DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

ruiyukirin /

ruiyukirin/dsh-prompt-optimization-master

Verified

DSH 输入框一键提示词增强按钮 | One-click prompt enhancement for the DeepSeek Harness composer: rewrite the unsent draft into a clearer, more specific prompt, restore the original with one click. Ported from Tencent WorkBuddy's EnhancePrompt design; independent model call that never touches the session log.

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@4a11ef20

dsh-prompt-optimization-master

作者:Kirin(GitHub: ruiyukirin)

给 DeepSeek Harness 的输入框加一个提示词优化按钮:点一下,把还没发出去的草稿 改写成更清晰、更具体的提示词;再点一下,还原原文。

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

English → | 更新日志 →


安装

从 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 与下方「实测记录」)。用 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 里搜不到 dshReleases。真正的判据是顶层 engines.dsh(市场也认 dsh.engines.dsh):声明了它就只按它决定,并忽略 peerDependencies。已从 0.3.2 起改正。反过来,写进去就会被强制执行,所以上限不能乱写。
错误塞进 title 等于没提示 0.3.2 及以前,失败时按钮变红、原因塞在 title 属性里。触屏、键盘、以及"不知道要悬停"的用户根本看不到为什么失败,表现就是"点了没反应"。0.3.3 改成浮动提示条(9 秒自动消失,点一下收),并保留 title 给鼠标用户。
调试残留会一直往用户磁盘写东西 修 i18n 时曾加过一段 TEMPORARY diagnostic:每次插件加载都往 localStorage 写一份 locale 诊断快照(内含内部函数类型与 locale 键列表)。bug 修好了、快照却留在代码里。0.3.3 已删除——临时诊断代码必须在当次修复里一并清掉。
设置页让用户手填模型 ID 是设计错误 普通用户不可能知道 deepseek-flash 这种字符串写对没有。0.3.3 改成向宿主要模型目录(GET /models → ctx.llm.listProviders() + listModels()),按 provider 分组下拉。宿主连不上的 provider 必须点名,不能静默从列表里消失,否则"我的模型不见了"无从排查。
确定性失败不该重试 0.3.2 只对"输出被截断"重试。0.3.3 起网络抖动、429、5xx 也会用 400ms 退避重试一次;但 no_route / llm_unavailable / timeout / cancelled 这类再试也一样的失败明确不重试——重试只会把用户的等待时间翻倍。

开发时的两个硬约束(实测,不是猜的)

  • 客户端半改动 → 刷新页面。 HMR 只在模块首次加入模块图时推送一次,之后的改动不会自动推。
  • 宿主半改动 → 重启 DSH。 Loader 会把插件模块缓存在进程里。以下三种方式都实测过, 都不会重新导入模块:禁用/启用插件、重新应用 bundle、改写 profile 的 cordis.patch.yml。

所以调这个插件时,客户端改动刷新即可,宿主改动要重启一次。

离线测试

npm test        # 不需要 DSH,四套测试一起跑(204 项检查)
  • 清单(test/manifest.mjs):盯"声明的字段到底有没有人读"。断言 engines.dsh 存在且是非空范围、dsh.compatibility 已删除、files 不含 test、CHANGELOG 记了当前版本——0.3.2 那个"字段是死的"的坑从此会被红灯挡住。

  • 宿主半(test/smoke.mjs):假 Cordis ctx + 真 HTTP 服务,覆盖路由注册、请求守卫 (含 dsh-app://app 源)、提示词组装、分片累积、结果清洗、全部错误码、取消、 网络错误的退避重试、模型目录路由,以及 llm 服务缺席。

  • 客户端半(test/client.test.mjs):用 node:vm 把真实的 client/client.js 跑起来,配一个极简 React 与假 fetch,驱动按钮走完全部状态转换——空草稿隐藏、 增强、还原、取消、失败还原、宿主未加载提示、"手动改动后备份失效",以及设置页的 模型下拉框、超时夹紧、失败提示条。

  • 输出预算(test/reasoning-budget.mjs):锁死"思考型模型打穿额度"这个坑—— 额度是否跟随模型能力、模型自身上限是否封顶、卡住的查询会不会拖慢改写、 截断是否重试、无效重试是否被抑制。真实的 60 秒超时是按需跑的,因为它会 拖长整个测试:

    DSH_PE_SLOW_TESTS=1 node test/reasoning-budget.mjs
    

持续集成

.github/workflows/test.yml:推送到 main 或提 PR 时,自动在 Node 20 / 22 两档上跑 npm test。测试不碰 Windows、也不碰真实模型,所以能在 Linux runner 上直接跑。

无头调试技巧

拿不到浏览器控制台时,可以让客户端把数据写进 localStorage,再从磁盘上的 leveldb 读:

C:\Users\yuqil\AppData\Roaming\@deepseek-ai\dsh-desktop\Local Storage\leveldb

.wb-research/read-ls.mjs 是配套的取值脚本。

⚠️ 注意:不要用 shell 的 Get-Content / WriteAllText 改写 cordis.patch.yml。 Windows PowerShell 会按 ANSI 解码无 BOM 的 UTF-8 文件,一读一写就把中文注释变成乱码, 还可能吃掉换行导致 YAML 解析失败。要改就用能保证 UTF-8 的编辑工具。

许可

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit 4a11ef2028f8

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout