dsh-plugin-cards
DeepSeek Harness (dsh) 设置卡片 + 对话节点插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-cards@0.9.29Plugin Cards 以 dsh-plugin-cards 发布，当前版本为 0.9.29。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness (dsh) 插件：设置卡片 + 对话节点 + 插件市场（社区插件发现 / 安装 / 管理）。
版本锚定：dsh >= 0.1.7-rc.2（上游最新，见 docs/dsh-plugin-开发建议方案.md）。
├── package.json # dsh.bundle manifest（组合包）
├── cordis.patch.yml # 发布形态 patch（按包名引用）
├── cordis.dev.patch.yml # 本地调试 patch（绝对路径，勿随包发布）
├── src/index.ts # 插件入口（tsdown 只编译此文件 → lib/index.js）
├── src/client/ # 客户端源码真相源（按域分块：00-wrapper/10-runtime/20-node-ui/30-market-pure/40-market-helpers/80-market-section/99-apply）
├── lib/ # 纯产物：lib/index.js（编译）+ lib/client.js（assemble-client.cjs 分块拼接组装）
├── assets/ # cards-snapshot.json 快照原料（assemble-client 裁剪后注入 lib/client.js 成出厂快照）——不入库（2026-10-12 方案 A）：本地 node scripts/refresh-factory-snapshot.cjs 拉取，CI 发版时自动从 hub 拉取
├── scripts/ # 工具脚本：assemble-client.cjs 组装 + load-client-pure.cjs 纯逻辑装载（测试/脚本共用）+ simulate-client-apply.cjs 客户端冒烟（CI 门禁）+ fetch-all-dsh.cjs 官方源收割复算（URL 构造与客户端同源）等
├── tests/ # 纯逻辑单测（node:test 零依赖，pnpm test；已接入 release.yml 门禁）
├── .github/workflows/ # release.yml：tag 触发的全自动发布流水线
├── tsdown.config.ts # 构建（esm → lib/，clean:true；client.js 由组装步骤在清空后重建）
└── docs/ # 开发建议方案
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" 层
启动后终端应打印 [dsh-plugin-cards] plugin loaded!，UI 在 http://127.0.0.1:3080。
普通用户不需要命令行，全程在桌面端 UI 完成：
dsh web 面板）dsh-plugin-cards → 点击 安装
（市场目录来自官方社区仓库 github.com/topics/dsh-plugin，本插件已收录；新插件最迟次日快照自动收录，缓存 miss 时静默收割约 6 分钟内可达）更新同样在市场内完成：已安装插件有新版本时卡片显示「有更新」，一键升级。
命令行备选（CI / 无头环境）：
dsh plugin --profile desktop add dsh-plugin-cards # 桌面端固定用 desktop profile dsh plugin --profile <name> add dsh-plugin-cards # 其他 profile（web 等）
- ✅ dsh 0.2.0+：桌面端菜单栏「Manage dsh command」可内置 dsh 命令并管理插件，无需另装 Node / pnpm（官方 0.2.0-rc.2 起）；
dsh已在 PATH 时 CLI 与桌面端默认都用~/.dsh，装完重启桌面端生效- ⚠️ 以下为 0.1.x 旧版用户备注：
dsh命令需在 deepseek-harness 源码 checkout 根目录执行pnpm dsh plugin ...（本机无全局 dsh）；必须用与桌面端一致的 pnpm（v12），旧 pnpm 重建 modules 会假成功；若 npm 装到偏旧版本，多为 pnpm metadata 缓存陈旧，删除%LOCALAPPDATA%/pnpm-cache/v11/metadata/registry.npmjs.org/dsh-plugin-cards.jsonl后重试- ⚠️ CLI 本地路径安装陷阱（2026-10-12 实测，宿主 0.2.0-rc.2）：
dsh plugin --profile <name> add <本地路径>（link 模式）只写 dependencies，不写dsh.profile.bundles激活清单 → 插件 UI 仅在当前实例存活，实例重启后静默消失（dsh plugin list只看 dependencies，极难察觉）。修复：手动把插件名加进~/.dsh/profiles/<name>/package.json的dsh.profile.bundles数组后重启。市场 UI 安装的插件不受影响（宿主自动补写 bundles）
# ① bump package.json 版本 → commit → push main
# ② 打 tag 推送，其余全自动（版本门禁 → build → 语法检查 → lib 漂移守卫 → npm publish → npmmirror sync → GitHub Release）
git push origin main && git tag v0.9.4 && git push origin v0.9.4
前置：仓库 Secret NPM_TOKEN（granular token，勾选 Bypass 2FA for API and CI）。✅ 2026-09-26 已配置并跑通（v0.8.16 起全自动发布）。
市场目录唯一来源为官方社区仓库 github.com/topics/dsh-plugin。本节只描述当前生效口径；版本演进与踩坑史见 docs/dsh-plugin-开发建议方案.md 的版本状态流水。
dsh.engine 声明为 >=0.1.7-rc.2（偏宽）：完整功能（设置卡片 / 对话节点 / locale 服务）需宿主 ≥0.2.0；旧宿主上 inject 硬依赖项 fail-fast 拒载，代码内另有防御（能力检查 + 中文回退）。topic:dsh-plugin + 近 12 个月有更新 + 名称/描述/标签含 dsh（★ 不限，完整覆盖官方 topic 页）dsh.bundle 才可安装（宿主硬门禁）→ L2 dsh.engine 与桌面端 0.2.0-rc.2 semver 兼容（不兼容默认隐藏）→ L3 展示规范三件套（icon/locale/package.json exports）计 0-3 分仅作排序full_name）去重：同一仓库被多个 npm 镜像/抢注包回挂时收敛为一条（npm-only 条目按包名天然唯一）；保留优先级 可安装 > npm 名与仓库名一致 > 展示合规分 > 星数 > 来源 both>github>npmCATIDX_RULES_VER 调整时 +1 使旧缓存失效dsh-/dsh_ 前缀漏斗测 full_name 仓库段（npm scoped 镜像 @owner/dsh-xxx 两形态同治）；全量 13748 条实测「其他」87 条（0.6%），剩余长尾基本为无描述/模板仓库promoteActiveCat + 单测）；窄屏 ≤480px chips 墙替换为下拉选择器description_zh（hub 侧 LLM 预翻译）> 运行时翻译（LLM 批量 → MyMemory 兜底）> 原文；搜索域包含译文，中文关键词可命中英文描述插件；本页有未译出条目时工具行显示「⚠ {n} 条未翻译」可点击重试restart-required，界面提示「下次启动 DeepSeek Harness 后加载」（桌面端安装后需重启宿主生效，刷新页面无效）BundleInfo.version 取本地真实版本（如 已安装并启用：github:o/r（v1.1.71；…））——市场卡版本来自快照元数据（最长滞后一个快照周期），git HEAD 安装实装的是实时最新，卡面与横幅口径分裂会误导用户dcards.mktview.v1（localStorage，形状校验后恢复）——卸载/安装完成后宿主整页刷新会重挂载面板，不持久化则搜索词清空、被踢出市场上下文（真机 E2E 实证）；「清除筛选」同步清存储ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED），客户端识别该错误并换人话 + 展示 pnpm hint 打印的精确授权键；该路径程序化授权重试结构性不可用（宿主 approveBuilds 只批 pnpm 预写进 pnpm-workspace.yaml 的占位条目，硬失败路径无占位——真机两轮 + asar 源码双证），自救 = 把精确键（两侧加英文双引号，@ 是 YAML 保留字符）写入 allowBuilds: 段后重试，或改走 npm 渠道（免授权）。generic 构建拦截（registry 包 Ignored build scripts）保留「授权构建并重试」流，且载荷已修正为宿主 wire schema 要求的字符串数组（旧对象载荷被边界校验拒绝，该流此前在宿主 0.2.0-rc.2 上整体失效）classifyNetError，单测覆盖；环境侧可在 profile cordis.patch.yml 调大 githubConnectionTimeoutMs）netSeq 严格递增防循环，走位决策已外提为纯函数 ladderNext，逐级走位有单测）：
① npm 同名探测（jsDelivr 拉 package.json，repository 字段一致性校验防同名抢注；命中换 npm 名重装，宿主 npm 通道自带 npmmirror 兜底）→ ② hub 镜像 tarball（快照条目带 tgz 字段时走 dsh-plugin-hub tgz 池，hub CI 预构建）→ ③ codeload tarball URL（与主站不同网络路径；spec 以 #.tar.gz 片段结尾通过宿主 TARBALL_SPEC 校验）→ ④⑤ 原通道重试 ×2（退避 0.8s/3s）；非 github: spec 退化为原通道重试 ×3netKeyFromChange(res) 从 ChangeResult 原始 diagnostic 分类（中文译文不参与分类，随 Error.netKey 传递）；pnpm 11 降级配置须写 profile pnpm-workspace.yaml（fetchTimeout/fetchRetries，.npmrc 会被无视）；宿主 inspect 拒绝（如 declares no dsh.bundle）属供应链硬门禁非网络故障，梯子正确止步SNAP_STALE_MS=13h 对齐 hub 双跑间隔，超龄源不采用继续试下一候选，全源耗尽取最新陈旧版兜底（离线可用性优先）scripts/assemble-client.cjs --keep/--npm-keep；原料 assets/cards-snapshot.json 不入库（git 体积治理，2026-10-12 方案 A）——CI 发版自动拉取，本地用 node scripts/refresh-factory-snapshot.cjs（候选清单与客户端 SNAPSHOT_URLS 单一来源）zhmap（翻译映射）优先写入保住反英文固化链路；catidx 全量缓存超限按设计放弃持久化（jsDelivr HTTP 缓存承接重拉 + 重建 ~230ms 兜底）；容量探针 scripts/verify-snapshot-capacity.cjs 可复现实测MIT © yuanzukun