# DSH Plugin Marketplace

> 帮助寻找DSH插件，引导安装，并持续在DeepSeek Harness内收集插件评分、FAQ、踩坑记录并分享到社区

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![DSH Index](https://img.shields.io/badge/DSH%20Index-dshindex.dev-47848F)](https://dshindex.dev)

[English](README.md) · **中文**

![Marketplace：搜索技能来源，并把安装提示加入当前 Harness 消息框](assets/marketplace-skill-install.gif)

## 它是什么

[DSH Index](https://dshindex.dev) 是 DeepSeek Harness 插件的公开索引，基于 GitHub [`dsh-plugin`](https://github.com/topics/dsh-plugin) 标签构建。**DSH Plugin Marketplace** 把这个索引带进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：浏览并查看插件、经你明确确认后安装，并向社区回馈。

它以插件形式运行在 DeepSeek Harness 内，并把同样的能力提供给 `dsh-index` CLI。

## 安装

```sh
dsh plugin --profile web add @dshindex/dsh-plugin-marketplace
```

然后重启 `dsh web`。该包在一个 bundle 中同时包含 host 插件、Web 客户端 bundle 和 `dsh-index` CLI。

## 功能特性

### 在 DSH Web 中

- **发现** —— 搜索并查看 DSH Index 来源，查看当前收录总数，并把可编辑的 `Install plugin <repository URL>` 提示交给 Agent。
- **报告 Issue** —— 把一次失败转成脱敏后的 GitHub 或 Gitee Issue 草稿；审阅后提交，并跟踪其状态。
- **反馈** —— 为插件打分、回答 FAQ 或报告踩坑。

### 在 CLI 中

同一套类型化客户端同时驱动 DSH 工具与 `dsh-index` CLI：

```text
dsh-index doctor
dsh-index plugins list --query "git" --tag workflow --cursor <cursor>
dsh-index plugins summary
dsh-index plugins show owner/repo
dsh-index install prepare owner/repo
dsh-index issue draft github owner/repo --title "…" --body "…"
dsh-index issue submit github owner/repo --title "…" --body "…" --confirm
dsh-index issue watch github owner/repo 42 --etag <etag>
dsh-index report score owner/repo --score 4 --share
dsh-index report faq owner/repo --text "…" --share
dsh-index report pitfall owner/repo --text "…" --share
```

CLI 是同一套受策略约束的库的接口，而不是绕过用户确认的捷径。在 Harness 中，对应的能力是可供模型调用的工具，其副作用调用必须走常规的用户审批策略。

## 信任与确认设计

- `dsh-plugin` 话题匹配只是**发现候选**，绝不代表兼容性或安全性声明。
- 每次安装都是用户确认的交接 —— 不存在后台安装。
- Issue 草稿在提交前会脱敏；token、密钥、源文件和原始对话记录默认排除。
- 评分与报告在作者主动选择共享、且 DSH Index 审核通过之前保持私密。
- Issue 轮询在本地且保守，使用条件读取与退避策略。

## 与 DSH Index 的关系

| 产品 | 职责 | 它不做的事 |
| --- | --- | --- |
| [DSH Index](https://dshindex.dev) | 公开发现、每日快照、观测动态与审核后的社区参考 | 认证仓库、审计安全或推荐安装 |
| Marketplace | DeepSeek Harness 行动层：搜索、查看、用户确认安装、Issue 草稿/状态与贡献 | 静默安装包、静默提交 Issue 或发布原始用户数据 |

## 开发

```sh
npm install
npm run check   # 构建 + 100% 覆盖率测试
```

## License

MIT。参见 [LICENSE](LICENSE)。