Repository navigation
v0.9.8
黑板探索的完整性与恢复可靠性:让模型看到的图变化是真实的、断点续跑的执行身份是稳定的、
证据知道自己从哪来以及何时失效。默认行为保持兼容——不填新字段的旧意图、旧调用仍按原规则领取。
新增
- 真实变更流:新增任务内单调的事件日志(节点/边/锚点/发现/证据绑定/豁免/约束),
事务提交时按探索 ID 升序发布,回滚不出版;纯心跳/租约续期不制造事件。blackboard_view
带change_cursor(ev1:任务:epoch:序号),覆盖节点状态更新、边与删除,而不只是新增节点。
epoch 变化或历史缺段返回resync_required,跨任务游标明确拒绝,不会把「读不到」伪装成「没变化」。
旧after/next_cursor保留为节点新增窗口的 legacy 语义,新调用应改用change_cursor。 - 一致快照与完整性契约:黑板概览、常驻上下文、联合账本、收官审计与图体检都绑定同一
read-only repeatable-read 快照,不再混用不同时刻的缓存;查询、Scan、Rows.Err失败显式
返回 unknown,不把失败计成零。各窗口节返回complete / truncated、精确总数与样本数;
30 秒图体检缓存与账本的 500/2000 行、5 条示例截断不再冒充总数,依赖环按循环强连通分量统计。
启动恢复中ResetRunningIntents失败会让任务循环不启动并报出原因,纯警告也如实进日志。 - 稳定恢复身份与写权威:意图持久化
logical_session_id与单调execution_generation。
首次领取按现有槽位/每意图设置绑定,之后暂停、跨槽接手、连续重启都沿用同一会话;共享槽位
的 transcript 以逻辑会话互斥,不会被两条意图同时执行。事实、发现、战果、检测、续租、
语义结论、验证资产与终态结算都在同一事务里核对 state+owner+generation+session;旧代次晚到
的写入返回ErrStaleExecution,不落库、不计数、不发送成功通知。正常终态与验证资产、阻塞
原因改为同一事务结算;异步长任务回调携带提交时的代次,旧回调不能唤醒或回收新 run;
租约看门狗按代次回收与取消,旧控制句柄不能 detach 新 run。战果/检测/开局事实的节点、锚点
与血缘边改为同事务写入,不再留下无法归因的记录。 - 证据元信息与关系:
record_fact可选evidence_meta(稳定 claim_key、实际观察时间、
有效截止、方法、适用资产、类型化的 activity/execution/finding_binding 来源引用)。来源必须是
本任务或直接关联任务里真实存在的记录;未知时间不伪造。新增contradicts(对称矛盾)与
supersedes(新→旧替代)关系,端点必须是本任务事实、替代不能成环,原件都保留;矛盾/过期/
被替代只在读取时给标记,不自动判定漏洞真假或写 negative。凭据目标可带实际验证时间与有效
期限,历史verified不会被抹掉,也不会被伪装成刚验证过。 - 可选数据前置条件:
add_intent支持结构化requires[](事实/能力/凭据,AND),可引用
本任务节点或按明确 claim_key/enables 声明尚不存在的条件。Frontier、可领计数、普通/paused/
槽位领取与真正领取事务使用同一判定;缺条件时仍是候选方向并返回具体缺项,不误标负面结论。
能力条件只认正向事实;凭据要求实测时需指定目标并满足时效。不填requires的旧意图行为不变。 - 可读状态:节点详情、黑板概览、常驻上下文与
node_detail会显示证据状态(观察时间未知/
已过期/有矛盾/已被替代)、显式前提缺项、逻辑会话与执行代次;凭据继续只印指纹与脱敏目标。
迁移与部署注意
- 新进程的数据库连接声明
blade.writer_protocol=2,未声明的旧连接写入图会被数据库拒绝。
升级必须先排空旧进程,不能让新旧写入器混跑;升级前应备份数据库,降级到旧写协议版本
时不能只回滚二进制。 - 迁移期间以受控 GUC 关闭事件捕获;结构指纹变化会更新 epoch,历史只建立基线,不虚构过去事件。
子系统需实例独占锁后才迁移,避免旧实例仍在运行时改结构。 - 共享槽位 transcript、classic-hybrid/enhanced 的派单/覆盖/收官/发散规则均未改变;
requires只对明确填写的意图生效,不构成新的机械探索门。
验证
- 隔离 PostgreSQL 上新增回归:反序/跨任务提交、回滚与提前 flush 后写拒绝、旧写协议拒绝、
epoch/缺段/跨任务游标 resync、并发外部更新下的快照一致性与查询/Scan 错误传播、
2105 条线索与 505 个战果的精确总数、双次重启会话不漂移与同槽互斥、旧代事实/发现/续租/
语义/结算/控制句柄全部拒绝、条件在竞争更新后失效时领取重查、凭据历史验证与时效、
畸形 requires 安全阻断、战果血缘原子性。 - 功能提交的 CI 已通过 Go 全仓
go test -race、go vet、staticcheck、gofmt与govulncheck。 - 前端 TypeScript 检查、node 单测与静态构建通过;本地已完成黑板数据库迁移、任务重载及
/api/health和前端静态资源验证。