前言¶
DeepSeek Harness (DSH) 侧重于插件化架构。开发者在使用过程中常遇到两个具体痛点：一是无法直观预估单次请求的 token 消耗，二是缺乏跨会话的消耗统计与成本追踪，以及提示词优化的重复操作。dsh-plugins 是一个个人维护的插件集合包，旨在通过一个仓库安装三个常用插件，解决上述问题。
核心功能¶
该插件集包含以下三个主要组件：
* tokprev：单轮 token 输入预告与真实消耗徽标。
* tokstats：跨会话 token 消耗统计面板。
* promptopt：Composer 草稿提示词 AI 重写工具。
功能详解¶
tokprev：Token 预告与实报¶
该插件提供单轮 token 消耗的“事前预告 + 事后实报”闭环。
1. 发送前预告
在 Composer 底部显示下一轮输入的预估值。该数值由三部分组成：上下文基座、排队消息和草稿内容。随着打字实时跳动。同时显示输入占比及输出预估区间。
2. 真实消耗徽标
每轮对话结束后的最后一跳 assistant 消息上，会渲染一行弱化小字，显示该轮所有调用的真实消耗。计费输入口径包含 inputTokens、cacheReadTokens 和 cacheWriteTokens。
tokstats：跨会话统计¶
DSH 宿主的 StatsLine 仅支持单会话统计，本插件通过侧栏脚按钮打开弹层面板，展示跨会话的详细数据。
1. 统计维度
支持按时间段（今日、本周、累计）查看请求数与 token 桶。支持按工作区聚合（子会话沿 parent 链归并到根工作区），以及按模型分组查看成本估算。
2. 初始化
首次安装后，面板显示“统计中…”，直到任一会话被打开或统计推送到达。
promptopt：提示词优化¶
在 Composer 卡片内部工具行（模型选择与发送按钮之间）提供星标按钮。点击后调用模型对草稿进行重写，原文与优化文上下对照，仅“采纳”后才将优化结果写回输入框。
1. 语言与限制
优化产物跟随草稿语言，不进词典。若草稿包含引用 chip、图片或 / 命令，按钮会被置灰禁用。
2. 性能与开销
这是一个旁路模型调用，不会计入跨会话统计日志，也不支持在配置面板选择模型。
安装与启用¶
本插件包采用 pnpm 作为安装转接器，支持从 GitHub 仓库直接安装。
npx @deepseek-ai/dsh plugin --profile web add github:PlusQi/dsh-plugins
安装后需要重启 dsh web 进程，profile 组合仅在启动时生效。
单插件开关¶
若需临时关闭单个插件而不修改代码，需编辑宿主的配置文件：
# 编辑 ~/.dsh/profiles/web/cordis.patch.yml
- id: tokprev
disabled: true
重启生效。注意，禁用插件仅移除宿主侧的 fiber，对于纯界面插件（如 tokprev），浏览器侧界面可能不会立即消失，需等待包内无其他存活插件时才会卸载。
注意事项¶
- Locale 依赖：插件依赖宿主的 locale 服务。若宿主未开启或被禁用，整包将不加载，表现为插件 UI 消失且无日志。
- 成本估算：tokstats 的金额为估算值，基于 DeepSeek 官方高峰单价，可通过 patch 文件覆盖。
- Promptopt 行为：优化产物不落盘，无 checkpoint；采纳时以发起时刻的草稿快照为准，会覆盖后续的改动。
