前言¶
DeepSeek Harness（DSH）的理念是“一切皆插件”。当你的配置文件中包含上百个 fiber 时，很难搞清楚智能体实际由哪些组件构成。哪个 fiber 卡在 pending？谁提供了 llm 服务？dsh-session-title-first-prompt-llm 是做什么的？dsh-constellation 旨在解决这些问题。它提供了一个实时、自组织的星座图，展示运行中的配置文件中的每个插件和服务 fiber。
这是什么¶
dsh-constellation 是一个客户端插件，提供 DeepSeek Harness 插件生态的实时、自组织星座图。它支持 AI 平衡的 taxonomy、双语标签、即时搜索、健康诊断以及一键插件操作。
核心功能¶
可视化图谱¶
插件以图形化方式展示，支持缩放和搜索。地图初始状态为折叠：每个能力域显示为一个药丸形状，大小由成员数量决定，域之间有聚合的依赖边。
- 点击域以展开其成员插件（呈径向布局），再次点击以折叠。
- 大域（成员数超过 12 个）会显示服务集群（例如 llm ×8），点击集群可过滤插件。
- 悬停或选择插件可显示实时依赖边。
- 按 / 键可搜索插件、服务、关键词或域。
AI 原生组织¶
插件生态增长速度快于任何手写的类别列表。如果配置文件中启用了 LLM，Constellation 会利用它：
- AI taxonomy：模型提议一个平衡的能力 taxonomy（无巨型域或单例域），并附带双语标签。它为每个插件分配短标签。
- AI 描述：为没有描述的插件生成一行摘要。
- 一键重分类：点击“AI classify”按钮重新组织地图。
详情抽屉与操作¶
每个插件打开一个侧边抽屉，显示其标签、描述、相位以及提供的/消费的服务。
- 启用 / 禁用：通过 cordis-plugin-loader 树 API 切换条目状态，并持久化到配置文件（无需重启）。
- 移除：停止条目并将其从加载器树中删除（需要确认）。
医生诊断¶
对实时快照进行自动诊断。点击发现项可检查详情：
- ⏳ Stuck pending：等待不存在于活动插件中的服务的 fiber。
- ❌ Failed fibers：加载时崩溃的插件。
- 🧟 Zombie entries：已启用但 fiber 已被释放的条目。
- ⚠️ Duplicate providers：两个插件提供相同服务。
双语 UI¶
界面支持中文和英语，一键切换。
安装与启用¶
安装插件需要运行 Web 配置文件（例如 web profile）。
dsh plugin --profile web add dsh-constellation
安装完成后，启动 Web UI：
dsh --profile web
在界面右下角点击 ✦ 按钮以打开 Constellation。
典型用法¶
- 按
/键搜索插件、域或关键词。 - 点击域以展开/折叠成员插件。
- 点击集群（例如
llm ×8）以过滤插件。 - 在详情抽屉中启用、禁用或移除插件。
要求与注意事项¶
- DeepSeek Harness：版本必须为
>= 0.1.0-rc.8。 - Node.js：版本必须为
>= 20。 - 数据安全：数据从未离开 localhost；路由会拒绝非环回 Host 头。
- 可选：要使用 AI taxonomy 和标签，需要配置默认模型。
结语¶
dsh-constellation 为管理复杂的插件生态系统提供了一个可视化的操作台，使开发者能够快速定位问题并管理插件状态。
