前言¶
DeepSeek Harness (DSH) 生态以插件化为核心，允许扩展各类工具。dsh-plugin-ide-hub 是一个工作流类插件，旨在解决多 IDE 环境下的管理痛点。当用户在 Claude Code、Codex、ZCode、Trae、Qoder、CatPaw 等多个编码 IDE 之间切换时，每个工具都会将会话、用量统计和规则文件独立存储在本地磁盘。本插件不调用厂商 API，而是直接读取这些磁盘上的本地状态，提供一个统一的入口来盘点、管理和导出这些信息。
核心功能¶
插件提供以下命令，覆盖从配置到使用的全流程：
-
/ide-hub
盘点已安装的适配器（共 8 个）与规则文件。它会检查每个工具的规则文件是否存在，并反馈安装状态。 -
/hub-init [目录]
生成规则本体与 8 个工具的指针。该命令会在指定目录下创建规则文件，并将指针写入各工具的项目规则文件中。写入遵循“不覆盖现有正文”的原则，仅在文件末尾追加带标记的指针段。 -
/hub-usage
统计各工具的用量。对于 ZCode，走本地 SQLite 库统计总量、轮数、缓存命中率等；对于 Claude 和 Codex，走转录统计。 -
/hub-sessions
列出最近会话并提供一键恢复命令。支持对 Claude Code、Codex、ZCode 和 DSH 本身的会话进行恢复操作。 -
/today
基于阻塞情况、预算和任务优先级对今日事项进行排序，辅助判断当前应该优先处理哪项工作。 -
/hub-migrate
制定配额迁移计划。根据配置的剩余配额和优先级，计算各工具的耗尽倒计时，并给出配额迁移建议。 -
/hub-export
将盘点结果与规则文件导出为 Obsidian 笔记，生成IDE-Hub/子树结构。
安装与启用¶
安装过程包含三个步骤：
- 安装插件包。
- 重启 dsh。
- 验证配置是否生效。
# 1. 安装插件
dsh plugin --profile web add github:121212165/dsh-plugin-ide-hub
# 2. 重启 dsh
# 3. 验证挂载
dsh --profile web --dump-config | grep dsh-plugin-ide-hub
安装完成后，插件会自动挂载。/hub-init 与 /today 等核心命令可直接使用。
典型用法¶
安装并重启 dsh 后，可通过以下命令进行操作：
# 查看适配器与规则文件盘点
/ide-hub
# 初始化或更新规则文件（指定项目目录）
/hub-init [项目目录]
# 查看今日优先级排序
/today
已知边界¶
由于插件仅读取磁盘文件，且不同厂商的实现差异，存在以下限制：
- Trae 会话不可见：Trae 的会话目前无法在
/hub-sessions中显示，仅能通过/ide-hub盘点出其已安装状态。 - Trae 聊天读取限制：v0.4 版本中，Trae 聊天读取功能未在运行中的 dsh 里进行 live mount 复验。
- 路径依赖：CatPaw、Qoder 等国产 IDE 的存储路径随版本变化，插件无法预知所有版本的具体路径，读不到时会在盘点中显示为“不在装”。
- 读写安全：插件仅往指定项目目录写入规则指针，不覆盖现有正文；卸载时仅删除自身添加的指针段，不会破坏原有文件。
生态链接¶
- GitHub 仓库：https://github.com/121212165/dsh-plugin-ide-hub
- 社区目录：https://www.skillhub.cn/plugins/121212165/dsh-plugin-ide-hub
