dsh-teams-x

dsh-teams-x

TeamsX for DeepSeek Harness — turn one session into a coordinated multi-agent team: a captain spawns durable member subagents, breaks a goal into a dependency-aware task DAG, and coordinates through direct mailbox messages, with a live all-SVG activity panel.

本插件原生面向 DeepSeek Harness 0.2.0-rc.1（peerDependencies 已声明 >=0.2.0-rc.1），宿主 API 漂移点全部收敛在 src/compat.ts 能力探测层——宿主升级时通常只需改这一个文件。工具命名空间为 teamsx_*、状态目录为 .teams-x，与宿主内其他团队模式互不干扰。

安装

方式 A：仓库 tgz 一条命令（推荐，最快）

仓库根目录自带与源码同步构建的 dsh-teams-x-<version>.tgz（零运行时依赖，宿主包全部走 peerDependencies）：

dsh plugin --profile web add <仓库路径>/dsh-teams-x-<version>.tgz

装完 重启宿主（dsh plugin add 不会热加载新 bundle），然后按下文「安装验证」确认。

方式 B：npm

npm i dsh-teams-x && dsh plugin --profile web add <node_modules 路径>/dsh-teams-x

方式 C：从源码构建

前置要求：Node ≥ 24、pnpm ≥ 12，且同一台机器上有一份 deepseek-harness 源码 checkout（构建期 link: 依赖直连它，运行期不需要）。

# 1) 布局二选一：
#    嵌套式：把本仓库 clone 到 <任意目录>/dsh-teams-x，再在其中放 harness：
git clone https://github.com/Mlte0907/dsh-teams-x.git && cd dsh-teams-x
ln -s <harness-checkout 绝对路径> deepseek-harness   # 兄弟目录时用内嵌 symlink 对齐 link:./deepseek-harness

# 2) 安装 + 类型检查 + 构建
pnpm install
pnpm typecheck
pnpm build          # 产物在 lib/

# 3) 安装进 profile（用仓库目录或 pnpm pack 产物均可）
dsh plugin --profile web add "$(pwd)"

常见报错：typecheck 报 Cannot find module '@deepseek-ai/dsh-client-ui-sidebar-right'——它是 peerDependency，宿主侧由 profiles 级 node_modules 供给。临时把它链入本仓库 node_modules/@deepseek-ai/ 即可（指到 <harness 机器> ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-sidebar-right）。

安装验证（三步）

1. 重启宿主后查日志，确认 loader 成功应用本插件、无 failed to apply loader entry teams-x：

   journalctl -u dsh-web --since '5 minutes ago' | grep -iE 'teams-x|failed'
   

2. 打开 Web UI，右栏应出现 TeamsX v<版本> tab（全 SVG 渲染）；本会话一组建团队，右栏会自动弹到这个 tab——刻意的：它抢在 dsh-better-sidebar 的「任务管理」页之前把栏占住。

3. 新会话中让 agent 调 teamsx_create 建一个测试团队（如 {"name":"smoke-test","members":[{"name":"a1"}]}），确认工具返回团队快照。

pnpm build 后重启宿主即可生效（profile 为 patchReload: live）。真实实例验证（工具注册、成员生成、调度、面板轮询）由使用者执行。

v0.2.1 变更

• 兼容 DeepSeek Harness 0.1.5-rc.2：宿主移除了插件侧 ctx.subagents.registerContinuableSetup 钩子，成员模型选择桥改为监听 agent/session-start 事件（fresh startup 与冷恢复 resume 双路径），修复 failed to apply loader entry teams-x 启动崩溃。

v0.2 新特性

特性	说明
团队模板（profiles）	配置 profiles 后在 teamsx_create 描述里写 profile=模板名，按预定义成员 + 种子任务 DAG 一键建队
Web 计划编辑器	staged 计划面板内直接改：成员行（角色/模型）与任务行（主题/指派/依赖）行内编辑，一次批量原子保存；未知操作白名单拦截
自动修复循环	review/requirements 任务 failed + needs_revision + findings 时自动派生 repair 任务（round 上限默认 3，autoDerive 可关）
会话内团队卡片	teamsx/* 事件折叠为消息流内卡片：成员状态可点开 transcript、任务摘要实时更新——零宿主改动，宿主缺能力自动降级
/teamsx 命令	输入框斜杠命令一键呼出团队面板

全套由功能套件守护：173 用例（pnpm verify 内含 scripts/full-functional-test.mjs）。

工具集（13 个 teamsx_* 工具）

工具	说明
teamsx_create	创建团队；approval="required" 走两阶段 staged 计划流
teamsx_add_member / teamsx_remove_member	成员增删；staged 时仅登记计划行
teamsx_edit_plan / teamsx_approve	原子批量修订 staged 计划 / 显式批准运行
teamsx_create_task	创建任务（DAG 依赖 + 质量门契约）
teamsx_claim_task / teamsx_update_task	认领（attempt_id 能力）与状态推进
teamsx_reassign_task	原子重派/重试/队长接管（旧 attempt 先失效再中断）
teamsx_send_message / teamsx_status	持久信箱消息 / 团队快照轮询
teamsx_resume / teamsx_delete	恢复停止的团队 / 归档并退出

工程亮点

稳定性修复

• 写入范围重叠检查死代码、withTeamLock Promise 链泄漏、依赖输出截断方向、分派前 halted 复查、persona 用户数据围栏（<<< >>>）、退役成员守卫正确恢复。

性能优化

• captain→team 反向索引（index.json）：查找 O(n) 目录扫描 → O(1)；索引缺失/损坏自动全扫重建（自愈）。
• kickMember 分派单次读取模式；调度器预构建 byId Map（O(T²)→O(T)）；依赖输出 O(D) 累计截断；快照邮箱并行读取；退役集合缓存。

架构

• 全 SVG 图标体系：src/client/icon-data.ts 单一数据源 → 内联 React 组件（currentColor 主题化 + 动作态 CSS 动画）与 assets/icons/*.svg 独立资产双形态，零 PNG。
• 质量门（v0.1）：requirements/implementation/verification/review/repair/integration 契约校验、完成规则（verdict=pass 才可完成、verify 失败必须 fail、inScope 路径审计、默认排除密钥文件）。

版本策略

dsh-compat-shim 让旧插件跑在新宿主上；src/compat.ts 是同一哲学的反向面——让本插件跨宿主版本运行：能力探测优先于版本判断（sendMessage vs followup、ownEvents() vs events.slice、可选 drainContinuableChildren、web/workspace 服务 key 别名）。已验证的宿主漂移点及对应分支全部集中在 compat.ts。

Roadmap

• v0.2：Web 计划编辑器（StagingPlanEditor 对应面）、profiles 团队模板、自动修复/复审循环、会话内团队卡片与成员会话跳转。