@logictan/dsh-config-manager 0.1.60

package/src/client/css-modules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CSS Modules 类型声明（dsh-ssh 同款：src/client/css-modules.d.ts）。
+ * p3 的 tsdown 构建需配置 CSS Modules 处理（dsh-ssh 用 lightningcss）。
+ */
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}

package/src/client/index.ts

@@ -0,0 +1,65 @@
+/**
+ * dsh-config-manager 浏览器半入口 —— 运行在 dsh web GUI 内。
+ * 宽读法改造：仅保留同步设置页与对应字典注册。
+ */
+import type { ClientContext } from './client-types.ts'
+// Type-only：拉入 ctx.locale 的 Context 合并（dsh-client-locale）。
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+// Type-only：拉入 settings.section 的 SlotMap 合并（dsh-client-ui-settings）。
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+// Type-only：拉入 SlotMap / LocaleNamespaceMap 合并表（dsh-client-ui-slots）。
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import { ConfigManagerApi } from './api.ts'
+import { ConfigManagerSection } from './ConfigManagerSection.tsx'
+import { en, zh, type ConfigManagerKey } from './locales.ts'
+import { makeUiT, type UiT } from '../ui/i18n.ts'
+import { SyncApi } from './sync/sync-api.ts'
+import { en as syncEn, zh as syncZh, type SyncKey } from './sync/sync-locales.ts'
+
+/** 本插件拥有的 locale namespace。 */
+const NS = 'config-manager'
+/** 远程同步设置区块的独立 locale namespace。 */
+const SYNC_NS = 'config-manager-sync'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** Config Manager 表面文案。 */
+    'config-manager': ConfigManagerKey
+    /** 远程同步设置区块文案。 */
+    'config-manager-sync': SyncKey
+  }
+}
+
+/** 必需服务（fiber inject 等待 —— slots/locale 必须先就绪）。 */
+export const inject = ['slots', 'locale']
+
+/** 类型面（导出纪律：除插件契约外无值导出）。 */
+export type { ConfigManagerSectionProps } from './ConfigManagerSection.tsx'
+export type { SyncSettingsViewProps } from './sync/SyncSettingsView.tsx'
+export type { ConfigManagerApiError, ServiceStatus } from './api.ts'
+export type { ConfigManagerKey } from './locales.ts'
+export type { SyncKey } from './sync/sync-locales.ts'
+
+/**
+ * 注册 Config Manager 设置页。
+ * @param ctx - client root context（slots + locale 服务）。
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'config-manager: dictionaries')
+  ctx.effect(() => ctx.locale.register(SYNC_NS, { zh: syncZh, en: syncEn }), 'config-manager: sync dictionaries')
+
+  const t = ctx.locale.bind(NS)
+  const uiT: UiT = makeUiT(ctx.locale.getLocale().active === 'en' ? 'en' : 'zh')
+  const api = new ConfigManagerApi(uiT)
+  const syncT = ctx.locale.bind(SYNC_NS)
+  const syncApi = new SyncApi(uiT)
+
+  ctx.slots.inject('settings.section', () => ctx.slots.register({
+    name: 'settings.section',
+    id: 'config-manager',
+    order: 60,
+    label: () => t('section.label'),
+    locale: NS,
+    inject: () => ({ api, syncApi, syncT }),
+  }, ConfigManagerSection))
+}

package/src/client/locales.ts

@@ -0,0 +1,56 @@
+/**
+ * Config Manager 表面文案：zh 为源语言，en 镜像每个键。
+ * 字典 namespace 由 client/index.ts 注册（declare module 合并进 LocaleNamespaceMap）。
+ * 键集合通过 `ConfigManagerKey` 类型在注册处做编译期校验（缺键/多键即编译错误）。
+ * 宽读法精简版：仅保留同步页与基础 Shell/Toast 文案。
+ */
+
+export const zh = {
+  // 入口
+  'section.label': '配置同步',
+  'section.description': '远程同步 DSH 配置',
+  // 视图与导航
+  'view.sync': '远程同步',
+  'nav.sync': '远程同步',
+  // 公共
+  'common.close': '关闭',
+  'common.cancel': '取消',
+  'common.confirm': '确认',
+  'common.retry': '重试',
+  'common.loading': '加载中…',
+  'common.unknownError': '未知错误',
+  // 全局通知（右下角 Toast）
+  'toast.copied': '已复制到剪贴板',
+  'toast.copyFailed': '复制失败，请手动选择文本复制',
+  'toast.refreshed': '已刷新',
+  // 状态栏
+  'shell.status.running': '正在同步（{count} 个任务进行中）',
+  'shell.status.idle': '就绪',
+  'shell.version': 'v{plugin} · DSH {dsh}',
+}
+
+export type ConfigManagerKey = keyof typeof zh
+
+export const en: Record<ConfigManagerKey, string> = {
+  // Entry
+  'section.label': 'Config Sync',
+  'section.description': 'Sync DSH configurations remotely',
+  // Views & Navigation
+  'view.sync': 'Remote Sync',
+  'nav.sync': 'Remote Sync',
+  // Common
+  'common.close': 'Close',
+  'common.cancel': 'Cancel',
+  'common.confirm': 'Confirm',
+  'common.retry': 'Retry',
+  'common.loading': 'Loading…',
+  'common.unknownError': 'Unknown error',
+  // Toasts
+  'toast.copied': 'Copied to clipboard',
+  'toast.copyFailed': 'Failed to copy, please select text manually',
+  'toast.refreshed': 'Refreshed',
+  // Status bar
+  'shell.status.running': 'Syncing ({count} active task(s))',
+  'shell.status.idle': 'Ready',
+  'shell.version': 'v{plugin} · DSH {dsh}',
+}

