前言¶
DeepSeek Harness (DSH) 的插件生态需要便捷的管理入口。现有方式往往依赖外部目录或非集成的界面，开发者需要手动查找、核对源码与许可证，效率较低。该插件通过本地化的界面，将浏览、搜索、过滤与安装流程集成在 DSH 环境内部，提供稳定的插件发现与使用体验。
插件简介¶
lovstudio/dsh-plugin-marketplace 是一个本地优先的插件市场。它通过 GitHub 和 dshfind 两个提供商，将公开仓库的元数据同步到本地 IndexedDB 快照中，供 Web 设置和侧边栏使用。所有浏览、搜索和过滤操作均基于本地快照，无需实时访问外部 API。
核心功能¶
- 本地优先架构：将仓库元数据同步到 IndexedDB，支持本地读取。
- 多提供商支持：支持 GitHub（通过
topic:dsh-plugin主题）和 dshfind。 - 搜索与过滤：支持 Google 风格语法，支持排序、分页、方面筛选和关键词建议。
- 界面集成：
- 在设置中注册
settings.plugins.tab(id market)。 - 在侧边栏底部注册
sidebar.footer.action。 - 提供
shell.overlay模态框。 - 在设置插件项中注册
settings.plugin.item卡片。 - 质量评估：提供等级（S/A/B/C）、评分（0-100）和风险标记。
安装与启用¶
在使用前，请确保环境满足以下前置条件：
- Node.js 22.19+ 或 24+
- pnpm 11
通过以下命令安装插件：
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
安装后，在 DSH 的 Web 设置界面中即可看到名为 “market” 的选项卡，或在侧边栏底部看到相应的操作入口。
典型用法¶
安装完成后，可通过以下方式启动并使用市场：
方式一：从源码构建（推荐）
git clone --depth 1 --branch dsh-v0.1.2-rc.1 https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
pnpm dsh web
方式二：使用 npx（无需构建源码）
npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-plugin-marketplace#v0.1.9
npx @deepseek-ai/dsh web
启动后，在设置或侧边栏中打开市场，即可浏览、搜索插件并查看其质量评估信息。
注意事项¶
- 权限与安全：该插件以当前 DSH 进程的权限运行。在安装前，请务必检查插件的源码与许可证（MIT）。
- Token 管理：在设置页面测试 Token 时，系统不会保存草稿。若测试失败或拒绝写入，草稿会被保留并报告保存失败。留空 Token 字段可保留已存储的 Token。
- GitHub 速率限制：当触发 GitHub 速率限制时，系统会保留当前页面和冷却时间，然后重试该页面最多三次。
- 本地开发：若需本地开发，需将仓库置于 Harness 目录外，并通过
DSH_HOME环境变量和-w link:/path/to/...进行链接。
结语¶
该插件通过本地缓存和 IndexedDB，为 DSH 提供了一个高效、稳定的插件管理入口。通过质量评估和清晰的搜索过滤功能，降低了插件管理的复杂度。更多细节与源码，可参考其 GitHub 仓库。
