提示词精灵 jr-create/dsh-prompt-wisp

dsh-prompt-wisp · 提示词精灵

一句话：在 DeepSeek Harness 聊天输入框的发送键旁加一枚 ✦ 按钮——点一下，草稿立刻被你已配置的模型改写成清晰、结构化、可直接执行的提示词。

One-liner (EN): A ✦ button next to the composer's send key in DeepSeek Harness — one click rewrites your draft into a clear, structured, ready-to-run prompt using the model you already configured.

零运行时依赖 · 零外部网络请求（模型调用走宿主自己已配置的服务）· 零构建步骤

它做什么

| ✦ 优化按钮 | 注册在官方 conversation.input.right 槽位（composer 工具行、发送键左侧），深浅色主题自动适配 |
| 一键改写 | 读取输入框草稿 → 宿主端调用你配置的默认模型 → 结构化改写 → 写回输入框 |
| 会话上下文感知 | 自动读取当前会话最近的对话（经 sessionPersistence，最多 12 条），改写时把「它 / 上面的方案」这类指代落到具体对象上 |
| 安全围栏 | 所有 HTTP 路由 loopback-only + same-origin；草稿单次上限 20,000 字符 |
| 失败可见 | 空草稿、超长、模型错误都在按钮旁内联提示，绝不静默失败 |

改写遵循一套内置的提示词工程规则：保留全部意图与约束、补全明显缺口（输出格式/范围）、消除模糊表述、语言跟随草稿——模型只返回改写正文，不夹带解释。

上下文感知怎么工作

- 浏览器只把 sessionId 发给宿主；会话日志只在宿主端读取（经官方 sessionPersistence 服务的只读句柄，绝不碰原始 .jsonl.zstd 文件）；
- 摘要只取真人发言与模型回答——注入的上下文（文件变更通知、skill 内容等）虽也是 user/message，但 source.kind === 'plugin'，被明确排除，不会污染优化依据；
- 尾部最多 80 个事件 → 最多 12 条对话消息 → 每条截断 600 字符 → 全文预算 4000 字符；
- 上下文是增强不是依赖：新会话无历史、会话读取失败、persistence 服务不在，都降级为「仅按草稿优化」，按钮照样工作，成功气泡会标注「（已结合会话上下文）」。

安装

从 GitHub 安装（推荐锁定 release tag）
dsh plugin --profile web add github:jr-create/dsh-prompt-wisp#v0.2.0

或跟踪仓库最新状态
dsh plugin --profile web add github:jr-create/dsh-prompt-wisp

本地开发（链接源目录）
dsh plugin --profile web add link:<本仓库绝对路径>

安装后重启 dsh web，输入区工具行出现 ✦ 按钮即成功。

使用

1. 在输入框正常写草稿（中英文皆可）；
2. 点 ✦（草稿为空时按钮置灰）；
3. 等待片刻——优化结果自动替换草稿，按钮旁出现确认气泡（失败则显示红色原因）。

模型路由（按优先级）

1. 请求显式指定的 { provider, model }（先对注册表校验）；
2. 宿主设置的默认 Agent 模型（设置页「默认模型」，agent-default-model）；
3. 第一个已注册 provider 的第一个模型。

GET /api/dsh-prompt-wisp/route 可随时查询「此刻会走哪个模型」。

HTTP API（全部 loopback-only + same-origin 围栏）

| 端点 | 方法 | 说明 |
| /api/dsh-prompt-wisp/status | GET | 版本、能力位（llm 服务 / 默认模型）、草稿长度上限 |
| /api/dsh-prompt-wisp/route | GET | 当前模型路由（不可用时返回原因而非 500） |
| /api/dsh-prompt-wisp/optimize | POST | { prompt, sessionId?, provider?, model? } → { optimized, provider, model, contextUsed, contextReason?, tookMs } |

错误约定：客户端可修复的问题（空草稿/超长/路由不存在/模型失败）返回 200 + { ok:false, error } 由界面内联展示；只有未预期崩溃才走 500。

设计与防回归（每条都有测试锁）

| 决策 | 理由 | 测试 |
| 彻底零依赖 | link 安装的插件从源目录被 import，够不到宿主依赖闭包；一个宿主 import 能拖死整棵插件树 | packaging.test.mjs 真实 import 每个模块 + 全文禁 @deepseek-ai |
| 晚到服务用 ctx.inject | ctx.get 的时序缺失不报错、只静默丢功能 | 宿主半侧结构断言 |
| 槽位不碰编辑器 DOM | composer 是宿主内部的 Lexical contenteditable，DOM 私有 | client.test.mjs 断言无 querySelector/contenteditable |
| 模型失败必须可见 | llm.stream 把适配器失败归一化为终止 finish 分片，只读文本分片会看到静默空答案 | collectText 对 error/aborted 都抛出并带 failure.message |
| 主题变量必须成对带 fallback | 缺 token 时整条声明静默失效；品牌色在深色主题下是白色 | 逐个 var(--dsw-) 检查 fallback |
| 诚实报错 | 空草稿/超长/无模型都是「可解释的失败」，不伪装成 500 | http.test.mjs 逐路径覆盖 |

