跳过主要内容
P

dsh-output-styles

perrylink/dsh-output-styles

运行时切换模型输出风格(对标 Claude Code outputStyles),另加 output.render.* 呈现协议:/style 命令、按会话持久化、systemPrompt 注入、六个内置风格、Web 选择器,以及带按会话/按工具规则与 /export 的渲染器注册表。

安装

dsh plugin --profile web add github:perrylink/dsh-output-styles

README

dsh-output-styles 横幅:一次 /style concise 把选择按会话写入 output_style 域;六种内置风格,每次组装都在 order 90 注入当前风格正文并按 maxStyleChars 截断。

dsh-output-styles

在运行时切换模型的输出风格——一次 /style concise,之后每条回复都简洁。

DeepSeek Harness 的 Claude Code outputStyles 等价实现:风格写成 Markdown 文件,选择按会话持久化,并在每次提示组装时注入。

安装 · 配置 · FAQ · 简体中文 · English · Español · Português · हिन्दी

License DSH npm CI Node

Stars npm downloads dshfind OpenSSF Scorecard DSH Market Gitee

dsh plugin --profile <name> add dsh-output-styles

社区插件,与 DeepSeek 官方无关。唯一仓库:https://github.com/PerryLink/dsh-output-styles(Gitee 为镜像)。

它是什么

/style concise —— 从此每条回复都简洁;/style off —— 回到项目默认。dsh-output-styles 把 Claude Code 的 outputStyles 搬到 DeepSeek Harness:风格是 Markdown 文件(frontmatter 存元数据,正文即模型指令),六种内置开箱可用;选择存在 output_style 存储域里、按会话隔离、重启不丢;每次提示组装都会把当前风格的正文注入系统提示,并按预算截断。它只作用于主会话,子代理会话保留自己的提示(与 Claude Code 一致)。

dsh-output-styles 结构图:一份风格库同时供给两条通道。提示注入通道——/style 写入 output_style 域(按 sessionId 持久),effectiveStyle() 按 force-for-plugin、会话选择、defaultStyle 依次解析,systemPrompt.section() 在 order 90 注入并按 maxStyleChars 截断,注入原文记为 system/message;检测到核心 outputStyles 时跳过注入(promptInjection: disabled)。渲染导出通道——/transcript 经 output.render/before 瀑布、rules 首个命中与纯 presenter,得到 { original, rendered },输出 md 或 html,--save 先净化再经审批写盘。两条通道都落在会话日志审计基线上。

工作方式

flowchart LR
    U[You type /style concise] --> C[command registry]
    C -->|command/run logged| L[(session log)]
    C -->|put {style, source}| D[(output_style domain)]
    D --> R[OutputStyleRuntime]
    R -->|body at every assembly| S[systemPrompt section order 90]
    S --> M[Model request]
    M -->|full system prompt| H[system/message logged]

模型所见的一切都能从会话日志重建 —— 无新增会话事件类型、无 agent-loop 改动。风格名来自 command/run,精确注入文本来自 system/message,来源标记 { kind: 'dsh-output-styles' } 随域记录携带。

演示

You > /style
      output style off
      concise — Terse, direct answers — minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
      explanatory — Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, …)
      formal — Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, …)
      learning — Collaborative learn-by-doing mode with short "Insights" and small hands-on steps for the user. (Pairing, onboarding, …)
      proactive — Execute immediately, assume reasonable defaults, and prefer action over planning. (Routine multi-step work, …)
      step-by-step — Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, …)

You > /style concise
      switched to concise

You > 请只用一句话介绍你自己。
AI  > 我是运行在 DeepSeek Harness 插件化平台上、基于 deepseek-v4-pro 模型的 AI 编码代理。

三步上手

  1. 安装(三选一):

    # git 通道(最新 main;prepare 脚本仅用生产依赖构建)
    dsh plugin --profile web add github:PerryLink/dsh-output-styles
    # npm 通道(发布版本)
    dsh plugin --profile web add dsh-output-styles
    # tarball 通道:本仓库 pnpm pack 后
    dsh plugin --profile web add ./dsh-output-styles-<version>.tgz
    
  2. 最小配置(默认即可用;按需给新会话指定项目默认风格):

    - insert:
        - id: output-styles
          name: dsh-output-styles
          config:
            defaultStyle: concise
    
  3. 验证已生效:

    dsh --profile web --dump-config | grep -A3 'id: output-styles'
    
    > /style
          output style off
          concise — Terse, direct answers — minimal prose, no preamble. (…)
    > /style concise
          switched to concise
    

