dsh-dpharness（严选插件）

在 DeepSeek Harness（dsh）里浏览、搜索 dpharness.com 的 dsh 插件目录， 并可直接一键安装。

两个视图

面板（浮窗与页签共用同一套组件）顶部可在两个视图间切换：

视图	数据来源	回答的问题
严选推荐	GET /api/plugins（全量目录）	「我知道要什么，帮我找」——可搜索、可按 Star 排序
分类精选	GET /api/best（月度策展，与站点 /best 同一份数据）	「我该装哪几个」——按大类 → 小类分组，每小类只留 2~3 个

分类精选视图刻意保留两项元数据：小类内名次与上榜理由（如「小类第 1 · 实装验证通过 · 周下载 12.8 万」）。 去掉它们，这份清单就只是又一个列表；它们的价值恰恰在于「为什么是它」可复核。 入榜门槛（站点侧规则）：通过静态安装检查或 CI 实装验证 + 汉化完成；每月 1 日重算并公开淘汰原因。

三个入口

入口	位置	说明
页签「严选插件」	会话视图区	完整页：搜索 + 排序 + 批量浏览
左下入口	侧边栏底部（sidebar.footer.action）	点击展开全站浮窗
全站浮窗	右下角（shell.overlay，跨路由含首页）	随手查：随时搜、随时装

卡片显示什么

按「汉化优先」组织，缺汉化时明确标注而不是假装有：

1. 中文名（nameZh）— 站点已汉化
2. 中文分类 + 可信度徽章（tier / dshCompat / verify / tested / risk）
3. 卖点行（强调）— 取站点 tagline，经严格过滤；不合格就不显示
4. 汉化正文 — 站点 descriptionZh；没有则显示英文原文并标「未汉化」
5. 安装按钮 + 可复制的 dsh plugin --profile web add <包名>

⚠️ 上游 tagline 实测约一半不可用（英文原文 / 被截断 / 甚至 安装 、README 目录导航）。 本插件用 pickZh() 过滤：切段逐段找中文、中文字符 ≥ 6、段长 ≥ 8、丢弃英文导航词开头。 覆盖面见 test-local.mjs 里那些用真实样本写的用例。

一键安装怎么工作

两条路径，安全优先：

1. 优先复用 dshmarket 的同源 HTTP 路由（POST /dsh-market/install）—— 免重启热挂载、可回滚、带供应链校验。代价：它只接受自己 curated registry（awesome 目录）里的 URL。
2. 不在目录里 / 未装 dshmarket 时降级到本插件自己的 spawn： dsh plugin --profile web add <包名>（改 profile，装完需重启 dsh 生效）。

细节与安全约束：

• 命令来源与站点同口径（lib/installCmd.ts 的 resolveInstallTarget）： 只有 installCheck.status === "pass" 时才用 npm 包名，否则退回 owner/repo 走 GitHub 源安装， 并在卡片上标注来源（与站点详情页用词一致）。不会出现"什么都不给"的情况。
• 一键安装按钮只在站点已验证时出现（未验证/警告都按保守处理，只给可复制的命令）。
• 只有站点给出 installCheck.status === "pass" 的条目才显示安装按钮 （校验未过时 npm 上的同名包可能属于别人）。
• 安装前有二次确认，展示将要执行的包名。
• dshmarket 返回 409（有 agent 正在运行）时不降级，直接报错 —— 避免和正在工作的 agent 抢插件文件。
• 目标包名过字符白名单校验；子进程环境会剥掉宿主的 safe-delete shim（否则 pnpm 清理临时文件被拦）。
• 失败时展示 pnpm 的错误码行（如 [ERR_PNPM_FETCH_404] …），而不是一堆进度日志。

HTTP 路由（host 侧）

路由	说明
GET /api/dpharness/search?q=&take=&sort=stars	目录查询，字段裁剪后返回，按 q+take+sort 缓存 5 分钟
GET /api/dpharness/best	分类精选榜单（站点 /api/best 的代理 + 字段裁剪），缓存 5 分钟
POST /api/dpharness/event	埋点代理 → dpharness.com/api/track/event
POST /api/dpharness/install	{ pkg }，spawn dsh plugin add；返回 202 + 任务启动
GET /api/dpharness/install	安装任务进度与结果
GET /api/dpharness/meta	版本、profile、路由清单、缓存与安装状态

隐私

• 不采集搜索关键词原文，只上报动作、关键词长度与命中数。
• 复制/安装命令的上报口径与站点一致（copy_install 的 value 为整条命令）， 来源靠 path=/dsh-plugin 区分。
• 浮窗与页签底部都有匿名统计开关，可随时关闭。
• 埋点经本地 host 转发（站点端点不带 CORS 头），失败静默忽略，绝不影响操作。

安装本插件

官方命令（推荐）：

dsh plugin --profile web add dsh-dpharness

--profile web 是 dsh CLI 的必需参数，省略会直接报 required option '--profile <name>' not specified。 任何来源给出的 dsh plugin add <owner/repo> 都不可用。

也可从 GitHub 源安装（等价，未依赖 npm 缓存时用）：

dsh plugin --profile web add zhanghao3693/dsh-dpharness

开发用（改完立刻看效果，从本地目录装）：bash install.sh，然后重启 dsh （侧边栏「重启」按钮，或 pkill -9 -f "bin/dsh web" 让 launchd 拉起）。

⚠️ install.sh 与官方命令不能混用：官方安装会把它并入 profile 的 bundle 层， 而 install.sh 是往 profile 的 cordis.patch.yml 里插一段 insert —— 同一个 id 被插入两次会让 dsh 启动硬失败。切换前先清掉另一边。

卸载

从 ~/.dsh/profiles/web/cordis.patch.yml 删掉含 id: dpharness 的 insert 块，然后：

rm -rf ~/.dsh/profiles/web/node_modules/dsh-dpharness

开发自检

cd .dev && npm install react@19 react-dom@19 && cd ..
node test-local.mjs     # host 侧真打上游 + client 侧 SSR + pickZh 判据（真实样本）

不要用 ~/.dsh/profiles/node_modules/react 做测试依赖：那两个软链在 0.1.5 升级后已悬空（实测）。

License

MIT