Paperclip 入门：用组织结构管理 AI Agent 团队
Paperclip 源码阅读：审批状态与预算决策
沿两处服务逻辑核对界面上展示的治理承诺。
Paperclip 源码阅读：审批状态与预算决策知识学习CN编辑简报更新 2026-09-26
你将学会
- 审批有合法的状态转移
- 预算观察按范围计算
- 追踪一次完整决策
开始前需要
- Node.js 与 Agent 运行环境基础
- 不含敏感资料的测试公司
把源码阅读转成有边界、有退出条件的团队实验。
先看结论
- 审批包含状态与操作者。
- 预算范围和时间窗口会改变结果。
- 源码阅读不等于端到端安全审计。
审批有合法的状态转移
已检查的 approvals 服务只允许从待审批或要求修改状态作出批准或驳回。内置 Agent 获批后，还可能与保存的配置进行协调。接入真实董事会前要看事务路径和错误处理。
审稿人身份和决定备注与状态值一样重要。在本地测试中试一遍拒绝、重复批准，观察最终保留哪些事件。
预算观察按范围计算
budgets 服务按策略时间窗口计算已观察到的花费，并区分提醒和硬停机。源码包含暂停作用域、取消排队任务的处理路径。
这能证明存在执行逻辑，却不能证明所有外部服务商账单都及时完整。把成本事件与服务商账单对照后，才能把额度当作财务控制。
追踪一次完整决策
从接口请求找到服务函数、数据库更新和审计事件。测试时保留公司与操作人编号，不要只凭界面文案就修改服务代码。
本次仅检查了固定提交中的两份服务文件，没有穷尽其他路由、适配器与认证中间件，也没有进行端到端审计。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
找到 resolveApproval 的允许状态。
- 2
找到 budgetStatusFromObserved 和硬停机路径。
- 3
设计重复审批与迟到成本事件的测试。
可复制示例
typescript
// Source-reading map, not executable application code
resolveApproval(id, actor, decision)
budgetStatusFromObserved(spend, amount, warningPercent)常见问题
硬停机能保证绝不超支吗？
不能。还要核对成本事件时效和服务商账单。
任何董事会成员都能批准吗？
需在部署版本验证路由授权和成员规则。
资料来源
- Paperclip / server/src/services/approvals.ts来源核查 2026-09-26
- Paperclip / server/src/services/budgets.ts来源核查 2026-09-26