ygc-dsh-sync 1.1.0 → 1.2.1

package/index.js

@@ -13,10 +13,12 @@ import {
   backupWorkspace,
   pickWorkspaces,
   projectKeysFor,
+  pullWorkspace,
   scanLocalSessions,
 } from './lib/backup.js';
 import { attachMany, findPulledUnattached } from './lib/attach.js';
-import { repairAll, scanFolders } from './lib/patrol.js';
+import { scanFolders } from './lib/patrol.js';
+import { applyFeaturePlan, onlyActive, pickRemovedIds, planFeatures, reconcileRemoved } from './lib/features.js';
 import {
   LINEAGE_FILE,
   LOCAL_SKILLS_ROOT,
@@ -107,6 +109,26 @@ export function apply(ctx, config = {}) {
     return { id: ws?.id, created: true };
   };
 
+  /**
+   * 取消注册一个工作区（只删注册，不删目录与会话）。
+   *
+   * 走宿主自己的 workspaceRegistry.delete：user 在侧边栏删工作区是同一个入口，
+   * 这里只是让「删特征文件夹」能顺手把注册也清掉（/features/drop 的选项）。
+   */
+  const deleteWorkspace = async (id) => {
+    const registry = (() => {
+      try {
+        return ctx.get('workspaceRegistry') || ctx.workspaceRegistry;
+      } catch {
+        return ctx.workspaceRegistry;
+      }
+    })();
+    if (!registry || typeof registry.delete !== 'function') {
+      throw new Error('宿主没有提供 workspaceRegistry.delete');
+    }
+    return registry.delete(id);
+  };
+
   // ---- 插件清单同步（1.0.0 从自动更新器迁来）----
 
   /** 把本机清单写进自己那一格，再汇集他人清单。幂等：没变就不写文件。 */
@@ -195,6 +217,7 @@ export function apply(ctx, config = {}) {
     workspaces,
     machineId,
     registerWorkspace,
+    deleteWorkspace,
     wsEntity,
     entities,
     // 起草器：宿主的默认模型。没有 llm 服务时返回 null，流水线自动跳过起草。
@@ -229,7 +252,9 @@ export function apply(ctx, config = {}) {
       if (!state.folders.length) return;
       const mid = config.machineId || state.machineId;
 
-      const matched = pickWorkspaces(workspaces(), state.folders);
+      // 只备份「本机特征文件夹存在」的工作区：没建格子 = 本机不参与，
+      // 自动备份也不许往里写（1.2.0 起的硬规矩）。
+      const matched = onlyActive(pickWorkspaces(workspaces(), state.folders), mid);
       if (!matched.length) return;
 
       const local = scanLocalSessions();
@@ -270,56 +295,97 @@ export function apply(ctx, config = {}) {
   });
 
   // ---- 定时巡检 ----
-  // 行为：到点后执行「发现 + 补全本机特征文件夹 + 补登记会话归属」。
-  // 发现的新文件夹只记录、不自动注册（需用户在面板确认）。
+  // 判据（用户 2026-11-14 定的矩阵，只认磁盘上有没有那三个东西）：
+  //   别人的格子 有 / 我的格子 没有 / 工作区 没有 → 问人要不要在本机建
+  //              我的格子 有 / 工作区 有                 → 正常，参与备份与拉取
+  //              我的格子 有 / 工作区 没有               → 补工作区（注册回侧边栏）
+  //              我的格子 没有 / 工作区 有               → 补文件夹
+  //   工作区被删（基线里有、清单里没有）                → 删我的格子（含格里对话）
+  // 补工作区这一步要调宿主接口（async），所以放在这里做，不在纯函数里。
   const runPatrol = async (reason) => {
     try {
       const state = loadState();
       const mid = config.machineId || state.machineId;
-      const result = scanFolders({
+      const all = workspaces();
+      const scan = scanFolders({
         folders: state.folders,
-        workspaces: workspaces(),
+        workspaces: all,
         machineId: mid,
       });
 
-      // 沿用用户既有习惯：已注册工作区缺特征文件夹时直接补齐
-      // （补齐只是建一个空目录，不改变任何会话数据）
-      const repaired = repairAll(result.repair, mid);
+      const plan = planFeatures({
+        folders: state.folders,
+        workspaces: all,
+        discover: scan.discover,
+        state: loadState(),
+        machineId: mid,
+      });
+      const next = loadState();
+      // 补文件夹 + 删格子（这两件是同步的、不涉及注册）
+      const applied = applyFeaturePlan({ plan, state: next, machineId: mid, log });
+      saveState(next);
 
-      // 补登记：本机已有、cwd 落在这个工作区、却没进归属账的会话。
-      // 旧版拉取只写文件不登记，这些会话会一直躺在「未分组」里；
-      // 这里每次巡检顺手补上，是幂等的（已登记的不动）。
-      const attachStats = await repairAttachments();
+      // 补工作区：有我的格子、但侧边栏里没有它
+      const restoredWs = [];
+      const restoreErrors = [];
+      if (typeof registerWorkspace === 'function') {
+        for (const item of plan.restoreWorkspace || []) {
+          try {
+            const out = await registerWorkspace(item.path, item.title);
+            restoredWs.push({ path: item.path, id: out?.id });
+          } catch (err) {
+            restoreErrors.push({ path: item.path, message: String((err && err.message) || err) });
+          }
+        }
+        if (restoredWs.length) {
+          const s2 = loadState();
+          for (const r of restoredWs) {
+            if (r.id !== undefined && r.id !== null) s2.features.known[String(r.id)] = String(r.path).replace(/[\\/]+/g, '\\');
+          }
+          saveState(s2);
+        }
+      }
 
-      const next = loadState();
-      next.patrol = {
-        ...next.patrol,
+      const attachment = await repairAttachments();
+
+      const after = loadState();
+      after.patrol = {
+        ...after.patrol,
         lastRunAt: Date.now(),
         lastResult: {
-          discover: result.discover.length,
-          repair: result.repair.length,
-          repaired: repaired.created.length,
-          attached: attachStats.attached,
-          attachFailed: attachStats.failed,
+          discover: scan.discover.length,
+          repair: scan.repair.length,
+          ask: plan.ask.length,
+          createdFolder: applied.created.length,
+          restoredWorkspace: restoredWs.length,
+          dropped: applied.dropped.length,
+          attached: attachment.attached,
+          attachFailed: attachment.failed,
           reason,
         },
       };
       pushHistory(
-        next,
+        after,
         'patrol',
-        `巡检（${reason}）：发现 ${result.discover.length} 个待注册、补全 ${repaired.created.length} 个特征文件夹${
-          attachStats.attached ? `、补登记 ${attachStats.attached} 个会话归属` : ''
-        }`,
+        `巡检（${reason}）：待人工确认 ${plan.ask.length} 个、补文件夹 ${applied.created.length} 个、` +
+          `补工作区 ${restoredWs.length} 个、删格子 ${applied.dropped.length} 个` +
+          `${attachment.attached ? `、补登记 ${attachment.attached} 个会话归属` : ''}`,
       );
-      saveState(next);
-
-      if (result.discover.length || repaired.created.length || attachStats.attached) {
+      saveState(after);
+
+      if (
+        plan.ask.length ||
+        applied.created.length ||
+        restoredWs.length ||
+        applied.dropped.length ||
+        attachment.attached
+      ) {
         log(
-          `巡检：发现 ${result.discover.length} 个待注册，补全 ${repaired.created.length} 个特征文件夹，` +
-            `补登记 ${attachStats.attached} 个会话归属`,
+          `巡检：待人工确认 ${plan.ask.length}，补文件夹 ${applied.created.length}，补工作区 ${restoredWs.length}，` +
+            `删格子 ${applied.dropped.length}，补登记 ${attachment.attached}`,
         );
       }
-      return next.patrol;
+      return after.patrol;
     } catch (err) {
       log(`巡检失败：${err && err.message ? err.message : err}`);
       return null;
@@ -332,6 +398,9 @@ export function apply(ctx, config = {}) {
    * 只认拉取产物（别的机器备份目录里有它），不按 cwd 无差别补——
    * 自动化插件和子代理留下的会话也命中 cwd，一起补会让侧栏一次多出上百条。
    * 幂等；单条失败不打断。
+   *
+   * 1.2.0 起只处理「有本机特征文件夹」的工作区：没建格子的本机压根没在同步它，
+   * 往里补登记只会让侧栏凭空多出一堆会话。
    */
   const repairAttachments = async () => {
     let attached = 0;
@@ -339,7 +408,7 @@ export function apply(ctx, config = {}) {
     try {
       const state = loadState();
       const mid = config.machineId || state.machineId;
-      const matched = pickWorkspaces(workspaces(), state.folders);
+      const matched = onlyActive(pickWorkspaces(workspaces(), state.folders), mid);
       if (!matched.length) return { attached, failed };
 
       const localIndex = scanLocalSessions();
@@ -385,10 +454,50 @@ export function apply(ctx, config = {}) {
       });
     };
 
+    /**
+     * 删除对账的二次确认记录：工作区 id → 第一次发现「清单里没有它」的时间。
+     * 判据与取整逻辑在 pickRemovedIds（纯函数，有测试）。
+     */
+    let missingSince = new Map();
+
     const tick = () => {
       try {
         const state = loadState();
         const patrol = state.patrol || {};
+
+        // 轻量对账（每 30 秒，与巡检间隔无关）：本机删掉工作区后要尽快把
+        // 特征文件夹一起清掉，不能等满一个巡检周期。只比对清单与基线，
+        // 不扫盘、不建目录，成本接近零。
+        try {
+          const liveIds = workspaces().map((w) => String(w.id));
+          const nextState = loadState();
+          const known = (nextState.features && nextState.features.known) || {};
+          const picked = pickRemovedIds({
+            known,
+            liveIds,
+            missingSince,
+            now: Date.now(),
+            minAgeMs: PATROL_TICK_MS,
+          });
+          missingSince = picked.missingSince;
+          if (picked.confirmed.length) {
+            const rec = reconcileRemoved(nextState, config.machineId || nextState.machineId, picked.confirmed, {
+              log,
+            });
+            if (rec.dropped.length || rec.errors.length) {
+              pushHistory(
+                nextState,
+                'features',
+                `工作区已删除，同步删掉 ${rec.dropped.length} 个本机特征文件夹`,
+              );
+              saveState(nextState);
+              log(`工作区删除：同步清掉 ${rec.dropped.length} 个本机特征文件夹`);
+            }
+          }
+        } catch (err) {
+          log(`特征文件夹对账失败：${err && err.message ? err.message : err}`);
+        }
+
         if (!patrol.enabled) {
           // 关闭期间不积累待办；重新开启时从下一次 tick 重新起算
           booted = false;