卸载:dsh plugin --profile web remove dsh-output-styles(或从 profile patch 删掉该行)。

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。

核心能力

dsh-output-styles 是 DeepSeek Harness 的 Claude Code outputStyles 等价实现:一个 /style 命令,在运行时切换模型输出风格,按会话持久化,并在每次提示组装时注入。

  • 风格库 —— 每种风格一个 Markdown 文件(styles/*.md);frontmatter 存元数据,正文即模型指令。内置六种(concise、explanatory、formal、learning、proactive、step-by-step),含与 Claude Code 对齐的 proactive 与 learning。
  • /style 命令 —— 无参数时列出风格(含描述)与当前选择;/style <name> 切换;/style off 恢复项目默认。
  • 会话级持久化 —— 选择存于 output_style 存储域,按 sessionId 隔离,重启后仍保留。
  • 系统提示注入 —— systemPrompt.section() 贡献(顺序 sectionOrder)在每次组装时注入当前会话的风格正文,按可配置预算截断。
  • Claude Code 对齐 —— keep-coding-instructions、force-for-plugin(别名 force)、outputStyles JSON 兼容、分层 stylesDir 目录、热重载,以及可在 Web 的 Plugins 页面实时编辑的项目默认回退。
  • 渲染器注册表(output.render.*) —— ctx.outputRenderers 允许任意插件注册纯 presenter,经 output.render/before waterfall 应用;内置渲染器 concise 与 step-by-step。
  • 按会话/按工具规则 —— rules: [{ match: { tool: 'bash' }, style: 'concise' }] 为匹配请求指定渲染器;可在 Web 的 Plugins 页面实时编辑。
  • /transcript —— 经渲染管线把当前会话导出为 Markdown 或净化 HTML;--save <path> 经用户审批后把净化文档写入该工作区路径。每次渲染都保留原文与渲染结果并列。

命令与工具面

表面类型说明
/stylecommand列出风格、切换或恢复项目默认
/transcriptcommand把当前会话渲染为 Markdown 或净化 HTML;--save 经审批写入
output_stylestorage domain按 sessionId 隔离的会话级风格选择
systemPrompt.section()contribution在每次组装时注入当前风格正文
output.render.*renderer registryctx.outputRenderers + output.render/before waterfall
styleprojection从已落定命令折叠出的 { options, currentValue }
Web pickerclient entrydsh-output-styles/client 用弹出选择器装饰 /style

命令参考

输入结果
/style列出当前选择 + 每个风格一行(名称 — 描述)
/style concise切换(持久写入),switched to concise
/style Diagrams first多词名称取整个余下部分
/style off恢复项目默认(settings 默认,其次 defaultStyle)
/style nopeerror: unknown output style "nope" (available: …)
/transcript经渲染管线把当前会话渲染为 Markdown
/transcript md渲染为 Markdown(md 是 markdown 的简写)
/transcript html渲染为净化 HTML
/transcript --renderer=concise强制指定一个渲染器渲染(跳过规则)
/transcript md --save report.md渲染后经审批把净化文档写入 report.md

示例

以下为插件真实入口;安装后调用一个即可。

详细示例 —— 命令 /style concise,输出:

switched to concise

Observed from plugins/dsh-output-styles/src/runtime.ts:474-478; asserted in tests/runtime.spec.ts:91; README §Command reference line 194

失败分支 —— 输入 /style nope,输出:

unknown output style "nope" (available: concise, explanatory, formal, learning, proactive, step-by-step)

Observed from plugins/dsh-output-styles/src/runtime.ts:213-214,474-475; plugins/dsh-output-styles/tests/runtime.spec.ts:118-125

简短示例:/transcript · output_style

风格库

每种风格一个 Markdown 文件;frontmatter 存元数据,正文即模型指令。name 默认取文件名,可含空格(Diagrams first)。

字段默认值含义
name文件名切换目标;字母、数字、空格与连字符(off 为保留字)
description—(必填)列表与选择器中显示的一句话
whenToUse—追加到列表的可选指引
keep-coding-instructionsfalse为 true 时保留 harness 提示;为 false 时整体替换(Claude Code 语义)
force-for-pluginfalse无条件应用,覆盖任何会话选择;force 为别名,至多一种风格可设置

启用 compatJson: true 后,Claude Code outputStyles JSON 条目({ name, description, prompt })与 Markdown 风格并列加载;无法解析的条目带警告跳过。

渲染器协议

output.render.* 协议把呈现层变为扩展点。渲染器是纯 presenter —— presenter(text, context) 把参数映射为展示数据、绝不触碰 DOM —— 按工具名与内容类型匹配,按优先级排序。

  • Waterfall first:每个渲染请求先经 output.render/before({ text, context });监听器必须调用 next()。
  • Rules:rules: [{ match: { tool: 'bash' }, style: 'concise' }] 为匹配请求指定渲染器;冲突按 priority 再按规则顺序裁决。
  • Built-ins:concise(空白压缩 + 预算截断)与 step-by-step(一致的步骤编号)。
  • Auditability:每次渲染结果携带 { original, rendered, rendererId, changed };渲染文本是展示内容,原文始终可从会话日志重建。

Web 选择器

dsh.client 条目装饰 host /style 命令的裸调用,弹出一个选择器:一个 "off" 行 + 每个库风格一行(description · whenToUse),当前行高亮。选择通过命令 Remote 提交 /style <name>,因此每次切换都保留 host 的持久命令生命周期。选择器跟随 Web UI 自带的 zh/en 语言对。

配置

所有可调项均为 Schemastery Config 字段(可在 cordis.yml 中修改)。非法值在加载期失败。

defaultStyle 与 rules 声明为 volatile(),因此在组合了 settings forms seam 的宿主上它们是可实时编辑的 Web 字段:在 Web UI 的 Plugins → dsh-output-styles 中修改后,运行中的插件会直接采用新值,无需重新挂载。其余字段仍仅在组合期生效,需要重载。提交的值会先校验再应用 —— 非法值会被拒绝,运行中的值保持不变。

最常用键:

键默认值Web 可编辑含义
stylesDir[]否风格库目录,相对 cwd 解析;后者覆盖前者。[] = 仅内置 styles/
maxStyleChars4000否风格正文预算(≥ 1);超长正文带标记截断
defaultStyle''是从未选择过风格的会话所用风格;'' = 无风格。不在实时库中的名称会被拒绝,而不会被注入
compatJsontrue否加载 Claude Code outputStyles JSON 条目(单对象或数组)
sectionOrder90否注入段的顺序(0 = persona,100–199 = 工具指引)
includeBuiltinstrue否将包内置 styles/ 作为最低优先级层
watchStylestrue否风格文件在磁盘上变化时重载库
rules[]是按会话/按工具渲染规则:[{ match: { tool?, contentType?, session? }, style, priority? }]
完整配置表(11 个键)
键默认值Web 可编辑含义
stylesDir[]否风格库目录,相对 cwd 解析;后者覆盖前者。[] = 仅内置 styles/
maxStyleChars4000否风格正文预算(≥ 1);超长正文带标记截断
defaultStyle''是从未选择过风格的会话所用风格;'' = 无风格。不在实时库中的名称会被拒绝,而不会被注入
compatJsontrue否加载 Claude Code outputStyles JSON 条目(单对象或数组)
sectionOrder90否注入段的顺序(0 = persona,100–199 = 工具指引)
truncationMarker"\n\n[style truncated]"否追加在截断点的标记
includeBuiltinstrue否将包内置 styles/ 作为最低优先级层
watchStylestrue否风格文件在磁盘上变化时重载库
rules[]是按会话/按工具渲染规则:[{ match: { tool?, contentType?, session? }, style, priority? }]
enableExporttrue否注册 /transcript 命令(Markdown/HTML 会话导出,感知渲染器;--save 经审批写入)
respectCoreOutputStylestrue否检测到核心 outputStyles 服务时跳过本插件的提示词注入(保留热切换 / rules / export)

profile patch 覆盖示例:

- insert:
    - id: output-styles
      name: dsh-output-styles
      config:
        defaultStyle: concise
        rules:
          - match: { tool: bash }
            style: concise

从 0.1.6 及更早版本迁移。 那些版本保留了两个插件自有的设置区:output-style(style)与 output-style-rules(rules)。0.1.7 宿主删除了它们所依赖的 API,因此这两个设置区都不复存在。请把原先填在那里的值迁移到对应的 Config 字段 —— output-style.style → defaultStyle,output-style-rules.rules → rules —— 写在你的 profile patch(cordis.yml)中,或在 Plugins 页面上设置。用 /style 做出的按会话选择不受影响:它们存放在 output_style 存储域中。

FAQ

风格选择存在哪?重启会丢吗?

选择存于 output_style 存储域、按 sessionId 隔离,重启后仍在;除此之外不持久化任何状态,也没有网络请求。风格正文来自 styles/ 目录与 stylesDir,每次组装时重新读取(watchStyles 开启时还会热重载)。

在 Web 上改了 `defaultStyle` 却没生效?

defaultStyle 与 rules 是 volatile() 字段:只有宿主组合了 settings forms seam 时才是可实时编辑的 Web 字段;否则它们仅在组合期生效,需要重载 profile。提交的值会先校验 —— 非法名称被拒绝,运行中的值保持不变。

官方以后内置 `outputStyles` 会冲突吗?

不会静默冲突。插件检测到第一方 outputStyles 服务后自动降级到增量面(热切换 / rules / /transcript),提示注入交给核心;每次 /style 与 /style off 的回复都带 degraded coexistence mode 说明,style 会话 projection 也暴露 promptInjection: 'enabled' | 'disabled',不会在风格未生效时暗示它已生效。逐条论证见 docs/COEXISTENCE.md。

性能开销多大?

没有网络请求、没有模型调用。插件挂在 system-prompt/assemble 上,把当前风格的正文(截断到 maxStyleChars,默认 4000 字符)并入系统提示;每个监听器都经 next() 委托,不短路链条。

子代理会话会继承风格吗?

不会。风格只作用于主会话;子代理会话保留自己的提示,与 Claude Code 的行为一致。

安全边界

  • 仅公开服务。 贡献 systemPrompt、命令、存储与 settings;不改 engine / agent-loop / apiproxy / 官方 UI。
  • 模型可见 ⟺ 已记录。 模型所见的一切都能从会话日志重建 —— 无新增会话事件类型、无 agent-loop 改动。
  • 始终保留原文。 每次渲染(含 /transcript)都保留原文与渲染结果并列;HTML 导出使用净化 HTML。
  • 写盘有门禁。 /transcript --save 仅在审批服务放行后写入,且写入内容先经 sanitizeText 纯函数净化;缺少审批或 fs 服务时一律不写入(fail-closed)。

权限与数据

  • 权限:workshop 清单声明 fs:read、fs:write、fs:watch、storage:read、storage:write 与 settings:read。
  • 数据:风格选择存于 output_style 存储域(按 sessionId 隔离);不持久化其他状态,无网络请求。
  • 会话日志:风格名来自 command/run,精确注入文本来自 system/message;来源标记 { kind: 'dsh-output-styles' } 随域记录携带。

已知限制

  • 核心共存。 若官方推出第一方 outputStyles 能力,本插件检测到其 outputStyles 服务后降级到增量面(热切换 / rules / /transcript),提示词注入交给核心 —— 见 docs/COEXISTENCE.md 与导出的 detectCoreOutputStyles / coexistenceReport。降级状态会写在你看得到的地方:每次 /style <风格> 与 /style off 的回复都带一条 degraded coexistence mode 说明,style 会话 projection 也暴露 promptInjection: 'enabled' | 'disabled',任何界面都不会在风格未生效时暗示它已生效。(0.7.0 之前唯一的痕迹是一行 ctx.logger.info,它进不了会话转录。)
  • 仅主会话。 风格只作用于主会话;子代理会话保留各自提示(与 Claude Code 一致)。
  • 截断。 超过 maxStyleChars 的风格正文带标记截断。
  • 跳过坏文件。 损坏的风格文件带警告跳过,绝不破坏 profile。

与其他 DSH 插件的互操作性

已对照 DSH 0.2.0-rc.2(本 README 面向的运行时)与 2026-10-05 实测的高星插件集验证。

本插件不干扰其他插件,包括广泛安装的高星插件:

  • 无工具名冲突。 所有工具都带命名空间,不占用任何已被内置工具或其他插件持有的裸名。
  • 无服务键冲突。 只提供 outputRenderers;该键既不是内置 seam,也没有被任何已调研的高星插件提供。
  • 无 slot 冲突。 不注册客户端 slot key,因此不参与 shadows-shipped-ui 座位争抢。
  • 无 HTTP 路由冲突。 不注册任何 webServer 前缀。
  • 无 patch 层冲突。 组合包 patch 只 insert 自己那一行,从不覆写内置行的 config。
  • 无全局改写。 不改原型、不改写 process.env、不替换全局 fetch dispatcher。

共享事件监听器在构造上就不互相干扰。 它用 ctx.on() 监听顺序敏感事件 system-prompt/assemble —— Cordis 的广播语义:每个监听器都会运行,任何一个都无法饿死其他监听器。此处每个监听器都通过 next() 委托,因此链条绝不会被短路;改写作用在 next() 产出的值上,而不是用它顶替返回:

  • system-prompt/assemble — also used by dsh-routing-suite (7000★, 13 listeners).

静态证据:dsh-plugin-doctor 的 K10–K13 在本仓全部为 pass。

生态冲突排查

开发前已对照 DSH 生态排查(2026-08 快照):topic:dsh-plugin 下无 style/output-style 仓库,四个主要 awesome lists 中无 output-style 分类,dsh-hub catalog 中无条目。最接近的邻居——dsh-soul-md(persona)与 dsh-claude-marketplace(输出风格明确推迟到 v0.2+)——是相邻而非冲突。

兼容性

维度状态
HarnessDeepSeek Harness dsh-v0.2.1-rc.2(2026-09-09 已适配):会话信封保留 ignorable 字段但仅用于存量日志读取兼容——Session.append 仍无法盖章,门控行为不变。2026-09-11 对照 dsh-v0.2.1-rc.2 checkout 已核验(完整门禁链 + profile 安装冒烟)。
Node^22.19.0 || >=24.9.0
平台全部(host + Web 客户端)
模型任意(系统提示注入)

与 Claude Code 的差异

Claude Codedsh-output-styles
风格文件用户/项目/受管层的 .claude/output-stylesstylesDir 目录 + 内置 styles/,后者目录优先
自定义风格Markdown,frontmatter name/description/keep-coding-instructions/force-for-plugin相同字段(force-for-plugin 原样接受,force 为别名)+ whenToUse
旧版 JSONsettings.json 中的 outputStyles 数组原样加载(compatJson: true)
生效时机/clear 之后或新会话立即——系统提示按请求重新组装
子代理风格不适用相同——子代理会话保留各自提示
切换/config 菜单或 outputStyle 设置(/output-style 命令已在 v2.1.91 移除)/style 命令 + Web picker + Web Plugins 页面的 defaultStyle 字段

生态与质量

开发

pnpm install
pnpm run typecheck    # 两个 tsc 工程
pnpm test             # vitest —— 156 个测试
pnpm run verify       # typecheck + tests + self-contained(prepublishOnly 门禁)
pnpm run check:readmes  # 五语 README 一致性门禁
pnpm run build        # lib/ 产物(host + client 包)
pnpm pack             # 供 dsh plugin add 的 tarball

发布:推送后缀与 package.json 版本一致的 v* 标签会触发 Publish workflow —— 完整验证后带 provenance 发布到 npm。

配图由 scripts/gen-readme-assets.py 程序化生成:hero 横幅是 Pillow 绘制的 1440×576 WebP(zh/en × 明/暗),结构图是手写 SVG(1100×660,明/暗);重跑即可覆盖 docs/assets/dsh-output-styles-hero-* 与 docs/assets/dsh-output-styles-flow-v5-{light,dark}.svg。本仓无 benchmark 数据,因此不出 evidence 图。

Topics:deepseek-harness, dsh, dsh-plugin, output-style, output-styles, claude-code

家族与致谢

本项目是 PerryLink 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,给个 star——它不解锁任何功能,但会让下一个人更容易找到它。

  • @kskazuha —— 0.1.7 的 Web 风格选择器复活(#8)。
  • @Bingtang1019 —— lib/client.js 的模块表交接报告(#10)。
  • @PerryLink —— 作者与维护者:插件架构、风格库、bundle 安装、Web picker、五语文档与 CI/发布工具链。
展开全部插件
插件状态
dsh-aqua-input-check
dsh-archive-check
dsh-auto-review
dsh-autotier🧊 已冻结 — 见仓库 README
dsh-bid-ca-precheck
dsh-bid-qual-check
dsh-cert-mcp🧊 已冻结 — 见仓库 README
dsh-checkpoint-rewind
dsh-click
dsh-composer-history
dsh-contract-stance
dsh-customs-doc-check
dsh-data-quality🧊 已冻结 — 见仓库 README
dsh-demurrage-ledger
dsh-doublecheck
dsh-drill-script-check
dsh-eia-guide-check
dsh-emergency-plan
dsh-essay-rubric-check
dsh-evidence-check
dsh-export-ctl-check
dsh-fast
dsh-fmea-table-check
dsh-forecast-penalty
dsh-fund-research
dsh-github
dsh-gongwen-flow-check
dsh-gongwen-word-check
dsh-guard-plan-qc
dsh-hazchem-check
dsh-hazplan-check
dsh-hidden-risk-map
dsh-hs-classify
dsh-icd-rule-check
dsh-industry-research
dsh-lawcite-adapter
dsh-laya
dsh-lc-doc-check
dsh-learning-gap-check
dsh-library
dsh-local-ai
dsh-lsp-actions
dsh-mask
dsh-mcp-panel
dsh-medrec-qc
dsh-memento🧊 已冻结 — 见仓库 README
dsh-nsfc-form-check
dsh-nurse-record-check
dsh-observe
dsh-origin-rvc-check
dsh-ota-review-check
dsh-output-styles
dsh-paper-doc-adapter
dsh-permission-rules
dsh-permit-report-check
dsh-pipeline-check
dsh-pleading-draft
dsh-plugin-doctor🚫 已退役(仓库已归档)
dsh-plugin-guide
dsh-plugin-kit🚫 已退役(仓库已归档)
dsh-plugin-upgrade🚫 已退役(仓库已归档)
dsh-policy-brief-draft
dsh-power-loss-split
dsh-power-ticket-check
dsh-ppap-check
dsh-protest-deadline
dsh-railway-window
dsh-repair-order-qc
dsh-research-report
dsh-review-reply-check
dsh-rulefile-check
dsh-safety-brief-check
dsh-score🧊 已冻结 — 见仓库 README
dsh-session-sync
dsh-site-log-check
dsh-skill-pack-security
dsh-soe-decision-check
dsh-soilwater-check
dsh-sop-sync-check
dsh-spc-gbt-adapter
dsh-talk
dsh-tender-extract
dsh-tender-matrix
dsh-test-drive
dsh-ticktick🚫 已退役(仓库已归档)
dsh-translate
dsh-warranty-calc
dsh-budget🧊 已冻结 — 见仓库 README
dsh-claude-move🧊 已冻结 — 见仓库 README
dsh-defend🧊 已冻结 — 见仓库 README
dsh-draw🧊 已冻结 — 见仓库 README
dsh-reach🧊 已冻结 — 见仓库 README
dsh-background-agents🚫 已退役(仓库已归档)
dsh-session-pin🚫 已退役(仓库已归档)
dsh-team-rooms🚫 已退役(仓库已归档)

License

LICENSE(Apache License 2.0)© 2026 dsh-output-styles contributors

Apache-2.0 · 社区插件,与 DeepSeek 无关。

工具链:dsh-plugin-guide · dsh-standards · dsh-plugin-start

相关插件