前言¶
在 DSH 的 composer 里输入内容时,经常需要先起草,再发送。dsh-composer-polish 解决的是发送前的一个小动作:把输入框里的草稿改得更顺,同时不把这条消息发出去。
它把 ✨ 按钮放在 composer 工具行。点击后,插件使用 flash 模型改写当前草稿,再把结果回填到输入框。你可以先预览、编辑,再决定是否发送。
这是什么¶
dsh-composer-polish 是 tianji-qingtian 维护的一个 DeepSeek Harness 插件,许可证为 MIT,安装命令固定到 v0.1.4。
它的定位很窄:只做 composer 草稿润色。它不会代替主模型完成任务,也不会把润色结果直接作为聊天消息发送。
核心功能¶
按钮与状态¶
按钮位于 conversation.input.right,也就是 composer 输入工具行中。
- 草稿为空或纯空白时,按钮禁用。
- 润色中显示 spinner。
- 重复点击不会触发第二次请求。
改写路径¶
点击按钮后,插件通过 harness 内置 commands remote 发起 /polish,不使用自定义 wire protocol。
/polish 命令注册时 recordInput 为 false,原始草稿不写入会话日志;润色结果记录在 command/done。
flash 改写¶
插件使用零前缀 flash 改写:
- 模型固定为
deepseek-v4-flash。 - 使用流式调用。
reasoningEffort为off。- 约 2000 token 上限。
- 改写时主模型不运行,且不触碰主模型 prefix cache。
- 固定模型 id 缺失时,通过
llm.listModels做一次 flash 类模型目录回退。
回填而不是发送¶
润色结果通过 inputActions.setDraft 直接回填输入框,而不是发送为聊天消息。
- 图片附件不被处理,仅替换文本。
- 改写失败或返回空时,草稿保持不变,仅输出 console log,不显示 toast。
- 改写期间草稿发生变化时,跳过回填,较新编辑优先。
语言与术语¶
改写跟随草稿语言和语气。代码块、文件路径、命令行、标识符和技术术语保持原样。
按钮标签和提示跟随 harness locale 服务,支持 zh/en。
安装与启用¶
准备 dsh CLI¶
需要先有 dsh CLI 在 PATH 上。如果平时只用 npx 运行 harness,可以先全局安装:
npm install -g @deepseek-ai/dsh
如果偏好 pnpm:
pnpm add -g @deepseek-ai/dsh
也可以不安装全局命令,后续命令使用 npx @deepseek-ai/dsh 前缀运行。
安装插件¶
dsh plugin --profile web add "github:tianji-qingtian/dsh-composer-polish#v0.1.4"
安装后重启对应 profile 的 harness:
dsh --profile web
重启后,composer 工具行会出现 ✨ 按钮;/polish 命令会在 host half 加载后注册。可以在 Settings → Plugins 中查看 dsh-composer-polish。
典型用法¶
1、在 composer 输入框里输入草稿。
2、点击工具行中的 ✨ 润色 / Polish。
3、几秒后,润色文本会替换输入框中的草稿。
4、预览、编辑,确认没问题后再按发送。
适用场景与注意¶
适合需要频繁整理 DSH composer 草稿、希望发送前快速改顺文本的场景。
使用注意:
- DeepSeek Harness 处于 developer preview,且迭代较快,可能出现兼容性破坏变更。
- 插件会以当前 dsh 进程权限运行。安装前应检查源码与 MIT 许可证。
- 草稿超过 50 KB 会在改写前截断。
- 改写期间草稿发生变化时,会跳过回填,较新编辑优先。
- 原始草稿通过
recordInput: false不写入会话日志;润色结果会记录在command/done。 - 改写模型固定为
deepseek-v4-flash;如果 harness 重命名模型 id,目录回退会选择一个 flash 类替代模型并记录一行日志。 package.json声明 Node 版本为^22.19.0 || >=24.0.0,packageManager为pnpm@11.14.0。
小结¶
dsh-composer-polish 把“润色”放在发送前:它只改输入框里的草稿,不发聊天消息,不动图片附件,也尽量保留代码块、路径、命令行和技术术语。对于 DSH composer 的日常输入,这是一个比较克制的前置整理工具。
仓库地址:https://github.com/tianji-qingtian/dsh-composer-polish