提示词锻造 zhaoxiagongsi001/dsh-prompt-forge

dsh-prompt-forge

DSH 桌面版（DSH desktop）的提示词优化插件：在聊天输入框旁加一个按钮，一键调用你已配置的模型渠道，把草稿改写成更清晰、更可执行的提示词。左右对比、流式输出、只有点「采纳」才写回输入框。

- 宿主半边：ctx.llm 调用、渠道/模型目录、设置命名空间、两条 loopback 路由
- 浏览器半边：输入框工具按钮、设置页、输入框内联优化面板
- 不接触密钥：模型渠道复用 DSH 已配置的 provider，插件自己不存任何 API Key

输入框工具行里的「优化」按钮

功能

| 能力 | 说明 |
| 一键优化 | 输入框左侧「优化」按钮，点击优化当前草稿 |
| 内联面板 | 面板浮在输入框上方不占布局：开合都不移动输入框、不重排对话 |
| 左右对比 | 左原文（默认收起，可展开）、右优化版，面板内可直接编辑结果 |
| 流式输出 | 右侧逐字出现，请求中可随时「停止」 |
| 继续微调 | 面板底部再输入一句要求（如「再短一点」），基于上一版继续改 |
| 采纳 / 复制 | 点「采纳」写回输入框（流式进行中会被拒绝，避免写回半截文本）；一键复制（流式途中也可复制，便于中断后取用已有内容） |
| 采纳前二次确认 | 当前草稿含 @引用 或附件时，采纳会先弹确认——整替写入会把引用降级为纯文本 |
| 预设切换 | 面板内可切换预设，切换即按新预设重跑 |
| 设置页 | 插件开关、渠道/模型下拉（从你已配置渠道实时拉取）、温度、输出上限 token（0 = 用模型默认值）、主提示词、预设增删改 |
| 语言跟随 | 中文进中文出，英文进英文出 |

v2 起没有任何键盘快捷键。 v1 在 document 捕获阶段绑定 Esc / Ctrl+Enter；面板内联后与官方输入框冲突——官方 Lexical 键盘表把 Ctrl/Cmd+Enter 当作「立即发送」，而 v1 的处理器没有 stopPropagation，结果是面板采纳与输入框发送同时触发。所以 v2 全部动作改为可见按钮，只有「微调」输入框内的 Enter 是本行提交键。

不做什么

首版刻意不含：优化历史记录、提示词模板库、缺陷诊断（缺角色/缺约束）、目标模型自适应、中英双语输出、选中消息右键优化、Agent 工具化。这些都在 PLAN.md 的挂账清单里。

安装

用户安装（从 GitHub）

仓库自带构建产物（lib/ 已提交），因此 GitHub 源码安装开箱可用：

dsh plugin --profile web add github:zhaoxiagongsi001/dsh-prompt-forge

装完刷新一次页面（客户端 bundle 首次加载必须刷新），输入框工具行里（附件按钮、权限下拉之后）即出现「优化」按钮。

插件市场（dshmarket）只安装其收录源里的条目，本插件当前未收录，所以市场里搜不到；收录后即可一键安装。

开发期安装

以下是把本地源码装进 desktop profile 的步骤。

1. 构建

用 DSH 自带的 node $node = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe" & $node node_modules/typescript/bin/tsc --noEmit # 类型检查 & $node scripts/build.mjs # 构建 & $node scripts/smoke.mjs # 48 项：bundle 契约与纯函数 & $node scripts/host-check.mjs # 29 项：宿主路由集成 & $node scripts/render-check.mjs # 215 项：真实 React 渲染、采纳闸门与写回路径

2. 装进 profile

cordis.patch.yml 里的行 id 是承重的：托管式设置 provider 用 Loader entry id 作设置命名空间，而 insert 进去的行，其 entry id 是 include:<行id> —— 所以本插件实际的设置命名空间是 include:prompt-forge，不是行里那个裸名字。浏览器半边会在运行时解析这个具体字符串（精确匹配 → :<行id> 后缀 → schema 指纹），所以改行 id 仍能工作，但会改变设置值的存放位置。

把本插件作为 profile 依赖添加，并让 profile 载入它的 bundle：

$profile = "$env:USERPROFILE\.dsh\profiles\desktop"
cd $profile
指向本地目录。用 link: 而不是 file: —— file: 是拷贝，重建后不会同步，结果是「改了源码、跑了 build，界面却还是旧行为」。link: 指向源目录，重建即生效。
pnpm add "link:D:\DSH\dsh-prompt-forge"

然后在 $profile\package.json 的 dsh.profile.bundles 数组末尾加上：

"dsh-prompt-forge"

该 profile 是 patchReload: live，保存后即刻生效。若未生效，重启 DSH。

换名/换路径后必须重装一次：pnpm remove 旧名 → 删掉 node_modules 里的旧目录 → pnpm add 新名 → pnpm install。残留的旧目录会让 loader 看到两个 bundle。

3. 先跑通配置

打开 设置 → 提示词优化：

