dsh-config-manager 0.1.86 → 0.2.0

package/lib/cli/web/page.js

@@ -5,7 +5,7 @@
  * HTML：**零脚本、零外部资源、零构建产物**，配合 http.ts 里收紧的 CSP。
  * 样式内联在 <style> 里（独立于插件 UI 的 CSS Modules；该新 pattern 已登记进 DESIGN.md）。
  * 这套样式表**有一份外部出处**（亮色 IBM Carbon / 暗色 Raycast 阶梯）与逐条对照表：
- * docs/design/2026-10-04-cli-rescue-console-carbon.md —— 改 STYLE 前先读它，改完跑 web.test.ts 的 R3-02。
+ * docs/components/cli-rescue-console.md —— 改 STYLE 前先读它，改完跑 web.test.ts 的 R3-02。
  *
  * 呈现纪律：每个数字都要能回答「你怎么知道的」—— 离线拿不到的（结构化分区/凭据/同步令牌）
  * 一律显式列出并说明原因，绝不显示为 0 或留空。
@@ -17,7 +17,7 @@ import { redact } from '../../security/redaction.js';
 import { CONSOLE_SCRIPT } from './client-script.js';
 const STYLE = [
     // ---- 设计 token：IBM Carbon（亮色语义四色）+ Raycast（暗色 surface 阶梯）----
-    // 映射表、取的章节与全部偏离记录：docs/design/2026-10-04-cli-rescue-console-carbon.md
+    // 映射表、取的章节与全部偏离记录：docs/components/cli-rescue-console.md
     // 文字色一律取「能读」的那一档：Carbon 的 #24a148 / #f1c21b 只做填充，正文用 #198038 / #8e6a00
     // （AA 对比度由 web.test.ts 的 R3-02 逐对钉住，改色先过那条测试）。
     ':root{color-scheme:light dark;--font:system-ui,-apple-system,"Segoe UI",Roboto,"PingFang SC","Hiragino Sans GB","Microsoft YaHei","Noto Sans SC",sans-serif;--mono:ui-monospace,SFMono-Regular,Menlo,Consolas,"Liberation Mono",monospace;--fg:#161616;--muted:#525252;--bg:#f4f4f4;--card:#fff;--surface:#f4f4f4;--line:#e0e0e0;--accent:#0f62fe;--accent-hover:#0043ce;--on-accent:#fff;--ok:#198038;--warn:#8e6a00;--bad:#da1e28;--scrim:rgba(22,22,22,.45)}',

package/lib/client.d.ts

@@ -2367,6 +2367,39 @@ interface ForeignSourcesResponse$1 {
   projectScoped?: boolean;
   sources: readonly ForeignSourceStatusInput[];
 }
+/** 列举失败的原因码（客户端按它选字典键）。 */
+type BrowseErrorCode = 'not-found' | 'denied' | 'failed' | 'not-absolute';
+/** 一条条目：目录（可进入）或文件（可选中）。 */
+interface BrowseEntry {
+  /** 末段名字（驱动器根即盘符本身，如 `D:\\`）。 */
+  name: string;
+  /** 绝对路径（客户端原样回填输入框）。 */
+  path: string;
+  kind: 'dir' | 'file';
+}
+/** 列举结果。 */
+interface BrowseResult {
+  /** 当前列出的目录；空串 = 「此电脑」（Windows 的盘符根列表）。 */
+  path: string;
+  /** 上一级；已是根时为 null。 */
+  parent: string | null;
+  /** 用户主目录（界面上的快捷入口；不随 path 变化）。 */
+  home: string;
+  entries: BrowseEntry[];
+  /** 命中 {@link BROWSE_ENTRY_LIMIT} 被截断。 */
+  truncated: boolean;
+  /** 失败原因码；成功为 null。 */
+  error: BrowseErrorCode | null;
+}
+type NativePickReason = 'canceled' | 'unsupported' | 'failed';
+type NativePickResult = {
+  ok: true;
+  path: string;
+} | {
+  ok: false;
+  reason: NativePickReason;
+  detail?: string;
+};
 /** 超时文案键（全部已存在于 ui/i18n.ts；本模块只做选键，不新增文案口径）。 */
 type TimeoutMessageKey = 'error.requestTimeout' | 'error.fallback' | 'error.exportTimeout' | 'error.syncTimeout' | 'error.recoveryTimeout';
 /** 请求选项：超时档位、超时文案键、调用方取消信号。 */
@@ -2570,6 +2603,19 @@ interface DownloadResult {
 interface DownloadOptions {
   saveDialog?: boolean;
 }
+/**
+ * DSH 宿主自带目录选择器的结果。
+ *  - `ok`：用户选中（`path` 非空）；
+ *  - `canceled`：用户点了取消，调用方静默收手；
+ *  - `unavailable`：宿主没有这个能力（非桌面宿主 / 版本较旧 / 调用抛错），调用方回落下一层。
+ */
+type DshPickResult = {
+  ok: true;
+  path: string;
+} | {
+  ok: false;
+  reason: 'canceled' | 'unavailable';
+};
 /**
  * Config Manager 浏览器半的唯一数据入口。
  * 同时实现 `ExportPort`（export-flow 用）与 `ImportPort`（import-wizard 用）。
@@ -2583,7 +2629,13 @@ declare class ConfigManagerApi {
   exportPassword: string | null;
   /** 客户端展示层翻译器（zh 源 / en 镜像，见 ui/i18n.ts）。 */
   readonly t: UiT;
-  constructor(t: UiT);
+  /**
+   * DSH 自带目录选择器（桌面壳全局 `__DSH_DIRECTORY_PICKER__.pick` 或客户端服务 `ctx.get('uiWorkspace').pickDirectory`），
+   * 由 `apply(ctx)` 注入的**惰取** thunk（解析顺序见 `import/dsh-directory-pick.ts`）。
+   * 宿主没提供该能力时保持 `undefined`。
+   */
+  private readonly dshDirectoryPicker;
+  constructor(t: UiT, dshDirectoryPicker?: () => Promise<string | null>);
   /** 健康/版本检查（主页横幅：插件版本 / DSH 版本 / 平台） */
   status(): Promise<ServiceStatus>;
   /** Star 引导弹窗状态（进入页面时判定是否展示 / 是否补记首次使用时间）。 */
@@ -2639,6 +2691,27 @@ declare class ConfigManagerApi {
     decryptPassword?: string;
     sessionFormatDisposition?: SessionFormatDisposition;
   }): Promise<ImportPlan>;
+  /**
+   * 列出一层本机目录（只读；路径映射「选本机路径」弹窗的数据源）。
+   * `target` 缺省或空串 = 「此电脑」根列表（Windows 盘符 / POSIX `/`）。
+   * 失败不抛异常：宿主回 `error: 'not-found'|'denied'|'failed'|'not-absolute'`，弹窗照常可用。
+   */
+  browsePath(target?: string): Promise<BrowseResult>;
+  /**
+   * 弹**系统原生**目录选择器（同一端点的 POST 形态）。
+   *
+   * 用户可能在系统对话框里逛几分钟，所以超时必须远大于常规请求：内核侧 10 分钟兜底，这里再加一道。
+   * 回 `reason: 'unsupported' | 'failed'` 时调用方回落到内置目录浏览器，不当错误处理。
+   */
+  pickNativePath(startPath?: string, title?: string): Promise<NativePickResult>;
+  /**
+   * 复用 **DSH 宿主自带**的原生目录选择器（就是「选择工作区目录」那个窗口）。
+   *
+   * 比插件自己起系统对话框更稳：窗口由 DSH 主进程弹，跟着宿主走，不受插件宿主的进程形态限制。
+   * 完全不设客户端超时 —— 用户可能在原生窗口里逛几分钟，宿主侧 `host.pickDirectory` 也是 caller-signal-only。
+   * 宿主没有该能力或调用抛错一律归成 `unavailable`，由调用方回落插件自己的原生对话框，不当错误处理。
+   */
+  pickDshPath(): Promise<DshPickResult>;
   /** ImportPort.decryptArchive：解锁整体加密备份容器 → 明文 ZIP 路径 + 解密覆盖的凭据 ref 名 */
   decryptArchive(zipPath: string, password: string): Promise<DecryptArchiveResponse>;
   /** ImportPort.executeImportPlan：快照→分阶段 apply→validate→commit/rollback */
@@ -5154,6 +5227,18 @@ declare const zh$4: {
   readonly 'import.paths.kind.homeMismatch': '基础路径不同';
   readonly 'import.paths.unresolved': '还有 {count} 条路径未映射（留空将跳过该路径，可以继续）';
   readonly 'import.paths.empty': '无需映射路径';
+  readonly 'import.paths.browse': '选择本机路径';
+  readonly 'import.paths.picker.title': '选择本机路径';
+  readonly 'import.paths.picker.up': '上一层';
+  readonly 'import.paths.picker.home': '主目录';
+  readonly 'import.paths.picker.thisPc': '此电脑';
+  readonly 'import.paths.picker.useCurrent': '使用当前目录';
+  readonly 'import.paths.picker.empty': '这个目录里没有可进入的项';
+  readonly 'import.paths.picker.truncated': '只显示前 {count} 项';
+  readonly 'import.paths.picker.notFound': '这个路径不存在（已为你打开上一级）';
+  readonly 'import.paths.picker.denied': '没有读取这个目录的权限';
+  readonly 'import.paths.picker.notAbsolute': '请填绝对路径（如 D:\\ 或 /）';
+  readonly 'import.paths.picker.failed': '读取这个目录失败';
   readonly 'home.schedule.title': '定时备份';
   readonly 'snapshots.selectHint': '选择快照以预览恢复计划（只读预览，不会改动任何设置）：';
   readonly 'snapshots.status': '状态';