前言¶
DeepSeek Harness（dsh）把能力拆成可组合的插件；日常开发里，除了装插件，还需要在设置里看清各插件提供了什么、在对话界面里挂载节点 UI，以及从社区目录里发现同类插件。宿主自带界面未必覆盖「设置卡片 + 对话节点 + 社区市场」这一整套体验。下面介绍社区插件 dsh-plugin-cards（维护者 yuanzukun），它在 dsh 桌面端 / Web 面板中提供设置卡片、对话节点渲染，并内置基于官方 topic 口径的插件市场。
这是什么¶
dsh-plugin-cards 是 dsh 的客户端类插件：在 npm 上的包名为 dsh-plugin-cards，当前版本 0.9.29（见仓库 package.json），许可证 MIT。仓库在 GitHub，SkillHub 目录页为 skillhub.cn/plugins/yuanzukun/dsh-plugin-cards。
插件在 manifest 中声明 dsh.engine 为 >=0.1.7-rc.2；README 说明设置卡片、对话节点与 locale 相关完整能力需宿主 ≥ 0.2.0，旧宿主上会 fail-fast 或走能力检查与中文回退。
核心功能¶
设置卡片与对话节点¶
安装并启用后，设置卡片出现在该插件在设置里的详情页内；对话节点渲染在 chat 目标上。客户端通过 dsh.client.inject 注入 @deepseek-ai/dsh-client-ui-conversation 与 @deepseek-ai/dsh-client-ui-renderer，平台为 web。
内置插件市场¶
市场目录的唯一来源为 GitHub 官方社区 topic：github.com/topics/dsh-plugin。发现规则包括：topic:dsh-plugin、近 12 个月有更新、名称/描述/标签含 dsh 等；安装需通过宿主 L1 门禁（声明 dsh.bundle）。界面提供六大类与二级分类筛选、中文描述优先级（快照 description_zh → 运行时翻译 → 原文）、搜索与 Tab 状态持久化（localStorage 键 dcards.mktview.v1）。
网络安装失败时，客户端按文档实现降级梯（例如 npm 同名探测、hub tarball、codeload tarball、原通道重试等），并对 pnpm 11 git 依赖构建授权、GitHub 连接超时等错误给出中文说明与自救提示。
出厂快照与在线补齐¶
发版产物内联按星数裁剪的 Top 1500 条目快照（完整目录约 1.3 万+ 条，打开市场后在线补齐）；快照来自 hub 定时任务与面板静默检查，Stale 守卫与 jsDelivr 镜像策略见仓库 README「数据通道与缓存」一节。
安装与启用¶
普通用户推荐全程在桌面端 UI完成，无需命令行：
- 打开 DSH 桌面端（或
dsh web面板） - 进入 设置 → 插件 → 插件市场
- 搜索
dsh-plugin-cards，点击 安装（本插件已收录于上述 topic 社区；新插件最迟次日快照收录） - 安装后自动启用；桌面端安装后需重启宿主才加载（宿主无 HMR 时界面会提示「下次启动 DeepSeek Harness 后加载」）
更新同样在市场内完成：已安装插件有新版本时卡片显示「有更新」，可一键升级。
命令行备选（CI / 无头环境）如下，profile 需与使用场景一致：
dsh plugin --profile desktop add dsh-plugin-cards
dsh plugin --profile <name> add dsh-plugin-cards
dsh 0.2.0+ 时，桌面端可通过「Manage dsh command」内置 dsh 并管理插件；dsh 已在 PATH 时 CLI 与桌面端默认共用 ~/.dsh。
注意：README 记录 CLI 本地路径 link 安装可能只写 dependencies、不写 dsh.profile.bundles，重启后插件 UI 会静默消失；市场 UI 安装不受影响。0.1.x 旧版用户若本机无全局 dsh，需在 deepseek-harness 源码根目录用与桌面端一致的 pnpm 执行 pnpm dsh plugin ...。
典型用法（本地调试）¶
维护者本地联调 dsh 源码时，在插件仓库构建后，用 dev patch 挂到宿主：
pnpm install
pnpm build
在 deepseek-harness 源码 checkout 根目录执行（路径按本机修改）：
pnpm dsh web --patch D:/导航/dsh-plugin/cordis.dev.patch.yml
pnpm dsh --profile web --dump-config
启动后终端应打印 [dsh-plugin-cards] plugin loaded!，UI 在 http://127.0.0.1:3080；dump-config 输出中应出现 # == dsh-plugin-cards 配置层。
适用场景与注意¶
适合谁：已在用 dsh 桌面端或 Web 面板、希望在设置里用卡片管理插件配置、在对话里使用节点 UI，并需要从官方 topic 口径浏览、安装社区插件的用户与插件作者。
权限与安全：插件以当前 dsh 进程权限运行；安装前应阅读 仓库源码 与 MIT 许可证，自行评估供应链与网络安装行为（含 git / npm 拉取与构建授权）。
生态说明：DSH 社区插件目录（如 SkillHub）是独立社区站点，与 DeepSeek / 幻方无官方从属关系；本插件市场数据口径对齐 GitHub dsh-plugin topic，而非第三方自封的「官方应用商店」。
结尾¶
dsh-plugin-cards 把设置卡片、对话节点和社区插件市场收进同一客户端插件，安装路径以桌面端市场为主、CLI 为辅。进一步了解实现与发布流水线见仓库 README 与 docs/dsh-plugin-开发建议方案.md。
