🌳 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 团队名册 + 任务计数 + 成员模型路由，点 💬 直达成员会话
• 别名系统：团队成员与原生 subagent 节点都可 ✏ 行内改显示名（Enter 保存 / 留空恢复），独立别名层存储，绝不改团队真源
• 自动任务简介：AgentTeams 成员默认显示「名字 · 任务简介 🔄✓✗」（从任务板聚合）；原生 subagent 子/孙代理自动提取派发 prompt 原文作为简介（读会话日志，去身份句，带缓存限流）
• 批次分组与过滤：同一会话多轮派发按时间自动聚类成批次区块，纵向堆叠不再横向挤爆；下拉选单批只看该批的子代理+孙代理
• 三段式视图：视图（会话树/团队）→ 目标 → 批次，每框职责单一，互不干扰

📦 安装

插件市场

「插件 → 添加插件」搜索 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 条目）

🧭 数据源与原理

已知边界：模型路由中心的写入依赖 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