项目级开发原则

提交与发布说明语言

• 所有新增 Git commit message（标题、正文、合并提交、自动提交、快照和备份说明）必须使用英文。标题采用 type(scope): description，说明具体变化；不得只写会话 ID、时间或“update/fix”。追溯信息放在英文正文中。
• 所有新增 release notes 的标题、分组和正文必须使用英文，以当前版本的 CHANGELOG.md 条目为唯一发布正文来源，不得用原始提交列表代替用户可读的变化说明。
• 发布前必须运行英文校验。含中文等非英文文字、缺失版本条目或空发布说明时停止提交/发布；不得跳过校验或删除原文来冒充翻译。历史 Git 记录不重写。
• 与用户的聊天、进度、报错解释和交付说明使用中文。提交和发布说明中的英文要求不改变对话语言。

提交身份

• 本项目所有新增提交的作者（Author）与提交者（Committer）统一使用 GitHub 账号 lsjwzh：lsjwzh <lsjwzh@gmail.com>，唯一配置来源为根目录 commit-policy.json。
• 自动提交、合并、初始提交、快照和备份使用同一身份；不得再使用 multicc@local、green@localhost 或其他临时身份，不得被继承的 Git 作者环境变量覆盖。
• Agent 手动提交也必须遵守该身份；合并与 CI 对新增提交同时校验作者和提交者，身份不符时停止操作。历史提交不重写，GitHub 推送认证与 Git 提交身份分别管理。

后端默认使用 Rust

自 2026-10-22 起，后续新增后端功能以及现有后端代码改进，默认必须使用 Rust；除非有明确的特殊场景，否则不允许继续用 Node.js 实现后端逻辑。最终方向是由 Rust 接管后端，Node.js 仅作为迁移期的兼容层。

• 新增或改进的业务逻辑、数据库读写、任务读模型、缓存、索引和计算逻辑，应在 Rust 中实现。不得仅因现有模块使用 JavaScript、开发方便或熟悉 Node.js 而扩大 Node.js 后端实现。
• Node.js 例外限于确有必要的场景，例如 Node/Electron 专属接口或 SDK 的适配、迁移期间必须保留的调用桥接，以及立即迁移会扩大风险的紧急缺陷修复。例外实现应保持最小范围，不得借桥接层承载新的业务核心。
• 使用例外时，必须在变更说明中写明具体原因、保留的 Node.js 范围及后续迁移条件；不因例外自动增加用户审批流程。
• Rust 通过现有原生模块接口或明确的进程协议接入；耗时计算和文件扫描应异步执行，避免阻塞 Node.js 主线程。
• 此原则不要求立即重写所有存量后端，也不授权直接切换尚未验证的生产逻辑。迁移须验证行为兼容和数据正确性；涉及性能收益时，应与同等优化的 Node.js 基线比较。
• 本原则约束后端产品逻辑；前端 JavaScript、Flutter 客户端及必要的测试、构建工具不因此被要求改用 Rust。测试和构建脚本不得成为绕过原则放置后端业务逻辑的入口。