dsh-prompt-forge

dsh plugin --profile web add dsh-prompt-forge

dsh-prompt-forge

输入框一键提示词增强（DeepSeek Harness Web / Desktop）。

在输入框里写一句草稿，点 ✨ → 模型把它改写成更清晰、可直接执行的提示词 → 在输入框上方的卡片里对比原文与结果 → 选择替换、复制、换风格重写或撤销。只有你点"替换草稿"才会改动输入框，永不自动发送。

安装

本项目是 DeepSeek Harness 的 bundle 插件包（Host + Web Client），任选一种方式安装：

• 源码目录：克隆本仓库，在 DSH 的 Plugin Manager（插件管理）中用 install_bundle 安装该目录；
• Release 包：从 Releases 下载 dsh-prompt-forge-<version>.tgz，通过 Plugin Manager 安装；
• npm：dsh plugin --profile desktop add dsh-prompt-forge（需 npm 已发布；本机 registry 不是 npmjs 时加 --registry https://registry.npmjs.org/）。

安装或更新后完整重启 DSH（Host 代码与默认配置需要重启生效），刷新页面即可在发送键旁看到 ✨。禁用或卸载请在 Plugin Manager 中操作。

交互

位置 · 内容

conversation.input.activity · ✨ 触发按钮（发送键旁；点击开始，右键弹出风格菜单；无草稿 / 含 @引用或命令 / 过长 / 会话忙时置灰并提示原因）

conversation.input.overlay · 按钮旁的浮动小窗：原文、增强后、替换 / 替换并发送 / 复制 / 重试 / 撤销

快捷键 Ctrl+Alt+E 打开或关闭当前会话的小窗（草稿为空、含命令芯片或会话忙时忽略）。

小窗以按钮为锚点首次定位（上方空间够就向上弹，否则向下）。可拖动标题移动、拖右下角缩放，尺寸与拖动后的位置会记在 localStorage（dsh.prompt-forge.layout.v1），下次打开、重开会话甚至重启后都沿用；双击标题恢复默认位置和尺寸。点击外部或 Esc 关闭（原文编辑区里按 Esc 会先落盘再关闭）；标题栏的「钉住」可让点击外部不再关闭。每个会话各有一份小窗，切换会话不会互相覆盖。打开时焦点进入小窗、关闭时回到 ✨。

