前言¶

在 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 安装与故障排查）