1Agents

项目介绍

1agents 是一个开源、自托管的 AI-native 工作操作系统，也是一套面向多智能体协作的 Agent Infra。它把数据、需求、任务、上下文、执行者、验证和状态回写连接成一张持续运转的工作 Graph，让一个人也能组织一支持续工作的 AI 团队。 传统 AI 助手解决的是一次对话里的单点效率；1agents 解决的是一件工作从进入系统到被验证完成的完整链路。它把 Inbox、IM、数据源、项目、任务蓝图、Agent 会话、终端、文件、日程和扩展能力组织在一起，不是为了堆功能，而是为了让工作可以被接住、被理解、被拆解、被调度、被执行、被验收，并让结果成为下一轮行动的上下文。 产品方向：搭建自循环的智能体 Graph 1agents 的核心不是一个更大的 Chat 面板，也不只是让 Agent 在单条 Loop 中重复执行，而是用 Graph 表达真实工作： 节点（Node）承载数据、需求、缺陷、任务、里程碑、会话、产物和验收记录； 状态（State）描述工作处于待规划、执行中、阻塞、待验收、完成或返工； 边（Edge）表达来源、归属、依赖、拆解、分发、验收和回写关系； 判断（Decision）决定依赖是否满足、由谁执行、验收是否通过以及下一步走向； 回流（Feedback）把执行结果和失败原因写回 Graph，更新计划并触发后续节点。 一条典型的业务 Graph： 目标是让 AI 不只停留在“帮人做一步”，而是进入协作链路：工作进来后，系统根据节点、状态和判断持续推进，显式暴露卡点，把结果交给人确认，并把经验沉淀成可复用的能力。Loop 是 Graph 中的一条回路；Graph 才是完整工作的组织方式。 主要功能 智能体工作台 Web 前端访问本机或远程 1agents 后端。 支持本机直连和 Relay 中转连接。 支持 Access Token 门禁和 Relay 配对门禁。 桌面端提供左侧工作区树、顶部上下文栏、主工作区画布和右侧内容面板。 移动端提供单列布局、触控导航和移动端 Chat/终端/设置入口。 支持多标签页、内置浏览器、文件预览、全局搜索和可拖拽分栏。 桌面端右侧副面板支持按会话持久化的多 Tab，可在任务、文件、浏览器、Git 与终端之间并行切换。 项目与工作区管理 创建、切换、删除和归档工作区。 一个工作区对应一个目录，也是终端和 Agent 执行任务的工作目录。 项目首页展示项目列表、归档项目和项目模板入口。 项目详情页包含会话、团队、任务、文件、渠道、动态、计划、资产和设置等标签。 项目配置支持指令、连接器、可见标签页和项目级设置。 AI 会话 新建 Chat 会话时可选择工作区、Agent 类型、角色、权限模式和初始 Prompt。 支持普通会话和 PM 会话。 支持会话列表、会话重命名、删除、任务关联和项目上下文锁定。 消息区支持 Markdown、代码块、表格、链接、Mermaid 和任务引用。 展示 Agent 的工具调用、命令输出、文件 diff、计划清单和权限确认。 支持附件、语音输入和 Slash Command。 Web 终端 基于 ttyd、xterm.js 和 WebSocket 提供浏览器终端。 使用 tmux 维护终端会话，刷新或断线后可恢复。 支持多终端窗口、指定工作区和 cwd 创建终端。 副面板终端 Tab 空闲后会卸载前端连接并回收对应 tmux window，避免长期遗留进程。 支持初始命令、tmux 鼠标模式、浅色/深色终端主题和移动端终端适配。 PMO、任务与路线图 项目内置讨论、需求、任务、缺陷、AI 建议和里程碑管理。 功能蓝图展示模块、功能点、来源需求和交付任务，并与任务、版本和交付状态联动。 任务蓝图将需求、功能点、交付任务、依赖、执行计划和里程碑组织成可导航、可追踪、可回写的工作地图。 任务视图支持列表、看板、日历和里程碑路线图。 任务表格支持搜索、筛选、排序、分组、列显隐和内联编辑。 任务详情展示描述、验收标准、checklist、子任务、关系、评论、会话分支和属性。 支持 #编号 任务引用和任务深链。 Inbox 内容可以分发到项目需求池。 文件、预览与 Git 文件浏览器支持工作区文件树、平铺视图和文件搜索。 支持文本、图片、Markdown、HTML、PDF 等内容预览。 Chat 和 Git 相关流程支持 diff 展示。 Git 面板围绕当前工作区展示版本控制相关操作。 内置浏览器可打开 URL、Dashboard 或外部页面。 数据源与数据治理 数据源模块支持外部账号接入、授权、配置和数据查看。 数据接入层按 source/account 管理原始数据。 数据治理层展示清洗、融合后的治理表。 支持 Python 脚本或确定性任务执行数据处理与热更新。 支持治理表详情、依赖关系和执行记录。 联系人、消息、Inbox 与日程 联系人模块可聚合外部渠道身份，支持联系人表格、搜索、分组、详情和编辑。 消息模块展示外部渠道消息和群聊内容。 Inbox 支持手动捕获文本或 URL、信息分类与意图识别、已读/未读、归档，以及将需求或反馈分发到项目。 日程模块聚合个人提醒、项目任务和里程碑日期，支持月历视图和提醒创建。 助理、技能与 Agent 能力管理 助理页管理 Assistant 工作区。 助理详情包含会话、团队、任务、文件、渠道和设置。 团队与技能页用于管理项目/助理关联的技能配置。 集成受控 HarnessKit Fork，用统一 Extensions 面板管理 Skills、Subagents、Commands、MCP、Hooks、Plugins、CLI 和 Kits。 Agent Catalog 展示可用 Agent 类型和安装命令。 插件式应用 已实现编译期 App Registry、Manifest 查询与启停，以及前端 Mount Point 渲染。 应用可以贡献一级页面、项目标签页和 Lens overlay；当前生产注册应用包括“圆桌讨论”。 完整外部应用 SDK、运行时热安装和第三方应用市场仍在演进。 发现中心展示应用、精选推荐和开源项目。 cc-connect、Provider 与渠道 集成 cc-connect，用于连接 Feishu、Telegram、Discord、Slack、DingTalk 等消息平台。 Provider 面板用于管理通信和 Agent 执行平台配置。 项目渠道页展示项目相关渠道状态。 Relay 模式下嵌入模块请求会走统一中转。 系统设置与更新 支持语言、主题、初学者/高级模式设置。 支持 Relay 配对、设备状态、账户/订阅和本机模式设置。 支持前端和后端版本检查与更新。 支持清空浏览器缓存和重置本地 App 数据。 Dashboard Dashboard 用于查看项目和团队运行状态。 包含项目列表、进度、最近活动、全局任务板和大屏视图。 可作为独立页面或内置浏览器标签打开。 架构概览 1agents 的四层共同维护同一张工作 Graph： 入口与数据层：Inbox、IM 渠道、数据源、数据治理、手动任务、日程和应用业务对象，把外部信息转成可处理的工作信号。 组织与 Graph 层：项目 / 工作区、ProjectItem、依赖、任务蓝图、计划、优先级、里程碑和验收标准，负责保存上下文、状态和关系。 调度与执行层：Schedule 根据状态和依赖触发任务，通过 1ACP / ACPX 接入不同 Agent，并与确定性 function、human 在同一任务内核下分流执行。 验证与回写层：Check、任务时间线、TaskRun 和 ProjectEvent 记录产出、验证、返工和状态变化，决定下一条边并把结果写回 Graph。 核心对象： 工作 Graph：由节点、状态、边、判断和回流组成的工作事实与执行关系。 项目 / 工作区：承载一个目录、一组会话、一组任务和项目配置。 ProjectItem / 工作项：承载需求、缺陷、讨论或可执行任务；task 型工作项进入调度。 任务蓝图：连接来源需求、功能点、交付任务、依赖、里程碑、目标版本和验收状态。 执行者：包括 AI Agent、确定性程序和用户本人。 时间线与执行记录：承载用户反馈、Agent 回复、会话分支、TaskRun、验证结果和状态变更。 仓库按“主产品 + 可替换执行组件 + 可分发模块”组织：前端和后端提供 1agents 主工作台；ttyd 提供终端能力；cc-connect、cc-switch、happy、HarnessKit、1acp 等子模块提供 Agent 接入、扩展管理、协议适配和 CLI sidecar；npm 分发层会把 core / web / cc-connect / cc-switch 等拆成平台包或功能包发布。