前言¶
DeepSeek Harness 的核心理念是“一切皆插件”。随着插件数量的增加，手动管理社区目录、当前 Profile 的包清单以及 Loader 的运行态变得繁琐且容易出错。dsh-plugin-console 是一个安装在 DeepSeek Harness Web profile 中的插件管理器，它将社区目录同步、Profile 包清单、Loader 运行态查看、安装前验证、隔离试运行以及 Harness 一键更新功能整合到了 Settings 的“插件管理”页面中，并通过官方的 dsh plugin 命令完成底层操作。
该插件由 AlexYin-Tongji 维护，遵循 MIT 协议。它不提供营销式的“赋能”，而是通过具体的步骤和校验机制，帮助开发者安全、可控地管理插件生态。
核心功能¶
该插件主要包含以下功能模块：
* 插件商店：默认同步 awesome-dsh-plugin 目录，支持搜索、分类、分页和本地缓存。
* 安装前验证：在安装前检查 npm 包的合法 SemVer、repository、HTTPS tarball、SHA-512 integrity、dsh.bundle.patch 和生命周期脚本；GitHub 包固定到 commit。
* 已安装清单：读取 profile 的 direct dependencies、bundle 顺序、解析后的 package manifest、Loader entry/Fiber phase 和 Web client 能力。
* 使用说明：支持 Markdown、MDX、RST、TXT 和无扩展名 README，支持源码视图。
* 快捷更新：不自动安装，点击确认后执行，支持社区目录和 npm 包的版本升级。
* 快捷删除：只允许删除 direct dependency，清理 bundle 配置。
* 暂停使用：通过 profile Loader patch 持久化 disabled 状态。
* 隔离试运行：在临时 DSH_HOME 中启动完整 profile 以发现插件间或 DSH/Cordis 初始化冲突。
* 变更确认：生成 5 分钟有效的 plan，校验 profile 指纹和 artifact integrity。
* DSH 一键更新：左侧边栏入口，支持检查各通道最新版本并一键更新 Harness 本体。
安装与启用¶
在 DSH 所在环境安装该插件，需要使用官方的 dsh plugin 命令。
dsh plugin --profile web add dsh-plugin-console@latest
安装完成后，进入 DeepSeek Harness 的 Settings 页面，即可在“插件管理”栏目中看到该插件的控制面板。
主要操作说明¶
1. 插件商店与搜索¶
插件商店默认同步 awesome-dsh-plugin 目录。支持对插件进行搜索、分类浏览和分页操作。为了提升响应速度，目录内容会被缓存到本地。
2. 安装前验证¶
在安装或更新插件时，系统会进行严格的预校验：
* 包合法性：检查 npm 包的合法 SemVer 版本号。
* 完整性：验证 HTTPS tarball 和 SHA-512 integrity。
* 依赖检查：确认 dsh.bundle.patch 和生命周期脚本是否存在。
* 来源锁定：GitHub 来源的包会固定到具体的 40 位 commit，防止供应链攻击。
3. 已安装清单与详情¶
在插件管理界面，可以查看当前 Profile 的详细状态：
* 依赖关系：读取 direct dependencies。
* 加载顺序：查看 bundle 顺序。
* 运行态：解析后的 package manifest、Loader entry、Fiber phase 以及 Web client 能力。
* 文档阅读：点击插件卡片可查看 README，支持 Markdown、MDX、RST、TXT 格式，且包含源码视图模式。
4. 更新与删除¶
- 更新：插件管理器发现新版本后，只显示更新按钮，不会自动执行。用户点击确认后，系统会执行更新操作。社区目录中的包按已验证 artifact 更新；npm 包只有在同名、同 repository、合法升级版本和 integrity 都成立时才可更新。
- 删除：为了保护系统稳定性，只允许删除 direct dependency，系统 bundle 受保护。删除会同步清理
dsh.profile.bundles中的对应层配置。
5. 隔离试运行与变更确认¶
- 隔离试运行：在安装或更新后，系统会在临时
DSH_HOME、随机端口和隔离环境中启动完整 Web profile。这能提前发现插件间或 DSH/Cordis 初始化的冲突。如果目标 bundle 的 Loader 条目、包版本、bundle 语法或 HTTP 资源校验不通过，系统会自动恢复旧版本。 - 变更确认：所有写操作会先生成一个 5 分钟有效的 plan。执行前会重新校验 profile 指纹、当前包状态和 artifact integrity。
6. DSH 一键更新¶
在左侧边栏底部新增 Harness 更新入口。
* 版本检查：支持检查各通道（如 latest/next）的最新版本，面板会显示运行中/已安装/最新版本。
* 更新执行：点击更新后，支持一键更新 Harness 本体。更新只支持 npm 全局安装方式，并会执行精确校验和隔离验证，确保所有插件兼容后才生效。
安全与限制¶
- 删除限制：只允许删除 direct dependency，系统 bundle 受保护。
- 安全边界：浏览器 API 仅接受 typed install/update/remove/pause/resume，子进程使用参数数组且 shell: false。
- Harness 更新：只支持 npm 全局安装方式。
总结¶
dsh-plugin-console 是 DeepSeek Harness 插件生态中重要的管理工具。它通过严格的校验机制、隔离试运行环境和规范的变更确认流程，解决了插件管理中的安全和稳定性问题。对于需要管理 Profile 和 Loader 的开发者，该工具提供了从发现到安装、再到运行态监控的完整闭环。
