在 GitHub 上编辑 content/zh/architecture.md ↗

架构

FlyBot 是构建在 DeepSeek Harness(DSH)上的一组长期运行 Bot。发布物包括 ds-bot 插件(对上游打补丁)与桌面应用。

目录

路径 内容
ds-bot/ 原样固定的上游版本(Fei2411/DeepSeek-Bot),不要编辑
patches/ds-bot/ FlyBot 的有序补丁
core/ ds-bot/ + 补丁;发布物,所有测试在这里运行
plugins/social/ @flybot/social 社交插件
plugins/tree/ @flybot/tree 知识树插件
plugins/timeline/ @flybot/timeline 团队时间、沟通与利用率视图
plugins/workflow/ @flybot/workflow 群聊式任务分派与流程图
plugins/project/ @flybot/project Project 状态、看板、Chief、档案、指标与助手
app/ DSH + 插件的桌面应用

子系统

每个子系统在 docs/subsystems/ 下有独立页面,说明拥有的路径、不变量与测试:ds-bot-core、core-host、core-client、plugin-runtime、tree、timeline、workflow、social、install、team。多人类所有权是计划中、尚未发布;在 docs/subsystems/team.md 的授权门通过前,team 模式保持关闭。Issue #16 已解决:树中的 Bot 可以在自己下面创建子 Bot(Option B)。

执行模型

团队权限

当前树是单所有者:一个人拥有 Bot 及其数据。计划中的多人类契约——人类所有者 ↔ 指定 Chief ↔ 专家、按所有者管理、仅 Chief 跨所有者通信与审批权——已有文档,但尚未发布。不要把计划中的 team 模式当成可用能力。

集成

插件是 plugins/<name>/index.js,加上 plugins/README.md 中的 @flybot/<name> 声明与子系统文档条目。只使用文档化的 DSH API;不要打补丁或依赖 DSH 安装目录内的文件。DSH 缺少能力时停止并报告。

数据与信任

控制面保存名单、会话、记忆与设置。仓库工作发生在仓库自己的环境中,受 DSH 文件策略与审批策略约束。GitHub 与模型凭据留在控制面;Bot 获得的是工具,而不是原始密钥。