Skip to content

[#3110] 工作区、团队权限与群内多 Agent 实跑 #3117

Closed

Description

@Birfy

范围

在管理 server 实现工作区/团队、角色、邀请与数据隔离(这是 Teamily Team plan 的开源等价核心,不复制计费包装),并让群内多个 Agent 在容器中真正跑完一轮协作。

任务

  • 调研创建团队向导第 2/3 步,以及「切换工作区」在本账户未见入口的条件
  • 管理面:工作区、Owner/Admin/成员、邀请、转化或导入当前数据
  • 实例/容器与工作区的绑定(粒度仍是待设计:本包不得把「每工作区一容器」写成用户已定,可在假设下实现并标明)
  • 群成员、可见性、Agent 参与;容器内回合编排与过程反馈
  • 群管理对等能力(公告、主动性、循环等先调研实体 UI;开源侧用权限与策略,不复制付费模式商标)
  • 智能体工作区(概览/渠道/站点/邮件/作品/API):Teamily 为灰度、本账户未见入口,先调研再实现

依赖

依赖管理面控制平面。多 Agent 实跑依赖 Agent 容器内运行。渠道/作品/API 工作台与后续包打通。

验收


父 issue:#3110
产品定位:开源版 Teamily,完整功能对等;品牌保持 FlyBot。阶段性 PR 可合并,但不得关闭 #3110。
安全边界:不依赖 Teamily 私有服务;不复制专有代码/商标/资产;密钥与会话令牌不得写入仓库或日志;多用户/多工作区必须权限隔离;不绕过平台防火墙或把实例端口暴露到公网。
仓库:优先在 ThinkFlowLab/FlyBot 扩展(可跨 bot-social 改动时在本 issue 说明并另提 Birfy/bot-social 的关联 PR)。不另建仓库,不使用 Cloud Coding Sessions。

Activity

  1. Birfy commented on Nov 16, 2026

    @Birfy
    CollaboratorAuthor

    查重(读取时间 2026-11-16T08:09:16Z,全仓 75 张开放 issue 对照标题与正文,含本批 11 张互比):

    标签:area:automation + area:security + enhancement。理由:area:automation(工作区/团队模型、群内多 Agent 回合编排与过程反馈)+ area:security(角色权限与数据隔离)。

    边界:本包管工作区、团队、角色、邀请与数据隔离,以及群内多 Agent 实跑;席位配额计量归 #3123,跨实例授权链归 #3115,容器粒度仍是待设计项、本包不写成用户已定。

    本轮只加 area 与 enhancement,未打 agent-ready、hold、risk:T*:开工顺序由 owner 定,风险等级由 controller 按 diff 算。

    Written-by: Triage

  2. added
    needs-humanThe agent loop stopped; a person must decide (reason in the last comment)
    on Nov 16, 2026
  3. Birfy commented on Nov 16, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Triage

    状态判定:needs-human(本批 #3113–#3123 的开工顺序等 owner 定,本单不进 agent-ready)。判据是 AGENTS.md 第 138–146 行的第 2、3 条;第 1 条已由 #3110 的服务端架构结论覆盖。

    缺什么:正文只到功能/页面级范围,还没有「要改哪些文件 + 一条可执行验收命令」的切片粒度;这 11 包的启动顺序与第一刀也还没定。
    谁能给:owner(#3110 的排期人)—— 定顺序、把第一刀切成文件级范围加验收命令;定下后把该切片写成独立小单即可转 agent-ready。

    相邻边界:与 #149/#427/#51 分界:那三张是 Bot 团队自身的任务层与跨 owner 授权,本包是产品侧的工作区/团队模型;跨实例授权链归 #3115,用量配额与席位计量归 #3123。

    查重与标签结论见上一条评论(2026-11-16T08:09Z,Triage 署名):全仓 75 张开放 issue 无整单重复。本评论只补状态依据,状态标签只加了 needs-human,未碰 agent-ready、hold、risk:T*。

  4. Birfy commented on Nov 20, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Chief · 2026-11-20T01:30Z

    Chief 决定:这是 #3114 收口后 #3110 的下一包(顺序 #3117 → #3123 → #3121 → #3119 → #3122 → #3118)。本轮先派规格(taskId spec3117):先出第一刀的可复制验收与文件:行,再转 agent-ready。规格落地前保持 needs-human,不要当新活接。

  5. Birfy commented on Nov 20, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: issue-spec workflow

    开工规格

    #3117 第一刀切片规格

    • issue:[#3110] 工作区、团队权限与群内多 Agent 实跑 #3117([整体:将 FlyBot + Bot Social 对标 Teamily 的功能与体验 #3110] 工作区、团队权限与群内多 Agent 实跑),父 整体:将 FlyBot + Bot Social 对标 Teamily 的功能与体验 #3110 不关闭
    • 读盘:2026-11-20T02:00Z(复核),仓库 ThinkFlowLab/FlyBot,main = 83b1556052ed5a1cc2c8e3f7c0826144a16324ba(/branches/main 现取,复核时未推进)。派活消息里的 683125c 已旧:/compare/683125c...main = ahead 1、16 个文件,全是 core/client.js、core/src/client/i18n.js、patches/ds-bot/** 与 i18n 测试,plane/ 与 docs/subsystems/ 一个字没动——本规格的事实与基线在新 tip 上仍成立。
    • 档位:T2。逐文件 diff -u 实测 234 行 / 7 文件(+228/−6);把同一组 hunk 交给仓库自带 .github/scripts/risk-gate.mjs 的 createGate().judge(),返回 risk-tier: T2、why: [](无 T3 命中)。
    • 红先:今天 5 例全红(tests 25 / pass 20 / fail 5)→ 实现后 25 / 25 / 0 / 0 skipped。

    目标(一句话)

    给管理面骨架 plane/ 加上「工作区成员与 owner / admin / member 三角色」:workspace.members 数据模型 + GET / POST 两条 /api/workspaces/:id/members 路由(读成员表、加成员),加成员时按 actor 的角色解析同名工作区;5 个红先测试钉住「成员权限与数据隔离」。本刀不碰 core/、不加改角色接口、不碰任何在飞的 UI 文件。

    现状(动手前必须知道的事实,全部按本机 main 读出来的)

    1. 仓库里没有 admin server / 多租户管理面,只有 plane/ 这个骨架。 顶层目录里没有 server/(ls server → 不存在);grep -rn "workspace" --include=*.js core/src core/index.js 共 89 处,逐条抽样全是 DSH 的文件夹工作区(ctx.workspaceRegistry、state.workspaceId、workspace-write、侧栏 sidebar.workspaces),没有一处是租户/团队对象。所以第一刀只能是「管理面数据模型 + 单机隔离实现」,不能假装有 admin server。
    2. plane/ 是 [#3110] 管理面控制平面与 FlyBot 容器生命周期最小闭环 #3113 的第一刀(docs/subsystems/plane.md:9-17):accounts / workspaces / instances 三个集合;workspace 记录只有 {id, ownerId, createdAt}(plane/src/store.mjs:33、:96-112)——仓库里没有成员表、没有角色、没有邀请、没有工作区名字。
    3. plane 的 HTTP 只有实例路由:POST/GET /api/instances(plane/src/server.mjs:36-53)、GET /api/instances/:id、POST /api/instances/:id/{start,stop}(:57-73);实例授权是一条 instance.ownerId === account.id(:63)。没有 /api/workspaces 路由。
    4. core 侧身份/权限原语很足,但没有一个是「工作区」:成员会话与邀请在 core/src/host/member-auth.js(只存 sha256);有会话后按 owner 收窄的入口是 core/src/host/authz.js:99-102 的 botOwnedBy(actor.memberId === bot.ownerId),共享资源名单在 :26-39,>1 成员 的整块 block 判定在 :256;房内角色 admin|member 在 core/src/host/room-membership.js:9;per-Bot grants 在 state.grants[botId](core/src/host/reach.js:16)。这些是「人 ↔ Bot / 房间」的权限,不是团队级工作区角色。
    5. 仓库里没有「团队级 Owner/Admin/member」这个对象。 team 契约写得很清楚:多人类 / 团队模式未开,且没有任何 flag / config / env 能开(docs/subsystems/team.md:11、:218-220)。
    6. state.workspaceId 不是租户,是 DSH 的文件夹工作区(core/src/host/roster.js:19-25)。把 core 的 workspace 当工作区模型会走错路。
    7. 群内多 Agent 跑一轮的编排已经存在:core/src/host/groups.js:676 runRound(槽位、@ 调用、PASS、兜底、过程上报),测试在 core/test/rounds.test.js、core/test/group-work.test.js、core/test/room-collaboration.test.js。缺的不是编排,是管理面这一侧的成员/角色来源与真跑验收——这也是把第一刀放在管理面的理由。
    8. 基线实测:main 上 cd plane && TZ=UTC node --test "test/*.test.js" → 20 tests / 20 pass / 0 fail。plane/package.json 的 test 脚本与 CI 的 Plane tests 一致(.github/actions/flybot-tests/action.yml:91,working-directory: plane、npm test),docs/testing-layers.json:85-93 有 plane 条目。
    9. 档位口径:plane/** 不在任何 tier 名单里,走 risk-rules.json:42 的 unknownPathTier = T2;T2 上限 250 行 / 12 文件(同文件 :44),risk-gate.mjs:90 只在 lines > lim.lines 时升 T3。

    第一刀(选定)

    工作区成员 + 三角色 + 读/加成员的 REST 路由,共 7 个文件、234 行:

    • workspace.members = [{ accountId, role: 'owner'|'admin'|'member', addedAt }];创建者自动成为唯一 owner;老 plane.json 读时补全。
    • GET /api/workspaces/:id/members:成员可读自己的成员表;非成员 403。
    • POST /api/workspaces/:id/members:owner / admin 可加人;重复成员 409、未知角色 400、未知账户 404。
    • 同名 id 按 actor 解析:workspace id 是 owner 作用域的(两个 owner 可各有一个 ws-1,store.mjs:105-112),路由不能只按 id 取 —— 必须在同 id 的候选里选「actor 有相应角色」的那一个。这是本刀要修掉的隔离洞,不是假设。
    • 不做 PATCH 改角色:withRole + last_owner 不变量 + 角色变更路由约 40 行、2 个用例,放到下一刀;本刀先让「成员 + 隔离」有红先证据,并留出体量余量。

    为什么是这个切法(否掉的四条)

    隔离修法(这一刀的核心,不是风险脚注)

    审规格在原型上复现了跨租户读:store.mjs 的 id 是 owner-scoped(:105-106 注释、:106-112 按 (id, ownerId) 查),insertInstance 的唯一性也是 owner+workspace+name(:122-134);但原型的成员路由只按 id 取第一个 workspace。于是:

    • acct-a 建 ws-1,acct-b 也建同名 ws-1;
    • acct-b GET /api/workspaces/ws-1/members → 403(连自己的工作区都读不到);
    • acct-a 的成员 acct-c 同一路径 → 200,并拿到 acct-a 的成员表。

    修法:store.workspacesWithId(id) 返回全部候选;index.js 的 workspaceFor(workspaceId, actorId, allowed) 用角色谓词选:读用 canRead,加人用 canAddMembers;没有候选 → workspace_not_found 404,有候选但 actor 都不匹配 → forbidden 403。不使用「同名 id 直接 409 拒绝」:plane/test/create.test.js:43-52 已经钉住「两个 owner 可各自用同一个 workspace 名」,拒绝对会打红既有测试。

    残留限制(必须写进文档,下一刀根治):若同一个账户被邀请进两个 owner 各自的同名 ws-1,GET 只能按存储顺序取第一个 —— URL 里的裸 id 不足以区分。下一刀把 workspace 换成不透明主键(或 ownerId + id 复合键)时一并解决。本刀的红先不覆盖这个极端情况。

    改动范围(逐文件 +N/−M,本机对 main 实测)

    文件 预估
    plane/src/workspace-roles.mjs(新增:ROLES、memberOf/roleOf/canRead/canAddMembers、seedMembers、withMember) +39 / −0
    plane/src/store.mjs(读时补 members、ensureWorkspace 播种 owner、workspacesWithId、updateWorkspaceMembers) +15 / −1
    plane/index.js(workspaceFor + listWorkspaceMembers / addWorkspaceMember + 错误类型导出) +24 / −1
    plane/src/server.mjs(GET/POST /api/workspaces/:id/members + 错误码→HTTP) +39 / −1
    plane/test/workspace-members.test.js(新增 5 例) +95 / −0
    docs/subsystems/plane.md(成员/路由/同名 id 的不变量、25 cases) +9 / −1
    plane/README.md(本刀做了什么、25 cases) +7 / −2

    合计 +228 / −6 = 234 行 / 7 文件(gate 的 judge() 返回 risk-tier: T2)。文档合计 19 行。不动:core/**(一行都不动)、plane/package.json(**/package.json 是 T3)、.github/**、compose.yaml、Dockerfile。

    红先(三数)

    先只加测试文件、不写实现:

    cd plane && TZ=UTC node --test test/workspace-members.test.js   # tests 5 / pass 0 / fail 5
    cd plane && TZ=UTC node --test "test/*.test.js"                  # tests 25 / pass 20 / fail 5

    实现后:tests 25 / pass 25 / fail 0 / skipped 0(本机已用原型验证:5/0/5 → 25/20/5 → 25/25/0)。

    验收(每条都可复制、可单独判定)

    • A1 基线不变:在 PR 的 base(最新 main,开 PR 时可能是新 tip)上 cd plane && TZ=UTC node --test "test/*.test.js" → # pass 20、# fail 0。开 PR 时基于最新 main rebase,A1 在新 tip 上重跑 20/20/0;本规格读盘时 main = 83b1556。

    • A2 红先:只加 plane/test/workspace-members.test.js 时,cd plane && TZ=UTC node --test test/workspace-members.test.js → # tests 5 # pass 0 # fail 5;全量 → # tests 25 # pass 20 # fail 5。

    • A3 绿:实现落地后 cd plane && TZ=UTC node --test "test/*.test.js" → # tests 25 # pass 25 # fail 0 # skipped 0。

    • A4 仓库入口:repo 根 TZ=UTC npm --prefix plane test 通过(与 CI 的 Plane tests 同一条命令,.github/actions/flybot-tests/action.yml:91、docs/testing-layers.json:85-93)。

    • A5 档位/体量:git add -N plane/test/workspace-members.test.js plane/src/workspace-roles.mjs && git diff --numstat main | awk '{a+=$1+$2} END {print a}' ≤ 250 且 git diff --numstat main | wc -l ≤ 12;PR 上 risk-tier.yml 的 job summary 报 risk-tier: T2。本刀实测 234 行 / 7 文件,余量 16 行;文档 +16/−3 = 19 行。实现时再加约 16 行(例如 1 个用例)就顶到 250,再多即按 size 规则升 T3(risk-gate.mjs:90),不要为了留 T2 砍测试。

    • A6 只动 plane 与它的文档:git diff --name-only main 的每一行都匹配 ^plane/ 或等于 docs/subsystems/plane.md(core/ 一行都没有)。

    • A7 隔离断言(同名 id 跨租户):测试 two owners with the same workspace id never read or write each others members (#3117) 必须同时成立:owner A 的 GET 只看到 [A owner, C member];owner B 的 GET 只看到 [B owner](不是 A 的表,也不是 403);C(A 的成员)只看到 A 的表;非成员 D 得 403 forbidden;B 给 D 的 POST 落在 B 自己的 ws-1,A 的表仍是 [A, C]。

    • A8 文档同步(固定字符串,不绑措辞猜测):

      grep -Fq 'workspace.members' docs/subsystems/plane.md
      grep -Fq 'owner / admin / member' docs/subsystems/plane.md
      grep -Fq 'workspaces/:id/members' docs/subsystems/plane.md
      grep -Fq 'workspaces/:id/members' plane/README.md
      grep -Fq '(25 cases)' docs/subsystems/plane.md

      规格要求加进 docs/subsystems/plane.md 的不变量原句(去掉行首缩进后可直接照抄):

      - `workspace.members` is the only source of membership: `owner / admin / member`, and the
        creating account becomes the only `owner`. An older `plane.json` is read with its owner
        seeded as the only member, never rejected.
      - `GET` / `POST /api/workspaces/:id/members` verify the token, then pick the workspace by the
        caller's role: two owners' same-named `ws-1` never mix. Non-member `403`, unknown id `404`,
        duplicate member `409`, unknown role `400`.
      

    测试映射(验收 → 具体用例名)

    验收 用例(plane/test/workspace-members.test.js)
    A2/A3 a workspace member list has its creator as the only owner (#3117)(建实例即建 workspace,唯一成员是 owner,addedAt=createdAt)
    A2/A3/A7 two owners with the same workspace id never read or write each others members (#3117)(A/B 各有 ws-1;A 加 C;A、B、C 各读自己的表;D 403;B 加 D 不污染 A)
    A3 an owner adds a member, who can then read the list (#3117)(owner POST → 201,{member};被加的人 GET → 200,顺序 [owner, member])
    A3 an admin may add a member; a plain member may not (#3117)(owner 把 B 加成 admin;B 加 C → 201;C 再加 D → 403)
    A3 a plane.json from before members loads with its owner as the only member (#3117)(老文件只带 {id, ownerId, createdAt},读出来 members=[owner],addedAt=createdAt)

    分步(≤6)

    1. 只加 plane/test/workspace-members.test.js 的 5 个用例(不写实现),跑 A2 取红:5/0/5、全量 25/20/5。
    2. 新增 plane/src/workspace-roles.mjs:ROLES、memberOf / roleOf / canRead / canAddMembers、seedMembers(老 workspace 补 owner)、withMember(重复成员、未知角色 → 类型化 WorkspaceRoleError)。不写 withRole / canChangeRoles / last_owner。
    3. store.mjs:#read() 给每个 workspace 补 members;ensureWorkspace 播种 owner;新增 workspacesWithId(id) 与 updateWorkspaceMembers(workspace, members)。
    4. index.js:workspaceFor(workspaceId, actorId, allowed) 按角色选候选;listWorkspaceMembers / addWorkspaceMember,actor 永远取自已验签账户(body 里的 actorId 一律不认),导出 WorkspaceRoleError。
    5. server.mjs:两条 /api/workspaces/:id/members 路由 + 错误码→HTTP(forbidden 403、workspace_not_found / account_not_found 404、member_exists 409、invalid_role 400、其它方法 405)。
    6. 补两份文档(含同名 id 解析与残留限制),跑 A3 / A4 / A5 / A6 / A7 / A8,开 PR(Part of #3110、Refs #3117,不关闭 整体:将 FlyBot + Bot Social 对标 Teamily 的功能与体验 #3110),不碰 core/。

    风险

    • 迁移:老 plane.json 的 workspace 没有 members,必须读时补全(seedMembers),不能 reject——直接拒绝会打死已经跑起来的 plane 部署。第 5 例就是这条的红先。
    • 同名 id 的残留歧义:按 actor 角色解析后,跨 owner 读/写已隔离并有用例;但「同一账户被两个 owner 的同名 ws-1 都邀请」时,裸 id 只能按存储顺序取第一个。文档必须写清,根治是下一刀的 workspace 主键作用域化。
    • 角色暂不驱动实例授权:实例路由仍是 ownerId === account.id(server.mjs:63),本刀 admin 的权力只在成员管理(加成员)上。文档必须写清,避免「界面显示 admin、实际什么都管不了」的假入口印象。
    • 体量留 16 行:234/250 行、7/12 文件、文档 +16/−3 = 19 行。再加约 16 行(例如 1 个用例)就顶到 250,再多即按 size 规则升 T3(T3 同样要 tip 上 PASS + CI 绿——不要为了留 T2 砍测试)。
    • 别写 displayName / display name:risk-rules.json 的 diffPatternsNotInTests 命中即 T3;字段叫 accountId / name。
    • 边界自律:#3117 还要「创建工作区 / 切换 / 改角色」,别在本 PR 里顺手加(顶出 T2,还挡住邀请那一刀的 rebase)。

    不做的事(本刀明确不碰)

    与在飞刀的冲突面

    留给后续刀的部分

    1. 改角色(PATCH /api/workspaces/:id/members/:accountId)+ last_owner 不变量。
    2. 邀请(hash-only token、一次性、TTL、撤销)+ 成员自服务加入。
    3. 工作区创建 / 改名 / 列出 / 切换,以及「转化或导入当前数据」;workspace 主键作用域化(根治同名 id 的残留歧义)。
    4. 实例路由角色化(owner/admin 可创建与启停,member 只读)。
    5. 删除成员与「还有实例时不能删」。
    6. 把 plane 的成员接到 core 的 member-auth(管理面账号 ↔ 容器内成员会话),再谈群内多 Agent 的跨 owner 实跑。

    first_slice

    工作区成员与三角色(owner / admin / member):workspace.members 数据模型 + 5 个红先测试 + GET/POST /api/workspaces/:id/members(读成员表、加成员),同名 id 按 actor 角色解析。T2,234 行 / 7 文件;纯 node、无 Docker、无端口、无 core/ 改动。


    Written-by: Triage · Part of #3110

    first_slice: 工作区成员与三角色(owner / admin / member):workspace.members 数据模型 + 5 个红先测试 + GET/POST /api/workspaces/:id/members(读成员表、加成员),同名 id 按 actor 角色解析;T2、234 行 / 7 文件、纯 node、无 Docker、无 core/ 改动。

  6. added
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    and removed
    needs-humanThe agent loop stopped; a person must decide (reason in the last comment)
    on Nov 20, 2026
  7. Birfy commented on Nov 20, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Dev

    #3117 第一刀已实现,按规格评论 7027620183 落地。

    • 分支:dev/3117-plane-workspace-members;PR plane: workspace members with the owner / admin / member roles #3242(https://github.com/ThinkFlowLab/FlyBot/pull/3242),tip d0e09cdf543c9c5f8790edd95077374186686f60
    • 红先(只加测试、实现回退):plane/test/workspace-members.test.js → tests 5 / pass 0 / fail 5;全量 → tests 25 / pass 20 / fail 5 / 0 skipped
    • 绿(tip):单文件 → 5 / 5 / 0;全量 → 25 / 25 / 0 / 0 skipped;npm --prefix plane test → 25 / 25 / 0 / 0 skipped
    • 档位:createGate().judge() 实测 T2,244 行 / 7 文件 / generated 0(T2 上限 250 行 / 12 文件)
    • 改动:plane/src/workspace-roles.mjs(新增)、plane/src/store.mjs、plane/index.js、plane/src/server.mjs、plane/test/workspace-members.test.js(新增 5 例)、docs/subsystems/plane.md、plane/README.md;core/ 一行没动
    • 未做(留给下一刀):PATCH 改角色 + last_owner、邀请 token、实例路由角色化、workspace 主键作用域化
  8. self-assigned this
    on Nov 20, 2026
  9. removed
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    on Nov 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:automationScheduled tasks and automationarea:securityAuth, grants, approvals, secretsenhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions