运维工具箱 sakanamaru/dsh-minato

DeepSeek Harness 工具箱 — dsh-minato

给 DeepSeek Harness（dsh）用的安装、监控、备份与修复工具箱，全程不用终端。 支持 Windows 和 Linux。本地运行。无遥测、无账号、不上传任何数据。

⚠️ 非官方项目。 本项目与 DeepSeek 无隶属关系，未获其认可，也无任何关联。它是第三方辅助工具，调用你本机已有的 dsh 命令行。

English · 简体中文 · 日本語

截图

下面全部是真实界面，基于测试数据目录截取 —— 图中不出现任何真实会话、路径或数字。

| 仪表盘 | 会话与 token | 备份 |
| Dashboard | Sessions | Backup |

| 健康检查 | 设置 | 更新中心 |
| Doctor | Settings | Update |

其余页面（概览、插件、关于、日志）与命令行

| 概览 | 插件 | 关于 | 日志 |
| Overview | Plugins | About | Logs |

| 命令行菜单 | 命令行状态 |
| CLI menu | CLI status |

为什么做这个

dsh 是命令行工具。安装、启动、备份，以及排查它为什么起不来，全是终端里的活 —— 而 Web UI 本身对这些操作没有任何入口。

这个工具箱把这些活搬进一个双击就能打开的窗口：

- 不用终端 —— 安装、启动、停止、更新、卸载，全在图形界面里完成。
- 备份靠得住 —— 备份包带完成标记和内容哈希，包被截断时直接拒绝，不会悄悄恢复出一份坏数据。
- 出问题给个准话 —— 健康检查会点名出故障的部件，并打印出修复它的那一行命令，而不是甩给你一堆堆栈信息。

它能做什么

| 安装 dsh | 双击即可。不用终端，也不需要懂 Node.js。它会安装命令行、配置 PATH 和开始菜单项，并在安装目录旁留一个卸载程序。 |
| 启动 / 停止 / 监控 | 一个按钮启动 Web UI，实时显示状态行和要打开的 URL。 |
| 备份与恢复 | 会话、设置和凭据 —— 打包时带完成标记和内容哈希，包被截断或被篡改就拒绝恢复，而不是照单全收。 |
| 备份管理器 | 动手之前，先看清每个包里到底装了什么。 |
| 迁移到另一台电脑 | 导出备份包，在新机器上导入。 |
| 更新中心 | 集中管理 Web UI、官方桌面应用、本工具和已安装插件。 |
| 健康检查 | 「到底哪里坏了？」—— 指出出问题的部件，并打印出修复它所需的那一行命令。 |
| 卸载 | 默认绝不删除你的数据，并且拒绝删除看起来不像安装目录的目录。 |

安装

Windows

从 Releases 下载 dsh-minato-<version>-win-x64-setup.exe 并运行。

- Windows 二进制文件没有数字签名，所以首次运行时 SmartScreen 可能弹出「未知发布者」提示。运行前请用发布的 .sha256（以及 GPG 签名的 hashes.txt）校验下载文件。
- 想要便携版？用 dsh-minato-win-x64.zip，解压后运行 gui\dsht-gui.exe。

Linux

下载 dsh-minato-linux-x64.tar.gz，然后：

tar -xzf dsh-minato-linux-x64.tar.gz
cd dsh-minato-linux-x64
./install.sh # installs for the current user; --prefix <dir> to choose the location

用 ./install.sh --uninstall 卸载（只有你自己挪动过安装位置时才加 --force）。

快速开始

1. 安装（见上文）并打开 dsh-minato。
2. 仪表盘会显示当前状态。如果缺少 dsh，健康检查会指出来并给出修复办法。
3. 按 Start，打开它打印出的 Web UI URL。
4. 改动任何东西之前，先按 Backup。

图形界面

十个页面，都能从左侧栏进入：

| 页面 | 用途 |
| 概览 | 一屏看清：装了什么、在跑什么、什么过期了。 |
| 仪表盘 | 关键数字 —— 会话数、缓存命中率、token —— 以及一键启停。 |
| 会话与 token | 按会话拆分，父子分组，可排序。 |
| 插件 | 某个配置档有哪些插件、哪些被禁用、哪些会导致启动失败。 |
| 备份 | 创建、查看、校验、恢复、导出和删除备份包。 |
| 健康检查 | 「哪里坏了」报告，附带精确处方。想跑的时候再跑 —— 它不会自己运行。 |
| 设置 | 语言、端口、行为 —— 不用改 YAML。 |
| 关于 | 版本、致谢，以及本工具刻意不做的事。 |
| 更新中心 | 更新 dsh、桌面应用、本工具或某个插件。 |
| 日志 | 过滤、搜索和导出启动器日志。 |

命令行

图形界面驱动的就是同一套命令行，你也可以单独使用：

