@gavinc-cn/dsh-plugins 0.1.0 → 0.2.1

package/README.md

@@ -1,84 +1,45 @@
-# @gavinc-cn/dsh-plugins
+# @gavinc-cn/dsh-plugins（聚合元包）
 
-把多个 DSH（DeepSeek Harness）自研插件收成**一个可安装单位**的 bundle 包：装上它，
-Plugins 面板里多出一张卡片；卡片里的每个**组件**（组合行）= 一个**独立开关**。
+> **0.2.0 起本包不再是 bundle。** 它只是一个「装一个拿到全部」的 npm 入口：
+> `dependencies` 指向拆分后的两个 bundle 包，自身不含 `dsh.bundle`、不含任何 `cordis.patch.yml`。
 
-- **一个包 = 面板一张卡片**：包名出现在 profile 的 `dsh.profile.bundles` 里，本包的
-  `cordis.patch.yml` 就会被当作一个配置层叠加进组合树。
-- **组件 = 行 = 开关**：本包每条 `- insert:` 声明一个组件；行状态（`disabled`）由各 profile
-  的 `cordis.patch.yml` 覆盖行持有，面板里拨开关就是往那里写回。
-- **整包开关**：包名在不在 `dsh.profile.bundles`。
+| 版本 | 语义 |
+|---|---|
+| `0.1.0` / `0.1.1` | 单包全量 bundle：`cordis.patch.yml` 里 13 条 `- insert:`，面板一张卡片 |
+| `0.2.0` 起 | 聚合元包：13 个组件拆成两个 bundle，本包只把它们一起装上 |
 
-## 安装
-
-```bash
-# 装进某个 profile（pnpm 会把依赖里的 11 个组件包一并装上）
-dsh plugin --profile web add @gavinc-cn/dsh-plugins
-```
-
-- CLI 这条路径会在 pnpm 成功后**自动**把新 bundle 追加进 `dsh.profile.bundles`（即装完就启用）。
-- 走 **Plugins 面板**的安装入口则**不会**自动选择 bundle，装完要自己把整包开关打开。
-- 改了 `dsh.profile.bundles` 要**重启宿主**才生效（启动时读）；profile patch 层是 live 热重载，
-  行级开关不需要重启。
+（拆分时是 UI 5 个 / 运行时 8 个；2026-10-15 `kanban-board` 移出 UI bundle 后两个 bundle
+合计 12 个；同日 `dsh-patch-ask-expand` 从运行时 bundle 移到 UI bundle ⇒ 现在是 UI 5 个 /
+运行时 7 个，合计仍是 12 个。）
 
-## 组件（11 个）
+## 拆分后的两个 bundle
 
-| 行 id | 包 | 做什么 |
-|---|---|---|
-| `kanban-board` | `@gavinc-cn/kanban-board` | Web GUI 任务看板（待开发/开发中/阻塞/待审核/已完成），拖进「开发中」自动建会话 |
-| `dsh-dim-text` | `@gavinc-cn/dsh-dim-text` | 把 Web GUI 文字梯度整体调暗一档 |
-| `dsh-session-unread-persist` | `@gavinc-cn/dsh-session-unread-persist` | 会话列表「已完成未查看」绿点持久化 |
-| `dsh-turn-labels` | `@gavinc-cn/dsh-turn-labels` | 右侧轮次刻度轨换成常驻文字（每轮一行显示该轮提问） |
-| `dsh-sidebar-width-persist` | `@gavinc-cn/dsh-sidebar-width-persist` | 左侧边栏拖动宽度持久化 |
-| `dsh-patch-ask-expand` | `@gavinc-cn/dsh-patch-ask-expand` | 展开 Web GUI 里「提问 / 回答」那一行 |
-| `dsh-superpowers-priming` | `@gavinc-cn/dsh-superpowers-priming` | 给「重开的会话」补一份 superpowers 开场说明（按会话历史判重，不重复注入） |
-| `dsh-memory` | `@gavinc-cn/dsh-memory` | 跨会话记忆：首轮注入两级记忆索引 |
-| `dsh-autocommit` | `@gavinc-cn/dsh-autocommit` | 回合收尾时若本会话还有未提交改动，挡下并提示模型先提交 |
-| `dsh-git-guard` | `@gavinc-cn/dsh-git-guard` | git 操作归属守卫（按提交前缀/分支命名判定，拦下越权 git 写操作） |
-| `dsh-file-guard` | `@gavinc-cn/dsh-file-guard` | 回合收尾比对「本会话写下的文件」与磁盘漂移，只报告不自动改回 |
+| 包 | 组件数 | 判据 | 面板卡片 |
+|---|---|---|---|
+| [@gavinc-cn/dsh-plugins-ui](../dsh-plugins-ui/README.md) | 5 | **面向 Web GUI**：4 个纯浏览器组件（声明 `dsh.client.platform: "web"`）+ `dsh-patch-ask-expand`（宿主侧启动时给官方 client bundle 打补丁，效果也是 GUI 观感） | 标题 = 包名 `@gavinc-cn/dsh-plugins-ui` |
+| [@gavinc-cn/dsh-plugins-runtime](../dsh-plugins-runtime/README.md) | 7 | 宿主（node）侧的运行支撑组件（记忆/守卫/沙箱等），没有 `dsh.client` | 标题 = 包名 `@gavinc-cn/dsh-plugins-runtime` |
 
