输出风格切换 PerryLink/dsh-output-styles

🎨 dsh-output-styles

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-output-styles（计入 deepseek1024.com 的安装排名）。

dshfind

给 DeepSeek Harness 用的 Claude Code outputStyles —— 运行时切换模型的输出风格，按会话生效，持久保存。

/style concise —— 此后每条回复都简洁。/style off —— 回到项目默认。

官方仓库。 这是 dsh-output-styles 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库与本项目无关。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

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

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

- git channel（最新 main）：dsh plugin --profile web add github:PerryLink/dsh-output-styles —— prepare 脚本只用生产依赖构建。
- npm channel（已发布版本）：dsh plugin --profile web add dsh-output-styles。
- tarball 渠道：在本仓库执行 pnpm pack，然后执行 dsh plugin --profile web add ./dsh-output-styles-<version>.tgz。
- 卸载：dsh plugin --profile web remove dsh-output-styles。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（共 95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-output-styles 是什么？

/style concise —— 之后每条回复都变得简洁。/style off —— 回到项目默认。

dsh-output-styles 的工作流示意图：安装 → 打开面板 → 操作。

工作流概览：安装 → 打开面板 → 操作。下面的示例用的都是真实命令。

兼容性

| 层面 | 状态 |
| Harness | DeepSeek Harness dsh-v0.2.1-rc.2（适配于 2026-09-09）：会话信封保留其可忽略字段，仅用于存储日志的读取兼容 —— Session.append 仍然无法写入该字段，所以审计门禁行为不变。2026-09-11 针对 dsh-v0.2.1-rc.2 检出验证（完整门禁链 + 配置档安装冒烟测试）。 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（宿主 + Web 客户端） |
| 模型 | 任意（系统提示词注入） |

你能得到什么

dsh-output-styles 是 DeepSeek Harness 版的 Claude Code outputStyles：一条 /style 命令，在运行时切换模型的输出风格，按会话持久化，每次组装提示词时注入。

- 风格库 —— 每种风格一个 Markdown 文件（styles/.md）；frontmatter 存元数据，正文就是给模型的指令。内置六种风格（concise、explanatory、formal、learning、proactive、step-by-step），其中 proactive 和 learning 与 Claude Code 对齐。
- /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 让任何插件注册纯展示器，经 output.render/before 瀑布流生效；内置渲染器有 concise 和 step-by-step。
- 按会话/按工具规则 —— rules: [{ match: { tool: 'bash' }, style: 'concise' }] 为匹配的请求指定渲染器；可在 Web Plugins 页面实时编辑。
- /transcript — 通过渲染管线把当前会话渲染成 Markdown 或净化后的 HTML；--save <path> 在用户批准后，把净化后的文档写到该工作区路径。每次渲染都把原文放在渲染结果旁边。

快速开始

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

1. install the bundle into your profile
dsh plugin --profile web add github:PerryLink/dsh-output-styles

or from npm (published releases)
dsh plugin --profile web add dsh-output-styles

2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: 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 编码代理。

工作原理

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]

模型看到的一切都能从会话日志重建——不新增会话事件类型，也不改动智能体循环。风格名来自 command/run，注入的确切文本来自 system/message，来源标记 { kind: 'dsh-output-styles' } 随域记录一起传递。风格只作用于主对话；子代理会话保留自己的提示词（与 Claude Code 一致）。

示例

下面是插件的真实入口；安装一次，之后调用其中一个即可。

详细示例

命令

~~~sh
/style concise

输出

~~~text
switched to concise

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

失败分支

输入

~~~text
/style nope

输出

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

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

简要示例

- /transcript
- output_style

配置

所有可调项都是 Schemastery 的 Config 字段，可在 cordis.yml 中修改。值不合法会导致加载失败。

defaultStyle 和 rules 声明为 volatile()，因此在组合了 settings forms seam 的宿主上，它们是实时、可在 Web 中编辑的字段：在 Web UI 的 Plugins → dsh-output-styles 下编辑，运行中的插件无需重新挂载即可采用新值。其余字段只能在组合时设定，改动需要重新加载。提交的值会先校验再应用——不合法的值会被拒绝，运行中的值保持不变。

| 键 | 默认值 | 可在 Web 编辑 | 含义 |
| stylesDir | [] | 否 | 样式库目录，按 cwd 解析；靠后的条目覆盖靠前的。[] = 只用内置的 styles/ |
| maxStyleChars | 4000 | 否 | 样式正文预算（≥ 1）；超长正文会被截断并加上标记 |
| defaultStyle | '' | 是 | 从未选择过样式的会话使用的样式；'' = 不使用样式。不在实时库中的名称会被拒绝，而不是注入 |
| compatJson | true | 否 | 加载 Claude Code 的 outputStyles JSON 条目（单个对象或数组） |
| sectionOrder | 90 | 否 | 注入段的顺序（0 = 人设，100–199 = 工具指引） |
| truncationMarker | "\n\n[style truncated]" | 否 | 截断处追加的标记 |
| includeBuiltins | true | 否 | 把包内置的 styles/ 作为最低优先级层包含进来 |
| watchStyles | true | 否 | 磁盘上的样式文件变化时重新加载样式库 |
| rules | [] | 是 | 按会话/按工具的渲染规则：[{ match: { tool?, contentType?, session? }, style, priority? }] |
| enableExport | true | 否 | 注册 /transcript 命令（Markdown/HTML 会话导出，感知渲染器；--save 经批准后写入） |
| respectCoreOutputStyles | true | 否 | 检测到核心 outputStyles 服务时，跳过本插件的提示词注入（保留热切换 / 规则 / 导出） |

