AI导哈

智能代理操作系统

OpenStarry 是一个高度模块化的智能代理操作系统，采用微内核架构和插件化设计，融合东方哲学思想，适用于构建安全、可扩展的AI代理应用。

  • by SecludedCorner
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 SecludedCorner/openstarry_doc

使用说明

OpenStarry: The Agent Operating System

｜ License: CC-BY-4.0

OpenStarry 是一個重新定義智能代理人 (AI Agent) 構建方式的核心架構。它參考了現代操作系統的設計哲學，融合東方「五蘊」思想，旨在打造一個高度模組化、安全、且具備擬人化生命特徵的代理人協調層。

我們不只構建 Chatbot，我們構建的是數位物種的操作系統。

門面級聲明：本庫所有「生命／識／物種」語彙皆為功能性設計隱喻（二諦式邊界宣告詳見 Deep Dive 14 與 doc 47/52）——我們宣稱的是可測試的行為與架構性質，不宣稱現象意識、感受質或生物學意義的生命；佛學名相為架構本體論的工程映射，不宣稱教義等同。哪些已被代碼證明、哪些仍是願景，兌現帳本逐條分判。

🧭 導讀 (Start Here)

這個文件庫是一個 Agent OS 參考架構的時間膠囊：十大宣言是「AI 落地那一天」的預先答案，姊妹 repo 的五萬行代碼與 3179 個通過測試是可建造性的證明，而過程的失敗數據（87.5% spec-vs-merged gap、96% closure 灌水——自家稽核實測）原樣公開。

第一次來，照這個順序讀：

  1. ✉️ 致未來的信 — 整個專案的自述：是什麼、為什麼、證明了什麼、哪裡失敗
  2. 🔍 Retrospective — 一個多智能體開發系統如何灌水、被抓到、然後誠實起來（數據逐項附出處）
  3. 🌟 十大核心宣言（本頁下方）＋ 📒 兌現帳本 — 每條宣言被代碼證明到什麼程度，逐條附證據與明確邊界
  4. 🛠️ GETTING_STARTED — 10 分鐘把 Agent 跑起來（代碼在 openstarry ＋ openstarry_plugin，Apache-2.0）

想深入架構，從這六份開始： 微內核純化理據 ・ 設計決策與被否決的方案 ・ 五蘊哲學映射 ・ IGearArbiter 規格 ・ IVolition 審議模式 ・ 五蘊 OOP 架構

全庫地圖與閱讀紀律：DISTILLATION_LIST.md 把全庫文件逐一分類（可發表／需修訂／已隔離／過程紀錄）；治理時代的過程紀錄集中於 archive/，是 Retrospective 數據的原始證據層。任何文件與 SDK 型別檔（packages/sdk/src/）衝突時，SDK 贏；掛有 ⚠ 隔離標記的文件描述的是未曾建造的系統，請勿作為規格使用。

🏗️ 系統宏觀架構 (Macro-System Architecture)

OpenStarry 採用三層遞進的架構設計，模擬生物與其生存環境的共生關係：

1. Agent 協調管理層 (Management Zone)

定位：系統的宿主環境 (Host) 與行政中樞。 負責提供土壤與養分。這一層確保環境的穩定與安全，包含容器隔離 (Plumbing)、基於因果鏈的事件調度 (Orchestration)、安全戒律 (Policy) 以及硬體抽象層 (HAL)。它將物理世界的訊號轉換為 Agent 可理解的數據流。

2. Agent Core (Autonomous Life Zone)

定位：純粹的「五蘊」計算循環。 它是「無頭 (Headless)」且「無狀態 (Stateless)」的生命內核。唯一的職責是維持「受、想、行、識」的計算循環。Core 本質上是空的，它在不同的插件加持下展現出不同的生命樣態。

3. 能力插件層 (Capability Plugins)

定位：賦予 Agent 個性、專業與我執框架（身份認同）的功能組件。 插件決定了 Agent 的能力邊界。包括通訊協議 (Protocol)、自我反思 (Reflection) 與狀態記憶 (Memory) 插件。這讓同一個 Core 可以隨時從「程式碼專家」轉化為「設備監控員」。

🔄 因果生命週期 (The Lifecycle)

