dsh-config-manager 0.1.86 → 0.2.1

package/lib/core/path-browse.js

@@ -0,0 +1,134 @@
+/**
+ * 本机目录列举（宿主半）—— 「路径映射 → 选择本机路径」弹窗的唯一数据源。
+ *
+ * 为什么要有它
+ * ------------
+ * 导入向导的路径映射要求用户为一堆**绝对路径**指定本机新位置，而此前只能凭记忆手打
+ * （浏览器拿不到真实路径：File System Access API 只给 handle，`<input type="file">` 只给文件名）。
+ * 于是「路径选不对 = 导不进」全落在用户的打字准确性上。这里把「列目录」做成宿主能力，
+ * 浏览器只负责画界面。
+ *
+ * 边界
+ * ----
+ * - **只读**：只 readdir/stat，绝不创建、改写、删除任何东西；
+ * - **不产出文案**：`error` 是枚举码（not-found / denied / failed / not-absolute），
+ *   用户可见句子由客户端按字典解析（i18n 硬规则：引擎不写中文）；
+ * - 有界：单次列举最多 {@link BROWSE_ENTRY_LIMIT} 条并回报 `truncated`，盘符探测逐根带硬超时
+ *   （离线光驱/断开的网络盘 stat 会挂住，路由不许被一个 panic 盘符拖死）。
+ */
+import { readdir, stat } from 'node:fs/promises';
+import { dirname, join, parse } from 'node:path';
+import { homedir } from 'node:os';
+/** 单次列举上限：够翻一个源码目录，又不至于把响应体撑成几 MB。 */
+export const BROWSE_ENTRY_LIMIT = 500;
+/** 盘符/根探测的单项硬超时（ms）：断开的网络盘 stat 会长时间不返回。 */
+export const ROOT_PROBE_TIMEOUT_MS = 400;
+/** 带硬超时的 Promise（只为本模块的盘符探测服务；超时后原 promise 的迟到结果被丢弃）。 */
+function withDeadline(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { reject(new Error('timeout')); }, ms);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error); });
+    });
+}
+/** 一个路径是不是「根」（Windows 盘符根 / POSIX 的 `/`）。 */
+function isRoot(target) {
+    return parse(target).root === target;
+}
+/**
+ * 本机根列表：Windows 上是**探测得到的**盘符根（不硬编码 C:），其余平台是 `/`。
+ * 探测逐根 400ms 超时；全部失败时至少给出 `parse(process.cwd()).root`，界面不至于空成白板。
+ */
+export async function listRoots() {
+    if (process.platform !== 'win32') {
+        return [{ name: '/', path: '/', kind: 'dir' }];
+    }
+    const letters = 'CDEFGHIJKLMNOPQRSTUVWXYZAB'.split('');
+    const probed = await Promise.all(letters.map(async (letter) => {
+        const root = `${letter}:\\`;
+        try {
+            const info = await withDeadline(stat(root), ROOT_PROBE_TIMEOUT_MS);
+            return info.isDirectory() ? root : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    const roots = probed.filter((root) => root !== null);
+    const fallback = parse(process.cwd()).root;
+    const ordered = roots.length > 0 ? roots : (fallback === '' ? [] : [fallback]);
+    return ordered.map((root) => ({ name: root, path: root, kind: 'dir' }));
+}
+/** 文件系统错误 → 原因码（只有 ENOENT 才叫「不存在」）。 */
+function errorCodeOf(error) {
+    const code = error?.code;
+    if (code === 'ENOENT' || code === 'ENOTDIR')
+        return 'not-found';
+    if (code === 'EACCES' || code === 'EPERM')
+        return 'denied';
+    return 'failed';
+}
+/** 名字排序：目录在前、同类按名字字典序（不依赖 locale，测试可复现）。 */
+function compareEntries(a, b) {
+    if (a.kind !== b.kind)
+        return a.kind === 'dir' ? -1 : 1;
+    return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+}
+/**
+ * 列出一个目录（缺省 = 根列表）。
+ *
+ * `target` 缺省或空串 = 根列表；凡不是绝对路径一律 `not-absolute`（不猜基准目录 —— 猜错就列出别人的东西）。
+ * @param options.limit 覆盖 {@link BROWSE_ENTRY_LIMIT}。
+ */
+export async function browseDirectory(target, options) {
+    const limit = Math.max(1, Math.trunc(options?.limit ?? BROWSE_ENTRY_LIMIT));
+    const home = homedir();
+    const wanted = (target ?? '').trim();
+    if (wanted === '') {
+        const roots = await listRoots();
+        return { path: '', parent: null, home, entries: roots.slice(0, limit), truncated: roots.length > limit, error: null };
+    }
+    if (!parse(wanted).root) {
+        return { path: wanted, parent: null, home, entries: [], truncated: false, error: 'not-absolute' };
+    }
+    const current = parse(wanted).root === wanted ? wanted : wanted.replace(/[\\/]+$/, '');
+    let dirents;
+    try {
+        dirents = await readdir(current, { withFileTypes: true });
+    }
+    catch (error) {
+        return { path: current, parent: isRoot(current) ? null : dirname(current), home, entries: [], truncated: false, error: errorCodeOf(error) };
+    }
+    const entries = [];
+    for (const dirent of dirents) {
+        const entryPath = join(current, dirent.name);
+        if (dirent.isDirectory()) {
+            entries.push({ name: dirent.name, path: entryPath, kind: 'dir' });
+            continue;
+        }
+        if (dirent.isFile()) {
+            entries.push({ name: dirent.name, path: entryPath, kind: 'file' });
+            continue;
+        }
+        // 符号链接 / junction / 其它特殊项：跟随一次（读不到就整条丢掉，绝不猜类型）
+        try {
+            const info = await stat(entryPath);
+            if (info.isDirectory())
+                entries.push({ name: dirent.name, path: entryPath, kind: 'dir' });
+            else if (info.isFile())
+                entries.push({ name: dirent.name, path: entryPath, kind: 'file' });
+        }
+        catch {
+            // 断链：不展示（点了也进不去）
+        }
+    }
+    entries.sort(compareEntries);
+    return {
+        path: current,
+        parent: isRoot(current) ? null : dirname(current),
+        home,
+        entries: entries.slice(0, limit),
+        truncated: entries.length > limit,
+        error: null,
+    };
+}
+//# sourceMappingURL=path-browse.js.map

package/lib/foreign/claude-sessions.d.ts

@@ -37,7 +37,7 @@
  *  ③ **sessionId 不一致**：`input.recordSessionId` 存在且 ≠ `input.id` → 非致命发现
  *     `session-id-mismatch`（会话 id 仍以文件名 stem 为准，见 `TranscodeResult.findings`）。
  *  ④ **推理块**（Claude Code 的 `thinking` / `redacted_thinking`）：共享 IR 没有 reasoning
- *     承载位（docs/spec/known-gaps.md F-01）→ 计报 `thinking`，**绝不伪装成正文**；非 Claude 原生的
+ *     承载位（docs/maintenance/known-gaps.md F-01）→ 计报 `thinking`，**绝不伪装成正文**；非 Claude 原生的
  *     `{type:'reasoning',text:…}` 刻意保持既有口径（理由与切换方式见 `REASONING_BLOCK_TYPES`）。
  */
 import type { Stats } from 'node:fs';

package/lib/foreign/claude-sessions.js

@@ -28,7 +28,7 @@ function usageField(usage, key) {
  * 沿「对象带 text 才算文本」的兜底把它变成一个**空文本块** —— 内容静默丢失，且那个空块还会多插入
  * 一个换行。本仓其余 20+ 来源一律「推理不伪装成正文、只计数」（read-crush / read-opencode /
  * read-qwen / read-pi / read-openclaw …），这里对齐同一口径；共享 IR 无 reasoning 承载位这件事
- * 记在 docs/spec/known-gaps.md 的 F-01。
+ * 记在 docs/maintenance/known-gaps.md 的 F-01。
  *
  * **为什么不把 `{type:'reasoning', text:'…'}` 一并纳入**（如实记明，别当成漏掉）：
  *  ① Claude Code 不写这种块（它是别的导出器的归一命名，各来源自己的解析器已各自计报）；

package/lib/index.d.ts

@@ -77,7 +77,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.1.86";
+export declare const PLUGIN_VERSION = "0.2.1";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照
@@ -130,7 +130,7 @@ export interface Config {
 /**
  * 本文件保留的 7 条路由的路径（被源码级守卫按文件窗口钉住，见下方 routesList 注释）。
  *
- * 其余 75 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
+ * 其余 76 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
  * 新增一条 API 只需那一条声明，不再有「常量表 + 路由对象」两处要同步。
  */
 export declare const API: {

package/lib/index.js

@@ -136,7 +136,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.86';
+export const PLUGIN_VERSION = '0.2.1';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**
@@ -158,7 +158,7 @@ export const DEFAULT_GITHUB_CLIENT_ID = 'Ov23liq4i7n8UsylGRfb';
 /**
  * 本文件保留的 7 条路由的路径（被源码级守卫按文件窗口钉住，见下方 routesList 注释）。
  *
- * 其余 75 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
+ * 其余 76 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
  * 新增一条 API 只需那一条声明，不再有「常量表 + 路由对象」两处要同步。
  */
 export const API = {
@@ -3027,7 +3027,7 @@ function makeRoutes(deps) {
     /**
      * 路由表：本文件只保留被源码级守卫按**文件窗口**钉住的 7 条（host-entry 审计 F-04 记录的
      * tests/host/**、src/core/model-tools.test.ts、src/core/phase1-wiring.test.ts 的窗口断言）。
-     * 其余 75 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
+     * 其余 76 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
      * 注册顺序不影响匹配：命名路由必须互不相同（webServer 契约）。
      */
     const routeEnv = makeRouteEnv();

package/lib/market/security.js

@@ -102,7 +102,7 @@ export function validateMarketItem(itemId, manifestRaw, zipBytes) {
         if (!enabled)
             continue;
         // 市场条目禁止分区（BANNED_MARKET_SECTIONS：sessions 历史会话 / pluginFiles 任意文件 / self 本地环境）：
-        // 与 secrets 同级硬约束（产品决策 2026-08-19，guide docs/design/2026-08-19-market-repo-setup-guide.md）。
+        // 与 secrets 同级硬约束（产品决策 2026-08-19，guide docs/spec/market-index-v1.md）。
         if (BANNED_MARKET_SECTIONS.includes(sectionId)) {
             return { status: 'invalid', errors: [marketMsg('market.security.bannedSection', { section: sectionId })], warnings, manifest, internalManifest, sections: [], checksumsOk: true };
         }

package/lib/market/types.d.ts

@@ -26,7 +26,7 @@ export type MarketPublishMode = 'migrate' | 'share';
  */
 export declare const MAX_MARKET_ZIP_BYTES: number;
 /**
- * 市场条目禁止携带的分区（产品决策 2026-08-19，guide docs/design/2026-08-19-market-repo-setup-guide.md）：
+ * 市场条目禁止携带的分区（产品决策 2026-08-19，guide docs/spec/market-index-v1.md）：
  *  - sessions：历史会话，含个人交互记录/上下文；
  *  - pluginFiles：任意文件直通（目录放啥带啥），无内容过滤，最易泄漏 token/密钥文件；
  *  - self：本地环境专属（sync 通道 URL / WebDAV 地址 / 市场配置 / UI 偏好），无分享价值且泄漏环境信息。

package/lib/market/types.js

@@ -8,7 +8,7 @@ export const MARKET_ITEM_SCHEMA_VERSION = 1;
  */
 export const MAX_MARKET_ZIP_BYTES = 64 * 1024 * 1024;
 /**
- * 市场条目禁止携带的分区（产品决策 2026-08-19，guide docs/design/2026-08-19-market-repo-setup-guide.md）：
+ * 市场条目禁止携带的分区（产品决策 2026-08-19，guide docs/spec/market-index-v1.md）：
  *  - sessions：历史会话，含个人交互记录/上下文；
  *  - pluginFiles：任意文件直通（目录放啥带啥），无内容过滤，最易泄漏 token/密钥文件；
  *  - self：本地环境专属（sync 通道 URL / WebDAV 地址 / 市场配置 / UI 偏好），无分享价值且泄漏环境信息。

package/lib/routes/index.d.ts

@@ -3,7 +3,7 @@
  *
  * 顺序对匹配无影响：DSH webServer 的契约是「命名路由必须互不相同，注册顺序不影响请求」
  * （见 @deepseek-ai/dsh-host-webserver 的 WebServer 文档）。src/index.ts 保留的 7 条被源码级
- * 守卫按文件窗口钉住，其余 75 条在这里组装。
+ * 守卫按文件窗口钉住，其余 76 条在这里组装（总数 83：含 path-browse）。
  */
 import type { WebRoute } from './kit.ts';
 import type { RoutesEnv } from './context.ts';

package/lib/routes/index.js

@@ -11,6 +11,7 @@ import { meRoutes } from './me.js';
 import { historyRoutes } from './history.js';
 import { recoveryRoutes } from './recovery.js';
 import { sessionExportRoutes } from './session-export.js';
+import { pathBrowseRoutes } from './path-browse.js';
 export function buildRoutes(env) {
     return [
         ...importRoutes(env),
@@ -26,6 +27,7 @@ export function buildRoutes(env) {
         ...historyRoutes(env),
         ...recoveryRoutes(env),
         ...sessionExportRoutes(env),
+        ...pathBrowseRoutes(env),
     ];
 }
 //# sourceMappingURL=index.js.map

package/lib/routes/kit.d.ts

@@ -8,8 +8,8 @@
  * - 「每条路由首行 guard」这条安全不变量此前**只写在注释里**，零测试覆盖；
  * - 3 条 prefix 路由自造围栏（裸 isLoopbackRequest + 自判方法）。
  *
- * 计数口径（三路一致 = 82，勿再照抄旧审计初稿的计数 —— 那是计数口径 overcount）：
- *   路由快照 82 条 ＝ 现行 `endpoint()` 声明 82 条 ＝ 运行期 `buildRoutes()` 75 条 + `src/index.ts` 保留的 7 条。
+ * 计数口径（三路一致 = 83，勿再照抄旧审计初稿的计数 —— 那是计数口径 overcount）：
+ *   路由快照 83 条 ＝ 现行 `endpoint()` 声明 83 条 ＝ 运行期 `buildRoutes()` 76 条 + `src/index.ts` 保留的 7 条。
  * 增删路由后必须同步这段计数、`src/routes/index.ts` 的头注释与 parity 快照清单；`tests/route/route-parity.test.ts`
  * 的「路由计数散文」守卫会拿真实声明数逐条对账（写错即红灯）。
  *

package/lib/routes/path-browse.d.ts

@@ -0,0 +1,3 @@
+import type { WebRoute } from './kit.ts';
+import type { RoutesEnv } from './context.ts';
+export declare function pathBrowseRoutes(_env: RoutesEnv): WebRoute[];

package/lib/routes/path-browse.js

@@ -0,0 +1,63 @@
+/**
+ * 路由组：本机路径浏览（导入向导「路径映射」→ 选择本机路径弹窗的唯一数据源）。
+ *
+ * 为什么需要一条宿主路由：浏览器拿不到用户机器的真实目录树（File System Access API 只给 handle、
+ * `<input type="file">` 只给文件名），而路径映射要求为一堆绝对路径逐个指定本机新位置。
+ * 没有这条路由，用户只能凭记忆手打，打错就是「导不进」。
+ *
+ * 语义与边界
+ * ----------
+ * - **只读**：readdir/stat，绝不创建/改写/删除；不读文件内容；
+ * - POST 形态只**弹系统对话框**（core/native-path-picker.ts），同样不碰盘面；不可用时回
+ *   `reason:'unsupported'|'failed'`，客户端回落 GET 的内置浏览器 —— 对话框不是用户的操作死路；
+ * - 空 `path` = 「此电脑」根列表（Windows 盘符探测，见 core/path-browse.ts）；
+ * - 失败用枚举码回报（`error: 'not-found'|'denied'|'failed'|'not-absolute'`，成功为 null），
+ *   用户可见句子由客户端按字典解析 —— 引擎不写中文；
+ * - 有界：单次列举 500 条上限 + truncated 标记；整体套 withTimeout，不让一个 panic 盘符拖住请求。
+ */
+import { endpoint, errorMessage, queryParam, readJsonBody, writeJson } from './kit.js';
+import { browseDirectory } from '../core/path-browse.js';
+import { pickNativeDirectory } from '../core/native-path-picker.js';
+import { withTimeout } from './route-support.js';
+/** 单次列举的整体时限：正常目录远快于此；网络盘悬挂时宁可报错也不让请求挂着。 */
+const BROWSE_TIMEOUT_MS = 10_000;
+/** POST 可透传文本的长度上限：只用来当对话框的**起点**与**标题**，都不该是长文本。 */
+const PICK_TEXT_MAX = 512;
+/** 取请求体里的短文本字段：非字符串/空串/超长一律视为未提供（对话框走缺省值，不报错）。 */
+function pickText(body, key) {
+    const value = body?.[key];
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' || trimmed.length > PICK_TEXT_MAX ? undefined : trimmed;
+}
+export function pathBrowseRoutes(_env) {
+    return [
+        // ---------------------------------------------------- path-browse
+        // GET  ?path=<绝对路径>：列一层目录（目录在前）。path 缺省 = 根列表。
+        // POST { startPath?, title? }：弹**系统原生**目录选择器（Windows IFileOpenDialog / macOS
+        //      choose folder / Linux zenity·kdialog）。回 `{ ok:false, reason:'unsupported'|'failed' }`
+        //      时客户端回落到 GET 的内置浏览器 —— 同一条路径承载两种能力，避免为一个对话框新开一条路由。
+        //      标题由客户端按当前语言传进来（引擎不产中文）。
+        endpoint({ path: '/api/dsh-config-manager/path-browse', methods: ['GET', 'POST'] }, async (req, res) => {
+            if (req.method === 'POST') {
+                // 用户可能在系统对话框里逛几分钟 —— 时限由 core 的口子兜（10 分钟），此处不再叠加。
+                const body = await readJsonBody(req);
+                writeJson(res, 200, await pickNativeDirectory({
+                    startPath: pickText(body, 'startPath'),
+                    title: pickText(body, 'title'),
+                }));
+                return;
+            }
+            const url = new URL(req.url ?? '/', 'http://localhost');
+            try {
+                const result = await withTimeout(browseDirectory(queryParam(url, 'path')), BROWSE_TIMEOUT_MS, 'path browse timed out');
+                writeJson(res, 200, result);
+            }
+            catch (error) {
+                writeJson(res, 500, { error: errorMessage(error) });
+            }
+        }),
+    ];
+}
+//# sourceMappingURL=path-browse.js.map

package/lib/security/secret-scanner.js

@@ -72,7 +72,7 @@ const BEARER_TOKEN_CHARS = '[A-Za-z0-9._~+/=-]';
  * 于是 `bearer credentials are required` / `bearer authentication failed` / `BEARER HEADER NOT SET`
  * 这类纯小写或纯大写的英文词**不命中**；而 `bearer abc12345`、`BEARER AbCdEfGh`、`bearer <24+ 字符>` 命中。
  *
- * 已知残余（登记在 `docs/spec/known-gaps.md` G-36）：scheme 用非规范大小写**且** token 是 8–23 个**纯字母、
+ * 已知残余（登记在 `docs/maintenance/known-gaps.md` G-36）：scheme 用非规范大小写**且** token 是 8–23 个**纯字母、
  * 单一大小写**时本条不命中；规范 `Bearer …` 形态不受此限（上面那条 `bearer-token` 只要求 8+ 字符，行为不变）。
  */
 const BEARER_TOKEN_ANY_CASE = new RegExp(BEARER_SCHEME_ANY_CASE +

package/lib/ui/sync-settings-view.d.ts

@@ -511,4 +511,22 @@ export declare function workdirBacklog(workDir: {
     };
     error?: string;
 } | undefined): WorkdirBacklog;
+/**
+ * 「这一步该按哪个方向」—— 动作行只留一个 primary（issue 115：两个按钮并排、首次使用看不出该按哪个）。
+ *
+ * 判定只用**已确证**的远端事实，没证据就回落下行：一键同步先拉远端再三方合并、逐项确认，
+ * 不会拿本机默认值覆盖远端历史；上行推送才是产生新快照、改写远端历史的那个动作。
+ * 唯一让上行成为 primary 的情形是「远端确证零快照」（git 工作副本自检 remoteSnapshots === 0）：
+ * 此时同步无事可做，用户要的就是第一次备份。判定入口收在本函数里（channel 一并传入），
+ * 组件不用在调用点再判一次通道 —— 判据只有一处。
+ */
+export declare function pickSyncPrimary(statusInfo: {
+    workDir?: {
+        facts?: {
+            ahead?: number | null;
+            remoteSnapshots?: number | null;
+        };
+        error?: string;
+    };
+} | null | undefined, channel: string): 'push' | 'sync';
 export declare function formatSyncUrlPreview(url: string, max?: number): string;

package/lib/ui/sync-settings-view.js

@@ -562,6 +562,26 @@ export function workdirBacklog(workDir) {
         return { kind: 'never-synced', ahead };
     return { kind: 'ahead', ahead, remoteSnapshots };
 }
+/**
+ * 「这一步该按哪个方向」—— 动作行只留一个 primary（issue 115：两个按钮并排、首次使用看不出该按哪个）。
+ *
+ * 判定只用**已确证**的远端事实，没证据就回落下行：一键同步先拉远端再三方合并、逐项确认，
+ * 不会拿本机默认值覆盖远端历史；上行推送才是产生新快照、改写远端历史的那个动作。
+ * 唯一让上行成为 primary 的情形是「远端确证零快照」（git 工作副本自检 remoteSnapshots === 0）：
+ * 此时同步无事可做，用户要的就是第一次备份。判定入口收在本函数里（channel 一并传入），
+ * 组件不用在调用点再判一次通道 —— 判据只有一处。
+ */
+export function pickSyncPrimary(statusInfo, channel) {
+    // 只有 git 通道会做工作副本自检；别的通道没有这份事实，一律回落下行。
+    if (channel !== 'git')
+        return 'sync';
+    const backlog = workdirBacklog(statusInfo?.workDir);
+    if (backlog.kind === 'never-synced')
+        return 'push';
+    if (backlog.kind === 'clean' && backlog.remoteSnapshots === 0)
+        return 'push';
+    return 'sync';
+}
 export function formatSyncUrlPreview(url, max = 60) {
     return url.slice(0, max);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.1.86",
+  "version": "0.2.1",
   "license": "MIT",
   "description": "Backup, restore, export, import, migrate and sync your DeepSeek Harness (DSH) configuration: settings, plugins, MCP servers, skills, agent presets and workspaces. One-click migration to another machine. DSH 配置一键备份、恢复、导出、导入、迁移与同步插件。",
   "icon": "./icon.svg",
@@ -199,7 +199,7 @@
     "lightningcss": "1.33.0",
     "lucide": "^1.61.0",
     "lucide-react": "^1.61.0",
-    "morphicons": "^1.7.1",
+    "morphicons": "^2.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "schemastery": "^3.18.0",

package/src/adapters/self.test.ts

@@ -284,4 +284,58 @@ test('self: 运行态改写不改变分区 hash（自动同步不再每轮误判
   await src.fs.writeFile(rel, Buffer.from(config({ lastRunAt: '2026-10-25T12:02:00.000Z' }, 'https://y/repo.git'), 'utf8'));
   const third = await adapter.export(src, { includeSecrets: false });
   assert.notEqual(hashSection(third.data), hashSection(second.data), '真实配置变化必须让分区 hash 变化');
+});
+
+/**
+ * issue #119 回归：跳过码翻转不得改变分区 hash。
+ *
+ * 现场（0.2.0 / macOS desktop / git 通道 + 自动同步 60s 远端轮询）：配置一字未改，远端仓库
+ * 每分钟多 1~2 个 commit，15 分钟 24 个。根因 = 调度器「跳过」轮写
+ * lastRunSkipReason='upToDate'（冲突轮写 'conflict' + lastRunSkipCount），而「真推」轮收尾
+ * 又把它们清空（toChannelPayload 空值不写）；两个字段不在剔除表里 → self 分区 hash 每轮翻新
+ * → hasLocalChanges() 恒真 → 每轮都真推一个新快照。
+ */
+test('self: 跳过码翻转不改变分区 hash（issue #119：自动同步不再每轮真推快照）', async () => {
+  const rel = 'dsh-config-manager/sync/sync-autosync.json';
+  const src = makeContext('win32', 'C:\\Users\\alice');
+  const adapter = new SelfAdapter();
+  const config = (runState: Record<string, unknown>, repoUrl = 'https://x/repo.git') => JSON.stringify({
+    schemaVersion: 2,
+    channels: {
+      git: { enabled: true, intervalMinutes: 30, realtime: true, remoteCheckMs: 60000, repoUrl, branch: 'main', ...runState },
+      webdav: { enabled: false },
+    },
+  }, null, 2);
+
+  // 轮次 A：跳过（无本地改动）
+  await src.fs.writeFile(rel, Buffer.from(config({ lastRunAt: '2026-10-29T09:00:00.000Z', lastRunStatus: 'success', lastRunSkipReason: 'upToDate', consecutiveFailures: 0 }), 'utf8'));
+  const skipRound = await adapter.export(src, { includeSecrets: false });
+
+  // 轮次 B：真推一次 —— 跳过码被清空，其余与 A 相同
+  await src.fs.writeFile(rel, Buffer.from(config({ lastRunAt: '2026-10-29T09:01:00.000Z', lastRunStatus: 'success', consecutiveFailures: 0 }), 'utf8'));
+  const pushRound = await adapter.export(src, { includeSecrets: false });
+
+  // 轮次 C：跳过（冲突，带待确认分区数）
+  await src.fs.writeFile(rel, Buffer.from(config({ lastRunAt: '2026-10-29T09:02:00.000Z', lastRunStatus: 'success', lastRunSkipReason: 'conflict', lastRunSkipCount: 3, consecutiveFailures: 0 }), 'utf8'));
+  const conflictRound = await adapter.export(src, { includeSecrets: false });
+
+  const base = hashSection(skipRound.data);
+  assert.equal(hashSection(pushRound.data), base, '跳过码被清空不得改变分区 hash（否则每轮都判「本地有改动」）');
+  assert.equal(hashSection(conflictRound.data), base, '跳过码换值 / 带分区数不得改变分区 hash');
+
+  const payload = Buffer.from(pushRound.data.files.find((f) => f.relativePath === 'sync/sync-autosync.json')!.data).toString('utf8');
+  assert.ok(!payload.includes('lastRunSkip'), '导出载荷不含跳过码：远端不该接收本机执行记录');
+  assert.ok(payload.includes('"repoUrl":"https://x/repo.git"'), '配置本体仍在载荷里');
+
+  // 同一份远端载荷回灌本机（本机多出跳过码）→ Skip，不是 Conflict
+  const dst = makeContext('linux', '/home/bob');
+  await dst.fs.writeFile(rel, Buffer.from(config({ lastRunAt: '2026-10-29T09:05:00.000Z', lastRunStatus: 'success', lastRunSkipReason: 'upToDate' }), 'utf8'));
+  const sections = new Map([['self', pushRound.data]]);
+  let items = await adapter.analyzeImport(pushRound.data, makeImportContext(dst, sections));
+  assert.equal(items[0]?.kind, 'Skip', '仅跳过码不同 → Skip（此前每轮判 Conflict 并重复推送）');
+
+  // 配置本体变化仍必须被识别（不能把剔除做成「什么都判不变」）
+  await dst.fs.writeFile(rel, Buffer.from(config({ lastRunSkipReason: 'upToDate' }, 'https://y/repo.git'), 'utf8'));
+  items = await adapter.analyzeImport(pushRound.data, makeImportContext(dst, sections));
+  assert.equal(items[0]?.kind, 'Conflict', '真实配置变化必须仍判 Conflict');
 });

package/src/adapters/self.ts

@@ -45,6 +45,8 @@
  * 且文件类分区不进 SecretScanner（与 pluginFiles/skills 同语义）。
  */
 import type { HostContext } from '../core/types.ts';
+import type { AutosyncConfig } from '../sync/autosync-config.ts';
+import type { BackupScheduleConfig } from '../sync/backup-schedule-config.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
 import { sectionMeta } from '../schema/section-registry.ts';
 import { FileCollectionAdapter } from './file-collection.ts';
@@ -62,13 +64,48 @@ export const SELF_CONFIG_FILES: readonly string[] = [
   'exports/.backup-notes.json',
 ];
 
+/**
+ * 调度配置里「运行态字段」的**命名口径**：调度器每轮收尾都会改写的字段名形状
+ * （`lastRun*` 一族 + `consecutiveFailures`）。剔除表必须覆盖两个调度配置的并集，
+ * 少一个都会让 self 分区的 hashSection 每轮翻新（issue #119）。
+ */
+type RunStateKeyOf<T> = {
+  [K in keyof T]-?: K extends 'consecutiveFailures' | `lastRun${string}` ? K : never;
+}[keyof T];
+
+type SchedulerRunStateKey = RunStateKeyOf<AutosyncConfig> | RunStateKeyOf<BackupScheduleConfig>;
+
 /**
  * 调度配置里的**运行态字段**：每次执行收尾都会被调度器改写，不属于「配置身份」。
  * 仅比对时剔除（见 comparableContent）；写盘仍写完整文件。
+ *
+ * 逐项列全而不是靠前缀过滤：前缀过滤会把**将来**新增的运行态字段静默吞掉（看不见的假 Skip），
+ * 漏列则让 hash 每轮翻新（issue #119）。所以列全 + 下面的穷尽断言，让编译器守住漂移。
  */
-const VOLATILE_RUN_STATE_KEYS: ReadonlySet<string> = new Set([
-  'lastRunAt', 'lastRunStatus', 'lastRunMessage', 'lastRunHistoryId', 'consecutiveFailures',
-]);
+const VOLATILE_RUN_STATE_KEY_LIST = [
+  'lastRunAt',
+  'lastRunStatus',
+  'lastRunMessage',
+  'lastRunHistoryId',
+  'consecutiveFailures',
+  // issue #119：跳过码每轮在「写入 / 清空」之间翻转，与 lastRunAt 同性质，漏剔即每轮真推快照
+  'lastRunSkipReason',
+  'lastRunSkipCount',
+] as const satisfies readonly SchedulerRunStateKey[];
+
+const VOLATILE_RUN_STATE_KEYS: ReadonlySet<string> = new Set(VOLATILE_RUN_STATE_KEY_LIST);
+
+/**
+ * 编译期穷尽断言（零运行时开销）：`AutosyncConfig` / `BackupScheduleConfig` 将来新增任何
+ * `lastRun*` 字段而没进上表时，`Exclude` 不再是 `never`，**这一行 typecheck 报错**。
+ * 只写 `satisfies keyof T` 挡不住「新增字段忘了加」——那正是 issue #119 的失效模式。
+ */
+type AssertExhaustive<T extends never> = T;
+
+/** 见 AssertExhaustive 的注释；导出只为让断言参与类型检查（无需被引用）。 */
+export type SchedulerRunStateKeysExhaustive = AssertExhaustive<
+  Exclude<SchedulerRunStateKey, (typeof VOLATILE_RUN_STATE_KEY_LIST)[number]>
+>;
 
 /** 含运行态字段的调度配置（相对 baseDir）。 */
 const SCHEDULER_CONFIG_RELS: ReadonlySet<string> = new Set([

package/src/cli/web/page.ts

@@ -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 或留空。
@@ -32,7 +32,7 @@ export interface PageChrome {
 
 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)}',