前言¶
DeepSeek Harness (DSH) 的功能扩展主要依赖社区插件。开发者需要从外部目录浏览、验证并管理这些插件。@czj-git/dsh-plugin-hub 是一个插件，它将 DSH Plugin Hub 的社区插件目录集成到 Harness 内部，提供搜索、兼容性检查和安装管理功能。
插件介绍¶
本插件隶属于 @czj-git/dsh-plugin-hub，由 czj-git 维护。它是一个联网工具，用于搜索和排序 DSH Plugin Hub 上已验证的社区插件。通过它，你可以在不离开 Harness 界面的情况下，查看插件市场、已安装列表、排行榜和任务中心。
安装与前置条件¶
安装前请确保环境满足以下条件：
- 已安装 DeepSeek Harness。
- Node.js 版本为
^22.19.0 || >=24.0.0。
设置页需要 Web profile 的客户端扩展支持。在终端执行以下命令安装到 Web profile：
dsh plugin --profile web add @czj-git/dsh-plugin-hub
安装完成后，重新启动 Harness 并刷新页面。
核心功能¶
该插件主要提供两类使用方式：设置页管理和对话工具调用。
设置页管理¶
在 Harness 的设置中，左侧会出现「插件中心」，包含四个标签页：
- 插件市场：按关键词、分类和分页浏览插件。卡片展示插件名、作者、简介、验证状态、分类、Stars、浏览量、安装来源和主要语言。主按钮根据兼容性和本机状态显示「安装」、「更新」、「已安装」或「不兼容」。点击「查看安装计划」可审阅兼容性。
- 已安装：读取当前 profile 的本机清单，包括依赖声明、实际安装版本、来源、bundle 状态、目录版本，以及启用状态。支持单项或批量更新和卸载。
- 排行榜：切换日增长、Star 总榜、最新上架或最近活跃榜单。支持分类筛选和分页。
- 任务中心：跟踪当前 profile 的生命周期队列，包括排队、校验、执行、核对与最终状态。支持取消、重试、脱敏日志和重启提示。
对话工具¶
在对话中，Agent 可调用以下工具：
dsh_plugin_search：搜索插件，支持按分类、运行形态、安装来源、排序和分页筛选。dsh_plugin_rankings：查询指定榜单。dsh_plugin_installed：查询本机已声明的插件信息（包名、版本、来源、启用状态）。dsh_plugin_task_status：查询本机安装、更新与卸载任务的状态、失败原因和重启要求。
技术细节¶
插件会校验公网 API 的每个返回字段，并暴露分页、数据更新时间和匿名限流信息。它支持 Harness 取消信号、可配置超时和 429 重试信息。Native 模式返回紧凑文本，PTC 模式返回完整结构化结果。
使用示例¶
在对话中搜索¶
你可以直接在对话中下达指令，让 Agent 搜索插件：
用 DSH Plugin Hub 搜索 memory 相关插件，选出最多 5 个，用中文说明用途，并给出安装命令和详情链接。
查看本机状态：
用 DSH Plugin Hub 查看当前 profile 的已安装插件和最近任务，告诉我哪些已生效、哪些还需要重启。
在设置页操作¶
- 打开「设置」 -> 「插件中心」。
- 在「插件市场」中输入关键词，如 “memory”。
- 浏览列表，点击插件的详情链接或「安装」按钮。
- 在确认面板中审阅计划，确认后创建安装任务。
- 在「任务中心」中跟踪执行结果。
注意事项¶
- 环境要求：必须安装 DeepSeek Harness 和 Node.js
^22.19.0 || >=24.0.0。设置页仅在 Web profile 环境下可用。 - 安装流程：安装需要用户在设置页审阅并确认结构化计划，点击不会立即执行修改。
- API 访问：公网目录访问不需要 API Key。对话搜索工具需要 Harness 已配置可用的模型。
- 返回模式：对话工具在 Native 模式下返回紧凑文本，PTC 模式返回完整结构化结果。
- 浏览器限制：浏览器不能直接请求跨域公网 API，所有请求通过插件代理处理。
- 版本依赖：中转页需要本插件 0.4.0 或更新版本。
总结¶
@czj-git/dsh-plugin-hub 将 DSH Plugin Hub 的社区生态整合进 Harness 的本地环境。它通过设置页和对话工具两种方式，为开发者提供了插件发现、兼容性检查、安装管理和任务跟踪的一站式解决方案。
