前言¶
在 DeepSeek Harness（DSH）里做对话或智能体开发时，模型输出往往带着固定套路：开头寒暄、结尾「如有疑问欢迎提问」、公文式大词，以及「首先…其次…综上所述」的机械结构。这些内容对读代码、对事实没有帮助，还会拉长上下文。手工删改每条回复成本高，也很难保证代码块和数字不被误改。
dsh-shuorenhua（说人话）是社区维护者 neuneed 发布的 DSH 原生插件，分类上属于模型推理相关能力：它在宿主已配置的 LLM 上做一次定向改写，把回答压成更直白的表述，同时尽量保留代码、公式和具体指标。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-shuorenhua 面向 DeepSeek Harness 全栈场景：在 Web 聊天里给每条助手消息的操作栏增加「说人话」入口，点击后通过同源 SSE 流式返回润色结果；在 Agent 侧还可注册 shuorenhua_simplify 工具，供自主智能体调用。
项目托管于 GitHub（neuneed/dsh-shuorenhua），采用 MIT 许可证；当前 package 版本为 0.1.0。社区插件目录页见 SkillHub 条目。DSH 生态强调「一切皆插件」；目录站点与 DeepSeek / 幻方无官方从属关系，安装前请自行审阅源码与许可证。
核心功能¶
Web 交互¶
插件通过 DSH 客户端插槽，把按钮嵌在助手消息操作条中（README 说明位于复制与分支按钮之间，order: 12）。点击后弹出对话框，以打字机方式流式展示润色文本，并展示原文字数、润色后字数及精简比例，支持一键复制；可按 ESC 或点击遮罩关闭。
改写规则（README 明示）¶
润色思路对齐社区项目 MrGeDiao/shuorenhua、Humanizer-zh 等，主要包括：
- 去名词化：把「完成了对…的调整」类表述改成直接动词句。
- 去重复：删掉与前文语义完全重叠的复述句。
- 去行文包装：去掉「简而言之」「值得注意的是」「综上所述」等过渡套话。
改写时采用占位符保护代码块（ fenced code）、$$...$$ 公式、行内代码与链接；README 强调不得把具体数字改成模糊概括（例如保留「从 24 次降到 7 次」这类表述）。
宿主与 Agent 双轨¶
- Host：复用 DSH 的
ctx.llm与既有 WebServer，在同端口提供/shuorenhua/stream等 SSE 路由，不额外开端口。 - Agent 工具：默认向 Agent 注册
shuorenhua_simplify；机制为「LLM 流式生成优先 + 离线规则引擎兜底」，README 说明在宿主未配大模型时仍可走兜底改写。 - 缓存：默认把每条消息的润色结果写入 Host 存储（
ctx.storageDomain），再次打开同一消息可直接读缓存，避免重复调用模型；可通过配置关闭或限制 LRU 条数。
安装与启用¶
前提：本机已安装 dsh CLI，且 Node 版本满足插件要求（^22.19 || >=24），DSH 版本 >=0.1.0-rc.6（见 package.json engines）。
用户侧推荐从 GitHub 一键安装到 Web profile：
# 一键安装到 Web profile 中
dsh plugin --profile web add github:neuneed/dsh-shuorenhua
# 启动 DSH Web
dsh web
也可在 DSH Web 侧边栏的「插件 (Plugin)」管理页，输入 github:neuneed/dsh-shuorenhua 进行安装。
插件以当前 dsh 进程权限运行；安装前请检查仓库代码与 MIT 许可证是否可接受。
可选配置¶
在 cordis.patch.yml 中可为插件实例设置（字段均来自 README）：
- insert:
- id: dsh-shuorenhua
name: dsh-shuorenhua
config:
# 可选：指定模型提供商（缺省时自动使用 DSH 当前激活的默认主模型）
provider: deepseek-official
# 可选：指定模型名称（缺省时自动使用当前主模型）
model: deepseek-chat
# 可选：是否向 Agent 注册 shuorenhua_simplify 工具（默认 true）
enableTool: true
# 可选：是否持久化每条消息的润色结果（默认 true）
enableCache: true
# 可选：缓存条数上限（LRU 逐出，默认 100）
cacheMaxEntries: 100
未指定 provider / model 时，润色调用会跟随 DSH 当前主模型。
典型用法¶
在 Web 里润色一条回答¶
- 执行
dsh web打开 Web 界面并完成对话，等待助手回复。 - 在该条回复下方的操作栏点击「说人话」。
- 在弹窗中等待流式输出结束，查看字数对比；需要时点击复制，将润色结果贴回笔记或工单。
在 Agent 流程中调用¶
保持 enableTool: true（默认）时，自主智能体可调用 shuorenhua_simplify 对长文本做同样风格的简化；具体入参与返回形态以实现仓库 src/runtime.ts 与 Agent 注册逻辑为准。若只想用 Web 按钮、不希望暴露工具，可将 enableTool 设为 false。
适用场景与注意¶
适合：日常在 DSH Web 里阅读长回答、写文档或复盘对话，希望快速去掉 AI 腔而不愿手改；需要在 Agent 管道里对模型输出做二次「说人话」处理；学习 DSH 插件双端架构时，README 还指向 深度技术分享文档。
注意：
- 润色仍是一次 LLM（或兜底规则）改写，重要事实、合规表述应人工复核。
- 缓存开启时，润色结果会落在 Host 存储；在共享环境需评估数据留存策略。
- 开发者本地调试需 clone 源码、
pnpm install与软链至~/.dsh/profiles/web/node_modules等步骤，见仓库 README「本地源码开发与调试」一节；正文不展开 clone 流程，避免与「一键安装」路径混淆。
结尾¶
dsh-shuorenhua 把「去 AI 味、保代码与数字」做成 DSH 里的一键操作和可选 Agent 工具，复用宿主模型与同端口 SSE，并支持结果缓存。若要在环境里试用，可从目录页了解分类与简介，再按官方命令安装：
- 目录页：https://www.skillhub.cn/plugins/neuneed/dsh-shuorenhua
- 源码与 README：https://github.com/neuneed/dsh-shuorenhua
