/
← Back to home@HTRP1486

dsh-one-click-polish

一键润色 / 扩写 / 自动驾驶 for DeepSeek Harness

Stars
0
Language
JavaScript
Created
Oct 26, 2026
Updated
Oct 26, 2026
Tools
GitHub repo

Introduction

一键润色 / 扩写 / 自动驾驶

npm license

给 DeepSeek Harness（dsh）桌面端的输入框加一组动作：润色、扩写、自动驾驶。所有模型调用都用你当前会话正在用的那个模型，结果直接写回输入框。

  • 润色：按三档深度重写草稿
  • 扩写：把一句话扩写成能直接开工的需求说明
  • 自动驾驶：让 AI 读对话、写下一步提示词、发给助手，一轮接一轮推进到你设定的目标

一句安装：

dsh-one-click-polish

装好之后，输入框左下角多一排按钮：

[+ 完全权限]  润色   深度   扩写   自动

需要什么

项要求
dsh桌面端（Web UI），带 settings.section / conversation.input.left 槽位
Node≥ 20
模型会话里能正常发消息即可；润色用的就是这个模型

没有额外依赖，不需要 API key——插件借的是 dsh 已经配好的模型通道。

安装

两种来源，功能完全一样：

来源填什么更新按钮
npmdsh-one-click-polish✅ 有「可更新」
GitHubhttps://github.com/HTRP1486/dsh-one-click-polish❌ 只能看提交

方式一：npm（推荐）

打开 dsh → 设置 → 插件 → 添加插件，输入框里就填包名：

dsh-one-click-polish

不用加 npm: 前缀，也不用加版本号（默认装 latest）。

命令行等价写法：

dsh plugin --profile <你的 profile 名> install dsh-one-click-polish

为什么推荐这个：npm 上有版本号，dsh 能比对，所以插件列表里会出现「可更新」和「卸载」两个按钮。缺点是更新要走一遍发布流程。

方式二：GitHub

输入框里填仓库地址：

https://github.com/HTRP1486/dsh-one-click-polish

等价写法都行：

https://github.com/HTRP1486/dsh-one-click-polish
https://github.com/HTRP1486/dsh-one-click-polish.git
github:HTRP1486/dsh-one-click-polish

末尾不要加斜杠。加了会报 a URL must point at a git repository or a tarball —— dsh 的判断规则是 ^https?://主机/用户/仓库(.git)?$，最后一段不允许出现 /。

为什么用它：跟最新提交走，不用等发版。但没有「可更新」按钮——想更新就是重装一次（remove 后 install）。

其他方式

方式做法
本地目录target 填仓库的绝对路径，如 D:\Documents\dsh-one-click-polish。改代码即时生效，适合开发
Release 包从 Releases 下 .tgz，target 填该文件的绝对路径

三种方式怎么选

只想用        → npm
要用最新代码   → GitHub
自己在改它     → 本地目录（link）

装完重启 dsh。判断是否成功：输入框左下角出现 润色 | 深度 | 扩写 | 自动，设置里多出「润色 / 扩写」一页。

版本号

三个地方保持同步，每次发布一起改：

位置当前
package.json 的 version1.2.0
npm 的 latest 标签1.2.0
GitHub 的 tag / Releasev1.2.0

装不上时

报错原因
a URL must point at a git repository or a tarball地址末尾多了斜杠，或不是 .tgz 结尾
a local path must be absolute填了相对路径或 ./xxx
unmet DSH version requirement你的 dsh 版本低于插件要求
装完没生效没重启。改 profile 的 bundles 后必须重启，刷新页面不够

用法

润色

打字 → 点 润色 → 草稿被重写并写回。

档位胶囊点一下循环 轻度 → 标准 → 深度（默认深度，记在浏览器本地）。它决定动手前查多少资料：

档位动手前改写力度
轻度什么都不查只改错别字、标点、语法
标准AI 翻项目目录和 dsh 配置目录，找相关文件改措辞和句式、去冗余
深度标准 + 联网检索（必应 / 百度 / GitHub）重组结构、拆长句、换精准用词

检索不是关键词匹配：Host 把 list_dir / read_file / search_files / search_content / web_search 交给模型，由它自己决定查什么、要不要再追一轮。轮数、检索时长、改写时长都能在设置里调，默认 4 轮 / 45 秒 / 120 秒。只读，越出项目目录与 dsh 配置目录的路径会被拒绝。

改动前后可以对比：草稿被覆盖，Ctrl+Z 能撤回。

扩写

输入一句粗需求，例如 帮我写一个登录功能，点 扩写。

它先判断你要的是哪一种，再按那种形态写，第一行会说明它的判断：

