dsh-prompt-refiner：DeepSeek Harness 提示词精炼插件

前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的理念。在开发智能体或调试模型时，开发者经常需要将模糊的草稿改写成结构化、可执行的提示词。dsh-prompt-refiner 是一款输入栏「提示词精炼」插件，旨在解决提示词结构混乱、精炼成本高（特别是思考 token 计费问题）以及缺乏监控数据等问题。

核心功能¶

插件提供以下能力：
* 结构化改写：将输入文本改写为「目标 / 背景 / 步骤 / 要求 / [假设]」结构。
* 成本路由：精炼过程可路由到便宜的模型（如 deepseek-v4-flash），而非跟随会话默认模型。
* 结果缓存：基于 LRU 策略缓存精炼结果，相同输入零成本复用。
* Token 统计：面板展示用量，并将数据落盘为 JSONL，支持 GET /prompt-refine/stats 查询。
* 思考档位控制：默认 off，避免不必要的思考 token 消耗。
* 对比面板：展示原文与改写结果，假设部分独立高亮。
* 清洗与校验：结果长度护栏，max-tokens 截断判为失败并丢弃。

安装与配置¶

插件提供动态模式（免安装）和静态模式（推荐）两种安装方式。

动态模式（尝鲜）¶

在 DSH 的「Cordis 动态插件」面板中：
1. 新建插件；
2. 在 code.host 粘贴 src/host.js 全文，code.client 粘贴 src/client.js 全文；
3. 激活并授权，输入栏出现 ✨ 按钮。
注意：动态版限制模型跟随会话默认选择、缓存仅内存、统计不落盘。

静态模式（推荐）¶

使用 npm 包安装：

npm publish          # 或先在本地 npm pack
dsh plugin --profile web add dsh-prompt-refiner

安装后，在 ~/.dsh/profiles/web/cordis.patch.yml 注册插件行：

- insert:
    - id: dsh-prompt-refiner
      name: 'dsh-prompt-refiner'

重启 dsh web 服务后生效。

配置文件¶

编辑 $DSH_HOME/prompt-refiner/config.json（默认 ~/.dsh/prompt-refiner/config.json）。配置项优先级为：cordis 条目 > config.json > 内置默认。

{
  "model": "deepseek-v4-flash", // 优化器模型；null = 跟随会话当前模型
  "provider": null,             // null = 跟随会话当前 provider
  "reasoningEffort": "off",     // 思考档位：'off'|'low'|'high'|'max'
  "maxTokens": 2048,
  "temperature": 0.3,
  "minChars": 0,
  "maxChars": 8000,
  "resultMaxChars": 4000,       // 结果长度护栏
  "cacheMax": 200,
  "cacheTtlMs": 86400000,
  "metrics": true               // 统计落盘开关
}

关键配置说明：思考档位¶

DeepSeek 适配器把模型的 thinking token 计在 outputTokens 里。不显式指定档位时，适配器默认 high，会导致精炼任务产生大量无用的思考内容。
插件默认下发 reasoningEffort: 'off'，并在面板显示实际生效的档位（如 思考 off）。若请求的档位不被支持，插件会自动回退到该模型支持的最省档位。

统计与监控¶

插件提供两类数据反馈：
1. 落盘文件：$DSH_HOME/prompt-refiner/metrics.jsonl。每次精炼追加一行记录，包含时间、模型、是否缓存命中、是否跳过、实际思考档位、字符数、入/出/思考 token、耗时。
2. 接口查询：GET /prompt-refine/stats。用于汇总自宿主启动起的内存累计及落盘目录位置。
3. 面板展示：实时显示模型、字数变化、耗时、缓存状态、思考档位及 token 统计。

已知限制与差异¶

与 dsh-prompt-optimize-plugin 的差异：本插件补齐了成本控制层。相比于 dsh-prompt-optimize-plugin，本插件支持成本路由（使用便宜模型）、LRU 缓存、统计落盘，以及思考档位默认关闭（防止非必要计费）。
结果截断：若结果因 max-tokens 被截断，会被判为失败并丢弃，不会应用半截提示词。
未验证项：
- 本地路径挂载（不发布直接指向本目录）的 CLI 用法尚未验证。
- 面板在真实浏览器里的观感需要人眼确认。
- Phase A 路线（自动拦截）的实现状态。

总结¶

dsh-prompt-refiner 是一款专注于提示词结构化与成本控制的 DSH 插件。通过默认关闭思考档位、支持缓存路由以及完善的统计落盘，它可以帮助开发者在精炼提示词时有效控制 Token 消耗。

目录页：https://www.skillhub.cn/plugins/glh5835/dsh-prompt-refiner
GitHub：https://github.com/glh5835/dsh-prompt-refiner