前言¶
在 DeepSeek Harness（dsh）里做智能体对话时，助手若一次输出很长，常见有两类麻烦：传输层可能在流式过程中截断超长回复；长内容若全部留在聊天里，还会反复进入上下文，后续每轮请求都会重复计费。社区插件 dsh-trans-md 的做法是：当面向用户的最终回复超过行数阈值时，把全文写到工作区 Markdown 文件，聊天里只留短摘要和路径。下面介绍它的定位、能力与安装配置方式。
这是什么¶
dsh-trans-md 是维护者 passerby325799 发布的 DSH 客户端类插件（GitHub 仓库 passerby325799/dsh-trans-md，可在 SkillHub 目录页 查看条目）。它不注册工具、不提供 UI、不发起网络请求，只向系统提示词贡献一条规则（顺序 40），引导模型改变「长回复」的交付位置，而不是改变调查深度。
核心功能¶
插件在系统提示中声明的规则要点如下（与 README 一致）：
- 若面向用户的最终回复将超过 15 行（默认阈值，可配置），应把完整内容写入当前工作区下的
docs/<prefix>-<topic>.md（目录与前缀可配置），而不是在聊天里贴全文。 - 聊天中的回复变为最多 10 行的摘要，并给出文件路径。
- 不足 15 行的回复仍正常在聊天中发送。
- 禁止既写文件又把正文粘贴进聊天。
- 工具调用之间的中间叙述不受此规则约束；规则主要作用于主对话里面向用户的最终回复。
额外说明：
- 首次写入时会在工作区创建
docs/（或你配置的目录）。 - 写入文件作为工具参数的内容，按 README 的说法，相对「长回复一直留在聊天上下文、每轮重发」更省 token；具体计费仍以你使用的 Harness 与模型为准。
- 这是提示词级的强偏好，不是输出层的硬拦截；README 明确说明无法保证每一轮都严格执行，若要硬保证需要 output hooks，本插件刻意不做。
安装与启用¶
安装命令来自仓库 README：
dsh plugin --profile web add github:<owner>/dsh-trans-md
将 <owner> 换为仓库所有者（本插件为 passerby325799）后执行。安装后需重启 dsh 或重新加载 profile，新回合才会生效。
运行环境要求：DSH 需提供 systemPrompt 服务；若该服务不存在，插件会挂载但不贡献内容，不会导致 profile 加载失败。无额外运行时依赖。许可证为 MIT（package.json 版本 0.1.0）。
配置¶
所有配置项均为可选，通过 profile patch 设置。README 示例：
- id: dsh-trans-md
name: dsh-trans-md
config:
maxLines: 20
docsDir: notes
完整字段与默认值：
| Key | 默认值 | 含义 |
|---|---|---|
enabled |
true |
关闭规则而不卸载插件 |
maxLines |
15 |
超过此行数则落盘 |
docsDir |
"docs" |
相对工作区的输出目录 |
filePrefix |
"notes" |
生成文件名前缀 |
ruleFile |
— | 用指定 Markdown 完全替换内置规则文案 |
workspaceRoot |
— | 可选绝对路径；省略则用进程工作目录 |
自定义规则：将 ruleFile 指向任意 Markdown 文件；非空文件内容完全取代内置说明（上限 4000 字符）。文件为空或不可读时静默回退内置文案，错误路径不会破坏 prompt 组装。
典型用法¶
- 在
webprofile 下按上文命令安装插件并重启或 reload。 - 保持默认即可：长最终回复会落到工作区
docs/notes-<topic>.md一类路径（<topic>由模型根据内容命名），聊天里看到摘要与路径。 - 若希望阈值更宽松、目录改为
notes，在 profile 中按 YAML 示例设置maxLines: 20、docsDir: notes。 - 若团队有固定输出规范，准备一份规则 Markdown，设置
ruleFile指向该文件。
无需额外 CLI；行为完全由系统提示规则驱动，文件由模型在对话中通过既有写文件能力创建。
适用场景与注意¶
适合谁
- 经常在 DSH 里拿到长篇分析、教程或报告，希望聊天窗口可读、又要在仓库里留档的开发者。
- 关心上下文长度与 token 占用、希望长文以文件形式「写一次、少重复进上下文」的场景。
使用前请知悉
- 插件以当前 dsh 进程权限运行；安装前建议阅读 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。
- 规则是软约束，极端情况下模型仍可能在聊天里输出较长内容；不要把它当作审计或合规上的强制截断。
- SkillHub 等社区目录独立于 DeepSeek / 幻方，并非官方应用商店；插件归属与说明以仓库 README 为准。
结尾¶
dsh-trans-md 用一条可配置的系统提示规则，把超长最终回复从聊天迁到工作区 Markdown，聊天只保留摘要与路径，并避免「写文件又贴全文」的重复。若你需要在 DSH 里控制长回复的展示与落盘方式，可从目录页或 GitHub 安装并按 profile 调整阈值与目录。
- 目录页：https://www.skillhub.cn/plugins/passerby325799/dsh-trans-md
- GitHub：https://github.com/passerby325799/dsh-trans-md
