# 路线图

> "人们不知道自己想要什么，直到你把它摆在他们面前。"
>
> 这不是一份功能清单。这是一个关于**你的 AI 助手应该如何存在**的宣言。

---

## 我们的信念

每个人都值得拥有一个真正理解自己的 AI 助手。

不是一个聊天玩具。不是一个技术 demo。而是一个**数字分身**——它知道你的工作方式，连接你的所有工具，替你思考、替你执行、替你记住。

MateClaw 就是这个东西。

---

## 我们已经做到了什么

### v1.0 —— 它能思考和行动 ✅ 已发布

让一个 AI 助手成为"会用工具的同事"，不是一个聊天框。

- ReAct 引擎：思考、行动、观察、再思考
- Plan-and-Execute 编排：先制定计划，再逐步执行
- StateGraph 架构：基于状态图的 Agent 编排
- DynamicAgent：从数据库加载配置，运行时随时调整
- 20 个内置工具：搜索 / Shell / 文件 / 委派 / 多模态生成 / 定时任务 / SQL 查询
- ToolGuard + FileGuard + AuditLog：每一次工具调用有审批、有控制、有记录
- SKILL.md 技能系统：像装 App 一样给 AI 装新能力

### v1.1 —— 它无处不在 ✅ 已发布

把 AI 从"网页上的对话框"搬进你团队真正在用的每一个 IM。

- **8 个渠道**：Web / 钉钉 / 飞书 / 企业微信 / Telegram / Discord / QQ / 微信个人 / Slack
- 4 层记忆：会话上下文 + 工作空间记忆 + 对话后提取 + 每天凌晨 2:00 自动整合
- DREAMS.md 整合日记：人类可读的记忆变更审计
- 工作空间隔离：每个 agent / skill / wiki / conversation / memory 都属于一个工作空间
- ChatGPT OAuth + Anthropic Claude Code OAuth：用订阅直接登录，不需要 API Key
- LLM Wiki 知识库 + RAG：把原始文件吃进去变成结构化、有双向链接、有摘要的知识页

### v1.2 —— 它是你的同事 ✅ 已发布（2026-05-05）

把"智能体"换成**数字员工**——这不是术语洁癖，是世界观换了。

- **数字员工**：每位有角色（Role）、目标（Goal）、背景故事（Backstory），不是冰冷的 system prompt
- **5 个职业模板**：产品研究员 / 客户支持 / 知识管理员 / 数据分析师 / 行政助理——开箱即用
- **技能是骨架**：每个技能有自己的 SKILL.md + LESSONS.md + workspace 文件空间
- **ACP 桥接**：Claude Code、Codex、Gemini CLI 这些顶级编码 Agent 以"员工"身份接入
- **Backstage 运行时控制台**：第一次能**看见每个员工正在干什么**
- Onboarding wizard + Dashboard + Doctor

完整故事：[v1.2.0 Release Notes](./releases/1.2.0.md)。

### v1.3 —— 它能编排业务流 ✅ 已发布（2026-05-13）

从"chatbot 框架"升级为"业务流程 OS"——一条业务流不再是几个员工各自聊天的总和，而是一份可发布、可触发、可重放的**线性 step DSL**。

- **工作流**：7 种 step mode（sequential / fan_out / collect / conditional / await_approval / dispatch_channel / write_memory）+ Pebble 表达式 + JSON-first 编辑 + 整数 revision + 运行历史
- **自然语言 → 工作流草稿**：描述需求，agent 生成 graph_json，人工审阅后发布
- **触发器**：6 种 pattern type（cron / webhook / channel_message / agent_lifecycle / content_match / workflow_completion），事件治理默认开（去重 / 限速 / 递归切断）
- **`await_approval` 持久化暂停**：服务重启不丢
- 图像编辑、4 个文档生成工具（Docx/Xlsx/Pptx/Pdf）、MCP per-agent 工具绑定、多模态旁路路由

完整故事：[v1.3.0 Release Notes](./releases/1.3.0.md)。

