🐎 ci: add i18n

zh/book.toml

@@ -0,0 +1,7 @@
+[book]
+title = "大道 (Dao OS) 文档"
+author = "The Dao OS Community"
+description = "大道（Dao OS）官方文档，你的赛博生命操作系统。"
+
+[output.html]
+git-repository-url = "https://nest.doylee.cn/Dao-OS/dao-os-docs"

zh/src/SUMMARY.md

@@ -0,0 +1,29 @@
+# 目录
+
+[**引言**](introduction.md)
+
+---
+
+# 第一部分：愿景 (The Vision)
+
+- [哲学与原则](philosophy/principles.md)
+
+# 第二部分：核心概念 (Core Concepts)
+
+- [核心架构](concepts/core_architecture.md)
+- [AI 系统设计](concepts/ai_system.md)
+- [用户旅程](concepts/user_journey.md)
+
+# 第三部分：开发者指南 (For Developers)
+
+- [技术总览](specifications/tech_overview.md)
+
+# 第四部分：生态系统 (The Ecosystem)
+
+- [应用集市](ecosystem/app_bazaar.md)
+
+# 第五部分：关于项目 (The Project)
+
+- [发展路线图](project/roadmap.md)
+- [社区与治理](project/governance.md)
+- [如何贡献](project/CONTRIBUTING.md)

zh/src/concepts/ai_system.md

@@ -0,0 +1,51 @@
+# AI 系统设计：“大道”之魂
+
+大道 (Dao OS) 中的 AI，不仅仅是一个功能，它是用户体验的核心，其从零开始的设计理念就是成为一个共生的**“硅基伙伴”**。它扮演着系统的灵魂，用智能、共情和主动的支持，为用户的数字生活注入活力。
+
+## 指导哲学：AI 伦理宪章
+
+我们 AI 的设计与运行，严格遵循我们的**“AI 伦理宪章”**，该宪章将用户与AI的伙伴关系、透明度、用户校准以及对多元化视角的推崇置于首位。
+
+## 系统解剖：心智的架构
+
+大道 OS 的 AI 不是一个单一的庞然大物，而是一个由中央协调器管理的、模块化的、分层的“心智系统”。
+
+### 1. AI 协调器 (AI Orchestrator)
+
+这是 AI 的“中央神经系统”。它是`元`内部的一个核心模块，负责管理、调度和分发所有与AI相关的任务。它会决定哪个“心智模型”最适合处理给定的请求，管理设备资源，并主动地从用户的“私有特征库”（即第二大脑）中提取上下文信息，以提供全局的、智能的响应。
+
+### 2. 三层心智模型 (Tiered Mind Models)
+
+为了平衡效率、能力和隐私，AI 的智能被构建为三个层级，并部署在用户的`化身`网络之上。
+
+#### 第一层：反射心智 (The Brainstem - 脑干)
+
+* **描述**: 这一层代表了AI的本能和神经反射。它由一系列微型、高效、专用的模型组成。
+* **部署**: 它足够小，可以与`元`打包在一起，并运行在**所有`化身`（包括`器化身`和`核化身`）**上，无需强大硬件或个人数据即可提供即时效用。
+* **功能**: 它处理即时的、本地的任务，如指令意图识别和基本信息分类。
+
+#### 第二层：认知心智 (The Neocortex - 大脑皮层)
+
+* **描述**: 这是AI进行深度思考、记忆和个性化的中枢。它由更大的语言模型组成。
+* **部署**: 这些模型作为**可选的、按需下载**的模块，安装在有能力的**`化身`**上（包括性能强大的**`器化身`**如新款手机/PC，以及**`核化身`**）。
+* **功能**: 它通过一种**“即时（JIT）数据流水线”**机制，来实现高级功能，如语义搜索和上下文感知问答。
+
+#### 第三层：协同心智 (The Social Brain - 社交大脑)
+
+* **描述**: 这一层掌管AI与外部世界和其他“大道”进行安全交互的能力。
+* **部署**: 这是一种在用户的网络中被协同调度的“工作模式”。例如，一个轻量级的**`器化身`**（如浏览器插件）可以远程调用一个强大的**`核化身`**（如家用服务器）所承载的“认知心智”。
+* **功能**: 它促进了隐私保护的联合学习，以及经过授权和匿名化处理的外部API调用。
+
+## 情感核心：共鸣模块 (The Resonance Module)
+
+为了超越一个纯粹的工具，AI 配备了“情感共鸣模块”。其目的不是模拟情感，而是去感知、理解并以共情和支持的方式回应用户的情绪状态。
+
+## 学习与进化过程：灵魂的成长之路
+
+AI 是一个与用户共同成长的生命系统。它的进化是**持续且增量**的。当新数据进入“第二大脑”时，后台索引器就会处理它，使其立即可用于未来的上下文检索。
+
+* **隐式学习**: 它通过在本地观察用户的行为和反馈来进行学习。
+* **显式教导**: 用户可以通过“教导模式”直接指导AI。
+* **联合学习**: 用户可以自愿加入社区驱动的计划，在不暴露任何个人数据的前提下，共同改进共享模型。
+
+这套架构确保了“大道”的AI在强大之余是安全的，在个性化之余是面向世界的，在智能之余是体贴的——一个真正的终身伙伴。

