dsh-prompt-optimization

dsh-prompt-optimization · 提示词优化

中文 | English

把输入框里那句“帮我把周报弄一下”，变成一份任务明确、主旨清晰、无歧义、计划合理、目标准确的专业提示词——点一下就完成，不满意一键撤回。

这是一个 DeepSeek Harness（DSH）Web 插件：「优化提示词」按钮位于输入框工具栏、紧挨模型选择器；改写结果直接回填草稿，草稿不被覆盖（改写前后可随时撤回）。插件的设置页可配置模型来源、API Key 与多候选评估，支持本地或在线 OpenAI 兼容接口。

---

为什么需要它

自然语言需求往往含糊：缺背景、缺范围、缺验收标准，模型只能猜。这个插件把“猜”前置成一次显式改写：

• 改写目标：任务明确 / 主旨清晰 / 无歧义 / 条理清晰 / 计划合理 / 目标准确
• 改写原则：忠实原意（不新增需求、不编造事实），信息不足时给标注假设或最多 3 条关键待确认问题，绝不把“反问用户”当成输出
• 深度自适应：短需求给短提示词，复杂需求才展开「目标 / 背景 / 任务 / 约束 / 步骤 / 输出格式 / 验收标准」结构

---

功能

插件界面与词典提供简体中文、繁体中文、日语和英语。

---

安装

方式一：插件管理器（推荐）

在 DSH 中打开「设置 → 插件」安装，或使用包坐标：

plugin_manager install_bundle target=dsh-prompt-optimization

国内网络可指定镜像源：

plugin_manager install_bundle target=dsh-prompt-optimization registry=https://registry.npmmirror.com

需要固定版本时写完整版本号，例如 target=dsh-prompt-optimization@1.1.0。

方式二：源码安装

git clone https://github.com/KukaNo996/dsh-prompt-optimization

plugin_manager install_bundle target=<克隆目录的绝对路径>

安装后：插件行出现在「设置 → 插件」，设置页出现在「设置 → 提示词优化」。

---

快速开始

1. 在输入框写下需求，例如 帮我把周报弄一下
2. 点击工具栏「优化提示词」
3. 查看改写结果，满意直接发送；不满意点「撤回」
4. 首次使用若提示模型不可用，前往「设置 → 提示词优化」选择模型来源

---

设置项

可随时用「测试连接」验证当前配置；配置未保存到可调用状态时，保存仍会成功，但优化会返回可读的错误提示。

问题分类

动笔前先判定原文属于哪一类，类型决定该问什么，不用同一套模板套所有问题：

问问题时不回答

用户问「什么是闭包」「React 和 Vue 选哪个」时，插件不会以大模型口吻直接回答。 它做的是把问题改写成一条可执行的提示词，交给别的 AI 去答：

• 问题必须拆成至少 3 个分析维度，只润色成一句问话算不合格改写；
• 六个可选维度：定义与核心概念、原理与机制、分类与对比、应用与示例、优点与局限、实践建议；
• 同时写明读者水平、覆盖粒度、是否要来源，并明确「不要只给一句定义就结束」；
• 知识理解类即使原文只有五六个字，也按详尽档系统展开。

例如原文「什么是闭包」会改写成要求覆盖定义、形成机制、常见形态、典型用途、 常见误区、与其它语言同类机制的区别，并每点配最小代码片段的任务说明。

篇幅分五档

改写长度由原文字数 + 问题类型共同决定，不是所有需求都要优化成一大串：

同一篇内不跨档：原文是极短档，就不会写到详尽档。知识理解类即使原文很短也落到详尽档。 判据是「原文写了多少、问题需要多深」，不是你还能补充多少。宁可偏短一档。

中断与等待时长

优化过程中点击转圈即可中断，草稿会恢复为原文。 中断会同时结束客户端请求与主机侧的模型调用，不会让模型在后台继续生成。

「最大等待时长」限制单次优化的总耗时，默认 15 秒，最低 10 秒。 该时长覆盖整个流程——上下文压缩、多候选生成与评审都在其中， 而不是只算最后一次模型调用。超时后插件会自动中止并明确提示。

