前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”，旨在通过模块化扩展来增强应用能力。dsh-kit 是一个面向 DSH 浏览器界面的能力插件包，它通过零依赖、零构建的架构，为 DSH 的界面加装可选能力。当所有功能关闭时，DSH 保持原版状态，不影响原有体验。
安装与启用¶
在宿主环境满足要求后，使用以下命令安装最新版本：
dsh plugin --profile web add "github:zhouzhencheng07/dsh-kit#semver:*"
安装或更新后，重启 dsh web，工具行会出现文件树、源代码管理、知识库、终端四个开关，工作台以官方右侧边栏承载各类 dock 签。
核心功能¶
dsh-kit 提供了以下独立的能力模块：
- 终端：底部多标签终端坞，绑定开启时所在会话。引擎为官方
webTerminals服务，支持 PTY。 - 文件树：以会话工作区为根浏览，支持新建/重命名/删除（回收站）/复制路径/@到对话。
- 源代码管理：页内 git 工作台，支持暂存/取消暂存/放弃/提交、分支切换、提交图谱。
- 日程：只读面板，数据结构化落盘至
$DSH_HOME/dsh-kit/schedule/（包含events/和entries/目录）。 - 知识库：左栏搜索+目录树，右栏阅读签。支持双链跳转（
[[页#标题]]），支持导入本地文件并自动处理引用。 - 内置浏览器：Agent 驱动，支持快照、动作、断言的 GUI 测试循环，支持人机共驾。
- 技能管理：设置面板新增页面，支持复制、移动、删除、禁用/启用技能。
- 手机访问：设置面板新增页面，提供令牌鉴权网关（默认端口 3090）。
- 网页搜索：免费多源引擎链，替换付费的
deepseek-official。 - 会话监视：自动重试 429 错误，流式输出重复内容时自动停止回合并续跑。
- 会话通知：桌面通知 API，在回合收尾、上下文压缩完成或等待批准时弹窗。
- 余额与用量：显示芯片与用量百分比（DeepSeek 出余额，OpenCode Go / GLM Coding Plan 出窗口用量）。
使用说明¶
- 启用功能：使用工具行开关或快捷键（
Ctrl+/、Ctrl+,、Ctrl+Alt+.、Ctrl+Alt+K）启用终端、文件树、源代码管理、知识库。 - 配置功能：在侧栏“插件”中找到 dsh-kit 的“配置”页，可自定义各功能开关、快捷键、搜索条数、会话监视参数等。配置保存即写入 profile 并热生效。
环境与依赖¶
- 宿主版本要求：dsh ≥ 0.1.5（依赖官方右侧边栏服务
sidebar.right）。 - Node.js：≥ 22。
- 依赖声明：零依赖声明；运行时从 profile fallback node_modules 解析。
- 数据目录：知识库数据目录默认为
dsh-kit/vault。 - 编辑权限：工作区文件不做插件内编辑，编辑需通过 agent 文件工具或本地编辑器。