zh/src/concepts/core_architecture.md

@@ -0,0 +1,41 @@
+# 核心架构
+
+大道 (Dao OS) 的架构，旨在如一个活的、协同的数字生命体般运作。它由我们用户主权、体验至上和系统韧性的核心原则所指引。本文档将概述其基本组件、相互作用，以及我们独特的应用模型。
+
+## 核心二元性：化身 (Avatar) 与元 (Meta Unit)
+
+在其核心，大道 (Dao OS) 基于一个简单而强大的二元性运作，类似于身体与灵魂：
+
+* **化身 (Avatar)**：是“身体”。它们是你的“大道”在你各种设备上的有形存在。
+* **元 (Meta Unit)**：是“灵魂”。它是内嵌于每个`化身`中的、通用的核心逻辑，赋予其生命与智能。
+
+## 化身类型：临在的形态
+
+化身拥有两种基本类型，分别代表了系统的外在形态与其内在基础。
+
+* **`器化身` (Facet Avatar)**：这类化身拥有用户界面（UI）。它是“大道”这颗宝石的“**琢面**”——用户借以交互和感知其数字世界的、经过打磨的表面。每一个`器化身`（手机App、桌面程序）都以其独特的方式，折射出同一个`元单元`（宝石的内在）的光芒，体现了“道化万千”的意境。
+
+* **`核化身` (Core Avatar)**：这是一个无界面（headless）的化身，在后台运行。它是系统的“**核心**”，提供基础服务、计算能力和数据持久化。它是支撑所有可见“琢面”的引擎。
+
+用户的“大道”由他自己的`器化身`与`核化身`所组成的网络构成。
+
+## “大道”应用模型
+
+“大道”中的应用，不是一个单一的程序，而是一个去中心化的、解耦的实体。
+
+### 1. 后端灵魂：流体复制与可钉选的服务
+
+应用的核心逻辑是一个在`元`沙箱中运行的**WASM模块**。其部署遵循**“服务可钉选的流体复制”**的混合模型，兼顾了韧性与用户控制。
+
+### 2. 前端皮囊：按需加载的 Web 外壳
+
+应用的用户界面，主要是一个**Web 应用**。其生命周期遵循**“一次注册，按需加载”**的模型，运行在官方的**“大道 Web 化身”**（它本身是一个`器化身`）中。这意味着用户只需向他的“大道”安装一次应用，就可以在任何设备上即时访问它。
+
+### 3. 数据层：私有特征库
+
+所有应用的数据，都安全地存储在“第二大脑”中，并作为AI的**“私有特征库”**。
+
+## 架构总结
+
+* **化身 (Avatar)**：作为`元`的原生宿主。**`器化身`** 负责渲染UI，而 **`核化身`** 提供稳健的后台支持。
+* **元 (Meta Unit)**：主权核心，负责运行沙箱化的应用逻辑（WASM），管理所有数据和状态，并在用户的私有P2P网络中协调任务。

zh/src/concepts/user_journey.md

