织点 AgentLoom 第一版实现与验证

历史记录。 保留原阶段的能力、日期和测试数字，不作为当前实现清单。2026-10-09 核对后的现状见总体技术设计，当前需求见产品需求。

日期：2026-09-30

入口	位置
代码位置	项目根目录
正式页面	http://localhost:8766
API 文档	http://localhost:8766/api/docs
旧演示	http://localhost:8765（独立保留，不是真实后端）

已完成

Vue 3 + TypeScript 正式前端，FastAPI 后端，SQLite 服务端持久化。
账号初始化、登录、邀请码注册、空间访问、API Key 生成与撤销。
DeepSeek/OpenAI 兼容 Chat Completions 模型连接，Key 加密存储、连接测试。
Skill 完整目录上传、公开 HTTPS Git 导入、frontmatter、引用资料与按需加载。
外部 MCP HTTP/SSE 发现与调用；托管 Python 目录/Git、容器构建与 stdio 服务代码。
知识库 MD/TXT/SQL 上传、分块、中文关键词、可选 embedding 与融合检索、引用及文件删除。
Agent 配置/草稿/不可变发布版本。未发布不能运行。
主 Agent ReAct/自动 Plan。子 Agent 配置内嵌，不独立选择模型或执行策略。
动态委派子任务，资源范围独立，统一继承主模型，返回结果。
会话、网页/API 共享引擎、SSE 事件、取消、超时、产物下载。
启动脚本、部署模板、Python 工具 SDK、示例技能和工具、OpenAPI 契约。

已验证

Vue 类型检查与生产构建通过。
23 项集成测试通过；涵盖发布限制/快照、空间/API 鉴权、密钥不回显、Skill 上传/路径、关键词及混合检索、子 Agent 契约与继承模型、Plan 与文件产物、取消、缺少 Docker 时拒绝宿主执行。
真实 MCP Streamable HTTP 本地服务发现与调用成功。
Vue 浏览器验证：登录、Agent 创建/保存/编辑、子 Agent 创建/编辑、发布后弹窗关闭、版本选择入口、发起运行、事件流与输出。
页面验证使用 work/qa 内独立测试账号与替身模型；正式 data 内没有测试账号或模型 Key。

尚未验证或当前限制

没有用户真实模型 Key，供应商端到端响应与工具调用尚未实测；模型/embedding 逻辑测试使用替身。
本机没有 Docker，托管构建与 Skill 脚本容器执行代码尚未实机验证。Compose 模板未实机构建。
Git 导入未完成远端集成验证；首版仅公开 HTTPS Git。
不承诺完整兼容所有 Codex/Claude Code Skill 宿主工具或自定义依赖。
当前没有后台索引队列、索引重建、私有 Git 凭据、分布式执行、子任务并行/递归。
SQLite 向量相似度用于小规模测试。未配置 embedding 时明确使用关键词检索。
文件索引失败可重新上传；新上传文档需要重新发布 Agent 后纳入快照。删除文档使历史检索也不可再访问。

使用顺序

由用户首次创建管理员账号。
模型连接页添加实际 Base URL、模型 ID、Key，并测试连接。
添加所需 Skill/MCP/知识库，配置 Agent，发布后调试。
通过空间成员页创建 API Key 后按发布页面示例调用。

详见项目 README.md。

2026-09-30 执行循环升级

统一模型行动/工具观察循环；Plan 使用 update_plan 动态维护并立即执行，子任务共用循环。
候选回答经过目标/计划/证据检查，可要求继续工作或进入 needs_input。
完整工具组上下文压缩，加密检查点，保留主/子任务、工具调用位置和文件工作区。
任务历史和恢复 API；Vue 展示计划状态、完成检查、压缩与继续任务入口。
恢复不会自动重放已完成调用，执行中中断的未知外部动作先检查状态；无 exactly-once 保证。
本次新增动态重规划、提前结束纠正、计划完成门槛、上下文协议、恢复不重放、未知动作、子任务恢复、阻碍补充与重启状态测试。
真实供应商模型和 Docker 限制仍同上；完成检查使用同一模型，不能替代真实工具验证。
网页验证已通过：Plan 自动生成/读回文件；阻碍状态；刷新页面后从历史选择原任务；补充后恢复；计划更新与完成检查事件。验证使用独立测试空间与替身模型。