前言¶
在 DSH 桌面环境里，智能体开发者往往要同时处理多件相互关联的事：发现与切换工作室、管理项目容器、观察本地服务状态、维护会话与更新记录。若把这些能力拆成多个互不相关的插件安装，目录结构和运行时边界容易混乱。dsh-studio-library 把控制面相关的两个包打成可安装的组合 bundle，业务工作室仍可按需单独安装，下面介绍其定位、能力与安装方式。
这是什么¶
dsh-studio-library（GitHub：1997liuyh-boop/dsh-studio-library）是由维护者 1997liuyh-boop 发布的 客户端 类 DSH 插件。仓库描述为：可安装的控制 bundle，用于工作室发现、项目容器、服务状态、会话与更新；业务工作室保持可选。
根包只捆绑两个控制包，不附带业务工作室或私有 Live2D/Cubism 资源。项目数据与更新记录隔离在 DSH_HOME/studio/<studio-id>/ 下。
社区目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-library（独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的思路）。
核心功能¶
组合安装后主要包含两块（资料中的包名与职责）：
dsh-worktable¶
- 工作室列表
- 控制室（control room）
- 项目容器
- 分屏工作区与窗口布局
dsh-studio-projects¶
- 工作室注册
- 页面服务（page serving）
- 本地服务启动与健康状态
- 会话工具
- 任务扩展与更新记录
根 package.json 声明 dsh.bundle.patch；packages/worktable 与 packages/runtime 各自保留包清单以及编译后的 Host/Client 入口。当前资料中的版本为 0.1.14，许可证为 MIT。
安装与启用¶
安装前请完全退出 DSH Desktop。在 Windows 上可通过 Desktop 安装目录下的载体 CLI 安装控制 bundle；业务工作室需根据其各自 README 另行添加，空业务工作室列表是合法状态。
官方 README 给出的命令如下（将 <Desktop install directory> 替换为实际安装路径）：
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-library#v0.1.14"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop list
第一条命令会安装 dsh-worktable 与 dsh-studio-projects。用 plugin --profile desktop list 校验：manifest 须包含 dsh.bundle.patch，且包须暴露声明的 main 入口与 patch 文件。完成包操作后重启 Desktop。
升级时注意：Git 提交不会自动更新已安装的 lockfile；升级时应重新安装精确 tag。移除旧版组合包前建议保留 DSH_HOME/studio/；若需保留业务工作室，应在移除该组合包前先安装好对应业务工作室。
也可在完全退出 Desktop 后使用官方 Desktop 插件管理器安装（与 README 说明一致）。
环境与限制¶
- 兼容 DSH
0.2.2-rc.1构建；从源码构建需 Node.js 22（package.json中engines.node为>=22，engines.dsh为0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2）。 - 本地应用、OBS、外部提供商与模型资源需自行配置；公开包不含凭证、私有模型文件或 Cubism Core。
- worktable 适配部分保留上游声明，见仓库内
SDK-SNAPSHOT.json及相关文件。
典型用法（可复现流程）¶
1、安装控制 bundle（见上文 PowerShell 命令，tag 使用 v0.1.14）。
2、执行 plugin --profile desktop list，确认 dsh.bundle.patch 与入口、patch 文件就绪。
3、重启 Desktop，通过 worktable 侧能力使用工作室列表、控制室与分屏布局；通过 studio-projects 侧完成工作室注册、本地服务与健康检查、会话与更新记录。具体业务工作室按各工作室 README 单独 add，数据落在 DSH_HOME/studio/<studio-id>/。
适用场景与注意¶
适合谁： 需要在 DSH Desktop 上统一管理工作室发现、项目容器、服务状态、会话与更新，且希望控制面与业务工作室安装解耦的开发者。
安全与权限： 插件在当前 DSH 进程权限下运行。安装前应自行查看源码与 MIT 许可证，确认是否符合你的环境与合规要求；公开包本身不包含凭证或私有模型。
资料说明： 截至撰写时，GitHub 仓库星标为 0（以目录线索为准）；功能与版本以仓库 README 与 v0.1.14 tag 为准。
结尾¶
dsh-studio-library 把 dsh-worktable 与 dsh-studio-projects 合成一步可装的控制 bundle，业务工作室仍按需扩展，数据按 studio-id 隔离。需要安装说明与清单字段时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-library
- GitHub：https://github.com/1997liuyh-boop/dsh-studio-library