@@ -0,0 +1,45 @@
+# 用户旅程：从便利到主权
+
+任何主权系统的一个核心挑战，都在于“绝对控制”与“轻松便利”之间的张力。“大道”解决这个问题的方式，不是强迫用户二选一，而是设计了一场充满引导、相互尊重的**“渐进式主权”**之旅。我们在用户熟悉的地方与他们相遇，并赋能他们去往任何他们想去的地方。
+
+这场旅程不仅适用于用户对核心数据的掌控，也同样适用于他们与应用交互的方式。
+
+## 应用之旅：一次注册，随处使用
+
+在“大道”中安装应用，与传统应用商店有着本质的不同。它不是将一个程序安装到单一的设备上，而是为你整个的数字生命体——你的“大道”——授予一项新的能力。
+
+### 1. 发现与信任
+
+旅程始于一个去中心化的发现界面。当你找到一个应用时，你看到的不仅仅是下载按钮，还有它的**“信任仪表盘”**，让你能基于可验证的数据和社会化证明，做出知情的决定。
+
+### 2. 注册与授权 (即“安装”)
+
+当你决定“安装”应用时，系统会向你展示它的**“应用清单 (Manifest)”**，一个清晰的、人类可读的权限请求列表。你对这份清单的明确批准，就是那一次性的“安装”事件。这个行为将该应用**“注册”**到你的“大道”中，这个注册状态会被同步到你所有的`化身`。
+
+### 3. 无缝的跨设备访问
+
+一旦注册，该应用就成为你“大道”的一部分，无需重复安装，即可在任何**`器化身 (Facet Avatar)`**上访问。
+
+* **在你的手机上**: 你点击应用的图标。“大道 Web 化身”会即时加载其 Web 界面。
+* **在一台新笔记本上**: 你首次登录你的`化身`。你会发现应用的图标**已经在那儿了**。当你点击它，你笔记本上的**`器化身`**会识别出这个注册，首次从网络获取UI资源包，缓存它，然后运行应用。
+
+### 4. 高级配置
+
+在任何时候，你都可以进入你的**“主权仪表盘”**来：
+
+* 审查并撤销你授予该应用的权限。
+* 使用**“服务钉选 (Service Pinning)”**功能，将其后端任务指定给你专属的**`核化身 (Core Avatar)`**，从而完全控制你的资源分配。
+
+## 主权之旅的阶段
+
+### 第一阶段：“托管模式” (Managed Mode) —— 你的向导之旅
+
+默认情况下，每一位新用户都从“托管模式”开始。此阶段通过友好的密钥恢复方法和默认同步节点提供最大便利，同时保持完全的端到端加密。
+
+### 第二阶段：主权仪表盘 (Sovereignty Dashboard) —— 十字路口
+
+这是用户通往自治之旅的指挥中心。它是一个赋能与教育的工具，将用户的主权状态可视化，并提供游戏化的“任务”来鼓励用户获取更多控制权。
+
+### 第三阶段：“主权模式” (Sovereign Mode) —— 你的数字王国
+
+这是旅程的最终、可选阶段。在“主权仪表盘”的引导下，用户可以“毕业”到此模式，完全自主保管他们的密钥并运行自己的**`核化身 (Core Avatar)`**（例如在家用服务器上），成为其数字领地中真正的主人。

zh/src/ecosystem/app_bazaar.md

