本地优先的 AI 项目管理，意味着耐久的项目记录始终保存在你控制的文件中，并与它所描述的代码放在一起。路线图、决策、交接和执行证据，不应因为某个 Dashboard 离线或供应商账号变化而消失。
它并不意味着 Coding Agent 模型、包管理、应用市场和可选协作功能全部离线运行。
哪些内容应该留在本地？
对于 AI 构建的软件项目，应把这些长期资产保存在工作区：
- 路线图和里程碑状态；
- 项目规则与聚焦的设计文档；
- 已接受决策及理由；
- 运行摘要与会话交接；
- 验证证据与稳定身份；
- 只对当前项目成立的可复用经验。
这些资产能让新会话理解当前事实，而不需要上传整个仓库或重放私人聊天。
为什么可检查格式很重要？
本地数据库可以提升搜索和性能，但不应成为关键项目状态的唯一副本。人类可读文件带来：
- Git 历史；
- 普通备份和迁移；
- 不同 Coding Agent 都能读取；
- 工具故障时仍可人工检查；
- 离开产品的清晰路径。
Ink & Switch 的经典本地优先论文把所有权、长期保存、隐私、离线工作和用户控制视为一组相互连接的设计理想：Local-first software。
本地优先不等于只用本地
实用产品可以使用云服务，同时让权威留在本地。
云服务可以提供：
- 模型推理；
- 源码托管与 CI；
- Issue 和 Release 信号；
- 可选的端到端加密远程控制；
- 分发与账号权益。
真正的边界是：云端副本是否悄悄变成了唯一权威。如果服务消失，你还能否打开项目、理解路线图、检查过去决策，并换一个工具继续工作？
避免重复真相
如果同一个状态可以在多个地方编辑，本地优先也会变得混乱。需要明确归属：
- 本地路线图负责项目推进状态；
- Git 负责代码历史；
- Issue Tracker 负责外部问题；
- CI 负责构建证据；
- Release 负责已交付版本。
其他界面可以展示投影，但不应创造冲突状态。
两类工具怎么选？
这些情况适合本地优先路线图驾驶舱：
- 一个人主要在本地仓库里工作；
- 需要跨 Coding Agent 会话保持连续性；
- 工作要与代码和证据直接连接；
- 重视数据归属和工具可迁移性。
这些情况适合通用云端任务管理：
- 多人需要共享规划和权限；
- 组织级汇报是首要工作；
- 工作范围远超本地软件项目；
- 实时协作高于仓库邻近性。
只要职责明确，两者也可以共存。
本地优先审计问题
可以逐项询问：
- 没有供应商 Dashboard 时，项目还能继续吗？
- 另一种 Agent 能读到耐久状态吗？
- 文件和格式有明确说明吗？
- 索引和缓存可以重建吗？
- 可选同步是否少于完整项目内容？
- 冲突发生后，本地状态是否仍是权威？
- 网络失败是否不会抹掉过去成果？
本地优先不保证什么？
本地存储本身不自动保证隐私、安全、备份或良好工作流。本地应用仍可能泄漏 Secret、丢数据或创建不透明文件。用户仍需要设备加密、备份、谨慎的凭据管理和透明格式。
本地优先是一种所有权模型，不是一个魔法形容词。
核心原则
把项目连续性留在工作发生的地方。云服务负责提供能力，但不应成为路线图、决策和 Agent 历史唯一能存活的地方。