根据上下文优化提示词（Beta）

设置页的「根据上下文优化（Beta）」默认关闭。开启后：

1. 读取当前会话中你真正输入过的消息（宿主注入的运行时上下文等不参与）；
2. 交给模型压缩成一份简短偏好简报——表达习惯、常用措辞、关注的主题、已排除的做法；
3. 用这份简报作为参考改写提示词。

只有压缩后的简报会进入改写请求，原始对话不会直接发给模型。 压缩本身会多调用一次模型，因此 token 消耗相应增加；压缩失败时会退回普通改写， 不会让整个操作失败。

该功能仍处 Beta：它会改变改写结果，介意可随时关闭。

检查更新

设置页底部有「检查更新」区块，点击后查询是否有新版本。它只读取版本号，不下载、不安装，也不会写入设置文件。

更新源支持三种写法，填在「更新源」输入框即可：

留空时依次尝试 npm registry → npmmirror → GitHub Releases，任一成功即返回。

• 自定义源按响应内容识别格式（dist-tags.latest 或 tag_name），因此镜像站、代理都可用，不依赖域名。
• 单个源超时 10 秒，失败自动回退到下一个；全部失败会逐条列出原因。
• 版本比较遵循语义化版本优先级，正确处理预发布版本。

三种模型来源

「跟随输入框」绝不回退：选它就是为了固定用手上那个模型， 悄悄换成别的模型会违背这个意图。因此当会话还没有可识别的选择时， 插件会明确提示，而不是替你决定。

模型解析顺序（跟随主程序）

1. 设置页显式填写的 provider + model
2. 当前会话最近一次请求使用的模型（即模型选择器所选）
3. 主程序默认模型（设置 → 模型）
4. 兜底 deepseek-account / deepseek-flash

---

环境要求

• DeepSeek Harness 0.2.1 及以上（依赖 conversation.input.right、settings.section 插槽与 inputActions.setDraft）
• 「跟随主程序」模式需已登录 DeepSeek 账户或已配置可用模型；否则请改用「自定义模型」

---

隐私与安全

• API Key 存储：优先放入宿主凭据服务（keyStorage: credential），settings.json 只记录“是否已配置”；没有凭据服务时降级写入 $DSH_HOME/dsh-prompt-optimization/settings.json（POSIX 下 0600）。旧版本明文会自动迁移并清除。
• 浏览器侧：永远只能拿到掩码（如 sk-••••1234），任何接口都不返回明文。
• 接口防护：除 /status 外所有路由要求进程级随机票据（页面从 /status 获取）并校验 Origin；模型路由按来源限流 10 次/分钟。
• 数据去向：被优化的草稿文本会发送给你配置的模型端点（跟随模式即主程序所用 provider）。请勿在需要保密的草稿上使用不可信的第三方端点。
• 请求中止：页面关闭、切换会话或再次点击时立即中止在途请求，主机侧返回 499 并停止计费。

---

实现说明

主机侧（index.js）