1. 确认「渠道」下拉能列出你配置的渠道（如 ofox），「模型」下拉能列出该渠道的聊天模型
2. 选好默认模型（默认 ofox / deepseek/deepseek-v4.1-flash）
3. 温度保持 0.3
4. 需要时改主提示词，或在「预设」里增删

模型下拉会自动过滤掉图像、embedding 等非聊天模型 —— 它们在网关的 /models 里和聊天模型混在一起。
设置 → 提示词优化

使用

1. 在输入框里写一段草稿（中文或英文都行）
2. 点输入框工具行里的 优化 按钮
3. 面板浮在输入框上方，右侧流式出结果，可以直接改
4. 点「采纳」写回输入框；不采纳则原稿一字不动。生成中「采纳」呈禁用态，等输出结束再采纳；中断后用「复制」取走已有内容

内联优化面板：左右对比、流式输出、微调与采纳

草稿为空、插件被关闭、或草稿超过 20000 字时，按钮会禁用并说明原因。

草稿里含 @引用 或附件时，采纳前会先弹一次确认：整替写入（setDraft）会清空编辑器文档并改写为纯文本，引用芯片会降级、附件会失去对应文本，且不产生独立的撤销步骤。

架构

[输入框工具行 · 优化按钮] conversation.input.left │ 点一下，捕获当前草稿 ▼ [内联优化面板] conversation.input.overlay │ POST /api/dsh-prompt-forge/optimize ▼ [宿主路由 · loopback-only] │ system = 预设 / 主提示词（+ 上一版 + 本次要求） │ ctx.llm.stream({ provider, model, temperature, system, messages, signal }) ▼ [SSE: start / delta / done / error / aborted] ──► 右侧逐字渲染

模型目录：GET /api/dsh-prompt-forge/models → ctx.llm.listProviders() + listModels()，过滤非聊天模型后供设置页下拉使用。客户端拿不到 ctx.llm（客户端运行时没有 llm remote 命名空间），所以由宿主投影。

关键设计取舍

| 取舍 | 原因 |
| 面板放 conversation.input.overlay（v2） | v1 用 shell.overlay 全屏遮罩，观感是「跳出一次对话」。改挂到输入框卡片内的 overlay 槽后，面板贴着输入框上沿浮起；锚点是卡片内一个零高绝对定位元素，所以开合不占布局、不移动编辑器、不重排对话，面板也可以比输入框本身更高 |
| 面板 order 固定 40 | dsh-context 在同一个槽里以 order 10 注册 context-modal。占同一格 id 会在注册时抛异常、连带整个 GUI 启动失败，所以 id 与 order 都必须让开 |
| 不注册任何全局快捷键（v2） | 见上文：Ctrl/Cmd+Enter 在官方 Lexical 键盘表里是「立即发送」，v1 的捕获阶段处理器会与它同时触发 |
| 写回只在「采纳」 | 草稿是用户手写的，任何隐式覆盖都是数据丢失 |
| 流式途中拒绝采纳 | 屏幕上的文本是模型答案的前缀而非答案，写回去就是残缺提示词；闸门放在采纳逻辑里（v2 仍由 accept-guard.ts 单一判定同时驱动按钮禁用态与采纳处理） |
| 有 @引用/附件时采纳先确认 | setDraft 是整替：引用芯片会降级为纯文本、附件失去对应文本，且不产生独立撤销步骤 |
| 写回失败不收起面板 | 会话在面板打开后被回收时 setDraft 会静默不生效；此时若照常收起，用户会以为已采纳而草稿未变 |
| 丢弃 reasoning-delta | 推理模型的思维链会混进要被粘贴的提示词里 |
| 草稿超长直接报错 | 静默截断会让用户拿到一段残缺提示词却不知道 |
| 优化中断标记为 aborted | 截断的输出不能伪装成完整结果 |
| 系统提示词由前端组装后传入 | 宿主不必再解析一遍插件设置，两边规则只有一处 |
| 写回走 slot 交付的 inputActions（v2） | v1 需 sessions.scope() + conversation.input.for() 反射式查找输入框；v2 的会话级槽位出现本身就带着 setDraft，那条「只能防御性查找」的路径从热路径上消失了 |

开发

监视 src/，改动即重建 & $node scripts/build.mjs --watch

构建说明

构建脚本是手写的、无子进程的打包器（scripts/build.mjs），基于 TypeScript 编译器 API：

