提示词增强 gw1450048532-arch/dsh-prompt-enhancer

✨ dsh-prompt-enhancer（中文说明）

一个面向 DeepSeek Harness 的社区插件：在对话输入框工具栏增加「✨ 增强提示词」按钮。点击后，当前草稿会交给模型改写成更清晰、更有效的提示词，并直接回填到输入框。不写会话日志、不触发 Agent 回合、不打断对话。

| 点击前：输入框工具栏中的按钮 | 点击后：模型优化结果已回填 |
| 输入框中的增强按钮 | 优化结果回填 |

功能

- 一键优化：按钮位于输入框左侧工具行（+ 与权限选择器之后），随应用语言显示中文或英文。
- 快速的辅助模型调用：使用 profile 的默认模型选择，并自动选择模型声明的最低 reasoning 档（deepseek-flash 实测约 2 秒）。
- 安全回填：通过带 revision 守卫的编辑器 API 整体替换草稿（原子编辑，可撤销）。若请求期间用户修改了草稿，绝不覆盖新输入，而是把优化结果复制到剪贴板并提示。
- 不污染会话：不追加会话事件、不产生模型消息、不启动 Agent 回合。
- 本机鉴权通道：Host 端点走 DSH 既有的浏览器 cookie /api 通道，插件不新开端口、不增加未鉴权路由。
- 可配置：输入/输出上限、超时、系统提示词、provider/model 覆盖。
- 双语：按钮、提示、插件管理器元数据均提供中英文本。

环境要求

- DeepSeek Harness（DSH）0.2.1-rc.3——本插件开发与验证所用的版本。
- 带 Web UI 的 profile（桌面端或 dsh web），且已组合 llm 服务（@deepseek-ai/dsh-base 自带）。
- 无需额外依赖或构建步骤，DSH 自带 Node.js 22+ 运行时。

安装

方式 A —— 插件管理器（推荐）

1. 打开 DSH 的 插件 → 添加插件。
2. 填入本仓库地址：https://github.com/gw1450048532-arch/dsh-prompt-enhancer
3. 安装后确认 bundle dsh-prompt-enhancer 处于启用状态。
4. 若插件行未立即出现，重启 DSH。

方式 B —— 命令行

dsh plugin --profile <profile> add github:gw1450048532-arch/dsh-prompt-enhancer
然后在“插件”页面启用该 bundle

方式 C —— 本地开发（link 安装）

git clone https://github.com/gw1450048532-arch/dsh-prompt-enhancer.git

然后在 插件 → 添加插件 中填入克隆目录的绝对路径，或自行在 profile 中添加 link: 依赖。
注意：以工作区 link 方式安装的包不在 DSH HMR 监听范围，修改 index.js / client.js 后需重启 DSH。

安装完成后，按钮出现在输入框左侧工具行 + / 模式控件之后。

使用

1. 在输入框输入草稿。
2. 点击 ✨ 增强提示词。
3. 等待约 1–3 秒，草稿被替换为优化后的提示词，按钮旁出现「已回填优化结果」提示。
4. 按需修改后正常发送。

行为细节：

- 草稿为空时按钮禁用；请求进行中显示「优化中… / Enhancing…」。
- 同一时间只允许一次优化，重复点击会被忽略。
- 请求期间草稿被修改、或编辑器暂不可用时，结果复制到剪贴板，不会覆盖用户内容。
- 草稿中含引用 chip（如 @文件 引用）时不自动整稿替换，改用剪贴板兜底以保留引用。

配置

所有配置项均可选，未配置时使用默认值。可在 profile 的 cordis.patch.yml（用户补丁层）覆盖：

C:\Users\<用户>\.dsh\profiles\<profile>\cordis.patch.yml
- id: prompt-enhancer
name: dsh-prompt-enhancer
config:
maxInputChars: 8000
maxOutputTokens: 2048
timeoutMs: 90000
systemPrompt: "请把用户的提示词改写为……"
provider: deepseek-official
model: deepseek-flash