### v1.4 —— 它更自主、能带团队 ✅ 已发布（2026-05-23）

流程是你写死的，员工本身还是"答完一轮就停"。这一版把焦点放回员工自己身上。

- **持久化目标（Goal）**：你说一次目标，员工锁住它、每轮自检、自己续命，直到完成或耗尽预算
- **子员工委派树**：递归委派最深 3 层，同步 / 并行扇出 / 异步三种委派工具；「数字员工构建器」一句话拉起一支团队
- **渐进式工具/技能披露**：核心层始终可见，扩展层按需 `enable_tool` / `load_skill`——工具再多，上下文不爆
- **工作空间 RBAC**：Owner / Admin / Member / Viewer 四级角色 + 能力门禁，MateClaw 第一次能给团队用
- **飞书一等公民**：互动卡片、审批卡片、流式卡片、语音转写、文件音视频收发、渠道原生工具
- 原生 Gemini、xAI / Grok、按会话选模型、结构化上下文压缩、限流自动故障转移

完整故事：[v1.4.0 Release Notes](./releases/1.4.0.md)。

### v1.5 —— 它可验证、知识会自维护、记忆认人 ✅ 已发布（2026-06-04）

让"自主"变得**可验证**，让"知识"变得**会自维护**，让"记忆"变得**认人**。

- **目标清单（checklist）**：目标拆成可逐条验证的准则，evaluator 一条条勾，**全勾完才算完成**——没有"差不多 95% 就放过"
- **Wiki 自维护**：`[[wikilink]]` 页面互联 + 改名/删页自动级联修链 + 坏链体检；知识分事实层 / 经验层，事实一改依赖它的经验页自动标"待复核"；pageType 档案 + per-agent 权限；页面事件触发的处理流水线；本地目录挂成知识源定时增量同步
- **记忆 per-owner 隔离**：每条记忆带 owner_key 和可见范围（个人 / 团队 / 全局），一个员工服务一群人互不串台；API 透传 `endUserId`
- 员工绑主知识库、偏好提供商真正生效、生成文件落盘持久化

完整故事：[v1.5.0 Release Notes](./releases/1.5.0.md)。

### v1.6 —— 它来到你所在的地方 ✅ 已发布（2026-06-22）

它能跑在哪、能用手和眼睛做什么、以及你能多直接地塑造它是谁。

- **KingbaseES（人大金仓）+ PostgreSQL 一等公民**：PostgreSQL 家族共用一套迁移树，国产化 / 受监管环境可用；MySQL 和桌面 H2 完全不动
- **图片跨轮次留在上下文**：三条消息之前发的截图，追问还看得见；`image_analyze` 按需重读
- **`execute_code`**：员工写代码并运行——算术、文件转换、核对，从猜测变成真实动作
- **塑造员工身份**：AGENTS.md 等上下文文件有了真正的编辑器（模态 + 章节重排）；About You 身份块；员工知道自己跑在哪个模型上
- **知识库访问限定范围** + Wiki Sources 标签（多路径 + glob + 按 KB 自动同步）
- 全局出站代理、最终回答确定性 Markdown 规范化

完整故事：[v1.6.0 Release Notes](./releases/1.6.0.md)。

### v1.7 —— 它敢放进生产 ✅ 已发布（2026-07-04）

一次**生产化加固**：把它放进真正的协作里之后，那些看不见、收不拢、够不着、装不下、连不通的地方，这一版全补上。