package/src/client/lucide-icons.d.ts

@@ -0,0 +1,38 @@
+/**
+ * lucide-react 单图标深路径导入的类型声明（逐图标 tree-shake，详见 Icon.tsx）。
+ *
+ * 这些 .mjs 深路径无随附类型；NodeNext 下物理文件存在时 TS 不回退通配 ambient，故为每个
+ * 用到的图标做精确路径声明。
+ *
+ * 关键：本文件刻意不含任何顶层 import/export —— 一旦有，文件即变为「模块」，内部的
+ * `declare module` 退化为「增量合并(augmentation)」，要求被声明模块已有基础声明；而这些
+ * 子路径模块并无基础声明，augmentation 会静默失效（实测恰好部分图标因此报 TS7016）。
+ * 保持全局脚本态后，`declare module` 才是真正的全局 ambient 声明，对所有图标一致生效。
+ * 图标类型用 lucide 的 ForwardRefExoticComponent 形状内联描述，避免顶层 import。
+ */
+
+type LucideIconComponent = import('lucide-react').LucideIcon
+
+declare module 'lucide-react/dist/esm/icons/arrow-right.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/check-circle.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/chevron-down.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/chevron-right.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/clock.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/copy.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/database-backup.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/download.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/eye.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/folder-input.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/hard-drive-download.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/info.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/message-square.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/package-check.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/pencil.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/refresh-cw.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/rotate-cw.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/search.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/trash-2.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/triangle-alert.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/upload.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/x.mjs' { const i: LucideIconComponent; export default i }
+declare module 'lucide-react/dist/esm/icons/circle-alert.mjs' { const i: LucideIconComponent; export default i }

package/src/client/run-store.test.ts

