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.config.ts       # 构建（esm → lib/）
└── 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 后重试

路线

• P0 脚手架 + 加载验证（✅ 2026-09-25 于 dsh-v0.1.7-rc.2 源码宿主实测通过：pnpm dsh web --patch cordis.dev.patch.yml 输出 [dsh-plugin-cards] plugin loaded!）
• P1 设置卡片（Schemastery Config，schemastery 3.18.4 打包自包含；配置覆盖 + 默认值补全已实测）
• P2 对话节点（P2 v1：cards-annotation 节点监听 user/message，渲染于 chat 目标；客户端产物 lib/client.js 为手写闭包工厂格式，修改后跑 node --check 校验）
• P3 打包发布（✅ 2026-09-25 已发布 npm：dsh-plugin-cards。tarball 安装 + registry 真实安装双路径实测，端到端（安装→启动→加载→客户端 boot graph）全通。npm 发布要求 granular token 勾选 "Bypass two-factor authentication for API and CI"。✅ 2026-09-26 已同步发布 GitHub：yuanzukun/dsh-plugin-cards（public，topic dsh-plugin 等 6 个已挂载），并被官方社区目录（topic + npm keywords 双源）收录，市场可搜可装，CLI 实测干净环境装到最新版）
• 0.1.1 设置卡片修复：0.1.7 Web UI 的第三方 bundle 配置不进设置侧边栏，必须由客户端注册 plugins.bundle.config 槽位（keyed by 包名），渲染在「插件页 → dsh-plugin-cards 详情页」内；表单数据走 ctx.configForms.get(包名)（服务端导出的 Config schema 自动成为 settings namespace，ns = patch entry id）。官方范例 ui-settings-web-search。
• P2 扩展：自定义 SessionEvent + 模型可见输入（所见即所记）
• P4 入驻 awesome-dsh-plugin + dsh-plugin-hub

License

MIT © yuanzukun