PAUL + BASE v2深度集成:知识图谱如何让项目状态可查询、可连接
PAUL + BASE v2深度集成:知识图谱如何让项目状态可查询、可连接
PAUL 是面向 Claude Code 的 Plan-Apply-Unify 循环开发框架,而 BASE v2 是它的"连接组织"——一个用 Rust 编写的主动式上下文引擎。两者深度集成后,PAUL 项目会成为 BASE v2 知识图谱中的一个节点:项目状态可查询、成本可归因、上下文可自动注入。本文带你理解这套机制如何工作,以及如何让旧项目快速接入。
为什么需要知识图谱集成
PAUL 本身就能独立工作:它在 .paul/ 目录中维护 STATE.md、PLAN.md 等文件,管理你的开发循环。但当你的工作区里有多个项目时,会冒出三个典型问题:
- 状态孤立:每个项目的进度散落在各自的 Markdown 文件里,无法跨项目查看
- 上下文缺失:换项目干活时,AI 不知道你在哪个领域、遵循什么规则
- 成本黑盒:AI 消耗的 token 花在了哪个项目、哪个阶段,完全无法追溯
BASE v2 通过知识图谱一次性解决这三个问题。它不是 MCP 服务器,也不需要 wrapper 脚本——就是一个 Rust 单二进制,base hook session-start 读入标准输入、写标准输出,常驻上下文成本接近于零。
集成核心:paul.toml 机器可读清单
PAUL v1.4+ 会在每个项目生成 .paul/paul.toml 清单文件,这是 BASE v2 扫描和解析的信号源,也是整个知识图谱的"身份证"。模板定义在 paul-toml.md 中,字段结构一目了然:
| 区块 | 记录内容 | 在图谱中的作用 |
|---|---|---|
| 身份区 | 项目名、版本、状态、路径、标签 | 生成 ops:Project 实体 |
[milestone] |
里程碑名称与阶段总数 | 计算完成百分比 |
[phase] |
当前阶段号与进度 | 节点连接点 |
[loop] |
循环位置(IDLE/PLAN/APPLY/UNIFY) | 实时状态查询 |
[stats] |
累计计划数、最后活动时间 | 健康度检查 |
关键设计点:tags 字段会转化为图谱中的 hasDomain 边。也就是说,你在 /paul:init 时打上的 laravel、api 等标签,会让 BASE 自动把对应领域规则注入到你这个项目里——无需手动配置。
这份清单由 PAUL 工作流在每次状态变化时自动同步,你不需要手动编辑。同步规则(读-改-写模式、字段更新矩阵)完整定义在 toml-sync.md 中。
四大集成能力:会话扫描、领域匹配、成本归因、规则注入
当 BASE v2 安装后,以下四件事会自动发生:
1️⃣ 会话开始时的全工作区扫描
BASE 在每次会话启动时扫描所有已注册工作区中的 .paul/paul.toml 文件,把项目状态摄取进知识图谱。你的所有 PAUL 项目从此"可查询"。
2️⃣ 零配置领域匹配
项目在 paul.toml 中的标签与 BASE 的领域(domains)相连。输入"work on casegate"时,BASE 通过图谱匹配自动触发该项目的正确规则,你什么都不用配置。
3️⃣ 成本精确归因
这是集成最有价值的部分。PAUL 为每个动作(plan、apply、unify 等)在 .paul/ledger.toml 中追加一条带时间戳的记录,模板见 ledger-toml.md。BASE 随后用时间戳匹配(timestamp-matching)把这些条目与 Claude Code 会话数据对齐,输出类似这样的归因结果:
Phase 2: 3 sessions · 1 day · $4.82 total
plan: 2 entries · $1.20
apply: 2 entries · $1.85
iteration: 1 entry · $0.92
账本是只追加、永不修改的审计轨迹——200 个计划的项目文件仅约 20KB,1000 个计划也不到 100KB,完全可控。
4️⃣ 按项目动态注入规则
PAUL 专属规则(循环强制、边界保护、验证要求)只在你处于 PAUL 项目时加载,离开项目即消失。这套动态加载由 CARL 机制实现,域清单定义在 PAUL.manifest 中,其中的 PAUL_RECALL 召回词让规则在相关话题出现时才被激活。
旧项目如何接入:一步迁移
如果你在用 v1.4 之前的 PAUL(paul.json 时代),有两种接入方式:
- 自动迁移:任意 PAUL 工作流触碰到旧项目时,会自动把
paul.json映射转换为paul.toml,字段级映射规则同样见 toml-sync.md 的 Pattern 3 - 显式注册:运行
/paul:register,该命令的完整流程定义在 register-manifest.md 工作流中,命令说明见 register.md
注册完成后,BASE v2 会在下次会话启动时自动检测到你的项目。若检测到 BASE v1(不再受支持)或未安装,PAUL 会给出提示但不影响独立运行——PAUL 依然照常追踪状态、强制执行循环、管理计划。
总结:无 BASE 与有 BASE 的差别
| 维度 | 仅 PAUL | PAUL + BASE v2 |
|---|---|---|
| 状态追踪 | ✅ 单项目内 | ✅ 跨工作区图谱化 |
| 循环强制 | ✅ | ✅ |
| 上下文注入 | 手动 | ✅ 领域匹配自动注入 |
| 成本归因 | ❌ | ✅ 按项目/阶段/计划 |
| 规则加载 | 静态 | ✅ 按项目动态注入 |
简单说:没有 BASE,PAUL 是一个可靠的单兵;加上 BASE v2,每个项目都变成了知识图谱里一个可查询、可连接、成本透明的节点。对于同时维护多个项目的开发者,这种"连接组织"正是 Agentic OS 生态的核心价值所在。