@@ -0,0 +1,223 @@
+/**
+ * run-store 单测：模块级单例 store + sessionStorage 恢复（同步面板专属）。
+ *
+ * 覆盖：
+ *  - 敏感字段（token/webdavPassword/encryptPassword 等）绝不写入 sessionStorage（白名单剔除）；
+ *  - 内存瞬态（busy/savingConfig）不写入 sessionStorage，刷新后复位；
+ *  - 非敏感状态序列化/反序列化往返（新实例 + 同存储 = 模拟刷新）；
+ *  - 损坏/版本不符数据回退默认并清除脏键；
+ *  - 旧版顶层 syncMode 载荷向后兼容迁移；
+ *  - subscribe/notify 语义与 this 绑定回归（useSyncExternalStore 方式）。
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import { RunStore, STATE_KEY, type StoreStorage } from './run-store.ts'
+
+/* ------------------------------------------------------------- fixtures */
+
+function makeStorage(): { storage: StoreStorage; raw: () => string | null } {
+  let value: string | null = null
+  return {
+    storage: {
+      getItem: (key: string) => (key === STATE_KEY ? value : null),
+      setItem: (key: string, v: string) => {
+        if (key === STATE_KEY) value = v
+      },
+      removeItem: (key: string) => {
+        if (key === STATE_KEY) value = null
+      },
+    },
+    raw: () => value,
+  }
+}
+
+/* ---------------------------------------------------------- 序列化白名单 */
+
+test('run-store: token 与 webdav 密码绝不写入 sessionStorage', () => {
+  const { storage, raw } = makeStorage()
+  const store = new RunStore({ storage })
+  store.patch({
+    sync: {
+      channel: 'git',
+      repoUrl: 'https://github.com/user/private-sync.git',
+      token: 'ghp_SECRET_TOKEN_VALUE',
+      webdavUrl: 'https://dav.example.com',
+      webdavUsername: 'davuser',
+      webdavPassword: 'WEBDAV_SECRET_PASSWORD',
+    },
+  })
+
+  const text = raw()
+  assert.ok(text !== null, 'patch 后已同步持久化')
+  assert.ok(!text.includes('ghp_SECRET_TOKEN_VALUE'), 'token 绝不得落盘')
+  assert.ok(!text.includes('WEBDAV_SECRET_PASSWORD'), 'webdav 密码绝不得落盘')
+
+  const parsed = JSON.parse(text) as Record<string, unknown>
+  const syncObj = parsed['sync'] as Record<string, unknown>
+  assert.ok(!('token' in syncObj), 'token 字段已从持久化剔除')
+  assert.ok(!('webdavPassword' in syncObj), 'webdavPassword 字段已从持久化剔除')
+
+  // 新实例加载时敏感凭据重置为空串
+  const reloaded = new RunStore({ storage })
+  assert.equal(reloaded.getSnapshot().sync.token, '')
+  assert.equal(reloaded.getSnapshot().sync.webdavPassword, '')
+})
+
+test('run-store: byChannel 加密解密密码绝不写入 sessionStorage', () => {
+  const { storage, raw } = makeStorage()
+  const store = new RunStore({ storage })
+  store.patch({
+    sync: {
+      byChannel: {
+        git: {
+          syncSections: ['settings'],
+          syncMode: 'advanced',
+          selectedSnapshotId: '',
+          autosync: null,
+          autosyncEnabled: false,
+          autosyncInterval: '60m',
+          snapshots: [],
+        },
+        webdav: {
+          syncSections: ['settings', 'skills'],
+          syncMode: 'default',
+          selectedSnapshotId: '',
+          autosync: null,
+          autosyncEnabled: true,
+          autosyncInterval: '30m',
+          snapshots: [],
+        },
+      },
+    },
+  })
+
+  const text = raw()
+  assert.ok(text !== null)
+
+  // 刷新后分区选择正确保留（凭据本身走 DSH credentials，不进 UI 状态）
+  const reloaded = new RunStore({ storage })
+  const snap = reloaded.getSnapshot().sync
+  assert.equal('encryptPassword' in snap.byChannel.git, false, 'ChannelSyncState 不再有加密密码字段')
+  // 非敏感选项正确保留
+  assert.equal(snap.byChannel.git.syncMode, 'advanced')
+  assert.deepEqual(snap.byChannel.git.syncSections, ['settings'])
+  assert.equal(snap.byChannel.webdav.autosyncEnabled, true)
+})
+
+test('run-store: busy 与 savingConfig 为内存瞬态——不写入 sessionStorage、刷新后复位', () => {
+  const { storage, raw } = makeStorage()
+  const first = new RunStore({ storage })
+  first.patch({ sync: { busy: 'push', savingConfig: true } })
+
+  const text = raw()
+  assert.ok(text !== null)
+  const parsed = JSON.parse(text) as Record<string, unknown>
+  const sync = parsed['sync'] as Record<string, unknown>
+  assert.ok(!('busy' in sync), 'busy 为瞬态，不得落盘')
+  assert.ok(!('savingConfig' in sync), 'savingConfig 为瞬态，不得落盘')
+
+  // 新实例（模拟刷新）：复位为 null 与 false
+  const second = new RunStore({ storage })
+  assert.equal(second.getSnapshot().sync.busy, null, '刷新后 busy 复位为 null')
+  assert.equal(second.getSnapshot().sync.savingConfig, false, '刷新后 savingConfig 复位为 false')
+})
+
+test('run-store: 非敏感同步表单状态往返恢复', () => {
+  const { storage } = makeStorage()
+  const first = new RunStore({ storage })
+  first.patch({
+    sync: {
+      channel: 'webdav',
+      webdavUrl: 'https://nextcloud.example.com/remote.php/dav/files/alice',
+      webdavUsername: 'alice',
+      repoUrl: 'git@github.com:alice/dsh-sync.git',
+      lastRestoreId: 'restore-20260919',
+      pushPreview: { preview: null, open: true },
+      error: '网络波动错误（已脱敏）',
+      loadError: '远端连接失败',
+    },
+  })
+
+  const second = new RunStore({ storage })
+  const s = second.getSnapshot().sync
+  assert.equal(s.channel, 'webdav')
+  assert.equal(s.webdavUrl, 'https://nextcloud.example.com/remote.php/dav/files/alice')
+  assert.equal(s.webdavUsername, 'alice')
+  assert.equal(s.repoUrl, 'git@github.com:alice/dsh-sync.git')
+  assert.equal(s.lastRestoreId, 'restore-20260919')
+  assert.equal(s.pushPreview.open, true)
+  assert.equal(s.error, '网络波动错误（已脱敏）')
+  assert.equal(s.loadError, '远端连接失败')
+})
+
+test('run-store: 损坏或版本不符的存储数据回退默认并清除脏键', () => {
+  const { storage, raw } = makeStorage()
+  storage.setItem(STATE_KEY, 'not valid json')
+
+  const store = new RunStore({ storage })
+  assert.equal(store.getSnapshot().panel, 'sync')
+  assert.equal(store.getSnapshot().sync.channel, 'git')
+  assert.equal(raw(), null, '损坏键已被清除')
+
+  // 版本不符
+  storage.setItem(STATE_KEY, JSON.stringify({ v: 999, panel: 'sync' }))
+  const store2 = new RunStore({ storage })
+  assert.equal(store2.getSnapshot().panel, 'sync')
+  assert.equal(raw(), null, '旧版本键已被清除')
+})
+
+test('run-store: subscribe/notify: patch 触发监听器，退订后不再通知', () => {
+  const { storage } = makeStorage()
+  const store = new RunStore({ storage })
+  let calls = 0
+  const unsubscribe = store.subscribe(() => { calls++ })
+
+  store.patch({ sync: { channel: 'webdav' } })
+  assert.equal(calls, 1)
+
+  store.patch({ sync: { repoUrl: 'https://example.com/repo.git' } })
+  assert.equal(calls, 2)
+
+  unsubscribe()
+  store.patch({ sync: { channel: 'git' } })
+  assert.equal(calls, 2, '退订后不应再触发')
+})
+
+test('run-store: subscribe/getSnapshot 以裸引用调用时 this 绑定实例（useSyncExternalStore 方式）', () => {
+  const { storage } = makeStorage()
+  const store = new RunStore({ storage })
+  const { subscribe, getSnapshot } = store
+
+  assert.doesNotThrow(() => {
+    const snap = getSnapshot()
+    assert.equal(snap.panel, 'sync')
+  })
+
+  let count = 0
+  const unsub = subscribe(() => { count++ })
+  store.patch({ sync: { channel: 'webdav' } })
+  assert.equal(count, 1)
+  unsub()
+})
+
+test('run-store: 旧版顶层 syncMode 载荷 → 迁移为 git 通道的 byChannel 状态', () => {
+  const { storage } = makeStorage()
+  const legacyPayload = {
+    v: 1,
+    panel: 'sync',
+    sync: {
+      channel: 'git',
+      repoUrl: 'https://github.com/user/repo.git',
+      syncMode: 'advanced',
+      syncSections: ['settings', 'skills'],
+      byChannel: {},
+    },
+  }
+  storage.setItem(STATE_KEY, JSON.stringify(legacyPayload))
+
+  const store = new RunStore({ storage })
+  const s = store.getSnapshot().sync
+  assert.equal(s.byChannel.git.syncMode, 'advanced')
+  assert.deepEqual(s.byChannel.git.syncSections, ['settings', 'skills'])
+})