PerryLink/dsh-output-styles

🎨 dsh-output-styles

• 1024 商店渠道：先 npm i -g dsh1024，再 dsh1024 plugin --profile web add dsh-output-styles（计入 deepseek1024.com 安装排行）。

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

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

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

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

---

⭐ 如果它帮到了你

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

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

Compatibility

Surface	Status
Harness	DeepSeek Harness dsh-v0.1.7-rc.2（2026-09-09 已适配）：会话信封保留 ignorable 字段但仅用于存量日志读取兼容——Session.append 仍无法盖章，门控行为不变。2026-09-11 对照 dsh-v0.1.7-alpha.1 master checkout 已核验（完整门禁链 + profile 安装冒烟）。
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 目录、热重载，以及可在 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> 经用户审批后把净化文档写入该工作区路径。每次渲染都保留原文与渲染结果并列。

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[system/message logged]

模型所见的一切都能从会话日志重建 —— 无新增会话事件类型、无 agent-loop 改动。风格名来自 command/run，精确注入文本来自 system/message，来源标记 { kind: '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 中修改）。非法值在加载期失败。

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

Key	Default	Web 可编辑	Meaning
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）

从 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 存储域中。

Tools & surfaces

Surface	Kind	Notes
/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

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: …)
/transcript	经渲染管线把当前会话渲染为 Markdown
/transcript md	渲染为 Markdown（md 是 markdown 的简写）
/transcript html	渲染为净化 HTML
/transcript --renderer=concise	强制指定一个渲染器渲染（跳过规则）
/transcript md --save report.md	渲染后经审批把净化文档写入 report.md

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 + Web Plugins 页面的 defaultStyle 字段

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:write、fs:watch、storage:read、storage:write 与 settings:read。
• Data：风格选择存于 output_style 存储域（按 sessionId 隔离）；不持久化其他状态，无网络请求。
• Session log：风格名来自 command/run，精确注入文本来自 system/message；来源标记 { kind: 'dsh-output-styles' } 随域记录携带。

Security boundaries

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

Known limitations

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

Development

pnpm install
pnpm run typecheck   # 两个 tsc 项目
pnpm test            # vitest —— 148 个测试
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

This project is one of the 45 DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:

Plugin	One-liner
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-plugin-upgrade-015	Merged 0.1.3-alpha.1 → 0.1.5-rc.1 upgrade corridor card plus a zero-dependency seam scanner
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

License

Apache License 2.0 © 2026 dsh-output-styles contributors

从 DSH Desktop 市场安装

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