dsh-config-manager 0.1.39 → 0.1.41

package/src/client/market/disclaimer.test.ts

@@ -0,0 +1,57 @@
+/**
+ * m-disclaimer 免责状态单测：key 隔离、读写往返、存储异常降级。
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  disclaimerStorageKey, readDisclaimerDismissed, writeDisclaimerDismissed,
+  DISCLAIMER_STORAGE_PREFIX,
+} from './disclaimer.ts'
+
+/** 内存 Storage mock（最小实现 Pick<Storage,'getItem'|'setItem'>） */
+function mockStorage(): Pick<Storage, 'getItem' | 'setItem'> & { data: Map<string, string> } {
+  const data = new Map<string, string>()
+  return {
+    data,
+    getItem(key: string): string | null { return data.get(key) ?? null },
+    setItem(key: string, value: string): void { data.set(key, value) },
+  }
+}
+
+test('disclaimer: key 生成带前缀且三操作互不相同', () => {
+  assert.equal(disclaimerStorageKey('upload'), `${DISCLAIMER_STORAGE_PREFIX}upload`)
+  assert.equal(disclaimerStorageKey('download'), `${DISCLAIMER_STORAGE_PREFIX}download`)
+  assert.equal(disclaimerStorageKey('install'), `${DISCLAIMER_STORAGE_PREFIX}install`)
+  const keys = new Set((['upload', 'download', 'install'] as const).map(disclaimerStorageKey))
+  assert.equal(keys.size, 3, '三操作 key 必须互不相同（分开记）')
+})
+
+test('disclaimer: 未写入时默认 false（要弹免责）', () => {
+  const storage = mockStorage()
+  assert.equal(readDisclaimerDismissed('upload', storage), false)
+  assert.equal(readDisclaimerDismissed('download', storage), false)
+})
+
+test('disclaimer: 写入后读回 true，且只影响对应操作（分开记）', () => {
+  const storage = mockStorage()
+  writeDisclaimerDismissed('upload', storage)
+  assert.equal(readDisclaimerDismissed('upload', storage), true, 'upload 已勾选 → 不再提示')
+  assert.equal(readDisclaimerDismissed('download', storage), false, 'download 未勾选 → 仍提示')
+  assert.equal(readDisclaimerDismissed('install', storage), false, 'install 未勾选 → 仍提示')
+})
+
+test('disclaimer: 存储抛异常（隐私模式）时读写静默降级不抛错', () => {
+  const broken: Pick<Storage, 'getItem' | 'setItem'> = {
+    getItem() { throw new Error('SecurityError') },
+    setItem() { throw new Error('SecurityError') },
+  }
+  assert.equal(readDisclaimerDismissed('upload', broken), false, 'getItem 异常 → false（仍提示）')
+  assert.doesNotThrow(() => writeDisclaimerDismissed('upload', broken), 'setItem 异常 → 静默忽略')
+})
+
+test('disclaimer: 值非 "1"（脏数据/旧格式）视为未勾选', () => {
+  const storage = mockStorage()
+  storage.setItem(disclaimerStorageKey('download'), 'yes')
+  assert.equal(readDisclaimerDismissed('download', storage), false)
+})

package/src/client/market/disclaimer.ts

@@ -0,0 +1,43 @@
+/**
+ * 市场免责弹窗的「不再提示」状态（m-disclaimer，node 可测）。
+ *
+ * 背景（2026-08-21）：用户要求上传 / 下载 / 装回本地时弹出免责弹窗，
+ * 并支持「不再提示」勾选 —— 勾选后该操作以后不再弹。
+ *
+ * 设计：
+ *  - 三个操作**分开记**（upload / download / install 各一个 key，互不影响）；
+ *  - 持久化用浏览器 localStorage（跨会话偏好，关掉浏览器再开仍记得）；
+ *  - storage 由调用方注入（React 壳传 window.localStorage；测试注入 mock），
+ *    本层零浏览器依赖、纯函数可测；
+ *  - 读写都包 try/catch：存储不可用（隐私模式 / 禁用）时静默降级为
+ *    「未勾选」（下次仍提示），绝不让存储异常打断操作流程。
+ *
+ * 安全：本层只存布尔标记，不触碰任何凭据；key 无敏感信息。
+ */
+export type DisclaimerKey = 'upload' | 'download' | 'install'
+
+/** localStorage key 前缀（按 key 隔离三个操作） */
+export const DISCLAIMER_STORAGE_PREFIX = 'dsh-cm-market.disclaimer.'
+
+/** 由操作 key 生成 localStorage key。 */
+export function disclaimerStorageKey(key: DisclaimerKey): string {
+  return `${DISCLAIMER_STORAGE_PREFIX}${key}`
+}
+
+/** 读取「不再提示」状态（true = 已勾选，该操作以后不再弹免责；任何异常 → false）。 */
+export function readDisclaimerDismissed(key: DisclaimerKey, storage: Pick<Storage, 'getItem'>): boolean {
+  try {
+    return storage.getItem(disclaimerStorageKey(key)) === '1'
+  } catch {
+    return false
+  }
+}
+
+/** 写入「不再提示」状态（勾选后调用；存储不可用时静默忽略）。 */
+export function writeDisclaimerDismissed(key: DisclaimerKey, storage: Pick<Storage, 'setItem'>): void {
+  try {
+    storage.setItem(disclaimerStorageKey(key), '1')
+  } catch {
+    // 存储不可用 → 忽略：下次仍会提示（安全侧保守）
+  }
+}