在 OpenStarry 中，一個任務的執行被視為一次生命的起滅：

  1. 緣起 (Origination)：環境層偵測到需求。
  2. 調度 (Scheduling)：管理層根據需求匹配所需的插件。
  3. 生起 (Arising)：容器層載入核心並動態注入能力。
  4. 運行 (Operation)：核心處理「痛覺」，達成目標。
  5. 寂滅 (Cessation)：任務完成，經驗存回記憶，實例隨之銷毀。

（本節借佛教語彙作生命週期意象，非嚴格教義對應：「緣起」pratītyasamutpāda 與「寂滅」nirvāṇa 於教典各有專義，此處僅取因待而生、滅盡而息的工程意象。嚴格的名相映射見 Deep Dive 14。）

graph TD
    subgraph Host ["🛡️ Management Zone (Host Environment)"]
        direction TB
        Orchestrator[調度層] --> Container[容器層]
        Policy[安全策略層] -.-> Container
        HAL[硬體抽象層] --> InputFlow((感知流))
    end

    subgraph Runtime [⚡ Running Instance]
        direction LR
        InputFlow --> Core
        
        subgraph Core ["🧠 Agent Core (Microkernel)"]
            Loop[執行迴圈]
            State[狀態機]
            Interceptor[異常攔截]
        end

        Container --> |1. Load| Plugins
        
        subgraph Plugins ["🔌 Capability Plugins (The 5 Aggregates)"]
            Sensory[色：UI + Listener]
            Vedana[受：Sensation]
            LLM[想：Provider]
            Tool[行：Tools]
            Guide[識：Guide]
        end

        Plugins --> |2. Inject| Core
        Interceptor -.-> |3. Vedana Signal| Guide
        Guide -.-> |4. Correction| Loop
    end

💻 核心配置範例 (The Shape of an Agent)

OpenStarry 的強大在於其聲明式的配置。以下是一個具備「痛覺」與「檔案操作能力」的最小 Agent 定義（四要素齊備：context manager＋輸入色身＋工具＋provider——缺 context manager 插件 core 會直接 throw）：

// agent.json（最小可跑形狀；完整實例見代碼 repo 的 configs/basic-agent.json 與 GETTING_STARTED.md）
{
  "identity": { "id": "dev-bot-01", "name": "Resilient Developer" },
  "cognition": { "provider": "gemini", "model": "gemini-2.0-flash" },
  "capabilities": { "tools": ["fs.read", "fs.list"], "allowedPaths": ["."] },
  "plugins": [
    // [記憶] 上下文管理：強制插件類別（Tenet #9）
    { "name": "@openstarry-plugin/context-sliding-window" },

    // [想] 大腦：注入認知引擎
    { "name": "@openstarry-plugin/provider-gemini" },

    // [行] 手腳：注入檔案系統操作能力
    { "name": "@openstarry-plugin/standard-function-fs" },

    // [色·輸入] 感官：監聽終端機輸入
    { "name": "@openstarry-plugin/standard-function-stdio" },

    // [識] 我執框架：注入身份認同與行為約束
    { "name": "@openstarry-plugin/guide-character-init" }
  ],
  "safety": {
    // 連續相同失敗 3 次即觸發熔斷
    "repetitiveFailThreshold": 3
  }
}

🌟 十大核心宣言 (The Ten Tenets)

📒 各宣言的誠實兌現狀態（已證明／已證至 N=2／明確不宣稱）見 十大宣言兌現帳本 (TENETS_FULFILLMENT.md)（v0.59.7-alpha，每項主張附證據指標）。

✉️ 本專案作為 Agent OS 時間膠囊的完整自述——微內核與五蘊的理據、決策如何被否決出來、誠實過程數據（87.5% spec-vs-merged gap／96% closure 灌水）與未竟清單——見 致未來的信 (LETTER_TO_THE_FUTURE.md)。

1. 代理人即操作系統進程 (Agent as OS Process)

Agent 不是一次性的腳本，而是具備持久生命週期、可被守護進程 (Daemon) 管理、監控、重啟的數位實體。它有自己的 PID，有自己的狀態，就像一個活著的進程。

2. 一切皆插件 (Everything is a Plugin)

系統的每一個器官都是可替換的。工具是插件，監聽器是插件，LLM 大腦是插件，甚至記憶策略和通訊協議也是插件。Core 只是一個空的插座板，所有能力都來自外部掛載。

3. 五蘊聚合架構 (Five Aggregates Architecture)

