榕器 · 企業 AI 資源統一管理平臺

前言¶

DeepSeek Harness（DSH）倡導「一切皆插件」的架構理念。基於這一架構，01men/ybkk-aios（榕器）構建了一個企業級 AI 資源統一管理平臺。它旨在解決多類資源（IAM、模型、應用、技能）分散管理的問題，通過一套身份、一套權限、一套計量、一套審計，實現對 AI 資源的統一接入、調度與管控。

核心功能¶

該平臺主要提供以下能力：
* 統一認證與權限：支持 IAM 組織架構、OIDC 登錄、場景級授權。
* 資源接入與管理：包含模型接入網關、MCP 服務部署與熔斷、Agent 與 AI 應用本體管理。
* 技能市場：提供 Skill 提交、靜態掃描、版本化管理與上架流程。
* 計量與審計：用量透明計量、審計與告警、內部成本穿透。
* 流程編排：支持流程編排域，包含 TF 編排、狀態機與模板庫。
* 模型渠道治理：分級路由、降級鏈與預算熔斷。

安裝與啓動¶

安裝插件¶

通過 DSH 插件命令安裝：

dsh plugin --profile web add github:01men/ybkk-AIOS

本地運行¶

安裝後需安裝依賴並啓動。首次啓動在空數據目錄上會執行基線初始化，生成根組織與管理員賬號。

npm install
npm start

啓動後訪問 http://127.0.0.1:7300 進入控制台。

演示模式¶

若需快速評估或測試功能，可啓動演示模式。該模式會自動生成完整演示數據與演示賬號。

DEMO_SEED=1 npm start

演示模式下，釘釘免密登錄可用（Mock 連接器），演示賬號口令均爲 Ybk@2026。

架構與配置¶

榕器本身是一棵 Cordis 插件樹，每個業務域對應一個插件包，可獨立聲明依賴與權限。

依賴與存儲約束¶

在開發或獨立宿主模式下，@deepseek-ai/cordis 必須僅存在於 devDependencies 中。若進入 dependencies，pnpm 會將其 hoist 到宿主，導致插件解析到錯誤的 cordis 實例，造成服務鏈失效。

平臺服務鍵已做衝突處理：
* 存儲鍵：必須使用 opsStorage（而非 storage），以避免與宿主自帶服務衝突。
* 工具鍵：tools 爲刻意共享接縫，獨立宿主下由 ToolRuntimeLite 提供，掛載進 dsh 後即進入原生 ToolRuntime。

配置注意事項¶

• Cordis YAML：本地開發檢出源碼時，cordis.yml 中的 <PROJECT_ROOT> 必須替換爲 file:/// 格式的絕對路徑（Windows 下裸盤符路徑會導致 ESM 報錯）。
• 同實例依賴：本地開發需將 node_modules/@deepseek-ai/cordis 指向 dsh 源碼樹的 vendor/cordis（Junction），確保插件與宿主加載同一實例。

運維與升級¶

平臺自更新¶

平臺支持自動檢查與手動升級，升級策略由管理員決定。
* 自動檢查：默認每 24h 一次，啓動 15s 後首查，發現新版本會在控制台顯示徽標。
* 手動升級：控制台提供「一鍵升級」或使用 CLI 命令。

    dshctl update status | check | apply [--dry-run]

商業模式與合規¶

• 定價：按「團隊 + 領域資產」定價（如行業圖譜包、場景包），製造業客戶可走私有化交付項目制。
• M0 合規：平臺對外只呈現用量與內部成本穿透，廢止按用量計費/轉售/分賬。錢包/分賬子系統已下線封存。
• M1-1 契約：包含 J1-J4 合同與安全加固（如默認開啓安全響應頭、usage 事件保留策略默認 730 天）。
• IAW 批次：包含流程編排、數據要素域、模型渠道治理、Agent 自治與 A2A 等能力。

適用場景與注意¶

• 適用場景：需要統一管理企業內 AI 模型、MCP 服務、Agent 和技能的開發與運維團隊；需要透明計量與審計的企業環境。
• 運行權限：插件以當前 DSH 進程的權限運行。在安裝前應檢查源碼與許可證（MIT）。
• 資料來源：詳細設計文檔與合約見項目目錄下的 docs/ 文件夾。