dsh-config-manager 0.1.86 → 0.2.0

package/src/client/chat/chat-entry-view.test.ts

@@ -475,7 +475,7 @@ test('动作行图标走宿主原生（复制 → 对勾 → 回退），拿不
 /**
  * 2026-10-17（用户要求「与 DSH 原生气泡完全一致」）：§15b 的几何/字号必须与宿主
  * MessageItem + MessageIconActions 的**同一条取值**逐字同式（宿主产物抽出的取值清单见
- * docs/spec/known-gaps.md 的「G-39 增量（八）」）。这张用例是那条口径的源级护栏：
+ * docs/maintenance/known-gaps.md 的「G-39 增量（八）」）。这张用例是那条口径的源级护栏：
  * 谁把圆角/内边距/动作行/文件卡改回「近似档」，这里立刻红。
  */
 test('气泡与动作行逐值对齐宿主：圆角 xl(20px) / 内边距 10·16 / 动作行 28+delta / 文件卡 240·64', () => {

package/src/client/chat/rollback-entry-view.test.ts

@@ -443,6 +443,20 @@ test('A 真机回归：workspaces.archiveSession 依赖 this —— 抽方法时
   assert.deepEqual(service.archived, ['c1'])
 })
 
+test('A 真机回归（0.2.x 服务名）：归档能力只在 uiWorkspace 上，也必须取得到', async () => {
+  const service = {
+    archived: [] as string[],
+    async archiveSession(this: { archived: string[] }, id: string): Promise<unknown> {
+      this.archived.push(id)
+      return { ok: true, value: { archivedSessionIds: [id] } }
+    },
+  }
+  // 老版本才有 workspaces 服务；只照这个名字取 = 真机上永远拿不到（本轮修的就是这个）。
+  const sources = navigationSourcesOf({ get: (key: string) => (key === 'uiWorkspace' ? service : undefined) })
+  assert.deepEqual(await archiveParentSession(sources.workspaces, 'c2'), { ok: true })
+  assert.deepEqual(service.archived, ['c2'])
+})
+
 test('A：归档失败码 → 文案键（子串映射；成功不提示；界面绝不裸渲染机器码）', () => {
   assert.equal(archiveHintKey({ ok: true }), null)
   assert.equal(archiveHintKey({ ok: false, code: 'archive-unavailable' }), 'rollback.rewind.archive.unavailable')

package/src/client/chat/rollback-entry-view.ts

@@ -839,7 +839,8 @@ export function navigationSourcesOf(ctx: unknown): NavigationSources {
   return {
     workspace: asWorkspaceSource(safeGet('uiWorkspace')),
     sessions: asSessionListSource(safeGet('sessions')),
-    workspaces: asArchiveSource(safeGet('workspaces')),
+    // 归档能力挂在 uiWorkspace 上（真机 DSH 0.2.x 只有这个服务名；老版本才有 workspaces）——两个都试，不猜。
+    workspaces: asArchiveSource(safeGet('uiWorkspace')) ?? asArchiveSource(safeGet('workspaces')),
   }
 }
 

package/src/client/common/CopyButton.tsx

@@ -21,6 +21,7 @@ import { useEffect, useRef, useState } from 'react'
 import type { TranslateNS } from '../client-types.ts'
 import { toast } from './toast-store.ts'
 import { CopyStateIcon } from './Icon.tsx'
+import { hostIcon } from './host-primitives.ts'
 import { copyTextToClipboard } from './clipboard.ts'
 import css from '../config-manager.module.css'
 
@@ -63,9 +64,27 @@ export function CopyButton({ text, label, t }: CopyButtonProps) {
     })
   }
 
+  /**
+   * 图标 = **对话（聊天）回退条用的那两颗宿主原生图**（2026-10-28 用户要求「复制图标统一替换成
+   * 对话回退的复制 icon」）：`IconCopyOutlineRegular → IconCheckOutlineRegular` 的**瞬时换图**，
+   * 与宿主 MessageIconActions / ChatEntryCopyAction 同一对、同一字形与描边重量。
+   * 拿不到宿主图标的老宿主回落 morphicons 的 `CopyStateIcon`（绝不能变成空白按钮）。
+   */
+  const HostCopyIcon = hostIcon('IconCopyOutlineRegular')
+  const HostCheckIcon = hostIcon('IconCheckOutlineRegular')
+
   return (
-    <button type="button" className={css.copyBtn} aria-label={label} title={label} onClick={onClick}>
-      <CopyStateIcon done={copied} size={12} />
+    <button
+      type="button"
+      className={css.copyBtn}
+      aria-label={label}
+      title={label}
+      onClick={onClick}
+      data-copy-state={copied ? 'copied' : 'idle'}
+    >
+      {HostCopyIcon !== null && HostCheckIcon !== null
+        ? (copied ? <HostCheckIcon size={12} /> : <HostCopyIcon size={12} />)
+        : <CopyStateIcon done={copied} size={12} />}
     </button>
   )
 }

package/src/client/common/Icon.tsx

@@ -30,7 +30,9 @@ import DatabaseBackup from 'lucide-react/dist/esm/icons/database-backup.mjs'
 import Download from 'lucide-react/dist/esm/icons/download.mjs'
 import Eye from 'lucide-react/dist/esm/icons/eye.mjs'
 import File from 'lucide-react/dist/esm/icons/file.mjs'
+import Folder from 'lucide-react/dist/esm/icons/folder.mjs'
 import FolderInput from 'lucide-react/dist/esm/icons/folder-input.mjs'
+import FolderOpen from 'lucide-react/dist/esm/icons/folder-open.mjs'
 import HardDriveDownload from 'lucide-react/dist/esm/icons/hard-drive-download.mjs'
 import History from 'lucide-react/dist/esm/icons/history.mjs'
 import Info from 'lucide-react/dist/esm/icons/info.mjs'
@@ -68,6 +70,8 @@ const ICONS = {
   close: X,
   delete: Trash2,
   file: File,
+  folder: Folder,
+  folderOpen: FolderOpen,
   download: Download,
   inspect: Search,
   view: Eye,
@@ -238,6 +242,9 @@ export const CloseIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name
 export const DeleteIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="delete" {...p} />
 export const DownloadIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="download" {...p} />
 export const InspectIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="inspect" {...p} />
+export const FolderIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="folder" {...p} />
+export const FolderOpenIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="folderOpen" {...p} />
+export const FileIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="file" {...p} />
 export const ArrowRightIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="arrowRight" {...p} />
 export const ChevronDownIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="chevronDown" {...p} />
 export const PreviewIcon = (p: Omit<IconProps, 'name'>): JSX.Element => <Icon name="preview" {...p} />

package/src/client/common/routes.ts

@@ -106,6 +106,11 @@ export const CONFIG_MANAGER_API = {
    * 带 `sessionId` = 流式代理 DSH 自己的 `/api/session.export`（原始日志 ZIP，含子会话与附件）。
    */
   sessionExport: `${API_BASE}/session-export`,
+  /**
+   * 本机目录列举（**只读**）：`?path=` 缺省 = 「此电脑」根列表。
+   * 导入向导「路径映射 → 选本机路径」弹窗的唯一数据源（浏览器拿不到真实目录树）。
+   */
+  pathBrowse: `${API_BASE}/path-browse`,
 } as const;
 
 /** 远程同步路由族（git / webdav 通道、GitHub device flow、历史快照、自动同步、分区选择）。 */

package/src/client/config-manager.module.css

@@ -3972,6 +3972,11 @@ body {
 
 .pathOld,
 .pathNew {
+  /* 黑块溢出面板的根因：本仓库**没有**全局 `*{box-sizing:border-box}` 复位，而这块是
+     width:100% + padding 4/8px + border 1px 的 content-box ⇒ 实际外框比父内容盒宽 18px，
+     深色底块右缘冲出 .pathRow 约 7px（实测卡片 39..570 vs 内部块 51..577）。
+     声明式修法：本块自己算 border-box（与 .input 的既有做法一致）。 */
+  box-sizing: border-box;
   min-width: 0;
   width: 100%;
   /* 纵向列容器：让内部 input 拉满块宽（等价于旧版全局 .input{width:100%} 的效果，
@@ -3998,6 +4003,71 @@ body {
   flex: none;
 }
 
+/* 新路径输入行：手打输入 + 浏览按钮同一行（窄画布下按钮 flex:none 不换行，输入可收缩） */
+.pathInputRow {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  min-width: 0;
+}
+
+.pathInputRow > .input {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+
+/* 路径选择弹窗：当前目录条 + 一层条目列表（长列表由 Modal.Body scroll 限高内滚） */
+.pickerPath {
+  box-sizing: border-box;
+  width: 100%;
+  padding: 4px 8px;
+  border-radius: var(--cm-r-2);
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-secondary);
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: var(--cm-fs-meta);
+  overflow-wrap: anywhere;
+}
+
+.pickerList {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.pickerRow {
+  box-sizing: border-box;
+  width: 100%;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 8px;
+  border: 1px solid transparent;
+  border-radius: var(--cm-r-2);
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: var(--cm-fs-meta);
+  text-align: left;
+  cursor: pointer;
+}
+
+.pickerRow:hover {
+  background: var(--dsw-alias-bg-layer-2);
+}
+
+.pickerRow:focus-visible {
+  outline: 2px solid var(--cm-accent);
+  outline-offset: -1px;
+}
+
+/* 文件名可任意折行，绝不横向撑破弹窗 */
+.pickerName {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
 /* 密钥补录 */
 .secretsList {
   display: flex;

package/src/client/import/ImportWizardView.tsx

@@ -648,6 +648,7 @@ function ImportWizardBody({ api, t, uiT, onOpenForeignImport }: ImportWizardView
         onBack={() => { setPhase('preview') }}
         onNext={finishPathMapping}
         t={t}
+        api={api}
       />
     )
   }

package/src/client/import/PathMappingForm.tsx

@@ -10,7 +10,10 @@ import { useMemo, useState } from 'react'
 import type { ChangeEvent } from 'react'
 import type { PathIssue, PathMapping } from '../../core/types.ts'
 import type { TranslateNS } from '../client-types.ts'
-import { Banner } from '../common/ui.tsx'
+import { Banner, IconButton } from '../common/ui.tsx'
+import { FolderOpenIcon } from '../common/Icon.tsx'
+import { PathPickerDialog } from './PathPickerDialog.tsx'
+import type { PathBrowsePort } from './PathPickerDialog.tsx'
 import css from '../config-manager.module.css'
 
 /**
@@ -32,13 +35,17 @@ export interface PathMappingFormProps {
   t: TranslateNS<'config-manager'>
   /** 映射变化时上报（仅已填写 newPrefix 的条目进入 core） */
   onChange: (mappings: PathMapping[]) => void
+  /** 本机路径来源：原生选择器优先，内置目录浏览器兜底（同一条宿主端点 /path-browse） */
+  api: PathBrowsePort
 }
 
 /**
  * 路径映射表单：每条 PathIssue 一行（原路径 → 新路径输入框），
  * 留空 = 该路径不映射（unresolved）；填写 = 输出 core PathMapping[]。
  */
-export function PathMappingForm({ issues, initial, t, onChange }: PathMappingFormProps) {
+export function PathMappingForm({ issues, initial, t, onChange, api }: PathMappingFormProps) {
+  // 正在为哪条路径挑目录（oldPrefix 作 key；null = 弹窗关闭）
+  const [pickingFor, setPickingFor] = useState<string | null>(null)
   // draft 状态：issue.value（oldPrefix）→ newPrefix；预置映射合并进 initial 状态
   const [drafts, setDrafts] = useState<Record<string, string>>(() => {
     const out: Record<string, string> = {}
@@ -55,6 +62,34 @@ export function PathMappingForm({ issues, initial, t, onChange }: PathMappingFor
     onChange(mappings)
   }
 
+  /**
+   * 文件夹按钮的完整动作，三层降级，任一层拿到绝对路径就回填：
+   *  ① **DSH 宿主自带**的目录选择器（就是「选择工作区目录」那个原生窗口，跟着宿主主进程走，最稳）；
+   *  ② 插件自己的系统对话框（Windows = 资源管理器同款、macOS = Finder、Linux = zenity/kdialog）；
+   *  ③ 内置目录浏览器（前两层都没有时才用）。
+   *
+   * 用户在任何一层点取消 ⇒ 什么都不做（不是错误，不弹红条）。
+   */
+  const pickFolder = (oldPrefix: string): void => {
+    const startPath = (drafts[oldPrefix] ?? '').trim()
+    void (async () => {
+      const viaHost = api.pickDshPath === undefined ? undefined : await api.pickDshPath()
+      if (viaHost?.ok === true) {
+        setNewPrefix(oldPrefix, viaHost.path)
+        return
+      }
+      if (viaHost?.reason === 'canceled') return
+      // 宿主没有该能力（非桌面宿主 / 版本较旧 / 调用抛错）⇒ 换插件自己的原生对话框
+      const native = await api.pickNativePath(startPath, t('import.paths.picker.title')).catch(() => null)
+      if (native !== null && native.ok) {
+        setNewPrefix(oldPrefix, native.path)
+        return
+      }
+      if (native !== null && native.reason === 'canceled') return
+      setPickingFor(oldPrefix) // unsupported / failed / 请求失败 → 内置浏览器兜底
+    })()
+  }
+
   const unresolved = useMemo(() => {
     return issues.filter((issue) => (drafts[issue.value] ?? '') === '')
   }, [issues, drafts])
@@ -78,15 +113,34 @@ export function PathMappingForm({ issues, initial, t, onChange }: PathMappingFor
           </div>
           <div className={css.pathNew}>
             <div className={css.fieldLabel}>{t('import.paths.new')}</div>
-            <input
-              className={css.input}
-              value={drafts[issue.value] ?? ''}
-              placeholder={issue.mappedTo ?? ''}
-              onChange={(e: ChangeEvent<HTMLInputElement>) => { setNewPrefix(issue.value, e.target.value) }}
-            />
+            {/* 输入行 = 手打 + 原生选择器（不可用时回落宿主的目录浏览器；浏览器本身拿不到本机路径） */}
+            <div className={css.pathInputRow}>
+              <input
+                className={css.input}
+                value={drafts[issue.value] ?? ''}
+                placeholder={issue.mappedTo ?? ''}
+                onChange={(e: ChangeEvent<HTMLInputElement>) => { setNewPrefix(issue.value, e.target.value) }}
+              />
+              <IconButton
+                icon={<FolderOpenIcon size={14} />}
+                label={t('import.paths.browse')}
+                onClick={() => { pickFolder(issue.value) }}
+              />
+            </div>
           </div>
         </div>
       ))}
+      <PathPickerDialog
+        open={pickingFor !== null}
+        api={api}
+        t={t}
+        startPath={pickingFor === null ? '' : (drafts[pickingFor] ?? '')}
+        onPick={(path) => {
+          if (pickingFor !== null) setNewPrefix(pickingFor, path)
+          setPickingFor(null)
+        }}
+        onClose={() => { setPickingFor(null) }}
+      />
     </div>
   )
 }

package/src/client/import/PathPickerDialog.tsx

@@ -0,0 +1,172 @@
+/**
+ * 本机路径选择弹窗（导入 → 路径映射 → 每条「新路径」右侧的文件夹按钮）。
+ *
+ * 为什么需要它
+ * ------------
+ * 路径映射要求用户给一堆**绝对路径**指定本机新位置，而浏览器拿不到真实路径
+ * （File System Access API 只给 handle，`<input type="file">` 只给文件名）。此前用户只能凭记忆
+ * 手打 `D:\\Apps\\nodejs\\node_global\\gitnexus.cmd` 这类字符串 —— 打错一位就等于「导不进」。
+ * 目录列举由宿主 `GET /path-browse` 提供（src/core/path-browse.ts，只读、有界），本组件只画界面。
+ *
+ * 交互约定
+ * --------
+ * - 点目录 = 进入；点文件 = 直接选中（原路径可能指向文件，如 .cmd / .json）；
+ * - 「使用当前目录」回填当前目录；「上一层」「主目录」是导航快捷入口；
+ * - 起点 `startPath` 若是文件或不存在，宿主会同时给出 `parent`，这里上浮一层再列（只自动上浮一次，
+ *   免得用户在空目录里被反复弹走）。
+ *
+ * 边界：组件不发请求做判断，不创建/改名/删除任何东西；错误码由字典翻译（引擎不产文案）。
+ */
+import { useEffect, useRef, useState } from 'react'
+import type { BrowseErrorCode, BrowseResult } from '../../core/path-browse.ts'
+import type { ConfigManagerApi } from '../api.ts'
+import type { TranslateNS } from '../client-types.ts'
+import { Modal } from '../common/Modal.tsx'
+import { Banner, Button, Spinner } from '../common/ui.tsx'
+import { FileIcon, FolderIcon } from '../common/Icon.tsx'
+import css from '../config-manager.module.css'
+
+/** 列举失败原因码 → 字典键（与 core 的 `BrowseErrorCode` 一一对应）。 */
+const BROWSE_ERROR_LABEL: Record<BrowseErrorCode, Parameters<TranslateNS<'config-manager'>>[0]> = {
+  'not-found': 'import.paths.picker.notFound',
+  denied: 'import.paths.picker.denied',
+  failed: 'import.paths.picker.failed',
+  'not-absolute': 'import.paths.picker.notAbsolute',
+}
+
+/** 列举状态机（加载中 / 有结果 / 传输失败）。 */
+type BrowseState =
+  | { kind: 'loading' }
+  | { kind: 'ready'; data: BrowseResult }
+  | { kind: 'failed'; detail: string }
+
+/**
+ * 只需要两个方法：内置浏览器列举 + 原生选择器（两者是**同一条**宿主端点的 GET / POST 形态）。
+ * 这样测试替身只碰这两个方法，其余 API 一概不进入组件视野。
+ * `pickDshPath`（DSH 宿主自带选择器）是可选能力：DSH 客户端总提供它，测试替身不必实现。
+ */
+export type PathBrowsePort = Pick<ConfigManagerApi, 'browsePath' | 'pickNativePath'> & {
+  pickDshPath?: ConfigManagerApi['pickDshPath']
+}
+
+export interface PathPickerDialogProps {
+  open: boolean
+  api: PathBrowsePort
+  t: TranslateNS<'config-manager'>
+  /** 起点：输入框现值（可能是文件、可能是别的机器的路径、可能为空） */
+  startPath: string
+  /** 选中（目录或文件）—— 由调用方回填输入框；本组件不自行关闭弹窗 */
+  onPick: (path: string) => void
+  onClose: () => void
+}
+
+/**
+ * 目录浏览弹窗：列一层目录，点目录进入、点文件选中。
+ */
+export function PathPickerDialog({ open, api, t, startPath, onPick, onClose }: PathPickerDialogProps) {
+  const [current, setCurrent] = useState<string | null>(null)
+  const [state, setState] = useState<BrowseState>({ kind: 'loading' })
+  // 自动上浮只做一次：记录已经为哪个起点上浮过（避免空目录/不存在路径来回弹）
+  const risenFor = useRef<string | null>(null)
+
+  const trimmedStart = startPath.trim()
+
+  // 打开时把起点落到当前目录（关闭状态下不动，避免清掉上次浏览位置造成闪烁）
+  useEffect(() => {
+    if (!open) return
+    risenFor.current = null
+    setCurrent(trimmedStart === '' ? null : trimmedStart)
+  }, [open, trimmedStart])
+
+  useEffect(() => {
+    if (!open) return
+    let alive = true
+    setState({ kind: 'loading' })
+    api.browsePath(current ?? undefined).then(
+      (data) => {
+        if (!alive) return
+        // 起点是文件或不存在：宿主给出的 parent 就是「该去哪」，上浮一层再列（一次性）
+        if (
+          data.error === 'not-found'
+          && data.path === trimmedStart
+          && data.parent !== null
+          && risenFor.current !== data.path
+        ) {
+          risenFor.current = data.path
+          setCurrent(data.parent)
+          return
+        }
+        setState({ kind: 'ready', data })
+      },
+      (error: unknown) => {
+        if (!alive) return
+        setState({ kind: 'failed', detail: error instanceof Error ? error.message : String(error) })
+      },
+    )
+    return () => { alive = false }
+  }, [open, current, trimmedStart, api])
+
+  const data = state.kind === 'ready' ? state.data : null
+  const atRoots = data !== null && data.path === ''
+  const canGoUp = data !== null && data.parent !== null
+  const pathLabel = atRoots ? t('import.paths.picker.thisPc') : (data?.path ?? trimmedStart)
+
+  return (
+    <Modal open={open} onClose={onClose} title={t('import.paths.picker.title')} wide>
+      <Modal.Header title={t('import.paths.picker.title')} onClose={onClose} closeLabel={t('common.close')} />
+      <Modal.Body scroll style={{ maxHeight: '56vh' }}>
+        <div className={css.pickerPath} title={pathLabel}>{pathLabel}</div>
+        {state.kind === 'loading' && <Spinner label={t('common.loading')} />}
+        {state.kind === 'failed' && <Banner kind="error">{state.detail}</Banner>}
+        {state.kind === 'ready' && (
+          <>
+            {state.data.error !== null && <Banner kind="warn">{t(BROWSE_ERROR_LABEL[state.data.error])}</Banner>}
+            {state.data.error === null && state.data.truncated && (
+              <Banner kind="info">{t('import.paths.picker.truncated', { count: String(state.data.entries.length) })}</Banner>
+            )}
+            {state.data.error === null && state.data.entries.length === 0 && (
+              <div className={css.empty}>{t('import.paths.picker.empty')}</div>
+            )}
+            {state.data.entries.length > 0 && (
+              <div className={css.pickerList}>
+                {state.data.entries.map((entry) => (
+                  <button
+                    key={entry.path}
+                    type="button"
+                    className={css.pickerRow}
+                    data-kind={entry.kind}
+                    title={entry.path}
+                    onClick={() => {
+                      if (entry.kind === 'dir') setCurrent(entry.path)
+                      else onPick(entry.path)
+                    }}
+                  >
+                    {entry.kind === 'dir' ? <FolderIcon size={14} /> : <FileIcon size={14} />}
+                    <span className={css.pickerName}>{entry.name}</span>
+                  </button>
+                ))}
+              </div>
+            )}
+          </>
+        )}
+      </Modal.Body>
+      <Modal.Footer>
+        <Button onClick={() => { if (data?.parent != null) setCurrent(data.parent) }} disabled={!canGoUp}>
+          {t('import.paths.picker.up')}
+        </Button>
+        <Button onClick={() => { if (data !== null) setCurrent(data.home) }} disabled={data === null}>
+          {t('import.paths.picker.home')}
+        </Button>
+        <Button onClick={onClose}>{t('common.cancel')}</Button>
+        {/* 根列表（「此电脑」）本身不是可映射目录：没有「当前目录」可回填 */}
+        <Button
+          variant="primary"
+          disabled={data === null || atRoots}
+          onClick={() => { if (data !== null) onPick(data.path) }}
+        >
+          {t('import.paths.picker.useCurrent')}
+        </Button>
+      </Modal.Footer>
+    </Modal>
+  )
+}

package/src/client/import/dsh-directory-pick.test.ts

@@ -0,0 +1,55 @@
+/**
+ * DSH 目录选择器解析层单测。
+ *
+ * 回归点（真机踩过的）：服务名是 `uiWorkspace`，不是 `workspaces` ——
+ * 只写 `workspaces` 时真机上永远取不到服务，于是「复用 DSH 自带选择器」根本没发生，
+ * 用户看到的一直是插件自己的对话框。这个文件钉住解析顺序与降级。
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { makeDshDirectoryPicker } from './dsh-directory-pick.ts';
+import type { DirectoryPickSources } from './dsh-directory-pick.ts';
+
+test('DSH-01 桌面全局优先：__DSH_DIRECTORY_PICKER__.pick 直接返回路径', async () => {
+  const calls: string[] = [];
+  const sources: DirectoryPickSources = {
+    desktop: { pick: async () => { calls.push('desktop'); return '/desktop/path' } },
+    getService: (name) => ({ pickDirectory: async () => { calls.push(name); return '/service/path' } }),
+  };
+  assert.equal(await makeDshDirectoryPicker(sources)(), '/desktop/path');
+  assert.deepEqual(calls, ['desktop'], '全局有就不该再碰服务');
+});
+
+test('DSH-02 服务名 uiWorkspace（真机口径）：即使 workspaces 不存在也必须成功', async () => {
+  const sources: DirectoryPickSources = {
+    getService: (name) => (name === 'uiWorkspace' ? { pickDirectory: async () => '/ws/path' } : undefined),
+  };
+  assert.equal(await makeDshDirectoryPicker(sources)(), '/ws/path');
+});
+
+test('DSH-03 老版本回退：只有 workspaces 时仍取得到', async () => {
+  const sources: DirectoryPickSources = {
+    getService: (name) => (name === 'workspaces' ? { pickDirectory: async () => '/legacy' } : undefined),
+  };
+  assert.equal(await makeDshDirectoryPicker(sources)(), '/legacy');
+});
+
+test('DSH-04 用户取消：服务返回 null 原样传出去（不是抛错）', async () => {
+  const sources: DirectoryPickSources = { getService: () => ({ pickDirectory: async () => null }) };
+  assert.equal(await makeDshDirectoryPicker(sources)(), null);
+});
+
+test('DSH-05 没有任何入口：抛错交给上层降级，绝不冒充「用户取消」', async () => {
+  await assert.rejects(makeDshDirectoryPicker({})(), /DSH directory picker unavailable/);
+  // 服务在但没有 pickDirectory（形态不符）同样算没有。
+  await assert.rejects(makeDshDirectoryPicker({ getService: () => ({ other: 1 }) })(), /unavailable/);
+});
+
+test('DSH-06 惰取：每次调用重新读服务，宿主重连后能拿到新实例', async () => {
+  let current: unknown = { pickDirectory: async () => '/first' };
+  const sources: DirectoryPickSources = { getService: () => current };
+  const pick = makeDshDirectoryPicker(sources);
+  assert.equal(await pick(), '/first');
+  current = { pickDirectory: async () => '/second' };
+  assert.equal(await pick(), '/second');
+});

package/src/client/import/dsh-directory-pick.ts

@@ -0,0 +1,55 @@
+/**
+ * DSH 自带目录选择器的解析层。
+ *
+ * 真机取证（DSH 0.2.1-rc.3，`resources/app.asar` 内）：
+ * - 桌面壳把原生选择器挂在全局：`globalThis.__DSH_DIRECTORY_PICKER__.pick(): Promise<string | null>`，
+ *   DSH 自己的 `@deepseek-ai/dsh-client-ui-directory-picker-native` 优先用它。
+ * - Web 侧走服务：`new UiWorkspaceService(...)` 里 `super(ctx, "uiWorkspace")`，
+ *   即服务名是 **uiWorkspace**（不是 workspaces），方法 `pickDirectory(): Promise<string | null>`。
+ *
+ * 这里只做「按优先级找一个能用的入口」，找不到就抛错交给上层降级：
+ * 上层顺序是 DSH 原生 → 插件自己的系统对话框 → 内置浏览器。
+ */
+
+/** 桌面壳全局选择器（Electron 侧注入；web 版本没有）。 */
+export interface DesktopDirectoryPicker {
+  pick?: () => Promise<string | null>
+}
+
+/** DSH 客户端服务里只要这个能力。 */
+export interface DirectoryPickService {
+  pickDirectory?: () => Promise<string | null>
+}
+
+/** 解析所需的两个来源（都可缺；测试直接注入替身）。 */
+export interface DirectoryPickSources {
+  /** `globalThis.__DSH_DIRECTORY_PICKER__` */
+  desktop?: DesktopDirectoryPicker | undefined
+  /** `ctx.get(name)`：服务名随 DSH 版本变，两个都试。 */
+  getService?: ((name: string) => unknown) | undefined
+}
+
+/** 服务名按 DSH 版本从新到旧：0.2.x = uiWorkspace，更早 = workspaces。 */
+const SERVICE_NAMES = ['uiWorkspace', 'workspaces'] as const
+
+function asService(value: unknown): DirectoryPickService | undefined {
+  if (typeof value !== 'object' || value === null) return undefined
+  const candidate = value as DirectoryPickService
+  return typeof candidate.pickDirectory === 'function' ? candidate : undefined
+}
+
+/**
+ * 造一个惰取 thunk：每次都重新读服务（宿主重连/服务重建后旧快照会失效）。
+ * 找不到任何入口就抛错 —— 调用方据此归成 `unavailable` 并降级，绝不静默当成「用户取消」。
+ */
+export function makeDshDirectoryPicker(sources: DirectoryPickSources): () => Promise<string | null> {
+  return async () => {
+    const desktop = sources.desktop
+    if (desktop !== undefined && typeof desktop.pick === 'function') return desktop.pick()
+    for (const name of SERVICE_NAMES) {
+      const service = asService(sources.getService?.(name))
+      if (service?.pickDirectory !== undefined) return service.pickDirectory()
+    }
+    throw new Error('config-manager: DSH directory picker unavailable')
+  }
+}

package/src/client/import/import-wizard-steps.tsx

@@ -12,6 +12,7 @@ import type { ImportAnalysis, PathMapping } from '../../core/types.ts'
 import type { ConsultReport } from '../../core/migration-consult.ts'
 import type { TranslateNS } from '../client-types.ts'
 import type { UiT } from '../../ui/i18n.ts'
+import type { PathBrowsePort } from './PathPickerDialog.tsx'
 import {
   Badge, Banner, Button, Card, Checkbox, Empty, SectionTitle,
 } from '../common/ui.tsx'
@@ -276,12 +277,14 @@ export function PathMappingStage(props: {
   onBack: () => void
   onNext: () => void
   t: TranslateNS<'config-manager'>
+  /** 「选择本机路径」弹窗的数据源（宿主只读列举端点） */
+  api: PathBrowsePort
 }) {
-  const { issues, mappings, onMappingsChange, onBack, onNext, t } = props
+  const { issues, mappings, onMappingsChange, onBack, onNext, t, api } = props
   return (
     <div className={css.viewBody}>
       <SectionTitle title={t('import.paths.title')} info={<InfoHint text={t('import.paths.hint')} label={t('common.infoHint')} />} />
-      <PathMappingForm issues={issues} initial={mappings} t={t} onChange={onMappingsChange} />
+      <PathMappingForm issues={issues} initial={mappings} t={t} onChange={onMappingsChange} api={api} />
       <div className={css.actionRow}>
         <Button variant="ghost" onClick={onBack}>{t('common.back')}</Button>
         <Button variant="primary" onClick={onNext}>{t('common.next')}</Button>

package/src/client/index.ts

@@ -21,6 +21,8 @@ import type {} from '@deepseek-ai/dsh-client-locale/client'
 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 { makeDshDirectoryPicker } from './import/dsh-directory-pick.ts'
+import type { DesktopDirectoryPicker } from './import/dsh-directory-pick.ts'
 import { ConfigManagerApi } from './api.ts'
 import { ConfigManagerSection } from './ConfigManagerSection.tsx'
 import { en, zh, type ConfigManagerKey } from './locales.ts'
@@ -136,7 +138,16 @@ export function apply(ctx: ClientContext): void {
   // 模块级单例（runStore 等）用同一个活源：它们没有调用方可以传 UiT。
   setUiLanguageSource(readLanguage)
   const uiT: UiT = makeLiveUiT(readLanguage)
-  const api = new ConfigManagerApi(uiT)
+  // DSH 自带的目录选择器（「选择工作区目录」那个原生窗口）：**点击那一刻**才读全局/服务，
+  // 装载期快照会在宿主重连/服务重建后失效。解析顺序与降级见 import/dsh-directory-pick.ts
+  // （真机取证：服务名是 uiWorkspace，不是 workspaces；桌面壳还会挂全局 __DSH_DIRECTORY_PICKER__）。
+  const pickDshDirectory = makeDshDirectoryPicker({
+    get desktop() {
+      return (globalThis as { __DSH_DIRECTORY_PICKER__?: DesktopDirectoryPicker }).__DSH_DIRECTORY_PICKER__
+    },
+    getService: (name) => ctx.get(name),
+  })
+  const api = new ConfigManagerApi(uiT, pickDshDirectory)
   const syncT = ctx.locale.bind(SYNC_NS)
   const syncApi = new SyncApi(uiT)
   const marketT = ctx.locale.bind(MARKET_NS)