前言¶
在 DSH 裏做智能體應用，常見做法是單插件堆能力：模型、工具、界面各寫各的，數據和業務規則散落在會話上下文裏，換一個場景就要重新接一遍。Beelli X 社區中臺（dsh-beellix-plugin）走另一條路：以 Harness 爲執行底座，用「中臺連接 + 場景插件 + 數據契約」把模型配置、插件管理和場景導航收攏到同一套插件體系裏，讓個人或本地業務可以從單個場景起步，再按依賴與數據關係組合成應用系統。
下面介紹它是什麼、能做什麼、如何安裝，以及使用時需要留意的邊界。
這是什麼¶
Beelli X 中臺插件 社區版（GitHub：Beellix-dev/dsh-beellix-plugin）是由 Beellix-dev 維護的 DSH 工作流類插件，當前版本 0.1.1，許可證 MIT。定位是 Harness-Based Agentic Data Engineering：基於 DSH 的開源連接中臺，通過統一插件與數據契約，把場景應用、工具和公共能力接到 Harness 執行底座上。
插件在 DSH 宿主內以中臺形式運行：中臺負責安裝與配置登記，DSH 原生 Loader 與執行機制負責加載和會話內調用；各業務插件保留自己的服務與數據歸屬。官網 beellix.com 承擔作品發現與發行協作；本倉庫負責把生態能力接入 DSH，並在用戶環境裏組織應用與數據連接。
體系怎麼拆¶
Beelli X 圍繞三塊相互配合的部分構建：
- 通用執行：由 DSH 提供智能體運行、會話、上下文、工具、技能、子代理及執行控制。
- 中臺連接：管理插件、模型配置、資源接入和場景組織，維護依賴、配置與公共契約；通過原生 Loader Include 接入運行。
- 場景複用：把面向業務目標的應用封裝爲可安裝、可配置、可組合的場景插件。
插件模型分三類，職責在 README 中寫得很清楚：
| 類型 | 職責 |
|---|---|
| 基礎插件 | 共享服務、數據連接、存儲等公共能力；核心部分主要由 Beelli X 維護 |
| 場景插件 | 面向業務目標的應用，是生態共創與應用組裝的主要單位 |
| 工具插件 | 輸入、輸出與操作邊界明確的可複用執行能力 |
場景還有二級分類（經營管理、專業作業、內容創作、分析研究），便於在目錄裏按工作性質檢索；實際能力仍以各插件清單與接口聲明爲準。
核心功能（資料已覈實部分）¶
插件與模型管理¶
中臺提供插件管理、模型配置、資源接入和場景組織能力。插件模型配置按插件聲明逐項展示：標題、必配／選配、默認策略和可選型號均來自插件本身；中臺複用 DSH 主模型卡片與控件，按聲明的操作類型顯示對應圖標。聲明幾項就顯示幾項；服務密鑰可共享，不按連接重新合併配置項。
模型方案支持由插件聲明業務方案分組。知識庫等能力可將底層能力歸入「入庫處理」和「檢索與重排」兩個入口，連接配置與原生模型選擇保留。可選 MinerU 作爲文檔解析服務，啓用後適用文檔直接走其 API（界面不將其標爲自動備用模型）。
「發現」與目錄¶
安裝啓用後，DSH 內 發現 與官網公開插件目錄聯動，支持搜索、分類、詳情和確認安裝；連接失敗時可重試。SkillHub 目錄頁：https://www.skillhub.cn/plugins/Beellix-dev/dsh-beellix-plugin。
數據互通與應用組裝¶
數據互通強調歸屬明確、對象可關聯、操作有契約、結果可積累：業務記錄由對應服務維護，跨應用引用保留標識與來源；讀寫與業務動作走公開接口。Harness 運行上下文與持久化業務數據分開管理。
應用系統由場景插件及所需基礎插件、工具、模型與外部服務組成。裝配時需明確應用組成、能力依賴、數據關係、業務銜接和運行配置；可用應用套件記錄可複用的裝配方案。
數據工具 beellix_data¶
beellix_data 區分 catalog、describe 與讀寫參數，併兼容模型適配器對未使用可選字段填入 null。寫入能力由已啓用的業務插件聲明；目錄入庫只沿資源契約使用工作區相對路徑並經過原生確認。沒有寫入能力時停止，不探測本地端口、HTTP 或安裝目錄。
中臺自身更新¶
從官方 GitHub 倉庫安裝的中臺，可在首頁 檢查更新，有變化後 立即更新，校驗完成後保存工作並 重啓生效。同爲 0.1.1 時也能識別內容更新，無需先卸載。該機制沿 DSH 桌面公開 CLI 與原生鎖維護當前包，不改業務資料或其他插件；與業務插件的官網更新服務是分開的。
安裝與啓用¶
在 DSH 中打開 插件 → 添加插件，填寫倉庫地址（資料原文如下，請勿自行改寫成 CLI 子命令）：
https://github.com/Beellix-dev/dsh-beellix-plugin
安裝並啓用後，會自動初始化安全的新資料目錄。接着從 更多 → Beelli X 中臺 查看目錄狀態、選擇已有資料目錄、配置模型，並按需安裝其他 Beelli X 生態插件。
環境與兼容範圍見倉庫 快速開始 與 驗證說明。package.json 中聲明的宿主要求爲：Node.js ≥ 22，DSH ≥ 0.2.1-rc.2 且 < 0.3.0。
典型用法（按文檔路徑）¶
- 完成上述安裝後，在中臺內配置模型與資料目錄。
- 通過 發現 瀏覽官網目錄，按分類或搜索定位場景／基礎／工具插件，確認後安裝。
- 從單個場景接入自己的數據與能力；需要組合多個場景時，按 應用組裝 思路梳理依賴與數據契約（詳細步驟見 產品說明、功能說明、模型與配置）。
若要參與生態開發，人工開發、開發助手與 DSH 創造模式共用同一套 插件開發標準 與 開發指南。
適用場景與注意¶
適合誰：已經在用 DSH 做智能體或本地業務自動化，希望用插件化中臺統一管理模型、子插件與場景導航，並願意按數據契約做多場景協作的開發者或小團隊。
權限與安全：插件在 當前 DSH 進程權限 下運行。安裝前應閱讀源碼與 MIT 許可證，並查看 數據與隱私、安全報告入口。社區插件目錄（如 SkillHub）是獨立站點，與 DeepSeek／幻方無官方從屬關係，公網服務可用性與本地安裝後的運行需分別驗收。
生態背景：DSH 側的理念是「一切皆插件」；Beelli X 中臺本身是入口插件，真正業務能力來自後續安裝的基礎、場景與工具插件。
結尾¶
Beelli X 社區中臺把 DSH 原生執行與中臺側的插件、模型、目錄發現和數據契約接在一起，適合從單場景起步、再按依賴組裝本地 AI 應用的工作流。更多細節以倉庫文檔爲準。
