前言¶
在 DeepSeek Harness(DSH)里跑 Agent 时,assistant/message 往往附带大段 reasoning:英文、工具名、步骤拆解,对调试有用,却不宜原样当「日记」给人看。若只把会话导出,要么噪音太多,要么得自己筛。下面介绍社区插件 dsh-inner-voice(维护者 95267,分类:记忆):在本地按日归档推理片段,可选调用小模型改写成一行短句,并在设置页只读展示。
这是什么¶
dsh-inner-voice 是 DeepSeek Harness 的服务端 + 客户端插件。服务端只订阅会话事件;客户端只读本地 HTTP 路由。当前版本 0.2.0,许可证 MIT,源码见 GitHub,目录页见 SkillHub。
一句话:把 Agent 的 reasoning 记成按日划分的 inner-voice log,改写成短行,在 Settings → Inner voice 面板展示。
核心功能¶
插件行为可分成三块,与 README 中的表格一致。
A:归档(archive)¶
监听每条 assistant/message 的 reasoning:去掉 Markdown 标记,取第一句,长度受 maxChars 限制,追加写入:
~/.dsh/inner-voice/YYYY-MM-DD.md
单条日志形态示例:
- 22:12
小鱼:又来了,这问题问第七遍了。
raw: Now the user asks whether the plugin is loaded...
B:改写(rewrite)¶
将同一段 reasoning 发给可配置的小型 chat 模型,保留 一行不超过 20 字 的表述。若推理纯属流程、无态度,输出 (无) 并丢弃,不虚构情绪(silence rule)。
C:面板(panel)¶
在 Settings → Inner voice 按日列出条目:上方为改写短行,下方灰色为 raw 摘录。数据由只读路由 /dsh-inner-voice-api 提供,面板不向外部发送内容。
关闭改写时(见配置 rewrite: false),可只做归档,不调用模型。
安装与启用¶
在 PowerShell 中执行(命令来自官方 README):
dsh plugin --profile <your-profile> add dsh-inner-voice
安装后需 重启应用。服务端插件没有 HMR,不重启不会加载新插件。
在 profile 的 cordis.patch.yml 中可通过 id: dsh-inner-voice 覆盖下列项:
| Key | Default | 说明 |
|---|---|---|
enabled |
true |
总开关 |
minChars |
160 |
过短的 reasoning 跳过 |
maxChars |
400 |
raw 摘录上限 |
label |
inner voice |
改写行前缀 |
rewrite |
true |
设为 false 则仅归档 |
model |
deepseek-chat |
任意 OpenAI 兼容 chat 模型 |
apiKey |
'' |
空则读环境变量 DEEPSEEK_API_KEY |
rewritePrompt |
内置 | 可改写成其它人设 |
不要把 API Key 写进插件包;应放在用户级 profile patch 或环境变量中。
典型用法¶
- 按上文命令把插件装进指定 profile,重启 DSH。
- 若需要改写,配置
apiKey或DEEPSEEK_API_KEY;仅本地归档则设rewrite: false。 - 正常与 Agent 对话;当 reasoning 长度 ≥
minChars时,服务端写入当日 md 文件,并在开启改写时各发起一次小型 chat 调用。 - 打开 Settings → Inner voice,通过
/dsh-inner-voice-api查看按日汇总。
改写的目的在 README 中写得很直接:原始 reasoning 冗长、常含工具名,原样展示像「掀开引擎盖」——准确但难读;改写是可读层,不是装饰。
适用场景与注意¶
适合谁:希望在本地保留 Agent「内心活动」轨迹、又不想在 UI 里堆满英文推理的 DSH 用户;需要轻量「记忆」类旁路日志、而非改聊天 transcript 本身时。
隐私(资料原文):
- 日志均在
~/.dsh/inner-voice/本地写入。 rewrite开启且配置了 key 时,每记录一轮会向配置的 OpenAI 兼容端点发送 该次 reasoning 摘录一次;除此以外不离开本机。- 面板只读本地路由,不对外发送。
已知限制:
- 每记录一轮改写约消耗一次小型 chat 调用(约 100–200 tokens)。
- 面板不能 inline 渲染会话里的 reasoning;要 inline 需另做客户端渲染,本插件刻意不做。
- 日志为纯文本,无自动 retention;旧文件可自行删除。
安装前:插件以当前 dsh 进程权限 运行,安装前应自行查看 源码与 MIT 许可证。社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-inner-voice 把会话里的 reasoning 落成按日的本地 inner-voice 日志,可选一行改写并在设置页只读展示,在「可审计」与「可读」之间加了一层可控的摘要。需要细节时以 GitHub README 与 目录页 为准。