前言¶

在 DeepSeek Harness（DSH）里写提示词，常见做法是先在编辑器里堆一段口语化草稿，再手动补输出格式、约束和范围，或复制到外部工具里改写。草稿短还好，一旦涉及多轮对话里的「按上面的方案改」这类指代，改写成本会明显上升。社区插件 dsh-prompt-wisp（提示词精灵）把这一步收进宿主界面：在聊天输入框发送键左侧注册一枚 ✦ 按钮，点一下即可用你已配置的模型把草稿改写成更清晰、结构化、可直接执行的提示词；另提供会话执行监控告警条，便于发现卡死、空转等问题。下面介绍其定位、能力与安装用法。

这是什么¶

dsh-prompt-wisp 由维护者 jr-create 发布，分类为客户端插件，面向 DSH web profile。一句话：在 composer 工具行、发送键旁增加 ✦ 优化按钮，读取输入框草稿，经宿主端调用默认或指定模型改写后写回输入框；模型调用走宿主已配置的服务，插件本身零运行时依赖、零外部网络请求、零构建步骤。

项目托管于 GitHub（jr-create/dsh-prompt-wisp），当前 package 版本 0.2.0，许可证 MIT。社区目录页：skillhub.cn 插件页。DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

提示词优化（✦ 按钮）¶

• 槽位：官方 conversation.input.right（发送键左侧），深浅色主题自动适配。
• 流程：读取草稿 → 宿主调用模型 → 按内置提示词工程规则改写 → 写回输入框。规则侧重点是保留意图与约束、补明显缺口、消除模糊表述、语言跟随草稿；模型只返回改写正文。
• 会话上下文感知（详细优化模式）：浏览器仅传 sessionId；会话日志在宿主端经 sessionPersistence 只读读取，不碰原始 .jsonl.zstd。摘要排除 source.kind === 'plugin' 的注入消息；尾部最多 80 事件 → 最多 12 条对话 → 每条最多 600 字符 → 全文预算 4000 字符。无历史或读失败时降级为「仅按草稿优化」，成功时气泡可标注「（已结合会话上下文）」。
• 安全与反馈：HTTP 路由 loopback-only + same-origin；草稿单次上限 20,000 字符；空草稿、超长、模型错误在按钮旁内联提示，不静默失败。

双模式与兜底¶

两种模式最多向 3 条模型路由并发，先返回干净答案者胜出；竞速失败或超时时，本地规则引擎（去废话词典、形状规范化、重复句折叠）兜底。

模型路由（优先级）¶

1. 请求显式 { provider, model }（经注册表校验）；
2. 宿主「默认模型」（agent-default-model）；
3. 第一个已注册 provider 的第一个模型。

GET /api/dsh-prompt-wisp/route 可查询当前会使用的模型。

会话执行监控¶

在输入区上方 conversation.input.dock 槽位显示全宽告警条：浏览器每 5 秒轮询（后台标签页暂停），宿主经 sessionPersistence 分析最近 120 个事件，检测卡死/死锁（45 秒无新事件）、无效输出（8+ 步无可见文本）、工具循环（同工具近似参数连续 5 次）、回合失败（120 秒内）等。只读分析，不写入会话、不干预执行；关闭后若有新发现会再弹出。

设置页¶

DSH 设置 → 提示词精灵：两个分组、六个开关，保存后立即生效；配置落在 <DSH_HOME>/dsh-prompt-wisp/config.json。

提示词优化：「去废话」（默认关）、「详细优化」（默认关）。

会话执行监控：「显示会话监控告警条」（默认开）、「卡死/死锁检测」（默认开）、「无效输出检测」（默认开）、「工具循环检测」（默认开）。

HTTP API（loopback + same-origin）¶

可修复错误返回 200 + { ok: false, error } 供界面展示；未预期崩溃才 500。

安装与启用¶

安装命令以仓库 README 为准：

# 从 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，输入区工具行出现 ✦ 按钮即表示加载成功。

兼容性（README 声明）：DSH 宿主 0.1.5-rc.2（开发与 81 项测试所验证版本）；profile web；Node ^22.19.0 || >=24.0.0。无 LLM 服务时插件仍可加载，按钮会提示宿主无可用 LLM；无 sessionPersistence 时上下文感知与执行监控自动关闭。

典型用法¶

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

需要完整结构化改写并结合近期对话指代时，在设置中打开「详细优化」。想确认当前模型路由时，可在本机访问 GET /api/dsh-prompt-wisp/route（须满足 loopback + same-origin）。

适用场景与注意¶

适合：经常在 DSH web 界面写长提示、希望少切换工具即可完成结构化改写；希望在 composer 上方被动观察回合是否卡死、空转或工具循环的开发者。

权限与风险（插件自述）：读取点击 ✦ 时的草稿与默认模型配置（只读）；写入优化后的草稿文本；不直连外部 API；会话摘要在详细模式下由宿主只读提供。插件以当前 dsh 进程权限运行，安装前建议阅读 源码与 LICENSE，自行评估是否满足环境要求。

结尾¶

dsh-prompt-wisp 把「草稿 → 可执行提示词」和轻量会话监控收进 DSH 输入区，依赖宿主已有模型与 sessionPersistence，无额外构建与外部请求。进一步了解与安装：

• 社区目录：https://www.skillhub.cn/plugins/jr-create/dsh-prompt-wisp
• 源码与文档：https://github.com/jr-create/dsh-prompt-wisp