DeepSeek Harness (DSH) 是一个插件化的模型推理框架。在多 agent 场景下,统一控制每个 agent 的输出格式(如代码风格、文档结构)是常见需求。dsh-output-styles 插件为 DSH Web 添加了一个“输出样式”设置页面,允许用户预设或自定义样式,并直接注入到 agent 的系统提示词中。
核心功能¶
该插件为 DSH Web 提供以下能力:
- 设置页面:在
dsh web的设置对话框中新增“输出样式”页面。 - 内置样式:提供五种开箱即用的输出风格:Default、Concise、Explanatory、Learning、Formal。
- 自定义样式:支持通过 Markdown 指令创建命名的自定义样式,可配置名称和描述。
- 实时生效:选中的样式会从“下一个模型步骤”开始进入所有 agent 的 system prompt,无需重启服务。
- 持久化存储:用户定义的样式会保存在配置文件中,重启后依然生效。
- 文件支持:指令字段支持直接粘贴完整的样式文件(例如 Claude Code 的输出样式或 Agent Skills 的 SKILL.md)。
安装与启用¶
插件通过 npm 包提供,安装命令如下:
dsh plugin --profile web add @auggieteo/dsh-output-styles
安装完成后,重启 dsh web,在设置菜单中即可看到“输出样式”页面。插件会自动将其 cordis.patch.yml 注入到 DSH 的层栈中,无需手动配置。
使用方法¶
- 打开设置 → 输出样式。
- 从列表中选择一个内置样式,或点击“创建”按钮。
- 在编辑模式下,修改样式行的名称、描述或指令内容。
- 点击“保存”生效,点击“取消”恢复原状。
- 用户自定义的样式会持久化存储在
~/.dsh/profiles/<profile>/cordis.patch.yml的output-styles配置项下。
注意事项¶
- 环境依赖:需要 Node.js 20+ 环境,且需要使用 DSH 的 Web profile(测试版本为 0.2.0-rc.2)。
- 依赖关系:所有运行时依赖均由 DSH 提供,插件自身不打包 peer dependencies。
- Frontmatter 限制:指令字段虽然支持粘贴文件,但仅支持扁平的
key: value格式。只有 Name 和 Description 会被读取,其他 key 被忽略。 - 仅会话安装:插件支持在运行时动态定义(Session-only install),Agent 可以在当前 DSH 进程中通过工具注入此插件,无需文件层面的持久化部署。