- **审批三条链路彻底闭环**：工作流 `await_approval` 真的推到渠道并能 resolve→恢复执行；WebChat（API-Key）渠道能批准/拒绝并重放；飞书/企微点卡片按钮直接 resolve 工作流审批
- **长任务看得见**：常驻「运行总览」侧栏（步骤进度 + 委派子 Agent 树状实时状态）+ 本轮 Token 明细（缓存命中/未命中/写入 + 推理拆分）+ 子 Agent 成本向上滚加 + 生成文件一键下载
- **装得下真实模型窗口**：本地模型上下文窗口探测、prefix 注入统一 Token 预算、小上下文自动降级、工具 schema 超预算按频度降级——不再被"猜个 32K"坑到预检拒绝或悄悄截断
- **开放出去**：知识库与 Deep Research 开放 API（API-Key + 限流 + SSE）、插件化搜索 Provider SPI、MCP 身份透传（把认证用户身份带给 STDIO MCP）
- **够得着更远**：桌面端本地内嵌 / 远程集中部署双模式 + 多服务器切换 + `mateclaw-desktop` 源码开放；局域网部署模式放开受控内网访问
- **运营数据一键导出**：Dashboard 9 表 Excel + CLI 命令行离线导出
- Wiki 处理失败可视化、按员工模型链偏好、OpenAPI / Swagger 可直接调试、聊天回到底部浮动按钮

完整故事：[v1.7.0 Release Notes](./releases/1.7.0.md)。

### v1.8 —— 它干完一整件活 ✅ 已发布（2026-07-12）

员工**转向对外、把一整件活干完**——从一句话简报到可发布成品——全用 MateClaw 自身的原子能力。

- **内容工作室** —— 第一个招牌*场景*：预置员工跑通 选题 → 搜集 → 成文 → 配图 → 去 AI 化 → 排版 → 交付。**微信公众号（公众号）** 图文文章（内联样式 HTML → 草稿箱）与 **小红书** 以图为主图文笔记（≥3 张竖版 3:4 卡片 + 在线预览）首批一等公民
- **可度量的去 AI 化** —— 启发式 AI 痕迹评分驱动 检测 → 改写 → 复检 闭环，硬上限 3 轮
- **为长期投产而加固的发布链** —— 正文图上传进微信、AES-GCM 加密密钥、服务复用 + token 持久化、重试 + 中文错误提示、兜底封面；草稿箱优先，发表走审批
- **会去重、会记账的内容日历** —— 每次交付都合规扫描 + 自动落台账、选题指纹防重复、只读内容日历页展示草稿/已打包/已发布/失败
- **浏览器 Agent 按引用去看** —— 无障碍树 ref 快照 + 按 ref 交互、真实浏览器隐私护栏、受控 CDP 逃生舱
- 注意力锚定与环境感知、工具调用循环护栏、改动后校验提醒；快加载优化（初始包体 ↓约 78%）、上下文占用面板、跨知识库 wikilink、MCP 进度通知、火山方舟供应商、PostgreSQL 16

完整故事：[v1.8.0 Release Notes](./releases/1.8.0.md)。

### v2.0 —— 它带队干活 ✅ 已发布（2026-07-31）

从"一个能干活的人"到"一支能协作的队伍"——**Agent 团队**成为常设编制，围着一块共享任务板协作。

- **团队实体与角色编制**：团队 = 名字 + Lead + 成员 + reviewer，持久化、可复用；团队名册与协作准则注入成员提示词
- **共享任务板**：八状态看板、`blockedBy` 依赖编排、成员级并行派发、前置结果自动传递、结果通报唤醒 Lead
- **队长调度**：Lead 拆任务、指派、验收；Plan-Execute 型 Lead 的计划**整体移交任务板**——步骤变任务、依赖变并行
- **执行加固**：租约心跳防双重执行、取消即中断、`in_review` 人工审批卡点、失败/过期可重试
- **交付物与全程可观测**：产出文件登记到任务、任务时间线、团队 SSE 实时看板、跳进成员子会话看逐字执行
- 外加：工作空间隔离全面收口、渠道魔法命令 + 企微进度气泡、会话回退/重新生成、自动批准可解释性、LLM 错误恢复策略化、附件在线预览、SKILL.md 单一事实源、Mem0 插件 provider

完整故事：[v2.0.0 Release Notes](./releases/2.0.0.md)，使用指南：[团队协作](./teams)。

### v2.1 —— 它把团队工作变成可治理的运行 ✅ 已发布（2026-08-15）