形态什么时候输出
要造的你打算做或让别人做需求说明：做什么、边缘怎么表现、怎么算做完
要货的你想要成品本身直接给成品（提示词 / 文案 / 模板 / 清单），不解释怎么设计
要判断的句子里藏着一个选择摆出取舍 + 带条件的建议，不给方案书
要问的缺一个事实，说了也白说只问那一个问题，不扩成问卷

它不会替你决定范围——不会自己宣布「不做注册、不做找回密码」，而是把这类分叉摆出来、说清楚每个选择会改变什么。它会读完整的对话历史（最近的对话保留全文，更早的压缩成一行摘要），所以知道你在做什么产品、哪些决策已经定了。

自动驾驶

点 自动 弹出面板：

自动驾驶
○ 循环几次结束      [ 5 ]
☑ 限制运行时间      [ 0 ] 小时  [ 30 ] 分钟
○ 直到达成目标结束

目标（可选）：写清楚要达成什么，达成后自动停；不填就只看轮数
[                                    ]

[ 启动 ]

点启动 → 确认弹窗 → 才真正开始。运行中再点 自动：

运行中 3/5 · 已跑 12 分钟
上下文：8 条消息 / 1300 字
查看驱动 AI 读到的上下文

[ 中断 ]  [ 结束循环 ]
  • 中断：掐掉当前这一轮，循环继续，它会重新判断再发一条
  • 结束循环：整个关掉
  • 轮数用尽 / 时间到 / 目标达成 / 出错 / 你点停 —— 五种情况都会立刻停机

停止条件可以叠加：循环 5 次 + 填个目标 = 最多 5 轮，做完了提前收工。

它读到的对话你能看见：面板里的「查看驱动 AI 读到的上下文」会显示这一轮实际传给驱动 AI 的对话全文。

它的思考和调用也能看见：面板里的「查看思考与调用」会列出每一轮的推理、它调用了哪个工具、参数是什么、返回了什么，以及最终发给助手的那条消息。按类型上色：

思考 1      The draft is vague. I should look at the project directory…
list_dir    - index.js  - client.js  d locale
search_files  d dsh-one-click-polish  - cordis.patch.yml
思考 2       Likely a DSH plugin. Let me check the config directory…
已发送 1     请把这句话改得更正式：…

这份记录来自同一个任务表（GET …/progress?id=autopilot-<sessionId>），所以润色/扩写时那个进度窗也能看到同样的过程。

右侧贴边窗口：点「在右侧显示」，思考窗会滑入屏幕右缘，跟着当前对话实时刷新（每 500ms 一轮），可以上下翻、折叠、关闭。切到别的对话时它会自己跟过去；那个对话没有记录时就是空的。

按钮会报告上一次怎么结束的：

按钮含义
🔵 转圈 自动 2/5正在跑
🟢 已完成跑满轮数，或驱动 AI 判断目标达成
🔴 出错出错停下，点开能看到错误全文
🟡 意外停止它自己停下了：想不出下一步、助手一直在忙、或到了时长上限
🟡 已中断你手动停的

点开按钮能看到为什么停、读了哪些文件、完整思考记录，底部有「从中断处继续」（停下的情况）或「重新开始」+「清除状态」。

设置页有每个对话的自动运行日志：它读了哪些文件、调用了什么、发了什么，按会话归档，重启后仍在。长工具行和长思考行默认收起，点一下展开，收起时保留首行预览。

换窗口 / 重启 会怎样

场景结果
切会话、切标签、最小化继续跑（在 Host 进程里）
切走再回来继续跑，按钮上轮数跟着涨
重启 dsh不自动跑，面板里给「从中断处继续」按钮，点了才续

每轮都会把进度写进 profile 目录的 .one-click-polish-autopilot.json，重启后据此提供恢复入口。正常结束会自动清掉。

设置

设置 → 润色 / 扩写：

项说明
模型来源跟随当前对话（默认）用输入框里选中的模型；固定模型 始终用指定那个
模型选 固定模型 后出现，带搜索的下拉框，按供应商分组
思考程度照 dsh 的 Default / Low / High / Max 做，选项按该模型实际支持的档位生成，不支持就整栏隐藏；换模型时旧档位自动回落
等待助手完成上一轮的上限自动驾驶要发下一条时助手仍在忙，等多久放弃。默认 5 分钟，可到 60
检索预算查资料总共能用多久、最多几轮。默认 45 秒 / 4 轮
改写预算模型写答案这一步最多等多久。默认 120 秒
自动运行日志每个对话的自动驾驶记录，按会话归档

改动先留在页面上，点 保存 才写入 profile，撤销修改 回到上次保存的状态。

