前言¶
DeepSeek Harness (DSH) 插件生态旨在通过模块化扩展工具集。narrative-prompt-polish 插件位于“模型推理”分类下，由 shengyvself 维护。它解决了一个常见痛点：原始草稿往往缺乏清晰度，难以直接交付给 AI Agent。它通过启动一个可对话的子代理来打磨提示词，而不是立即覆盖文本。本插件要求 DSH 版本 ≥ 0.1.5。
核心功能¶
-
主框 ✨ → 可对话子代理打磨
点击主框右下角的✨，服务端会通过POST /api/polish.start在主会话下起一个continuable子代理。该子代理继承当前会话的 provider、model 和预设。客户端随后打开该子代理会话，进入多轮追问环节。满意后，用户手动将结果复制回主输入框。 -
C 方案与 Prompt Cache
默认使用full模式，通过deriveMessages复刻[system] + [...history]前缀。这确保了前缀与主会话一致，从而命中 prompt cache，仅增量计算草稿与润色指令。若主会话非 live 会话，会降级至partial（近期对话）或none（裸草稿）。 -
意图分类与安全写回
插件内置本地正则分类意图（debug/implement/explain/chat）。在 CAS（Check-And-Set）机制下，若草稿在打磨期间被用户修改，插件会拒绝覆盖并提示“草稿已变，未应用润色”。 -
Trace 与事件总线
每次调用会追加 JSONL Trace 到lore/traces/prompt-polish/YYYY-MM-DD.jsonl，记录意图、上下文模式、缓存命中等信息。插件支持事件总线联动，外部模块可通过广播narrative:prompt-polish:trigger触发单次 polish 流程。
安装与启用¶
安装过程依赖 DSH 内核提供的子代理编排服务。
dsh plugin --profile web add github:shengyvself/narrative-prompt-polish
安装后重启 DSH Web 即可生效。插件在 0.2.0 版本起移除了所有第三方依赖。
典型用法¶
- 在主框输入草稿。
- 点击输入框右下角的
✨。 - 子代理会话被打开，任务书进入首轮对话。
- 在子代理会话中多轮追问，优化提示词细节。
- 满意后，手动复制回填至主输入框。
适用场景与注意¶
本插件旨在辅助提示词优化，适合需要将模糊需求转化为具体执行指令的开发者。
- 仓库迁移：原仓
narrative-prompt-polish已迁移至dsh-prompt-only-forge，旧仓保持只读，不再接受新提交。 - UI 与安全：无野生 DOM 注入，UI 走官方 slot。服务端无
@deepseek-ai/*静态 import。 - 配置调整：
strictFull: true可改为硬失败（no-session），侧边栏浮按钮在 0.2.0 中已移除。
短结尾¶
该插件通过子代理机制和 C 方案，为 DSH 用户提供了意图感知的提示词打磨能力。更多细节与源码，可查看插件目录或GitHub。