2.0 建好了团队和任务板，2.1 把长期使用后暴露的三条链合流：**一次团队请求有统一身份、一次执行有可回放轨迹、一项技能改进有来源和恢复点**。

- **统一 Team Run**：一个 `runId` 串起用户请求、任务 DAG、成员执行、最终汇总与交付物；Chat 交付、Agents 观察、Teams 治理读取同一投影
- **成果优先的交付体验**：团队 worker 会话退出普通侧栏，中间通报合并，最终摘要、文件、异常和审批优先，过程逐层下钻
- **Skill 自进化闭环**：reflection + 跨会话重复请求 mining + promotion + 受约束自动绑定 + curator 治理移交 + snapshot/restore；reflection/routine 默认关闭，curator 激活前只预览，按工作空间隔离且可回滚
- **推理与执行可回放**：每轮 thinking、真实耗时、tool/observation 顺序、superseded 叙述与线性 trajectory 导出
- **能力到达真实现场**：主动渠道消息、Cron 定向投递、模型级上下文窗口、渐进式工具桥、行动完成约束
- 浏览器、WebChat/SSE、飞书进度、Qwen3-ASR、文件目录与 64 位 id 精度全面加固

完整故事：[v2.1.0 Release Notes](./releases/2.1.0.md)，使用指南：[Team Run 与团队协作](./teams)、[技能系统](./skills)。

### v2.2 —— 运行时可替换、长任务可恢复 ✅ 已发布（2026-08-29）

2.1 定义了什么是一份完整运行；2.2 让“由谁来运行、如何在中断后继续、怎样与外部 Agent 协作”成为基础设施能力。

- **员工 Runtime Contract**：provider registry、session factory、能力声明与统一事件流，让 native / 外部 runtime 共用会话、工作空间、工具治理和 UI 投影
- **DeepSeek Harness Runtime**：认证 JSON-RPC 子进程桥、思考/文本/工具/生命周期事件、宿主工具策略、受管理安装配置与环境隔离
- **持久目标执行**：有界 segment + 数据库调度队列 + supervisor + lease / attempt / 输入排队，服务重启后恢复未完成目标
- **A2A 互联**：MateClaw 同时成为 A2A server 和 client，支持 Agent Card、流式任务、查询/取消以及受限出站调用
- **运行时可靠性与边界**：Team 交付完成门、checkpoint 恢复、长回答、审批输入、生成文件和管理视图的工作空间隔离全面加固
- 可选 OfficeCLI 文档引擎、ACP prompt timeout 与插件工具发现补齐扩展运行时的日常能力

完整故事：[v2.2.0 Release Notes](./releases/2.2.0.md)，使用指南：[DeepSeek Harness](./deepseek-harness)、[持久化目标](./goals)、[A2A 协议](./a2a)。

---

## 下一站：常驻 Runtime 与团队进阶

> "伟大的事业不是一个人做成的，是一个团队做成的。"

回头看这条线：v1.2 员工有了身份，v1.3 流程能编排，v1.4 员工会自主跟目标、能临时拉起委派树，v1.7 长任务看得见，v2.0 团队成了常设编制，v2.1 让每轮团队工作可交付、可学习、可治理，**v2.2 则让执行引擎可替换、长目标能跨请求和重启恢复、Agent 能跨系统互联**。

还剩一个“停”：**持久目标已经会继续，但员工还没有通用的常驻职责循环。** cron 和触发器能定时叫醒它，Goal supervisor 能恢复一项目标，却还没有统一 inbox、心跳、值班日志和跨目标的优先级决策。下一步是把 2.2 的 runtime / queue / recovery 基础推广成真正的“在岗”状态。

### Agent Team 进阶 —— 编制有了，接下来长本事

2.0 交付了团队实体、任务板、队长调度与执行链（见上），团队方向还想做：

