前言¶
DeepSeek Harness(DSH)里,主模型完成任务后给出的最终回答,往往偏「报告腔」:术语多、句式长,日常阅读成本高。若每次自己改写成大白话,既费时间,又容易在改写里动到事实或技术细节。
「说人话」是社区维护者 Exception-H 发布的 DSH 插件(分类:模型推理)。它不替换主模型的工作流,而是在一轮回答正常结束后,用你在 DSH 里已配置好的另一条模型路由,只对最终回答的可改写文字做表达润色;聊天界面默认展示润色版,原回答折叠,可随时展开。执行轨迹和后续主模型上下文仍用原文,避免「界面好读、上下文被悄悄改掉」这类错位。
下面介绍插件定位、能力与安装启用方式,并说明自动/手动润色及使用边界。安装命令与配置项均来自项目 README;插件以当前 DSH 进程权限运行,安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。社区目录页:skillhub.cn 插件页。
这是什么¶
- 名称:说人话 ·
dsh-speak-plain(npm 包名dsh-speak-plain,当前资料中发行版示例版本 0.3.1) - 维护者:Exception-H
- 一句话:DSH 插件——用你选的模型把最终回答润色成大白话,默认显示润色版,原回答可折叠。
- 不做什么:不存储或索要 API Key;润色请求走 DSH 已有模型路由,会额外消耗该渠道额度;发给润色模型的是最近一次用户提问、原回答中可改写的文字和你的表达偏好,不发送思考过程或完整工具日志。
核心功能¶
润色与展示¶
主模型照常执行任务;润色只改表达,不改事实、条件与技术细节。代码围栏、行内代码和 Markdown 链接等会先替换为保护标记,润色后校验并还原(校验只能防止代码/链接丢失,不能保证语义绝对不变;重要结论请结合原文查看)。
实现上不接管或重写 DSH 原生回答渲染:润色结果由 turn-tail 渲染;就绪后通过 DOM 找到同一轮最近的 assistant-step 回答行并隐藏,提供「查看原回答 / 收起原回答」。找不到该行则不隐藏,不会破坏聊天。中间工具步骤、运行中、失败、未润色的回答不受影响;「查看原回答」仍是 DSH 原生渲染(含代码、图片、思考等)。
自动与手动(0.3.1)¶
设置里有两个开关:
- 启用最终回答润色:总开关。
- 自动润色所有回答:打开则每轮回答结束后自动润色(持续消耗额度);关闭(默认)则只在某条回答下方点「润色这段回答」时才润色该段,更省额度。
两种模式展示一致:原回答默认折叠,润色版为默认正文。
GenUI 兼容(0.1.1 起)¶
润色结果中的真实 dsh-ui 围栏由公开 GenUI embed 组件渲染。panel:true 围栏不在润色区重新发布或 append,请在原会话面板中查看。从旧版升级后需重启 DSH;已有润色结果不需重新调模型,加载新前端即可。
MVP 边界(使用前必读)¶
- 全局开关、渠道/模型选择、一段表达偏好;暂无每会话配置。
- 原回答流式显示不受影响;润色结果出现在回合结束处。
- 仅处理正常 stop、无工具调用、未中断的最后回答;子代理、失败、输出截断和无正文回答不处理。
- 润色默认最多等待 60 秒;失败或取消保留原回答,不自动重试、不继续驱动主模型。
- 超过 60,000 字符的原回答跳过。
- Chat 显示润色区;原生「复制回答」复制原文;润色区「复制润色结果」复制润色版。
- 已保存润色结果位于当前 profile 的插件 storage-domain 数据中,刷新或重启可恢复;卸载不会自动清理。
面向当前具备 agent/turn-stopping、ctx.llm.stream()、storageDomain 和 conversation.chat.turnTail 等接口的 DSH;宿主升级后需重新验证兼容性。
安装与启用¶
任选一种安装方式(Web 环境把命令里的 desktop 换成 web)。
从 GitHub 安装(README 原文):
dsh plugin --profile desktop add -w "github:Exception-H/dsh-speak-plain"
也可使用本地源码目录或已含编译产物的发行版 tgz(示例文件名 dsh-speak-plain-0.3.1.tgz),具体命令见仓库 README。
安装后重启 DSH,打开「设置 → 说人话」,选择已在 DSH 配置好的渠道和模型,勾选「启用」并保存。之后新完成的普通主会话回答会按你的开关策略润色;已有历史回答不会补跑。
典型用法¶
- 安装并重启后,在设置里选好润色用的渠道与模型,打开「启用最终回答润色」。
- 若希望省额度,保持「自动润色所有回答」为关闭(默认),在需要时在回答下方点击「润色这段回答」。
- 阅读默认显示的润色版;需要核对技术细节时展开「查看原回答」。
- 若回答中含 GenUI 组件,交互面板仍在原会话中操作;润色区为阅读向展示。
适用场景与注意¶
适合:希望 DSH 日常对话输出更易读、又希望保留原文与上下文一致性的用户;愿意用额外模型额度换表达清晰度,且能接受 README 中列出的处理范围与 60 秒超时等限制。
注意:
- 插件不代替你对源码的信任审查;安装前请阅读仓库与
VALIDATION.md中的验证说明。 - 自动润色会持续消耗所选模型额度;默认手动按需润色更可控。
- DSH 生态理念是「一切皆插件」;skillhub.cn 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
「说人话」把「最终回答可读性」做成可选插件:主模型专注任务,润色模型专注表达,界面默认大白话、原文可折叠可查。需要安装命令、开关说明与边界列表时,以 GitHub README 为准;浏览插件条目可访问 目录页。