| 字段 | 默认值 | 说明 |
| maxInputChars | 8000 | 允许优化的草稿最大字符数。 |
| maxOutputTokens | 2048 | 优化结果的输出 token 上限。 |
| timeoutMs | 90000 | Host 侧单次调用的端到端超时（毫秒）。 |
| systemPrompt | 内置 | 覆盖优化指令。 |
| provider / model | profile 默认 | 显式指定辅助调用的模型路由；必须成对配置。 |

浏览器半自身在 150 秒后会中止请求，因此把 timeoutMs 调高到 150000 以上不会延长工具栏动作的实际期限。

工作原理

输入框（浏览器半） Host 半 ───────────────── ─────── useInput → 读取草稿点击 ✨ │ ├─ POST api/prompt-enhancer/enhance ────────▶ /api 鉴权通道（浏览器 cookie） │ ctx.connection.fetch.register 注册的路由 │ ctx.llm.prepareCall({provider, model, maxTokens}) │ call.stream({system, messages, signal}) │ ↳ 累加 text-delta │ ↳ 清理代码围栏/标签，拒绝空结果与截断
├─ { ok: true, text } ◀────────────────────── 200 JSON
│
└─ inputActions.insertText(optimized, {start: 0, end: draft.length, draftRev})
（带 revision 守卫的整稿替换；冲突时降级为剪贴板）

- 浏览器半使用 conversation.input.left 插槽的标准 props（useInput / inputActions / sessionId），不直接操作 DOM。
- Host 半在 Connection 的鉴权 fetch 通道注册一条精确路由，请求由 DSH 既有浏览器会话鉴权，不进入模型回合或会话日志。
- 模型路由默认读取 ctx.get('agentDefaultModel').currentSelection()，也可用配置覆盖。

隐私与安全

- 唯一离开本机的数据是你主动提交优化的草稿文本，经 DSH 常规 LLM 管道发往已配置的模型提供商。
- 无遥测、无第三方网络请求、不读取凭据。
- 本地端点由 DSH 自身的回环服务器承载，位于鉴权的 /api 通道上；插件不新开监听端口、不增加未鉴权路由。
- 威胁模型与漏洞报告方式见 SECURITY.md。

兼容性与维护

DSH 目前仍是预发布版本，插件 API（slots、InputActions、connection.fetch）可能变化。本插件声明 engines.dsh: ^0.2.1-rc.3；在更新的 DSH 版本上可能被拒绝安装或需要适配。仓库 CI 负责静态检查（清单、bundle 一致性、资源）与单元测试，并对固定的 DSH 版本做人工验证——详见 docs/VERIFICATION.md（含端到端记录与升级冒烟清单）。

维护预期：单功能小插件，无构建步骤，两个运行时源文件（index.js、client.js）加一个纯函数模块（lib/prompt.js）。DSH 升级若导致失效，修复通常局限于 index.js（路由/LLM API）或 client.js（插槽/输入 API）。

开发

git clone https://github.com/gw1450048532-arch/dsh-prompt-enhancer.git
cd dsh-prompt-enhancer
npm run check # node --check + 清单/资源校验 + 单元测试
npm test # 仅运行 lib/prompt.js 的单元测试

无运行时依赖、无构建步骤：包根目录即 bundle，index.js 是 Host 半，client.js 是浏览器模块加载器工厂， lib/prompt.js 存放带单元测试的纯函数。本地 link 安装流程见 CONTRIBUTING.md。

发布流程：更新 CHANGELOG.md 与 version，执行 npm run check，打 vX.Y.Z 标签，按 RELEASE_NOTES.md 发布 GitHub Release。

许可证

MIT © 2026 GAO

本项目为社区非官方插件，与 DeepSeek 无隶属或背书关系。“DeepSeek Harness”“DeepSeek” 为其各自权利人的商标。