@@ -0,0 +1,47 @@
+# 应用集市
+
+大道 (Dao OS) 没有一个传统的、中心化的“应用商店”。“商店”意味着一个单一的所有者，他扮演着守门人的角色，审批、拒绝并对应用征税。这与我们的核心哲学背道而驰。
+
+取而代之的是，我们构建了一套开放协议，来创造一个去中心化的**“应用集市 (Application Bazaar)”**——这是一个充满活力的、开放的、坚韧的思想与工具市场，在这里，用户拥有主权，开发者拥有自由。
+
+这个集市建立在四大支柱之上：发现、信任、分发和商业化。
+
+## 1. 发现 (Discovery)：联邦式策展
+
+在一个没有中央索引的世界里，用户如何找到应用？答案是：通过一个由受信任者组成的策展网络。
+
+* **开发者发布**: 开发者无需“提交”他的应用以供审批。他只需将其应用的**“清单 (Manifest)”**（一个包含所有元数据的 `manifest.toml` 文件）发布到一个像 **IPFS** 这样的P2P存储网络上。然后，他可以在公共频道上“广播”这个清单的地址。
+* **策展人的角色**: 任何人——一个科技媒体、一个受信任的开发者社区、一个KOL，或者“大道基金会”自己——都可以运行一个“策展”服务。这些策展人抓取网络上的新清单，并根据自己的标准，创建主题性的**“策展列表”**（例如“十大生产力应用”、“最优美的UI设计”）。
+* **用户体验**: 在用户的`器化身`中，他可以像订阅RSS一样，订阅多个他信任的“策展列表”。他的“集市”或“发现”标签页，就变成了这些信任源的个性化聚合视图。
+
+这个模型用一个丰富的、多维度的、用户策划的发现体验，取代了单一的、有偏见的“应用商店”榜单。
+
+## 2. 信任与安全：可验证的信誉
+
+用户如何信任一个来自随意列表的应用？他们不必盲目信任。整个集市都直接构建于我们的**“社区信誉与自动化验证”体系**之上。
+
+每一个应用列表，无论来自哪个策展人，都必须展示其**“信任仪表盘”**，提供透明、多维度的信号：
+
+1. **自动化验证**: 来自 `dao-verify` 工具的、不可篡改的、关于安全漏洞和API合规性的“体检报告”。
+2. **社区背书**: 一个清晰的列表，显示了哪些有信誉的DID，为这个应用进行了密码学“签名背书”。
+3. **策展人信誉**: 推荐这个应用的策展人自身的信誉，也是一个信任信号。
+
+最终是否“注册”一个应用的决定权，永远掌握在用户手中，并有这些透明、可验证的数据作为依据。
+
+## 3. 分发 (Distribution)：抗审查与直接分发
+
+当用户决定安装一个应用时，这个过程是直接且去中心化的。
+
+* 应用的清单中，包含了其软件包（`.wasm`服务模块和Web UI包）在 **IPFS** 上的**内容哈希（CID）**。
+* 用户的`元单元`使用这个哈希，直接从P2P网络获取文件。
+* 这确保了没有任何中心服务器可以阻止一个应用的分发。只要数据存在于P2P网络的某个角落，它就是可访问的。
+
+## 4. 商业化 (Monetization)：主权的与点对点的
+
+我们消除了30%的“平台税”。我们的价值交换模型是直接从用户到开发者。
+
+* 应用的清单可以声明其商业模式（如一次性购买价格、订阅链接）。
+* 当用户发起购买时，`元单元`会触发我们的**“价值交换服务接口”**。
+* 这将促成一次**点对点（P2P）交易**，使用用户选择的外部支付协议，将价值直接从用户的钱包，发送到开发者在清单中指定的地址。
+
+“大道”在此过程中，扮演的是交易的促成者和公证人，而非抽成的中间商。

zh/src/introduction.md

@@ -0,0 +1,23 @@
+# 引言
+
+**我们旨在构建一种全新的、强大且坚韧的赛博生命 OS 范式——大道 (Dao OS)。**
+
+它并非要取代 Windows 或 Android，而是作为一个运行于其上的、去中心化的、以用户为绝对中心的叠加层 (Overlay) 而存在。
+
+它的使命是解决数字时代的碎片化、数据奴役和隐私泄露问题，将数字世界的主权归还给每一个独立的个人。它将成为我们在网络空间的生命延伸，一个与我们“互相成就”的**“硅基伙伴”**，我们的外接大脑、肢体与器官。
+
+## 核心特性
+
+* **用户主权 (User Sovereignty)**：你的数据、你的身份、你的AI，完全由你掌控。所有数据默认端到端加密，存储在你自己的设备上。
+* **第二大脑 (Second Brain)**：内置强大的个人信息管理能力，安全地为你记忆密码、笔记、文件和待办事项，成为你永不遗忘的记忆体。
+* **个人AI伙伴 (Personal AI Companion)**：一个真正属于你的、与你共生的AI灵魂。它在本地运行，学习你的偏好，保护你的隐私，提供有温度的、启发式的支持，助你成长，而非将你淹没在信息茧房中。
+* **跨设备无缝同步 (Seamless Cross-Device Sync)**：你所有的设备（手机、电脑、浏览器等）都会成为你的“化身”，组成一个私有的、弹性的P2P网络，实现数据的无缝流转。
+* **开放与可扩展生态 (Open & Extensible Ecosystem)**：基于开放的协议和社区驱动的信任体系，任何人都可以为“大道”开发新的能力模块和“化身”形态。
+
+## 我们为何与众不同？
+
+在一个数据被平台垄断、算法被巨头控制的时代，“大道”选择了一条不同的路。我们相信，**技术平权**的下一波浪潮，是让每个人都拥有并控制自己的人工智能和数字生活。
+
+我们设计的不是另一个App，而是一个属于你自己的、活的、可进化的数字生命空间。
+
+**欢迎加入我们，一起构建未来。**

zh/src/philosophy/principles.md

