dsh-config-manager 0.1.79 → 0.1.81

package/lib/cli/actions.d.ts

@@ -142,6 +142,11 @@ export interface RescueStatus {
 /** 首页聚合：每一项各自 try/catch，缺一项不影响其余（但失败必须在 errors 里可见）。 */
 export declare function readRescueStatus(paths: RescuePaths, now?: () => Date): Promise<RescueStatus>;
 export type WriteRefusalCode = 'safe-mode' | 'stale-lock' | 'dsh-running' | 'nothing-to-do' | 'io-error';
+/**
+ * SAFE MODE 拒因码的**单点常量**：`src/cli/index.ts` 的源码守卫（P0-11-07）禁止
+ * CLI 自带 `'safe-mode'` 字面量，判据必须复用本常量（否则改一处漏一处）。
+ */
+export declare const SAFE_MODE_REFUSAL_CODE: WriteRefusalCode;
 export interface WriteGateRefusal {
     ok: false;
     code: WriteRefusalCode;

package/lib/cli/actions.js

@@ -279,6 +279,11 @@ export async function readRescueStatus(paths, now = () => new Date()) {
 function errorText(error) {
     return error instanceof Error ? error.message : String(error);
 }
+/**
+ * SAFE MODE 拒因码的**单点常量**：`src/cli/index.ts` 的源码守卫（P0-11-07）禁止
+ * CLI 自带 `'safe-mode'` 字面量，判据必须复用本常量（否则改一处漏一处）。
+ */
+export const SAFE_MODE_REFUSAL_CODE = 'safe-mode';
 /**
  * 写动作的前置门（与 CLI `sessions repair --fix` 同一判据）。
  *

package/lib/cli/index.js

@@ -30,7 +30,7 @@ import { runSessionsRepair } from './sessions-repair.js';
 import { runSessionsInspect } from './sessions-inspect.js';
 import { runImportSource } from './import-source.js';
 import { renderCommandHelp, renderOverview } from './help.js';
-import { collectVerifyResults, readRunningInstances } from './actions.js';
+import { checkWriteGates, collectVerifyResults, readRunningInstances, SAFE_MODE_REFUSAL_CODE } from './actions.js';
 import { Phase3Recovery, readSafeModeMarkerSync, safeModeMarkerPath } from '../core/phase3-host.js';
 import { verifyBackupZip, } from '../core/backup-verify.js';
 import { collectBackupEntries, buildSectionFlags, parseSectionsArg, OFFLINE_UNAVAILABLE_SECTIONS, } from '../core/backup-plan.js';
@@ -853,19 +853,33 @@ export async function runCli(argv, io = defaultIo, env = process.env, deps = {})
         }, io, env);
     }
     if (options.command === 'sessions') {
-        // 离线修复：不碰 $DSH_HOME 的其它部分、不需要环境锁（只读写会话目录，且默认 dry-run）
+        // 离线修复：只读写会话目录，默认 dry-run（零写入）。list/doctor 纯只读，连「DSH 在跑」都不用管。
+        // **--fix 走与救急台完全相同的写入门**（actions.ts 的 checkWriteGates，顺序 SAFE MODE → 残留环境锁 → DSH 未运行）：
+        // 此前这里只查「DSH 在跑」，于是 SAFE MODE 激活 / 残留环境锁时 CLI 仍能改写会话字节 —— 与救急台判据分叉（审计 P1）。
         const home = options.home ?? resolveDshHome(env);
         const action = options.positionals[0] ?? 'repair';
         // T6：list / doctor 是**只读**动作 —— 不检查「DSH 是否在跑」，因为读永远不会伤害运行中的实例。
         if (action === 'list' || action === 'doctor') {
             return runSessionsInspect({ home, action: action === 'doctor' ? 'doctor' : 'list', json: options.json }, io);
         }
-        // T6：repair（含 --fix/--apply）先跑安全修复计划；**写操作前必须确认 DSH 没在跑**。
+        // T6：repair（含 --fix/--apply）先跑安全修复计划；写操作前三道门与救急台逐条同源。
         if (options.fix === true) {
-            const running = (await readRunningInstances(resolveControlRoots({ dataRoot: options.dataRoot, dataDir: options.dataDir }, env))).map((instance) => instance.name);
-            if (running.length > 0) {
-                io.error('检测到 DSH 正在运行（' + running.join(', ') + '）：请先关闭 DSH 再执行修复。');
-                io.error('DSH running (' + running.join(', ') + '): close DSH before repairing session bytes.');
+            const controlOpts = { dataRoot: options.dataRoot, dataDir: options.dataDir };
+            const gate = await checkWriteGates(resolveControlRoots(controlOpts, env), {
+                needsDshStopped: true,
+                locksDir: resolveRecoverLocksDir(controlOpts, env),
+            });
+            if (!gate.ok) {
+                io.error('拒绝执行：' + gate.reason);
+                if (gate.code === 'dsh-running') {
+                    io.error('DSH running: close DSH before repairing session bytes.');
+                }
+                else if (gate.code === SAFE_MODE_REFUSAL_CODE) {
+                    io.error('SAFE MODE is active: resolve the pending transaction before writing session bytes.');
+                }
+                else if (gate.code === 'stale-lock') {
+                    io.error('A stale environment lock is present: run "dsh-config-manager recover-stale-lock" first.');
+                }
                 return 1;
             }
         }

package/lib/client.d.ts

@@ -1546,6 +1546,7 @@ declare const uiZh: {
   readonly 'report.unit.notes': '条说明';
   readonly 'report.action.done': '完成';
   readonly 'error.notMounted': 'config-manager 服务未挂载（插件未加载）：请确认 profile 中已安装 dsh-config-manager 并重启 DSH';
+  readonly 'error.apiPathMissed': '接口路径未命中（HTTP {status}）：请求前缀为 {base}，但该路径没有返回 JSON —— 若你经反向代理挂在子路径下，请检查代理是否转发了这个前缀（issue #108）';
   readonly 'error.httpInvalidJson': 'HTTP {status}: 无效的 JSON 响应';
   readonly 'error.fallback': '操作失败';
   readonly 'error.requestTimeout': '请求超时（{seconds} 秒）：未在时限内收到宿主响应，请重试';