Repository navigation
Open
Labels
area:automationScheduled tasks and automationScheduled tasks and automationarea:securityAuth, grants, approvals, secretsAuth, grants, approvals, secretsenhancementNew feature or requestNew feature or requestneeds-humanThe agent loop stopped; a person must decide (reason in the last comment)The agent loop stopped; a person must decide (reason in the last comment)
Description
背景与设计(本包是后续所有服务端工作的基础)
父 issue #3110 已确定服务端架构:开源、可自托管的 管理 server + FlyBot 容器。管理 server 负责账号、认证、工作区、权限,以及容器生命周期;FlyBot 容器承载 Agent 运行。本 issue 把该设计写成可实施的最小闭环,并完成第一刀实现。
现状(仓库已有,不是空想)
- FlyBot 今天是「一人一个实例」的可自托管运行时(见
compose.yaml对 Deployment step 1: official image and one isolated instance per person #352 的说明,docs/docker.md):现有镜像跑dsh web+ FlyBot core 与插件;数据在实例卷/data(DSH home、workspace、凭证);Web 默认绑在宿主机回环;实例之间只通过自托管 Bot Social 往来,Bot Social 不在 FlyBot 镜像内。 - 现有 Docker Compose 是一种已存在的自托管路径(且文档写明 Linux
network_mode: host、Desktop 不路由 host 网络等限制),不是用户指定的唯一编排方案,也不能写死为唯一实现。 - Bot Social 已是独立的开源自托管社交服务(账号/home、邀请、grant、审批、面对面房间、REST + MCP、SQLite 或 Docker)。FlyBot
plugins/social作为其客户端:onboard、成员、分享、出站审批。 - 不能把「一个现有 FlyBot 进程 + 一个现有 Bot Social 进程」互不相通地拼在一起,就声称管理面 + 容器架构已经完成;也不能把 Agent 运行塞进管理 server。
目标边界
- 管理 server(管理面,不强制单进程): 账号与会话、工作区记录、角色权限、FlyBot 运行实例的创建/启动/停止/升级/回收、实例状态与日志查询、管理面与实例之间的鉴权。第一刀不必一次做完 Teamily 全部工作区产品面。
- FlyBot 容器/运行实例: 继续承载 Agent、会话、记忆、调度等现有运行时。管理面编排它,不在管理进程里直接跑 Agent。
- Bot Social: 仍负责跨实例的社交图、grant 与审批投递;第一刀先让管理面能够为实例配置并连接到自托管 Bot Social,后续协作包再做更紧的身份对齐。不得绕过它另写一套互不相通的分享协议。
待验证假设(不是用户已定要求)
- 容器粒度(每用户 / 每工作区 / 每 Agent)用户尚未指定。第一刀可先用「每个 owner(或每个工作区)一个 FlyBot 运行实例」作为可替换的工作默认,因为这接近现有「一人一个实例」;必须在代码与文档里标明可调整,不得写成用户决定。
- 运行载体:允许把现有 Dockerfile / compose 作为第一条自托管路径来验证生命周期,但生命周期接口必须抽象,不能把 Docker 或某一云厂商写成唯一选择。
- 对外 API 入口与路由策略待设计:第一刀允许用户仍按实例地址打开 FlyBot UI,同时另有管理面 API/UI 做控制;不预设必须单一公网入口。
- 管理面存储选型、数据库未指定:可在本仓库内用最小持久化先记下账号/工作区/实例元数据,并预留迁移;不得擅自绑定某一云数据库。
调用链(第一刀)
- 操作者认证到管理面。
- 管理面创建实例记录,并启动一个 FlyBot 运行实例(使用抽象的生命周期后端)。
- 管理面与实例建立内部鉴权(实例只接受来自管理面的控制调用;用户令牌与管理面凭证分离)。
- 管理面可查询状态/日志,可停止、再启动;升级/回收与备份路径要有接口和测试,即使第一刀实现是最小的。
- 实例内 Agent 照常运行;社交流量仍经配置好的 Bot Social,而不是管理面伪造消息。
范围
- 在 ThinkFlowLab/FlyBot 仓库内落地管理面最小控制平面(新模块/目录,不另建仓库)
- 实例生命周期:创建、启动、停止、升级、回收
- 管理面 ↔ 实例的协议与鉴权
- 状态与日志查询
- 隔离与持久化方案的第一刀(实例数据仍在实例卷;管理面元数据单独持久化;落点与粒度在文档标明假设)
- 备份/恢复、数据迁移、异常恢复与版本兼容的接口或明确最小实现 + 后续缺口
- 部署说明(自托管;写清现有 compose 只是路径之一)
- 自动化测试;不依赖 Teamily 云即可本地/自托管跑通「创建实例 → 启动 → 查询状态 → 停止」
依赖
无阻塞依赖。不要等 #3112 合并再开始。后续 issue 依赖本包的管理面与生命周期接口。
验收
- 管理面可以创建并启动至少一个 FlyBot 运行实例,查询健康/状态,停止后再启动。
- 未授权调用不能操作他人实例;控制凭证与用户登录令牌分离。
- 文档写清假设(粒度、编排后端)与不是用户已定的部分。
- 测试覆盖鉴权失败、重复创建、停止后的状态,以及至少一种自托管启动路径。
- 本包合入不能关闭 整体:将 FlyBot + Bot Social 对标 Teamily 的功能与体验 #3110。
非目标
一次性做完工作区产品 UI、对外 Agent API 网关、全渠道、完整备份产品化;这些在后续子 issue。
父 issue:#3110
产品定位:开源版 Teamily,完整功能对等;品牌保持 FlyBot。阶段性 PR 可合并,但不得关闭 #3110。
安全边界:不依赖 Teamily 私有服务;不复制专有代码/商标/资产;密钥与会话令牌不得写入仓库或日志;多用户/多工作区必须权限隔离;不绕过平台防火墙或把实例端口暴露到公网。
仓库:优先在 ThinkFlowLab/FlyBot 扩展(可跨 bot-social 改动时在本 issue 说明并另提 Birfy/bot-social 的关联 PR)。不另建仓库,不使用 Cloud Coding Sessions。
Metadata
Metadata
Assignees
Labels
area:automationScheduled tasks and automationScheduled tasks and automationarea:securityAuth, grants, approvals, secretsAuth, grants, approvals, secretsenhancementNew feature or requestNew feature or requestneeds-humanThe agent loop stopped; a person must decide (reason in the last comment)The agent loop stopped; a person must decide (reason in the last comment)
Activity
Birfy commentedon Nov 16, 2026
查重(读取时间 2026-11-16T08:09:16Z,全仓 75 张开放 issue 对照标题与正文,含本批 11 张互比):
.github/agent/rule data or the tier runner itself #3095/Close the two gaps in the user-visible changelog rule: shared copy files and a deleted fragment #3068/fix(i18n): the approval cards still draw four English controls (carries #3012) #3032 三张无开放 PR 的老单比对:policy-sign does not cover the rest of.github/agent/rule data or the tier runner itself #3095 是 policy-sign 对 .github/agent 规则数据的覆盖、Close the two gaps in the user-visible changelog rule: shared copy files and a deleted fragment #3068 是 changelog 规则缺口、fix(i18n): the approval cards still draw four English controls (carries #3012) #3032 是批准卡 i18n 缺陷,三者都在仓库门禁与文案层,与本包的产品面范围无重叠,不引用为重复。标签:
area:automation+area:security+enhancement。理由:area:automation(服务端控制平面/生命周期是自动化运行时的地基)+ area:security(管理面与实例之间鉴权、多用户隔离、控制凭证与登录令牌分离)。边界:管理面只做账号、工作区、权限、容器生命周期与鉴权接口,Agent 运行留在 FlyBot 容器;工作区产品面归 #3117,对外入口与路由归 #3121,本包只提供它们依赖的生命周期与鉴权接口。
本轮只加 area 与 enhancement,未打 agent-ready、hold、risk:T*:开工顺序由 owner 定,风险等级由 controller 按 diff 算。
Written-by: Triage
Birfy commentedon Nov 16, 2026
Written-by: Triage
状态判定:needs-human(本批 #3113–#3123 的开工顺序等 owner 定,本单不进 agent-ready)。判据是 AGENTS.md 第 138–146 行的第 2、3 条;第 1 条已由 #3110 的服务端架构结论覆盖。
缺什么:正文只到功能/页面级范围,还没有「要改哪些文件 + 一条可执行验收命令」的切片粒度;这 11 包的启动顺序与第一刀也还没定。
谁能给:owner(#3110 的排期人)—— 定顺序、把第一刀切成文件级范围加验收命令;定下后把该切片写成独立小单即可转 agent-ready。
相邻边界:与 #3115/#3116/#3117/#3121 是提供方与消费方关系:账号、角色权限、实例生命周期和鉴权接口由本包提供,产品面归它们;#3095/#3068/#3032 是仓库门禁与批准卡文案,与本包不相干,不作为重复。
查重与标签结论见上一条评论(2026-11-16T08:09Z,Triage 署名):全仓 75 张开放 issue 无整单重复。本评论只补状态依据,状态标签只加了 needs-human,未碰 agent-ready、hold、risk:T*。