- [ ] **成员互审（peer review）**：关键产出可以配置"另一个成员复核后才交付"（2.0 的 `in_review` 是人工审批；成员互审是下一步）
- [ ] **团队级目标**：一个 goal 拆成成员子目标，清单跨成员汇总——hover 队长头像，看到整个团队还差哪几条
- [ ] **团队绑渠道**：一个飞书群 / 钉钉群绑一个团队，群里 @ 团队，队长决定谁接
- [ ] **团队复盘**：任务收尾自动生成 retrospective，沉淀进团队的 LESSONS.md——这个团队下次会做得更好
- [ ] **协作 DAG / 泳道视图**：在时间线数据之上画出任务依赖与成员泳道
- [ ] **「数字员工构建器」升级**：一句话直接产出一个**带编制的常设团队**

### Agent Loop（智能体循环）—— 从"答完就停"到"长期在岗"

让员工进入一种新状态：**在岗**。不是等你说话才动，而是按心跳周期自主循环——**醒来 → 看收件箱和目标 → 决定做不做 → 行动 → 记日志 → 休眠**：

- [ ] **常驻循环运行时**：员工可以被设为"在岗"，按可配置的心跳（分钟级到天级）自主醒来检查职责范围
- [ ] **任务收件箱（Inbox）**：渠道消息、触发器事件、其他员工的委派、你随手丢的待办——统一进一个队列，循环醒来按优先级消化
- [x] **跨请求与重启的目标延续（2.2）**：Goal supervisor、持久队列、lease / attempt 和恢复逻辑把目标带过有界执行片段与服务重启，直到清单通过或明确暂停
- [ ] **预算与熔断**：每循环有 token / 成本 / 轮次预算，连续失败自动熔断进入休眠等你处置；ToolGuard 审批门禁照常拦截敏感操作——自主不等于失控
- [ ] **循环日志（Loop Journal）**：每次醒来干了什么、为什么决定不干、花了多少——人类可读、可回放，像 DREAMS.md 之于记忆
- [ ] **暂停 / 恢复 / 一键下班**：UI 和渠道命令都能控制；运行总览侧栏显示每个在岗员工的循环状态
- [ ] **安静时段与打扰策略**：夜间静默积攒、重要事项主动汇报——和 nudge 体系结合，它知道什么值得叫醒你

### 两者合流：会自己运转的部门

队长在岗循环，成员按需唤起——这就是一个**会自己运转的数字部门**：

- 晨报部门：队长每天 7:00 醒来，派数据员工采数、分析员工汇总、写作员工成稿，互审后发进群——你睡醒看结果
- 客服部门：收件箱进一条工单，队长判断类型，指派对应成员处理，处理不了的升级给你
- 情报部门：监控员工循环盯着信息源，发现值得关注的变化才唤醒分析员工，分析完值得打扰才通知你

**工作流负责"确定的流程"，团队 + 循环负责"不确定的日常"。** 三者互补，不互相替代。

### 同步推进的事

- [ ] **工作流 `loop` / `invoke_skill` step mode**：迭代处理数组 / 直接调技能不经过员工
- [ ] **工作流画布编辑**：从只读链式渲染到拖拉编辑
- [ ] **运行回放视图**：trace timeline + 任意节点看 input/output diff
- [ ] **场景模板与场景市场**：把"员工 + 团队 + 工作流 + 触发器 + 知识库结构"打包成可一键导入的场景包

---

## 我们故意不做的事

> "我对我们没做过的事情和我们做过的事情一样感到自豪。"

