前言¶
DeepSeek Harness 提倡“一切皆插件”的理念，这使得开发者可以灵活扩展应用能力。然而，随着插件生态的扩张，社区中混杂了半成品、随机 Fork 以及各种未经验证的项目。在充斥噪音的搜索结果中寻找可用插件容易浪费时间且存在安全隐患。
dsh-plugin-market 旨在 DeepSeek Harness Web 客户端内提供一个经过验证的插件目录。它通过本地化的验证机制和浏览界面，帮助用户在不需要离开 DSH 界面的情况下，安全地发现和安装插件。
插件定位¶
这是一个运行在 DSH Web 客户端内部的插件市场。它不作为独立的 Web 服务运行，而是直接嵌入到 DeepSeek Harness 的浏览器界面中。
该插件由用户 2160039878-cyber 开发，采用 MIT 许可证。其核心设计原则是“验证优先”：内置的目录条目经过人工或脚本检查，确保具备基本的可安装性。
安装与启用¶
安装过程分为两步：首先将插件添加到 DSH 的 Web 配置中，然后启动 Web 客户端。
- 执行以下命令安装插件：
dsh plugin --profile web add github:2160039878-cyber/dsh-plugin-market
- 启动 DeepSeek Harness Web 客户端：
dsh web
- 在浏览器中打开
http://127.0.0.1:3080/，在页面右上角找到“插件市场”按钮并打开。
核心功能¶
该插件提供了浏览、搜索和验证插件的能力，同时严格遵循安全原则。
1. 验证目录浏览¶
插件内置了一个本地化的验证目录。打开面板后，无需发起网络请求即可查看已验证的插件列表。目录中包含市场、管理器、皮肤、工作流、运行时和开发者等类别的条目。
2. 搜索与发现¶
- 多语言搜索：支持中文和英文搜索。
- 中文映射：插件内置了中文搜索扩展，例如搜索“皮肤”、“市场”、“沙箱”、“会话”或“模板”时，会自动映射到对应的英文标签进行检索。
- GitHub 发现：本地目录有限，用户可以点击“搜 GitHub”按钮，显式地通过 GitHub 搜索发现潜在的插件源。
- 手动索引：当搜索索引较慢时，用户可以手动粘贴精确的
owner/repo或 GitHub 仓库 URL 来触发查询。
3. 信息展示与操作¶
- 概览信息：列表中直接显示中文摘要、星标数、编程语言、最后更新时间及描述。
- 安装命令复制：对于内置的已验证条目，插件会生成并显示带有特定 Git 提交哈希的安装命令，用户可直接复制使用。
- 仓库操作：支持直接在 GitHub 上打开匹配的仓库，并检查仓库是否符合 DSH 插件的规范。
4. 安全机制¶
- 无自动远程安装：插件不会自动安装远程代码。
- 无密钥访问：不读取用户的 DSH API 密钥或 GitHub 私有 API。
- 无隐藏写入：不会向用户的 DSH 配置文件进行自动写入操作。
- 安装性检查：在尝试安装前，插件会快速检查
package.json、dsh.bundle.patch、补丁文件以及 Web 客户端入口点，判断仓库是否像是一个真实的 DSH 插件。
5. 性能与稳定性¶
- 本地优先：内置的可用插件列表完全由本地数据提供，避免了因网络问题导致面板无法打开。
- 防阻塞设计：面板打开时不会自动搜索，这防止了在
api.github.com被阻断或限流时出现错误提示。 - 版本锁定：内置的条目被锁定到特定的 Git 提交，确保版本一致性。
典型用法¶
在实际使用中，该插件主要解决两个问题：查找经过验证的插件，以及检查 GitHub 上的陌生仓库是否适合安装。
-
查找内置插件：
打开插件市场面板，浏览内置的 12 个已验证条目。如果需要安装某个条目，复制面板中生成的安装命令并执行。 -
GitHub 发现与验证：
点击“搜 GitHub”按钮，输入关键词或直接粘贴仓库 URL。在搜索结果中，插件会显示该仓库是否看起来像真实的 DSH 插件。对于 GitHub 发现的条目，虽然可以显示为可安装，但它们不会被标记为已锁定到提交。
适用场景与注意事项¶
该插件适合需要在 DSH 环境中管理插件生态、寻求稳定插件来源的开发者或高级用户。
注意事项：
- 该插件仅作为浏览器端的辅助工具，它通过 GitHub 公开的搜索结果进行渲染。
- 它不存储任何本地数据或 Token。
- 虽然内置目录经过验证，但在安装任何插件（尤其是通过 GitHub 搜索发现的插件）前，建议查看源码和许可证。
