dsh-prompt-optimization-master

dsh plugin --profile web add dsh-prompt-optimization-master

dsh-prompt-optimization-master

作者：Kirin（GitHub: ruiyukirin）

给 DeepSeek Harness 的输入框加一个提示词优化按钮：点一下，把还没发出去的草稿

改写成更清晰、更具体的提示词；再点一下，还原原文。

机制参考腾讯 WorkBuddy 的 EnhancePrompt（增强提示词）功能。

[English →](README.en.md) ｜ [更新日志 →](CHANGELOG.md)

---

安装

从 npm（包管理器）装，最省事：

dsh plugin --profile web add dsh-prompt-optimization-master

也可以直接装 GitHub 上的仓库：

dsh plugin --profile web add github:ruiyukirin/dsh-prompt-optimization-master

或者从 Releases 下载 tarball（压缩包）安装：

dsh plugin --profile web add "https://github.com/ruiyukirin/dsh-prompt-optimization-master/releases/download/v0.3.3/dsh-prompt-optimization-master-0.3.3.tgz"

兼容范围：package.json 的 engines.dsh 声明支持 >=0.2.0-rc.2 <0.4.0。

DSH 在安装与启动时会按这个范围检查，不满足会被直接拒绝（可以用

dsh plugin --profile web allow-version 显式豁免，但有风险）。

当前已在 DSH 0.2.1-rc.3 上实测通过（见下方「实测记录」）。

升级提示：0.3.1 修掉了"会思考的模型下一直转圈、没有产出"的问题

（详见 [CHANGELOG](CHANGELOG.md) 与下方「实测记录」）。用 0.3.0 或更早的请尽快升级。

0.3.2 只是补充兼容声明，功能与 0.3.1 完全一致。

0.3.3 没有新功能，全是体验与工程化打磨：设置页模型改成下拉框、超时可调、

失败原因弹提示、删掉调试残留、加了 CI 与清单测试。功能上与 0.3.2 等价，可升可不升。

关于名字：dsh-prompt-enhance 与 dsh-prompt-optimizer 在 npm 和 GitHub 上都已被

他人占用（且是同一产品定位），所以本插件改用 dsh-prompt-optimization-master，

发布前已逐项核查 npm 与 GitHub 三处均无占用。

---

它能干什么

在输入框工具栏右侧（模型选择器与发送按钮之间）出现一个 ✨ 按钮：

状态 · 图标 · 点击效果

有草稿、空闲 · ✨ · 把草稿发给模型改写，结果直接替换输入框

优化中 · ⏳ · 取消，中止请求并还原原文

已优化 · ↩️ · 恢复原文

• 输入了才出现：草稿为空时按钮自动隐藏——和 WorkBuddy 一样。

隐形占位符（零宽空格 U+200B）不算内容，不会被误判成"有输入"。

• 输入框忙的时候不出现：输入框正在提交/仲裁（submitting / adjudicating）时隐藏，

避免点出一个白跑的请求；但已优化过的结果仍可还原，不会被锁死。

• 改过就失效：优化之后如果你又手动改了草稿，"恢复原文"会自动退休，

不会把你后来的修改吞掉。

• 切会话自动复位：切换会话后，上一个会话的备份与错误提示不会残留。
• 不占对话上下文：优化走的是独立的模型调用，不创建会话、不写入会话记录，

也不读对话历史——只看「固定提示词 + 当前草稿」。这一点与 WorkBuddy 一致。

---

效果

同一段草稿，点一下 ✨ 之后：

优化前 · 优化后

 · 

草稿从「已经重启了，现在你检查一下任务的进度」被改写成一条目标明确、把要检查的几项

都点名的任务说明；右侧的 ✨ 同时变成了 ↶（还原原文）。

设置

设置 → 提示词优化——设置面板左侧栏里的一个独立条目，和「费用」「插件市场」「侧边卡片」并列：

项 · 说明

启用 ✨ 按钮 · 关掉后按钮从输入框消失。随时可以回到这一页重新打开

最少字符数 · 草稿短于这个长度就不显示按钮。留空 = 跟随宿主默认值

指定模型 · 默认跟随当前会话模型。勾选后从下拉框里挑——插件会向宿主要模型目录，按 provider 分组列出所有已注册的模型（显示「名字（ID）」，并标出会话当前用哪个）；宿主连不上的 provider 会点名说明。想填列表里没有的，选最后一项「手动填写提供方和模型 ID」——这个辅助调用能固定到便宜模型上，不影响你对话本身用哪个模型

超时时间（秒） · 超过这个时间就放弃本次增强并提示。留空 = 跟随宿主默认值（本机 60 秒）。可填范围由宿主给出（本机 5–300 秒），越界会被自动夹到边界

设置存在浏览器本地存储里，重装插件不会丢。

语言

按钮文案跟随 DSH 的界面语言（设置 → 语言），内置简体中文与英文两套。

走的是 DSH 官方 locale（本地化）服务，不是硬编码字符串。

---

工作原理

[输入框草稿]
    ↓ useInput(s => s.draft)
[✨ 按钮]（conversation.input.right 插槽）
    ↓ POST /dsh-prompt-enhance/enhance
[宿主半]  ctx.llm.stream({ system, messages })   ← 独立调用，不入会话
    ↓ 拼接 text-delta 分片
[写回输入框]  inputActions.setDraft(text)
    ＋ 原文存进备份，可一键还原

用的是插件自己的 HTTP 路由，不是 Remote。原因：桌面版界面跑在 dsh-app:// 协议上，