package/src/client/market/market-api.test.ts

@@ -36,6 +36,8 @@ test('M-01 api.status()：GET 到 /market/status，解析已添加市场列表
     ok: true,
     configured: true,
     markets: [{ url: 'https://github.com/u/m', addedAt: '2026-08-16T00:00:00.000Z', itemCount: 3 }],
+    // 启动后首次打开市场页自动更新的判据（Host 进程内存标记；dsh 重启后重置）
+    bootAutoRefreshed: false,
   };
   let called: FetchCall | null = null;
   installFetchMock((call) => {
@@ -50,6 +52,7 @@ test('M-01 api.status()：GET 到 /market/status，解析已添加市场列表
   assert.equal(result.configured, true);
   assert.equal(result.markets.length, 1);
   assert.equal(result.markets[0]?.url, 'https://github.com/u/m');
+  assert.equal(result.bootAutoRefreshed, false, 'status 契约透传 bootAutoRefreshed（首次打开自动更新判据）');
   assert.equal('token' in result, false, 'status 契约不得携带 token');
   assert.equal(lastCall()?.url, MARKET_API.status);
   assert.equal(lastCall()?.init?.method, undefined, 'GET 不设 method');

package/src/client/market/market-locales.ts

@@ -14,16 +14,10 @@ export const zh = {
   // 入口
   'section.label': '配置市场',
   'section.description': '浏览并下载社区共享的配置（公开 Git 仓库；下载内容一律视为不可信，导入前必经校验与确认）',
-  // 市场仓库表单
+  // 市场仓库操作（2026-08-21 精简：面板只保留「拉取最新 / 浏览」，不再展示 URL/名称/条目数/状态行）
   'config.title': '市场仓库',
-  'config.builtinHint': '内置官方市场，只读、不可编辑（由创建者维护的公开 Git 仓库）。',
-  'config.official': '内置官方市场',
-  'config.custom': '自定义市场地址',
-  'config.repoUrlHint': '内置公开 Git 仓库地址。市场只读拉取（绝不推送）。',
   'config.refresh': '拉取最新',
   'config.refreshing': '拉取中…',
-  'config.addedAt': '更新于：{time}',
-  'config.itemCount': '{count} 个条目',
   // 列表
   'list.empty': '内置市场尚未加载。请先「拉取最新」。',
   'list.browse': '浏览',
@@ -96,6 +90,8 @@ export const zh = {
   'myconfigs.update.hint': '版本将自动 +1，已预填原条目信息（名称可改）。',
   'myconfigs.update.run': '一键更新',
   'myconfigs.update.running': '更新中…',
+  'myconfigs.update.zipHint': '更新需要新的配置包：选择新 zip 后自动校验，通过后即可一键更新。',
+  'myconfigs.update.selectZip': '选择新 ZIP…',
   // 上传/更新结果卡
   'myconfigs.result.title': '上传/更新完成',
   'myconfigs.result.version': '版本 {version}',
@@ -105,6 +101,9 @@ export const zh = {
   'myconfigs.result.openRepo': '打开仓库',
   'myconfigs.result.pr': '收录 PR #{number}',
   'myconfigs.result.openPr': '查看 PR',
+  'myconfigs.result.listingPending': '已上传 ✓ 正在后台提交收录（fork + 收录 PR），稍后列表状态自动更新',
+  'myconfigs.result.listingFailed': '收录失败',
+  'myconfigs.result.relist': '重新提交收录',
   // 已上传列表
   'myconfigs.list.title': '已上传',
   'myconfigs.list.empty': '尚未上传任何配置',
@@ -115,6 +114,20 @@ export const zh = {
   'myconfigs.item.update': '更新',
   'myconfigs.item.install': '装回本地',
   'myconfigs.item.openPr': '查看收录 PR',
+  // 删除条目（弹窗二次确认 + 下架处理）
+  'myconfigs.delete.run': '删除',
+  'myconfigs.delete.confirm': '确认删除',
+  'myconfigs.delete.confirmTitle': '删除条目',
+  'myconfigs.delete.confirmText': '确认删除？该操作会从配置仓库永久删除该条目的索引与文件（不可恢复）',
+  'myconfigs.delete.delistStarted': '已删除本地条目，并自动提交「下架 PR」（官方市场移除需人工合并，期间市场可能仍显示该条目）',
+  'myconfigs.delete.prClosed': '已删除本地条目，并关闭该条目的待审核收录 PR',
+  // 免责弹窗（2026-08-21：上传/下载/装回本地前置免责声明；支持「不再提示」勾选，三操作分开记）
+  'disclaimer.title': '免责声明',
+  'disclaimer.upload.text': '你即将把配置上传到你的公开仓库（<login>/dsh-configs）并提交官方市场收录申请。\n\n上传后内容将对所有人公开可见，且需经过人工审核才能进入官方市场。请确保：\n· 内容不包含任何真实密钥 / 凭据（环境变量引用如 $VAR 是安全的）；\n· 内容不包含个人隐私或本地环境信息；\n· 你有权分享这些配置。',
+  'disclaimer.download.text': '你即将从公共网络市场下载配置并导入本地。\n\n下载内容属于不可信输入：未经官方审核、可能包含风险（安装插件 / 写入文件 / 修改设置）。\n· 导入前会逐项展示并校验，高风险分区默认不导入、需逐项批准；\n· 导入会先自动创建快照，失败可回滚；\n· 请核对来源与内容后再确认导入。',
+  'disclaimer.install.text': '你即将把配置从你的公开仓库装回本地。\n\n该内容属于你此前上传的配置，但同样会经过安全校验与逐分区批准：\n· 高风险分区默认不导入、需逐项批准；\n· 导入前自动创建快照，失败可回滚。',
+  'disclaimer.confirm': '我已了解，继续',
+  'disclaimer.dontAsk': '不再提示（该操作以后不再显示免责声明）',
   // 错误
   'myconfigs.error.loadStatus': '登录状态读取失败',
   'myconfigs.error.loadItems': '已上传列表读取失败',
@@ -130,14 +143,8 @@ export const en: Record<keyof typeof zh, string> = {
   'section.label': 'Config Marketplace',
   'section.description': 'Browse and download community-shared configs (public Git repos; downloaded content is always untrusted — validated and confirmed before import)',
   'config.title': 'Market Repository',
-  'config.builtinHint': 'Built-in official market — read-only and not editable (a public Git repo maintained by the creator).',
-  'config.official': 'Built-in official market',
-  'config.custom': 'Custom market URL',
-  'config.repoUrlHint': 'Built-in public Git repository URL. Markets are read-only (never pushed).',
   'config.refresh': 'Refresh',
   'config.refreshing': 'Refreshing…',
-  'config.addedAt': 'Updated: {time}',
-  'config.itemCount': '{count} item(s)',
   'list.empty': 'The built-in market has not loaded yet. Click "Refresh" first.',
   'list.browse': 'Browse',
   'list.loading': 'Reading market…',
@@ -204,6 +211,8 @@ export const en: Record<keyof typeof zh, string> = {
   'myconfigs.update.hint': 'The version will be bumped automatically (+1); item info is prefilled (name editable).',
   'myconfigs.update.run': 'Update',
   'myconfigs.update.running': 'Updating…',
+  'myconfigs.update.zipHint': 'Updating needs a new config zip: pick one and it will be validated automatically, then you can update.',
+  'myconfigs.update.selectZip': 'Choose new ZIP…',
   'myconfigs.result.title': 'Upload/update complete',
   'myconfigs.result.version': 'version {version}',
   'myconfigs.result.sha256': 'SHA-256: {hash}',
@@ -212,6 +221,9 @@ export const en: Record<keyof typeof zh, string> = {
   'myconfigs.result.openRepo': 'Open repo',
   'myconfigs.result.pr': 'Listing PR #{number}',
   'myconfigs.result.openPr': 'View PR',
+  'myconfigs.result.listingPending': 'Uploaded ✓ submitting listing in the background (fork + PR) — list status will update shortly',
+  'myconfigs.result.listingFailed': 'Listing failed',
+  'myconfigs.result.relist': 'Resubmit listing',
   'myconfigs.list.title': 'Uploaded',
   'myconfigs.list.empty': 'No configs uploaded yet',
   'myconfigs.list.loading': 'Loading…',
@@ -221,6 +233,18 @@ export const en: Record<keyof typeof zh, string> = {
   'myconfigs.item.update': 'Update',
   'myconfigs.item.install': 'Install locally',
   'myconfigs.item.openPr': 'View listing PR',
+  'myconfigs.delete.run': 'Delete',
+  'myconfigs.delete.confirm': 'Confirm delete',
+  'myconfigs.delete.confirmTitle': 'Delete item',
+  'myconfigs.delete.confirmText': 'Delete? This permanently removes the item index and files from your config repo (not recoverable)',
+  'myconfigs.delete.delistStarted': 'Local item deleted; a "delist PR" has been submitted (removal from the official market needs human merge; the item may still appear in the market meanwhile)',
+  'myconfigs.delete.prClosed': 'Local item deleted; its pending listing PR has been closed',
+  'disclaimer.title': 'Disclaimer',
+  'disclaimer.upload.text': 'You are about to upload configs to your public repo (<login>/dsh-configs) and submit a listing request to the official market.\n\nUploaded content becomes publicly visible and requires human review before entering the official market. Please ensure:\n· No real secrets / credentials are included (env-var references like $VAR are safe);\n· No personal privacy or local environment info is included;\n· You have the right to share these configs.',
+  'disclaimer.download.text': 'You are about to download configs from a public network market and import them locally.\n\nDownloaded content is untrusted input: not officially reviewed and may carry risks (installing plugins / writing files / changing settings).\n· Everything is validated and shown before import; high-risk sections are not imported by default and require individual approval;\n· A snapshot is auto-created before import and rollback is available on failure;\n· Please verify the source and content before confirming the import.',
+  'disclaimer.install.text': 'You are about to reinstall configs from your public repo to this machine.\n\nThis is content you uploaded before, but it still goes through the same validation and per-section approval:\n· High-risk sections are not imported by default and require individual approval;\n· A snapshot is auto-created before import and rollback is available on failure.',
+  'disclaimer.confirm': 'I understand, continue',
+  'disclaimer.dontAsk': "Don't ask again (no more disclaimers for this action)",
   'myconfigs.error.loadStatus': 'Failed to read sign-in status',
   'myconfigs.error.loadItems': 'Failed to read uploaded items',
   'common.cancel': 'Cancel',

package/src/client/market/my-configs-api.ts

@@ -22,13 +22,13 @@
  *  - 本文件不 import 任何 node 模块（纯浏览器 bundle）。
  */
 import type {
-  MyItemEntry, MyRepoForm, UploadResult,
+  DeleteResult, ListingStatusResponse, MyItemEntry, MyRepoForm, UploadResult,
 } from '../../market/my-repo.ts';
 import { ConfigManagerApiError } from '../api.ts';
 import { zhUiT, type UiT } from '../../ui/i18n.ts';
 
 // 便捷重导出：Host 半 my-repo.ts 领域类型（client 消费单一来源，避免漂移）
-export type { MyItemEntry, MyRepoForm, UploadResult };
+export type { DeleteResult, ListingStatusResponse, MyItemEntry, MyRepoForm, UploadResult };
 
 /* ---------------------------------------------------------------- 端点常量 */
 
@@ -39,6 +39,9 @@ export const MY_CONFIGS_API = {
   upload: '/api/dsh-config-manager/me/upload',
   items: '/api/dsh-config-manager/me/items',
   update: '/api/dsh-config-manager/me/update',
+  listing: '/api/dsh-config-manager/me/listing',
+  relist: '/api/dsh-config-manager/me/relist',
+  delete: '/api/dsh-config-manager/me/delete',
 } as const;
 
 /** 「我的配置」请求超时（ms）：上传/更新含 git clone/push/fork/PR，与 market/sync 对齐量级 */
@@ -160,4 +163,19 @@ export class MyConfigsApi {
   async meUpdate(payload: { zipPath: string; form: MyConfigsFormPayload }): Promise<MyUploadResult> {
     return postJson<MyUploadResult>(MY_CONFIGS_API.update, payload, this.t);
   }
+
+  /** 查询收录/下架任务状态（结果卡轮询；任务表未命中时 Host 回退 GitHub 实况推导；无任务无实况 → null） */
+  async meListing(itemId: string): Promise<ListingStatusResponse | null> {
+    return postJson<ListingStatusResponse | null>(MY_CONFIGS_API.listing, { itemId }, this.t);
+  }
+
+  /** 重新提交收录（失败/重启丢失后重试；幂等复用已存在 fork/open PR） */
+  async meRelist(itemId: string): Promise<ListingStatusResponse> {
+    return postJson<ListingStatusResponse>(MY_CONFIGS_API.relist, { itemId }, this.t);
+  }
+
+  /** 删除条目（同步删本地索引+文件；已收录自动后台提下架 PR；待审核自动关闭收录 PR） */
+  async meDelete(itemId: string): Promise<DeleteResult> {
+    return postJson<DeleteResult>(MY_CONFIGS_API.delete, { itemId }, this.t);
+  }
 }

package/src/client/market/my-configs-view.test.ts

@@ -14,9 +14,9 @@ import {
   autoFieldBadges, buildMyItemsView, deriveItemStatus, deriveLoginState, itemStatusBadge,
   itemStatusFromHost, MARKET_SYNC_PR_BRANCH_PREFIX, MY_CONFIG_AUTO_FIELDS, myConfigFormValid,
   parseCategories, prBranchFor, summarizeMyItems, toMyItemView, validateMyConfigForm,
-  EMPTY_MY_CONFIG_FORM,
+  EMPTY_MY_CONFIG_FORM, EMPTY_MY_WIZARD, initialWizard, restoreMyWizard, toMyWizardSlice,
 } from './my-configs-view.ts'
-import type { ItemStatus, MeStatusData, MyItemSource, OpenPrInfo } from './my-configs-view.ts'
+import type { ItemStatus, MeStatusData, MyItemSource, MyUploadResult, MyWizardSlice, MyWizardState, OpenPrInfo } from './my-configs-view.ts'
 
 /* ---------------------------------------------------------------- 登录状态推导 */
 
@@ -286,4 +286,139 @@ test('my-configs-view: ItemStatus 判别联合可判别（编译期形状约束
   assert.equal(statusKindOf({ kind: 'listed' }), 'listed')
   assert.equal(statusKindOf({ kind: 'pending-pr', prNumber: 1, prUrl: 'u' }), 'pending-pr')
   assert.equal(statusKindOf({ kind: 'not-listed' }), 'not-listed')
+})
+
+/* ---------------------------------------------------------------- 向导状态模型 */
+
+/** UploadResult 夹具（对齐 host 半 my-repo.ts 形状；listing 必填）。 */
+function uploadResult(overrides: Partial<MyUploadResult> = {}): MyUploadResult {
+  return {
+    ok: true,
+    itemId: 'my-config',
+    version: '1.0.0',
+    sha256: 'sha256-abc',
+    sections: ['settings'],
+    repoUrl: 'https://github.com/xiaojun/dsh-configs',
+    prNumber: null,
+    prUrl: null,
+    warnings: ['供应链警示'],
+    listing: 'pending',
+    ...overrides,
+  }
+}
+
+function wizard(overrides: Partial<MyWizardState> = {}): MyWizardState {
+  return {
+    mode: 'upload',
+    step: 'select',
+    zipPath: null,
+    fileName: null,
+    validating: false,
+    validated: false,
+    validationError: null,
+    form: { ...EMPTY_MY_CONFIG_FORM },
+    formErrors: { name: null },
+    running: false,
+    result: null,
+    error: null,
+    ...overrides,
+  }
+}
+
+test('my-configs-view: toMyWizardSlice 去掉瞬态字段（validating/running/formErrors 不出现）、保留 validated', () => {
+  const w = wizard({
+    mode: 'update',
+    step: 'form',
+    zipPath: 'C:\\tmp\\upload-abc.zip',
+    fileName: 'cfg.zip',
+    validating: true,
+    validated: true,
+    validationError: null,
+    form: { name: 'My Config', description: 'desc', categories: 'a, b', id: 'my-config' },
+    formErrors: { name: null },
+    running: true,
+    result: uploadResult(),
+    error: null,
+  })
+  const s = toMyWizardSlice(w)
+  assert.equal(s.mode, 'update')
+  assert.equal(s.step, 'form')
+  assert.equal(s.zipPath, 'C:\\tmp\\upload-abc.zip')
+  assert.equal(s.fileName, 'cfg.zip')
+  assert.equal(s.validated, true, 'validated 保留（已校验通过状态值得持久化）')
+  assert.equal(s.validationError, null)
+  assert.deepEqual(s.form, { name: 'My Config', description: 'desc', categories: 'a, b', id: 'my-config' })
+  assert.equal(s.result, w.result, 'result 为纯 JSON 直接引用')
+  assert.equal(s.error, null)
+  // 瞬态/派生字段不进入切片
+  assert.ok(!('validating' in s), 'validating 不得进入切片')
+  assert.ok(!('running' in s), 'running 不得进入切片')
+  assert.ok(!('formErrors' in s), 'formErrors 不得进入切片（恢复时重算）')
+})
+
+test('my-configs-view: restoreMyWizard(null) → EMPTY 语义（step select、瞬态归零、formErrors 无错）', () => {
+  const w = restoreMyWizard(null)
+  assert.equal(w.mode, 'upload')
+  assert.equal(w.step, 'select')
+  assert.equal(w.zipPath, null)
+  assert.equal(w.fileName, null)
+  assert.equal(w.validating, false)
+  assert.equal(w.validated, false)
+  assert.equal(w.validationError, null)
+  assert.deepEqual(w.form, EMPTY_MY_CONFIG_FORM)
+  assert.deepEqual(w.formErrors, { name: null })
+  assert.equal(w.running, false)
+  assert.equal(w.result, null)
+  assert.equal(w.error, null)
+  // 返回新对象，不共享 EMPTY_MY_WIZARD / EMPTY_MY_CONFIG_FORM 引用
+  assert.notEqual(w, EMPTY_MY_WIZARD)
+  assert.notEqual(w.form, EMPTY_MY_CONFIG_FORM)
+})
+
+test('my-configs-view: restoreMyWizard(slice) → 瞬态归零、formErrors 按 form.name 重算、其余字段一致', () => {
+  const slice: MyWizardSlice = {
+    mode: 'update',
+    step: 'form',
+    zipPath: 'C:\\tmp\\upload-abc.zip',
+    fileName: 'cfg.zip',
+    validated: true,
+    validationError: null,
+    form: { name: 'My Config', description: '', categories: '', id: 'my-config' },
+    result: uploadResult(),
+    error: null,
+  }
+  const w = restoreMyWizard(slice)
+  assert.equal(w.mode, 'update')
+  assert.equal(w.step, 'form')
+  assert.equal(w.zipPath, slice.zipPath)
+  assert.equal(w.fileName, 'cfg.zip')
+  assert.equal(w.validating, false, 'validating 恢复后恒 false')
+  assert.equal(w.running, false, 'running 恢复后恒 false')
+  assert.equal(w.validated, true, 'validated 从切片保留')
+  assert.deepEqual(w.form, slice.form)
+  assert.deepEqual(w.formErrors, { name: null }, 'form.name 合法 → 无错误')
+  assert.equal(w.result, slice.result)
+  assert.equal(w.error, null)
+  assert.notEqual(w.form, slice.form, 'form 为新对象，不共享切片引用')
+  // form.name 为空 → formErrors.name 重算为非 null
+  const w2 = restoreMyWizard({ ...slice, form: { ...slice.form, name: '   ' } })
+  assert.notEqual(w2.formErrors.name, null, '空白名称 → 重算出错误')
+  assert.equal(w2.formErrors.name, validateMyConfigForm({ ...slice.form, name: '   ' }).name)
+})
+
+test('my-configs-view: initialWizard(mode) → 指定模式、step select、空表单', () => {
+  const w = initialWizard('update')
+  assert.equal(w.mode, 'update')
+  assert.equal(w.step, 'select')
+  assert.deepEqual(w.form, EMPTY_MY_CONFIG_FORM)
+  assert.deepEqual(w.formErrors, { name: null })
+  assert.equal(w.zipPath, null)
+  assert.equal(w.result, null)
+  assert.equal(w.validating, false)
+  assert.equal(w.running, false)
+  assert.notEqual(w, EMPTY_MY_WIZARD, '每次返回新对象')
+  assert.notEqual(w.form, EMPTY_MY_CONFIG_FORM, 'form 为新对象')
+  const u = initialWizard('upload')
+  assert.equal(u.mode, 'upload')
+  assert.equal(u.step, 'select')
 })

package/src/client/market/my-configs-view.ts

@@ -17,6 +17,10 @@
  * 渲染前仍过 redact() 兜底（与全站一致）。
  */
 import { zhUiT, type UiT } from '../../ui/i18n.ts'
+import type { UploadResult } from '../../market/my-repo.ts'
+import type { MarketDownloadResult } from '../../market/types.ts'
+import type { ImportResult } from '../../core/types.ts'
+import type { MarketApprovals } from './market-view.ts'
 
 /* ---------------------------------------------------------------- 登录状态展示模型 */
 
@@ -69,19 +73,23 @@ export function deriveLoginState(input: {
 /* ---------------------------------------------------------------- 上传表单模型 */
 
 /**
- * 一键上传表单（§2.4 用户输入最小化）：仅名称（必填，预填 zip 文件名可改）/
+ * 一键上传/更新表单（§2.4 用户输入最小化）：仅名称（必填，预填 zip 文件名可改）/
  * 描述（可选）/ 类别（可选，逗号分隔原始文本）。id/author/version/updatedAt
  * 均由系统自动生成，不在表单里。
+ * `id` 为**更新模式内部字段**（「更新」按钮预填条目 id，避免后端靠 name→slug 猜错），
+ * 不渲染为输入框；上传模式恒为空串。
  */
 export interface MyConfigForm {
   name: string
   description: string
   /** 类别原始文本（逗号分隔；UI 解析为数组，空串 = 无类别） */
   categories: string
+  /** 更新目标条目 id（update 模式预填；upload 模式空串） */
+  id: string
 }
 
 /** 空表单初值（React 壳 useState 初始 + 测试用）。 */
-export const EMPTY_MY_CONFIG_FORM: MyConfigForm = { name: '', description: '', categories: '' }
+export const EMPTY_MY_CONFIG_FORM: MyConfigForm = { name: '', description: '', categories: '', id: '' }
 
 /** 表单字段错误（null = 该字段合法；文案已翻译）。 */
 export interface MyConfigFormErrors {
@@ -103,6 +111,170 @@ export function parseCategories(csv: string): string[] {
   return csv.split(',').map((c) => c.trim()).filter((c) => c !== '')
 }
 
+/* ---------------------------------------------------------------- 上传/更新向导状态模型 */
+
+/**
+ * 上传结果（对齐 host 半 my-repo.ts 的 UploadResult 类型，避免客户端各层重复声明）。
+ * 纯 JSON 无 token：error/listingError 在宿主侧已脱敏；可安全持久化。
+ */
+export type MyUploadResult = UploadResult
+
+/**
+ * 上传/更新向导的运行时全量状态（迁移自 MyConfigsView 组件内私有 WizardState）。
+ * validating/validated/running/formErrors 为瞬态/派生字段：不进入持久化切片
+ * （MyWizardSlice）；validated 虽为瞬态，但「是否已校验通过」值得随切片保留，
+ * 恢复后由组件结合 zipPath 决定是否自动重校验（详见 restoreMyWizard 注释）。
+ */
+export interface MyWizardState {
+  mode: 'upload' | 'update'
+  step: 'select' | 'validate' | 'form'
+  zipPath: string | null
+  fileName: string | null
+  /** 瞬态：校验进行中（不持久化，恢复后恒 false） */
+  validating: boolean
+  /** 瞬态：最近一次校验是否通过（切片保留，恢复后由组件决定是否重校验） */
+  validated: boolean
+  validationError: string | null
+  form: MyConfigForm
+  /** 派生：由 validateMyConfigForm(form) 重算（不持久化） */
+  formErrors: MyConfigFormErrors
+  /** 瞬态：上传/更新请求进行中（不持久化，恢复后恒 false） */
+  running: boolean
+  result: MyUploadResult | null
+  error: string | null
+}
+
+/** 向导初始状态常量（initialWizard('upload') 语义；调用方应经 initialWizard 获取新对象）。 */
+export const EMPTY_MY_WIZARD: MyWizardState = {
+  mode: 'upload',
+  step: 'select',
+  zipPath: null,
+  fileName: null,
+  validating: false,
+  validated: false,
+  validationError: null,
+  form: { ...EMPTY_MY_CONFIG_FORM },
+  formErrors: { name: null },
+  running: false,
+  result: null,
+  error: null,
+}
+
+/**
+ * 向导的持久化切片 = 全量状态去掉瞬态/派生字段（validating/running/formErrors）。
+ * formErrors 恢复时由 restoreMyWizard 经 validateMyConfigForm 重算；validating/running 恢复后恒 false。
+ * 仅非敏感字段：zipPath 为宿主受控临时文件路径、form 为用户输入描述性内容（含 update 模式的
+ * 公开条目 id）、result 为无 token 的 UploadResult —— 与 run-store market 切片整体落盘纪律一致。
+ */
+export interface MyWizardSlice {
+  mode: 'upload' | 'update'
+  step: 'select' | 'validate' | 'form'
+  zipPath: string | null
+  fileName: string | null
+  validated: boolean
+  validationError: string | null
+  form: MyConfigForm
+  result: MyUploadResult | null
+  error: string | null
+}
+
+/** 全量状态 → 持久化切片（忽略 validating/running/formErrors；form 浅拷贝，result 直接引用纯 JSON）。 */
+export function toMyWizardSlice(w: MyWizardState): MyWizardSlice {
+  return {
+    mode: w.mode,
+    step: w.step,
+    zipPath: w.zipPath,
+    fileName: w.fileName,
+    validated: w.validated,
+    validationError: w.validationError,
+    form: { ...w.form },
+    result: w.result,
+    error: w.error,
+  }
+}
+
+/**
+ * 持久化切片 → 全量状态（null → 全新向导）。瞬态字段归零（validating/running 恒 false），
+ * formErrors 按 form 经 validateMyConfigForm 重算；form 拷贝新对象（不共享切片引用）。
+ */
+export function restoreMyWizard(slice: MyWizardSlice | null): MyWizardState {
+  if (slice === null) return { ...EMPTY_MY_WIZARD, form: { ...EMPTY_MY_CONFIG_FORM } }
+  return {
+    mode: slice.mode,
+    step: slice.step,
+    zipPath: slice.zipPath,
+    fileName: slice.fileName,
+    validating: false,
+    validated: slice.validated,
+    validationError: slice.validationError,
+    form: { ...slice.form },
+    formErrors: validateMyConfigForm(slice.form),
+    running: false,
+    result: slice.result,
+    error: slice.error,
+  }
+}
+
+/** 指定模式的向导初始状态（form 全新空表；mode/step 之外同 EMPTY_MY_WIZARD）。 */
+export function initialWizard(mode: 'upload' | 'update'): MyWizardState {
+  return { ...EMPTY_MY_WIZARD, mode, form: { ...EMPTY_MY_CONFIG_FORM } }
+}
+
+/* ---------------------------------------------------------------- 装回本地状态模型 */
+
+/**
+ * 装回本地（下载 + 逐分区批准 + 执行导入）的运行时全量状态。
+ * importing 为瞬态：不进入持久化切片（MyInstallSlice）；approvals（逐分区批准）是
+ * 用户昂贵的人工决策，必须随切片保留（切 tab/刷新不丢）。
+ */
+export interface MyInstallState {
+  itemId: string
+  detail: MarketDownloadResult | null
+  /** 逐分区批准表（安全不变式 (c)：高风险分区默认不勾选） */
+  approvals: MarketApprovals
+  /** 瞬态：导入执行中（不持久化，恢复后恒 false） */
+  importing: boolean
+  importResult: ImportResult | null
+  error: string | null
+}
+
+/**
+ * 装回本地的持久化切片 = 全量状态去掉瞬态（importing）。
+ * 仅非敏感字段：detail.zipPath 为宿主受控临时文件路径、approvals 为布尔批准表、
+ * importResult 为纯 JSON、error 为已 redact 文本 —— 与 run-store market 切片整体落盘纪律一致。
+ */
+export interface MyInstallSlice {
+  itemId: string
+  detail: MarketDownloadResult | null
+  approvals: MarketApprovals
+  importResult: ImportResult | null
+  error: string | null
+}
+
+/** 全量状态 → 持久化切片（忽略 importing；detail/approvals/importResult 直接引用纯 JSON/布尔表）。 */
+export function toMyInstallSlice(s: MyInstallState): MyInstallSlice {
+  return {
+    itemId: s.itemId,
+    detail: s.detail,
+    approvals: s.approvals,
+    importResult: s.importResult,
+    error: s.error,
+  }
+}
+
+/** 持久化切片 → 全量状态（null → 无装回本地会话；importing 恢复后恒 false）。 */
+export function restoreMyInstall(slice: MyInstallSlice | null): MyInstallState | null {
+  if (slice === null) return null
+  return {
+    itemId: slice.itemId,
+    detail: slice.detail,
+    approvals: slice.approvals,
+    importing: false,
+    importResult: slice.importResult,
+    error: slice.error,
+  }
+}
+
 /* ---------------------------------------------------------------- 系统自动字段徽章 */
 
 /** 系统自动字段（表单不用填，UI 以「系统自动」徽章展示，§2.4）。 */