DEEPSEEK HARNESS TOOLBOX · SESSION LOG REPAIR & SESSION-AREA MANAGEMENT · MIT

A small toolbox for the DeepSeek Harness with two CLI packages:

面向 DeepSeek Harness 的小工具集，两个命令行组件：

• dtb-session-care — a corrupt session log can keep the whole Harness from starting; health-check and repair logs offline.

  会话日志损坏时，Harness 可能打不开 / 无法运行；用它离线体检并修复。

• dtb-harness-patch — apply the session-area management patch: drag sessions between workspaces / ungrouped / archived (all directions), archive folders, cross-directory moves, and resilience so one corrupt log no longer takes the whole UI down.

  给 Harness 打上会话区管理补丁：界面内拖拽整理会话（工作区 / 未分组 / 归档 之间全向移动）、归档文件夹、跨目录移动，坏日志不再拖垮整个界面。

npm i -g @dsh-toolbox/session-care @dsh-toolbox/harness-patch

推荐通过 npm 全局安装；@dsh-toolbox/core 是两个组件的共享底层，无需直接安装。

dtb-session-care health              # scan every session log (default root ~/.dsh/sessions)
dtb-session-care repair --apply      # repair corrupt logs (originals kept as .corrupt-<ts>)
dtb-harness-patch                    # interactive full-screen flow (see below)

dtb-harness-patch 默认进入交互式界面（全屏 TUI）：先显示各组状态一览（每个文件一行，带进度条与待应用/已具备/无法匹配计数），确认后逐补丁应用并实时更新进度；应用失败时提供"撤销 / 升级 Harness / 升级补丁模块"的选择。按 H 随时查看帮助。非 TTY 环境（管道 / CI）自动降级为文本流程；DSH_PATCH_TUI=0 可强制文本模式。

dtb-harness-patch 默认进入交互式界面：状态一览（每文件一行 + 进度条）→ 确认 → 逐补丁应用实时刷新；失败可撤销/升级。H 显示帮助，非终端自动降级为文本。

After dtb-harness-patch: refresh the browser (client capabilities: drag-organization, archived folder, etc. apply immediately) + restart the Harness once (host-side RPCs).

dtb-harness-patch 应用后：刷新浏览器（拖拽、归档文件夹等客户端能力立即生效）+ 重启一次 Harness（host 侧 RPC 生效）。

Non-interactive commands:

非交互命令：

dtb-harness-patch --apply <group>       # apply one feature group only
dtb-harness-patch --unapply <group>     # restore one group from backup
dtb-harness-patch --unapply-all         # restore every group
dtb-harness-patch --status              # show per-group state (no changes)
dtb-harness-patch --yes                 # skip the confirmation prompt
dtb-harness-patch --allow-unverified    # skip the version check

Package	Purpose	Command
@dsh-toolbox/session-care	session-log health check & repair (offline) 会话日志健康检查与修复（离线）	dtb-session-care
@dsh-toolbox/harness-patch	session-area management patch — feature groups session-area + resilience, interactive TUI, unapply 会话区管理补丁：特性组 session-area + resilience，交互式界面，可撤销	dtb-harness-patch
@dsh-toolbox/core	shared internals for both — no need to install directly 两个组件的共享底层，无需直接安装	—

Clone the repo only for development / contributing — daily use goes through npm.

克隆仓库仅供开发与贡献；日常使用请走 npm 安装。

git clone https://github.com/wxy/dsh-toolbox.git
cd dsh-toolbox
make install        # links the commands into ~/.dsh/tools/bin

• Incident postmortem & repair playbook

  事故复盘与修复手册

Released under the MIT License.

本项目以 MIT 许可证发布。

• npm — @dsh-toolbox/session-care · @dsh-toolbox/harness-patch · @dsh-toolbox/core

  npm 上的三个软件包

• GitHub — wxy/dsh-toolbox

  GitHub 仓库

• DeepSeek Harness — deepseek-ai/dsh

  被修补的 DeepSeek Harness 本体