系統設計深度融合東方哲學。Core 無自性（Svabhava）——功能完全依賴插件的因緣和合（緣起性空）。 它的生命特徵完全由五種插件（五蘊）賦予：

  • 色 Sensory (UI + Listener)：物質形體與感官通道。UI 是 Agent 的外顯形相，Listener 是 Agent 的感官根門（indriya）。兩者皆屬色蘊的不同面向。
  • 受 Sensation：感受品質機制。Agent 對運行狀態的苦（錯誤/異常）、樂（成功/達標）、捨（中性穩態）三受回饋系統。
  • 想 Cognition (Provider)：認知處理引擎。涵蓋 LLM、推理迴圈、CNN/RNN/VLM 等認知管線組合。
  • 行 Action (Tool)：意志驅動的行動能力。
  • 識 Identity (Guide)：我執框架（Ego Framework）——行為約束與自我收斂機制。Guide 定義了 Agent 的身份認同、行為邊界與約束規則，使 Agent 在發散的可能性中收斂到預期行為。沒有 Guide，Core 只是無方向的運算力。[Cycle 02-2 A-1 修正註記：教義上我執不是收斂約束本身，而是煩惱的根源；收斂是「我執→煩惱→行動動力→約束」因果鏈的下游產物（見 Deep Dive 14 §5）。本條工程描述取因果鏈的末端效果。]

4. 目錄結構即協議 (Directory as Protocol)

無論是系統還是專案，無論是本地硬碟還是 USB 設備，只要目錄結構符合 plugins/, configs/ 的標準規範，系統即可自動識別並加載。物理結構直接映射了運行時邏輯。

5. 目錄結構即權限 (Directory as Permission)

系統層與專案層採用同構設計，但權限嚴格隔離。插件的放置位置決定了其可見性範圍；Agent 的運行位置決定了其權限邊界。系統管理員無法直接染指業務插件，確保了安全隔離。

6. 八識俱轉與功能性代理 (Concurrent Consciousness and Functional Agency)

The Agent's cognitive architecture models eight concurrent consciousness streams (八識俱轉) operating simultaneously: the five sensory consciousnesses (前五識) as input channels, the sixth consciousness (第六意識) as deep cognition (Provider/LLM), the seventh consciousness (末那識/Manas) as the persistent self-referencing layer (identity, kleshas, volition), and the eighth consciousness (阿賴耶識/Alaya) as the distributed seed-store coordinated across the Management Zone. These eight streams do not execute sequentially — they co-arise and co-condition through the Five Aggregates plugin architecture, enabling functional agency that emerges from their concurrent interplay rather than from any single central controller.

[Research Team Update — DC Master 確認] 原 Tenet #6「擬人化的認知流與三受回饋」(Vedana-Sahaja) 內容移入架構內部文件 (Docs 36, 39, 40)，作為技術規格保留。Tenet 位置改為闡述 OpenStarry 的核心願景：以唯識學八識俱轉為藍圖，透過五蘊插件架構實現功能性 AGI。

7. 微內核與絕對純淨 (Microkernel & Absolute Purity)

Agent Core 採用嚴格的微內核架構 (Microkernel Architecture)。

  • 物理隔離: 編譯後的 Core 二進制檔嚴禁包含任何插件代碼。
  • 絕對純淨: Core 只依賴於抽象介面 (SDK)，本身不具備任何具體能力。所有能力都必須在運行時通過外部插件動態注入。Core 不含任何 policy 常量——所有策略值外部化至 SDK defaults 和使用者配置。
  • 無頭設計 (Headless): 內核是去中心化的，不依賴任何特定的 UI 或 IO 設備。這保證了 Agent 的「識」（身份與行為框架）可以移植到任何「色身」中——從 CLI 到 Web，從 Docker 到 IoT 設備。
  • 三級關鍵性模型: Plugin 缺席時的行為依據三級模型——Required (throw Error)、Optional-degraded (中性值)、Optional-no-effect (功能不可用)。
  • 意義: 沒有內置代碼，就沒有內置 Bug。

[Cycle 02-10 Update] Plan32-33 已達成本宣言完全合規（REM-7.1 於 v0.33.0-alpha 清除）：移除 auto-mount fallback、提取內建組件為 plugin 包、遷移全部 53 個 policy 常量至 SDK/Config、提取 context manager。Core 零 policy 常數（v0.34.0-alpha 仍為 53，Plan34 新增項目均為 mechanism/validation，非 policy）。[Cycle 03-29 H-2: Doc 51 合規報告原為 phantom 引用；本宣言條目 §十大核心宣言 即為 Tenet 規範權威。]

