前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”，其社区生态独立于 DeepSeek 官方。在实际使用中，开发者往往需要手动逐个安装和配置社区插件，流程繁琐且容易出错。dsh-bundles 旨在解决这一问题，提供按人设分类的标准化工具集，支持一键安装、预览与安全卸载。
插件介绍¶
名称：dsh-bundles
仓库：lm20230311/dsh-bundles
定位：DeepSeek Harness 的精选人设插件包。
维护者：LM20230311。
解决痛点：手动管理多个插件的依赖关系与版本冲突，提供经过筛选的、按角色（如开发者、设计师）分组的插件组合。
核心功能¶
- 人设插件包：内置 6 个精选工具包，涵盖开发者、创作者、设计师、学生、研究人员及趣味场景，并包含 29 个社区插件。
- 一键工作流：支持卡片式预览、一键安装、安全卸载及实时安装进度查看。
- 插件详情：可查看每个插件的安装来源、仓库链接及市场元数据。
- 安全恢复：安装时会跳过已安装的包，保留预存在的共享包；若安装失败，系统会自动回滚到之前的状态。
- 共享目录：提供经过验证的社区插件目录，确保插件来源可靠。
安装与启用¶
通过官方命令行安装插件：
dsh plugin --profile web add dshbundles
安装完成后，需要重启 dsh web，然后打开 Settings → Plugin Bundles 即可使用。
典型用法¶
安装特定人设包¶
npx -y dshbundles@latest install developer --profile web
安全卸载包¶
npx -y dshbundles@latest uninstall developer --profile web
接管遗留安装¶
如果某个安装未在 UI 中被管理，或需要将手动安装的包纳入统一管理，可以使用接管命令：
npx -y dshbundles@latest adopt developer --profile web
查看安装状态¶
# 列出所有包
npx -y dshbundles@latest list --profile web
# 查看特定包的状态
npx -y dshbundles@latest status developer --profile web
源码测试安装¶
在发布前，若需测试源码，可以使用以下命令：
dsh plugin --profile web add --allow-build=dshbundles github:LM20230311/dsh-bundles#main
适用场景与注意¶
适用场景：需要快速搭建特定工作流（如全栈开发、UI 设计）的开发者，或希望批量管理插件的 DSH 用户。
注意事项：
* 插件以当前 DSH 进程的权限运行。在安装前，务必检查源码与许可证，确保符合安全规范。
* 安装操作会在目标配置文件中写入一份所有权账本，路径为 .dsh-bundles/state。
* 卸载操作仅移除该包独家安装的插件，不会删除预存在的包或被其他包引用的共享插件。
* 默认 pnpm 命令超时时间为 3 分钟，网络较慢时可设置环境变量 DSHBUNDLES_PNPM_TIMEOUT_MS 调整。
* 安装后需重启 dsh web 并在设置中刷新插件列表。
总结¶
dsh-bundles 通过标准化的管理流程，降低了接入 DeepSeek Harness 生态的门槛。它不仅提供了精选的插件组合，还通过安全机制保障了依赖管理的稳定性。项目主页与插件市场目录位于 dshbundles.com。