从 0.1.6 或更早版本迁移。 那些版本保留了两个插件自有的设置段：output-style（style）和 output-style-rules（rules）。0.1.7 的宿主删除了它们所依赖的 API，因此这两个段都不存在了。把你原先放在那里的值移到对应的 Config 字段——output-style.style → defaultStyle，output-style-rules.rules → rules——写进你的配置档补丁（cordis.yml），或在 Plugins 页面设置。用 /style 做出的按会话选择不受影响：它们存放在 output_style 存储域中。

工具与界面

| 界面 | 类型 | 说明 |
| /style | 命令 | 列出样式、切换样式，或恢复项目默认值 |
| /transcript | 命令 | 把当前会话渲染成 Markdown 或净化后的 HTML；--save 写入前需审批 |
| output_style | 存储域 | 会话级样式选择，按 sessionId 索引 |
| systemPrompt.section() | 贡献点 | 每次组装时注入当前样式正文 |
| output.render. | 渲染器注册表 | ctx.outputRenderers + output.render/before 瀑布流 |
| style | 投影 | 从已确定的命令折叠出 { options, currentValue } |
| Web 选择器 | 客户端入口 | dsh-output-styles/client 给 /style 挂一个弹窗选择器 |

命令参考

| 输入 | 结果 |
| /style | 列出当前选择 + 每行一个样式（名称 — 描述） |
| /style concise | 切换（持久写入），返回 switched to concise |
| /style Diagrams first | 多词名称取剩余全部内容 |
| /style off | 恢复项目默认值（先取设置默认值，再取 defaultStyle） |
| /style nope | error: 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 |

样式库

每个样式一个 Markdown 文件；frontmatter 放元数据，正文 = 模型指令。name 默认取文件名，可含空格（如 Diagrams first）。

| 字段 | 默认值 | 含义 |
| name | 文件名 | 切换目标；允许字母、数字、空格和连字符（off 为保留字） |
| description | —（必填） | 一句话，显示在列表和选择器里 |
| whenToUse | — | 可选提示，追加到列表 |
| keep-coding-instructions | false | 为 true 时保留 harness 提示词；为 false 时替换（Claude Code 语义） |
| force-for-plugin | false | 无条件生效，覆盖任何会话选择；force 是别名，最多一个样式可设置 |

开启 compatJson: true 后，Claude Code 的 outputStyles JSON 条目（{ name, description, prompt }）会和 Markdown 样式一起加载；无法解析的条目跳过并给出警告。

渲染器协议

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

- 瀑布流优先：每个渲染请求都先经过 output.render/before（{ text, context }）；监听器必须调用 next()。
- 规则：rules: [{ match: { tool: 'bash' }, style: 'concise' }] 为匹配的请求指定渲染器；平局按 priority 再按规则顺序决定。
- 内置：concise（压缩空白 + 按预算截断）和 step-by-step（步骤编号保持一致）。
- 可审计：每次渲染结果都带 { original, rendered, rendererId, changed }；展示出来的是渲染后的文本，原始文本可从会话日志还原。

Web 选择器

dsh.client 入口给宿主 /style 命令的裸调用加了一个弹窗选择器：一行「关闭」，加上每个库内样式一行（description · whenToUse），当前生效行有标记。选中后通过命令 Remote 提交 /style <name>，所以每次切换都保留宿主那套持久化的命令生命周期。选择器跟随 Web UI 自带的 zh/en 语言对。

与 Claude Code 的差异

| | Claude Code | dsh-output-styles |
| 样式文件 | 用户/项目/托管三级的 .claude/output-styles | stylesDir 目录 + 内置 styles/，靠后的目录优先 |
| 自定义样式 | Markdown，frontmatter 含 name/description/keep-coding-instructions/force-for-plugin | 同样这些字段（force-for-plugin 原样接受，force 作别名）+ whenToUse |
| 旧版 JSON | settings.json 里的 outputStyles 数组 | 原样加载（compatJson: true） |
| 生效时机 | /clear 之后或新会话 | 立即生效——系统提示词按请求重新组装 |
| 子代理 | 样式不生效 | 相同——子代理会话保留自己的提示词 |
| 切换方式 | /config 菜单或 outputStyle 设置（/output-style 命令在 v2.1.91 已移除） | /style 命令 + Web 选择器 + Web 插件页上的 defaultStyle 字段 |

冲突检查

