dsh-config-manager 0.2.2 → 0.2.4

package/lib/core/messages-core.js

@@ -53,7 +53,7 @@ export const zh = {
     'core.journal.notTerminal': 'moveToCompleted 仅接受 terminal journal: {opId} state={state}',
     // ---------- run-registry ----------
     'core.run.autosyncBusy': '自动同步已在进行中',
-    'core.run.syncApplyBusy': '一键同步已在进行中',
+    'core.run.syncApplyBusy': '正在从远端合并',
     'core.run.backupScheduleBusy': '定时备份已在进行中',
     'core.run.restoreBusy': '快照恢复已在进行中（请等待当前恢复完成）',
     'core.run.recoveryBusy': '恢复/回滚已在进行中（请等待当前恢复完成）',
@@ -349,7 +349,7 @@ export const en = {
     'core.journal.notTerminal': 'moveToCompleted only accepts a terminal journal: {opId} state={state}',
     // ---------- run-registry ----------
     'core.run.autosyncBusy': 'Automatic sync is already in progress',
-    'core.run.syncApplyBusy': 'One-click sync is already in progress',
+    'core.run.syncApplyBusy': 'Merge from remote is already in progress',
     'core.run.backupScheduleBusy': 'Scheduled backup is already in progress',
     'core.run.restoreBusy': 'Snapshot restore is already in progress (wait for the current restore to finish)',
     'core.run.recoveryBusy': 'Recovery/rollback is already in progress (wait for the current recovery to finish)',

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.2.2";
+export declare const PLUGIN_VERSION = "0.2.4";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照

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.2.2';
+export const PLUGIN_VERSION = '0.2.4';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**

package/lib/routes/messages.d.ts

@@ -21,13 +21,13 @@ export declare const zh: {
     readonly 'route.syncPreviewFailed': '同步预览失败';
     readonly 'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览';
     readonly 'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）';
-    readonly 'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}';
+    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.syncRollbackSummary': '从远端合并回滚（{id}）';
     readonly 'route.recoverySessionRepairRollback': '会话修复回滚';
     readonly 'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）';
     readonly 'route.recoverySessionRepairRejected': '会话修复被拒绝：{reason}';

package/lib/routes/messages.js

@@ -39,13 +39,13 @@ export const zh = {
     'route.syncPreviewFailed': '同步预览失败',
     'route.syncSessionExpired': '同步会话不存在或已过期，请重新拉取预览',
     'route.syncConflictResolutionRequired': '冲突项 {id} 必须提供 resolution（useRemote/keepLocal/skip）',
-    'route.syncApplySummary': '一键同步应用：{count} 项{status}{ineffective}',
+    'route.syncApplySummary': '从远端合并：{count} 项{status}{ineffective}',
     'route.syncRollbackIncomplete': '（回滚未完成）',
     'route.syncRolledBack': '（已回滚）',
     'route.syncIneffectiveSuffix': '（{count} 项未生效）',
     'route.syncApplyPartial': '同步应用部分成功：有项未生效（见告警明细）',
     'route.syncApplyFailed': '同步应用未完全成功',
-    'route.syncRollbackSummary': '一键同步回滚（{id}）',
+    'route.syncRollbackSummary': '从远端合并回滚（{id}）',
     // ---------- 事故恢复 ----------
     'route.recoverySessionRepairRollback': '会话修复回滚',
     'route.recoverySessionRepairDropped': '会话修复（丢弃重放重复行 {count} 行）',
@@ -79,13 +79,13 @@ export const en = {
     '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.syncApplySummary': 'Merge from remote: {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.syncRollbackSummary': 'Merge from remote rollback ({id})',
     'route.recoverySessionRepairRollback': 'Session repair rollback',
     'route.recoverySessionRepairDropped': 'Session repair (dropped {count} replayed duplicate row(s))',
     'route.recoverySessionRepairRejected': 'Session repair was rejected: {reason}',

package/lib/sync/git/git-transport.d.ts

@@ -7,7 +7,7 @@ export interface GitExecResult {
     stderr: string;
     code: number;
 }
-/** 可注入的 git 执行器（测试 mock 用）；默认实现 = child_process.execFile promise 封装 */
+/** 可注入的 git 执行器（测试 mock 用）；默认实现 = child_process.spawn promise 封装（超时杀进程树） */
 export type GitExecFn = (cmd: string, args: string[], opts: {
     cwd?: string;
     timeoutMs?: number;
@@ -59,7 +59,7 @@ export interface GitTransportOptions {
     timeoutMs?: number;
     /** 幂等读操作（list/download 的 clone/pull）的网络重试参数；缺省 attempts=3、250ms 起指数退避 */
     retry?: SyncRetryOptions;
-    /** 注入 exec（测试 mock 用）；缺省 = execFile 封装 */
+    /** 注入 exec（测试 mock 用）；缺省 = spawn 封装（超时杀进程树） */
     exec?: GitExecFn;
     /** 提交作者（写入远端历史），默认 DSH Config Sync <sync@dsh.local> */
     author?: GitAuthor;
@@ -75,11 +75,26 @@ export interface GitTransportOptions {
 export declare class GitTransportError extends SyncTransportError {
     constructor(message: string, opts?: SyncTransportErrorOptions);
 }
+/**
+ * 默认 git 执行器：spawn + **进程树** kill（issue #122）。
+ *
+ * 为什么不再用 execFile：它的 timeout 只对 git.exe 自己发 SIGTERM，而真正在下包的是 git.exe 的子进程
+ * （git-remote-https / git index-pack）。父进程被杀、孙进程继续写 tmp_pack_*，管道不关闭 ⇒ execFile 的
+ * promise 连超时错误都可能不返回 ⇒ 上层「正在检查远端变更...」永久挂起，下一轮重试再起一份，最终 N 份
+ * 并发下载同一个 pack。
+ * 这里改为：POSIX 上 detached 起独立进程组，超时对**整组**发 SIGKILL；Windows 上 `taskkill /T /F`；
+ * 无论 kill 是否成功，宽限期到点都带着已收集输出收尾 —— 绝不把「管道没关」变成上层无限等待。
+ *
+ * 导出仅供测试直接验证「超时 + 进程树 kill + 有界收尾」（issue #122 的验收面）。
+ */
+export declare const defaultGitExec: GitExecFn;
 /** 实现 SyncTransport 的 git 通道。所有操作前 ensureRepo() 保证工作副本就绪，网络命令带凭据。 */
 export declare class GitTransport implements SyncTransport {
     readonly type = "git";
     private readonly o;
     private repoReady;
+    /** 该工作副本是否 partial clone（remote.origin.promisor）；null = 尚未判定（issue #122） */
+    private partialClone;
     /**
      * 工作副本锁的可重入深度：list/upload/download/delete 都会经 ensureRepo → reconcileOrigin，
      * rebuildWorkDir → adoptRemoteHistory 也各自嵌套；外层入口持锁，内层直接跑。
@@ -151,6 +166,30 @@ export declare class GitTransport implements SyncTransport {
      */
     private withWorkdir;
     private ensureRepo;
+    /**
+     * 首次 clone（issue #122）：partial clone + sparse-checkout，只落地同步内容。
+     *
+     * 为什么：同步仓库可能比同步内容大几个数量级（报告者现场 1.8 GB 仓库 / 6 MB 内容）。此前 `git clone`
+     * 全量落地，之后每次 fetch 还要拉完整对象图 ⇒ 一次「检查远端变更」就下几百 MB。
+     * `--filter=blob:none` 只取 commit+tree，`--no-checkout` 先不落地任何文件，
+     * `sparse-checkout set --cone <三个目录>` 之后 checkout 只 materialize 这三个目录的 blob。
+     *
+     * 老 git 不认这些选项（unknown option）时回落全量 clone —— 行为与修复前完全一致，绝不因优化失败。
+     */
+    private cloneIntoWorkDir;
+    /**
+     * 该工作副本是不是 partial clone（`remote.origin.promisor=true`）。
+     *
+     * 只有 partial clone 才能给 fetch 加 `--filter=blob:none`：对普通全量副本加过滤会让后续 checkout
+     * 拿到缺失的 blob。存量副本（1.8 GB 那种）因此只受益于 ls-remote 短路与 `--no-tags`，不会被改坏。
+     */
+    private isPartialClone;
+    /** 拉取姿态：partial clone 保持 blob 过滤；同步仓库不需要 tag（issue #122） */
+    private fetchOptionFlags;
+    /** 远端分支当前的 sha（ls-remote 只取一行 refs）；读不到 → null（短路是优化，失败一律回落正常 fetch） */
+    private lsRemoteBranchSha;
+    /** 解析引用指向的 sha；读不到 / 不是 sha → null */
+    private revParseSha;
     /**
      * 让工作副本的 origin 与配置的 repoUrl 保持一致（issue #79）。
      *
@@ -229,6 +268,11 @@ export declare class GitTransport implements SyncTransport {
      * 还会在本地留下一个已提交却推不上去的快照。
      */
     private runGit;
+    /**
+     * 把「git 退出非零」归一成可操作错误（runGit 与 clone 回落共用同一套文案与分类）。
+     * token 只用于脱敏，绝不进 message。
+     */
+    private raiseGitFailure;
     /**
      * 为网络命令构造 credential helper 参数：
      * 仅 http(s) 远端需要 token；本地路径 / ssh 走 git 原生认证（密钥），不调用 provider。