PerryLink/dsh-output-styles

🎨 dsh-output-styles

DeepSeek Harness 的 Claude Code outputStyles 等价实现 —— 在运行时、按会话、持久地切换模型输出风格。

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

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

---

Compatibility

Surface	Status
Harness	DeepSeek Harness 0.1.0-rc.6
Node	`^22.19.0
Platforms	全部（host + Web 客户端）
Model	任意（系统提示注入）

What you get

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 目录、热重载，以及通过 DSH settings 接缝的项目默认回退。
• 渲染器注册表（output.render.*） —— ctx.outputRenderers 允许任意插件注册纯 presenter，经 output.render/before waterfall 应用；内置渲染器 concise 与 step-by-step。
• 按会话/按工具规则 —— rules: [{ match: { tool: 'bash' }, style: 'concise' }] 为匹配请求指定渲染器；可通过 output-style-rules 设置区编辑。
• /export —— 经渲染管线把当前会话导出为 Markdown 或净化 HTML；每次渲染都保留原文与渲染结果并列。

Quick start

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

# 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'

Demo

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 编码代理。

How it works

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[request/header logged]

模型所见的一切都能从会话日志重建 —— 无新增会话事件类型、无 agent-loop 改动。风格名来自 command/run，精确注入文本来自 request/header，来源标记 { kind: 'plugin', plugin: 'dsh-output-styles' } 随域记录携带。风格只作用于主会话；子代理会话保留各自提示（与 Claude Code 一致）。

Install & uninstall

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

Configuration

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

Key	Default	Meaning
stylesDir	[]	风格库目录，相对 cwd 解析；后者覆盖前者。[] = 仅内置 styles/
maxStyleChars	4000	风格正文预算（≥ 1）；超长正文带标记截断
defaultStyle	''	从未选择过风格的会话所用风格（且无 settings 默认）；'' = 无风格
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	注册 /export 命令（Markdown/HTML 会话导出，感知渲染器）

Tools & surfaces

Surface	Kind	Notes
/style	command	列出风格、切换或恢复项目默认
/export	command	把当前会话渲染为 Markdown 或净化 HTML
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

Command reference

Input	Outcome
/style	列出当前选择 + 每个风格一行（名称 — 描述）
/style concise	切换（持久写入），switched to concise
/style Diagrams first	多词名称取整个余下部分
/style off	恢复项目默认（settings 默认，其次 defaultStyle）
/style nope	error: unknown output style "nope" (available: …)
/export	经渲染管线把当前会话渲染为 Markdown
/export html	渲染为净化 HTML
/export --renderer=concise	强制指定一个渲染器渲染（跳过规则）

Style library

每种风格一个 Markdown 文件；frontmatter 存元数据，正文即模型指令。name 默认取文件名，可含空格（Diagrams first）。

Field	Default	Meaning
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 风格并列加载；无法解析的条目带警告跳过。

Renderer protocol

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 picker

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

Differences from 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 + settings output-style.style

Conflict check

开发前已对照 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+）——是相邻而非冲突。

Permissions & data

• Permissions：workshop 清单声明 fs:read、fs:watch、storage:read、storage:write 与 settings:read。
• Data：风格选择存于 output_style 存储域（按 sessionId 隔离）；不持久化其他状态，无网络请求。
• Session log：风格名来自 command/run，精确注入文本来自 request/header；来源标记 { kind: 'plugin', plugin: 'dsh-output-styles' } 随域记录携带。

Security boundaries

• 仅公开服务。 贡献 systemPrompt、命令、存储与 settings；不改 engine / agent-loop / apiproxy / 官方 UI。
• 模型可见 ⟺ 已记录。 模型所见的一切都能从会话日志重建 —— 无新增会话事件类型、无 agent-loop 改动。
• 始终保留原文。 每次渲染（含 /export）都保留原文与渲染结果并列；HTML 导出使用净化 HTML。

Known limitations

• 仅主会话。 风格只作用于主会话；子代理会话保留各自提示（与 Claude Code 一致）。
• 截断。 超过 maxStyleChars 的风格正文带标记截断。
• 跳过坏文件。 损坏的风格文件带警告跳过，绝不破坏 profile。

Development

pnpm install
pnpm run typecheck   # 两个 tsc 项目
pnpm test            # vitest —— 107 个测试
pnpm run verify      # typecheck + tests + self-contained（prepublishOnly 门禁）
pnpm run build       # lib/ 产物（host + client 包）
pnpm pack            # 供 dsh plugin add 的 tarball

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

Topics

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

Contributors

• @PerryLink —— 作者与维护者：插件架构、风格库、bundle 安装、Web picker、五语文档与 CI/发布工具链。

PerryLink DSH Plugin Family

本项目是 PerryLink 维护的 15 个 DeepSeek Harness 插件 之一。如果这个对你有用，其他插件多半也有用：

Plugin	One-liner
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH

License

Apache License 2.0 © 2026 dsh-output-styles contributors