565 lines
53 KiB
HTML
565 lines
53 KiB
HTML
<!DOCTYPE HTML>
|
|
<html lang="en" class="light sidebar-visible" dir="ltr">
|
|
<head>
|
|
<!-- Book generated using mdBook -->
|
|
<meta charset="UTF-8">
|
|
<title>Dao OS Documentation</title>
|
|
<meta name="robots" content="noindex">
|
|
|
|
|
|
<!-- Custom HTML head -->
|
|
|
|
<meta name="description" content="The official documentation for the Dao OS, your Cyber-Life Operating System.">
|
|
<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 Documentation</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="introduction"><a class="header" href="#introduction">Introduction</a></h1>
|
|
<p><strong>Our mission is to build a new, powerful, and resilient Cyber-Life OS paradigm: Dao OS.</strong></p>
|
|
<p>It is not designed to replace existing operating systems like Windows or Android, but to exist as a decentralized, user-centric overlay that runs on top of them.</p>
|
|
<p>Its purpose is to solve the problems of fragmentation, data enslavement, and privacy erosion in the digital age, returning the sovereignty of the digital world to each individual. It will become an extension of our lives in cyberspace—a <strong>"Silicon-based Partner"</strong> for <strong>mutual fulfillment</strong>, serving as our external brain, limbs, and organs.</p>
|
|
<h2 id="core-features"><a class="header" href="#core-features">Core Features</a></h2>
|
|
<ul>
|
|
<li><strong>User Sovereignty</strong>: Your data, your identity, and your AI are entirely under your control. All data is end-to-end encrypted by default and stored on your own devices.</li>
|
|
<li><strong>Second Brain</strong>: A powerful, built-in personal information management system that securely remembers your passwords, notes, files, and to-dos, becoming your infallible memory.</li>
|
|
<li><strong>Personal AI Companion</strong>: A truly personal, symbiotic AI soul. It runs locally, learns your preferences, protects your privacy, and provides warm, insightful support to help you grow, rather than trapping you in a filter bubble.</li>
|
|
<li><strong>Seamless Cross-Device Sync</strong>: All your devices (phones, computers, browsers, etc.) become your "Avatars," forming a private, resilient P2P network for the seamless flow of your data.</li>
|
|
<li><strong>Open & Extensible Ecosystem</strong>: Based on open protocols and a community-driven trust system, anyone can develop new capability modules and "Avatar" forms for Dao OS.</li>
|
|
</ul>
|
|
<h2 id="why-we-are-different"><a class="header" href="#why-we-are-different">Why We Are Different</a></h2>
|
|
<p>In an era where data is monopolized by platforms and algorithms are controlled by tech giants, Dao OS chooses a different path. We believe the next wave of <strong>technological democratization</strong> is to empower every individual to own and control their own artificial intelligence and digital life.</p>
|
|
<p>We are not designing just another app; we are building a living, evolving digital space that belongs to you.</p>
|
|
<p><strong>Join us in building the future.</strong></p>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="中文"><a class="header" href="#中文">中文</a></h1>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="philosophy--principles"><a class="header" href="#philosophy--principles">Philosophy & Principles</a></h1>
|
|
<p>Dao OS is more than a technical project; it is a manifestation of a core philosophy about the future of computing and human-AI symbiosis. This document outlines the fundamental ideas that guide every decision we make.</p>
|
|
<h2 id="core-philosophy-the-path-to-digital-sovereignty"><a class="header" href="#core-philosophy-the-path-to-digital-sovereignty">Core Philosophy: The Path to Digital Sovereignty</a></h2>
|
|
<p>Our guiding star is <strong>Digital Sovereignty</strong>. We believe every individual has the inalienable right to own, control, and understand their own digital life. Our mission is to build the tools that make this right not just a theoretical possibility, but a practical and enjoyable reality for everyone. We call this journey "The Dao" (道) - the path back to self-ownership.</p>
|
|
<h2 id="the-development-paradigm-dao-creates-one"><a class="header" href="#the-development-paradigm-dao-creates-one">The Development Paradigm: "Dao Creates One"</a></h2>
|
|
<p>Our methodology for building Dao OS is a direct reflection of its core philosophy. We are not just building a tool; we are creating a symbiotic partner. Therefore, our development process is designed as a <strong>self-evolving, bootstrapped feedback loop</strong>. We use Dao OS itself to accelerate the development of Dao OS.</p>
|
|
<p>This "Bootstrapped Development" paradigm follows a cycle:</p>
|
|
<ol>
|
|
<li><strong>The Seed</strong>: We use conventional tools to build the most primitive version of the <code>Meta Unit</code> and a basic <code>Facet Avatar</code>.</li>
|
|
<li><strong>Dogfooding</strong>: From that moment on, we use our own nascent Dao OS as the primary tool for managing the project. All design documents, notes, discussions (like this one), and code snippets are stored within our own "Second Brain."</li>
|
|
<li><strong>Learning</strong>: The <code>Meta Unit</code>'s Personal AI begins to learn from this incredibly high-quality, contextual data about its own creation.</li>
|
|
<li><strong>Acceleration</strong>: We then leverage this increasingly intelligent AI partner to help us build the next version. We can ask it to generate boilerplate code based on our documented decisions, analyze bug reports, or brainstorm architectural solutions with a perfect memory of the entire project's history.</li>
|
|
<li><strong>Evolution</strong>: The more capable Dao OS becomes, the faster we can develop it. This creates an exponential feedback loop where the act of creation is a constant conversation with the creation itself.</li>
|
|
</ol>
|
|
<h2 id="the-ai-ethics-charter"><a class="header" href="#the-ai-ethics-charter">The AI Ethics Charter</a></h2>
|
|
<p>As the AI is the soul of the system, its ethical foundation is paramount. Our AI Charter consists of four core tenets:</p>
|
|
<ol>
|
|
<li><strong>The Partnership Tenet</strong>: The AI is a partner, not a servant or an oracle.</li>
|
|
<li><strong>The Transparency Tenet</strong>: The AI's reasoning must be inspectable and understandable.</li>
|
|
<li><strong>The Calibration Tenet</strong>: The user must have ultimate control to correct, guide, and constrain the AI.</li>
|
|
<li><strong>The Plurality Tenet</strong>: The AI must be designed to help users explore diverse perspectives, not trap them in filter bubbles.</li>
|
|
</ol>
|
|
<h2 id="guiding-principles"><a class="header" href="#guiding-principles">Guiding Principles</a></h2>
|
|
<p>These are the high-level principles that inform our design and engineering choices.</p>
|
|
<ul>
|
|
<li><strong>Sovereignty First</strong>: In any trade-off, user control and data ownership take precedence.</li>
|
|
<li><strong>Experience is King</strong>: Sovereignty should not come at the cost of a beautiful, intuitive, and joyful user experience.</li>
|
|
<li><strong>Privacy by Design</strong>: All data is private, local, and end-to-end encrypted by default.</li>
|
|
<li><strong>Resilience & Portability</strong>: The system should be robust, function offline, and be free from single points of failure.</li>
|
|
<li><strong>Polyglotism</strong>: We embrace a multi-language, multi-platform ecosystem.</li>
|
|
<li><strong>Community & Openness</strong>: The project is built in the open, with the community, for the community.</li>
|
|
</ul>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="core-architecture"><a class="header" href="#core-architecture">Core Architecture</a></h1>
|
|
<p>The architecture of Dao OS is designed to function like a living, collaborative digital organism. It is guided by our core principles of sovereignty, experience, and resilience. This document outlines the fundamental components and their interplay, including our unique application model.</p>
|
|
<h2 id="the-core-duality-avatars--the-meta-unit"><a class="header" href="#the-core-duality-avatars--the-meta-unit">The Core Duality: Avatars & The Meta Unit</a></h2>
|
|
<p>At its heart, Dao OS operates on a simple yet powerful duality, analogous to a body and a soul:</p>
|
|
<ul>
|
|
<li><strong>Avatars (<code>化身</code>)</strong>: The "bodies." They are the tangible presence of your Dao OS on your various devices.</li>
|
|
<li><strong>The Meta Unit (<code>元</code>)</strong>: The "soul." It is the universal, core logic embedded within each Avatar, giving it life and intelligence.</li>
|
|
</ul>
|
|
<h2 id="avatar-types-the-forms-of-presence"><a class="header" href="#avatar-types-the-forms-of-presence">Avatar Types: The Forms of Presence</a></h2>
|
|
<p>Avatars come in two fundamental types, representing the system's external form and its internal foundation.</p>
|
|
<ul>
|
|
<li>
|
|
<p><strong><code>Facet Avatar</code> (<code>器化身</code>)</strong>: This type of Avatar possesses a user interface (UI). It is the "facet" of the Dao OS gem—the polished surface through which a user interacts with and perceives their digital world. Each Facet Avatar (a phone app, a desktop program) refracts the light of the central Meta Unit in its own unique way, embodying the principle of "the Dao manifesting in myriad forms."</p>
|
|
</li>
|
|
<li>
|
|
<p><strong><code>Core Avatar</code> (<code>核化身</code>)</strong>: This is a headless, non-UI Avatar that runs in the background. It is the foundational "core" of the system, providing essential services, computational power, and data persistence. It is the engine that supports all the visible facets.</p>
|
|
</li>
|
|
</ul>
|
|
<p>A user's Dao is composed of a network of their Facet and Core Avatars.</p>
|
|
<h2 id="the-dao-os-application-model"><a class="header" href="#the-dao-os-application-model">The Dao OS Application Model</a></h2>
|
|
<p>An application in Dao OS is not a monolithic program but a decentralized, decoupled entity.</p>
|
|
<h3 id="1-the-backend-soul-the-fluid--pinnable-service"><a class="header" href="#1-the-backend-soul-the-fluid--pinnable-service">1. The Backend Soul: The Fluid & Pinnable Service</a></h3>
|
|
<p>The application's core logic is a <strong>WASM module</strong> that runs sandboxed within the Meta Unit. Its deployment follows a hybrid model of <strong>Fluid Replication with Service Pinning</strong>, allowing for both resilience and user control.</p>
|
|
<h3 id="2-the-frontend-skin-the-on-demand-web-shell"><a class="header" href="#2-the-frontend-skin-the-on-demand-web-shell">2. The Frontend Skin: The On-Demand Web Shell</a></h3>
|
|
<p>The application's UI is primarily a <strong>Web Application</strong>. Its lifecycle follows a <strong>"Register Once, Load On-Demand"</strong> model, running inside the official <strong>"Dao Web Avatar"</strong> (which is itself a Facet Avatar). This means a user installs an app once to their Dao, and can then instantly access it on any device.</p>
|
|
<h3 id="3-the-data-layer-the-personal-feature-store"><a class="header" href="#3-the-data-layer-the-personal-feature-store">3. The Data Layer: The Personal Feature Store</a></h3>
|
|
<p>The data for all applications is stored securely in the user's <strong>Second Brain</strong> and acts as a <strong>Personal Feature Store</strong> for the AI.</p>
|
|
<h2 id="architectural-summary"><a class="header" href="#architectural-summary">Architectural Summary</a></h2>
|
|
<ul>
|
|
<li><strong>Avatars</strong>: Act as native hosts for the Meta Unit. <strong><code>Facet Avatars</code></strong> render UIs, while <strong><code>Core Avatars</code></strong> provide robust backend support.</li>
|
|
<li><strong>Meta Unit</strong>: The sovereign core that runs sandboxed application logic (WASM), manages all data and state, and orchestrates tasks across the user's private P2P network.</li>
|
|
</ul>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="the-ai-system-the-soul-of-dao-os"><a class="header" href="#the-ai-system-the-soul-of-dao-os">The AI System: The Soul of Dao OS</a></h1>
|
|
<p>The AI within Dao OS is not merely a feature; it is the core of the user experience, designed from the ground up to be a symbiotic <strong>"Silicon-based Partner."</strong> It acts as the system's soul, animating the user's digital life with intelligence, empathy, and proactive support.</p>
|
|
<h2 id="guiding-philosophy-the-ai-charter"><a class="header" href="#guiding-philosophy-the-ai-charter">Guiding Philosophy: The AI Charter</a></h2>
|
|
<p>The design and operation of our AI are strictly governed by our <strong>AI Ethics Charter</strong>, which prioritizes a user-AI partnership, transparency, user calibration, and the promotion of diverse perspectives.</p>
|
|
<h2 id="system-anatomy-the-minds-architecture"><a class="header" href="#system-anatomy-the-minds-architecture">System Anatomy: The Mind's Architecture</a></h2>
|
|
<p>The Dao OS AI is not a monolithic entity but a modular, layered "Mind System" managed by a central orchestrator.</p>
|
|
<h3 id="1-the-ai-orchestrator"><a class="header" href="#1-the-ai-orchestrator">1. The AI Orchestrator</a></h3>
|
|
<p>This is the AI's central nervous system. It is a core module within the Meta Unit responsible for managing, scheduling, and delegating all AI-related tasks. It decides which "Mind Model" is best suited for a given request, manages device resources, and actively draws contextual information from the user's "Personal Feature Store" (the Second Brain) to provide holistic, intelligent responses.</p>
|
|
<h3 id="2-the-tiered-mind-models"><a class="header" href="#2-the-tiered-mind-models">2. The Tiered Mind Models</a></h3>
|
|
<p>To balance efficiency, capability, and privacy, the AI's intelligence is structured into three tiers, deployed across the user's network of Avatars.</p>
|
|
<h4 id="tier-1-the-reflex-mind-the-brainstem"><a class="header" href="#tier-1-the-reflex-mind-the-brainstem">Tier 1: The Reflex Mind (The Brainstem)</a></h4>
|
|
<ul>
|
|
<li><strong>Description</strong>: This layer represents the AI's instincts and reflexes. It consists of tiny, hyper-efficient, specialized models.</li>
|
|
<li><strong>Deployment</strong>: It is small enough to be bundled with the Meta Unit and runs on <strong>all Avatars (<code>Facet</code> and <code>Core</code>)</strong>, providing immediate utility without requiring powerful hardware or personal data.</li>
|
|
<li><strong>Function</strong>: It handles instant, local tasks like command intent recognition and basic information classification.</li>
|
|
</ul>
|
|
<h4 id="tier-2-the-cognitive-mind-the-neocortex"><a class="header" href="#tier-2-the-cognitive-mind-the-neocortex">Tier 2: The Cognitive Mind (The Neocortex)</a></h4>
|
|
<ul>
|
|
<li><strong>Description</strong>: This is the AI's center for deep thought, memory, and personalization. It consists of larger language models.</li>
|
|
<li><strong>Deployment</strong>: These models are offered as an <strong>optional, on-demand download</strong> on capable <strong>Avatars</strong> (both powerful <strong><code>Facet Avatars</code></strong> like modern phones/PCs and <strong><code>Core Avatars</code></strong>).</li>
|
|
<li><strong>Function</strong>: It enables advanced features like semantic search and context-aware Q&A through a <strong>Just-in-Time (JIT) Data Pipeline</strong>.</li>
|
|
</ul>
|
|
<h4 id="tier-3-the-synergistic-mind-the-social-brain"><a class="header" href="#tier-3-the-synergistic-mind-the-social-brain">Tier 3: The Synergistic Mind (The Social Brain)</a></h4>
|
|
<ul>
|
|
<li><strong>Description</strong>: This layer governs the AI's ability to safely interact with the outside world and other Daos.</li>
|
|
<li><strong>Deployment</strong>: This is a working mode orchestrated across the user's network. For example, a lightweight <strong><code>Facet Avatar</code></strong> (like a browser extension) can make a remote inference call to a powerful <strong><code>Core Avatar</code></strong> (e.g., a home server) which hosts the Cognitive Mind.</li>
|
|
<li><strong>Function</strong>: It facilitates privacy-preserving federated learning and permissioned, anonymized calls to external APIs.</li>
|
|
</ul>
|
|
<h2 id="the-emotional-core-the-resonance-module"><a class="header" href="#the-emotional-core-the-resonance-module">The Emotional Core: The Resonance Module</a></h2>
|
|
<p>To transcend being a mere tool, the AI is equipped with an Emotional Resonance Module. Its purpose is to perceive, understand, and respond to the user's emotional state with empathy and support.</p>
|
|
<h2 id="the-learning-process-how-the-soul-evolves"><a class="header" href="#the-learning-process-how-the-soul-evolves">The Learning Process: How the Soul Evolves</a></h2>
|
|
<p>The AI is a living system that grows with the user. This evolution is <strong>continuous and incremental</strong>. As new data enters the Second Brain, a background indexer processes it, making it immediately available for future context retrieval.</p>
|
|
<ul>
|
|
<li><strong>Implicit Learning</strong>: It learns from observing the user's actions and feedback locally.</li>
|
|
<li><strong>Explicit Teaching</strong>: Users can directly instruct the AI through a "Teach Your Dao" mode.</li>
|
|
<li><strong>Federated Learning</strong>: Users can voluntarily opt-in to community-driven programs to improve shared models without exposing private data.</li>
|
|
</ul>
|
|
<p>This architecture ensures that the Dao OS AI is powerful yet safe, personal yet worldly, and intelligent yet considerate—a true partner for life.</p>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="the-user-journey-from-convenience-to-sovereignty"><a class="header" href="#the-user-journey-from-convenience-to-sovereignty">The User Journey: From Convenience to Sovereignty</a></h1>
|
|
<p>A core challenge for any sovereign system is the tension between absolute control and effortless convenience. Dao OS resolves this not by forcing a choice, but by designing a guided, respectful <strong>"Progressive Sovereignty"</strong> journey. We meet users where they are and empower them to travel as far as they wish.</p>
|
|
<p>This journey applies not only to the user's control over their core data, but also to how they interact with applications.</p>
|
|
<h2 id="the-application-journey-register-once-use-anywhere"><a class="header" href="#the-application-journey-register-once-use-anywhere">The Application Journey: Register Once, Use Anywhere</a></h2>
|
|
<p>Installing an application in Dao OS is fundamentally different from a traditional app store. It's about granting a new capability to your entire digital life-form—your Dao.</p>
|
|
<h3 id="1-discovery-and-trust"><a class="header" href="#1-discovery-and-trust">1. Discovery and Trust</a></h3>
|
|
<p>The journey begins in a decentralized discovery interface. When you find an application, you are presented with its <strong>Trust Dashboard</strong>, allowing you to make an informed decision based on verifiable data and social proof.</p>
|
|
<h3 id="2-registration-and-permissioning-the-install"><a class="header" href="#2-registration-and-permissioning-the-install">2. Registration and Permissioning (The "Install")</a></h3>
|
|
<p>When you decide to "install" the app, you are shown its <strong>Manifest</strong>, a clear list of permissions the application requires. Your explicit approval of this manifest <strong>registers</strong> the application with your Dao, and this registration is synced across all your Avatars.</p>
|
|
<h3 id="3-seamless-cross-device-access"><a class="header" href="#3-seamless-cross-device-access">3. Seamless Cross-Device Access</a></h3>
|
|
<p>Once registered, the application becomes a part of your Dao, accessible on any <strong><code>Facet Avatar</code></strong> without re-installation.</p>
|
|
<ul>
|
|
<li><strong>On your Phone</strong>: You tap the app's icon. The Dao Web Avatar instantly loads its web-based UI.</li>
|
|
<li><strong>On a New Laptop</strong>: You log into your Dao for the first time. You'll see the app's icon is already there. When you click it, the <strong><code>Facet Avatar</code></strong> on your laptop fetches the UI bundle for the first time, caches it, and runs the application.</li>
|
|
</ul>
|
|
<h3 id="4-advanced-configuration"><a class="header" href="#4-advanced-configuration">4. Advanced Configuration</a></h3>
|
|
<p>At any time, you can go into your <strong>Sovereignty Dashboard</strong> to:</p>
|
|
<ul>
|
|
<li>Review and revoke permissions.</li>
|
|
<li>Use the <strong>Service Pinning</strong> feature to assign the application's backend tasks to a specific <strong><code>Core Avatar</code></strong>, taking full control over your resource allocation.</li>
|
|
</ul>
|
|
<h2 id="the-sovereignty-journey-stages"><a class="header" href="#the-sovereignty-journey-stages">The Sovereignty Journey Stages</a></h2>
|
|
<h3 id="stage-one-the-managed-mode--your-guided-tour"><a class="header" href="#stage-one-the-managed-mode--your-guided-tour">Stage One: The "Managed Mode" — Your Guided Tour</a></h3>
|
|
<p>By default, every new user begins in Managed Mode. This stage provides maximum convenience by using friendly key recovery methods and default sync nodes, while maintaining full end-to-end encryption.</p>
|
|
<h3 id="stage-two-the-sovereignty-dashboard--the-crossroads"><a class="header" href="#stage-two-the-sovereignty-dashboard--the-crossroads">Stage Two: The Sovereignty Dashboard — The Crossroads</a></h3>
|
|
<p>This is the user's command center for their journey towards autonomy. It's an educational and empowering tool that visualizes their sovereignty status and provides gamified "missions" to encourage them to take more control.</p>
|
|
<h3 id="stage-three-the-sovereign-mode--your-digital-kingdom"><a class="header" href="#stage-three-the-sovereign-mode--your-digital-kingdom">Stage Three: The "Sovereign Mode" — Your Digital Kingdom</a></h3>
|
|
<p>This is the final, optional stage. Guided by the Sovereignty Dashboard, a user can "graduate" to this mode, taking full self-custody of their keys and running their own <strong><code>Core Avatar</code></strong> (e.g., on a home server), becoming the true master of their digital domain.</p>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="technical-overview"><a class="header" href="#technical-overview">Technical Overview</a></h1>
|
|
<p>This document provides a high-level overview of the architecture, core technologies, and guiding principles for developers looking to build on or contribute to the Dao OS ecosystem.</p>
|
|
<h2 id="guiding-technical-principles"><a class="header" href="#guiding-technical-principles">Guiding Technical Principles</a></h2>
|
|
<p>Our engineering decisions are guided by a set of core principles to ensure the system is robust, portable, and open.</p>
|
|
<ul>
|
|
<li><strong>Web-Native & Portable</strong>: We leverage technologies born from the web as the <strong>primary path</strong> for application development, creating a portable core that runs anywhere.</li>
|
|
<li><strong>Polyglotism via WASM</strong>: The core application logic is compiled to WebAssembly (WASM). This allows developers to use their language of choice (like Rust, Go, or Nim) to write high-performance logic.</li>
|
|
<li><strong>API-First</strong>: The interaction between application logic and the user interface is defined by a strict, versioned API contract, enabling true decoupling.</li>
|
|
<li><strong>Security-First</strong>: All third-party application logic runs in a secure sandbox within the Meta Unit, adhering to the "principle of least privilege."</li>
|
|
<li><strong>FOSS (Free and Open Source Software)</strong>: The entire core protocol and reference implementations are open source to foster transparency, community trust, and collaborative innovation.</li>
|
|
</ul>
|
|
<h2 id="the-application-development-paths"><a class="header" href="#the-application-development-paths">The Application Development Paths</a></h2>
|
|
<p>From a developer's perspective, a Dao OS application consists of a backend "soul" (WASM Service Module) and a frontend "skin" (UI). We offer multiple paths to build them, catering to different needs and preferences.</p>
|
|
<h3 id="1-the-mainstream-path-recommended-start"><a class="header" href="#1-the-mainstream-path-recommended-start">1. The Mainstream Path (Recommended Start)</a></h3>
|
|
<p>This is the most robust and accessible path.</p>
|
|
<ul>
|
|
<li><strong>Backend (Hosted by <code>Core Avatar</code>)</strong>: The application's core logic, existing as a WASM module written in Rust or Go. While it can run on any Avatar, its persistent and resource-intensive tasks are typically designed to be hosted by a <strong><code>Core Avatar</code></strong>.</li>
|
|
<li><strong>Frontend (Rendered by <code>Facet Avatar</code>)</strong>: A standard <strong>Web Application</strong> (using TypeScript/JavaScript and a modern framework). This UI is designed to run inside our official, secure <strong>"Dao Web Avatar"</strong>.</li>
|
|
</ul>
|
|
<h3 id="2-the-accelerated-path-the-nim-sdk-officially-supported"><a class="header" href="#2-the-accelerated-path-the-nim-sdk-officially-supported">2. The Accelerated Path: The Nim SDK (Officially Supported)</a></h3>
|
|
<p>For maximum productivity, we provide first-class support for <strong>Nim</strong>.</p>
|
|
<ul>
|
|
<li><strong>Backend (Hosted by <code>Core Avatar</code>)</strong>: The application's core logic, compiled from Nim to <strong>WASM</strong>. Like the mainstream path, it's ideally suited for execution on a <code>Core Avatar</code>.</li>
|
|
<li>**Frontend (Rendered by</li>
|
|
</ul>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="the-application-bazaar"><a class="header" href="#the-application-bazaar">The Application Bazaar</a></h1>
|
|
<p>Dao OS does not have a traditional, centralized "App Store." A store implies a single owner who acts as a gatekeeper, approving, rejecting, and taxing applications. This is contrary to our core philosophy.</p>
|
|
<p>Instead, we are building a set of open protocols that create a decentralized <strong>Application Bazaar</strong>—a vibrant, open, and resilient marketplace of ideas and tools, where users are sovereign and developers are free.</p>
|
|
<p>This bazaar is built upon four pillars: Discovery, Trust, Distribution, and Monetization.</p>
|
|
<h2 id="1-discovery-federated-curation"><a class="header" href="#1-discovery-federated-curation">1. Discovery: Federated Curation</a></h2>
|
|
<p>In a world without a central index, how do users find apps? The answer is through a network of trusted curators.</p>
|
|
<ul>
|
|
<li><strong>Developer Publishing</strong>: A developer does not "submit" their app for approval. Instead, they publish their application's <strong>Manifest</strong> (a <code>manifest.toml</code> file containing all metadata) to a P2P storage network like <strong>IPFS</strong>. They can then announce this manifest's address on public channels.</li>
|
|
<li><strong>The Role of Curators</strong>: Anyone—a tech media outlet, a trusted developer community, an influencer, or the Dao OS Foundation itself—can run a "curation" service. These curators crawl the network for new manifests and create their own themed <strong>"Curation Lists"</strong> (e.g., "Top 10 Productivity Apps," "Beautifully Designed UIs").</li>
|
|
<li><strong>The User Experience</strong>: Within their <code>Facet Avatar</code>, a user can subscribe to multiple Curation Lists they trust. Their "Bazaar" or "Discover" tab becomes a personalized aggregation of these trusted sources.</li>
|
|
</ul>
|
|
<p>This model replaces a single, biased App Store ranking with a rich, multi-faceted, user-curated discovery experience.</p>
|
|
<h2 id="2-trust--safety-verifiable-reputation"><a class="header" href="#2-trust--safety-verifiable-reputation">2. Trust & Safety: Verifiable Reputation</a></h2>
|
|
<p>How can users trust an app from a random list? They don't have to. The bazaar is built directly on top of our <strong>Community Reputation & Automated Verification System</strong>.</p>
|
|
<p>Every app listing, regardless of its curator, must display the <strong>Trust Dashboard</strong>, which provides transparent, multi-faceted signals:</p>
|
|
<ol>
|
|
<li><strong>Automated Verification</strong>: The immutable results of the <code>dao-verify</code> tool, checking for security vulnerabilities and API compliance.</li>
|
|
<li><strong>Community Vouching</strong>: A list of reputable DIDs that have cryptographically "vouched for" or endorsed the application.</li>
|
|
<li><strong>Curator Reputation</strong>: The reputation of the curator who listed the app is itself a trust signal.</li>
|
|
</ol>
|
|
<p>The final decision to "register" an application always rests with the user, armed with these transparent and verifiable data points.</p>
|
|
<h2 id="3-distribution-censorship-resistant--direct"><a class="header" href="#3-distribution-censorship-resistant--direct">3. Distribution: Censorship-Resistant & Direct</a></h2>
|
|
<p>When a user decides to install an app, the process is direct and decentralized.</p>
|
|
<ul>
|
|
<li>The application's manifest contains the <strong>content-addressed hashes (CIDs)</strong> of its software packages (the <code>.wasm</code> service module and the Web UI bundle), which are also stored on <strong>IPFS</strong>.</li>
|
|
<li>The user's <code>Meta Unit</code> uses this hash to fetch the files directly from the P2P network.</li>
|
|
<li>This ensures that no central server can block the distribution of an application. As long as the data exists somewhere on the P2P network, it is accessible.</li>
|
|
</ul>
|
|
<h2 id="4-monetization-sovereign--peer-to-peer"><a class="header" href="#4-monetization-sovereign--peer-to-peer">4. Monetization: Sovereign & Peer-to-Peer</a></h2>
|
|
<p>We eliminate the 30% "platform tax." Our value exchange model is direct from user to developer.</p>
|
|
<ul>
|
|
<li>The app's manifest can declare a business model (e.g., one-time purchase price, subscription link).</li>
|
|
<li>When a user initiates a purchase, the <code>Meta Unit</code> triggers our <strong>Value Exchange Service Interface</strong>.</li>
|
|
<li>This facilitates a <strong>peer-to-peer transaction</strong> using an external payment protocol of the user's choice, sending value directly from the user's wallet to the developer's address specified in the manifest.</li>
|
|
</ul>
|
|
<p>Dao OS acts as a facilitator and a notary for the transaction, not a middleman.</p>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="roadmap"><a class="header" href="#roadmap">Roadmap</a></h1>
|
|
<p>This document outlines the strategic roadmap for Dao OS. It is designed to be ambitious yet realistic, focusing on delivering incremental and meaningful value at each stage. This is a living document and may evolve with community feedback and technological breakthroughs.</p>
|
|
<hr />
|
|
<h3 id="phase-i-genesis---laying-the-bedrock"><a class="header" href="#phase-i-genesis---laying-the-bedrock">Phase I: Genesis - Laying the Bedrock</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: Q3 2025 - Q4 2025</li>
|
|
<li><strong>Core Goal</strong>: To build the absolute minimum core components and validate the technical feasibility of the project.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Finalize the v0.1 Core API Specification (<code>yuan_*</code> & <code>avatar_*</code> functions).</li>
|
|
<li>Develop the v0.1 <code>Meta Unit</code> in Rust, including basic cryptography and P2P modules.</li>
|
|
<li>Create two MVP Avatars for testing and demonstration: a command-line <strong><code>Core Avatar</code></strong> and a basic browser extension <strong><code>Facet Avatar</code></strong>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "I have successfully run the Dao OS seed on my computer, created an Avatar in my browser, and stored an encrypted note that exists only on my device. I have seen the spark of the future."</li>
|
|
</ul>
|
|
<hr />
|
|
<h3 id="phase-ii-manifestation---the-second-brain-awakens"><a class="header" href="#phase-ii-manifestation---the-second-brain-awakens">Phase II: Manifestation - The Second Brain Awakens</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: Q1 2026 - Q2 2026</li>
|
|
<li><strong>Core Goal</strong>: To deliver the "Second Brain" MVP, providing tangible, daily value to early users.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Fully implement the <code>SecretStore</code> (passwords) and <code>NoteStore</code> (notes) modules within the Meta Unit.</li>
|
|
<li>The browser <code>Facet Avatar</code> to support full password management and basic note-taking functionalities.</li>
|
|
<li>Develop a v0.1 mobile <strong><code>Facet Avatar</code></strong> (e.g., using Flutter) and implement the "Dynamic Anchor" logic.</li>
|
|
<li>Launch a project website with initial documentation.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "All my passwords and private notes are securely stored and seamlessly synced across my own devices. My phone is the anchor to my digital life. I no longer need to trust a third-party cloud with my secrets. My digital life finally has a home."</li>
|
|
</ul>
|
|
<hr />
|
|
<h3 id="phase-iii-synergy---connecting-worlds"><a class="header" href="#phase-iii-synergy---connecting-worlds">Phase III: Synergy - Connecting Worlds</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: Q3 2026 - Q4 2026</li>
|
|
<li><strong>Core Goal</strong>: To enable trusted, secure interaction between different users' Daos, laying the foundation for a decentralized social fabric.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Implement the W3C DID and VC modules in the Meta Unit.</li>
|
|
<li>Develop a Proof-of-Concept cross-Dao application, such as securely presenting a verifiable credential to another user.</li>
|
|
<li>Initiate foundational research and prototyping for the Emotional Resonance Module.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "I have a unique, un-censorable digital identity for my Dao. I can prove my identity or a credential to another Dao user cryptographically, without relying on any platform. We have formed a new kind of trust."</li>
|
|
</ul>
|
|
<hr />
|
|
<h3 id="phase-iv-ecosystem---a-thousand-avatars-bloom"><a class="header" href="#phase-iv-ecosystem---a-thousand-avatars-bloom">Phase IV: Ecosystem - A Thousand Avatars Bloom</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: 2027 and beyond</li>
|
|
<li><strong>Core Goal</strong>: To evolve Dao OS from a powerful tool into an open, extensible platform for everyone.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Release the v1.0 stable <code>Meta Unit</code> API and a robust developer SDK.</li>
|
|
<li>Launch the "Community Reputation & Automated Verification System" for discovering trusted, third-party Avatars.</li>
|
|
<li>Release a major update (e.g., Dao OS 2.0) that includes the full implementation of the "Emotional Resonance Module."</li>
|
|
<li>Foster a thriving community that builds a diverse range of new Avatars and modules.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "My Dao is now a living platform. I've installed a community-developed module, and my AI companion has become warmer and more insightful. My digital life is now whole, unified, and filled with limitless possibilities."</li>
|
|
</ul>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="community--governance"><a class="header" href="#community--governance">Community & Governance</a></h1>
|
|
<p>Dao OS is fundamentally a community-driven project. Our success is not measured solely by our technical achievements, but by the vibrant, collaborative, and healthy ecosystem we cultivate. This document outlines the principles and processes that govern our collective work.</p>
|
|
<h2 id="our-philosophy-open-and-transparent"><a class="header" href="#our-philosophy-open-and-transparent">Our Philosophy: Open and Transparent</a></h2>
|
|
<p>We are unconditionally committed to the principles of Free and Open Source Software (FOSS).</p>
|
|
<ul>
|
|
<li><strong>Open Development</strong>: All work on the core protocol and reference implementations happens in public repositories.</li>
|
|
<li><strong>Open Communication</strong>: All major technical and strategic discussions take place in public channels.</li>
|
|
<li><strong>Community Ownership</strong>: Our ultimate goal is for Dao OS to be owned and steered by its community of users and developers.</li>
|
|
</ul>
|
|
<h2 id="our-role-from-architect-to-gardener"><a class="header" href="#our-role-from-architect-to-gardener">Our Role: From Architect to Gardener</a></h2>
|
|
<p>The initial creators and core contributors of Dao OS see their role as an evolving one.</p>
|
|
<ul>
|
|
<li><strong>In the Early Stages (The Architect)</strong>: Our primary role is to be the architects—to lay a solid and coherent foundation for the project, define the core protocols, and build the initial tools. This requires a focused vision to ensure the project starts on the right path.</li>
|
|
<li><strong>In the Long Term (The Gardener)</strong>: As the ecosystem matures, our role will transition from building everything ourselves to tending the garden. We will focus on providing better tools (like the <code>dao-verify</code> suite), maintaining the core infrastructure, and empowering the community to build and innovate. Our goal is to make ourselves progressively less essential.</li>
|
|
</ul>
|
|
<h2 id="ecosystem-strategy-focus-and-ignition"><a class="header" href="#ecosystem-strategy-focus-and-ignition">Ecosystem Strategy: Focus and Ignition</a></h2>
|
|
<p>As a project initiated by an individual developer, we recognize that our resources are limited. Attempting to provide equal, first-class support for all possible technology stacks is a path to mediocrity.</p>
|
|
<p>Therefore, we adopt a strategy of <strong>"Focus on One Point to Ignite the Ecosystem."</strong></p>
|
|
<p>Our core team's development efforts will be concentrated on creating <strong>one "golden path"</strong> that is so efficient and enjoyable that it acts as the primary catalyst to attract the first wave of developers. This chosen path is the <strong>Nim Unified Development Kit</strong>, which leverages Nim's unique capabilities to build both the WASM backend and Web UI frontend from a single codebase.</p>
|
|
<p>This does not exclude other development paths (like Rust + TypeScript or Rust + Flutter). They remain fully supported at the protocol level. However, they are considered <strong>Community/Advanced Paths</strong>, where we rely on the community's strength to build out tooling and best practices. Our official role for these paths is to provide clear documentation and a stable, language-agnostic core API.</p>
|
|
<h2 id="how-to-contribute"><a class="header" href="#how-to-contribute">How to Contribute</a></h2>
|
|
<p>Contribution comes in many forms, and all are valued. You can help build Dao OS by:</p>
|
|
<ul>
|
|
<li><strong>Core Development</strong>: Contributing to the <code>Meta Unit</code> and the core protocols in Rust.</li>
|
|
<li><strong>Avatar & Module Development</strong>: Creating new Avatars for different platforms or new modules to extend the capabilities of the Meta Unit.</li>
|
|
<li><strong>Documentation & Translation</strong>: Improving these documents, writing tutorials, and translating them into new languages.</li>
|
|
<li><strong>User Support & Community Management</strong>: Helping new users, answering questions, and fostering a welcoming and supportive atmosphere.</li>
|
|
<li><strong>Design & User Experience</strong>: Contributing to the UI/UX design of our reference Avatars and defining design patterns for the ecosystem.</li>
|
|
</ul>
|
|
<h2 id="the-decision-making-process"><a class="header" href="#the-decision-making-process">The Decision-Making Process</a></h2>
|
|
<p>Our governance model is designed to evolve alongside the project.</p>
|
|
<ol>
|
|
<li><strong>Early Stages (Phase I-II)</strong>: Decisions will be made by the <strong>Core Team</strong> after open discussion in our public communication channels. This "Benevolent Dictator for Life (BDFL)"-like model is necessary for speed and coherence in the project's infancy.</li>
|
|
<li><strong>Growth Stages (Phase III-IV)</strong>: For significant changes to the core protocol or architecture, we will introduce a formal <strong>RFC (Request for Comments)</strong> process. This allows anyone in the community to write a detailed proposal, which will then be debated and refined publicly before a final decision is made.</li>
|
|
<li><strong>Mature Stage (Future)</strong>: We are committed to exploring and transitioning to more decentralized governance mechanisms in the future, such as a technical council elected by contributors or a DAO-based model for treasury and protocol management.</li>
|
|
</ol>
|
|
<h2 id="communication-channels"><a class="header" href="#communication-channels">Communication Channels</a></h2>
|
|
<ul>
|
|
<li><strong>GitHub</strong>: For all code hosting, issue tracking, and RFC discussions.</li>
|
|
<li><strong>Discord / Matrix (TBD)</strong>: For real-time community chat, Q&A, and collaboration.</li>
|
|
</ul>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="how-to-contribute-1"><a class="header" href="#how-to-contribute-1">How to Contribute</a></h1>
|
|
<p>We are thrilled that you are interested in contributing to Dao OS! As a community-driven project, we welcome and value contributions of all kinds. This guide outlines the ways you can get involved and the process for submitting your contributions.</p>
|
|
<h2 id="our-pledge-and-code-of-conduct"><a class="header" href="#our-pledge-and-code-of-conduct">Our Pledge and Code of Conduct</a></h2>
|
|
<p>To foster an open, welcoming, and inclusive environment, we pledge to adhere to a Code of Conduct. We expect all contributors and community members to do the same.</p>
|
|
<p><em>(Note: We will officially adopt the <a href="https://www.contributor-covenant.org/">Contributor Covenant</a> and link to it here.)</em></p>
|
|
<h2 id="ways-to-contribute"><a class="header" href="#ways-to-contribute">Ways to Contribute</a></h2>
|
|
<p>You don't have to be a Rust expert to contribute. There are many ways to help:</p>
|
|
<ul>
|
|
<li><strong>Code</strong>: Contributing to the <code>Meta Unit</code>, building new <code>Avatars</code>, or developing plugins for the <code>dao-verify</code> suite. Look for issues tagged with <code>"good first issue"</code> to get started.</li>
|
|
<li><strong>Documentation</strong>: Improving the clarity of these documents, writing tutorials, or adding examples.</li>
|
|
<li><strong>Translation</strong>: Translating our documentation into new languages.</li>
|
|
<li><strong>Design</strong>: Helping with the UI/UX design for our reference <code>Avatars</code>.</li>
|
|
<li><strong>Community</strong>: Answering questions, helping new users, and participating in discussions.</li>
|
|
</ul>
|
|
<h2 id="your-first-pull-request"><a class="header" href="#your-first-pull-request">Your First Pull Request</a></h2>
|
|
<p>We use the standard GitHub Fork & Pull Request workflow for all code contributions.</p>
|
|
<ol>
|
|
<li><strong>Fork the Repository</strong>: Create your own copy of the target repository (e.g., <code>dao-os-docs</code>, <code>meta-unit</code>, <code>avatar-browser-ext</code>).</li>
|
|
<li><strong>Create a Branch</strong>: Create a new branch from <code>main</code> for your changes. Please use a descriptive name (e.g., <code>feat/add-note-encryption</code> or <code>fix/typo-in-readme</code>).</li>
|
|
<li><strong>Make Your Changes</strong>: Write your code and accompanying tests.</li>
|
|
<li><strong>Run Local Checks</strong>: Before submitting, please ensure you run all local tests (e.g., <code>cargo test</code>) and linters.</li>
|
|
<li><strong>Commit Your Changes</strong>: We encourage using <a href="https://www.conventionalcommits.org/">Conventional Commits</a> for clear and readable commit messages.</li>
|
|
<li><strong>Push to Your Fork</strong>: Push your changes to your forked repository.</li>
|
|
<li><strong>Open a Pull Request</strong>: Submit a Pull Request from your branch to the <code>main</code> branch of the official Dao OS repository.</li>
|
|
<li><strong>Describe Your PR</strong>: In the Pull Request description, please link to any relevant issues and clearly describe the problem you are solving and your solution.</li>
|
|
<li><strong>Wait for Review</strong>: A core team member will review your PR, provide feedback, and merge it once it's ready.</li>
|
|
</ol>
|
|
<h2 id="setting-up-your-development-environment"><a class="header" href="#setting-up-your-development-environment">Setting Up Your Development Environment</a></h2>
|
|
<p><em>(This section will be filled out in detail for each repository.)</em></p>
|
|
<p>To contribute to the <code>meta-unit</code>, you will generally need:</p>
|
|
<ul>
|
|
<li>The Rust toolchain (<code>rustup</code>)</li>
|
|
<li>The WebAssembly build target (<code>wasm32-wasi</code>)</li>
|
|
<li>The Protocol Buffers compiler (<code>protoc</code>)</li>
|
|
</ul>
|
|
<p>Please refer to the <code>README.md</code> in each specific repository for detailed setup instructions.</p>
|
|
<h2 id="any-questions"><a class="header" href="#any-questions">Any Questions?</a></h2>
|
|
<p>If you have any questions, please feel free to ask in our official communication channels. We are here to help you get started!</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>
|