前言¶
在 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