DeepSeek Harness 的核心理念是“一切皆插件”。在使用过程中，开发者常面临需要便签记录、API 成本追踪、会话管理以及界面辅助功能的需求。dsh-toolkit 是一组纯增量的原生插件合集，包含便签、API 余额与费用、推理等级、删除会话、对话节点导航条和轻拟物皮肤。它通过官方插槽与独立 API 路由注入，不修改 Harness 核心，卸载即可完全还原。
插件由 Vast-Unhurried 维护，遵循 MIT 许可证。安装后需重启 dsh 服务以加载宿主路由与客户端 bundle。
安装¶
推荐使用官方命令一键安装全家桶：
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit"
如需按需安装单个组件，可指定仓库内的路径：
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit#path:packages/dsh-note"
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit#path:packages/dsh-session-delete"
核心功能¶
便签（dsh-note）¶
在输入框工具行打开。支持新建便签、查看历史记录（上限 30 条）、拖拽窗口。双击历史条目即可进入行内编辑，停止输入约 0.6 秒自动保存。文本上限 16,000 字符。数据落盘位置为 $DSH_HOME/storages/dsh-note。
API 余额与费用（dsh-api-balance）¶
在会话头部操作行显示余额徽章。双击徽章可打开“模型计费管理”，配置多个供应商、模型及费率，支持峰谷计价（周一至周五 9:00–12:00、14:00–18:00 为高峰）。悬停徽章可查看今日消耗。切换会话或供应商时，徽章会自动切换显示对应余额。
推理等级（dsh-reasoning-levels）¶
在官方模型选择器中，为 pi-ai 供应商的模型提供 low / medium / high / xhigh / max 五档推理等级。支持五档的模型默认档位为 Max。同一供应商内可混排支持与不支持档位的模型，reasoningEfforts: false 的模型不显示档位。
删除会话（dsh-session-delete）¶
在会话列表 ⋮ 菜单中新增“删除会话”。点击后彻底清理 JSONL 会话日志、工作区登记及归档集合。删除前会弹窗确认并展示会话 ID，拒绝删除运行中的会话。
对话节点导航条（dsh-session-nav）¶
在文字列与滚动条之间的右缘常驻节点串。每条 user 提问一轮次一短横条。支持悬停预览（显示该轮全部内容）、单击跳转并置顶、双击钉住（数量不限，localStorage 持久化）。最多同时显示 6 条，超出部分可通过滚轮翻看。激活条（DeepSeek 蓝）会跟随阅读位置自动滚入可视区。
轻拟物皮肤（dsh-softui-skin）¶
修改自 Lhy723/dsh-neu-theme。在设置 → 通用设置 → 外观中开启系统原生开关。启用后，浅色（奶油暖白）/ 深色（墨蓝夜）皮肤将跟随系统原生外观。关闭开关后，页面与 Harness 原生完全一致。
卸载¶
# 卸载全家桶
dsh plugin --profile web remove dsh-toolkit
# 卸载单个组件
dsh plugin --profile web remove dsh-note
dsh plugin --profile web remove dsh-api-balance
注意事项¶
- 环境要求：需要 DeepSeek Harness v0.1.0-rc.7+（Web 界面），Windows 实测；pnpm ≥ 9。
- 安全校验：所有 API 路由做同源校验，要求 Host 为回环地址且 Origin 与 Host 精确一致。
- 数据保留：卸载后便签数据文件默认保留，如需彻底清除需手动删除
$DSH_HOME/storages/dsh-note。
