运行时切换模型输出风格(对标 Claude Code outputStyles),另加 output.render.* 呈现协议:/style 命令、按会话持久化、systemPrompt 注入、六个内置风格、Web 选择器,以及带按会话/按工具规则与 /export 的渲染器注册表。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-output-styles
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:PerryLink/dsh-output-styles
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
dsh-output-styles
在运行时切换模型的输出风格——一次 /style concise,之后每条回复都简洁。
DeepSeek Harness 的 Claude Code outputStyles 等价实现:风格写成 Markdown 文件,选择按会话持久化,并在每次提示组装时注入。
安装 · 配置 · FAQ · 简体中文 · English · Español · Português · हिन्दी
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 一致)。
工作方式
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 编码代理。
三步上手
安装(三选一):
# 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最小配置(默认即可用;按需给新会话指定项目默认风格):
- insert: - id: output-styles name: dsh-output-styles config: defaultStyle: concise验证已生效:
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 删掉该行)。
所有 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)、outputStylesJSON 兼容、分层stylesDir目录、热重载,以及可在 Web 的 Plugins 页面实时编辑的项目默认回退。 - 渲染器注册表(
output.render.*) ——ctx.outputRenderers允许任意插件注册纯 presenter,经output.render/beforewaterfall 应用;内置渲染器concise与step-by-step。 - 按会话/按工具规则 ——
rules: [{ match: { tool: 'bash' }, style: 'concise' }]为匹配请求指定渲染器;可在 Web 的 Plugins 页面实时编辑。 /transcript—— 经渲染管线把当前会话导出为 Markdown 或净化 HTML;--save <path>经用户审批后把净化文档写入该工作区路径。每次渲染都保留原文与渲染结果并列。
命令与工具面
| 表面 | 类型 | 说明 |
|---|---|---|
/style |
command | 列出风格、切换或恢复项目默认 |
/transcript |
command | 把当前会话渲染为 Markdown 或净化 HTML;--save 经审批写入 |
output_style |
storage domain | 按 sessionId 隔离的会话级风格选择 |
systemPrompt.section() |
contribution | 在每次组装时注入当前风格正文 |
output.render.* |
renderer registry | ctx.outputRenderers + output.render/before waterfall |
style |
projection | 从已落定命令折叠出的 { options, currentValue } |
| Web picker | client entry | dsh-output-styles/client 用弹出选择器装饰 /style |
命令参考
| 输入 | 结果 |
|---|---|
/style |
列出当前选择 + 每个风格一行(名称 — 描述) |
/style concise |
切换(持久写入),switched to concise |
/style Diagrams first |
多词名称取整个余下部分 |
/style off |
恢复项目默认(settings 默认,其次 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 |
示例
以下为插件真实入口;安装后调用一个即可。
详细示例 —— 命令 /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-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 —— 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/ |
maxStyleChars |
4000 |
否 | 风格正文预算(≥ 1);超长正文带标记截断 |
defaultStyle |
'' |
是 | 从未选择过风格的会话所用风格;'' = 无风格。不在实时库中的名称会被拒绝,而不会被注入 |
compatJson |
true |
否 | 加载 Claude Code outputStyles JSON 条目(单对象或数组) |
sectionOrder |
90 |
否 | 注入段的顺序(0 = persona,100–199 = 工具指引) |
includeBuiltins |
true |
否 | 将包内置 styles/ 作为最低优先级层 |
watchStyles |
true |
否 | 风格文件在磁盘上变化时重载库 |
rules |
[] |
是 | 按会话/按工具渲染规则:[{ match: { tool?, contentType?, session? }, style, priority? }] |
| 键 | 默认值 | Web 可编辑 | 含义 |
|---|---|---|---|
stylesDir |
[] |
否 | 风格库目录,相对 cwd 解析;后者覆盖前者。[] = 仅内置 styles/ |
maxStyleChars |
4000 |
否 | 风格正文预算(≥ 1);超长正文带标记截断 |
defaultStyle |
'' |
是 | 从未选择过风格的会话所用风格;'' = 无风格。不在实时库中的名称会被拒绝,而不会被注入 |
compatJson |
true |
否 | 加载 Claude Code outputStyles JSON 条目(单对象或数组) |
sectionOrder |
90 |
否 | 注入段的顺序(0 = persona,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 服务时跳过本插件的提示词注入(保留热切换 / 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 开启时还会热重载)。
defaultStyle 与 rules 是 volatile() 字段:只有宿主组合了 settings forms seam 时才是可实时编辑的 Web 字段;否则它们仅在组合期生效,需要重载 profile。提交的值会先校验 —— 非法名称被拒绝,运行中的值保持不变。
不会静默冲突。插件检测到第一方 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 bydsh-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+)——是相邻而非冲突。
兼容性
| 维度 | 状态 |
|---|---|
| Harness | DeepSeek 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 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 picker + Web Plugins 页面的 defaultStyle 字段 |
生态与质量
- Gitee 镜像(同步镜像,以 GitHub 为准)
- dshfind 插件页(安装量与排名)
- OpenSSF Scorecard 报告(由 .github/workflows/scorecard.yml 驱动)
- dsh-plugin-doctor 验证报告(K10–K13 全
pass) - DSH Market(已上架)
- 1024 商店渠道:先
npm i -g dsh1024,再dsh1024 plugin --profile web add dsh-output-styles(计入 deepseek1024.com 安装排行) - 生态实测知识库:插件开发指南 · 选型实测数据 · 维护取舍判据
开发
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/发布工具链。
License
LICENSE(Apache License 2.0)© 2026 dsh-output-styles contributors
链接
同类插件
yjh051108/dsh-routing-suite★ 7015
一个仓库三件套:DSH 插件包的运行时注入器(注入、热重载、卸载、开发侧挂区一键转正、路由自愈,外带设置页插件管理:列出、卸载、拖入文件夹内化)、任务感知的思维模式路由 agent 预设(router-standard / router-spec / router-react)、以及分级两级任务协议(commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具,任务状态落盘)。注入器实现直接在库内,安装的是它自己的行为而不是一份依赖清单。
strukto-ai/mirage#dsh★ 3783
把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。
first-fluke/oh-my-agent#dsh★ 1440
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖,并在首次使用时初始化未配置的项目。需要 Node.js 22+;首次初始化需要网络连接和项目目录写入权限。
MichengAI/dsh-skills-manager★ 552
在设置里管理本地 DSH 技能,并只读查看公共 Agent 技能。
hust-open-atom-club/oh-dsh★ 324
社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。
Fishquito7/dsh-skill-mcp-panel★ 272
在 DSH Web 设置中管理技能与 MCP 服务器:技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入,以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏,并附带统一 dsh-panel 命令行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。