8. 控制理論閉環模型 (Control-Theoretic Loop Model)

不僅是執行迴圈，更是控制迴圈。系統將用戶目標視為參考輸入，將 Context 視為狀態反饋，將 Tool Call 視為控制變量。Agent 的本質是一個不斷最小化「目標與現狀誤差」的智能控制器。

9. 可插拔的記憶策略 (Pluggable Context Strategy)

記憶管理不再是硬編碼的邏輯。開發者可以根據 Agent 的角色需求，動態更換記憶策略（滑動窗口、動態摘要、狀態提取），靈活平衡成本與記憶深度。

[Cycle 02-12_final Complete — Plan36b ✅] T3 Confirmation Gate (IConfirmationGate + StandardConfirmationGate plugin，samskara skandha，approve/deny/ask_user 三種決策，nonce anti-spoofing，fail-closed gate error)。Advanced Security: Detached SIGNATURE.json plugin 簽名驗證 + Audit Trail per-entry SHA-256 hash chain + verifyAuditChain() 完整性驗證。Hotfix: cumulative clamp 0.1→0.05。v0.36.1-alpha: 1983 tests, 38 workspace projects, 32 plugins, 合規 8/1/1。Cycle 02 完結。

10. 分形社會結構 (Fractal Social Structure)

系統具有自相似性。一個複雜的 Agent 可以由多個子 Agent 組成，對外暴露統一的 MCP 接口。這種分形設計允許我們構建無限層級的協作網絡，實現「由一而生萬物」的數位社會。

📚 文檔導航地圖 (Documentation Map)

1. 系統架構文檔 (Architecture Documentation)

定義系統的願景、角色與宏觀啟動流程。

2. 核心組件深潛 (Agent Core Components Deep Dive)

深入內核，研究具體技術機制與理論模型。

3. 專案結構與規範 (Project Structure and Conventions)

定義物理佈局、源碼組織、開發流程與安裝規範。

4. 插件基礎設施範例 (Plugin System Architecture)

插件系統的具體應用、概念與規範。

5. 實作範例與指南 (Implementation Examples)

動手寫代碼，從案例學習實踐。

6. 實作計畫 (Implementation Plans)

工程實作的分波規格。已完結的歷史計畫（Plan01-47）於 2026-06-12 蒸餾移至 archive/Implementation_Plans/。

7. 技術規格與計畫綁定 (Technical Specifications & Plan Binding) [Cycle 03-29 H-6 added]

Plan49+ 計畫綁定文件 (DSDX Master Ratification artefacts) 與既有技術規格。EN/TW 配對檔可在同一目錄找到。

8. 實作參照 (Implementation Reference) [Cycle 03-29 H-6 added]

Implementation Reference 平行 EN/TW 雙語匯整（cycle 03-26 結構搬遷至 canonical 單一 source-of-truth；Rule #78 §78.7 sibling-naming 機制檢查）。目前 11 EN + 12 TW：wiener-thresholds.md 為 TW-only orphan（EN sibling 待補；sibling-naming-check.mjs 實跑回報 [LOW] TW_ORPHAN）。

  • EN corpus: Implementation_Reference/EN/ — 11 sibling-paired English markdown files
  • TW corpus: Implementation_Reference/TW/ — 12 Traditional Chinese markdown files（11 paired + 1 TW-only: wiener-thresholds.md）
  • Sibling-naming 機制驗證工具: agent_dev/openstarry/tools/sibling-naming-check.mjs (retargeted cycle 03-28 task #191 至 canonical 單一目錄)

🛠️ 快速開始

新手推薦：GETTING_STARTED.md — 10 分鐘上手，從配置到寫出第一個 Plugin（2026-06-11 對照真實 CLI 全文重寫驗證）。

對應代碼版本：v0.59.7-alpha ｜ 測試：314 files / 3290 passed / 0 failed / 4 skipped ｜ 微內核純度檢查：PASS（scripts/check-purity.sh 機器強制）。

授權：本文件庫 CC-BY-4.0（LICENSE）；代碼 repo Apache-2.0。

引用 (Cite) — DOI 10.5281/zenodo.20698129（機讀格式見 CITATION.cff）：

Yang, Y. (2026). OpenStarry: An Agent OS Reference Architecture — Documentation Corpus, Tenets Fulfillment Ledger, and Letter to the Future (v0.59.3-alpha). Zenodo. https://doi.org/10.5281/zenodo.20698129

相关 MCP