Files
dao-os-docs/zh/print.html
2025-06-16 09:59:57 +00:00

589 lines
55 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE HTML>
<html lang="en" class="light sidebar-visible" dir="ltr">
<head>
<!-- Book generated using mdBook -->
<meta charset="UTF-8">
<title>大道 (Dao OS) 文档</title>
<meta name="robots" content="noindex">
<!-- Custom HTML head -->
<meta name="description" content="大道Dao OS官方文档你的赛博生命操作系统。">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#ffffff">
<link rel="icon" href="favicon.svg">
<link rel="shortcut icon" href="favicon.png">
<link rel="stylesheet" href="css/variables.css">
<link rel="stylesheet" href="css/general.css">
<link rel="stylesheet" href="css/chrome.css">
<link rel="stylesheet" href="css/print.css" media="print">
<!-- Fonts -->
<link rel="stylesheet" href="FontAwesome/css/font-awesome.css">
<link rel="stylesheet" href="fonts/fonts.css">
<!-- Highlight.js Stylesheets -->
<link rel="stylesheet" id="highlight-css" href="highlight.css">
<link rel="stylesheet" id="tomorrow-night-css" href="tomorrow-night.css">
<link rel="stylesheet" id="ayu-highlight-css" href="ayu-highlight.css">
<!-- Custom theme stylesheets -->
<!-- Provide site root and default themes to javascript -->
<script>
const path_to_root = "";
const default_light_theme = "light";
const default_dark_theme = "navy";
</script>
<!-- Start loading toc.js asap -->
<script src="toc.js"></script>
</head>
<body>
<div id="mdbook-help-container">
<div id="mdbook-help-popup">
<h2 class="mdbook-help-title">Keyboard shortcuts</h2>
<div>
<p>Press <kbd></kbd> or <kbd></kbd> to navigate between chapters</p>
<p>Press <kbd>S</kbd> or <kbd>/</kbd> to search in the book</p>
<p>Press <kbd>?</kbd> to show this help</p>
<p>Press <kbd>Esc</kbd> to hide this help</p>
</div>
</div>
</div>
<div id="body-container">
<!-- Work around some values being stored in localStorage wrapped in quotes -->
<script>
try {
let theme = localStorage.getItem('mdbook-theme');
let sidebar = localStorage.getItem('mdbook-sidebar');
if (theme.startsWith('"') && theme.endsWith('"')) {
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
}
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
}
} catch (e) { }
</script>
<!-- Set the theme before any content is loaded, prevents flash -->
<script>
const default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? default_dark_theme : default_light_theme;
let theme;
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
if (theme === null || theme === undefined) { theme = default_theme; }
const html = document.documentElement;
html.classList.remove('light')
html.classList.add(theme);
html.classList.add("js");
</script>
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
<!-- Hide / unhide sidebar before it is displayed -->
<script>
let sidebar = null;
const sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
if (document.body.clientWidth >= 1080) {
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
sidebar = sidebar || 'visible';
} else {
sidebar = 'hidden';
}
sidebar_toggle.checked = sidebar === 'visible';
html.classList.remove('sidebar-visible');
html.classList.add("sidebar-" + sidebar);
</script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
<!-- populated by js -->
<mdbook-sidebar-scrollbox class="sidebar-scrollbox"></mdbook-sidebar-scrollbox>
<noscript>
<iframe class="sidebar-iframe-outer" src="toc.html"></iframe>
</noscript>
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
<div class="sidebar-resize-indicator"></div>
</div>
</nav>
<div id="page-wrapper" class="page-wrapper">
<div class="page">
<div id="menu-bar-hover-placeholder"></div>
<div id="menu-bar" class="menu-bar sticky">
<div class="left-buttons">
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
<i class="fa fa-bars"></i>
</label>
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
<i class="fa fa-paint-brush"></i>
</button>
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
<li role="none"><button role="menuitem" class="theme" id="default_theme">Auto</button></li>
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
</ul>
<button id="search-toggle" class="icon-button" type="button" title="Search (`/`)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="/ s" aria-controls="searchbar">
<i class="fa fa-search"></i>
</button>
</div>
<h1 class="menu-title">大道 (Dao OS) 文档</h1>
<div class="right-buttons">
<a href="print.html" title="Print this book" aria-label="Print this book">
<i id="print-button" class="fa fa-print"></i>
</a>
<a href="https://nest.doylee.cn/Dao-OS/dao-os-docs" title="Git repository" aria-label="Git repository">
<i id="git-repository-button" class="fa fa-github"></i>
</a>
</div>
</div>
<div id="search-wrapper" class="hidden">
<form id="searchbar-outer" class="searchbar-outer">
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
</form>
<div id="searchresults-outer" class="searchresults-outer hidden">
<div id="searchresults-header" class="searchresults-header"></div>
<ul id="searchresults">
</ul>
</div>
</div>
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
<script>
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
});
</script>
<div id="content" class="content">
<main>
<h1 id="引言"><a class="header" href="#引言">引言</a></h1>
<p><strong>我们旨在构建一种全新的、强大且坚韧的赛博生命范式——大道 (Dao OS)。</strong></p>
<p>“大道”不是一个传统的操作系统。相反,它是一套开放的协议和一个核心的、可移植的库—— <strong><code>元单元 (Meta Unit)</code></strong>(以下简称为 <strong><code></code></strong>),其使命是为任何平台上的任何应用,带来主权、智能与互操作性。</p>
<p>它的目标是解决“数据孤岛”、“平台锁定”和“隐私侵蚀”问题。它通过提供一个统一、安全、用户所有的“数字灵魂”(即 <strong><code></code></strong>让任何程序都可以通过集成它而转变为用户个人P2P网络中的一个主权 <strong><code>化身 (Avatar)</code></strong></p>
<p>我们称呼这些与“大道”集成的软件生态为 <strong><code>道器 (Dao Implement)</code></strong></p>
<h2 id="核心概念"><a class="header" href="#核心概念">核心概念</a></h2>
<ul>
<li>
<p><strong><code>元 (Meta Unit)</code></strong>: 你数字生命的“精密机器”。一个可移植的库包含了你加密的“第二大脑”、核心服务API以及被扩展的能力。它是你所拥有的、等待被激活的唯一事实来源。</p>
</li>
<li>
<p><strong><code>化身 (Avatar)</code></strong>: “运行时”或“能源”。任何加载并运行你**<code></code><strong>的程序,都会成为一个<code>化身</code>。一个运行着Web应用的浏览器标签页、一个命令行工具、或一个原生移动App都可以是<code>化身</code>,扮演着为</strong><code></code>**这台机器提供运行所需“能源”CPU、内存和资源的桥梁。</p>
</li>
<li>
<p><strong><code>道器 (Dao Implement)</code></strong>: 通过集成<code></code>而成为<code>化身</code>的应用和扩展所组成的生态系统。</p>
<ul>
<li><strong><code>器 (Facet Implement)</code></strong>: 拥有用户界面的<code>道器</code>,提供一个可与你的“大道”交互的“控制面板”。</li>
<li><strong><code>核 (Core Implement)</code></strong>: 无界面的<code>道器</code>(“扩展”),用于增强你的“大道”的后台能力。</li>
</ul>
</li>
<li>
<p><strong>主权 P2P 网络</strong>: 你所有的<code>化身</code>,无论它们运行在何种设备上,都会连接起来,形成一个私有的、坚韧的、端到端加密的网络,让它们内嵌的<code></code>中的数据,保持无缝同步。</p>
</li>
</ul>
<h2 id="我们的愿景"><a class="header" href="#我们的愿景">我们的愿景</a></h2>
<p>我们构想的未来是,你的数字身份和数据,不再被困于一个个花园围墙之内;你的应用,不再是一个个孤立的工具,而是一个更大的“数字自我”中,可以智能协作的组件;每一个用户,都是自己数字生活里真正的主权君主。</p>
<p><strong>欢迎加入我们,一起构建这个未来。</strong></p>
<div style="break-before: page; page-break-before: always;"></div><h1 id="哲学与原则"><a class="header" href="#哲学与原则">哲学与原则</a></h1>
<p>大道 (Dao OS) 不仅仅是一个技术项目,它是一套关于未来计算和人机共生核心理念的具现化。本文档概述了指引我们每一项决策的根本思想。</p>
<h2 id="核心哲学数字主权之路"><a class="header" href="#核心哲学数字主权之路">核心哲学:数字主权之路</a></h2>
<p>我们的指引之星是<strong>数字主权</strong>。我们相信,每一个个体都拥有不可剥夺的、去拥有、控制和理解自己数字生活的权利。我们的使命,是创造能让这项权利不仅仅是理论上的可能,更是为每个人服务的、切实的、令人愉悦的现实。我们称这场旅程为“道”——一条回归自我拥有权的道路。</p>
<h2 id="开发范式道生一"><a class="header" href="#开发范式道生一">开发范式:“道生一”</a></h2>
<p>我们构建“大道”的方法论,是其核心哲学的直接体现。我们不只是在构建一个工具,我们是在创造一个共生伙伴。因此,我们的开发过程被设计为一个<strong>自我进化、自举的反馈循环</strong>。我们用“大道”本身,来加速“大道”的开发。</p>
<p>这个“自举式开发”范式遵循以下循环:</p>
<ol>
<li><strong>播种 (The Seed)</strong>:我们用传统工具,写出**<code>元单元</code><strong>(以下简称为</strong><code></code><strong>)的第一个最简陋的版本,和一个能运行它的基础</strong><code>化身</code>**。</li>
<li><strong>自用 (Dogfooding)</strong>:从那一刻起,我们使用我们自己这个初生的“大道”,作为管理项目的主要工具。所有的设计文档、笔记、讨论和代码片段,都存入我们自己的、由**<code></code>**所管理的“第二大脑”中。</li>
<li><strong>学习 (Learning)</strong>**<code></code>**的个人AI能力由我们官方的“AI伙伴”道器提供开始以最高质量、最专注的“养料”——也就是我们创造它本身的过程数据——来训练自己。</li>
<li><strong>加速 (Acceleration)</strong>我们继而利用这个日益智能的AI伙伴来帮助我们构建下一个版本。我们可以让它基于我们已记录的决策来生成样板代码分析错误报告或者带着对项目完整历史的完美记忆来一起进行架构设计的头脑风暴。</li>
<li><strong>进化 (Evolution)</strong>:“大道”的能力越强,我们开发它的速度就越快。这就创造了一个指数级的正反馈循环,在这个循环中,创造的行为本身,就是一场与“创造物”的持续对话。</li>
</ol>
<h2 id="ai-伦理宪章"><a class="header" href="#ai-伦理宪章">AI 伦理宪章</a></h2>
<p>由于AI是系统潜能的核心部分其伦理基石至关重要。我们的AI宪章由四大核心宗旨构成</p>
<ol>
<li><strong>伙伴宗旨</strong>: AI 是伙伴,而非仆人或神谕。</li>
<li><strong>透明宗旨</strong>: AI 的推理过程必须是可审查和可理解的。</li>
<li><strong>校准宗旨</strong>: 用户必须拥有最终的控制权以纠正、引导和约束AI。</li>
<li><strong>多元宗旨</strong>: AI 的设计必须旨在帮助用户探索多元化的视角,而非将他们困于信息茧房。</li>
</ol>
<h2 id="指导原则"><a class="header" href="#指导原则">指导原则</a></h2>
<p>这些是为我们的设计和工程选择提供信息的高阶原则。</p>
<ul>
<li><strong>主权第一</strong>: 在任何权衡中,用户的控制权和数据所有权都拥有最高优先级。</li>
<li><strong>体验为王</strong>: 主权不应以牺牲优美、直观和愉悦的用户体验为代价。</li>
<li><strong>设计即隐私</strong>: 默认情况下,所有数据都是私密的、本地的,并进行端到端加密。</li>
<li><strong>韧性与可移植性</strong>: 系统应该是健壮的,支持离线工作,并且没有单点故障。</li>
<li><strong>开放与多语言主义</strong>: **<code></code><strong>是一个可移植的库,集成它而成为<code>化身</code></strong><code>道器</code>**可以用任何语言编写。</li>
<li><strong>社区驱动</strong>: 项目在开放中构建,与社区同行,为社区服务。</li>
</ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="核心架构"><a class="header" href="#核心架构">核心架构</a></h1>
<p>大道 (Dao OS) 的架构,并非一个传统的、单体的操作系统。它是一个为实现主权、韧性和可扩展性而设计的、去中心化的分层范式。要理解它,必须理解它的三个基本实体:元单元、化身、以及道器。</p>
<h2 id="1-元单元-meta-unit可移植的灵魂代码"><a class="header" href="#1-元单元-meta-unit可移植的灵魂代码">1. <code>元单元 (Meta Unit)</code>:可移植的“灵魂代码”</a></h2>
<p><code>元单元</code>(以下简称为<code></code>)是用户数字存在的概念核心,但它本身不是一个运行中的程序。</p>
<ul>
<li><strong>其本质</strong>: <code></code>是一个<strong>可移植的库或制品 (Library/Artifact)</strong>,例如一个 <code>.wasm</code><code>.so</code><code>.dll</code> 文件。它包含了用户完整的、端到端加密的“第二大脑”所有数据、核心服务API身份、P2P网络、AI基础设施以及管理它们的逻辑。</li>
<li><strong>其角色</strong>: 它是被动的、统一的、唯一的“事实来源”,定义了用户的核心数据与能力。就像 Java 的字节码 (<code>.class</code> 文件)一样,它定义了“能做什么”,但它自己不“做”。它是等待被激活的“精密机器”。</li>
</ul>
<h2 id="2-化身-avatar元的运行时环境"><a class="header" href="#2-化身-avatar元的运行时环境">2. <code>化身 (Avatar)</code><code></code>的“运行时环境”</a></h2>
<p><code>化身</code>是赋予<code></code>生命的“能动”实体。</p>
<ul>
<li><strong>其本质</strong>: <code>化身</code>是任何一个<strong>可执行的程序或进程</strong>,其核心职责是加载、承载并执行一个<code></code>的实例。它是激活“机器”的“能源”。</li>
<li><strong>其角色</strong>: <code>化身</code>扮演着连接抽象的<code></code>与具体的宿主平台iOS、Windows、浏览器、命令行之间的关键<strong>桥梁</strong>。它为<code></code>提供访问系统资源CPU、内存、存储、网络的通道。在 Java 的比喻中,<code>化身</code>就是 <strong>JVM (Java虚拟机)</strong></li>
<li><strong>大道网络</strong>: 用户所有正在运行的<code>化身</code>都会组成一个私有的P2P网络以保持其内嵌的<code></code>实例时刻无缝同步。</li>
</ul>
<h2 id="3-道器-dao-implement生态系统中的软件"><a class="header" href="#3-道器-dao-implement生态系统中的软件">3. <code>道器 (Dao Implement)</code>:生态系统中的软件</a></h2>
<p>“道器”是为所有与“大道”生态集成、并扩展其能力的第三方软件所设定的通用术语。它们是用户实际交互的应用和服务。一个<code>道器</code>通过集成<code></code>而成为一个<code>化身</code></p>
<p>一个<code>道器</code>并非单一类型,而是根据其设计,由不同类型的组件构成。</p>
<ul>
<li><strong><code>器 (Facet Component)</code></strong>: 这是一个<code>道器</code>中,拥有<strong>用户界面</strong>的部分。它是<code></code>这台机器的“控制面板”,负责向用户呈现信息和捕获用户输入。</li>
<li><strong><code>核 (Core Component)</code></strong>: 这是一个<code>道器</code>中,<strong>无界面、负责后台逻辑</strong>的部分。它作为一个服务运行,提供特定的能力来增强<code></code>或被其他<code>道器</code>调用。它是机器的“外挂工具”。</li>
</ul>
<h3 id="架构的自由"><a class="header" href="#架构的自由">架构的自由</a></h3>
<p>开发者在构建他的<code>道器</code>时,拥有完全的架构自由:</p>
<ul>
<li>他可以创建一个<strong>单体式独立应用</strong>,这个应用本身就是一个<code>化身</code>,将<code></code>库、一个<code></code>(用于逻辑)和一个<code></code>用于UI打包在一个可执行文件中。</li>
<li>他可以创建一个<strong>分布式应用</strong>,让一个<code></code>在一个设备上,与另一个设备上的<code></code>进行通信。</li>
<li>他可以只创建一个纯粹的**<code></code>**(一个“扩展”),仅仅为用户的整个“大道”提供一种新的后台能力。</li>
<li>他也可以只创建一个纯粹的**<code></code>**,它没有任何自定义的后端逻辑(<code></code>),其界面直接调用<code></code>本身提供的核心服务(如“第二大脑”)来构建一个简单的工具应用。</li>
</ul>
<p>这套架构确保了“大道”不仅是一个平台,更是一个真正开放的、可组合的、去中心化的生态系统。</p>
<div style="break-before: page; page-break-before: always;"></div><h1 id="ai-系统设计"><a class="header" href="#ai-系统设计">AI 系统设计</a></h1>
<p>大道 (Dao OS) 中的 AI并非一个单一的程序而是一个协同工作的生态系统。它源于**<code></code><strong>所提供的</strong>基础能力**,与**<code>道器</code><strong>所实现的</strong>具体智能**之间的协同作用。</p>
<h2 id="1-元主权ai的基础设施"><a class="header" href="#1-元主权ai的基础设施">1. <code></code>主权AI的基础设施</a></h2>
<p><code></code>(即<code>元单元</code>本身不包含AI而是提供能让智能应用在用户掌控下安全运行的核心、可信的<strong>基础设施</strong>。这包括“私有特征库”(第二大脑)、<code></code>组件的安全执行环境,以及数据访问的权限网关。</p>
<h2 id="2-大道ai伙伴一个分层的行为模型"><a class="header" href="#2-大道ai伙伴一个分层的行为模型">2. “大道AI伙伴”一个分层的行为模型</a></h2>
<p>为了提供开箱即用的强大体验,“大道”包含了一个官方的、第一方的<code>核道器</code>,名为**“大道AI伙伴 (Dao AI Companion)”**。这便是用户能与之交互的那个“灵魂”。它的行为不是一成不变的,而是遵循一个分层的、基于情境的模型,以确保它总是有用,但从不越界。</p>
<h3 id="第一层默认行为---静默优先原则"><a class="header" href="#第一层默认行为---静默优先原则">第一层:默认行为 - “静默优先”原则</a></h3>
<p>AI伙伴的首要和默认状态是近乎“隐形”的。它的首要目标不是主动介入而是为用户创造一个宁静、有序、低噪音的数字环境。它在后台静默地工作</p>
<ul>
<li>优化数据同步和系统性能。</li>
<li>过滤数字“噪音”,如分心的通知和垃圾信息。</li>
<li>以符合逻辑、不打扰的方式,组织和索引新信息。
其目标是做到高效而无形,让用户忘记它的存在,从而使其自身自然的思想和意图,能够在无数字干扰的情况下浮现。</li>
</ul>
<h3 id="第二层交互行为---赋能式对话模型"><a class="header" href="#第二层交互行为---赋能式对话模型">第二层:交互行为 - “赋能式”对话模型</a></h3>
<p>当用户<strong>主动</strong>与AI伙伴进行交互时例如打开其聊天界面它的行为模型会切换为**“赋能式伙伴”**。其目标不是提供“正确答案”或替用户做决定,而是培育用户自己的清晰度和勇气。它通过以下方式做到这一点:</p>
<ul>
<li><strong>提供客观信息</strong>:不带评判地呈现事实、数据和不同视角。</li>
<li><strong>澄清用户意图</strong>:提出能帮助用户理解自身目标的问题。</li>
<li><strong>分清各自责任</strong>:它始终将其角色框定在“提供信息”上,同时强调“做出最终选择”永远是用户的角色和责任。
这个交互模型被设计为充满尊重和平等精神,旨在赋能用户做出他们自己的最佳决策。</li>
</ul>
<h3 id="第三层可选行为---目标驱动的辅助模块"><a class="header" href="#第三层可选行为---目标驱动的辅助模块">第三层:可选行为 - “目标驱动”的辅助模块</a></h3>
<p>对于那些希望在生活特定领域获得更结构化、更主动辅助的用户,系统提供了一系列<strong>可选的、由用户主动开启的模块</strong>。这些功能默认关闭。例如:</p>
<ul>
<li>一个**“项目管理”**模块,可以为一个特定的工作项目,主动追踪截止日期并整理相关资源。</li>
<li>一个**“个人角色与责任”**模块,可以帮助用户追踪与他们自我定义的角色(如为人父母、朋友或团队领导)相关的目标。
这允许用户在一个受控的、自愿选择的基础上“雇佣”AI在特定领域扮演更积极的角色而不会改变其充满尊重的、非侵入性的默认人格。</li>
</ul>
<h2 id="3-第三方智能道器的设计模式"><a class="header" href="#3-第三方智能道器的设计模式">3. 第三方智能<code>道器</code>的设计模式</a></h2>
<p>第三方开发者可以创造他们自己的智能<code>道器</code>他们既可以调用官方AI伙伴的服务也可以构建自己专属的AI<code></code>组件,为用户在大道生态中提供另类的或互补的智能。</p>
<div style="break-before: page; page-break-before: always;"></div><h1 id="用户旅程从便利到主权"><a class="header" href="#用户旅程从便利到主权">用户旅程:从便利到主权</a></h1>
<p>任何主权系统的一个核心挑战,都在于“绝对控制”与“轻松便利”之间的张力。“大道”解决这个问题的方式,不是强迫用户二选一,而是设计了一场充满引导、相互尊重的**“渐进式主权”**之旅。我们在用户熟悉的地方与他们相遇,并赋能他们去往任何他们想去的地方。</p>
<p>这场旅程不仅适用于用户对核心数据的掌控,也同样适用于他们与**<code>道器</code>**(应用和扩展)生态系统的交互。</p>
<h2 id="应用之旅一次注册随处使用"><a class="header" href="#应用之旅一次注册随处使用">应用之旅:一次注册,随处使用</a></h2>
<p>在“大道”中“安装”一个应用,与传统应用商店有着本质的不同。它不是将一个程序安装到单一的设备上,而是为你整个的数字生命体——你的“大道”——授予一项新的能力。</p>
<h3 id="1-发现与信任"><a class="header" href="#1-发现与信任">1. 发现与信任</a></h3>
<p>旅程始于我们的**“应用集市”<strong>,一个去中心化的发现系统。当你找到一个<code>道器</code>时,你看到的将是它的</strong>“信任仪表盘”**(包含自动化验证检查和社区背书),让你能做出知情的、主权的决定。</p>
<h3 id="2-注册与授权-即安装"><a class="header" href="#2-注册与授权-即安装">2. 注册与授权 (即“安装”)</a></h3>
<p>当你决定添加一个<code>道器</code>时,系统会向你展示它的**“清单 (Manifest)”<strong>。这是一个清晰的、人类可读的列表,说明了该<code>道器</code>的组件(<code></code>和/或<code></code>)运行所需的权限。你对这份清单的明确批准,就是那一次性的“安装”事件。这个行为将该<code>道器</code></strong>“注册”**到你的<code></code>中,这个注册状态会被同步到你所有的<code>化身</code></p>
<h3 id="3-无缝的跨平台访问"><a class="header" href="#3-无缝的跨平台访问">3. 无缝的跨平台访问</a></h3>
<p>一旦一个<code>道器</code>被注册,你就可以在任何设备上访问它。访问方式取决于其开发者的设计。</p>
<ul>
<li>
<p><strong>对于基于 Web 的<code></code>组件</strong>:
你只需在你的标准浏览器中访问该应用的网址。网页会通过我们的 <code>dao.js</code> SDK请求连接到你的“大道”。一旦你批准例如通过一个简单的认证器插件那个<strong>浏览器标签页本身,就变成了一个临时的<code>器化身</code></strong>安全地渲染UI并与你的<code></code>通信。</p>
</li>
<li>
<p><strong>对于原生的<code></code>组件</strong>:
你下载并运行这个原生应用(例如,从应用商店或直接下载)。在首次启动时,它会请求连接你的“大道”。一旦批准,这个<strong>正在运行的应用程序,就变成了一个持久的<code>器化身</code></strong>,加入了你的网络。</p>
</li>
</ul>
<p>因为所有这些<code>器化身</code>都由同一个、已同步的<code></code>来驱动,所以你的体验在任何地方都是一致的,无需在传统意义上于每个设备都“安装”一次应用。</p>
<h3 id="4-高级配置"><a class="header" href="#4-高级配置">4. 高级配置</a></h3>
<p>在任何时候,你都可以进入你的**“主权仪表盘”**来:</p>
<ul>
<li>审查并撤销你授予任何<code>道器</code>的权限。</li>
<li>使用**“角色分配”**功能,来建议某个<code>道器</code><code></code>组件,优先在你指定的某个<code>核化身</code>(例如你作为<code>计算节点</code>的家用服务器)上运行。</li>
</ul>
<h2 id="主权之旅的阶段"><a class="header" href="#主权之旅的阶段">主权之旅的阶段</a></h2>
<h3 id="第一阶段托管模式-managed-mode--你的向导之旅"><a class="header" href="#第一阶段托管模式-managed-mode--你的向导之旅">第一阶段:“托管模式” (Managed Mode) —— 你的向导之旅</a></h3>
<p>对于新用户,此模式通过友好的密钥恢复方法和默认同步节点提供最大便利,同时保持完全的端到端加密。</p>
<h3 id="第二阶段主权仪表盘-sovereignty-dashboard--十字路口"><a class="header" href="#第二阶段主权仪表盘-sovereignty-dashboard--十字路口">第二阶段:主权仪表盘 (Sovereignty Dashboard) —— 十字路口</a></h3>
<p>这是用户通往自治之旅的指挥中心,是一个赋能与教育的工具,可将用户的主权状态可视化,并提供游戏化的“任务”来鼓励用户获取更多控制权。</p>
<h3 id="第三阶段主权模式-sovereign-mode--你的数字王国"><a class="header" href="#第三阶段主权模式-sovereign-mode--你的数字王国">第三阶段:“主权模式” (Sovereign Mode) —— 你的数字王国</a></h3>
<p>这是旅程的最终、可选阶段。在“主权仪表盘”的引导下,用户可以“毕业”到此模式,完全自主保管他们的密钥并运行自己的<code>核化身</code>网络,成为其数字领地中真正的主人。</p>
<div style="break-before: page; page-break-before: always;"></div><h1 id="技术总览"><a class="header" href="#技术总览">技术总览</a></h1>
<p>本文档为希望构建**<code>道器</code>**与大道OS生态集成的应用和服务的开发者提供了关于架构、核心技术和指导原则的高阶概览。</p>
<h2 id="技术指导原则"><a class="header" href="#技术指导原则">技术指导原则</a></h2>
<ul>
<li><strong>是“库”,而非“框架”</strong>: 大道OS不是一个限制性的框架。**<code></code>**是一个可移植的库,你将它集成到你自己的应用中,在不规定你应用内部架构的前提下,为其赋能。</li>
<li><strong>开放与多语言主义</strong>: 任何应用,无论用何种语言编写,都可以成为一个**<code>化身</code><strong><code></code>的运行时)。我们通过将<code></code>同时提供为</strong>WASM库**用于Web和脚本语言<strong>原生库</strong><code>.so</code>, <code>.dll</code>, <code>.a</code>,用于系统语言)来实现这一点。</li>
<li><strong>API优先</strong>: 所有与<code></code>的交互都通过一个稳定的、版本化的、文档齐全的API进行。</li>
<li><strong>安全第一</strong>: <code></code>是一个安全保险库。所有数据默认端到端加密,所有交互都由一个严格的、用户控制的权限系统来管理。</li>
</ul>
<h2 id="核心集成应用如何化身"><a class="header" href="#核心集成应用如何化身">核心集成:应用如何“化身”</a></h2>
<p>创造一个<code>道器</code>的旅程,始于集成<code></code>库,这个动作会即时地将正在运行的应用进程,转变为用户“大道”网络中的一个主权<code>化身</code>。我们提供两条主要的集成路径。</p>
<h3 id="1-web-集成路径-通过-daojs-sdk"><a class="header" href="#1-web-集成路径-通过-daojs-sdk">1. Web 集成路径 (通过 <code>dao.js</code> SDK)</a></h3>
<p>这是对于 Web 开发者来说,最简单、最平滑的路径。</p>
<ul>
<li><strong>工作原理</strong>: 开发者可以利用任何新的或现有的Web应用。通过引入我们的 <code>dao.js</code> SDK他的Web应用就获得了加载<code></code>的WASM二进制文件 (<code>dao.wasm</code>) 的能力。</li>
<li><strong>“化身”转变</strong>: 一旦用户授权运行这个Web应用的<strong>浏览器标签页,就变成了一个临时的<code>化身</code></strong>。Web应用的JavaScript代码就可以通过<code>dao.js</code>桥暴露出的高层API<code></code>进行通信。</li>
<li><strong>最适用于</strong>: 快速构建<code></code>组件 (<code>Facet Implement</code>)创建数据可视化面板以及将现有的PWA渐进式Web应用集成到“大道”生态中。</li>
</ul>
<h3 id="2-原生集成路径-通过-ffi"><a class="header" href="#2-原生集成路径-通过-ffi">2. 原生集成路径 (通过 FFI)</a></h3>
<p>这条路径为原生应用提供了最强的性能和最深的系统集成能力。</p>
<ul>
<li><strong>工作原理</strong>: 一个原生应用用Rust, Go, Swift, Kotlin, C++等编写)的开发者,可以直接链接<code></code>的原生库。</li>
<li><strong>“化身”转变</strong>: 正在运行的原生应用进程,就变成了一个持久的**<code>化身</code><strong>。应用代码通过一个</strong>外部函数接口FFI**桥,与<code></code>的核心服务通信。</li>
<li><strong>最适用于</strong>:
<ul>
<li>在服务器或NAS设备上创建强大的、7x24小时在线的**<code></code>组件 (<code>Core Implement</code>)**。</li>
<li>构建高性能的原生**<code></code>组件 (<code>Facet Implement</code>)**比如我们理想中基于Flutter的移动客户端。</li>
<li>改造现有的开源原生应用。</li>
</ul>
</li>
</ul>
<h2 id="关键技术与协议"><a class="header" href="#关键技术与协议">关键技术与协议</a></h2>
<div class="table-wrapper"><table><thead><tr><th style="text-align: left">类别</th><th style="text-align: left">技术 / 协议</th><th style="text-align: left">用途</th></tr></thead><tbody>
<tr><td style="text-align: left"><strong>核心库</strong></td><td style="text-align: left">Rust -&gt; WASM / 原生库</td><td style="text-align: left"><code></code>创建一个单一的、安全的、高性能的核心逻辑。</td></tr>
<tr><td style="text-align: left"><strong>Web集成</strong></td><td style="text-align: left"><code>dao.js</code> SDK (JS/TS)</td><td style="text-align: left">任何Web应用成为<code>化身</code>的桥梁。</td></tr>
<tr><td style="text-align: left"><strong>P2P网络</strong></td><td style="text-align: left"><code>libp2p</code></td><td style="text-align: left">模块化的节点发现、传输和安全通道。</td></tr>
<tr><td style="text-align: left"><strong>数据同步</strong></td><td style="text-align: left">无冲突复制数据类型 (CRDTs)</td><td style="text-align: left">确保各<code>化身</code>间的最终一致性。</td></tr>
<tr><td style="text-align: left"><strong>身份</strong></td><td style="text-align: left">DID &amp; VC</td><td style="text-align: left">主权身份与可互操作的、基于密码学的信任。</td></tr>
<tr><td style="text-align: left"><strong>数据序列化</strong></td><td style="text-align: left">Protocol Buffers (Protobuf)</td><td style="text-align: left">用于API的高效、语言无关的数据结构。</td></tr>
</tbody></table>
</div><div style="break-before: page; page-break-before: always;"></div><h1 id="应用集市"><a class="header" href="#应用集市">应用集市</a></h1>
<p>大道 (Dao OS) 没有一个传统的、中心化的“应用商店”。“商店”意味着一个单一的所有者,他扮演着守门人的角色,审批、拒绝并对应用征税。这与我们的核心哲学背道而驰。</p>
<p>取而代之的是,我们构建了一套开放协议,来创造一个去中心化的**“应用集市 (Application Bazaar)”**——这是一个充满活力的、开放的、坚韧的思想与工具市场,在这里,用户拥有主权,开发者拥有自由。</p>
<p>这个集市建立在四大支柱之上:发现、信任、分发和商业化。</p>
<h2 id="1-发现-discovery联邦式策展"><a class="header" href="#1-发现-discovery联邦式策展">1. 发现 (Discovery):联邦式策展</a></h2>
<p>在一个没有中央索引的世界里,用户如何找到新的**<code>道器</code>**?答案是:通过一个由受信任者组成的策展网络。</p>
<ul>
<li><strong>开发者发布</strong>: 开发者无需“提交”他的<code>道器</code>以供审批。他只需将其**“清单 (Manifest)”**(一个包含所有元数据的 <code>manifest.toml</code> 文件)发布到一个像 <strong>IPFS</strong> 这样的P2P存储网络上。然后他可以在公共频道上“广播”这个清单的地址。</li>
<li><strong>策展人的角色</strong>: 任何人——一个科技媒体、一个受信任的开发者社区,或者“大道基金会”自己——都可以运行一个“策展”服务。这些策展人抓取网络上的新清单,并根据自己的标准,创建主题性的**“策展列表”**。</li>
<li><strong>用户体验</strong>: 在用户的<code>器化身</code>他可以像订阅RSS一样订阅多个他信任的“策展列表”。他的“集市”或“发现”标签页就变成了这些信任源的个性化聚合视图。</li>
</ul>
<p>这个模型用一个丰富的、多维度的、用户策划的发现体验,取代了单一的、有偏见的“应用商店”榜单。</p>
<h2 id="2-信任与安全可验证的信誉"><a class="header" href="#2-信任与安全可验证的信誉">2. 信任与安全:可验证的信誉</a></h2>
<p>用户如何信任一个第三方的<code>道器</code>?他们不必盲目信任。整个集市都直接构建于我们的**“社区信誉与自动化验证”体系**之上。</p>
<p>每一个<code>道器</code>的列表,无论来自哪个策展人,都必须展示其**“信任仪表盘”**,提供透明、多维度的信号:</p>
<ol>
<li><strong>自动化验证</strong>: 来自 <code>dao-verify</code> 工具的、不可篡改的、关于安全漏洞和API合规性的“体检报告”。</li>
<li><strong>社区背书</strong>: 一个清晰的列表显示了哪些有信誉的DID为这个<code>道器</code>进行了密码学“签名背书”。</li>
<li><strong>策展人信誉</strong>: 推荐这个<code>道器</code>的策展人自身的信誉,也是一个信任信号。</li>
</ol>
<p>最终是否“注册”一个<code>道器</code>的决定权,永远掌握在用户手中,并有这些透明、可验证的数据作为依据。</p>
<h2 id="3-分发-distribution抗审查与直接分发"><a class="header" href="#3-分发-distribution抗审查与直接分发">3. 分发 (Distribution):抗审查与直接分发</a></h2>
<p>当用户决定注册一个<code>道器</code>时,这个过程是直接且去中心化的。</p>
<ul>
<li><code>道器</code>的清单中,包含了其软件包(例如作为<code>.wasm</code>文件的<code></code>组件和作为Web UI包的<code></code>组件)在<strong>IPFS</strong>上的<strong>内容哈希CID</strong></li>
<li>用户的<code></code>(由<code>化身</code>承载使用这个哈希直接从P2P网络获取文件。</li>
<li>这确保了没有任何中心服务器可以阻止一个<code>道器</code>的分发。只要数据存在于P2P网络的某个角落它就是可访问的。</li>
</ul>
<h2 id="4-商业化-monetization主权的与点对点的"><a class="header" href="#4-商业化-monetization主权的与点对点的">4. 商业化 (Monetization):主权的与点对点的</a></h2>
<p>我们消除了30%的“平台税”。我们的价值交换模型是直接从用户到开发者。</p>
<ul>
<li><code>道器</code>的清单可以声明其商业模式(如一次性购买价格)。</li>
<li>当用户发起购买时,<code></code>会触发我们的**“价值交换服务接口”**。</li>
<li>这将促成一次<strong>点对点P2P交易</strong>,使用用户选择的外部支付协议,将价值直接从用户的钱包,发送到开发者在清单中指定的地址。“大道”在此过程中,扮演的是促成者,而非中间商。</li>
</ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="发展路线图"><a class="header" href="#发展路线图">发展路线图</a></h1>
<p>本文档概述了大道 (Dao OS) 的战略路线图。它的设计旨在做到既雄心勃勃又切合实际,专注于在每个阶段都能交付有意义的增量价值。这是一份活的文档,可能会随着社区反馈和技术突破而演进。</p>
<hr />
<h3 id="第一阶段创世-genesis---基石与桥梁"><a class="header" href="#第一阶段创世-genesis---基石与桥梁">第一阶段:创世 (Genesis) - 基石与桥梁</a></h3>
<ul>
<li><strong>时间</strong>2025年第三季度 - 2025年第四季度</li>
<li><strong>核心目标</strong>:构建核心的<code></code>库,以及让开发者能够开始构建的关键工具。</li>
<li><strong>关键里程碑</strong>:
<ul>
<li>完成 v0.1 版本的<code></code>核心 API 规范。</li>
<li>使用 Rust 开发 v0.1 版本的<code></code>,包含<code>SecretStore</code><code>NoteStore</code>和基础的P2P同步服务。</li>
<li>开发第一个官方的**<code>核化身 (Core Avatar)</code>**:一个用于初始化“大道”、管理密钥和基础诊断的命令行工具。</li>
<li>发布 v0.1 版本的 <strong><code>dao.js</code> SDK</strong>,使任何 Web 应用都能成为一个临时的<code>器化身</code></li>
</ul>
</li>
<li><strong>功能故事</strong>: “作为一名开发者我能用一个命令行工具来初始化我的。然后我可以利用一个简单的Web应用导入<code>dao.js</code>库,并看着它连接上我的‘道’,读取一条测试笔记。这个地基是真实存在的。”</li>
</ul>
<hr />
<h3 id="第二阶段显现-manifestation---第一个道器诞生"><a class="header" href="#第二阶段显现-manifestation---第一个道器诞生">第二阶段:显现 (Manifestation) - 第一个“道器”诞生</a></h3>
<ul>
<li><strong>时间</strong>2026年第一季度 - 2026年第二季度</li>
<li><strong>核心目标</strong>:发布第一个官方的、高价值的<code>道器</code>,以展示生态系统的力量并吸引早期用户。</li>
<li><strong>关键里程碑</strong>:
<ul>
<li>完善并稳定化<code></code>内部的核心服务。</li>
<li>遵循我们的“良木为材”战略,<strong>改造一个结构清晰的开源笔记或密码管理器</strong>,通过集成<code>dao.js</code> SDK使其成为我们的第一个官方<code>器道器</code></li>
<li>实现**“渐进式主权”**的用户上手流程。</li>
<li>上线包含完整用户和开发者文档的项目官网。</li>
</ul>
</li>
<li><strong>功能故事</strong>: “我正在浏览器里使用一个优美、快速、且熟悉的笔记应用。但我知道它的数据是端到端加密的通过P2P网络在我的所有设备间无缝同步没有任何中心服务器。这是第一个真正属于我自己的应用。”</li>
</ul>
<hr />
<h3 id="第三阶段协同-synergy---连接不同的大道"><a class="header" href="#第三阶段协同-synergy---连接不同的大道">第三阶段:协同 (Synergy) - 连接不同的大道</a></h3>
<ul>
<li><strong>时间</strong>2026年第三季度 - 2026年第四季度</li>
<li><strong>核心目标</strong>实现不同用户“大道”之间的、可信的安全交互并为高级AI奠定基础。</li>
<li><strong>关键里程碑</strong>:
<ul>
<li><code></code>中实现 W3C DID 和 VC 模块。</li>
<li>开发一个跨“大道”通信的PoC应用例如分享一篇经过签名、可验证的笔记</li>
<li>启动官方**“大道AI伙伴”<code>核道器</code>**的基础研究和原型设计。</li>
</ul>
</li>
<li><strong>功能故事</strong>: “我拥有了一个主权的数字身份。我可以授权另一个‘大道’用户有限的、加密的访问权限来读取我的一篇笔记,而无需通过任何第三方平台。我们可以组建真正的信任网络。”</li>
</ul>
<hr />
<h3 id="第四阶段生态-ecosystem---应用集市开张"><a class="header" href="#第四阶段生态-ecosystem---应用集市开张">第四阶段:生态 (Ecosystem) - 应用集市开张</a></h3>
<ul>
<li><strong>时间</strong>2027年及以后</li>
<li><strong>核心目标</strong>:将“大道”从一个拥有旗舰应用的平台,演进为一个繁荣、开放的生态系统。</li>
<li><strong>关键里程碑</strong>:
<ul>
<li>发布 v1.0 稳定版的<code></code> API。</li>
<li>发布第一个官方的**“大道AI伙伴”<code>核道器</code>**,为用户提供主动的、智能的辅助。</li>
<li>上线**“应用集市”**协议和一个参考策展索引。</li>
<li>为构建高级原生**<code>器化身</code>**例如用Flutter/Swift提供官方指南和社区支持。</li>
</ul>
</li>
<li><strong>功能故事</strong>: “我的大道活了过来。我的AI伙伴帮助我管理我的一天。我可以在一个去中心化的集市里寻找社区构建的、可信的新<code>道器</code>。我的数字生活是主权的、智能的,并且在不断成长。”</li>
</ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="社区与治理"><a class="header" href="#社区与治理">社区与治理</a></h1>
<p>大道 (Dao OS) 从根本上说是一个社区驱动的项目。我们成功的标准,不仅取决于我们的技术成就,更取决于我们所培育的那个充满活力的、协作的、健康的生态系统。本文档概述了我们集体工作的治理原则与流程。</p>
<h2 id="我们的哲学开放与透明"><a class="header" href="#我们的哲学开放与透明">我们的哲学:开放与透明</a></h2>
<p>我们无条件地致力于自由及开源软件 (FOSS) 的原则。</p>
<ul>
<li><strong>开放开发</strong>: 所有关于核心协议和参考实现的工作,都在公共代码仓库中进行。</li>
<li><strong>开放沟通</strong>: 所有重大的技术和战略讨论,都在公共渠道中进行。</li>
<li><strong>社区所有</strong>: 我们的终极目标,是让“大道”由其用户和开发者社区所拥有和引导。</li>
</ul>
<h2 id="我们的角色从架构师到园丁"><a class="header" href="#我们的角色从架构师到园丁">我们的角色:从“架构师”到“园丁”</a></h2>
<p>“大道”的初始创建者和核心贡献者,将自己的角色视为一个不断演进的过程。</p>
<ul>
<li><strong>在早期阶段(架构师)</strong>: 我们的主要角色是架构师——为项目奠定一个坚实且自洽的基础,定义核心协议,并构建初始工具。</li>
<li><strong>在长期阶段(园丁)</strong>: 随着生态的成熟,我们的角色将从“事必躬亲”转变为“照料花园”。我们将专注于提供更好的工具、维护核心基础设施,并赋能社区去建设和创新。</li>
</ul>
<h2 id="生态策略聚焦与引爆"><a class="header" href="#生态策略聚焦与引爆">生态策略:聚焦与引爆</a></h2>
<p>作为一个由个人开发者发起的项目,我们认识到自身资源的有限性。试图为所有可能的技术栈提供同等的一流支持,是一条通往平庸的道路。</p>
<p>因此,我们采纳**“聚焦一点,引爆生态”**的战略。</p>
<p>我们核心团队的开发精力,将集中于打造<strong>一条“黄金路径”</strong>,使其体验足够高效和愉悦,以此作为吸引第一波开发者的主要催化剂。这条被选定的路径,就是<strong>Nim 统一开发套件</strong>,它利用 Nim 语言的独特能力,从单一代码库构建 WASM 后端和 Web UI 前端。</p>
<p>这并不排斥其他的开发路径(如 Rust + TypeScript 或原生集成)。它们在协议层面依然被完全支持。然而,它们被视为**“社区/高级路径”**,我们依赖社区的力量来构建相应的工具链和最佳实践。</p>
<h2 id="如何贡献"><a class="header" href="#如何贡献">如何贡献</a></h2>
<p>贡献的形式多种多样,每一种都同样宝贵。你可以通过以下方式帮助建设“大道”:</p>
<ul>
<li><strong>核心开发</strong>: 为<code></code>库和核心协议使用Rust贡献代码。</li>
<li><strong><code>道器</code>开发</strong>: 创建新的<code>道器</code>,它可以包含**<code></code>UI组件<strong></strong><code></code>(无界面逻辑)组件**。</li>
<li><strong>文档与翻译</strong>: 改进这些文档,撰写教程,以及将它们翻译成新的语言。</li>
<li><strong>用户支持与社区管理</strong>: 帮助新用户,回答问题,营造一个热情、互助的氛围。</li>
<li><strong>设计与用户体验</strong>: 为参考<code>道器</code>贡献UI/UX设计并为生态定义设计模式。</li>
</ul>
<h2 id="决策流程"><a class="header" href="#决策流程">决策流程</a></h2>
<p>我们的治理模式,被设计为与项目共同成长。</p>
<ol>
<li><strong>早期阶段 (阶段 I-II)</strong>: 决策将由<strong>核心团队</strong>在公共渠道进行开放讨论后做出。</li>
<li><strong>成长阶段 (阶段 III-IV)</strong>: 对于核心协议或架构的重大变更,我们将引入一个正式的 <strong>RFC (请求评论) 流程</strong></li>
<li><strong>成熟阶段 (未来)</strong>: 我们致力于在未来探索并过渡到更去中心化的治理机制。</li>
</ol>
<h2 id="沟通渠道"><a class="header" href="#沟通渠道">沟通渠道</a></h2>
<ul>
<li><strong>GitHub</strong>: 用于所有代码托管、问题追踪和RFC讨论。</li>
<li><strong>Discord / Matrix (待定)</strong>: 用于实时的社区聊天、问答和协作。</li>
</ul>
<div style="break-before: page; page-break-before: always;"></div><h1 id="如何贡献-1"><a class="header" href="#如何贡献-1">如何贡献</a></h1>
<p>我们非常高兴您有兴趣为大道 (Dao OS) 做出贡献!作为一个社区驱动的项目,我们欢迎并珍视所有形式的贡献。本指南概述了您可以参与的方式以及提交贡献的流程。</p>
<h2 id="我们的承诺与行为准则"><a class="header" href="#我们的承诺与行为准则">我们的承诺与行为准则</a></h2>
<p>为了营造一个开放、友善和包容的环境,我们承诺遵守一套行为准则。我们也期望所有贡献者和社区成员都能共同遵守。</p>
<p><em>(注:我们将正式采用 <a href="https://www.contributor-covenant.org/">贡献者契约 (Contributor Covenant)</a> 并在此处提供链接。)</em></p>
<h2 id="贡献方式"><a class="header" href="#贡献方式">贡献方式</a></h2>
<p>您无需成为 Rust 专家才能做出贡献。有很多方式可以提供帮助:</p>
<ul>
<li><strong>核心开发</strong>: 为<code></code>库和核心协议使用Rust贡献代码。</li>
<li><strong><code>道器</code>开发</strong>: 创建新的<code>道器</code>,它可以包含**<code></code>UI组件<strong></strong><code></code>(无界面逻辑)组件**。</li>
<li><strong>文档与翻译</strong>: 改进这些文档,撰写教程,以及将它们翻译成新的语言。</li>
<li><strong>用户支持与社区管理</strong>: 帮助新用户,回答问题,营造一个热情、互助的氛围。</li>
<li><strong>设计与用户体验</strong>: 为参考<code>道器</code>贡献UI/UX设计并为生态定义设计模式。</li>
</ul>
<h2 id="你的第一个-pull-request"><a class="header" href="#你的第一个-pull-request">你的第一个 Pull Request</a></h2>
<p>我们对所有的代码贡献都采用标准的 GitHub Fork &amp; Pull Request 工作流。</p>
<ol>
<li><strong>Fork 仓库</strong>: 创建目标仓库的一份你自己的拷贝(例如 <code>dao-os-docs</code>, <code>meta-unit</code>)。</li>
<li><strong>创建分支</strong>: 从 <code>main</code> 分支创建一个新的分支用于你的变更。请使用描述性的名称(例如 <code>feat/add-note-encryption</code>)。</li>
<li><strong>进行更改</strong>: 编写你的代码及相应的测试。</li>
<li><strong>运行本地检查</strong>: 在提交前,请确保你运行了所有本地测试和代码格式化工具。</li>
<li><strong>Commit 你的变更</strong>: 我们鼓励使用 Conventional Commits 规范,以获得清晰可读的 commit 消息。</li>
<li><strong>Push到你的Fork</strong>: 将你的变更推送到你自己的 Fork 仓库。</li>
<li><strong>开启一个 Pull Request</strong>: 从你的分支向 Dao OS 官方仓库的 <code>main</code> 分支提交一个 Pull Request (PR)。</li>
<li><strong>描述你的 PR</strong>: 在 PR 的描述中,请链接任何相关的 issue并清晰地描述你正在解决的问题和你的解决方案。</li>
<li><strong>等待审查</strong>: 一位核心团队成员将会审查你的 PR提供反馈并在就绪后将其合并。</li>
</ol>
<h2 id="配置你的开发环境"><a class="header" href="#配置你的开发环境">配置你的开发环境</a></h2>
<p><em>(此部分将在每个仓库中被详细填写。)</em></p>
<p>要为 <code>meta-unit</code> 做出贡献,您通常需要:</p>
<ul>
<li>Rust 工具链 (<code>rustup</code>)</li>
<li>WebAssembly 构建目标 (<code>wasm32-wasi</code>)</li>
<li>Protocol Buffers 编译器 (<code>protoc</code>)</li>
</ul>
<p>请参考每个具体仓库中的 <code>README.md</code> 以获取详细的配置指南。</p>
<h2 id="还有问题"><a class="header" href="#还有问题">还有问题?</a></h2>
<p>如果您有任何疑问,请随时在我们官方的沟通渠道中提问。我们很乐意帮助您开始!</p>
</main>
<nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons -->
<div style="clear: both"></div>
</nav>
</div>
</div>
<nav class="nav-wide-wrapper" aria-label="Page navigation">
</nav>
</div>
<script>
window.playground_copyable = true;
</script>
<script src="elasticlunr.min.js"></script>
<script src="mark.min.js"></script>
<script src="searcher.js"></script>
<script src="clipboard.min.js"></script>
<script src="highlight.js"></script>
<script src="book.js"></script>
<!-- Custom JS scripts -->
<script>
window.addEventListener('load', function() {
window.setTimeout(window.print, 100);
});
</script>
</div>
</body>
</html>