开发前对照 DSH 生态筛查过（2026-08 快照）：topic:dsh-plugin 下没有 style/output-style 仓库，四大 awesome 列表 里没有 output-style 分类，dsh-hub 目录 里也没有条目。最接近的邻居——dsh-soul-md（人格）和 dsh-claude-marketplace（output styles 明确推迟到 v0.2+）——只是相邻，不冲突。

权限与数据

- 权限：在 workshop manifest 里声明 fs:read、fs:write、fs:watch、storage:read、storage:write 和 settings:read。
- 数据：样式选择存在 output_style 存储域里（按 sessionId 键控）；不持久化其他状态，不发网络请求。
- 会话日志：样式名来自 command/run，实际注入的文本来自 system/message；来源标记 { kind: 'dsh-output-styles' } 随域记录一起保存。

安全边界

- 只碰公共服务。 贡献 systemPrompt、命令、存储和设置；不改引擎 / agent-loop / apiproxy / 官方 UI。
- 模型可见 ⟺ 已记录。 模型看到的一切都能从会话日志重建 —— 不新增会话事件类型，不改智能体循环。
- 始终保留原文。 每次渲染（以及 /transcript）都在渲染结果旁保留原文；HTML 导出使用净化后的 HTML。
- 磁盘写入受控。 /transcript --save 只在审批服务批准后写入，写入内容先经过 sanitizeText 纯函数；没有审批服务或 fs 服务时不写任何内容（fail-closed）。

已知限制

- 与核心共存。 如果官方推出 outputStyles 能力，本插件会检测到它的 outputStyles 服务，降级为增量功能面（热切换、规则、/transcript），把提示词注入交给核心 —— 见 docs/COEXISTENCE.md 以及导出的 detectCoreOutputStyles / coexistenceReport 函数。降级模式会在你看得到的地方说明：每次 /style 切换和 /style off 的回复都带一条 degraded coexistence mode 提示，style 会话投影暴露 promptInjection: 'enabled' | 'disabled'，因此不会有任何界面在样式未生效时暗示它已生效。（0.7.0 之前唯一的痕迹是一行 ctx.logger.info，它永远不会进入会话记录。）
- 仅限主对话。 样式只作用于主对话；子代理会话保留自己的提示词（与 Claude Code 一致）。
- 截断。 样式正文超过 maxStyleChars 会被截断并加标记。
- 跳过的样式文件。 有问题的样式文件会被跳过并给出警告，绝不会弄坏配置档。

开发

pnpm install
pnpm run typecheck # both tsc projects
pnpm test # vitest — 156 tests
pnpm run verify # typecheck + tests + self-contained (the prepublishOnly gate)
pnpm run build # lib/ artifacts (host + client bundles)
pnpm pack # tarball for dsh plugin add

发布：推送一个 v* 标签，其后缀与 package.json 版本一致，就会触发 Publish 工作流 —— 先做完整验证，再带 provenance 发布到 npm。

与其他 DSH 插件的互操作性

已针对 DSH 0.2.0-rc.2（本 README 对应的运行时）以及 2026-10-05 调研的高星插件集做过验证。

本插件不会干扰其他插件，包括广泛安装的高星插件：

- 无工具名冲突。 每个工具都带命名空间；不注册任何已发布工具或其他插件占用的裸名称。
- 无服务键冲突。 它提供 outputRenderers；该键不是内置接缝，调研过的高星插件也没有提供它。
- 无槽位冲突。 它不注册任何客户端槽位键，因此不会争抢 shadows-shipped-ui 的席位。
- 无 HTTP 路由冲突。 它不注册任何 webServer 前缀。
- 无补丁层冲突。 打包补丁只 insert 自己的一行；从不覆盖内置行的 config。
- 不做全局改动。 不改写原型，不重写 process.env，也不替换全局 fetch 调度器。

共享事件监听器从设计上就互不干扰。 它用 ctx.on() 监听对顺序敏感的事件 system-prompt/assemble —— 这是 Cordis 的广播注册方式，每个监听器都会执行，谁也无法挤掉别人。这里每个监听器都通过 next() 向下传递，所以调用链永远不会被短路，改动施加在 next() 产出的值上，而不是另返回一个值顶替它：
- system-prompt/assemble —— dsh-routing-suite（7000★，13 个监听器）也在用。

静态证据：dsh-plugin-doctor 的 K10–K13 在本仓库的每一项检查上都报告 pass。

Topics

deepseek-harness、dsh、dsh-plugin、output-style、output-styles、claude-code

Contributors

- @kskazuha —— 0.1.7 上恢复 Web 样式选择器（#8）。
- @Bingtang1019 —— lib/client.js 的模块表交接报告（#10）。
- @PerryLink —— 作者与维护者：插件架构、样式库、打包安装、Web 选择器、五语言文档，以及 CI/发布工具。

PerryLink DSH Plugin Family

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下面这份名单默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| 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 | |
| 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 | |
| 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 | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache License 2.0 © 2026 dsh-output-styles contributors