@dsh-external/dsh-plugin-workshop

Readme

# 🧩 DSH 插件工坊（dsh-plugin-workshop）

简体中文 | [English](README.en.md)

DeepSeek Harness（DSH）的**创意工坊式插件浏览器**——零服务器、单包开箱即用，内置在 DSH Web UI 侧栏「新会话」按钮正下方。

> 与 [DSH_Creative_Workshop](https://github.com/OBdangshang07/DSH_Creative_Workshop) 的中心化市场平台路线不同，本项目走**零基础设施**路线：目录、搜索、热度、发布时间全部由 GitHub 免费提供，不部署任何控制平面或账号系统，装进 profile 即用。

## ✨ 特性

- **侧栏常驻入口**：官方「新会话」按钮正下方，同款样式（DOM 克隆官方按钮，宽/窄侧栏自适应），刷新、重启都不丢
- **搜索与排序**：关键词搜索（支持中文，自动映射英文）、★最热 / ⏰最新、**飙升榜时间窗口**（近 7/30/90 天新建 + 热度排序，Steam Trending 近似）
- **默认只搜 DSH 插件**：默认「插件话题」（`topic:dsh-plugin`）；搜索结果自动排除官方 harness 等核心仓库（查询级 `-repo:` 过滤，不再占据榜首）；全站模式自带**插件特征验证**（检查 `package.json` 的 `dsh` 字段 / `cordis.yml` 等，走 raw CDN 不耗 API 额度），默认过滤无关仓库
- **已安装管理**：工具栏「📦 已安装」视图——合并 profile 依赖/激活行/本地预设展示本机插件（类型、激活状态、安装来源），一键更新（pnpm update / git pull）与卸载
- **双语体验**：描述一键切换原文/中文机翻，README 可整篇翻译（Google 翻译接口，自动缓存）
- **智能一键安装/卸载（预检分级）**：详情页自动预检仓库结构，给出「可直接安装 / 有风险 / 建议手动」三级评级——标准 bundle/nested/preset 一键安装照旧；特殊结构（多包 monorepo、非插件仓库、带构建脚本等）自动降级为**作者给出的安装方式**（从 README 提取安装命令，可复制，绝不自动执行）。卸载按安装方式逆向清理（pnpm remove 失败则不动文件、不留失效链接；成功后自动重启 dsh web 刷新插件表）；缺 git 时界面明确提示
- **详情页**：星数/fork/语言/许可证/创建时间、README 轻量渲染、手动安装命令、GitHub 直达
- **额度透明**：实时显示 GitHub 搜索剩余额度与恢复倒计时；可选填 GitHub Token（30 次/分，仅存本机浏览器）
- **零服务器**：数据全部来自 GitHub 搜索 API（浏览器直连，CORS）+ raw.githubusercontent.com（特征验证与 README）；可选接入统计服务后解锁「社区装机徽章 + 真·飙升榜」（见 [`remote/README.md`](remote/README.md)，不部署零影响）

## 📦 安装

以 web profile 为例：

```bash
# 一条命令即可：本包在 package.json 声明了 dsh.bundle.patch，
# dsh plugin add 会自动把它加入 profile 的 dsh.profile.bundles，
# 启动时其 cordis.patch.yml 作为 bundle 补丁层自动激活，无需手改配置。
dsh plugin --profile web add "github:yyyyukari/dsh-plugin-workshop"

# 重启 dsh web 并刷新浏览器
```

> 手动接入旧流程：把本包加进 profile dependencies，并在 `$DSH_HOME/profiles/web/cordis.patch.yml` 添加：
> ```yaml
> - insert:
>     - id: plugin-workshop
>       name: '@dsh-external/dsh-plugin-workshop'
> ```

激活后侧栏「新会话」下方出现「🧩 插件工坊」，点击打开浮层；设置 → 插件 区也有「插件工坊」标签页。

## 🧭 使用

| 需求 | 操作 |
|---|---|
| 找 DSH 插件 | 默认即「插件话题」列表（`topic:dsh-plugin` 收录的仓库） |
| 看飙升榜 | 时间下拉选 近7天/近30天/近90天飙升 + ★最热 |
| 中文搜索 | 直接输入「天气」「翻译」等中文词，自动映射英文关键词 |
| 看中文描述 | 工具栏「描述中文」；详情页「翻译 README」 |
| 安装/更新/卸载插件 | 详情页「一键安装（订阅）/ 更新到最新 / 卸载」，按仓库类型自动选择安装路径（需要本机 git，缺失时会提示） |
| 提高搜索额度 | 工具栏 ⚙ → 填入 GitHub Personal Access Token |

## 🏗️ 架构

- **宿主侧**（`lib/index.js`）：在 `webServer` 服务上注册同源 HTTP 路由 `/dsh-plugin-workshop/api/{status,install,update,uninstall}`；智能安装（bundle/preset 类型检测）与逆向卸载（严格输入校验 + 自定义头 CSRF 防护）
- **浏览器侧**（`lib/client.js`）：React + 平台种子模块；DOM 克隆官方按钮 + MutationObserver 自愈；`shell.overlay` 与 `settings.plugins.tab` 双挂载
- **数据流**：GitHub 搜索 API（匿名 10 次/分）→ 特征验证与 README（raw CDN，无额度）→ 机翻（Google gtx）
- **安全**：不执行任何第三方代码；Token 仅存 localStorage

## 🗺️ Roadmap

- [x] v1.1 一键安装/更新（宿主 API：git 探测、clone/pull 到 `.agent-presets`，缺失时界面提示）
- [x] v1.2 智能安装/卸载：bundle 型走官方 `dsh plugin add` + 激活行，preset 型走 `.agent-presets`，卸载逆向清理（实测通过）
- [x] v1.3 遵循 DSH bundle 规范：`package.json` 声明 `dsh.bundle.patch`（`dsh plugin add` 一条命令自动激活）；智能安装兼容三种仓库形态（bundle / nested / preset）
- [x] v1.4 「已安装」管理视图（更新/卸载、类型与激活状态）；搜索结果排除官方核心仓库；卸载安全化（失败不改动、自动重启刷新）
- [x] v1.5 可选统计服务（Phase A）：匿名装机埋点 + 社区装机徽章 + 真·飙升榜（Cloudflare Worker 参考实现见 `remote/`，未部署时零影响）
- [x] 社区索引收录：✅ 三大列表全部收录——[awesome-dsh-plugin](https://awesome-dsh-plugin.com/)（UI Enhancements 分类）/ [awesome-deepseek-harness](https://github.com/0xsline/awesome-deepseek-harness) / [awesome-dsh-plugins](https://github.com/AdamPlatin123/awesome-dsh-plugins)

## 📄 License

MIT