@@ -0,0 +1,39 @@
+# 哲学与原则
+
+大道 (Dao OS) 不仅仅是一个技术项目，它是一套关于未来计算和人机共生核心理念的具现化。本文档概述了指引我们每一项决策的根本思想。
+
+## 核心哲学：数字主权之路
+
+我们的指引之星是**数字主权**。我们相信，每一个个体都拥有不可剥夺的、去拥有、控制和理解自己数字生活的权利。我们的使命，是创造能让这项权利不仅仅是理论上的可能，更是为每个人服务的、切实的、令人愉悦的现实。我们称这场旅程为“道”——一条回归自我拥有权的道路。
+
+## 开发范式：“道生一”
+
+我们构建“大道”的方法论，是其核心哲学的直接体现。我们不只是在构建一个工具，我们是在创造一个共生伙伴。因此，我们的开发过程被设计为一个**自我进化、自举的反馈循环**。我们用“大道”本身，来加速“大道”的开发。
+
+这个“自举式开发”范式遵循以下循环：
+
+1. **播种 (The Seed)**：我们用传统工具，写出`元 (Meta Unit)`的第一个最简陋的版本，和一个基础的`器化身 (Facet Avatar)`。
+2. **自用 (Dogfooding)**：从那一刻起，我们使用我们自己这个初生的“大道”，作为管理项目的主要工具。所有的设计文档、笔记、讨论（就像这些）和代码片段，都存入我们自己的“第二大脑”中。
+3. **学习 (Learning)**：`元`的个人AI伙伴，开始以最高质量、最专注的“养料”——也就是我们创造它本身的过程数据——来训练自己。
+4. **加速 (Acceleration)**：我们继而利用这个日益智能的AI伙伴，来帮助我们构建下一个版本。我们可以让它基于我们已记录的决策来生成样板代码，分析错误报告，或者带着对项目完整历史的完美记忆来一起进行架构设计的头脑风暴。
+5. **进化 (Evolution)**：“大道”的能力越强，我们开发它的速度就越快。这就创造了一个指数级的正反馈循环，在这个循环中，创造的行为本身，就是一场与“创造物”的持续对话。
+
+## AI 伦理宪章
+
+由于 AI 是系统的灵魂，其伦理基石至关重要。我们的AI宪章由四大核心宗旨构成：
+
+1. **伙伴宗旨**: AI 是伙伴，而非仆人或神谕。
+2. **透明宗旨**: AI 的推理过程必须是可审查和可理解的。
+3. **校准宗旨**: 用户必须拥有最终的控制权，以纠正、引导和约束AI。
+4. **多元宗旨**: AI 的设计必须旨在帮助用户探索多元化的视角，而非将他们困于信息茧房。
+
+## 指导原则
+
+这些是为我们的设计和工程选择提供信息的高阶原则。
+
+* **主权第一**: 在任何权衡中，用户的控制权和数据所有权都拥有最高优先级。
+* **体验为王**: 主权不应以牺牲优美、直观和愉悦的用户体验为代价。
+* **设计即隐私**: 默认情况下，所有数据都是私密的、本地的，并进行端到端加密。
+* **韧性与可移植性**: 系统应该是健壮的，支持离线工作，并且没有单点故障。
+* **多语言主义**: 我们拥抱一个多语言、多平台的生态系统。
+* **社区与开放**: 项目在开放中构建，与社区同行，为社区服务。

