前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在使用过程中，开发者可能会积累多个零散的工具想法或功能需求。dsh-tools 插件通过在设置页面提供页签式导航，将这些功能收纳到一个统一的工具箱中，方便集中管理和即时调用。
插件概览¶
dsh-tools 是一个面向 DSH Web Profile 的个人通用工具箱插件。作者为 LoKiGGo，采用 MIT 许可证。它不是一个单一的强功能工具，而是一个集成平台，允许用户通过开关控制多个独立功能的启用与停用。
安装与启用¶
安装过程通过 DSH 官方 CLI 完成，支持一键激活。
dsh plugin --profile web add dsh-tools
执行上述命令后，插件会自动完成依赖安装并写入激活层。安装完成后需要重启 dsh web 服务，进入“设置”菜单，点击“dsh 工具箱”即可看到管理界面。
核心功能¶
该插件收纳了系统维护、会话管理、插件生态及应用监控等多类功能。
1. 功能开关与系统工具¶
设置页顶部为常驻功能，包括：
* DeepSeek Harness 版本检查：检查宿主版本与 GitHub 最新 Release，仅检查不自动升级。
* 一键重启 dsh web：重启服务并自动打开新窗口，关闭旧页面，用于开发测试循环。
* 任务完成提示：当网页未聚焦且对话任务完成时，在桌面右下角弹出系统提示框，点击可跳转回会话。
下方为可选功能开关列表，开关状态即时生效并持久化保存。
2. 会话管理¶
在“会话管理”页签中，可以执行以下操作：
* 归档与删除：支持单条删除与批量删除会话，并提供归档功能。
* 磁盘占用：查看每个会话及工作区占用的磁盘空间。
* 文件操作：点击会话路径可直接打开对应文件夹。
* 加载优化：先快速返回列表，后台补齐大小与磁盘缓存，提升打开速度。
3. 插件生态¶
- 插件开关：控制已安装插件的启用与停用，点击插件名可跳转至其 GitHub 页面查看详情。
- 更新检查：检查并更新已安装的插件，支持 npm 注册表与 GitHub 安装源。
- 插件分类视图：在“设置 -> 插件”中新增“插件分类”页签，可筛选浏览官方、已安装（市场/GitHub/npm）及本地插件。
4. 应用用量¶
在“应用用量”页签中，可以按时间跨度（今年/本月/近7天等）聚合查看：
* Token 使用量
* 缓存命中率
* 会话时长与步数
* 估算费用（支持峰/谷价格切换）
5. 微信接入¶
通过“微信接入”页签，可以使用腾讯 openclaw-weixin / iLink 协议将个人微信接入 DSH Agent。
基础配置：
* 扫码绑定微信账号。
* 白名单模式：为空时仅记录模式，配置后放行。
* 会话模式：支持 room（共享会话）或 per-user（独立会话）。
* 媒体收发：图片、视频、文件自动下载到指定目录，Agent 回复中通过语法（如 [image:路径]）发送回微信。
* AI 能力：支持配置 ASR（语音转文字）、Vision（图像理解）、Image（文生图）的 Base URL、Key 和 Model。
注意： 同一微信账号同时只能有一个轮询网关。
配置文件¶
插件的配置存储在本地 JSON 文件中，路径通常为：
<DSH_HOME>/profiles/web/plugins-data/dsh-tools.json
首次修改时自动生成，修改前系统会自动备份原文件。配置结构包含 features（功能开关状态）和 featureConfig（各功能的扩展配置）。
注意事项¶
- 维护状态：本插件由纯 AI 制作，无人工维护，可能存在后续停止更新的情况，请谨慎使用。
- 依赖更新：更新宿主依赖（如 peerDependencies）时，必须删除
package-lock.json和node_modules后重装，否则可能因版本范围不匹配导致安装失败。 - 微信凭据：微信登录凭据保存在
~/.openclaw/openclaw-weixin/accounts/，请勿泄露。 - 权限要求：插件运行时需具备读取宿主会话日志及操作本地文件系统的权限。