- 原生 esbuild 与 esbuild-wasm 都会 spawn 带管道 stdio 的辅助进程，DSH 文件沙箱会拒绝（spawn EPERM）；TS 编译器 API 是纯 JS，在进程内跑得通
- 浏览器半边输出必须包成 window.__ModuleLoader__.load({ id, factory }) 这种自注册经典脚本；react 与 @deepseek-ai/dsh-client-store 走外壳的冻结模块表，其余全部内联
- .module.css 编译成注入一个带 data-plugin-css 标签的模块 —— 模块系统在 factory 首次材料化时认领 ，所以注入必须发生在那时，标签则让禁用/替换代码时能回收
- 宿主半边输出普通 ESM，node: 与 @deepseek-ai/* 保持外部依赖，由宿主进程解析

自检覆盖（292 项）

| 脚本 | 项数 | 覆盖 |
| scripts/smoke.mjs | 48 | bundle 注册协议、只用种子模块能否材料化、导出面、两半 apply() 能否真跑完、面板入口注册与「无会话绑定时渲染空」、每个客户端 effect 能否干净释放、纯函数（提示词组装、配置归一化、草稿校验、模型过滤） |
| scripts/host-check.mjs | 29 | 真起 HTTP server 打两条路由：loopback 语义、SSE 帧、推理块不外泄、上游报错透传、中断标记、微调请求体形状、各拒绝分支 |
| scripts/render-check.mjs | 215 | 真实 React 渲染三处 surface：按钮各禁用态与其原因文案、设置页读写态与预设增删、面板结构/语义/模型名/空结果禁用、采纳闸门（流式进行中拒绝采纳）；写回路径（面板整替写入、writeNeedsConfirm 二次确认判定、写回失败不收起）、composerFor 解析与异常吞噬、设置合并的容错；外加加载安全闸门与 dsh.client 声明形状 |

自检不等于 GUI 渲染通过。 这三个脚本证明 bundle 能加载、路由行为正确、组件能渲染出预期结构、写回路径不会抛异常；但按钮在你真实输入框里的位置、面板贴住输入框上沿的实际观感、与外壳主题的搭配、以及 ctx.configForms 在你 profile 里的真实握手，只有真实页面能证明 —— 这正是最后一步要在 GUI 里验收的原因。

加载安全闸门值得单独说：浏览器里 require(未知包) 是硬加载失败，插件会整体不出现且没有任何提示。所以「bundle 里每个裸 require 都在平台种子表里」这一条，比其余所有断言加起来都更能防止「装上但没反应」。

目录

src/
├─ protocol.ts 前后端共享契约（命名空间、路由、类型） ├─ prompts.ts 默认主提示词 + 内置预设 + 提示词解析 ├─ model-catalog.ts 渠道/模型聚合与聊天模型过滤 ├─ settings-compat.ts 设置 provider 世代兼容 ├─ index.ts 宿主半边：设置 + 两条路由 + llm 调用 └─ client/ ├─ index.tsx 浏览器半边：注册三处 surface、按会话分桶的面板状态、写回 ├─ settings.ts 设置读取/写入（官方 configForms） ├─ composer.ts 按 session 解析输入框、读草稿、整替写入判定 ├─ accept-guard.ts 采纳闸门（流式中拒绝 / 空结果拒绝），纯函数 ├─ api.ts /models + /optimize（含 SSE 解析） ├─ locales.ts zh/en 文案 ├─ OptimizeButton.tsx 输入框工具按钮 ├─ InlinePanel.tsx 输入框内联面板：对比、流式、微调、二次确认 ├─ SettingsSection.tsx 设置页 ├─ inline.module.css 面板样式 └─ optimizer.module.css 按钮与设置页样式 scripts/ ├─ build.mjs 无子进程打包器（TS 编译器 API） ├─ smoke.mjs 48 项 bundle 契约与纯函数自检 ├─ host-check.mjs 29 项宿主路由集成自检 ├─ render-check.mjs 215 项真实渲染、采纳闸门、写回路径与加载安全自检 ├─ asar-list.mjs 开发期参考：列 app.asar 内文件 ├─ asar-extract.mjs 开发期参考：从 app.asar 提取文件 └─ pack-ref.ps1 开发期参考：拉取指定版本类型包

后三个脚本只在核对上游契约时用过，产物在 .refs/（已在 .gitignore 里）。保留它们是为了将来 DSH 升级时能快速重新核对，不影响构建与运行。

排障

| 现象 | 原因 / 处理 |
| 输入框旁没有按钮 | 插件未启用（设置页开关）、未装进 profile，或 profile 未重载 |
| 按钮一直灰着 | 草稿为空、草稿超 20000 字，或输入框处于提交中状态 |
| 提示「没能写入输入框」 | 面板打开后该会话已被回收（不可写），或面板已被关闭/重开而不再是当前那一份；面板会保持展开不收起，内容仍在面板里，手动复制即可（不会覆盖原稿） |
| 采纳时弹出确认框 | 当前草稿含 @引用 或附件，整替写入会破坏其结构，需你确认一次 |
| 设置页下拉是空的 | 宿主没有报告渠道：确认 DSH 已配置至少一个模型渠道，且 cordis.patch.yml 的行 id 与包名未被改动（浏览器半边按「精确 id → :行id 后缀 → schema 指纹」三重解析命名空间，改名也能工作，但会改变设置值的存放位置） |
| 设置页显示只读 | 官方设置表单（ctx.configForms）缺席或该文档不接受写入（非 loopback 页面），插件退回内置默认值且拒绝假保存 |
| 优化报「模型不存在」 | 设置里存的模型已不在该渠道目录中，重选一次 |
| 优化报上游错误 | 原文透传自 provider（如限流、密钥无效），按提示处理 |

许可

MIT