前言¶
DeepSeek Harness (DSH) 的 Web GUI 提供了插件管理入口，但原生面板的功能较为基础。dsh-lego-plugin 是一个将动态 Cordis 插件以乐高积木形式呈现的客户端插件，旨在提升交互直观性和视觉反馈。
插件介绍¶
该插件由 XIAOke8698 维护，采用 MIT 许可证。它不依赖外部库，完全使用 CSS 渲染乐高积木的物理质感（ABS 塑料光泽、微倒角、同心圆凸点）。
核心功能¶
- 面板替换与热插拔：替换 Web GUI 左下角的“Cordis Plugin”原生面板，支持热插拔，无需刷新页面。
- 乐高积木渲染：积木具有 ABS 塑料质感、光泽和倒角。运行中的插件呈现霓虹发光宝石效果，停止状态为半透明，等待审批状态为红色脉冲轮廓。
- 多色与自适应形状：系统根据插件 ID 自动分配官方乐高 10 色调色板，并根据哈希值自适应几何形状（2x2、2x3、2x4 等）。
- 交互反馈：点击积木有触觉“咔嗒”声（Web Audio 合成），面板头部提供“摇一摇”按钮以重新分配颜色。
- 辅助功能：支持按插件 ID 搜索、侧边栏显示运行数量、中英文国际化（i18n）以及跟随系统的浅色/深色主题。
安装¶
安装前请确保 DSH 环境已配置 Web GUI，并且 pnpm 已加入系统 PATH（dsh plugin 命令会转发到 pnpm）。
dsh plugin --profile web add dsh-lego-plugin
如果你在 DSH 源码树内开发测试，dsh 命令不可用，可改用：
pnpm dsh plugin --profile web add dsh-lego-plugin
使用方法¶
- 启动 DSH Web GUI。
- 在左侧边栏底部点击“Cordis Plugin”条目。
- 面板以乐高积木列表形式展示当前会话的动态插件。
- 点击积木进行操作：
| 积木状态 | 操作 |
|---|---|
| 运行中（实心 + 绿点） | 停止、移除 |
| 已停止（灰色） | 运行、移除 |
| 等待审批（红色轮廓） | 批准、批准（未来版本）、拒绝 |
适用范围与注意事项¶
- 管理范围：仅管理动态插件（
dyn/*），这些是通过cordis_define创建的插件。静态插件（cordis.yml中定义的）不会出现在列表中。 - 卸载影响：卸载插件后，原生 Cordis Plugin 面板会自动恢复，并清理该插件注入的样式和
cordis.patch.yml配置。 - 版本兼容：需要
pnpm版本 ≥ 10，且安装源码包时需处理构建脚本权限。
结尾¶
该插件通过可视化的方式简化了动态插件的启停与审批流程，适合需要频繁调试或管理多个动态插件的开发者。