已知边界（诚实声明）：浏览器端无 React/DOM 依赖，做不了渲染测试；client.test.mjs 用结构性断言守住关键生命周期。

权限与风险声明

- 插件读取：输入框草稿（仅在你点击 ✦ 时发送到本机宿主）、宿主默认模型配置（只读）；
- 插件写入：输入框草稿文本（仅优化结果写回）；
- 外部服务：无——模型调用经由宿主自身已配置的 provider，插件不直连任何外部 API；
- 不读取会话记录、不修改任何 DSH 配置。

兼容性

- DSH 宿主：0.1.5-rc.2（本插件开发与全部 81 项测试所验证的版本）；目标 profile：web；Node ^22.19.0 || >=24.0.0；
- 插件使用的能力面（ctx.llm.stream、ctx.sessionPersistence、ctx.agentDefaultModel、webServer 路由、conversation.input./settings.section 槽位）在该版本均已存在且稳定；
- 宿主服务均为软依赖：没有 llm 服务的 profile 里插件照常加载，按钮会明确提示「宿主没有可用的 LLM 服务」；没有 sessionPersistence 时上下文感知与执行监控自动关闭，仅按草稿优化；
- 测试：node --test，81 项，全部离线。

会话执行监控

输入区上方的全宽告警条（官方 conversation.input.dock 槽位——composer 卡片正上方、正常文档流内，不遮挡输入框与会话内容）是执行监控的出口：浏览器每 5 秒轮询一次当前会话的日志尾部（宿主端经 sessionPersistence 只读句柄分析最近 120 个事件），检测四类执行异常：

| 检测项 | 触发条件 | 级别 |
| 卡死 / 死锁 | 回合进行中，超过 45 秒没有任何新事件（工具挂起 / 模型无响应） | 🔴 alert |
| 无效输出 | 回合已执行 8+ 步，仍无任何可见文本（无意义空转） | 🟡 warn |
| 工具循环 | 同一工具以几乎相同的参数连续调用 5 次（参数按 GUID/数字/空白归一化后比较） | 🟡 warn |
| 回合失败 | 最近一个回合以错误结束（120 秒内的才提示，旧错误不算） | 🟡 warn |

告警条点击 × 关闭；关闭后若出现新的发现会自动重新弹出（按发现集合变化判定，旧发现不会骚扰）。标签页切到后台时轮询自动暂停。分析纯只读（GET /api/dsh-prompt-wisp/watch），不写入会话，不干预执行——检测到卡死时由用户决定是否中断。

双引擎与速度

| 模式 | 引擎 | 实测耗时 |
| 简便优化（默认） | 模型竞速 + 精简提示词（lean prompt）+ 无上下文读取，6s/路预算 | 0.5–1.5s |
| 详细优化 | 模型竞速 + 完整结构化提示词 + 会话上下文，10s/路预算 | 1.4–4s |

- 两种模式都向最多 3 条模型路由同时发请求，谁先给出干净答案用谁（实测常由响应最快的路由胜出）；
- 竞速失败/超时时，本地规则引擎（去废话词典 + 形状规范化 + 重复句折叠）即时兜底——宁给规则改写，不给报错；
- 会话摘要只服务详细模式，自身有 15 秒预算，超时降级为无上下文。

设置页

设置界面新增「提示词精灵」分区（DSH 设置 → 提示词精灵）——本插件全部功能的集中配置，两个分组、六个独立开关，每项标注默认值，保存后立即生效：

分组一：提示词优化

| 开关 | 默认 | 作用 |
| 去废话 | 关 | 剔除草稿里的客套话、寒暄、重复与空洞修饰，只留有实际内容的指令；简便与详细模式都生效 |
| 详细优化 | 关 | 开 = 完整结构化提示词 + 会话上下文（1~4s）；关 = 简便优化：精简提示词 + 模型竞速（0.5~1.5s） |

分组二：会话执行监控

| 开关 | 默认 | 作用 |
| 显示会话监控告警条 | 开 | 在输入区上方显示执行异常告警条；关闭后完全隐藏（轮询也停止） |
| 卡死 / 死锁检测 | 开 | 回合进行中超过 45 秒无任何新事件时告警 |
| 无效输出检测 | 开 | 回合执行 8+ 步仍无可见文本时告警 |
| 工具循环检测 | 开 | 同一工具以几乎相同的参数连续调用 5 次时告警 |

配置持久化在 <DSH_HOME>/dsh-prompt-wisp/config.json（临时文件 + 原子重命名，手改坏的文件自动回落默认值）。

许可证

MIT