-行 id 的约定是**包名去掉 scope**（`@gavinc-cn/dsh-memory` → `dsh-memory`）：profile 覆盖行按它命中，
-面板开关按它写回。要改组件集合，改本包的 `cordis.patch.yml` 即可（**改完 patch 层当场热重载**）。
+两个包合起来 = 拆分前 `0.1.x` 的 13 个组件减去不随 bundle 下发的 `kanban-board`，即 **12 个**；
+行 id 与相对顺序都没变 ⇒ 各 profile 的覆盖行原样继续命中（`dsh-patch-ask-expand` 从 runtime
+移到 UI 时也是如此，**profile 无需改动**）。
 
-## 机器相关配置不要写进这里
+## 安装
 
-本包只下发「有哪些组件 + 默认行为」。只有某台机器才成立的值（本地检出路径、状态目录、日志路径）
-请写在 profile 覆盖层：
+```bash
+# 想一次拿到两个 bundle 带来的 12 个组件的依赖（但仍要分别选 bundle）
+pnpm add @gavinc-cn/dsh-plugins
 
-```yaml
-# ~/.dsh/profiles/<profile>/cordis.patch.yml
-- id: dsh-superpowers-priming
-  config:
-    skillPath: /path/to/superpowers/skills/using-superpowers/SKILL.md
+# 真正把它挂进某个 profile：分别装两个 bundle（dsh plugin 会把包名追加进 dsh.profile.bundles）
+dsh plugin --profile web add @gavinc-cn/dsh-plugins-ui
+dsh plugin --profile web add @gavinc-cn/dsh-plugins-runtime
 ```
 
-| 组件 | 可覆盖项 | 默认值 |
-|---|---|---|
-| `dsh-superpowers-priming` | `skillPath`（或 env `SUPERPOWERS_SKILL_PATH`） | `~/superpowers/skills/using-superpowers/SKILL.md`（文件不存在只记日志、不注入） |
-| `dsh-file-guard` | `stateRoot`（或 env `FILE_GUARD_ROOT`） | `~/.orca/file-guard` |
-| `dsh-patch-ask-expand` | `bundlePath` | `~/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-tool/lib/client.js` |
-| 各组件 | `logPath` / `enabled` / `dryRun` | 日志在 `~/.kimi-code/hooks/logs/`，默认启用 |
-
-## 开发工作流（重要）
-
-若你像本仓库的开发方式一样，**把组件源码放在各 profile 共享的目录**
-（`~/.dsh/profiles/node_modules/@gavinc-cn/`）并在 profile 里用相对 `link:` 声明本包，那么
-「改共享目录里的源码立即生效、不需要重装」。
-
-在这种工作流下**不要**再对那个 profile 跑 `pnpm install` / `dsh plugin install`：本包在
-`dependencies` 里声明了 11 个 registry 组件包，pnpm 会把它们下载成 profile 自己的副本
-（`<profile>/node_modules/@gavinc-cn/*`），按 Node 的解析顺序**盖住**共享目录里那份，
-你改的源码就不再生效。要验证「干净安装」请在另一个 profile 或另一台机器上做。
-
-## 已知限制
+**不要**把本包名写进 `dsh.profile.bundles`：它声明不了 `dsh.bundle`，加载时会被判为
+`declares no dsh.bundle` 并跳过该层（面板里也会显示成一条 `not-bundle` 异常卡片）。
+用 `dsh plugin add @gavinc-cn/dsh-plugins` 装它时，CLI 会按**普通依赖**安装并打一条同样的 warning —— 这是预期行为。
 
-- 桌面端（Electron 宿主）改 `dsh.profile.bundles` 后必须**重启 App**；只有 patch 层是 live 热重载。
-- 面板里 node 侧组件的中文标题来自包内 `locale/*.json`，host 启动时缓存行元数据
-  （`pluginPackages.metaOf`）⇒ 运行中新增/改 `locale` 要重启宿主才看到。
-- `dsh-patch-ask-expand` 改的是另一个包（`@deepseek-ai/dsh-client-ui-tool`）的成品 client bundle；
-  重装/升级那个包会覆盖补丁，靠本插件在启动时重打。
-- 某些组件只在特定平台有意义（Web GUI 类组件在桌面端同样可用，但宿主侧的状态目录、
-  日志目录等按上表各自配置）。
+两个 bundle 的 `dsh.profile.bundles` + `dependencies` 都要写（后者决定面板卡片是否显示），
+改完重启宿主才生效；行级开关是 live 热重载。
 
 ## License
 

package/package.json

@@ -1,49 +1,29 @@
 {
   "name": "@gavinc-cn/dsh-plugins",
-  "version": "0.1.0",
-  "description": "DSH 插件组合包（bundle）：一个包承载多个可独立开关的组件（行），每行对应一个组件包；机器相关配置留在各 profile 覆盖层。",
+  "version": "0.2.1",
+  "description": "DSH 自研插件的聚合元包：自身不是 bundle（不含任何配置行），只把 @gavinc-cn/dsh-plugins-ui 与 @gavinc-cn/dsh-plugins-runtime 一起装上。",
   "license": "MIT",
-  "type": "module",
-  "main": "./lib/index.js",
-  "exports": {
-    ".": {
-      "default": "./lib/index.js"
-    },
-    "./package.json": "./package.json",
-    "./locale/*.json": "./locale/*.json"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gavinc-cn/dsh-plugins.git",
+    "directory": "packages/bundles/dsh-plugins"
   },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "files": [
-    "lib",
-    "locale",
-    "cordis.patch.yml"
-  ],
+  "homepage": "https://github.com/gavinc-cn/dsh-plugins/tree/master/packages/bundles/dsh-plugins#readme",
+  "bugs": "https://github.com/gavinc-cn/dsh-plugins/issues",
   "keywords": [
     "dsh",
     "deepseek-harness",
     "cordis",
     "bundle",
-    "plugin"
+    "plugin",
+    "meta"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
   "dependencies": {
-    "@gavinc-cn/kanban-board": "^0.1.2",
-    "@gavinc-cn/dsh-dim-text": "^0.1.1",
-    "@gavinc-cn/dsh-session-unread-persist": "^0.1.1",
-    "@gavinc-cn/dsh-turn-labels": "^0.5.2",
-    "@gavinc-cn/dsh-sidebar-width-persist": "^0.1.0",
-    "@gavinc-cn/dsh-patch-ask-expand": "^0.1.1",
-    "@gavinc-cn/dsh-superpowers-priming": "^0.1.0",
-    "@gavinc-cn/dsh-memory": "^0.1.0",
-    "@gavinc-cn/dsh-autocommit": "^0.1.1",
-    "@gavinc-cn/dsh-git-guard": "^0.1.0",
-    "@gavinc-cn/dsh-file-guard": "^0.1.0"
+    "@gavinc-cn/dsh-plugins-ui": "^0.1.0",
+    "@gavinc-cn/dsh-plugins-runtime": "^0.1.0"
   }
 }

package/cordis.patch.yml

@@ -1,64 +0,0 @@
-# @gavinc-cn/dsh-plugins —— 「一个插件包 = 多个可独立开关的组件」的组合行。
-#
-# 工作方式：
-#   * Plugins 面板出现 @gavinc-cn/dsh-plugins 卡片，卡片内每个行 = 一个组件 = 一个开关；
-#   * 行开关写回 profile patch 的 `- id: <行id>` 覆盖行（行状态留在各 profile，可各自独立开关）；
-#   * 整包开关控制包名在不在 profile 的 dsh.profile.bundles。
-#
-# 行 id 与包名的约定：id 是组合树里的本地行键（面板开关按它写回、profile 覆盖行按它命中），
-# 取包名去掉 scope（@gavinc-cn/dsh-memory → dsh-memory）；name 才是模块说明符（= 完整包名）。
-#
-# 依赖：本包在 package.json 的 dependencies 里声明了下述 11 个组件包 —— 装本包即把它们一并装上，
-# 各 profile 因此能按包名解析到每一行。若改成本地开发形态（组件源码放在共享目录、profile 里用
-# 相对 `link:` 声明本包），注意**别再**对那个 profile 跑 pnpm install：registry 版会盖住本地那份
-# （见 README「开发工作流」一节）。
-#
-# 机器相关配置（本机检出路径、状态目录、日志路径）**不进本文件**：写在各 profile 的覆盖行里，
-# 例如 `- id: dsh-superpowers-priming` + `config: { skillPath: ... }`（见 README 表格）。
-#
-# 改组件集合 = 改本文件：patch 层是 live 热重载，不需要重装/重启；改完同步到本包被加载的那份副本即可。
-
-- insert:
-    - id: kanban-board
-      disabled: true
-      name: "@gavinc-cn/kanban-board"
-
-- insert:
-    - id: dsh-dim-text
-      name: "@gavinc-cn/dsh-dim-text"
-
-- insert:
-    - id: dsh-session-unread-persist
-      name: "@gavinc-cn/dsh-session-unread-persist"
-
-- insert:
-    - id: dsh-turn-labels
-      name: "@gavinc-cn/dsh-turn-labels"
-
-- insert:
-    - id: dsh-sidebar-width-persist
-      name: "@gavinc-cn/dsh-sidebar-width-persist"
-
-- insert:
-    - id: dsh-patch-ask-expand
-      name: "@gavinc-cn/dsh-patch-ask-expand"
-
-- insert:
-    - id: dsh-superpowers-priming
-      name: "@gavinc-cn/dsh-superpowers-priming"
-
-- insert:
-    - id: dsh-memory
-      name: "@gavinc-cn/dsh-memory"
-
-- insert:
-    - id: dsh-autocommit
-      name: "@gavinc-cn/dsh-autocommit"
-
-- insert:
-    - id: dsh-git-guard
-      name: "@gavinc-cn/dsh-git-guard"
-
-- insert:
-    - id: dsh-file-guard
-      name: "@gavinc-cn/dsh-file-guard"

package/lib/index.js

@@ -1,3 +0,0 @@
-// 纯配置 bundle：运行时内容全在 cordis.patch.yml，本入口不挂任何东西。
-// 与官方 @deepseek-ai/dsh-experimental-schedule-bundle 同形（其 lib 也是 `export {}`）。
-export {};

package/locale/en.json

@@ -1,6 +0,0 @@
-{
-  "meta": {
-    "title": "Local plugin container",
-    "description": "One bundle holding the locally written plugins: each plugin is a separately switchable component row in the Plugins panel, and the whole bundle can be switched off at once."
-  }
-}

package/locale/zh.json

@@ -1,6 +0,0 @@
-{
-  "meta": {
-    "title": "自研插件容器",
-    "description": "把本机自研插件收成一个 bundle：每个插件在 Plugins 面板里是一行可独立开关的组件，整包也能一键停用。"
-  }
-}