Skip to content

Home

Jump to bottom
Catown Bot edited this page Apr 10, 2026 · 10 revisions

Catown Wiki

最后更新: 2026-04-10

项目概览

PRD | ADR 索引 | Skills | 路线图

Catown — AI 软件工厂。输入原始需求，输出可发布产品。多个 AI Agent 协作完成软件项目开发，全流程自动化，BOSS 可实时监控和介入。

架构速览

用户提交需求 → Pipeline 启动
    │
    ▼
┌─────────┐  ┌──────────┐  ┌───────────┐  ┌────────┐  ┌─────────┐
│ Analyst  │→│ Architect │→│ Developer  │→│ Tester │→│ Release │
│ 需求分析 │  │ 架构设计  │  │ 编码开发   │  │ 测试    │  │ 发布     │
│ Gate:人工 │  │ Gate:自动 │  │ Gate:自动  │  │ Gate:自动│  │ Gate:人工│
└─────────┘  └──────────┘  └───────────┘  └────────┘  └─────────┘

核心技术栈: Python 3.10+ / FastAPI / SQLite / WebSocket / Vanilla JS + TailwindCSS

测试状态: 27 Pipeline + 35 E2E + 227 单元 = 289 个测试 100% 通过

路线图

按优先级排序，P0 最高。

✅ 已完成

# 模块 内容 日期
— 数据模型 + 配置 agents.json, pipelines.json, DB 表 2026-04-07
— Pipeline 引擎 + API 5 阶段流水线、Gate 审批、回滚 2026-04-07
— 前端 Dashboard Pipeline 状态、Agent 通信、产出物 2026-04-07
— Git 集成 自动 commit + tag 2026-04-07
— Agent SOUL 体系 三层 prompt（灵魂→角色→规则→记忆） 2026-04-08
— Skills 三级注入 hint/guide/full 渐进式披露 (ADR-008) 2026-04-10
P0 工具白名单 agents.json tools 字段 → 运行时校验 2026-04-10
P0 Workspace 隔离 路径白名单 + symlink 防护 + .catown 保护 2026-04-10
P0 知识图谱 Skill 定义 ADR-004 确认 Skills 模式，skills.json 已写入 2026-04-10

⏳ 待做

阶段一：Agent 认知基础（P0）

# 模块 内容 依赖
1 短期记忆 内存 + JSON 落盘，Stage 结束摘要归档到项目记忆 无
2 项目记忆 Markdown 文件 + grep 检索，存储在 .catown/memory/ #1
3 Choice Box 交互组件 前端：单选/多选/确认/编辑组件，用于 BOSS 审批和决策 无
4 Agent 操作可视化 折叠卡片：LLM 思考 / 工具调用 / 记忆操作 / Agent 通信 无

阶段二：交互与流程（P1）

# 模块 内容 依赖
5 聊天框输入体验 消息历史（↑↓）、指令系统（/help 等）、输入联想补全 #3
6 工具临时授权流程 Agent 请求 → Choice Box → BOSS 审批（本次/本阶段/拒绝） #3
7 审计日志系统 audit_logs + audit_details 双表，滚动清理，锁定机制 无
8 知识图谱集成 developer/architect 加入 knowledge-graph skill；建图审批接入 Choice Box #3, #6

阶段三：记忆深化（P2）

# 模块 内容 依赖
9 长期记忆 (ChromaDB) Agent 级向量数据库，语义检索，跨项目保留 #1, #2
10 睡眠整理调度器 空闲触发记忆压缩、短期→项目→长期迁移、不确定项提交 Choice Box #1, #2, #3

阶段四：高级能力（P3）

# 模块 内容 依赖
11 OMNI 多模态集成 图片理解（P0）、视频/音频处理（P1） 无
12 UI/UX Pro Max Phase 2 截图对比、ui-designer Agent 角色、设计资产产出物 #6
13 Knowledge Graph 进阶 增量更新自动化、图谱可视化、Agent 建图自主决策 #8, #9

ADR 索引

# 标题 状态 日期
ADR-001 记忆系统架构决策 — 混合方案（自研编排 + ChromaDB） ✅ 已确认 2026-04-09
ADR-002 Agent SOUL 体系 — 三层 prompt 结构 ✅ 已确认 2026-04-09
ADR-003 LLM 对话系统队列调度模式 — steer/followup/collect/steer-backlog 动态选择 ✅ 已确认 2026-04-09
ADR-004 知识图谱集成方案 — Skills 模式 + 人控建图 ✅ 已确认 2026-04-10
ADR-005 聊天框输入体验优化 — 历史/指令/联想 ✅ 已确认 2026-04-10
ADR-006 OMNI 多模态能力集成 — 图片/视频/音频 草案 2026-04-10
ADR-007 UI/UX Pro Max Skill 集成 Phase 1 完成 2026-04-10
ADR-008 Skills 渐进式披露 — 三层渐进 + priority 控制 ✅ 已确认 2026-04-10

详细开发日志见 Git history。ADR 文档记录所有架构决策。

Clone this wiki locally