配置

在 profile 的 cordis.patch.yml 里覆盖本行 config：

- id: one-click-polish
  config:
    modelSource: follow      # follow | fixed
    provider: ''             # modelSource 为 fixed 时必填
    model: ''
    reasoningEffort: ''      # '' = 默认；否则必须是该模型支持的档位
    defaultStrength: strong  # light | standard | strong
    maxInputChars: 12000     # 单次输入字符上限
    timeoutMs: 120000        # 单次改写预算
    exploreMs: 45000         # 检索预算
    exploreRounds: 4         # 最多检索几轮
    idleWaitMs: 300000       # 等助手空下来的上限
    instruction: ''          # 追加给模型的额外要求

原理

  • 模型解析在 Host 侧：会话日志里最新的 model/selection → 最近一次 request/header → profile 默认模型。所以模型选择器切到哪个就用哪个，切了还没发消息也认得。
  • 润色 / 扩写是手工构造的 llm.stream()：不写会话日志、不开 Turn、不动对话历史，只借一次模型能力。
  • 长任务用 202 + 轮询：桌面 webview 会掐断长时间静默的请求，所以 POST …/polish 立刻返回 202，浏览器每 700ms 轮询 GET …/progress 取结果。
  • 自动驾驶用 agent.followup() 往会话里追加用户消息并唤醒，用 await agent.whenIdle() 等这一轮跑完。每轮按 session id 重新取 agent，所以切换会话销毁重建 agent 也不影响。

HTTP 接口

都在 /plugins/dsh-one-click-polish 下：

方法路径作用
POST/polish提交润色/扩写任务，返回 202 + requestId
GET/progress?id=轮询任务状态与结果
GET/settings读/写设置与模型目录
GET/efforts?provider=&model=某模型支持的思考档位
GET/POST/autopilot读/写自动驾驶状态，?resumable=1 列可恢复的运行
GET/runs按会话归档的自动运行日志；?sessionId= 取某会话
GET/status当前会话解析到的模型
GET/diag排查用：会话、目录、上下文快照

文件

文件作用
index.jsHost 半身：模型解析、检索、改写、轮询任务、自动驾驶驱动
client.js浏览器半身：工具栏按钮组、进度窗、右侧思考窗、设置页
cordis.patch.yml插件行声明
locale/*.json插件管理页的标题与描述
TESTING.md测试纪律：自动驾驶会真往会话里发消息，不能拿真实对话试

出问题怎么查

按钮没出现

  1. 确认插件真的加载了：设置 → 插件 里能看到 dsh-one-click-polish
  2. 重启 dsh（改 package.json 的 bundles 后必须重启，刷新页面不够）
  3. 打开 http://127.0.0.1:<dsh 端口>/plugins/dsh-one-click-polish/status，返回 {"ok":true,...} 就是活着

按钮出现了但点了没反应

打开同一端口下的 /diag，看 processCwd 和 profileDir。如果 profileDir 是空的，说明插件认不出 profile 目录（判断依据是那个目录里要有 cordis.patch.yml，且不含 package.json + client.js）。

润色一直转圈不结束

设置页把「检索预算」和「改写预算」调大。深度档要联网检索，网络慢的时候 45 秒不够。

自动驾驶自己停了

按钮颜色会告诉你原因，点开有全文：

颜色原因
🟡 意外停止驱动 AI 想不出下一步 / 助手一直在忙（超过等待上限）/ 到了时长上限
🟠 已中断你自己点的
🔴 出错具体错误在面板里，红字
🟢 已完成跑满轮数或目标达成

停下不等于失败：底部有「从中断处继续」，从已跑的轮数接着来。

想复盘它做了什么

设置 → 润色 / 扩写 → 自动运行日志，按会话列出每一次运行：读了哪些文件、调用了什么工具、发了什么消息。或者面板里点「查看思考与调用」。

看到的上下文不完整

长对话会被压缩：最近的保留全文，更早的压成一行摘要，中间放不下的丢掉并标注「中间省略了 N 条」。面板上会显示「压缩省略 N 条」。想让它看更多，就在目标里写得具体一点。

隐私

  • 插件只读本地文件。越出项目工作目录和 dsh 配置目录的路径会被拒绝。
  • 敏感文件名和目录一律不读不列：cookie、凭据、id_rsa、.env、微信 / QQ 数据目录、node_modules、.git 等。
  • 自动驾驶每轮的推理、工具调用、发出的消息会写到 profile 目录下的 .one-click-polish-log.json，按会话归档。这个文件只在你的机器上，不会上传。不想要就删掉它。
  • 插件不会把运行时数据写进自己的源码目录。

许可

MIT