前言¶

在 DSH Desktop 上擴展側欄與設置面板時，常見做法是把多個 UI 面板塞進同一個客戶端包、共用一份 lib/client.js。資料裏說明，這種形態會在首屏前下載並執行全部面板，且某一個面板的 apply 拋異常可能連帶影響其他面板。Muciya953 維護的 Muciya DSH macOS Suite（倉庫 Muciya953/Muciya-DSH-macos-suite）把能力拆成五個可各自安裝的 DSH Web 插件：插件庫、技能庫、外觀庫、智能體團隊、用量統計。每個包自帶 package.json、cordis.patch.yml、宿主半（lib/index.js）與瀏覽器半（lib/client.js），按需安裝、按需啓停。

下面介紹這套插件的定位、各包職責、安裝方式與使用注意。事實以 GitHub README 爲準；社區目錄頁見 SkillHub。SkillHub 分類爲「客戶端」，與 README 中各包的 DSH 分類一致。

這是什麼¶

Muciya DSH macOS Suite 面向 macOS 上的 DSH Desktop（以及滿足版本要求的 DSH 環境），提供五個完整 bundle，可單獨 dsh plugin add，不必一次裝齊。倉庫根包 muciya-dsh-plugin-macos-suite 在 monorepo 裏聚合五個子包；日常安裝以 packages/ 下各插件或 Release 裏的 .tgz 爲準。

許可爲 MIT；README 標註 Release v1.0.0，DSH 要求 >= 0.2.0-rc.2。

環境要求¶

安裝前對照 README 中的表格：

預構建的 lib/ 已入庫，Release 也有打包資產，兩條安裝路徑都不必先本地構建。

核心功能¶

插件庫（market）¶

上游 fork 的 @deepseek-ai/dsh-client-ui-plugin-manager：已安裝插件逐行啓停；插件市場瀏覽、安裝與來源歸屬；配置值顯示來自 profile 覆蓋層 / bundle 默認 / 出廠；默認快捷鍵 ⌘⇧M 打開設置裏的市場頁（不佔側欄行）；中文界面與上游英文條目可並存。

技能庫（skill）¶

零依賴。掃描 ~/.dsh-beta/skills、~/.agents/skills、工作區 .dsh/skills 與 .agents/skills；每行標註來源根；支持按名字、來源、描述篩選；宿主半隻做一次 web boot graph 自檢，不輪詢。

外觀庫（theme，macOS）¶

壁紙導出爲 DSH 皮膚（skin.json、skin.css、預覽圖）；影片皮膚可選原畫/壓縮與普通/無縫；航拍壁紙讀取系統 aerial 資源並轉封裝；提供 /api/skin-center/v2 供第三方皮膚中心；開機動畫換片與音軌、時長 2–10s 推導倍速；懸停色 CSS 三層；只讀用量卡聚合本機臺賬（寫入由用量統計插件負責）。路由分佈在 /api/muciya-appearance/v1 與 /api/skin-center/v2。

智能體團隊（agi）¶

花名冊與父子拓撲、跳轉會話；共享任務看板只讀刷新；自動化控制台彙總用戶 LaunchAgents、系統 agent/daemon、crontab 與 DSH 定時器；對用戶 launchd agent 可 start/stop/kickstart，系統 job 與 crontab 只讀；路由掛載失敗只記日誌。自動化控制台需 macOS。

用量統計（usage）¶

本地臺賬按本地日分桶（日 / 供應商 / 模型）；內置人民幣峯谷定價與模型別名；餘額探測覆蓋 README 所列十餘家供應商，單條失敗不影響其他條目；側欄卡流式刷新、寫盤 3 秒防抖；數據在 $DSH_HOME/muciya-usage/，可與 @linxin666/dsh-usage 並存。

安裝與啓用¶

三種方式任選其一；資產名與路徑以 README 原文爲準，不要憑倉庫名自行拼接未出現的命令。

一、從 Release 安裝（示例爲用量統計包，版本 1.0.0）：

dsh plugin add https://github.com/Muciya953/Muciya-DSH-macos-suite/releases/download/v1.0.0/muciya-dsh-plugin-usage-1.0.0.tgz

其餘 Release 資產名：muciya-dsh-plugin-skill-library、muciya-dsh-plugin-appearance-library、muciya-dsh-plugin-agent-teams、muciya-plugin-library，版本均爲 1.0.0。

二、從倉庫子路徑安裝（會在 profile 裏觸發構建，需 allowBuilds）：

dsh plugin add github:Muciya953/Muciya-DSH-macos-suite/packages/usage

將末尾路徑換成 skill-library、appearance-library、agent-teams、plugin-library 即可對應其他插件。

三、作爲 profile 本地插件（自改代碼時）：把包目錄複製到 <profile>/plugins/muciya-<名字>/，在 profile 的 cordis.patch.yml 末尾掛載，例如：

- insert:
    - id: muciya-usage
      name: ./plugins/muciya-usage/lib/index.js

裝完怎麼驗¶

1. dsh plugin list 中出現對應包名；
2. 側欄出現該插件行；
3. 宿主日誌有自檢行，例如 [appearance-library] 15 API routes mounted under /api/muciya-appearance/v1 …。

日誌路徑：桌面版在 ~/Library/Application Support/DSH Desktop*/logs/host/，CLI 在 ~/.dsh/logs/。

日常操作¶

• 啓停：設置 → 插件，展開對應行開關，寫入 profile 覆蓋層。
• 改配置：同一面板逐行編輯，字段前綴與行 id 一致（muciya-*）。
• 卸載：dsh plugin remove <包名>，或刪除 patch 行並移除目錄。
• 排錯：查宿主日誌中的 failed to import / never reached the web boot graph；外觀庫只讀診斷 GET /api/muciya-appearance/v1/usage；若裝了 web-all，還有 GET /api/dsh-web-all/degraded。

改代碼後可跑倉庫自檢：

node scripts/check-packages.mjs

適用場景與注意¶

適合在 macOS 上使用 DSH Desktop、希望把插件市場、技能瀏覽、主題/壁紙、智能體協作視圖和本地 token 臺賬分開安裝、分開升級的用戶。技能庫與用量統計對平臺要求較寬；外觀庫與智能體團隊裏的自動化控制台強依賴 macOS 系統 API。

DSH 社區目錄（SkillHub）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件以當前 DSH 進程權限運行，安裝前應自行查看源碼與 MIT 許可證，確認 API 路由與本地文件讀寫範圍可接受。

非 macOS 用戶若只需技能庫或用量統計，可按上表只裝對應包；外觀庫與 launchd/cron 控制台在 README 中明確標註爲 macOS 能力。

結尾¶

Muciya DSH macOS Suite 把原先擠在一個客戶端包裏的多塊面板拆成五個獨立 bundle，降低首屏耦合與單面板故障面，同時覆蓋市場、技能、主題、智能體運維與用量臺賬等 macOS 桌面場景。按需從 Release 或 packages/ 子路徑安裝即可。

• 社區目錄：https://www.skillhub.cn/plugins/Muciya953/Muciya-DSH-macos-suite
• 源碼與文檔：https://github.com/Muciya953/Muciya-DSH-macos-suite（含 MANUAL.zh.md 安裝與故障排查）