dsh-plugin-cards

dsh-plugin-cards

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）
├── lib/                   # lib/index.js（编译产物）+ lib/client.js（手写客户端，勿手改 tsdown 配置外清理）
├── assets/                # cards-snapshot.json 快照原料（inject-snapshot 注入进 client.js 成出厂快照）
├── scripts/               # verify-*.cjs 版本验证脚本 + inject-snapshot.cjs 注入工具
├── .github/workflows/     # release.yml：tag 触发的全自动发布流水线
├── tsdown.config.ts       # 构建（esm → lib/，clean:false 保护手写 client.js）
└── docs/                  # 开发建议方案

本地调试（P0）

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 完成：

1. 打开 DSH 桌面端（DSH Desktop / dsh web 面板）
2. 进入 设置 → 插件 → 插件市场
3. 搜索 dsh-plugin-cards → 点击 安装 （市场目录来自官方社区仓库 github.com/topics/dsh-plugin，本插件已收录；新插件最迟次日快照自动收录，缓存 miss 时静默收割约 6 分钟内可达）
4. 安装后自动启用：设置卡片出现在插件详情页内，对话节点渲染于 chat 目标

更新同样在市场内完成：已安装插件有新版本时卡片显示「有更新」，一键升级。

命令行备选（CI / 无头环境 / 桌面端管理员）：

dsh plugin --profile desktop add dsh-plugin-cards    # 桌面端固定用 desktop profile
dsh plugin --profile <name>  add dsh-plugin-cards    # 其他 profile（web 等）

桌面端命令安装要点：

• Home 不用设置：CLI 与桌面端默认都用 ~/.dsh（即 C:\Users\<你>\.dsh），dsh plugin add 直接写进 ~/.dsh/profiles/desktop，装完重启桌面端生效
• 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 后重试

发布（tag 流水线）

# ① bump package.json 版本 → commit → push main
# ② 打 tag 推送，其余全自动（版本门禁 → build → 语法检查 → lib 漂移守卫 → npm publish → npmmirror sync → GitHub Release）
git push origin main && git tag v0.8.17 && git push origin v0.8.17

前置：仓库 Secret NPM_TOKEN（granular token，勾选 Bypass 2FA for API and CI）。✅ 2026-09-26 已配置并跑通（v0.8.16 起全自动发布）。

License

MIT © yuanzukun