dsh-config-manager 0.1.71 → 0.1.73

package/lib/profiles/dsh-profile-launcher.js

@@ -30,6 +30,7 @@ import { resolveDesktopCarrier } from '../utils/desktop-carrier.js';
 import { isRecord } from '../utils/guards.js';
 import { DshProfileError } from './dsh-profile-manager.js';
 import { readTextSafe, sanitizeFilePart } from './dsh-profile-io.js';
+import { profilesMsg } from './messages.js';
 import { resolveProcessControl, stopPid } from './process-control.js';
 import { DSH_PROFILE_LAUNCH_TIMEOUT_MS, isLaunchableShape, isManagedProfileName, } from './dsh-profile-shared.js';
 /** 实例记录文件名（`<dataDir>/launches.json`；机器本地状态，**不进备份/同步**）。 */
@@ -180,7 +181,7 @@ export class DshProfileLauncher {
         const rest = records.filter((r) => r.name !== name);
         const outcome = await stopPid(record.pid, this.proc);
         if (outcome === 'failed') {
-            throw new DshProfileError('stopFailed', 'stopFailed: pid ' + String(record.pid) + ' 仍在运行');
+            throw new DshProfileError('stopFailed', profilesMsg('profiles.stopFailed', { pid: record.pid }));
         }
         this.deps.writeState(serializeLaunches(rest));
         return { name, result: outcome, port: record.port };

package/lib/profiles/dsh-profile-runtime.js

@@ -21,6 +21,7 @@ import { join } from 'node:path';
 import { atomicWriteFileSync } from '../utils/atomic-write.js';
 import { readTextSafe, sanitizeFilePart } from './dsh-profile-io.js';
 import { DshProfileError } from './dsh-profile-manager.js';
+import { profilesMsg } from './messages.js';
 import { resolveProcessControl, stopPid } from './process-control.js';
 /** 心跳目录名（`<dataDir>/running`）。 */
 export const RUNTIME_DIR_NAME = 'running';
@@ -175,7 +176,7 @@ export class DshProfileRuntimeRegistry {
             throw new DshProfileError('currentProfile');
         const outcome = await stopPid(record.pid, this.proc);
         if (outcome === 'failed') {
-            throw new DshProfileError('stopFailed', `stopFailed: pid ${String(record.pid)} 仍在运行`);
+            throw new DshProfileError('stopFailed', profilesMsg('profiles.stopFailed', { pid: record.pid }));
         }
         rmSync(this.fileFor(name), { force: true });
         return { name, result: outcome, port: record.port ?? undefined };

package/lib/profiles/messages.d.ts

@@ -0,0 +1,7 @@
+import type { MsgParams } from '../core/msg-types.ts';
+export declare const zh: {
+    readonly 'profiles.stopFailed': 'stopFailed: pid {pid} 仍在运行';
+};
+export declare const en: Record<keyof typeof zh, string>;
+/** 本域翻译器：key 受目录约束（拼错键 = 编译错误），语言按 engineMsg 的活语言解析。 */
+export declare function profilesMsg(key: keyof typeof zh, params?: MsgParams): string;

package/lib/profiles/messages.js

@@ -0,0 +1,27 @@
+/**
+ * profiles 层的领域消息目录（zh 源 / en 镜像）—— 经 engineMsg 取「调用期」语言文案。
+ *
+ * 为什么是本域独立目录：src/profiles/** 的写作用域不含 src/core/messages.ts（既有键有冻结指纹），
+ * 所以本域的键用 registerMessageCatalog 在**模块加载时**注册进引擎目录，查找顺序见
+ * src/core/engine-locale.ts（基础目录 → 注册目录 → 键名）。
+ *
+ * 纪律（与 src/core/messages.ts 同口径）：
+ *  - zh 值 = 迁移前的既有中文文案**逐字不变**（既有测试断言依赖）；
+ *  - en 类型为 Record<keyof typeof zh, string> —— 缺键/多键即编译错误；
+ *  - {param} 插值与缺参保留由 engineMsg 负责；
+ *  - 只追加键，不改既有键。
+ */
+import { engineMsg, registerMessageCatalog } from '../core/engine-locale.js';
+export const zh = {
+    // ---------- 档案实例停止（dsh-profile-launcher.ts / dsh-profile-runtime.ts） ----------
+    'profiles.stopFailed': 'stopFailed: pid {pid} 仍在运行',
+};
+export const en = {
+    'profiles.stopFailed': 'stopFailed: pid {pid} is still running',
+};
+registerMessageCatalog({ id: 'profiles', zh, en });
+/** 本域翻译器：key 受目录约束（拼错键 = 编译错误），语言按 engineMsg 的活语言解析。 */
+export function profilesMsg(key, params) {
+    return engineMsg(key, params);
+}
+//# sourceMappingURL=messages.js.map

package/lib/routes/backup.js

@@ -13,7 +13,14 @@ import { MARKET_RETENTION_DEFAULT_MS, TMP_RETENTION_DEFAULT_MS, EXPORTS_RETENTIO
 import { scanDiskUsage } from '../core/disk-usage.js';
 import { validateBackupScheduleDraft } from '../ui/backup-schedule.js';
 import { join as joinPath } from 'node:path';
-/** 磁盘体检子区 → 物理目录（`$DSH_HOME/dsh-config-manager` 下的固定布局，单一映射点） */
+/**
+ * 磁盘体检子区 → 物理目录（`$DSH_HOME/dsh-config-manager` 下的固定布局，单一映射点）。
+ *
+ * 注意这里**没有** `rollback-points`：回滚点库与遗留 `checkpoints/` 的位置由 core 按
+ * `dataDir + ROLLBACK_POINTS_DIR`（与引擎常量逐字一致，有源码级守卫）与 `LEGACY_DATA_DIRS`
+ * 推导（见 `src/core/disk-usage.ts` 的 `diskUsageDirOf`）——宿主路由与离线 CLI 因此不可能
+ * 各写一份目录名而漂移。
+ */
 function diskUsageDirsOf(env) {
     const { dataDir, syncDir, marketDir, tmpDir, snapshotsDir, exportsDir } = env;
     return {
@@ -129,6 +136,12 @@ export function backupRoutes(env) {
         // ------------------------------------------------------- disk-usage（只读体检）
         // 界面「磁盘占用」卡的数据源：按子区回传字节数/文件数 + 各保留期的「已到期」量。
         // 零写入、零敏感（只有本机目录布局与体积）；子区读不到时如实标 unreadable（绝不显示 0 诱导）。
+        //
+        // 响应恒含两块**此前不可见**的占用（都是 protected，只报告、绝不进清理候选）：
+        //  ① report.areas['rollback-points']   回滚点库（dataDir/rollback-points，工作区+会话两态的恢复入口）；
+        //  ② report.legacy[]                   遗留数据（结构可容纳多条；当前一条 legacy-checkpoints =
+        //                                      旧 checkpoints/ 目录，插件已不再读取、也不代删）。
+        // 已超期/可回收字段只对 retained / regenerable 子区有值，这两块恒为空/undefined。
         endpoint({ path: '/api/dsh-config-manager/disk-usage', methods: ['GET'] }, async (_req, res) => {
             try {
                 writeJson(res, 200, { ok: true, report: await diskUsageReportOf(env) });
@@ -140,7 +153,10 @@ export function backupRoutes(env) {
         // ------------------------------------------------- disk-usage/cleanup（手动清理）
         // 缺省只清可重建的缓存/暂存（tmp + 市场缓存 + 市场工作副本，忽略保留期整块清）；
         // categories 可加入 'expired-exports'（只删已超保留期的导出产物，豁免定时备份）。
-        // **snapshots / sync 永不在候选集内**（用户数据与安全网）。走 mutation gate：同一时刻只允许一个写操作。
+        // **snapshots / sync 永不在候选集内**（用户数据与安全网）；**回滚点库
+        // （report.areas['rollback-points']）与遗留数据（report.legacy[]）同样永不进候选** ——
+        // 上面的 categories 白名单就是逐条判据（源级守卫见 src/core/disk-usage.test.ts）。
+        // 走 mutation gate：同一时刻只允许一个写操作。
         endpoint({ path: '/api/dsh-config-manager/disk-usage/cleanup', methods: ['POST'] }, withMutationGate('disk-usage-cleanup', async (req, res) => {
             try {
                 const body = await readJsonBody(req);

package/lib/routes/import.js

@@ -134,7 +134,7 @@ export function importRoutes(env) {
                     return;
                 }
                 if (!verified.ok || verified.info === null || verified.kdf === null) {
-                    writeJson(res, 400, { error: decryptErrorText(new SecurityError('BAD_PASSWORD', '解密认证失败'), msg) });
+                    writeJson(res, 400, { error: decryptErrorText(new SecurityError('BAD_PASSWORD', msg('route.decryptAuthFailed')), msg) });
                     return;
                 }
                 // 解密得到明文 ZIP（Security-sensitive transient：随机独占名 + 0600 + 先权限后写，用后即删）
@@ -307,8 +307,8 @@ export function importRoutes(env) {
                     snapshotId: result.snapshotId ?? undefined,
                     runId,
                     source: 'api',
-                    summary: `导入完成：${importSections.join(', ') || '无分区'}（执行 ${result.executed.length} 项）`,
-                    error: result.ok ? undefined : '导入未完全成功',
+                    summary: msg('route.importHistorySummary', { sections: importSections.join(', ') || msg('route.importNoSections'), count: result.executed.length }),
+                    error: result.ok ? undefined : msg('route.importIncomplete'),
                 });
                 writeJson(res, 200, historyError === undefined ? { ...result, runId } : { ...result, runId, historyWriteError: historyError });
             }

package/lib/routes/index.d.ts

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

package/lib/routes/kit.d.ts

@@ -9,7 +9,7 @@
  * - 3 条 prefix 路由自造围栏（裸 isLoopbackRequest + 自判方法）。
  *
  * 计数口径（三路一致 = 78，勿再照抄旧审计初稿的计数 —— 那是计数口径 overcount）：
- *   路由快照 78 条 ＝ 现行 `endpoint()` 声明 78 条 ＝ 运行期 `buildRoutes()` 71 条 + `src/index.ts` 保留的 7 条。
+ *   路由快照 79 条 ＝ 现行 `endpoint()` 声明 79 条 ＝ 运行期 `buildRoutes()` 72 条 + `src/index.ts` 保留的 7 条。
  * 增删路由后必须同步这段计数、`src/routes/index.ts` 的头注释与 parity 快照清单；`tests/route/route-parity.test.ts`
  * 的「路由计数散文」守卫会拿真实声明数逐条对账（写错即红灯）。
  *
@@ -17,7 +17,8 @@
  * 新增一条路由 = 在所属组文件里加一条 `endpoint({ path, methods, kind? }, handler)` 声明，
  * 围栏/方法/异常处理由 kit 统一提供，无需再写样板。
  *
- * 分层：本文件只依赖 node:http。WebRoute 刻意在本地结构化声明（与
+ * 分层：本文件依赖 node:http + `src/core/engine-locale.ts`（t6 起的引擎语言运行时：请求入口失效 +
+ * 注册点断言文案）。WebRoute 刻意在本地结构化声明（与
  * @deepseek-ai/dsh-host-webserver 的同名接口结构等价），因为架构边界测试规定
  * @deepseek-ai/* 只能出现在 src/index.ts 与 src/client/（见 tests/architecture-boundaries.test.ts）。
  */

package/lib/routes/kit.js

@@ -1,3 +1,5 @@
+import { invalidateEngineLocale } from '../core/engine-locale.js';
+import { engineMsg } from './messages.js';
 /** kit 产出的路由上挂的声明信息（供注册点兜底断言与 route-parity 测试读取）。 */
 export const ROUTE_SPEC = Symbol('dsh-config-manager.routeSpec');
 /* ------------------------------------------------------------------ 错误 */
@@ -121,6 +123,9 @@ export function endpoint(spec, handler) {
         kind: spec.kind ?? 'exact',
         path: spec.path,
         handler: async (req, res) => {
+            // 「英文界面零中文」（t6）：请求入口强制失效语言缓存 —— 用户切语言后**下一次请求**就必须拿到新语言。
+            // 不接也有 LANGUAGE_TTL_MS=1000 的兜底上界；TTL 只给调度器/后台任务这类非请求路径用。
+            invalidateEngineLocale();
             if (!isLoopbackRequest(req)) {
                 writeJsonError(res, 403, 'forbidden: loopback-only');
                 return;
@@ -161,7 +166,7 @@ export function registerRoutes(registry, routes) {
     return routes.map((route) => {
         const spec = routeSpecOf(route);
         if (spec === undefined) {
-            throw new Error(`路由 ${route.path} 未经 route kit 声明（endpoint()）——禁止裸 handler（安全不变量：围栏必须在注册点统一包装）`);
+            throw new Error(engineMsg('route.kitUnregistered', { path: route.path }));
         }
         return registry.register(route);
     });

package/lib/routes/market.js

@@ -157,7 +157,7 @@ export function marketRoutes(env) {
                 const downloadedAt = new Date().toISOString();
                 const warnings = manifest !== null
                     ? marketItemWarnings(manifest, sourceRepo, downloadedAt, msg)
-                    : [`条目 ${itemId} 来自公共网络市场，未经官方审核（供应链警示）`];
+                    : [msg('route.marketItemSupplyChainWarning', { id: itemId })];
                 const base = {
                     id: itemId,
                     name: manifest?.name ?? itemId,

package/lib/routes/messages.d.ts

@@ -0,0 +1,43 @@
+import type { MsgFunc } from '../core/msg-types.ts';
+export declare const zh: {
+    readonly 'route.kitUnregistered': '路由 {path} 未经 route kit 声明（endpoint()）——禁止裸 handler（安全不变量：围栏必须在注册点统一包装）';
+    readonly 'route.marketItemSupplyChainWarning': '条目 {id} 来自公共网络市场，未经官方审核（供应链警示）';
+    readonly 'route.decryptAuthFailed': '解密认证失败';
+    readonly 'route.importNoSections': '无分区';
+    readonly 'route.importHistorySummary': '导入完成：{sections}（执行 {count} 项）';
+    readonly 'route.importIncomplete': '导入未完全成功';
+    readonly 'route.profileLaunchSummary': '启动档案 {name}（独立实例 :{port}）';
+    readonly 'route.profileCreateSummary': '新建档案 {name}（模板 {template}）';
+    readonly 'route.profileCopySummary': '复制档案 {from} → {to}{suffix}';
+    readonly 'route.profileCopyNoNodeModules': '（未含 node_modules）';
+    readonly 'route.profileRenameSummary': '重命名档案 {from} → {to}';
+    readonly 'route.profileDeleteSummary': '删除档案 {name}（物理删除目录）';
+    readonly 'route.profileStopSummary': '停止档案 {name}（{kind}{port}）';
+    readonly 'route.profileStopOwned': '本插件启动的独立实例';
+    readonly 'route.profileStopExternal': '其他实例';
+    readonly 'route.snapshotRestoreSummary': '恢复快照 {id}：还原 {count} 项{suffix}';
+    readonly 'route.snapshotRestoreRemovedPluginsSuffix': '，卸载插件 {count}';
+    readonly 'route.snapshotDeleteSummary': '删除快照 {id}';
+    readonly 'route.syncPreviewFailed': '同步预览失败';
+    readonly 'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览';
+    readonly 'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）';
+    readonly 'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}';
+    readonly 'route.syncRollbackIncomplete': '（回滚未完成）';
+    readonly 'route.syncRolledBack': '（已回滚）';
+    readonly 'route.syncIneffectiveSuffix': '（{count} 项未生效）';
+    readonly 'route.syncApplyPartial': '同步应用部分成功：有项未生效（见告警明细）';
+    readonly 'route.syncApplyFailed': '同步应用未完全成功';
+    readonly 'route.syncRollbackSummary': '一键同步回滚（{id}）';
+    readonly 'route.recoverySessionRepairRollback': '会话修复回滚';
+    readonly 'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）';
+    readonly 'route.recoverySessionRepairRejected': '会话修复被拒绝：{reason}';
+    readonly 'route.recoverySessionLayoutApplied': '会话布局归位（搬运/隔离 {count} 条）';
+    readonly 'route.recoverySessionLayoutPartial': '会话布局归位未全部完成（成功 {applied}，失败 {failed}，跳过 {skipped}）';
+    readonly 'route.rollbackPointRewind': '回滚到回滚点：{outcome}';
+    readonly 'route.rollbackPointDelete': '删除回滚点 {id}';
+    readonly 'route.rollbackPointCleanup': '清理回滚点台账：删除 {records} 个点';
+    readonly 'route.recoveryOperationSummary': '恢复操作 {action}';
+};
+export declare const en: Record<keyof typeof zh, string>;
+/** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */
+export declare const engineMsg: MsgFunc;

package/lib/routes/messages.js

@@ -0,0 +1,102 @@
+/**
+ * routes 域（src/routes/**）的追加消息目录（zh 源 / en 镜像），归 t6 作用域。
+ *
+ * 为什么不在 \`src/core/messages.ts\` 追加：该文件不在本作用域的 inScope 内，且既有 372 键有冻结指纹。
+ * 本模块经 \`registerMessageCatalog\` 注册**追加目录**：engineMsg / makeMsg 的查找顺序是
+ * 「既有目录 → en 下回退既有 zh → 注册目录 → 键名」，所以本域新键只在既有目录未命中时生效，
+ * 不可能遮蔽 core 的既有 import.* / host.* 键。
+ *
+ * 纪律：zh 值 = 改动前的既有中文文案**逐字原样**（迁移历史 summary 的拼接顺序/空格/全角标点不变）；
+ * en 为 \`Record<keyof typeof zh, string>\`（缺键即编译错）。
+ * **导入 \`./kit.ts\` 即完成注册**（kit.ts import 本模块）：全部路由组都经 kit.ts 声明路由。
+ */
+import { engineMsg as engineMsgOf, registerMessageCatalog } from '../core/engine-locale.js';
+export const zh = {
+    // ---------- 注册点安全不变量 ----------
+    'route.kitUnregistered': '路由 {path} 未经 route kit 声明（endpoint()）——禁止裸 handler（安全不变量：围栏必须在注册点统一包装）',
+    // ---------- 市场 ----------
+    'route.marketItemSupplyChainWarning': '条目 {id} 来自公共网络市场，未经官方审核（供应链警示）',
+    // ---------- 导入 ----------
+    'route.decryptAuthFailed': '解密认证失败',
+    'route.importNoSections': '无分区',
+    'route.importHistorySummary': '导入完成：{sections}（执行 {count} 项）',
+    'route.importIncomplete': '导入未完全成功',
+    // ---------- 档案 ----------
+    'route.profileLaunchSummary': '启动档案 {name}（独立实例 :{port}）',
+    'route.profileCreateSummary': '新建档案 {name}（模板 {template}）',
+    'route.profileCopySummary': '复制档案 {from} → {to}{suffix}',
+    'route.profileCopyNoNodeModules': '（未含 node_modules）',
+    'route.profileRenameSummary': '重命名档案 {from} → {to}',
+    'route.profileDeleteSummary': '删除档案 {name}（物理删除目录）',
+    'route.profileStopSummary': '停止档案 {name}（{kind}{port}）',
+    'route.profileStopOwned': '本插件启动的独立实例',
+    'route.profileStopExternal': '其他实例',
+    // ---------- 快照 ----------
+    'route.snapshotRestoreSummary': '恢复快照 {id}：还原 {count} 项{suffix}',
+    'route.snapshotRestoreRemovedPluginsSuffix': '，卸载插件 {count}',
+    'route.snapshotDeleteSummary': '删除快照 {id}',
+    // ---------- 一键同步 ----------
+    'route.syncPreviewFailed': '同步预览失败',
+    'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览',
+    'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）',
+    'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}',
+    'route.syncRollbackIncomplete': '（回滚未完成）',
+    'route.syncRolledBack': '（已回滚）',
+    'route.syncIneffectiveSuffix': '（{count} 项未生效）',
+    'route.syncApplyPartial': '同步应用部分成功：有项未生效（见告警明细）',
+    'route.syncApplyFailed': '同步应用未完全成功',
+    'route.syncRollbackSummary': '一键同步回滚（{id}）',
+    // ---------- 事故恢复 ----------
+    'route.recoverySessionRepairRollback': '会话修复回滚',
+    'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）',
+    'route.recoverySessionRepairRejected': '会话修复被拒绝：{reason}',
+    'route.recoverySessionLayoutApplied': '会话布局归位（搬运/隔离 {count} 条）',
+    'route.recoverySessionLayoutPartial': '会话布局归位未全部完成（成功 {applied}，失败 {failed}，跳过 {skipped}）',
+    'route.rollbackPointRewind': '回滚到回滚点：{outcome}',
+    'route.rollbackPointDelete': '删除回滚点 {id}',
+    'route.rollbackPointCleanup': '清理回滚点台账：删除 {records} 个点',
+    'route.recoveryOperationSummary': '恢复操作 {action}',
+};
+export const en = {
+    'route.kitUnregistered': 'Route {path} was not declared through the route kit (endpoint()) — bare handlers are forbidden (safety invariant: the fence must be wrapped at the registration point)',
+    'route.marketItemSupplyChainWarning': 'Item {id} comes from a public community marketplace and is not officially reviewed (supply-chain warning)',
+    'route.decryptAuthFailed': 'Decryption authentication failed',
+    'route.importNoSections': 'no sections',
+    'route.importHistorySummary': 'Import finished: {sections} ({count} item(s) executed)',
+    'route.importIncomplete': 'Import did not fully succeed',
+    'route.profileLaunchSummary': 'Launched profile {name} (separate instance :{port})',
+    'route.profileCreateSummary': 'Created profile {name} (template {template})',
+    'route.profileCopySummary': 'Copied profile {from} → {to}{suffix}',
+    'route.profileCopyNoNodeModules': ' (node_modules excluded)',
+    'route.profileRenameSummary': 'Renamed profile {from} → {to}',
+    'route.profileDeleteSummary': 'Deleted profile {name} (directory physically removed)',
+    'route.profileStopSummary': 'Stopped profile {name} ({kind}{port})',
+    'route.profileStopOwned': 'separate instance launched by this plugin',
+    'route.profileStopExternal': 'other instance',
+    'route.snapshotRestoreSummary': 'Restored snapshot {id}: {count} item(s) restored{suffix}',
+    'route.snapshotRestoreRemovedPluginsSuffix': ', {count} plugin(s) uninstalled',
+    'route.snapshotDeleteSummary': 'Deleted snapshot {id}',
+    'route.syncPreviewFailed': 'Sync preview failed',
+    'route.syncSessionExpired': 'The sync session does not exist or has expired; pull a fresh preview',
+    'route.syncConflictResolutionRequired': 'Conflict item {id} must provide a resolution (useRemote/keepLocal/skip)',
+    'route.syncApplySummary': 'One-click sync apply: {count} item(s){status}{ineffective}',
+    'route.syncRollbackIncomplete': ' (rollback incomplete)',
+    'route.syncRolledBack': ' (rolled back)',
+    'route.syncIneffectiveSuffix': ' ({count} item(s) had no effect)',
+    'route.syncApplyPartial': 'Sync apply partially succeeded: some items had no effect (see the warning details)',
+    'route.syncApplyFailed': 'Sync apply did not fully succeed',
+    'route.syncRollbackSummary': 'One-click sync rollback ({id})',
+    'route.recoverySessionRepairRollback': 'Session repair rollback',
+    'route.recoverySessionRepairDropped': 'Session repair (dropped {count} replayed duplicate row(s))',
+    'route.recoverySessionRepairRejected': 'Session repair was rejected: {reason}',
+    'route.recoverySessionLayoutApplied': 'Session layout relocation ({count} item(s) moved/quarantined)',
+    'route.recoverySessionLayoutPartial': 'Session layout relocation did not fully complete ({applied} succeeded, {failed} failed, {skipped} skipped)',
+    'route.rollbackPointRewind': 'Rewind to rollback point: {outcome}',
+    'route.rollbackPointDelete': 'Deleted rollback point {id}',
+    'route.rollbackPointCleanup': 'Cleaned up rollback-point ledger: {records} point(s) deleted',
+    'route.recoveryOperationSummary': 'Recovery operation {action}',
+};
+registerMessageCatalog({ id: 'routes-domain', zh, en });
+/** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */
+export const engineMsg = engineMsgOf;
+//# sourceMappingURL=messages.js.map

package/lib/routes/prefs.js

@@ -7,11 +7,30 @@
  * path/methods 就是唯一声明处；围栏、方法判定与顶层异常处理由 src/routes/kit.ts 在注册点统一提供。
  */
 import { endpoint, requireJsonObject, writeJson } from './kit.js';
+import { EnvironmentLockUnavailableError, runWithMutationLock } from '../utils/env-lock.js';
 import { PLUGIN_VERSION, STAR_PROMPT_REPO_URL } from '../index.js';
 import { readUiPrefs, updateUiPrefs } from '../sync/ui-prefs.js';
 import { UpdateChecker, wantsForcedUpdateCheck } from '../core/update-check.js';
 export function prefsRoutes(env) {
-    const { syncDir, selfUpdate, withMutationGate, } = env;
+    const { host, syncDir, selfUpdate, withMutationGate, } = env;
+    /**
+     * 偏好写必须与其它写路径**同门**（④A）：ui-prefs.json 由 star-prompt / release-notes-prompt /
+     * 回滚开关三个端点共写。`updateUiPrefs` 虽是 read→merge→write，但两个端点**并发**时仍会互相覆盖
+     * 字段（典型：刚打开的 rollbackEnabled 被另一个端点的旧快照抹掉 ⇒ 重启后功能自己关掉，fail-closed）。
+     * 被 SAFE MODE / 环境锁挡住时直接回 423 并返回 null（调用方 return，零写入）。
+     */
+    const writePrefsOrBlocked = async (res, patch) => {
+        try {
+            return await runWithMutationLock(host.mutationLock, { op: 'ui-prefs', target: 'star/release-notes', isBlocked: () => host.safeModeIsBlocked?.() ?? false }, async () => await updateUiPrefs(syncDir, patch));
+        }
+        catch (error) {
+            if (error instanceof EnvironmentLockUnavailableError) {
+                writeJson(res, 423, { error: error.message, code: 'mutation-locked' });
+                return null;
+            }
+            throw error;
+        }
+    };
     // 版本更新检查器：每进程一个（进程内缓存 10 分钟；用户点「重新检查」走 ?force=1）。
     // 网络失败/超时/响应畸形一律结构化回传（ok:false + 原因），绝不「失败当最新」。
     const updateChecker = new UpdateChecker(PLUGIN_VERSION);
@@ -51,7 +70,9 @@ export function prefsRoutes(env) {
                 if (body['clicked'] === true) {
                     patch['starPromptClicked'] = true;
                 }
-                const next = await updateUiPrefs(syncDir, patch);
+                const next = await writePrefsOrBlocked(res, patch);
+                if (next === null)
+                    return;
                 writeJson(res, 200, {
                     ok: true,
                     firstSeenAt: next.starPromptFirstSeenAt,
@@ -93,7 +114,9 @@ export function prefsRoutes(env) {
                 if (body['dismissed'] === true) {
                     patch['releaseNotesDismissed'] = true;
                 }
-                const next = await updateUiPrefs(syncDir, patch);
+                const next = await writePrefsOrBlocked(res, patch);
+                if (next === null)
+                    return;
                 writeJson(res, 200, {
                     ok: true,
                     lastSeenVersion: next.releaseNotesLastSeenVersion,

package/lib/routes/profiles.js

@@ -5,6 +5,8 @@
  * path/methods 就是唯一声明处；围栏、方法判定与顶层异常处理由 src/routes/kit.ts 在注册点统一提供。
  */
 import { endpoint, requireJsonObject, writeJson, queryParam } from './kit.js';
+// t6：「英文界面零中文」——迁移历史 summary 一律由目录键产生（engineMsg 与宿主 msg 同源，且是活翻译器）。
+import { engineMsg } from './messages.js';
 import { writeProfileError } from '../index.js';
 import { DSH_PROFILE_TEMPLATES, DshProfileError } from '../profiles/index.js';
 export function profileRoutes(env) {
@@ -94,7 +96,7 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [name],
                     source: 'api',
-                    summary: `启动档案 ${name}（独立实例 :${String(launch.port)}）`,
+                    summary: engineMsg('route.profileLaunchSummary', { name, port: String(launch.port) }),
                 });
                 const running = runningView();
                 writeJson(res, 200, historyError === undefined ? { ok: true, launch, running } : { ok: true, launch, running, historyWriteError: historyError });
@@ -127,7 +129,7 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [meta.name],
                     source: 'api',
-                    summary: `新建档案 ${meta.name}（模板 ${template}）`,
+                    summary: engineMsg('route.profileCreateSummary', { name: meta.name, template }),
                 });
                 writeJson(res, 200, historyError === undefined ? { ok: true, profile: meta } : { ok: true, profile: meta, historyWriteError: historyError });
             }
@@ -167,7 +169,7 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [meta.name],
                     source: 'api',
-                    summary: `复制档案 ${name} → ${meta.name}${meta.hasNodeModules ? '' : '（未含 node_modules）'}`,
+                    summary: engineMsg('route.profileCopySummary', { from: name, to: meta.name, suffix: meta.hasNodeModules ? '' : engineMsg('route.profileCopyNoNodeModules') }),
                 });
                 writeJson(res, 200, historyError === undefined
                     ? { ok: true, profile: meta, copy }
@@ -188,7 +190,7 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [name],
                     source: 'api',
-                    summary: `重命名档案 ${name} → ${newName}`,
+                    summary: engineMsg('route.profileRenameSummary', { from: name, to: newName }),
                 });
                 writeJson(res, 200, historyError === undefined ? { ok: true, profile: meta } : { ok: true, profile: meta, historyWriteError: historyError });
             }
@@ -211,7 +213,7 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [name],
                     source: 'api',
-                    summary: `删除档案 ${name}（物理删除目录）`,
+                    summary: engineMsg('route.profileDeleteSummary', { name }),
                 });
                 writeJson(res, 200, historyError === undefined ? { ok: true } : { ok: true, historyWriteError: historyError });
             }
@@ -238,7 +240,11 @@ export function profileRoutes(env) {
                     result: 'success',
                     sections: [name],
                     source: 'api',
-                    summary: `停止档案 ${name}（${owned ? '本插件启动的独立实例' : '其他实例'}${stopped.port !== undefined ? ` :${String(stopped.port)}` : ''}）`,
+                    summary: engineMsg('route.profileStopSummary', {
+                        name,
+                        kind: owned ? engineMsg('route.profileStopOwned') : engineMsg('route.profileStopExternal'),
+                        port: stopped.port !== undefined ? ` :${String(stopped.port)}` : '',
+                    }),
                 });
                 const running = runningView();
                 writeJson(res, 200, historyError === undefined ? { ok: true, stopped, running } : { ok: true, stopped, running, historyWriteError: historyError });

package/lib/routes/recovery.d.ts

@@ -6,4 +6,25 @@
  */
 import type { WebRoute } from './kit.ts';
 import type { RoutesEnv } from './context.ts';
+import type { RollbackPreviewResult, RollbackRewindResult } from '../core/rollback-point.ts';
+/**
+ * t8 的硬拒**什么时候该生效**（判定链里的位置，t8 实现说明的选项 ②）。
+ *
+ * 既有护栏**优先**：确认门没开（`userConfirmed !== true`）、该点本来就不可回退
+ * （`preview.ok !== true || preview.canRestore !== true`：protected / record-incomplete /
+ * 记录不存在 / 存储不可用）、或 SAFE MODE 正拦着（由锁门给 423）时，**把结论让给引擎自己的
+ * 结构化拒绝** —— 那些情形下说「对话正在运行」是误导：用户等多久都退不了。
+ * 只有「这次本来能退、只是因为它正在运行而不能动工作区」时，才用 `session-active`。
+ *
+ * 两道门（R1 预检 / R2 锁内二道保险）共用这一份判据，绝不各写一套。
+ */
+export declare function sessionActiveGateApplies(preview: RollbackPreviewResult, userConfirmed: boolean, safeModeBlocked: boolean): boolean;
+/**
+ * 运行中对话的拒绝结果（t8）：**形状与引擎的 rewind 结果同构**，两处（路由预检 / 锁内二道保险）
+ * 共用一份，界面照常走「结果 → 文案」那条链。`segments` 恒为空 = 一段都没动（零写入）。
+ *
+ * 判据来源只有一个：**preview 已算出的 `session.active`**（引擎按会话日志 mtime 静默窗算）——
+ * 路由**绝不自己 stat 会话日志**（那会变成第二份判据，两处迟早漂移）。
+ */
+export declare function sessionActiveDenied(id: string, preview: RollbackPreviewResult): RollbackRewindResult;
 export declare function recoveryRoutes(env: RoutesEnv): WebRoute[];