前言¶
在 DeepSeek Harness（DSH）里发消息前，很多人习惯先丢一句口语草稿进输入框，再指望模型自己补全上下文。同类「提示词增强」插件不少，多数核心产物是一段改写后的提示词；改写质量可以做得很好，但「事实、推断、假设、未知」往往混在一团，多轮对话也容易每次整段重生成。
shiliumu/dsh-prompt-enhancer（维护者 shiliumu，分类：工作流）是 DSH Web UI 上的双引擎插件：一条链路负责草稿结构化改写与方向拍板，另一条以局势模型为核心，把一句话想法变成可审查、可比较、可迭代的结果。生态里同名插件至少有 11 个；按仓库说明，维护者通读了 27 个同行完整源码后定位差异——本插件把「把问题想清楚」当作一等公民，改写只是出口之一。当前版本 v0.3.0，MIT 许可，仅使用官方插槽扩展点，不改 DSH 源码。
这是什么¶
插件包名 @linxin666/dsh-prompt-enhancer，要求 DSH 引擎 >=0.2.0-rc.1。Host 侧提供 HTTP 路由，浏览器侧通过官方插槽注入 React 组件；模型调用走宿主已配置的 provider，不硬编 token 上限，空正文且因 max-tokens 截断时会自动用更大额度重试一次。
两个引擎可以分开理解：
- 提示词增强器：口语草稿 → 多条结构化候选 + 待定处的方向选项 → 采纳写回输入框。
- 参谋方向引擎（v0.3）：一句话（例如决策类问题）→ 局势模型（意图、事实/推断/假设/未知、关键矛盾、方向、推荐等）→ 缩进树是模型的视图之一，支持续研增量更新与手动复查。
核心功能¶
提示词增强器（输入框侧）¶
- 入口：注册在官方插槽
conversation.input.right（输入框工具行右侧、模型选择器左边），快捷键Ctrl+Shift+Enter与按钮等价。 - 候选面板：注册在
conversation.input.dock（输入卡片上方整行）。生成后展示多条候选；表头可查看当前模型，点击可换模型并立刻对同一份草稿重新生成。 - 模型选择策略：优先
id/name含flash的模型，且优先当前默认 provider；若无 flash 模型，候选区变为模型列表，数字键选择（会记住直到重开会话）。 - 待定与拍板（v0.2.0）：模型不应替你拍板的地方，除
<待确认：…>外还提供 2–4 个方向选项，每项带一句「效果」说明；候选卡显示待定 N 处 / 已定 N/N。Tab在选候选与拍板方向之间切换焦点。 - 看方向图：表头「看方向图」展开缩进树，并列各待定点的方向与后果，当前选择高亮；默认收起。
- 采纳：通过官方
inputActions.setDraft(text)整段替换草稿并进入撤销栈（Ctrl+Z可回退）。正文内占位符原地替换；无对应占位符的新约束追加到文末【补充要求】。 - 生成约束：只做结构化补全，禁止编造文件、报错或需求；保留
@引用、/命令、路径与报错原文。
参谋方向引擎（Host API）¶
POST /prompt-enhancer/advisor：输入文本、mode（如decision）、可选resume: true做续研——带上上一份模型、标记失效判断，增量更新而非整段重生成。- 合法输出：信息不足时可返回「暂不推荐」及最多三个待确认问题；事实与推断强制四分（事实 / 推断 / 假设 / 未知），各带来源与置信度；局势模型还包含关键矛盾、方向、推荐等字段，并带
tree视图节点（类型 / 来源 / 置信度 / 影响 / 状态等属性）。 POST /prompt-enhancer/review：手动「复查」，审查器逐条检查忠实度、脑补、方向差异、转向条件。- 失败处理：区分「只出思维链」与「完全空白」，可自动弹出换模型选择；失败草稿原样保留。
与常见 prompt-enhancer 的差异（摘要）¶
| 维度 | 常见实现 | 本插件 |
|---|---|---|
| 核心产物 | 改写后的提示词 | 局势模型 + 改写出口 |
| 多轮 | 常整段重生成 | 续研增量更新 |
| 缩进树 | 层级列表 | 局势模型视图，节点带多属性徽标 |
| 信息不足 | 硬给结论 | 可「暂不推荐」+ ≤3 个问题 |
完整对比见仓库内 docs/peer-landscape.md。
请求与安全边界¶
提示词增强：
POST /prompt-enhancer/enhance
Content-Type: application/json
{
"text": "草稿",
"provider": "tokenrhythm",
"model": "deepseek-v4-flash-0731",
"sessionId": "…",
"count": 3,
"direction": "可选：重写角度"
}
成功时返回 candidates（含 text 与 gaps 方向选项）；错误码含 reasoning-only、empty-output 等。仅接受本机来源；请求体上限 256 KB，草稿上限 6000 字符，单次调用 90 秒超时。
Host 不要求模型输出 JSON，而用行分隔 DSL（如 【候选】、【待定】 段），降低 flash 模型 JSON 非法的概率。路由与 DSL 细节见 GitHub README。
安装与启用¶
官方 README 给出的安装方式是在本机终端执行 PowerShell 脚本（沙箱/权限原因需自行运行，普通 PowerShell，无需管理员）。示例路径以文档为准，若你的 Desktop profile 不同，用 -ProfilePath 指定。
cd C:\Users\ROG\dsh-workspace\dsh-prompt-enhancer
powershell -ExecutionPolicy Bypass -File .\install.ps1
脚本会：在 profile 的 node_modules\@linxin666\ 下建立指向插件目录的 junction；向 cordis.patch.yml 幂等追加注册段（备份为 cordis.patch.yml.bak-prompt-enhancer）；把包写入 profile package.json 的 dependencies（Desktop 插件图谱从 dependencies 派生，只 patch 不登记依赖则不会加载）；并做 Node 自检。
装完后完全退出并重启 DeepSeek Harness Desktop（Desktop profile 无 patchReload，不会热加载），任意会话输入框右侧应出现增强按钮。
其他 profile 示例：
powershell -ExecutionPolicy Bypass -File .\install.ps1 -ProfilePath "C:\Users\ROG\.dsh\profiles\desktop"
卸载：
powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
不删插件源码目录，只移除 junction、patch 段与 package.json 依赖。
不重启 App 的真机验证（可选）¶
powershell -ExecutionPolicy Bypass -File .\verify-live.ps1
脚本临时建 pe-verify profile、起一次性 DSH host，检查配置 dump、Host 路由（405/400/404）、浏览器内按钮 DOM 与端到端点按钮出候选、数字键写回。默认删除临时 profile；-KeepProfile、-Port 可按 README 使用。
典型用法¶
下面流程来自 README 中的交互示意（爬虫断连排查），便于对照 UI 行为。
- 在输入框写入口语草稿，例如：
帮我看看这个爬虫为啥老是断。 - 点输入框右侧增强按钮，或按
Ctrl+Shift+Enter。 - 在 dock 候选框中：
↑/↓切换候选，1–3或Enter采纳；←/→换角度重新生成；若有待定，用Tab进入拍板，数字键选方向，0清除当前待定选择。 - 需要对比分支后果时，点「看方向图」查看缩进树（例如「只诊断不改代码」与「诊断+修复」的效果说明）。
- 采纳后，输入框变为结构化提示词；你选定的方向替换文中
<待确认：…>，其余新约束进入【补充要求】。
决策类问题可走参谋引擎：对 POST /prompt-enhancer/advisor 传想法与 mode，需要多轮时用 resume: true；对已有局势模型可 POST /prompt-enhancer/review 做复查。
常用快捷键汇总：
| 按键 | 行为 |
|---|---|
Ctrl+Shift+Enter |
生成（候选框已开则关闭） |
1–9 |
采纳第 N 条候选 / 拍板选方向 / 模型列表选模型 |
Tab |
候选与拍板焦点切换 |
Esc |
关闭或退回上一层 |
适用场景与注意¶
适合谁：经常在 DSH 里用长对话、又希望发送前把目标、约束和未定项说清楚的用户；需要做决策梳理、希望保留「事实 vs 推断」边界、并愿意多一步拍板或看方向图的人；开发或调试 DSH 插件、需要参考官方插槽与 Host 路由实现的同行。
使用注意：
- 插件在当前 DSH 进程权限下运行，安装前请自行阅读源码与 MIT 许可证，确认 junction/patch 修改的 profile 路径正确。
- 安装文档以 Windows + Desktop profile 为例；Linux 用户需自行对照 profile 布局，或先用
verify-live.ps1思路理解验证项，再适配本机路径。 - 社区目录站点 SkillHub 插件页 与 GitHub 仓库独立维护；与 DeepSeek / 幻方无官方从属关系，属 DSH「一切皆插件」生态中的社区工作流插件。
- 仓库说明星标为 0（以目录页为准），功能以 v0.3.0 README 与 CHANGELOG 为准。
结尾¶
若你的痛点是「只会改写提示词、却说不清局面与未定项」，dsh-prompt-enhancer 用双引擎把结构化改写与局势模型放在一起：前者负责可采纳的提示词与方向拍板，后者负责可续研、可复查的参谋输出。详情与安装脚本见 GitHub：shiliumu/dsh-prompt-enhancer；浏览与归类见 SkillHub 目录页。
