595 lines
57 KiB
HTML
595 lines
57 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 paradigm for digital life: Dao OS.</strong></p>
|
|
<p>Dao OS is not a traditional operating system. Instead, it is a set of open protocols and a core, portable library—the <strong><code>Meta Unit</code></strong>—that brings sovereignty, intelligence, and interoperability to any application on any platform.</p>
|
|
<p>Its purpose is to solve the problems of data silos, platform lock-in, and privacy erosion. It achieves this by providing a unified, secure, and user-owned "digital soul" (the <code>Meta Unit</code>) that can be integrated into any program, transforming it into a sovereign <strong><code>Avatar (</code>化身<code>)</code></strong> within the user's personal P2P network.</p>
|
|
<p>We call the ecosystem of Dao-enabled software <strong><code>Dao Implements (</code>道器<code>)</code></strong>.</p>
|
|
<h2 id="core-concepts"><a class="header" href="#core-concepts">Core Concepts</a></h2>
|
|
<ul>
|
|
<li>
|
|
<p><strong>The <code>Meta Unit</code> (<code>元</code>)</strong>: The "precise machine" of your digital life. A portable library containing your encrypted "Second Brain," core service APIs, and the capacity to be extended. It is the single source of truth that you own, waiting to be activated.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>The <code>Avatar</code> (<code>化身</code>)</strong>: The "runtime" or "power source." Any program that loads and runs your <code>Meta Unit</code> becomes an Avatar. A browser tab running a web app, a command-line tool, or a native mobile app can all be Avatars, acting as the bridge that provides the <code>Meta Unit</code> with the energy (CPU, memory) and resources to operate.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong><code>Dao Implements</code> (<code>道器</code>)</strong>: The ecosystem of applications and extensions that integrate the <code>Meta Unit</code> to become Avatars.</p>
|
|
<ul>
|
|
<li><strong><code>Facet Implement</code> (<code>器</code>)</strong>: An Implement with a user interface, providing a "control panel" to interact with your Dao.</li>
|
|
<li><strong><code>Core Implement</code> (<code>核</code>)</strong>: A headless Implement (an "extension") that enhances your Dao's backend capabilities.</li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<p><strong>A Sovereign P2P Network</strong>: All of your Avatars, regardless of the device they run on, connect to form a private, resilient, end-to-end encrypted network, keeping the data within their embedded <code>Meta Units</code> seamlessly in sync.</p>
|
|
</li>
|
|
</ul>
|
|
<h2 id="our-vision"><a class="header" href="#our-vision">Our Vision</a></h2>
|
|
<p>We envision a future where your digital identity and data are not trapped within walled gardens. Where your applications are not just isolated tools, but intelligent, collaborative components of a larger digital self. Where every user is the true sovereign of their own digital life.</p>
|
|
<p><strong>Join us in building this future.</strong></p>
|
|
<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 <strong>Meta Unit</strong> and a basic <strong>Avatar</strong> to run it.</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, and code snippets are stored within our own "Second Brain," managed by the Meta Unit.</li>
|
|
<li><strong>Learning</strong>: The Meta Unit's Personal AI capabilities (provided by our official "AI Companion" Dao Implement) begin 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, 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 AI is a core part of the system's potential, 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>Openness & Polyglotism</strong>: The Meta Unit is a portable library. The <code>Dao Implements</code> (<code>道器</code>) that integrate it to become Avatars can be written in any language.</li>
|
|
<li><strong>Community-Driven</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 not that of a traditional, monolithic operating system. It is a decentralized, layered paradigm designed for sovereignty, resilience, and extensibility. To understand it, one must understand its three fundamental entities: the Meta Unit, the Avatar, and the Dao Implement.</p>
|
|
<h2 id="1-the-meta-unit-the-portable-soul-code"><a class="header" href="#1-the-meta-unit-the-portable-soul-code">1. The <code>Meta Unit</code>: The Portable Soul-Code</a></h2>
|
|
<p>The <code>Meta Unit</code> is the conceptual core of a user's digital existence, but it is not a running program by itself.</p>
|
|
<ul>
|
|
<li><strong>Its Nature</strong>: The Meta Unit is a <strong>portable library or artifact</strong> (e.g., a <code>.wasm</code>, <code>.so</code>, or <code>.dll</code> file). It contains the user's complete, end-to-end encrypted "Second Brain" (all data), core service APIs (identity, P2P networking, AI infrastructure), and the logic for managing them.</li>
|
|
<li><strong>Its Role</strong>: It is the passive, unified, and single source of truth for the user's data and core capabilities. Like Java bytecode (<code>.class</code> files), it defines what is possible but does not execute on its own. It is the "precise machine" waiting to be activated.</li>
|
|
</ul>
|
|
<h2 id="2-the-avatar-the-runtime-environment"><a class="header" href="#2-the-avatar-the-runtime-environment">2. The <code>Avatar</code>: The Runtime Environment</a></h2>
|
|
<p>An <code>Avatar</code> is the active entity that gives life to the <code>Meta Unit</code>.</p>
|
|
<ul>
|
|
<li><strong>Its Nature</strong>: An Avatar is any <strong>executable program or process</strong> whose primary function is to load, host, and execute an instance of the <code>Meta Unit</code> library. It is the "power source" that activates the machine.</li>
|
|
<li><strong>Its Role</strong>: The Avatar acts as the crucial <strong>bridge</strong> between the abstract <code>Meta Unit</code> and the concrete host platform (iOS, Windows, a web browser, the command line). It provides the <code>Meta Unit</code> with access to system resources like CPU, memory, storage, and networking. In the Java analogy, the Avatar is the <strong>JVM (Java Virtual Machine)</strong>.</li>
|
|
<li><strong>The Dao Network</strong>: All of a user's running Avatars form a private P2P network, keeping their embedded <code>Meta Unit</code> instances constantly and seamlessly in sync.</li>
|
|
</ul>
|
|
<h2 id="3-dao-implements-道器-the-ecosystem-of-software"><a class="header" href="#3-dao-implements-道器-the-ecosystem-of-software">3. <code>Dao Implements</code> (<code>道器</code>): The Ecosystem of Software</a></h2>
|
|
<p>"Dao Implement" is the universal term for any third-party software designed to integrate with the Dao OS ecosystem. They are the applications and services that users interact with. An Implement becomes an Avatar by integrating the <code>Meta Unit</code>.</p>
|
|
<p>An Implement is composed of different types of components based on its design.</p>
|
|
<ul>
|
|
<li><strong><code>Facet Component</code> (<code>器</code>)</strong>: The part of a Dao Implement that has a <strong>user interface</strong>. It is the "control panel" for the <code>Meta Unit</code>, responsible for presenting information to and capturing input from the user.</li>
|
|
<li><strong><code>Core Component</code> (<code>核</code>)</strong>: The <strong>headless, backend logic</strong> part of a Dao Implement. It runs as a service, providing specific capabilities that can enhance the Meta Unit or be called by other Implements. It is an "add-on tool" for the machine.</li>
|
|
</ul>
|
|
<h3 id="application-architecture-freedom"><a class="header" href="#application-architecture-freedom">Application Architecture Freedom</a></h3>
|
|
<p>Developers have complete freedom in how they structure their <code>Dao Implement</code>:</p>
|
|
<ul>
|
|
<li>They can create a <strong>standalone application</strong> that is itself an Avatar, bundling the Meta Unit library, a Core component (for logic), and a Facet component (for UI) into one executable.</li>
|
|
<li>They can create a <strong>distributed application</strong>, where a Facet Implement on one device communicates with a Core Implement on another.</li>
|
|
<li>They can create a pure <strong>Core Implement</strong> (an "extension") that just provides a new backend capability to the user's entire Dao.</li>
|
|
<li>They can also create a pure <strong>Facet Implement</strong> that has no custom backend logic (<code>Core Component</code>). This type of application's UI directly interacts with the built-in core services of the <code>Meta Unit</code> to create a simple utility.</li>
|
|
</ul>
|
|
<p>This architecture ensures that Dao OS is not just a platform, but a truly open, composable, and decentralized ecosystem.</p>
|
|
<div style="break-before: page; page-break-before: always;"></div><h1 id="the-dao-os-ai-system"><a class="header" href="#the-dao-os-ai-system">The Dao OS AI System</a></h1>
|
|
<p>The AI in Dao OS is not a monolithic program but a collaborative ecosystem. It emerges from the synergy between the foundational capabilities provided by the <strong><code>Meta Unit</code></strong> and the specific intelligence implemented by a universe of <strong><code>Dao Implements</code></strong>. This design ensures a system that is sovereign, powerful, and open.</p>
|
|
<h2 id="1-the-meta-unit-the-foundation-for-sovereign-ai"><a class="header" href="#1-the-meta-unit-the-foundation-for-sovereign-ai">1. The <code>Meta Unit</code>: The Foundation for Sovereign AI</a></h2>
|
|
<p>The <code>Meta Unit</code> does not contain a single, all-knowing AI. Instead, it provides the core, trusted <strong>infrastructure</strong> that enables intelligent applications to run securely under the user's control.</p>
|
|
<ul>
|
|
<li><strong>The Personal Feature Store</strong>: The user's "Second Brain" acts as the ultimate, private data source for any AI task. The <code>Meta Unit</code> provides a secure, permissioned API for <code>Dao Implements</code> to access this rich, multi-modal context.</li>
|
|
<li><strong>The Secure Execution Environment</strong>: The <code>Meta Unit</code> provides a secure WASM sandbox for running <code>Core Implements</code> (<code>核</code>). It manages resources and enforces permissions, ensuring third-party logic cannot harm the system.</li>
|
|
<li><strong>The AI Model Registry</strong>: The <code>Meta Unit</code> maintains a registry of AI models that the user has approved. A <code>Dao Implement</code> can request the <code>Meta Unit</code> to run inference using one of these registered models.</li>
|
|
</ul>
|
|
<h2 id="2-the-dao-ai-companion-the-official-first-party-intelligence"><a class="header" href="#2-the-dao-ai-companion-the-official-first-party-intelligence">2. The "Dao AI Companion": The Official First-Party Intelligence</a></h2>
|
|
<p>To provide a powerful, intelligent experience out of the box, Dao OS includes an official, pre-registered <code>Dao Implement</code> called the <strong>"Dao AI Companion."</strong></p>
|
|
<ul>
|
|
<li><strong>Its Nature</strong>: This is a <code>Core Implement</code> (<code>核</code>) developed and maintained by the Dao OS core team. It is the "living soul" that users experience.</li>
|
|
<li><strong>Its Role</strong>: The AI Companion has privileged (but user-revocable) access to the user's Second Brain. It is responsible for the proactive, holistic, and empathetic features we envision:
|
|
<ul>
|
|
<li>Finding deep connections across all user data.</li>
|
|
<li>Providing context-aware suggestions.</li>
|
|
<li>Powering the Emotional Resonance features.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Why Separate?</strong>: By making our official AI a <code>Dao Implement</code> rather than part of the <code>Meta Unit</code> itself, we keep the <code>Meta Unit</code> lean, un-opinionated, and purely foundational. It also allows users (in the future) to potentially replace or supplement our official AI with other core AI <code>Implements</code>.</li>
|
|
</ul>
|
|
<h2 id="3-design-patterns-for-intelligent-dao-implements"><a class="header" href="#3-design-patterns-for-intelligent-dao-implements">3. Design Patterns for Intelligent <code>Dao Implements</code></a></h2>
|
|
<p>Third-party developers can create their own intelligent <code>Dao Implements</code> by following these architectural patterns:</p>
|
|
<h3 id="the-reflex-mind-pattern"><a class="header" href="#the-reflex-mind-pattern">The "Reflex Mind" Pattern</a></h3>
|
|
<p>A developer can create a lightweight <code>Dao Implement</code> that packages a small, fast, specialized model in its <code>Core Component</code> (<code>核</code>). This is ideal for simple, instant tasks like command intent recognition or information classification.</p>
|
|
<h3 id="the-cognitive-mind-pattern"><a class="header" href="#the-cognitive-mind-pattern">The "Cognitive Mind" Pattern</a></h3>
|
|
<p>A more advanced <code>Dao Implement</code> can perform deep analysis. Its <code>Core Component</code> (<code>核</code>) would:</p>
|
|
<ol>
|
|
<li>Request data access from the <code>Meta Unit</code>.</li>
|
|
<li>Implement the <strong>Just-in-Time (JIT) Data Pipeline</strong> pattern: create a local vector index of the data.</li>
|
|
<li>Query this index to find relevant context.</li>
|
|
<li>Request the <code>Meta Unit</code>'s Inference Engine to run a powerful, user-approved LLM on this context to generate insights.</li>
|
|
</ol>
|
|
<h3 id="the-synergistic-mind-pattern"><a class="header" href="#the-synergistic-mind-pattern">The "Synergistic Mind" Pattern</a></h3>
|
|
<p>A <code>Dao Implement</code> can be designed to orchestrate complex workflows by requesting the <code>Meta Unit</code> to facilitate communication with other <code>Dao Implements</code> or external, permissioned APIs.</p>
|
|
<p>This architecture ensures that Dao OS provides not just a single AI, but a foundation for a universe of interoperable, user-sovereign intelligent applications.</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 the ecosystem of <strong><code>Dao Implements</code></strong> (applications and extensions).</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 the <strong>Application Bazaar</strong>, our decentralized discovery system. When you find a <code>Dao Implement</code>, you are presented with its <strong>Trust Dashboard</strong> (with automated verification checks and community vouches), allowing you to make an informed, sovereign decision.</p>
|
|
<h3 id="2-registration-and-permissioning"><a class="header" href="#2-registration-and-permissioning">2. Registration and Permissioning</a></h3>
|
|
<p>When you decide to add an Implement, you are shown its <strong>Manifest</strong>. This is a clear list of permissions the Implement's components (<code>Facet</code> and/or <code>Core</code>) require to function. Your explicit approval <strong>registers</strong> the Implement with your <code>Meta Unit</code>, and this registration is synced across all your Avatars.</p>
|
|
<h3 id="3-seamless-cross-platform-access"><a class="header" href="#3-seamless-cross-platform-access">3. Seamless Cross-Platform Access</a></h3>
|
|
<p>Once an Implement is registered, you can access it on any device. The way you access it depends on how its developer designed it.</p>
|
|
<ul>
|
|
<li>
|
|
<p><strong>For Web-based <code>Facet</code> Implements</strong>:
|
|
You simply navigate to the application's URL in your standard web browser. The web page, using our <code>dao.js</code> SDK, will prompt you to connect to your Dao. Once you approve (e.g., via a simple authenticator extension), that <strong>browser tab itself becomes a temporary <code>Facet Avatar</code></strong>, securely rendering the UI and communicating with your <code>Meta Unit</code>.</p>
|
|
</li>
|
|
<li>
|
|
<p><strong>For Native <code>Facet</code> Implements</strong>:
|
|
You download and run the native application (e.g., from an app store or directly). On first launch, it will ask for permission to connect to your Dao. Once approved, that <strong>running application becomes a persistent <code>Facet Avatar</code></strong> in your network.</p>
|
|
</li>
|
|
</ul>
|
|
<p>Because all these <code>Facet Avatars</code> are powered by the same, synchronized <code>Meta Unit</code>, your experience is consistent everywhere, without needing to "install" the app on each device in the traditional sense.</p>
|
|
<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 the permissions you granted to any <code>Dao Implement</code>.</li>
|
|
<li>Use the <strong>Role Assignment</strong> feature to designate that an Implement's <code>Core</code> component should preferably run on a specific <code>Core Avatar</code> (e.g., your home server acting as a <code>Compute Node</code>).</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>For new users, this mode 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, providing tools to visualize their setup, manage permissions, and learn more about their digital sovereignty.</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 optional stage for users who desire absolute control. A user can "graduate" to this mode, taking full self-custody of their keys and running their own network of <code>Core Avatars</code>, 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 <strong><code>Dao Implements</code></strong>—applications and services that integrate with the Dao OS ecosystem.</p>
|
|
<h2 id="guiding-technical-principles"><a class="header" href="#guiding-technical-principles">Guiding Technical Principles</a></h2>
|
|
<ul>
|
|
<li><strong>Library, not Framework</strong>: Dao OS is not a restrictive framework. The <strong><code>Meta Unit</code></strong> is a portable library that you integrate into your own application, empowering it with new capabilities without dictating its internal architecture.</li>
|
|
<li><strong>Openness & Polyglotism</strong>: Any application, written in any language, can become an <strong><code>Avatar</code></strong> (a runtime for the <code>Meta Unit</code>). We achieve this by providing the <code>Meta Unit</code> as both a <strong>WASM</strong> library for web/scripting languages and as a <strong>native library</strong> (<code>.so</code>, <code>.dll</code>, <code>.a</code>) for system languages.</li>
|
|
<li><strong>API-First</strong>: All interactions with the <code>Meta Unit</code> are conducted through a stable, versioned, and well-documented API.</li>
|
|
<li><strong>Security-First</strong>: The <code>Meta Unit</code> is a secure vault. All data is end-to-end encrypted, and all interactions are governed by a strict, user-controlled permission system.</li>
|
|
</ul>
|
|
<h2 id="the-core-integration-how-an-app-becomes-an-avatar"><a class="header" href="#the-core-integration-how-an-app-becomes-an-avatar">The Core Integration: How an App Becomes an <code>Avatar</code></a></h2>
|
|
<p>The journey of creating a <code>Dao Implement</code> begins by integrating the <code>Meta Unit</code> library, which instantly transforms the running application process into a sovereign <code>Avatar</code> in the user's Dao network. We provide two primary integration paths.</p>
|
|
<h3 id="1-web-integration-path-via-daojs-sdk"><a class="header" href="#1-web-integration-path-via-daojs-sdk">1. Web Integration Path (via <code>dao.js</code> SDK)</a></h3>
|
|
<p>This is the easiest and most accessible path for web developers.</p>
|
|
<ul>
|
|
<li><strong>How it works</strong>: A developer can take any new or existing web application. By including our <code>dao.js</code> SDK, their web app gains the ability to load the <code>Meta Unit</code>'s WASM binary (<code>dao.wasm</code>).</li>
|
|
<li><strong>The Transformation</strong>: Once the user grants permission, the browser tab running the web app becomes a temporary <strong><code>Avatar</code></strong>. The web app's JavaScript can then communicate with the <code>Meta Unit</code> via the high-level API exposed by the <code>dao.js</code> bridge.</li>
|
|
<li><strong>Best for</strong>: Building <code>Facet Implements</code> (<code>器</code>) quickly, creating data visualization dashboards, and integrating existing PWAs (Progressive Web Apps) into the Dao ecosystem.</li>
|
|
</ul>
|
|
<h3 id="2-native-integration-path-via-ffi"><a class="header" href="#2-native-integration-path-via-ffi">2. Native Integration Path (via FFI)</a></h3>
|
|
<p>This path offers maximum performance and deep system integration for native applications.</p>
|
|
<ul>
|
|
<li><strong>How it works</strong>: A developer of a native application (written in Rust, Go, Swift, Kotlin, C++, etc.) can link against the <code>Meta Unit</code>'s native library.</li>
|
|
<li><strong>The Transformation</strong>: The running native application process becomes a persistent <strong><code>Avatar</code></strong>. The application's code communicates with the <code>Meta Unit</code>'s services via a Foreign Function Interface (FFI) bridge.</li>
|
|
<li><strong>Best for</strong>:
|
|
<ul>
|
|
<li>Creating powerful, always-on <strong><code>Core Implements</code> (<code>核</code>)</strong> on servers or NAS devices.</li>
|
|
<li>Building high-performance, native <strong><code>Facet Implements</code> (<code>器</code>)</strong> like our ideal Flutter-based mobile clients.</li>
|
|
<li>Adapting existing open-source native applications.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h2 id="key-technologies--protocols"><a class="header" href="#key-technologies--protocols">Key Technologies & Protocols</a></h2>
|
|
<div class="table-wrapper"><table><thead><tr><th style="text-align: left">Category</th><th style="text-align: left">Technology / Protocol</th><th style="text-align: left">Purpose</th></tr></thead><tbody>
|
|
<tr><td style="text-align: left"><strong>Core Library</strong></td><td style="text-align: left">Rust -> WASM / Native Libs</td><td style="text-align: left">To create a single, safe, and performant core logic for the <code>Meta Unit</code>.</td></tr>
|
|
<tr><td style="text-align: left"><strong>Web Integration</strong></td><td style="text-align: left"><code>dao.js</code> SDK (JavaScript/TypeScript)</td><td style="text-align: left">The bridge for any web application to become an <code>Avatar</code>.</td></tr>
|
|
<tr><td style="text-align: left"><strong>P2P Networking</strong></td><td style="text-align: left"><code>libp2p</code></td><td style="text-align: left">Modular peer discovery, transport, and secure channels.</td></tr>
|
|
<tr><td style="text-align: left"><strong>Data Synchronization</strong></td><td style="text-align: left">CRDTs (Conflict-Free Replicated Data Types)</td><td style="text-align: left">Ensuring eventual consistency across Avatars.</td></tr>
|
|
<tr><td style="text-align: left"><strong>Identity</strong></td><td style="text-align: left">DID & VC</td><td style="text-align: left">Sovereign identity and interoperable, cryptographic trust.</td></tr>
|
|
<tr><td style="text-align: left"><strong>Data Serialization</strong></td><td style="text-align: left">Protocol Buffers (Protobuf)</td><td style="text-align: left">Efficient, language-agnostic data structures for APIs.</td></tr>
|
|
</tbody></table>
|
|
</div><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 new <strong><code>Dao Implements</code></strong>? The answer is through a network of trusted curators.</p>
|
|
<ul>
|
|
<li><strong>Developer Publishing</strong>: A developer does not "submit" their <code>Dao Implement</code> for approval. Instead, they publish its <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, 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></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 a third-party <code>Dao Implement</code>? They don't have to trust blindly. The bazaar is built directly on top of our <strong>Community Reputation & Automated Verification System</strong>.</p>
|
|
<p>Every listing for a <code>Dao Implement</code>, 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 Implement.</li>
|
|
<li><strong>Curator Reputation</strong>: The reputation of the curator who listed the Implement is itself a trust signal.</li>
|
|
</ol>
|
|
<p>The final decision to "register" a <code>Dao Implement</code> 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 register a <code>Dao Implement</code>, the process is direct and decentralized.</p>
|
|
<ul>
|
|
<li>The Implement's manifest contains the <strong>content-addressed hashes (CIDs)</strong> of its software packages (e.g., the <code>Core Component</code> as a <code>.wasm</code> file and the <code>Facet Component</code> as a Web UI bundle).</li>
|
|
<li>The user's <code>Meta Unit</code>, hosted within an <code>Avatar</code>, uses this hash to fetch the files directly from the P2P network (IPFS).</li>
|
|
<li>This ensures that no central server can block the distribution of a <code>Dao Implement</code>. 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 <code>Dao Implement</code>'s manifest can declare a business model (e.g., one-time purchase price).</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, sending value directly from the user's wallet to the developer's address specified in the manifest. Dao OS acts as a facilitator, not a middleman.</li>
|
|
</ul>
|
|
<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---the-bedrock--the-bridge"><a class="header" href="#phase-i-genesis---the-bedrock--the-bridge">Phase I: Genesis - The Bedrock & The Bridge</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: Q3 2025 - Q4 2025</li>
|
|
<li><strong>Core Goal</strong>: To build the core <code>Meta Unit</code> library and the essential tools for developers to start building.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Finalize the v0.1 Core API Specification for the <code>Meta Unit</code>.</li>
|
|
<li>Develop the v0.1 <code>Meta Unit</code> in Rust, including <code>SecretStore</code>, <code>NoteStore</code>, and basic P2P sync services.</li>
|
|
<li>Develop the first official <strong><code>Core Avatar</code></strong>: a command-line tool for initializing a Dao, managing keys, and basic diagnostics.</li>
|
|
<li>Release the v0.1 <strong><code>dao.js</code> SDK</strong>, enabling any web application to become a temporary <code>Facet Avatar</code>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "As a developer, I can use a command-line tool to initialize my Dao. I can then take a simple web app, import the <code>dao.js</code> library, and watch it connect to my Dao and read a test note. The foundation is real."</li>
|
|
</ul>
|
|
<hr />
|
|
<h3 id="phase-ii-manifestation---the-first-dao-implement-is-born"><a class="header" href="#phase-ii-manifestation---the-first-dao-implement-is-born">Phase II: Manifestation - The First "Dao Implement" is Born</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: Q1 2026 - Q2 2026</li>
|
|
<li><strong>Core Goal</strong>: To launch the first official, high-value <code>Dao Implement</code> to showcase the power of the ecosystem and attract early users.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Refine and stabilize the core services within the <code>Meta Unit</code>.</li>
|
|
<li>Following our "Good Timber" strategy, <strong>adapt a well-structured, open-source notes or password manager</strong> into our first official <code>Facet Implement</code>, using our <code>dao.js</code> SDK.</li>
|
|
<li>Implement the <strong>"Progressive Sovereignty"</strong> onboarding flow for new users.</li>
|
|
<li>Launch a project website with comprehensive documentation for users and developers.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "I am using a beautiful, fast, and familiar notes application in my browser. But I know its data is end-to-end encrypted and seamlessly synced across all my devices via a P2P network, with no central server. This is the first application that truly belongs to me."</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 and to lay the groundwork for advanced AI.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Implement the W3C DID and VC modules in the <code>Meta Unit</code>.</li>
|
|
<li>Develop a Proof-of-Concept for cross-Dao communication (e.g., sharing a signed, verifiable note).</li>
|
|
<li>Initiate foundational research for the official <strong>"Dao AI Companion" <code>Core Implement</code></strong>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "I have a sovereign digital identity. I can grant another Dao user limited, cryptographic access to one of my notes without going through a third-party platform. We can form trust networks."</li>
|
|
</ul>
|
|
<hr />
|
|
<h3 id="phase-iv-ecosystem---the-bazaar-opens"><a class="header" href="#phase-iv-ecosystem---the-bazaar-opens">Phase IV: Ecosystem - The Bazaar Opens</a></h3>
|
|
<ul>
|
|
<li><strong>Timeline</strong>: 2027 and beyond</li>
|
|
<li><strong>Core Goal</strong>: To evolve Dao OS from a platform with a flagship app into a thriving, open ecosystem.</li>
|
|
<li><strong>Key Milestones</strong>:
|
|
<ul>
|
|
<li>Release the v1.0 stable <code>Meta Unit</code> API.</li>
|
|
<li>Release the first official <strong>"Dao AI Companion" <code>Core Implement</code></strong>, providing proactive, intelligent assistance to users.</li>
|
|
<li>Launch the <strong>"Application Bazaar"</strong> protocol and a reference curator index.</li>
|
|
<li>Provide official guides and community support for building advanced <strong>native <code>Facet Implements</code></strong> (e.g., with Flutter/Swift).</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Feature Story</strong>: "My Dao is alive. My AI Companion helps me manage my day. I can browse a decentralized bazaar to find new, trusted <code>Dao Implements</code> built by the community. My digital life is sovereign, intelligent, and constantly growing."</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.</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, maintaining the core infrastructure, and empowering the community to build and innovate.</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 native integrations). 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.</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> library and the core protocols in Rust.</li>
|
|
<li><strong><code>Dao Implement</code> Development</strong>: Creating new <code>Dao Implements</code>, which can include <strong><code>Facet</code> (UI) components</strong> and <strong><code>Core</code> (headless logic) components</strong>.</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 for reference <code>Dao Implements</code> 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.</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.</li>
|
|
<li><strong>Mature Stage (Future)</strong>: We are committed to exploring and transitioning to more decentralized governance mechanisms.</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>Core Development</strong>: Contributing to the <code>Meta Unit</code> library and the core protocols in Rust.</li>
|
|
<li><strong><code>Dao Implement</code> Development</strong>: Creating new <code>Dao Implements</code>, which can include <strong><code>Facet</code> (UI) components</strong> and <strong><code>Core</code> (headless logic) components</strong>.</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 for reference <code>Dao Implements</code> and defining design patterns for the ecosystem.</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>).</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>).</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 and linters.</li>
|
|
<li><strong>Commit Your Changes</strong>: We encourage using Conventional Commits 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>
|