dsh-minato status [--detail] what is installed / running / listening
dsh-minato start | stop start or stop the dsh Web UI
dsh-minato install | update install or update dsh (and this tool)
dsh-minato uninstall remove the tool (never touches your data)
dsh-minato sessions per-session token and cache figures
dsh-minato cost [--days 7|14|30] tokens and an estimated USD amount (needs your own unit prices; no prices = no amount)
dsh-minato backup [--to <dir>] 创建备份包 dsh-minato backup-list [--verify] 列出备份包，并校验包内容 dsh-minato backup-dir [--set <d>] 备份写入哪个目录 dsh-minato restore --path <pkg> [--apply] [--yes] dsh-minato backup-export | backup-delete dsh-minato doctor 完整健康检查，附带修复建议 dsh-minato profiles | profilecheck | profilepatch | bridge-install dsh-minato bootdiag dsh 为什么启动失败？
dsh-minato verify-install 校验你下载的文件 dsh-minato balance DeepSeek 账户余额（需要在设置里填 key） dsh-minato log | config-get | config-set | autostart | shortcut dsh-minato ui 启动本包自带的 GUI（缺失时退出码为 1） dsh-minato version | about | selftest

每条命令都会打印机器可读的标记（STATUS_OK、BACKUP_OK、RESTORE_FAIL……），脚本和 GUI 可以直接解析结果，不用从文字里猜。

安全与隐私 —— 哪些说法是真的

本节只讲代码实际做了什么。如果这里的某条说法在代码里找不到依据，那就是 bug，请反馈。

- 纯本地。 工具只读写你自己的机器。只有以下命令会联网：check、update-info、update-center、doctor、install、update、verify-install --url，以及 balance（仅当你已在设置里填了 balance_key；没填时该命令完全离线）。其余命令 —— status、sessions、cost、backup、restore、logs —— 从不建立连接。
- 无遥测，无账号，不上传。
- 卸载不会删除你的数据。 卸载只移除工具自身的文件。删除数据是另一个独立动作，需要你明确执行。
- 备份完整性靠校验，不靠假设。 备份包带一个最后写入的完成标记，以及逐文件哈希；中途中断的包、内容被改过的包，一律拒收。
- 零第三方运行时依赖：命令行、安装器、启动器和 dsh 插件都是如此。唯一例外是 GUI，它基于 Avalonia（一个 UI 框架）构建。
- 你设置的 API key 以明文保存在本地配置文件中，只有 balance 命令会把它发往 DeepSeek API 端点。留空则不保存任何内容。

已知限制

- 体积：自包含的 Windows 包约 50 MB（.NET 运行时打包在内，无需另外安装运行时）。
- 未做数字签名：请校验发布的 .sha256 和 GPG 签名，不要依赖证书。
- 没有 v2.x 界面回退：ui 只启动本包自带的 GUI（gui/ 文件夹里的 dsht-gui 可执行文件，或 DSHT_GUI 指向的程序）。缺失时它打印 UI_FAIL 并以 1 退出 —— 不会回退到已退役的 v2.x 界面。
- bridge 插件需要 pnpm（npm i -g pnpm）；dsh 不会替你安装。
- desktop 配置档由官方桌面应用管理 —— 给它的插件要在该应用自己的对话框里添加，不能从命令行添加。
- backup-export 在 3.0.0 到 3.0.6 的每个已发布版本里都是坏的：只要包非空就一定失败（文件复制了，但同级的 .manifest 没写，还打印 BKEXPORT_FAIL）。
3.0.7 已修复（BKEXPORT_OK + 同级标记文件 + 端到端断言）。
- 命令行退出码（2026-10-30 全部裁定完毕，策略 A）：0 表示成功，也用于计划/只读预览； 1 表示拒绝执行或操作失败（包括「你问的东西找不到 / 读不了 / 验不了」）； 2 表示用法错误（参数缺失、非法或冲突）；3 表示启动自完整性检查拒绝运行。
明确降级或跳过的路径仍返回 0，并在各自的标记行里说明（RESTORE_WS_SKIPPED、INTEGRITY_SKIPPED、PROFILECHK_SKIPPED_VENDOR、BRIDGE_FAIL_RAW 以及 _PRE_BACKUP_FAILED 诊断）。下面每一类在 v3/tests/verify_exit_codes.ps1 里都有端到端断言；逐类的裁定、理由和未覆盖清单见 docs/退出码裁决-2026-10-30.md（中文，权威）。