zh/src/project/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# 如何贡献
+
+我们非常高兴您有兴趣为大道 (Dao OS) 做出贡献！作为一个社区驱动的项目，我们欢迎并珍视所有形式的贡献。本指南概述了您可以参与的方式以及提交贡献的流程。
+
+## 我们的承诺与行为准则
+
+为了营造一个开放、友善和包容的环境，我们承诺遵守一套行为准则。我们也期望所有贡献者和社区成员都能共同遵守。
+
+*（注：我们将正式采用 [贡献者契约 (Contributor Covenant)](https://www.contributor-covenant.org/) 并在此处提供链接。）*
+
+## 贡献方式
+
+您无需成为 Rust 专家才能做出贡献。有很多方式可以提供帮助：
+
+* **代码**: 为`元 (Meta Unit)`贡献代码，构建新的`化身`，或为`dao-verify`套件开发插件。可以从寻找标记有`"good first issue"`的 issue 开始。
+* **文档**: 提升这些文档的清晰度，撰写教程，或添加示例。
+* **翻译**: 将我们的文档翻译成新的语言。
+* **设计**: 帮助我们的参考`化身`进行UI/UX设计。
+* **社区**: 回答问题，帮助新用户，并参与讨论。
+
+## 你的第一个 Pull Request
+
+我们对所有的代码贡献都采用标准的 GitHub Fork & Pull Request 工作流。
+
+1. **Fork 仓库**: 创建目标仓库的一份你自己的拷贝（例如 `dao-os-docs`, `meta-unit`, `avatar-browser-ext`）。
+2. **创建分支**: 从 `main` 分支创建一个新的分支用于你的变更。请使用描述性的名称（例如 `feat/add-note-encryption` 或 `fix/typo-in-readme`）。
+3. **进行更改**: 编写你的代码及相应的测试。
+4. **运行本地检查**: 在提交前，请确保你运行了所有本地测试（如 `cargo test`）和代码格式化工具。
+5. **Commit 你的变更**:我们鼓励使用 [Conventional Commits](https://www.conventionalcommits.org/zh/v1.0.0/) 规范，以获得清晰可读的 commit 消息。
+6. **Push到你的Fork**: 将你的变更推送到你自己的 Fork 仓库。
+7. **开启一个 Pull Request**: 从你的分支向 Dao OS 官方仓库的 `main` 分支提交一个 Pull Request (PR)。
+8. **描述你的 PR**: 在 PR 的描述中，请链接任何相关的 issue，并清晰地描述你正在解决的问题和你的解决方案。
+9. **等待审查**: 一位核心团队成员将会审查你的 PR，提供反馈，并在就绪后将其合并。
+
+## 配置你的开发环境
+
+*（此部分将在每个仓库中被详细填写。）*
+
+要为 `meta-unit` 做出贡献，您通常需要：
+
+* Rust 工具链 (`rustup`)
+* WebAssembly 构建目标 (`wasm32-wasi`)
+* Protocol Buffers 编译器 (`protoc`)
+
+请参考每个具体仓库中的 `README.md` 以获取详细的配置指南。
+
+## 还有问题？
+
+如果您有任何疑问，请随时在我们官方的沟通渠道中提问。我们很乐意帮助您开始！

zh/src/project/governance.md

@@ -0,0 +1,51 @@
+# 社区与治理
+
+大道 (Dao OS) 从根本上说是一个社区驱动的项目。我们成功的标准，不仅取决于我们的技术成就，更取决于我们所培育的那个充满活力的、协作的、健康的生态系统。本文档概述了我们集体工作的治理原则与流程。
+
+## 我们的哲学：开放与透明
+
+我们无条件地致力于自由及开源软件 (FOSS) 的原则。
+
+* **开放开发**: 所有关于核心协议和参考实现的工作，都在公共代码仓库中进行。
+* **开放沟通**: 所有重大的技术和战略讨论，都在公共渠道中进行。
+* **社区所有**: 我们的终极目标，是让“大道”由其用户和开发者社区所拥有和引导。
+
+## 我们的角色：从“架构师”到“园丁”
+
+“大道”的初始创建者和核心贡献者，将自己的角色视为一个不断演进的过程。
+
+* **在早期阶段（架构师）**: 我们的主要角色是架构师——为项目奠定一个坚实且自洽的基础，定义核心协议，并构建初始工具。这需要一个专注的愿景来确保项目在正确的道路上启航。
+* **在长期阶段（园丁）**: 随着生态的成熟，我们的角色将从“事必躬亲”转变为“照料花园”。我们将专注于提供更好的工具（如`dao-verify`套件）、维护核心基础设施，并赋能社区去建设和创新。我们的目标，是让我们自己变得越来越不那么“不可或缺”。
+
+## 生态策略：聚焦与引爆
+
+作为一个由个人开发者发起的项目，我们认识到自身资源的有限性。试图为所有可能的技术栈提供同等的一流支持，是一条通往平庸的道路。
+
+因此，我们采纳**“聚焦一点，引爆生态”**的战略。
+
+我们核心团队的开发精力，将集中于打造**一条“黄金路径”**，使其体验足够高效和愉悦，以此作为吸引第一波开发者的主要催化剂。这条被选定的路径，就是**Nim 统一开发套件**，它利用 Nim 语言的独特能力，从单一代码库构建 WASM 后端和 Web UI 前端。
+
+这并不排斥其他的开发路径（如 Rust + TypeScript 或 Rust + Flutter）。它们在协议层面依然被完全支持。然而，它们被视为**“社区/高级路径”**，我们依赖社区的力量来构建相应的工具链和最佳实践。我们对这些路径的官方角色，是提供清晰的文档和一个稳定的、语言无关的核心API。
+
+## 如何贡献
+
+贡献的形式多种多样，每一种都同样宝贵。你可以通过以下方式帮助建设“大道”：
+
+* **核心开发**: 为`元 (Meta Unit)`和核心协议（使用Rust）贡献代码。
+* **化身与模块开发**: 为不同平台创建新的`化身`，或开发新的模块来扩展`元`的能力。
+* **文档与翻译**: 改进这些文档，撰写教程，以及将它们翻译成新的语言。
+* **用户支持与社区管理**: 帮助新用户，回答问题，营造一个热情、互助的氛围。
+* **设计与用户体验**: 为我们的参考`化身`贡献UI/UX设计，并为生态定义设计模式。
+
+## 决策流程
+
+我们的治理模式，被设计为与项目共同成长。
+
+1. **早期阶段 (阶段 I-II)**: 决策将由**核心团队**在公共渠道进行开放讨论后做出。这种类似“仁慈的终身独裁者 (BDFL)”的模式，对于项目初期的速度和一致性是必要的。
+2. **成长阶段 (阶段 III-IV)**: 对于核心协议或架构的重大变更，我们将引入一个正式的 **RFC (请求评论) 流程**。这允许社区中的任何人撰写详细的提案，该提案将在公开辩论和完善后，再做出最终决定。
+3. **成熟阶段 (未来)**: 我们致力于在未来探索并过渡到更去中心化的治理机制，例如由贡献者选举产生的技术委员会，或基于DAO的财库与协议管理模型。
+
+## 沟通渠道
+
+* **GitHub**: 用于所有代码托管、问题追踪和RFC讨论。
+* **Discord / Matrix (待定)**: 用于实时的社区聊天、问答和协作。

zh/src/project/roadmap.md

@@ -0,0 +1,53 @@
+# 发展路线图
+
+本文档概述了大道 (Dao OS) 的战略路线图。它的设计旨在做到既雄心勃勃又切合实际，专注于在每个阶段都能交付有意义的增量价值。这是一份活的文档，可能会随着社区反馈和技术突破而演进。
+
+---
+
+### 第一阶段：创世 (Genesis) - 奠定基石
+
+* **时间**：2025年第三季度 - 2025年第四季度
+* **核心目标**：构建大道 OS 最底层的核心组件，完成项目的技术可行性验证。
+* **关键里程碑**:
+  * 完成 v0.1 版本的核心 API 规范定义。
+  * 使用 Rust 开发 v0.1 版本的`元 (Meta Unit)`，包含基础的加密和P2P模块。
+  * 创建两个用于测试和演示的最小可行化身：一个命令行的**`核化身 (Core Avatar)`**和一个基础的浏览器**`器化身 (Facet Avatar)`**。
+* **功能故事**: “我成功在我的电脑上运行了‘大道’的种子，在我的浏览器里创建了一个‘化身’，并存储了一条只存在于我自己设备上的加密信息。我看到了未来的火花。”
+
+---
+
+### 第二阶段：显现 (Manifestation) - “第二大脑”觉醒
+
+* **时间**：2026年第一季度 - 2026年第二季度
+* **核心目标**：交付“第二大脑”的核心功能 MVP，为早期用户提供切实的日常价值。
+* **关键里程碑**:
+  * 在`元`中完整实现`SecretStore`（密码）和`NoteStore`（笔记）模块。
+  * 浏览器`器化身`支持完整的密码管理和基础的笔记功能。
+  * 开发 v0.1 版本的移动端**`器化身 (Facet Avatar)`**（例如，使用 Flutter），并实现“动态锚点”逻辑。
+  * 上线包含初步文档的项目官网。
+* **功能故事**: “我所有的密码和私密笔记都安全地存储和无缝地同步在我自己的设备之间。我的手机是我数字生活的锚点。我再也无需信任第三方云服务来保管我的秘密。我的数字生活终于有了家。”
+
+---
+
+### 第三阶段：协同 (Synergy) - 连接不同的大道
+
+* **时间**：2026年第三季度 - 2026年第四季度
+* **核心目标**：实现不同用户“大道”之间的、可信的安全交互，为去中心化的社会结构奠定基础。
+* **关键里程碑**:
+  * 在`元`中实现 W3C DID 和 VC 模块。
+  * 开发一个跨“大道”协作的PoC应用，例如：向另一个用户安全地出示一个可验证凭证。
+  * 启动“情感共鸣模块”的基础研究和原型设计。
+* **功能故事**: “我拥有了一个独一无二的、无法被审查的‘大道’数字身份。我可以用这个身份，向另一个‘大道’用户通过密码学证明我的一个凭证，而无需依赖任何平台。我们之间建立了一种新的信任。”
+
+---
+
+### 第四阶段：生态 (Ecosystem) - 千树万树梨花开
+
+* **时间**：2027年及以后
+* **核心目标**：将“大道”从一个强大的工具，演进为一个为所有人服务的、开放的、可扩展的平台。
+* **关键里程碑**:
+  * 发布 v1.0 稳定版的`元` API 和一个健壮的开发者SDK。
+  * 上线用于发现可信第三方`化身`的“社区信誉与自动化验证”体系。
+  * 发布一个集成“情感共鸣模块”的重大更新（例如 Dao OS 2.0）。
+  * 培育一个能构建各种新`化身`和模块的、繁荣的社区。
+* **功能故事**: “我的‘大道’现在是一个活的平台。我安装了一个社区开发的模块，我的AI伙伴也变得更有温度、更有洞察力了。我的数字生活现在是完整的、统一的，并充满了无限的可能性。”

zh/src/specifications/tech_overview.md

@@ -0,0 +1,42 @@
+# 技术总览
+
+本文档为希望在大道 (Dao OS) 生态系统中进行构建或贡献的开发者，提供了关于架构、核心技术和指导原则的高阶概览。
+
+## 技术指导原则
+
+我们的工程决策由一套核心原则指引，以确保系统是健壮、可移植和开放的。
+
+* **Web原生与可移植性**: 我们将源自Web的技术作为应用开发的**主路径**。
+* **通过WASM实现多语言主义**: 核心应用逻辑被编译成 WebAssembly (WASM)，允许开发者使用他们选择的语言（如 Rust, Go, 或 Nim）。
+* **API优先**: 应用逻辑和用户界面之间的交互，由一个严格的、版本化的API契约来定义。
+* **安全第一**: 所有第三方应用逻辑都运行在`元`内部的安全沙箱中，并恪守“最小权限原则”。
+* **自由及开源软件 (FOSS)**: 整个核心协议和参考实现都是开源的。
+
+## 应用开发路径
+
+从开发者的角度看，“大道”应用由一个后端的“灵魂”（WASM服务模块）和一个前端的“皮囊”（UI）组成。我们提供多种路径来构建它们，以满足不同的需求和偏好。
+
+### 1. 主流路径 (推荐起点)
+
+这是最稳健、生态最丰富的路径。
+
+* **后端 (服务于 `核化身`)**: 应用的核心逻辑，以一个用 Rust 或 Go 编写的 WASM 模块存在。虽然它理论上可以在任何化身上运行，但其持久的、资源密集型的任务，通常被设计为在**`核化身 (Core Avatar)`**上执行。
+* **前端 (呈现于 `器化身`)**: 一个标准的 **Web 应用** (使用 TypeScript/JavaScript)。这个 UI 被设计为运行在我们官方的、安全的**“大道 Web 化身”**中。
+
+### 2. 快速通道：Nim 开发套件 (官方支持)
+
+为了追求极致的生产力，我们为 **Nim** 提供了一流的支持。
+
+* **后端 (服务于 `核化身`)**: 应用的核心逻辑，从 Nim 编译到 **WASM**。同主流路径一样，它理想的运行环境是`核化身`。
+* **前端 (呈现于 `器化身`)**: 从同一份 Nim 源码编译到 **JavaScript** 的 **Web 应用**。这个统一的方案运行在“大道 Web 化身”中。
+
+### 3. 原生路径 (高级)
+
+对于需要深度平台集成或顶尖原生性能的开发者，可以构建一个**自定义的`器化身`**。
+
+* **后端 (服务于 `核化身`)**: 同样是那个 **WASM** 服务模块，它可以被任何类型的化身调用。
+* **前端 (自定义 `器化身`)**: 一个完全原生的应用（例如，用 Flutter 或 Swift 编写），它直接作为`元`的宿主并提供 UI。
+
+## API 契约与关键技术
+
+API 契约通过 `dao.js` 桥为 Web UI 暴露，或为原生 UI 直接暴露，统一使用 **Protocol Buffers** 进行数据序列化。所有路径的核心技术保持一致。