流式生成：默认边生成边显示（/prompt-forge/stream，SSE），首字出现后就不再是干等转圈；流式展示会吞掉模型多包的 `` 围栏，完成时不再"跳一下"，最终以完整归一化结果为准。可在配置里用 streaming: false` 退回一次性返回。

原文可直接编辑：小窗里的原文是输入框草稿的实时镜像。在面板里改字会（防抖 120ms）写回输入框，反之在输入框里改字面板也会跟着变。结果始终对应"发起请求时那一版原文"；编辑原文后会出现「草稿已改动」提示，点风格按钮或重试即可用新文本重新生成。点「替换草稿」后原文编辑区收起，只留结果提示与撤销；撤销记录会持久化，关掉小窗后重新打开、只要输入框仍是替换后的文本，就能用「撤销上次替换」还原。会话处于提交中（命令芯片、正在发送）时原文只读并给出提示。

替换并发送：结果栏的「替换并发送」会先写入草稿，等输入框真正反映新文本后再提交（最多等 600ms，超时则保留替换结果、让你手动发送），避免把替换前的草稿发出去。

直接替换模式：设置里打开「点击按钮直接替换草稿」后，点 ✨ 不再弹窗，而是直接请求并写回输入框；默认使用设置中的「直接替换使用的风格」（留空跟随默认风格，不会沿用你在弹窗里临时切过的风格）。写入是流式的：生成过程中输入框里的文字会逐段刷新（约 60ms 一批），不用等整段生成完；生成期间按钮旁显示「生成中 · 风格」，点击该胶囊可立即停止，中止请求并还原原草稿。如果你在生成过程中自己改动了输入框，插件会立即停止写入、保留你的改动，并把完整结果放进预览窗口（同时飘出「草稿已变化」提示）。替换成功后 ✨ 上方会飘出一个费用提示：显示本次估算金额（悬停标注「按本插件配置的单价估算」与 token 信息），没有价格数据时退回显示 token；显示时长由 toastDurationMs 控制（默认 2.6 秒）。按钮旁同时出现「已替换 · 撤销」的一步撤销。失败时会飘出「生成失败，已打开预览」并打开错误窗口。Ctrl+Alt+E 默认始终打开预览窗口（作为对照入口）；在设置里关闭「快捷键始终打开预览」后，直接模式下快捷键也会直接替换。

今日花费：每次真实生成（不含缓存命中）会把估算费用累计到本机 localStorage（按日重置、按货币分别累计），可以在设置页「用量统计」看到今日估算花费与次数并清除；直接替换的费用提示悬停时也会带上今日累计。

上下文感知：Host 读取本会话最近若干轮对话用于消解指代、补全术语；结果标注「参考了 N 轮」。标题栏的「上下文」是一个开关：关掉后下一次请求不读取上下文（开关状态会记住，但不写回插件配置）。

结果缓存：同一份草稿 + 同一风格 + 同一会话路由与配置指纹的增强结果会缓存（dsh.prompt-forge.results.v2，最多 40 条），关掉再打开会直接显示上次结果并标注「沿用上次」和生成它的模型；缓存命名空间由 Host 的 /route（按会话解析 provider/model）与 /config 共同决定，换模型、换会话模型或改配置都会让旧缓存失效。点「重试」强制重新生成；草稿改动后 key 变化。设置页「最近结果」可以浏览这些缓存条目（按时间倒序，查看原文/结果全文、复制、删除、清空），全部只读写本机 localStorage。

三种风格（按按钮顺序）：极简（默认；≤1.5 倍，只把模糊动词变具体）、详细（缺的信息用「待补充」占位、列待确认清单，不臆造）、规格化（角色、目标、约束、步骤、输出格式、验收标准）。

提示词模板：可以在设置里用自定义指令覆盖改写模型的行为——「追加」把指令加到内置规则之后，「替换」则只用你的指令（会丢失内置的保真/不扩写约束，慎用）。模板参与缓存指纹，改模板后旧缓存自动失效。

多候选对比：在设置里选一个「对比风格」后，预览窗口会并行生成两版（当前风格 + 对比风格）；第二版以普通请求完成，带「使用这个 / 复制」操作，选中即替换草稿。两版各自参与缓存与费用统计，成本约为单候选的两倍；直接替换模式仍只生成一版。

错误提示：鉴权失败 / 额度不足 / 上下文超限 / 限流 / 并发 各给一条可操作的本地化提示；限流额外显示「请 N 秒后再试」，provider 的原始报错折叠在「技术详情」里，不再直接糊在脸上。

模型

默认跟随当前会话已选定的 provider/model；会话尚无请求记录时回落到 agent 默认模型。不需要任何第二套 API Key——调用走 ctx.llm，复用 DSH 已配置的凭据。

思考强度按模型能力自动适配：请求前先通过 ctx.llm.resolveModelInfo 读取当前模型真正支持的档位。不同模型的阶梯并不一致——例如 deepseek-v4.1-flash 只提供 low/high/max（关不掉思考），deepseek-v4-pro 从 high 起步，非推理模型则没有任何档位。插件会把配置的档位就近映射到模型支持的档位（平局取更省的一档），并在结果与设置页标注「已就近调整」；模型完全没有推理档位时直接不发送该字段。若上游元数据滞后、请求仍被以 UNSUPPORTED_REASONING_EFFORT 拒绝，Host 会在尚未输出任何文字时自动去掉该字段重试一次，不再把这个错误抛给用户。

完全独立：只使用核心服务（llm、webServer）和输入框槽位 props，不读取、不依赖任何第三方插件（不接 cost-meter、不读别人的价表或配置）。

设置页

设置 → 提示词增强（位于设置侧栏「工作伙伴」之后）顶部有一行只读状态：当前生效模型（Host 通过 /route 解析的默认 provider/model，未解析到时显示「跟随会话」）与计费时段（高峰 / 空闲，来自 /config，Host 未升级时由前端按同一规则计算）。「思考强度」分组还会列出当前模型支持的档位，并说明不支持的档位会被自动就近调整。下方是可视化配置：启用插件、默认风格、直接替换风格、对比风格、流式、点击按钮的行为（直接替换 / 弹出窗口）、费用提示时长、快捷键行为、模型覆盖、提示词模板（追加/替换 + 自定义指令）、三档思考强度（全局 + 按风格）、上下文预算、生成限制、费用估算单价、最近结果（浏览/复制/删除本机缓存的历史结果）以及用量统计（今日估算花费与增强次数，仅存本机、可清除）。保存会通过宿主 configEditor 写入当前 profile 的 patch，并立即热重载生效；输入框 ✨ 与浮层读取的客户端配置也会在保存确认后同步刷新，不需要再刷新页面；「恢复默认」会移除该覆盖。若 profile 未启用配置编辑器，页面会提示改用手工编辑 cordis.patch.yml。

保存只写与内置默认值不同的字段；未写出的字段回落到内置默认值（lib/config.js 的 DEFAULTS），而不是 bundle patch 里的值——这是宿主「profile 覆盖会替换整条 config」的语义决定的。因此 bundle patch 只应用于没有 profile 覆盖的情况；要让某项始终生效，把它写进默认值或写进 profile 覆盖。保存后页面会轮询到新值真正生效才显示「已保存并生效」，热重载导致的重挂载也不会丢掉这条状态提示。数字字段在提交前就按范围校验，避免被服务端静默夹紧；Provider 与模型名必须成对填写（只填一个会行内报错并阻止保存）。表单按分组折叠（默认收起思考强度、生成限制、单价），保存条吸底常驻，长表单不必滚到底才能保存。

设置页写入的是部分覆盖：只包含你改过的字段。一旦存在覆盖行，未列出的字段使用内置默认值；contextAware 默认即为 true，不会因为一次保存被静默关闭。

配置

也可以直接编辑 bundle 的 cordis.patch.yml（或在你自己的 profile patch 里用 - id: prompt-forge 覆盖）：

字段 · 默认 · 说明

enabled · true · 总开关，关闭后按钮隐藏、接口拒绝

defaultStyle · brief · 点 ✨ 时使用的风格：brief（极简）/ clarify（详细）/ spec（规格化）

directStyle · 空 · 直接替换模式使用的风格；空=跟随 defaultStyle

compareStyle · 空 · 设置后预览窗口会并行生成第二个风格用于对比；空=单候选

streaming · true · 边生成边显示；设 false 退回一次性 JSON 返回

directApply · false · true：点击 ✨ 直接把增强结果替换进输入框（不弹窗，按钮旁出现一步「撤销」）；false：弹出预览窗口

toastDurationMs · 2600 · 直接替换后费用提示的显示时长（800–10000 毫秒）

shortcutOpensPreview · true · true：Ctrl+Alt+E 始终打开预览；false：直接替换模式下快捷键也直接替换

systemPrompt · 空 · 自定义指令（最多 8000 字符）；留空使用内置指令

promptMode · append · append：自定义指令追加在内置规则之后；replace：只使用自定义指令（参考对话的说明仍会自动追加）

provider / model · 空 · 成对填写可固定模型；留空跟随会话

temperature · 0.3 · 低温改写更忠实原意

maxOutputTokens · 2048 · 单次输出上限

maxInputChars · 12000 · 草稿字数上限，超限拒绝而不截断

timeoutMs · 60000 · 单次超时

reasoningEffort · 空 · 全局思考强度覆盖：off/low/high/max；留空走下面的按风格映射

reasoningByStyle · brief=off, spec=low, clarify=high · 按风格分档的思考强度

pricing · 官方人民币价（空闲时段） · 本插件自带的单价表（元/百万 token），按官方 API 规则估算；高峰时段自动 ×2

maxConcurrent · 2 · 并发上限

rateLimitPerMinute · 10 · 每分钟次数上限

contextAware · true · 上下文感知：读取本会话最近若干轮对话用于消解指代、补全已确立

…(truncated)