Electron 会把非静态资源的路径全部转发给宿主 HTTP 服务，所以相对路径 fetch 是通的

——但转发函数强制要求请求头 Origin: dsh-app://app，宿主侧的同源校验必须显式接受它，

否则桌面版下会全部 403。

提示词设计

两层结构，沿用 WorkBuddy 的思路并做了适配：

1. system —— 角色设定：提示词工程专家，服务于一个通用的编码/操作型 AI 助手。

明确列出该做什么、不该做什么（不许写教程、不许要代码片段、不许提用户没提的技术栈、

不许回答问题而要把问题改得更精确）。

2. user —— 任务模板 + 少样本示例。核心是语言锁定为最高优先级，

外加一组"坏输出 vs 好输出"对照，专门压制"用户输入是中文 → 应该用中文回复"

这类元话术。

结果还会做清洗：剥掉模型爱加的 Markdown 围栏和首尾引号。

---

结构

路径 · 作用

dsh/index.js · 宿主半：路由、提示词、模型调用、取消与错误码

client/client.js · 客户端半：三态按钮

cordis.patch.yml · 装载该插件的一行 insert

test/smoke.mjs · 宿主半离线冒烟测试（45 项检查）

test/client.test.mjs · 客户端半状态机测试（57 项检查，沙箱里跑真实代码）

test/reasoning-budget.mjs · 输出预算回归测试（29 项检查：思考识别、上限封顶、截断重试、超时）

docs/ · 调研报告：WorkBuddy 机制、命名诊断、机制对比、发布策略

docs/阶段0-探针结论.md · 插槽契约实测记录

---

实测记录（都踩过）

下面这些不是推测，是在真机上验证/踩坑得来的：

发现 · 说明

ctx.llm 不能直接访问 · Cordis 会抛 cannot get property "llm" without inject。必须用 ctx.get('llm') 或声明 inject。已修，并且冒烟测试现在会模拟这个守卫，防止回归。

推理会吃光输出预算 · 实测 deepseek-flash：一次短改写输出了 132 字符可见文本，但推理花了 2632 字符。512 token 的预算会全被推理吃掉、可见输出为 0。所以输出上限提到 4096，并把"触发上限"单独报成 truncated——截断的提示词比不优化更糟。

setDraft 是整体替换 · 官方源码注释：Replace the whole draft; newline 分段；光标落到末尾。

业务错误不能用 HTTP 状态判断 · 宿主的错误是 HTTP 200 + ok:false。客户端一度在这里提前清空了请求 id，导致 catch 把它当成"已被新请求取代"而直接返回——模型一失败按钮就永久转圈。已修，客户端测试锁死。

桌面版 Origin 是 dsh-app://app · Electron 会把非静态资源路径全部转发给宿主 HTTP 服务，但强制要求这个 Origin。严格同源校验在桌面版会全部 403。

零宽空格会被误判成"有输入" · 编辑器会塞入隐形占位符 U+200B，而 trim() 不会去掉它。WorkBuddy 会先剔除再计数；本插件原先没剔，导致草稿"看起来是空的"却能点按钮并发出无意义请求。已修（含测试）。

照搬提示词时会漏条款 · 双层提示词里，TASK_PROMPT 是 WorkBuddy 的逐字照搬（字符级只差 4 处），但 SYSTEM_PROMPT 漏了「约 800 字符」的长度上限和 2 组英文少样本——没有上限，模型会把一行需求写成多段小作文。已补回。

写死输出预算会被"思考型"模型打穿 · 实测 hy4-preview（onlyReasoning: true、canDisableThinking: false）：固定 4096 token 会全部被推理吃掉，可见输出 0 字，最后报 truncated；连「你好」两个字都要耗 89～114 秒才失败，界面表现就是一直转圈没有产出。同一份代码换成 deepseek-v4.1-flash 只要 1.7 秒就成功——这是模型相关的失败，不是插件坏掉。修法：输出预算按模型是否思考动态分配（思考型 32768 / 普通 4096），用官方 ctx.llm.resolveModelInfo() 判断（看 reasoning.efforts 是否只有 off 一档），并按模型自身的 defaultMaxTokens 封顶。不要写死模型名单。

宿主侧没有超时会永远转圈 · 模型慢或卡住时，客户端没有任何反馈。已加 60 秒硬超时，报 timeout；被判定为"不思考"却仍截断的，自动用大额度重试一次（两次共享同一个总时限）。

能力查询不能放在调用链上白等 · resolveModelInfo() 卡住时，原先会白等守卫时间。现已：结果按路线缓存（放在插件实例内，不用模块级全局）、守卫降到 1.2 秒、查询失败会记住，靠"截断重试"兜底。

DSH 0.2.1-rc.3 升级后不用改代码 · 2026-10-24 实测：DSH 从 0.2.0-rc.2 升到 0.2.1-rc.3 后，宿主半的 /dsh-prompt-enhance/config 正常返回，/dsh-prompt-enhance/enhance 真实调用模型 2.1 秒返回中文改写结果。客户端半依赖的四样东西在 0.2.1-rc.3 里全部还在：conversation.input.right 插槽、useInput、inputActions.setDraft、@deepseek-ai/dsh-client-locale@0.2.1-rc.3。结论：不需要为新版 DSH 改代码。

声明的兼容范围必须写在 engines.dsh · 原先写在自定义的 dsh.compatibility 里（dshReleases 那套），但 DSH 与插件市场都不读这个字段——在 app.asar

…(truncated)