dsh-manage-session 0.2.3 → 0.4.8

package/package.json

@@ -1,121 +1,125 @@
-{
-  "name": "dsh-manage-session",
-  "version": "0.2.3",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public",
-    "tag": "dsh-0.1.2"
-  },
-  "description": "DSH Web 插件：会话管家 —— 会话历史文件（归档浏览与清理）与会话健康检查（体检 → 处方 → 出院），不碰会话日志、只做可逆处置",
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "session",
-    "archive",
-    "health",
-    "doctor"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/drscrewdriver/dsh-manage-session.git"
-  },
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "default": "./lib/client.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-general"
-      ]
-    }
-  },
-  "scripts": {
-    "build": "node -e \"require('fs').rmSync('lib',{recursive:true,force:true})\" && tsc -b && tsdown",
-    "prepublishOnly": "npm run build",
-    "typecheck": "tsc -b --pretty false",
-    "test": "vitest run"
-  },
-  "files": [
-    "lib/index.js",
-    "lib/index.d.ts",
-    "lib/client.js",
-    "src",
-    "cordis.patch.yml",
-    "dsh.plugin.json",
-    "screenshots.json",
-    "README.md",
-    "README.en.md",
-    "README.ja.md",
-    "README.ko.md",
-    "INSTALL.md",
-    "INSTALL.zh.md",
-    "INSTALL.ja.md",
-    "INSTALL.ko.md",
-    "CHANGELOG.md",
-    "CHANGELOG.ja.md",
-    "CHANGELOG.ko.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20",
-    "dsh": ">=0.1.2-rc.1 <0.1.3-0"
-  },
-  "license": "MIT",
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.2-rc.1 <0.1.3-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.2-rc.1 <0.1.3-0",
-    "@deepseek-ai/dsh-client-ui-settings-general": ">=0.1.2-rc.1 <0.1.3-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.1.3-0",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "react": "^18.2.0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-client-locale": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-settings": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-settings-general": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-slots": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "@types/node": "^24.0.0",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "^18.3.7",
-    "cordis": "^4.0.0-rc.7",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "tsdown": "^0.22.2",
-    "tsx": "^4.23.12",
-    "typescript": "^5.6.0",
-    "vite-tsconfig-paths": "^6.1.1",
-    "vitest": "^4.1.1"
-  }
-}
+{
+  "name": "dsh-manage-session",
+  "version": "0.4.8",
+  "publishConfig": {
+    "tag": "dsh-0.1.7"
+  },
+  "description": "DSH Web 插件（DSH 0.1.5 专线）：会话管家 —— 会话历史文件（归档浏览与清理）与会话健康检查（体检 → 处方 → 出院），不碰会话日志、只做可逆处置",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "session",
+    "archive",
+    "health",
+    "doctor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drscrewdriver/dsh-manage-session.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-general"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('lib',{recursive:true,force:true})\" && tsc -b && tsdown",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -b --pretty false",
+    "test": "vitest run",
+    "release:015": "npm publish --tag dsh-0.1.5"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/index.d.ts",
+    "lib/client.js",
+    "src",
+    "cordis.patch.yml",
+    "dsh.plugin.json",
+    "screenshots.json",
+    "README.md",
+    "README.en.md",
+    "README.ja.md",
+    "README.ko.md",
+    "INSTALL.md",
+    "INSTALL.zh.md",
+    "INSTALL.ja.md",
+    "INSTALL.ko.md",
+    "CHANGELOG.md",
+    "CHANGELOG.ja.md",
+    "CHANGELOG.ko.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-settings-general": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-session": ">=0.1.7-rc.1 <0.1.8-0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings-general": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@types/node": "^24.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "^18.3.7",
+    "cordis": "^4.0.0-rc.7",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.23.12",
+    "typescript": "^5.6.0",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.1"
+  }
+}

package/screenshots.json

@@ -1,3 +1,7 @@
 {
-  "screenshots": []
+  "screenshots": [
+    "assets/left-sidebar.png",
+    "assets/archive.png",
+    "assets/doctor.png"
+  ]
 }

package/src/client/card.tsx

