dsh-prompt-dock（提示词修改助手）
DSH 插件：挂在输入框工具行（conversation.input.right，模型选择左侧），对输入框草稿做：
- AI 改写：更简洁 / 更详细 / 结构化 / 译成英文 / 自定义指令；SSE 流式输出、可取消、写入后 ↩ 撤销
- 模板插入：自定义常用提示词模板，一键追加到草稿
工具行从左到右为「设置 / 风格菜单 / 改写」：风格与模板合并进一个二级菜单（触发器显示当前风格名；分类在右侧以树形浮层展开，父级保留不替换，空间不足时自动改为向左展开），因此「改写」成为本插件这一行最靠右的控件，紧邻官方模型选择器（再往右是官方模型选择与发送按钮，插件无法越过它们）。下拉箭头、选中态、开关、标签页均沿用官方视觉与主题令牌（选中项用底色 + 细阴影描边，不再打勾）。「改写」为纯图标（官方 sparkle 形状，文案在 tooltip），进行中在原位显示「改写中…」，完成后同一槽位变成 ↩ 撤销。设置面板与输入框同一中轴居中。
模型默认走 DSH 全局默认模型（agentDefaultModel），可在设置里固定为某个模型；改写调用宿主半 ctx.llm.stream。
配置文件
界面与配置文件是同一份 JSON，两种方式等价：
- 路径：
~/.dsh/prompt-dock/settings.json（遵循 DSH_HOME）
- 入口：设置面板标题栏的文件夹图标（「打开配置文件」），会在系统文件管理器中定位到该文件；文件不存在时会先按默认值生成
- 打开设置面板即重新读取该文件，所以手工编辑后无需刷新页面即可看到
{
"styles": [{ "id": "concise", "name": "更简洁", "instruction": "……" }],
"templates": [{ "id": "t-review", "name": "代码审查", "text": "……" }],
"customInstruction": "",
"contextEnabled": true,
"contextTurns": 6,
"rewriteModel": { "provider": "deepseek-official", "model": "deepseek-chat" }
}
字段说明：
| 字段 | 含义 | 约束 |
|---|
styles | 风格列表（id 用于菜单与记忆，name 显示） | 缺省时用内置 5 条；custom 的 instruction 应为空 |
templates | 模板列表，插入草稿末尾 | ≤ 100 条；name ≤ 60 字，text ≤ 4000 字 |
customInstruction | 「自定义」风格的改写要求 | ≤ 2000 字 |
contextEnabled | 改写时是否附带最近对话 | 布尔 |
contextTurns | 附带最近多少轮 | 1–20 |
rewriteModel | 固定改写模型；null 表示跟随全局默认 | { provider, model } 或 null |
注意：在界面里点「保存」会用当前界面内容整份覆盖该文件；手工编辑后若界面里还留着旧状态，请先重新打开面板再保存。
内置风格与模板
风格指令的共同约定：只输出改写后的正文；写清「必须保留什么」与「禁止做什么」；给出目标长度区间，避免模型为凑长度而丢约束或编造。每条都可在设置里改。
| 风格 | 关键约束 |
|---|
| 更简洁 | 保留全部硬性约束、数字与阈值、文件/接口/字段名、验收标准与否定条件；不得为缩短删要求；目标 50%–70% |
| 更详细 | 只补草稿已隐含的信息；不得编造事实/接口/数字；缺失信息写「待补充：…」；目标 1.5–3 倍 |
| 结构化 | 固定章节顺序：目标 / 上下文 / 任务步骤 / 约束 / 输出格式；只重组不新增需求；空章节省略 |
| 译成英文 | 代码标识符、路径、命令行参数、产品名不译；Markdown 结构保留；不增删信息 |
| 自定义 | 指令为空，取设置里的「自定义改写指令」；两者都空时报 NO_INSTRUCTION |
模板（插入草稿末尾）：代码审查（按严重程度分类 + 文件:行号 + 修复建议）、解释代码（职责/控制流/边界/坑点，禁止逐行复述）、写测试（正常/边界/失败路径，不 mock 被测逻辑，注明框架与命令）。
这些是默认值。一旦在设置里保存过风格或模板，~/.dsh/prompt-dock/settings.json 会覆盖默认值，后续版本改默认文案不会自动生效——需手动改或在设置里恢复。
安全与边界
- 回环围栏：所有
/api/prompt-dock/* 只接受本机来源（校验 socket 地址、Host、Origin，并拒绝带 X-Forwarded-For / Forwarded 的请求）。*.localhost 与非 http(s) 的自定义 scheme（桌面壳 app://、tauri://、file://）放行，http(s) 必须是回环。不要把 dsh web 暴露在反向代理后还期望这道围栏生效。
- 改写限流：同一宿主进程内并发改写上限 2，每分钟成功调用上限 10（失败调用不占配额）。
- 芯片保护：草稿含
@文件 / /命令 引用芯片时，「改写」置灰并提示。判据取自宿主真实发布状态——InputState.occurrences 非空即视为含芯片（见下）。
- 变更检测：改写期间若草稿被改动，结果不会回填，避免覆盖新输入。
- 只走
inputActions.setDraft：不再猜测其它方法名。宿主不支持时显式报错，而不是静默换一条未知路径。
与宿主 API 的对应关系（已核对 dsh 0.2.1-rc.2 运行时）
| 宿主事实 | 本插件的处理 |
|---|
SessionInputShell.compose() 发布 { draft: projection.clipboardText, draftRev, phase, occurrences, ... } | pickDraftText 读 draft；chipFromState 读 occurrences |
inputActions.setDraft(text) 是单参数，内部 text.replace(REFERENCE_PLACEHOLDER_RE, "") 并重建段落 | 回填只调用 setDraft(text)；含芯片时直接禁用改写 |
芯片占位符为 [\uE100-\uE11D\uFFFC]，setDraft 会清掉它们 | detectChip 额外检测这些字符作为兜底 |
兼容性
- dsh
>=0.2.0-rc.2 <0.3.0 || >=0.2.1-0 <0.3.0（已在 0.2.1-rc.2 上核对 API 与行为；区间用并集是因为 semver 的预发布门控要求同 major.minor.patch 的比较器）。
- 宿主未提供
inputActions.setDraft 时，改写会明确报「当前宿主不支持改写回填」。
路由
| 路由 | 说明 |
|---|
GET/POST /api/prompt-dock/config | 读写设置 |
GET /api/prompt-dock/models | 模型目录 + 全局默认 |
POST /api/prompt-dock/rewrite | {text, styleId, customInstruction, sessionId, useContext} → {ok, text} |
POST /api/prompt-dock/rewrite-stream | 同上，text/event-stream：meta / delta / done / error |
POST /api/prompt-dock/cancel | {requestId} 中断进行中的流式改写 |
POST /api/prompt-dock/probe | 开发期探针（~/.dsh/prompt-dock/probe.json） |
错误码：AUTH / RATE_LIMIT（含 retryAfter）/ CONCURRENCY_LIMIT / QUOTA / CONTEXT_WINDOW / TIMEOUT / EMPTY_TEXT / TEXT_OVER / NO_INSTRUCTION / NO_MODEL / NO_LLM / LLM_FAILED / EMPTY_REPLY / BAD_JSON / BODY_OVER_SIZE / METHOD。
安装
从 GitHub 安装（推荐，lib/ 为已提交产物，无需本地构建）：
dsh plugin --profile web add github:wnei-f/dsh-prompt-dock
# 重启 dsh web 后生效
从本地目录安装（开发迭代用）：
dsh plugin install <本目录绝对路径>
也可在 GUI 插件管理里安装。开发迭代：改码 → 重新 install → 刷新页面。
开发
npm test # 160 项断言：宿主路由、客户端纯逻辑、组件挂载
无需安装依赖（测试只用 Node 内置模块）；Node 版本要求见 package.json 的 engines。
标识
