北京
AI编程助手现在改代码的速度快得惊人。问题是，代码变了，代码库却常常跟不上节奏——文档落后实际行为，架构笔记过期，产品决策散落在聊天记录里。审查者能看到代码差异，却看不到背后变化的上下文。
Truthmark 1.4.0想解决的就是这个断层。它不是又一个AI模型，也不托管服务、不跑数据库、不加MCP服务器。它做的是把流程基础设施直接装进你的代码库，让AI在改代码的同时，把"真相"也同步更新。
这套系统有两层界面。给人用的是命令行：配置仓库、初始化流程、检查设置，几个命令搞定。给AI用的则是宿主原生的工作流界面——在Cursor里可能是技能，在Claude里可能是托管指令块，在VS Code里可能是项目代理。CLI负责准备仓库，AI界面负责运行时的实际工作。
默认流程很清晰：AI改功能代码→相关测试运行→Truth Sync检查映射的真相文档→必要时更新文档→人类审查代码差异+真相差异。关键不是造更多文档，而是让"更新真相"这件事变得难以跳过。AI交代码前必须检查映射的文档，如果需要改动，改动会以普通Git差异的形式呈现。
1.4.0版本新增了工作流验证器和写入代理。这对大型仓库尤其有用——单个代理的上下文窗口很快就会被塞满，验证器能帮它确认哪些真相文档确实需要更新，而不是盲目全扫一遍。
分支级别的真相管理是Truthmark的核心设计。真实仓库里，真相不是全局统一的：分支会分叉，架构改动分阶段推进，功能分支和主分支的产品行为可能不同。记忆工具能帮一个用户、一次会话，但没法自动给审查者一个已提交的、记录该分支当前"相信什么"的档案。Truthmark把这些路线文件、真相文档、生成的工作流界面和指令块都留在分支里，可以像其他项目文件一样审查、更新、回滚、合并。
技术实现上，Truthmark用TOML路线文件声明工作流，用Markdown写真相文档，用JSON Schema做验证。这些文件人类可读、可编辑，和代码走同样的审查流程。没有隐藏状态，没有外部依赖，审查者看到的就是实际运行的东西。
这个设计的潜台词很直接：AI编程的瓶颈已经不是写代码，而是写完之后怎么让人敢合并。当AI能在一小时内改完原本需要一周的代码，审查者面临的认知负载会爆炸。Truthmark试图把一部分负载转移给机器——不是让AI替人做决定，而是让AI把"为什么这样改"的结构化证据留在代码库里，供人检查。
当然，这要求团队真的愿意维护那些真相文档。如果路线文件本身变成没人管的垃圾，整个系统就失效了。Truthmark的赌注是：把真相文档变成普通Git文件，用同样的分支、审查、合并流程来管理，比依赖外部记忆工具或隐式提示工程更可持续。
目前支持Cursor、Claude Code、VS Code、GitHub Copilot等主流宿主，路线文件格式统一，宿主特定的生成界面自动处理。对于已经在用AI编程助手、但开始感到"改得快、审得累"的团队，这可能是个值得观察的方向。
特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