@@ -1,153 +1,150 @@
-/**
- * 设置卡（插件配置行）：一个可折叠抽屉 —— 会话历史文件 / 健康检查。
- *
- * **chrome 必须自己渲染**：DSH 的「插件」设置分区（`dsh-client-ui-settings-plugins`）
- * 只做一件事——按 settings 命名空间分发 `settings.plugin.item`：
- *
- *     renderSlot('settings.plugin.item', {}, { entryKey: ns })
- *
- * 它**不提供任何外壳**。所以卡片的标题、说明、展开/收起全归插件自己所有
- * （同分区里 search-index 等卡片都是这个形态）。早期版本只渲染了裸行，
- * 结果既与分区内其它插件的抽屉形态不一致，又让 `card.title` / `card.desc`
- * 变成定义了却没人渲染的死文案。
- *
- * 读写走 settingsScope 的显式 `set`（用户在控件上的直接操作，非隐式提交）。
- */
-import { createElement, useState, useSyncExternalStore, type JSX } from 'react'
-import { DEFAULT_CONFIG, type StewardConfig } from '../config.ts'
-import { translate, type LocaleKey } from './locales.ts'
-
-/** 卡片字典面。 */
-export type CardTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
-
-/** 设置 scope 面（结构化镜像，与 toggle 的 SwitchCardScope 同形状）。 */
-export interface StewardCardScope {
-  getSnapshot(): {
-    status: 'ready' | 'loading' | 'unavailable'
-    value: StewardConfig | undefined
-    revision?: number
-    writable: boolean
-  }
-  subscribe(listener: () => void): () => void
-  set(field: string, value: unknown): Promise<void>
-}
-
-/** 卡片入参。 */
-export interface StewardCardProps {
-  t?: CardTranslate
-  scope: StewardCardScope
-}
-
-/** 一行设置项。 */
-function Row(props: { title: string; desc?: string; control: JSX.Element }): JSX.Element {
-  return createElement('div', { className: 'dss_setRow' }, [
-    createElement('div', { key: 'text', className: 'dss_setText' }, [
-      createElement('span', { key: 't', className: 'dss_setTitle' }, props.title),
-      props.desc !== undefined && createElement('span', { key: 'd', className: 'dss_setDesc' }, props.desc),
-    ]),
-    createElement('div', { key: 'ctl' }, props.control),
-  ])
-}
-
-/** 一个布尔开关（原生 checkbox 语义，样式由本插件 CSS 提供）。 */
-function Toggle(props: { checked: boolean; disabled?: boolean; onChange: (checked: boolean) => void }): JSX.Element {
-  return createElement('label', { className: `dss_toggle${props.checked ? ' dss_toggleOn' : ''}` }, [
-    createElement('input', {
-      key: 'i',
-      type: 'checkbox',
-      checked: props.checked,
-      disabled: props.disabled === true,
-      onChange: (event: { target: { checked: boolean } }) => { props.onChange(event.target.checked) },
-    }),
-    createElement('span', { key: 's', className: 'dss_toggleTrack' }, createElement('span', { className: 'dss_toggleKnob' })),
-  ])
-}
-
-/** 抽屉头：标题 + 说明 + chevron，整块可点。 */
-function Header(props: { t?: CardTranslate; open: boolean; onToggle: () => void }): JSX.Element {
-  return createElement('button', {
-    key: 'head',
-    type: 'button',
-    className: 'dss_setHead',
-    'aria-expanded': props.open,
-    onClick: props.onToggle,
-  }, [
-    createElement('span', { key: 'text', className: 'dss_setHeadText' }, [
-      createElement('span', { key: 't', className: 'dss_setCardTitle' }, translate(props.t, 'card.title')),
-      createElement('span', { key: 'd', className: 'dss_setCardDesc' }, translate(props.t, 'card.desc')),
-    ]),
-    createElement('svg', {
-      key: 'chev',
-      className: 'dss_setChev',
-      width: 16,
-      height: 16,
-      viewBox: '0 0 16 16',
-      'aria-hidden': true,
-    }, createElement('path', {
-      d: 'M4 6l4 4 4-4',
-      fill: 'none',
-      stroke: 'currentColor',
-      strokeWidth: 1.5,
-      strokeLinecap: 'round',
-      strokeLinejoin: 'round',
-    })),
-  ])
-}
-
-/** 插件设置卡主体（抽屉）。默认收起，与「插件」分区内其它卡片一致。 */
-export function StewardSettingsCard({ t, scope }: StewardCardProps): JSX.Element {
-  const snapshot = useSyncExternalStore(
-    (listener) => scope.subscribe(listener),
-    () => scope.getSnapshot(),
-  )
-  const [open, setOpen] = useState(false)
-  const value: Partial<StewardConfig> = snapshot.value ?? {}
-  const writable = snapshot.writable
-
-  const rows: JSX.Element[] = []
-  if (snapshot.status === 'unavailable') {
-    // 拿不到设置服务：抽屉仍要在（否则这个插件在分区里彻底消失），只是里面说明原因。
-    rows.push(createElement('div', { key: 'unavailable', className: 'dss_setDesc' }, translate(t, 'card.unavailable')))
-  } else {
-    rows.push(
-      createElement(Row, {
-        key: 'enabled',
-        title: translate(t, 'card.enabled'),
-        desc: translate(t, 'card.enabled.desc'),
-        control: createElement(Toggle, {
-          checked: value.enabled ?? DEFAULT_CONFIG.enabled,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('enabled', checked) },
-        }),
-      }),
-      createElement(Row, {
-        key: 'history',
-        title: translate(t, 'card.history'),
-        desc: translate(t, 'card.history.desc'),
-        control: createElement(Toggle, {
-          checked: value.historyFiles ?? DEFAULT_CONFIG.historyFiles,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('historyFiles', checked) },
-        }),
-      }),
-      createElement(Row, {
-        key: 'health',
-        title: translate(t, 'card.health'),
-        desc: translate(t, 'card.health.desc'),
-        control: createElement(Toggle, {
-          checked: value.healthCheck ?? DEFAULT_CONFIG.healthCheck,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('healthCheck', checked) },
-        }),
-      }),
-    )
-    if (!writable) rows.push(createElement('div', { key: 'ro', className: 'dss_setDesc' }, translate(t, 'card.readonly')))
-  }
-
-  return createElement('div', {
-    className: `dss_setCard${open ? ' dss_setCardOpen' : ''}`,
-  }, [
-    createElement(Header, { key: 'head', t, open, onToggle: () => { setOpen(current => !current) } }),
-    open && createElement('div', { key: 'body', className: 'dss_setBody' }, rows),
-  ])
-}
+/**
+ * 设置卡（插件配置行）：一个可折叠抽屉 —— 会话历史文件 / 健康检查。
+ *
+ * **chrome 必须自己渲染**：宿主不为贡献卡提供任何外壳，标题、说明、
+ * 展开/收起全归插件自己所有。早期版本只渲染裸行，与同分区其它插件
+ * 的抽屉形态不一致，还让 `card.title` / `card.desc` 成为死文案。
+ *
+ * 读写走 configForms（`configForms.get(STEWARD_ENTRY_ID)`，以本插件 entry 为键；
+ * 旧宿主回退 settingsScope 绑定）的显式 `set`。0.1.7 起本卡挂在插件族共用
+ * 设置节（`dsh-family.tab`，dsh-thinking-levels 顶级「起子插件设置」节声明）里，
+ * 与同节其它抽屉一样默认展开。
+ */
+import { createElement, useState, useSyncExternalStore, type JSX } from 'react'
+import { DEFAULT_CONFIG, type StewardConfig } from '../config.ts'
+import { translate, type LocaleKey } from './locales.ts'
+
+/** 卡片字典面。 */
+export type CardTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
+
+/** 设置 scope 面（结构化镜像，与 toggle 的 SwitchCardScope 同形状）。 */
+export interface StewardCardScope {
+  getSnapshot(): {
+    status: 'ready' | 'loading' | 'unavailable'
+    value: StewardConfig | undefined
+    revision?: number
+    writable: boolean
+  }
+  subscribe(listener: () => void): () => void
+  set(field: string, value: unknown): Promise<void>
+}
+
+/** 卡片入参。 */
+export interface StewardCardProps {
+  t?: CardTranslate
+  scope: StewardCardScope
+}
+
+/** 一行设置项。 */
+function Row(props: { title: string; desc?: string; control: JSX.Element }): JSX.Element {
+  return createElement('div', { className: 'dss_setRow' }, [
+    createElement('div', { key: 'text', className: 'dss_setText' }, [
+      createElement('span', { key: 't', className: 'dss_setTitle' }, props.title),
+      props.desc !== undefined && createElement('span', { key: 'd', className: 'dss_setDesc' }, props.desc),
+    ]),
+    createElement('div', { key: 'ctl' }, props.control),
+  ])
+}
+
+/** 一个布尔开关（原生 checkbox 语义，样式由本插件 CSS 提供）。 */
+function Toggle(props: { checked: boolean; disabled?: boolean; onChange: (checked: boolean) => void }): JSX.Element {
+  return createElement('label', { className: `dss_toggle${props.checked ? ' dss_toggleOn' : ''}` }, [
+    createElement('input', {
+      key: 'i',
+      type: 'checkbox',
+      checked: props.checked,
+      disabled: props.disabled === true,
+      onChange: (event: { target: { checked: boolean } }) => { props.onChange(event.target.checked) },
+    }),
+    createElement('span', { key: 's', className: 'dss_toggleTrack' }, createElement('span', { className: 'dss_toggleKnob' })),
+  ])
+}
+
+/** 抽屉头：标题 + 说明 + chevron，整块可点。 */
+function Header(props: { t?: CardTranslate; open: boolean; onToggle: () => void }): JSX.Element {
+  return createElement('button', {
+    key: 'head',
+    type: 'button',
+    className: 'dss_setHead',
+    'aria-expanded': props.open,
+    onClick: props.onToggle,
+  }, [
+    createElement('span', { key: 'text', className: 'dss_setHeadText' }, [
+      createElement('span', { key: 't', className: 'dss_setCardTitle' }, translate(props.t, 'card.title')),
+      createElement('span', { key: 'd', className: 'dss_setCardDesc' }, translate(props.t, 'card.desc')),
+    ]),
+    createElement('svg', {
+      key: 'chev',
+      className: 'dss_setChev',
+      width: 16,
+      height: 16,
+      viewBox: '0 0 16 16',
+      'aria-hidden': true,
+    }, createElement('path', {
+      d: 'M4 6l4 4 4-4',
+      fill: 'none',
+      stroke: 'currentColor',
+      strokeWidth: 1.5,
+      strokeLinecap: 'round',
+      strokeLinejoin: 'round',
+    })),
+  ])
+}
+
+/** 插件设置卡主体（抽屉）。默认展开，family 设置节内直接呈现完整面板。 */
+export function StewardSettingsCard({ t, scope }: StewardCardProps): JSX.Element {
+  const snapshot = useSyncExternalStore(
+    (listener) => scope.subscribe(listener),
+    () => scope.getSnapshot(),
+  )
+  const [open, setOpen] = useState(true)
+  const value: Partial<StewardConfig> = snapshot.value ?? {}
+  const writable = snapshot.writable
+
+  const rows: JSX.Element[] = []
+  if (snapshot.status === 'unavailable') {
+    // 拿不到设置服务：抽屉仍要在（否则这个插件在分区里彻底消失），只是里面说明原因。
+    rows.push(createElement('div', { key: 'unavailable', className: 'dss_setDesc' }, translate(t, 'card.unavailable')))
+  } else {
+    rows.push(
+      createElement(Row, {
+        key: 'enabled',
+        title: translate(t, 'card.enabled'),
+        desc: translate(t, 'card.enabled.desc'),
+        control: createElement(Toggle, {
+          checked: value.enabled ?? DEFAULT_CONFIG.enabled,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('enabled', checked) },
+        }),
+      }),
+      createElement(Row, {
+        key: 'history',
+        title: translate(t, 'card.history'),
+        desc: translate(t, 'card.history.desc'),
+        control: createElement(Toggle, {
+          checked: value.historyFiles ?? DEFAULT_CONFIG.historyFiles,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('historyFiles', checked) },
+        }),
+      }),
+      createElement(Row, {
+        key: 'health',
+        title: translate(t, 'card.health'),
+        desc: translate(t, 'card.health.desc'),
+        control: createElement(Toggle, {
+          checked: value.healthCheck ?? DEFAULT_CONFIG.healthCheck,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('healthCheck', checked) },
+        }),
+      }),
+    )
+    if (!writable) rows.push(createElement('div', { key: 'ro', className: 'dss_setDesc' }, translate(t, 'card.readonly')))
+  }
+
+  return createElement('div', {
+    className: `dss_setCard${open ? ' dss_setCardOpen' : ''}`,
+  }, [
+    createElement(Header, { key: 'head', t, open, onToggle: () => { setOpen(current => !current) } }),
+    open && createElement('div', { key: 'body', className: 'dss_setBody' }, rows),
+  ])
+}