开源Eva软件工厂：用JSONL流水账代替写代码
内容提要
Eva是一个开源终端聊天工具，自称“软件工厂”，但当前无文件或shell操作能力。其核心设计是事件溯源：所有问答、重试、Token用量先写入本地JSONL文件，屏幕仅作为视图。项目强调可复核性、配置隔离和严格代码规范，为未来工具扩展奠定数据结构基础，体现了“先写后显”的AI编程新思路。
延伸解读
事件溯源：屏幕不再是唯一真相
Eva 将每次问答、重试和 Token 用量先写入 JSONL 文件，终端界面只是读取并显示这份记录。这种“先写后显”的设计让可复核性成为默认属性，脚本和审计可以直接消费同一份数据，而不依赖瞬时屏幕输出。对于需要自动化或合规追踪的场景，这种数据模型可能比传统日志更有优势。
配置隔离的“多租户”
Eva 的“多租户”并非传统服务器概念，而是通过配置作用域实现：仓库级配置只能影响配色和快捷键，无法改变其他设置；认证信息通过独立登录流程管理，密钥不会出现在配置或日志中。这种设计在本地工具中实现了不同项目、不同用户之间的隔离，为未来多用户协作或自动化流水线奠定了基础。
先定规则，再补工具
Eva 在尚无文件或 shell 操作能力时，已通过架构决策记录、注释预算、依赖分层等规则约束代码演进。这种“先建规范，后加功能”的顺序，体现了工厂式思维：数据结构先行，工具后补。对于 AI 编程工具而言，这或许是一种值得关注的开发策略，确保未来扩展时不会因技术债而失控。
Q&A
Eva是什么？它目前能做什么？
Eva是一个开源的终端聊天工具，由Missing Studio在2026年8月发布，自称“软件工厂”。目前它只是一个终端聊天客户端，不能读取文件、运行测试或操作终端，没有任何工具能力。
Eva的核心设计理念是什么？
Eva的核心设计理念是“先写后显”，即所有问答、重试、Token用量等事件先写入本地JSONL文件，屏幕只是读取并显示这些记录。这确保了数据的可追溯性和可复核性。
Eva的Trace文件有什么特点？
Eva的Trace文件是JSONL格式，记录每个事件，包含运行ID、会话ID、父级关联、序号等信息。缓存读取和写入的Token分开保存，未报告字段保持未报告状态。脚本可以消费这些数据，用于审计和成本分析。
Eva的多租户是什么意思？
Eva的多租户并非传统意义上的服务器多租户，而是指配置作用域的隔离。通过eva init生成用户级配置，仓库级配置只能共享配色和快捷键，且受允许列表限制。认证信息也隔离，API密钥不会出现在设置或日志中。
Eva的代码规范有哪些？
Eva的代码规范包括：使用depguard强制层间依赖，文档和注释使用简化技术英语，注释块不超过六行，注释占比有阈值，测试运行竞态检测器，以及书面化的决策记录。
Eva为什么自称“软件工厂”？
Eva自称“软件工厂”是因为它虽然目前没有工具，但已经建立了为未来工具扩展而设计的基础设施，如事件溯源Trace文件、严格分层架构、决策记录和量化代码规范。这体现了工厂式的思维，先定规则再实现功能。