| 砍掉的功能 | 为什么 | 什么时候才该做 |
|-----------|--------|--------------|
| **超出四级角色的细粒度 RBAC** | v1.4 的 Owner / Admin / Member / Viewer + 能力门禁已覆盖真实团队需要。按钮级权限、自定义角色组合是企业管理平台的事 | 当真正出现需要细粒度权限的多团队 SaaS 客户时 |
| **多租户** | 过早的多租户是架构癌症。工作空间隔离已覆盖单组织多团队 | 当有明确的 SaaS 商业化路径时 |
| **SSO / LDAP / SAML** | 企业集成是个无底洞 | 当付费企业客户明确要求时 |
| **30+ 节点的可视化工作流编辑器** | 7 种 step mode 已覆盖 90% 实际场景，剩下的复杂度推给自然语言生成 | 真有用户场景需要 30+ 节点时（很少） |
| **移动端原生 App** | 8 个 IM 渠道 + 桌面端（现已支持连远程）+ Web 已经覆盖。你在手机上用钉钉 / 飞书 / Telegram 就在用 MateClaw | 当 Web / IM 渠道有不可替代的移动专属能力时 |
| **替代 ReAct / Plan-Execute** | 工作流、团队、循环和这两条引擎**是协作关系**，不是替代——单 agent 多轮推理仍在那两条引擎里 | 永远不替代 |
| **无预算的全自主 Agent** | Agent Loop 永远带预算、熔断和审批门禁。"跑到没钱为止"不是自主，是失控 | 永远不做 |

---

## 版本里程碑

| 版本 | 一句话 | 用户体验目标 | 状态 |
|------|--------|-------------|------|
| **v1.0** | 它能思考和行动 | 一个能用工具解决问题的 AI 助手 | ✅ 已发布 |
| **v1.1** | 它无处不在 | 8 个渠道 + 4 层记忆 + 工作空间 + LLM Wiki | ✅ 已发布 |
| **v1.2** | 它是你的同事 | 数字员工 + 职业模板 + 骨架式技能 + ACP 桥接 + Backstage | ✅ 已发布 |
| **v1.3** | 它能编排业务流 | 工作流 + 触发器 + 文档生成 + per-agent 工具绑定 | ✅ 已发布 |
| **v1.4** | 它更自主、能带团队 | 持久化目标 + 委派树 + 渐进披露 + RBAC + 飞书一等公民 | ✅ 已发布 |
| **v1.5** | 它可验证 | 目标清单 + Wiki 自维护 + 记忆认人 | ✅ 已发布 |
| **v1.6** | 它来到你所在的地方 | 国产数据库 + 视觉留存 + 代码执行 + 身份塑造 | ✅ 已发布 |
| **v1.7** | 它敢放进生产 | 审批三链路闭环 + 运行总览与成本可见 + 上下文/Token 预算 + 开放 API/Deep Research + 桌面远程/局域网 + 运营导出 | ✅ 已发布 |
| **v1.8** | 它干完一整件活 | 内容工作室 —— 一句话到可发布的公众号 / 小红书成品 + 浏览器 ref 交互 | ✅ 已发布 |
| **v2.0** | **它带队干活** | **Agent 团队 + 共享任务板 —— Lead 拆解派发、成员并行执行、交付物与全程可观测** | ✅ 已发布 |
| **v2.1** | **它把协作变成运行** | **统一 Team Run + Skill 自进化闭环 + 可回放推理轨迹 + 主动渠道投递** | ✅ 已发布 |
| **v2.2** | **它重塑运行时** | **可插拔 Runtime + DeepSeek Harness + 持久 Goal 恢复 + A2A 互联** | ✅ 已发布 |
| **下一站** | **它长期在岗** | **通用常驻 Runtime（心跳 / inbox / journal / 熔断）+ 团队进阶 = 会自己运转的数字部门** | 📋 规划中 |

---

## One More Thing

我们做 MateClaw，不是为了追赶 ChatGPT、不是为了做下一个 Dify、不是为了融资 PPT 上多一个 buzzword。

我们做它，是因为我们相信一件事：

**AI 不应该是一个网页上的对话框。它应该是你的第二个大脑。**

它住在你的钉钉里、你的飞书里、你的 Telegram 里。它读过你所有的文档。它记得你三个月前说过的话。它会用你公司的内部工具。它在你睡觉的时候整理记忆。它能替你跑一整条业务流程。**现在它的运行时可替换、长目标可恢复、外部 Agent 可互联；下一步，是把这套底座推进成长期在岗的数字部门。**

总有一天，你会忘记它是一个程序。

**那一天，就是我们成功的那一天。**

---

*Stay hungry. Stay foolish.*