PAUL + BASE v2深度集成:知识图谱如何让项目状态可查询、可连接

原创2026-10-13 18:10:591,673 阅读

PAUL + BASE v2深度集成:知识图谱如何让项目状态可查询、可连接

PAUL 是面向 Claude Code 的 Plan-Apply-Unify 循环开发框架,而 BASE v2 是它的"连接组织"——一个用 Rust 编写的主动式上下文引擎。两者深度集成后,PAUL 项目会成为 BASE v2 知识图谱中的一个节点:项目状态可查询、成本可归因、上下文可自动注入。本文带你理解这套机制如何工作,以及如何让旧项目快速接入。

PAUL 框架终端安装截图:展示 npx paul-framework 安装命令与 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 生态的核心价值所在。

登录后查看全文
paul