注册同源前缀路由 /dsh-prompt-optimization/*：

• 跟随模式走 DSH llm 服务（自带账户鉴权与重试）；自定义模式由主机侧请求 OpenAI 兼容 /chat/completions
• 评估：candidates > 1 时并行生成 N 份，再发一次只返回编号的评审请求；评审失败或无有效编号时退回确定性评分（结构 + 数字/标识符保留率 + 长度比）
• 取消：req.on('close') 触发 AbortSignal，透传给 llm.stream / fetch
• 检查更新：对更新源发起 HTTPS GET（10 秒超时、2 MB 上限），按响应内容识别 npm packument 或 GitHub release，用语义化版本规则比较；只读，不写设置文件
• 上下文：开启 Beta 后先读取会话中用户真正输入的消息，交给模型压缩成偏好简报，再把简报注入改写请求；原始对话不直接发给模型

客户端侧（client.js）

以 window.__ModuleLoader__.load 注册两个 slot：

• conversation.input.right：工具栏优化 / 撤回按钮与错误气泡
• settings.section：设置页面

草稿读写使用宿主注入的 inputActions / useInput，不改 DOM；occurrences 非空时禁用优化。改写完成后一次性回填草稿，输出即用，不带任何开场白。样式只用 --dsw-alias-* 主题 token。

打包内容

只包含 index.js、client.js、cordis.patch.yml、locale/*.json、icon.svg；测试脚本与文档留在仓库、不进包。

---

开发

node --check index.js
node --check client.js
node .verify/host-test.mjs            # 主机侧：路由、票据/限流、密钥存储、取消、多候选评估（46 项）
node .verify/client-test.mjs          # 客户端侧：模块工厂与插槽注册（14 项）
node .verify/hint-animation-test.mjs  # 空输入提示动画：打字/停留/逐字删除与打断（31 项）
node .verify/icon-test.mjs            # 图标结构约定（16 项）
node .verify/locale-test.mjs          # 多语言解析与键一致性（36 项）
node .verify/translate-sim.mjs        # 各语言实际输出（14 项）
node .verify/preamble-test.mjs        # 开场白剔除且不误伤真实提示词（12 项）
node .verify/rename-migration-test.mjs # 改名迁移：设置与 API Key 无损（9 项）
node .verify/update-test.mjs          # 检查更新：源解析、版本比较、超时与鉴权（37 项）
node .verify/composer-mode-test.mjs   # 跟随输入框模式（19 项）
node .verify/disconnect-test.mjs      # 客户端断开必须被主机侧感知（5 项）
node .verify/wait-budget-test.mjs     # 等待时长与中断（34 项）
python3 .verify/icon-weight.py        # 真实 16px 渲染下的图标视觉平衡

或者一次跑完（与 CI 一致）：

npm run verify

提交代码

本目录已是完整 Git 仓库，origin 指向 https://github.com/KukaNo996/dsh-prompt-optimization，默认分支 main。

git status
git add -A -- . ':!.workbuddy'
git commit -m "fix: 说明改了什么"
git push origin main

• 本机代理：仓库级 http.proxy = http://127.0.0.1:7897。端口不同时：

  git config --local http.proxy http://127.0.0.1:<端口>
  git config --local https.proxy http://127.0.0.1:<端口>
  

  可直连后：git config --local --unset http.proxy 与 --unset https.proxy。

• 凭据：Git Credential Manager 已保存 GitHub 账号；失效时按 git push 提示登录。

• 身份与换行：仓库级 user.name=KukaNo996、user.email=1274666494@qq.com、core.autocrlf=false。

• .workbuddy/、*.tgz、node_modules/ 已在 .gitignore 忽略。

---

常见问题

Q：按钮点了没反应/报“模型不可用”？ A：账户未登录或未配置模型。到「设置 → 提示词优化」改用「自定义模型」，填写 API 地址与模型名后点「测试连接」。

Q：优化后按钮为什么是灰的？ A：草稿中存在文件/会话引用芯片，纯文本改写会丢失引用，因此禁用；移除引用后可继续优化。

Q：多候选评估值得开吗？ A：值得在“结果要交付给别人”的场景开启；N 份候选成本约为单次的 N + 1 倍 token，耗时也更长。

Q：改写结果被扩写得过多？ A：默认指令已要求“篇幅与原文信息量匹配”。仍不满意可在设置页自定义「优化指令」，明确字数上限或删减段落。

---

已知限制

• 优化与撤回以纯文本重写草稿；含引用芯片时按钮禁用（撤回也只恢复文本）
• 「输入框当前选择的模型」取自会话最近一次请求的 request/header；刚切换模型且未发送时会使用默认模型
• 自定义接口目前仅支持 OpenAI 兼容 /chat/completions
• 多候选评估成本约为单次 N + 1 倍 token，适合重质量、不重速度的场景
• 仅在 Web GUI 验证；未在 Electron 独立窗口中验证

---

许可证

MIT © 2026 KukaNo996