| 命令 | 成功 / 计划 | 失败 / 拒绝 1 | 用法错误 2 |
| config-set | CONFIGSET_OK | 写入未生效 | 未知键 / 非法值 |
| backup-dir | BACKUP_DIR / _OK / _RESET | 无法删除/创建/保存 | 相对路径或无法解析的路径 |
| restore | RESTORE_OK | 没有备份、在根目录之外、包非法/不完整、回滚失败 | 缺少 --path |
| restore --dry-run | DRYRUN_OK | 没有有效备份、包非法/不完整 | — |
| wipe | 带 --yes：仅手动删除路径 | 缺少 --yes；无法计算路径 | — |
| backup-delete | BKDEL_PLAN / BKDEL_OK | 在根目录之外、不是备份、确认时间过期、删除失败 | 缺少 --path、--confirm-time 格式错误 |
| backup-export | BKEXPORT_PLAN / BKEXPORT_OK | 在根目录之外、找不到、目标嵌套/非法、导出失败 | 缺少 --path / --to |
| import | IMPORT_PLAN / IMPORT_OK | 源不存在、包为空/非法、复制失败 | 缺少 --path、路径无法解析 |
| verify-install | VERIFY_OK 1 | 文件缺失、清单缺失/不可读、不在清单里、哈希不匹配 | — |
| start | START_OK / START_PLAN | 端口被非 dsh 进程占用、启动失败、30 秒内未就绪 | --profile 非法 |
| stop | STOP_OK / STOP_PLAN | 没有运行中的 dsh、监听者不是 dsh、安全拒绝、仍在监听 | — |
| bridge-install | BRIDGE_OK / BRIDGE_PLAN | 插件/dsh/pnpm 缺失、安装或打补丁失败、配置档由桌面应用管理 | --profile 非法 |
| ui | UI_OK | 找不到内置 GUI（不回退到 v2.x）、DSHT_GUI 缺失/不可执行、启动失败 | — |
| profilepatch | PROFILEPATCH_PLAN / _DRYRUN / _OK / _NOOP | patch 文件缺失、计划无效、应用失败 | 缺少 --profile、配置档名称无效 |
| profiles | PROFILES_OK | 找不到配置档目录 | — |
| bootdiag | BOOTDIAG_OK | 文件无法读取、输出无法识别 | 缺少 --from |
| doctor --report | DOCTOR_REPORT | 报告写入失败（DOCTOR_WRITE_FAIL） | — |
| log --export | LOG_EXPORT | 导出写入失败（LOG_FAIL） | — |
| sessions | SESSIONS_OK | 没有可读的投影、lineage（bridge 插件）不可用 | --days / --from / --to / --level 取值错误、范围冲突 |
| cost | COST_META / COST_TOTAL | 没有可读的投影、lineage（bridge 插件）不可用 | 参数错误与 sessions 相同 |
| install / update | _PLAN / _OK / _SKIP | node bootstrap 失败、版本列表/最新版本不可用、npm 失败、仅回滚 | --version 不安全 |
| uninstall | UNINSTALL_PLAN / UNINSTALL_OK / UNINSTALL_SKIP | npm 失败且仍能观察到 dsh | — |

wipe 无论退出码是什么都不会删除任何东西；这是有意为之，不是失败。
- 测试数量不能证明单条安全承诺：契约/GUI/插件测试套件全绿，只能说明回归覆盖到位——导出命令损坏和退出码不准确这两件事，都是在所有套件全绿时存在的。请把逐条承诺的端到端断言和修复记录当作证据。
- 含子代理统计：未实现（待第二批；需读原始日志）：磁盘上的会话投影完全不携带 lineage 字段（已在完整存储上验证），所以只靠投影做「包含子代理」的计数会静默漏掉边。GUI 的范围选择器把这些模式置灰，并标注「batch 2」；sessions --level 除 global 外一律拒绝，返回诚实的 SESSIONS_FAIL，而不是猜测。

可选 bridge 插件

dsh 只掌握一件只有它自己知道的事：哪些会话在它的进程里还活着。这件事不写入磁盘，所以没有插件时，那一列显示 unknown。

| | 没有插件 | 有插件 |
| 会话列表、token、缓存命中率、速度 | 有（从磁盘投影读取） | 有 |
| 「running」/「parked」标记 | unknown | 实时，进程内 |
| 仪表盘 lineage 范围（父级 / 父级 + 子代理） | 只有「global」；另外两个保持禁用 | 三个范围全部可用 |

它是只读的：不发模型请求、不写 dsh 状态、不碰对话内容、不联网，也从不阻塞 dsh。

对于 lineage 范围，它直接从磁盘读取 ~/.dsh/sessions 下的原始会话日志，并且只解码每个文件的第一个 zstd 帧头（parentSession / origin / createdAt，每个文件最多读 64 KiB）——正文帧从不解压，消息内容从不触碰。解码失败会计数并上报，绝不猜测。

安装方式：

dsh-minato bridge-install --profile web --yes
或者把仓库 URL 粘贴到桌面应用的添加插件对话框

这套工具包里的其他功能都不依赖它。

许可证与致谢

- MIT License。代码采用 MIT 协议，图标不是——详见 docs/ASSETS.md。
- DeepSeek Harness (dsh)
- AI 参与情况，如实说明：v1 脚本由 SOGR-Momono Dango（QwenPaw）协助完成；v2 的重写和打包由 DeepSeek DSH 完成；v3 和本文档主要由 AI 编程智能体撰写，每一处改动都由维护者审核、决定并接受。Logo 是生成式 AI 的产物（工具：Kimi），提示词由维护者提供。
- 这不意味着「AI 写的，所以不可信」，也不意味着「AI 写的，所以没问题」——判断依据应该是你自己能不能核查：每个产物都附带 SHA-256，命令行、安装器和启动器都是可审查的源码。
- GitHub： @sakanamaru