🌳 dsh-agent-tree · 代理代际树

DeepSeek Harness 的代理代际树面板：把「Lead → 成员 → 孙代理」的多层代理关系画成一棵实时树，配上团队焦点、真状态点和模型路由中心。

Agent lineage tree panel for DeepSeek Harness: visualize your Lead → member → grandchild agent tree in real time, with team focus, live status dots and a model-routing center.

✨ 功能

• 血缘树：按会话快照的 parentSessionId 建树，一眼看清谁派生了谁（层级无上限：成员、孙代理、重孙代理…）
• 两种视图：宽容器（中心面板 ≥760px）渲染横向组织树（卡片 + 连接线）；窄容器（右栏页签）自动切缩进列表；拖动分栏实时切换
• 真状态点：host 半订阅 agent/created / agent/status 宿主事件 + agents 即时活性，🔵活跃 🟢已结束 🟡待命 ⚪沉睡 🔴失败（事件缺失时自动降级为活跃时间推断）
• 团队焦点：多团队并行时不迷路——默认锁定最新派出的团队，下拉一键切换；焦点视图可放大 1.5×
• 只看活跃：默认折叠 2 小时无活动的沉睡叶枝，一键展开全量
• 模型路由中心（可选增强）：
  • 孙代理默认模型热配置——写入 subagent-director 设置，立即生效（白名单开启时自动收敛到授权路由）
  • 孙代理节点挂实际运行路由标签（读 session request/header，官方通道）
• 团队覆盖层（可选增强）：AgentTeams 团队名册 + 任务计数 + 成员模型路由，点 💬 直达成员会话

📦 安装

插件市场

「插件 → 添加插件」搜索 dsh-agent-tree，或把本仓库地址粘进添加框。

npm

dsh plugin --profile <你的profile> add dsh-agent-tree

安装后重启一次 DSH，侧边栏出现「代际树」图标即成功。

环境要求

• DeepSeek Harness >= 0.2.1-rc.2（实测 0.2.1-rc.5 Desktop / Windows）
• 可选增强（不装也能用，面板自动降级）：
  • @nanmicoder/dsh-agent-teams → 团队覆盖层
  • dsh-plugin-subagent-director → 模型路由中心 + 孙代实际路由标签

🔧 想看到孙代理？两道闸要打开

孙代理（成员的子代理）默认被两道闸拦住，面板要显示它们需：

1. 宿主深度：插件 → 子智能体 → 限制，maxDepth ≥ 2（或 cordis.patch.yml 里 subagent.maxDepth: 2）
2. 团队成员派生权限：agent-teams 的 memberMaxDepth: 1（cordis.patch.yml 里 - id: agent-teams 条目）

🧭 数据源与原理

数据	来源	说明
血缘树	会话快照 parentSessionId（client 侧）	无需宿主事件，稳定低风险
团队/成员/路由	.agent-teams/*/team.json（host 半读取）	成员 id 即会话 id，可直接跳转
真状态	agent/created + agent/status 事件 + agents 即时活性（host 半订阅）	事件仅本进程内，重启后旧会话自动降级为时间推断
孙代实际路由	subagent-director 桥接 subagentModel（session request/header）	官方可观测性同源
模型目录	宿主模型目录（三级回退读取）	与任务看板同款

已知边界：模型路由中心的写入依赖 subagent-director 桥接（headless 或未装时该区块显示降级提示，其余功能不受影响）。

🩺 故障排除

• 启动失败弹窗：只点「Exit」（不要点 Disable third-party plugins！），把 %APPDATA%\@deepseek-ai\dsh-desktop\logs\crash-*.log 提交 issue
• 面板空白 / 没有图标：改过 client.js 后需重启一次；确认 bundles 里有 agent-tree
• 团队覆盖层提示 cwd 缺失：当前根会话的快照无工作区字段，血缘树不受影响

📄 License

MIT