ai-project-manage-cli 7.1.15 → 7.1.17

package/README.md

@@ -57,6 +57,6 @@ apm daemon start -f
 
 使用全局 PM2（未安装时会自动执行 `npm install -g pm2`）；同一时刻仅允许一个 connect。启动时会自动检测 CLI 更新并刷新守护配置。
 
-`apm pull` 会自动将平台登记的**项目文档**同步到 `.apm/docs/`（含 `manifest.json`）。Agent 修改 `.apm/docs/` 下文件后，`apm connect` 处理完消息会自动推回平台。
+`apm pull` 会自动将平台登记的**项目文档**同步到 `.apm/project/<项目ID>/`（含 `manifest.json`）。Agent 修改该目录下文件后，`apm connect` 处理完消息会自动推回平台。
 
 详见仓库根目录 [docs/CLI.md](../../docs/CLI.md)。

package/dist/index.js

@@ -184,6 +184,10 @@ var init_request_config = __esm({
           method: "GET",
           path: "/cli/webide/assumptions"
         }),
+        webideListAttachments: defineEndpoint({
+          method: "GET",
+          path: "/cli/webide/attachments"
+        }),
         webideRecommendPlan: defineEndpoint({
           method: "PUT",
           path: "/cli/webide/plan-recommendation"
@@ -220,10 +224,12 @@ var init_request_config = __esm({
           method: "GET",
           path: "/cli/tasks/branch-baseline"
         }),
-        projectBaseBranch: defineEndpoint({
-          method: "GET",
-          path: "/cli/tasks/project-base-branch"
-        }),
+        projectBaseBranch: defineEndpoint(
+          {
+            method: "GET",
+            path: "/cli/tasks/project-base-branch"
+          }
+        ),
         listSessionsForBranchCleanup: defineEndpoint({
           method: "GET",
           path: "/cli/sessions/branch-cleanup"
@@ -1665,12 +1671,26 @@ import {
 import { createHash } from "crypto";
 import { dirname as dirname2, join as join4, relative, sep } from "path";
 var MANIFEST_FILE = "manifest.json";
-function projectDocumentsDir(apmRoot) {
-  return join4(apmRoot ?? workspaceApmDir(), "docs");
+function normalizeProjectIdForPath(projectId) {
+  const id = projectId.trim();
+  if (!id) {
+    throw new Error("projectId \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (id.includes("..") || id.includes("/") || id.includes("\\") || id.includes("\0")) {
+    throw new Error(`\u975E\u6CD5 projectId: ${projectId}`);
+  }
+  return id;
+}
+function projectDocumentsDir(apmRoot, projectId) {
+  const id = normalizeProjectIdForPath(projectId);
+  return join4(apmRoot ?? workspaceApmDir(), "project", id);
 }
-function projectDocumentLocalPath(apmRoot, documentPath) {
+function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
   const normalized = normalizeLocalDocumentPath(documentPath);
-  return join4(projectDocumentsDir(apmRoot), ...normalized.split("/"));
+  return join4(
+    projectDocumentsDir(apmRoot, projectId),
+    ...normalized.split("/")
+  );
 }
 function normalizeLocalDocumentPath(path19) {
   const trimmed = path19.trim().replace(/\\/g, "/");
@@ -1686,8 +1706,11 @@ function normalizeLocalDocumentPath(path19) {
 function hashLocalFileContent(content) {
   return createHash("sha256").update(content, "utf8").digest("hex");
 }
-function readLocalManifest(apmRoot) {
-  const manifestPath2 = join4(projectDocumentsDir(apmRoot), MANIFEST_FILE);
+function readLocalManifest(apmRoot, projectId) {
+  const manifestPath2 = join4(
+    projectDocumentsDir(apmRoot, projectId),
+    MANIFEST_FILE
+  );
   if (!existsSync2(manifestPath2)) {
     return null;
   }
@@ -1699,8 +1722,8 @@ function readLocalManifest(apmRoot) {
     return null;
   }
 }
-function listLocalDocumentPaths(apmRoot) {
-  const root = projectDocumentsDir(apmRoot);
+function listLocalDocumentPaths(apmRoot, projectId) {
+  const root = projectDocumentsDir(apmRoot, projectId);
   if (!existsSync2(root)) {
     return [];
   }
@@ -1743,7 +1766,11 @@ function diffManifestPaths(remote, local) {
   }
   return { download, deleteLocal };
 }
-async function resolveProjectIdForSync(api, workdirPath) {
+async function resolveProjectIdForSync(api, workdirPath, options) {
+  const explicit = options?.projectId?.trim();
+  if (explicit) {
+    return { projectId: explicit, diagnostic: null };
+  }
   try {
     const baseline = await api.cli.workspaceBaseline({ workdirPath });
     const projectId = baseline.projectId?.trim() || null;
@@ -1771,7 +1798,7 @@ async function resolveProjectIdForSync(api, workdirPath) {
     };
   }
 }
-async function syncProjectDocumentsPull(workdirPath, apmDir) {
+async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
   const empty = {
     synced: false,
     projectId: null,
@@ -1788,7 +1815,8 @@ async function syncProjectDocumentsPull(workdirPath, apmDir) {
   const api = createApmApiClient(cfg);
   const { projectId, diagnostic } = await resolveProjectIdForSync(
     api,
-    workdirPath
+    workdirPath,
+    options
   );
   if (!projectId) {
     console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
@@ -1796,14 +1824,16 @@ ${diagnostic ?? ""}`);
     return empty;
   }
   const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const docsDir = projectDocumentsDir(targetApmDir);
+  const docsDir = projectDocumentsDir(targetApmDir, projectId);
   await ensureDirExists(docsDir);
-  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest({ projectId });
+  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest(
+    { projectId }
+  );
   if (!remoteManifest) {
     console.log(`[apm] \u9879\u76EE ${projectId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`);
     return { ...empty, projectId };
   }
-  const localManifest = readLocalManifest(targetApmDir);
+  const localManifest = readLocalManifest(targetApmDir, projectId);
   const { download, deleteLocal } = diffManifestPaths(
     remoteManifest,
     localManifest
@@ -1816,7 +1846,7 @@ ${diagnostic ?? ""}`);
     });
     for (const doc of list) {
       const absPath = toFsPath(
-        projectDocumentLocalPath(targetApmDir, doc.path)
+        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
       );
       await ensureDirExists(dirname2(absPath));
       writeFileSync4(absPath, doc.content, "utf8");
@@ -1825,7 +1855,9 @@ ${diagnostic ?? ""}`);
   }
   let deleted = 0;
   for (const path19 of deleteLocal) {
-    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path19));
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path19)
+    );
     if (existsSync2(absPath)) {
       rmSync(absPath, { force: true });
       deleted += 1;
@@ -1838,7 +1870,7 @@ ${diagnostic ?? ""}`);
     "utf8"
   );
   console.log(
-    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted}`
+    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: projectId=${projectId} \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted} \u2192 .apm/project/${projectId}/`
   );
   return {
     synced: true,
@@ -1847,14 +1879,18 @@ ${diagnostic ?? ""}`);
     deleted
   };
 }
-async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot) {
+async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
   const api = createApmApiClient(cfg);
-  const { projectId } = await resolveProjectIdForSync(api, workdirPath);
+  const { projectId } = await resolveProjectIdForSync(
+    api,
+    workdirPath,
+    options
+  );
   if (!projectId) {
     return 0;
   }
   const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
-  const localPaths = listLocalDocumentPaths(targetApmDir);
+  const localPaths = listLocalDocumentPaths(targetApmDir, projectId);
   if (localPaths.length === 0) {
     console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
     return 0;
@@ -1864,14 +1900,13 @@ async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot) {
     (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
   );
   const remoteDescriptionByPath = new Map(
-    (remoteManifest?.documents ?? []).map((doc) => [
-      doc.path,
-      doc.description
-    ])
+    (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.description])
   );
   let synced = 0;
   for (const path19 of localPaths) {
-    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path19));
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path19)
+    );
     const content = readFileSync3(absPath, "utf8");
     const contentHash = hashLocalFileContent(content);
     if (remoteHashByPath.get(path19) === contentHash) {
@@ -2498,7 +2533,9 @@ import { join as join6 } from "path";
 var MANIFEST_FILE2 = ".sync-manifest.json";
 async function downloadAttachment(cfg, attachmentId) {
   const base = cfg.baseUrl.trim().replace(/\/+$/, "");
-  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({ attachmentId })}`;
+  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
+    attachmentId
+  })}`;
   const res = await fetch(url);
   if (!res.ok) {
     throw new Error(
@@ -2537,24 +2574,23 @@ function isAttachmentUpToDate(entry, item, dest) {
   const createdAt = item.createdAt ?? "";
   return entry.createdAt === createdAt;
 }
-async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
-  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
   await ensureDirExists(dir);
   if (attachments.length === 0) {
     saveManifest(dir, { version: 1, attachments: {} });
-    return;
+    return [];
   }
   const manifest = loadManifest(dir);
   const nextManifest = { version: 1, attachments: {} };
+  const names = [];
   for (const item of attachments) {
     const dest = join6(dir, item.name);
     const entry = manifest.attachments[item.id];
     const createdAt = item.createdAt ?? "";
+    names.push(item.name);
     if (isAttachmentUpToDate(entry, item, dest)) {
       nextManifest.attachments[item.id] = entry;
-      console.log(
-        `[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`
-      );
+      console.log(`[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${logLabel}/${item.name}`);
       continue;
     }
     const buffer = await downloadAttachment(cfg, item.id);
@@ -2563,9 +2599,19 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
       name: item.name,
       createdAt
     };
-    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`);
+    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${logLabel}/${item.name}`);
   }
   saveManifest(dir, nextManifest);
+  return names;
+}
+async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
+  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+  return syncAttachmentsToDirectory(
+    cfg,
+    attachments,
+    dir,
+    SESSION_ATTACHMENTS_SUBDIR
+  );
 }
 
 // src/rules-sync.ts
@@ -10031,12 +10077,12 @@ function buildProgram() {
     await runSyncDeployConfig();
   });
   program.command("sync-project-documents").description(
-    "\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF1A\u9ED8\u8BA4 pull \u5230 .apm/docs/\uFF1B\u52A0 --push \u5C06\u672C\u5730\u53D8\u66F4\u63A8\u9001\u5230\u5E73\u53F0"
-  ).option("--push", "\u63A8\u9001\u672C\u5730 .apm/docs/ \u5230\u5E73\u53F0").option("--pull", "\u4ECE\u5E73\u53F0\u62C9\u53D6\u5230 .apm/docs/").action(async (opts) => {
+    "\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF1A\u9ED8\u8BA4 pull \u5230 .apm/project/<\u9879\u76EEID>/\uFF1B\u52A0 --push \u5C06\u672C\u5730\u53D8\u66F4\u63A8\u9001\u5230\u5E73\u53F0"
+  ).option("--push", "\u63A8\u9001\u672C\u5730 .apm/project/<\u9879\u76EEID>/ \u5230\u5E73\u53F0").option("--pull", "\u4ECE\u5E73\u53F0\u62C9\u53D6\u5230 .apm/project/<\u9879\u76EEID>/").action(async (opts) => {
     await runSyncProjectDocuments(opts);
   });
   program.command("pull").description(
-    "\u62C9\u53D6\u6C9F\u901A\u7FA4\u6570\u636E\u5230 .apm/sessions/<sessionId>/\uFF0C\u5E76\u540C\u6B65\u90E8\u7F72\u914D\u7F6E\u4E0E\u9879\u76EE\u6587\u6863\u5230 .apm/docs/"
+    "\u62C9\u53D6\u6C9F\u901A\u7FA4\u6570\u636E\u5230 .apm/sessions/<sessionId>/\uFF0C\u5E76\u540C\u6B65\u90E8\u7F72\u914D\u7F6E\u4E0E\u9879\u76EE\u6587\u6863\u5230 .apm/project/<\u9879\u76EEID>/"
   ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
     await runPull(sessionId);
   });

package/dist/webide-message-worker.js

@@ -88,6 +88,10 @@ var requestConfig = {
       method: "GET",
       path: "/cli/webide/assumptions"
     }),
+    webideListAttachments: defineEndpoint({
+      method: "GET",
+      path: "/cli/webide/attachments"
+    }),
     webideRecommendPlan: defineEndpoint({
       method: "PUT",
       path: "/cli/webide/plan-recommendation"
@@ -124,10 +128,12 @@ var requestConfig = {
       method: "GET",
       path: "/cli/tasks/branch-baseline"
     }),
-    projectBaseBranch: defineEndpoint({
-      method: "GET",
-      path: "/cli/tasks/project-base-branch"
-    }),
+    projectBaseBranch: defineEndpoint(
+      {
+        method: "GET",
+        path: "/cli/tasks/project-base-branch"
+      }
+    ),
     listSessionsForBranchCleanup: defineEndpoint({
       method: "GET",
       path: "/cli/sessions/branch-cleanup"
@@ -591,6 +597,14 @@ function assertApmGitignoredInRepo(workdir) {
     );
   }
 }
+var SESSION_ATTACHMENTS_SUBDIR = "attachments";
+var WEBIDE_SUBDIR = "webide";
+function webideTaskDir(taskId, workdir) {
+  return join2(workdir, ".apm", WEBIDE_SUBDIR, taskId);
+}
+function webideAttachmentsDir(taskId, workdir) {
+  return join2(webideTaskDir(taskId, workdir), SESSION_ATTACHMENTS_SUBDIR);
+}
 async function ensureLoggedConfig() {
   const cfg = await ensureApmConfig();
   if (!resolveApiKey(cfg)) {
@@ -2667,14 +2681,29 @@ import {
   rmSync,
   writeFileSync as writeFileSync7
 } from "fs";
+import { createHash } from "crypto";
 import { dirname as dirname4, join as join6, relative as relative2, sep } from "path";
 var MANIFEST_FILE = "manifest.json";
-function projectDocumentsDir(apmRoot) {
-  return join6(apmRoot ?? workspaceApmDir(), "docs");
+function normalizeProjectIdForPath(projectId) {
+  const id = projectId.trim();
+  if (!id) {
+    throw new Error("projectId \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (id.includes("..") || id.includes("/") || id.includes("\\") || id.includes("\0")) {
+    throw new Error(`\u975E\u6CD5 projectId: ${projectId}`);
+  }
+  return id;
+}
+function projectDocumentsDir(apmRoot, projectId) {
+  const id = normalizeProjectIdForPath(projectId);
+  return join6(apmRoot ?? workspaceApmDir(), "project", id);
 }
-function projectDocumentLocalPath(apmRoot, documentPath) {
+function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
   const normalized = normalizeLocalDocumentPath(documentPath);
-  return join6(projectDocumentsDir(apmRoot), ...normalized.split("/"));
+  return join6(
+    projectDocumentsDir(apmRoot, projectId),
+    ...normalized.split("/")
+  );
 }
 function normalizeLocalDocumentPath(path) {
   const trimmed = path.trim().replace(/\\/g, "/");
@@ -2687,8 +2716,14 @@ function normalizeLocalDocumentPath(path) {
   }
   return segments.join("/");
 }
-function readLocalManifest(apmRoot) {
-  const manifestPath3 = join6(projectDocumentsDir(apmRoot), MANIFEST_FILE);
+function hashLocalFileContent(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function readLocalManifest(apmRoot, projectId) {
+  const manifestPath3 = join6(
+    projectDocumentsDir(apmRoot, projectId),
+    MANIFEST_FILE
+  );
   if (!existsSync5(manifestPath3)) {
     return null;
   }
@@ -2700,6 +2735,29 @@ function readLocalManifest(apmRoot) {
     return null;
   }
 }
+function listLocalDocumentPaths(apmRoot, projectId) {
+  const root = projectDocumentsDir(apmRoot, projectId);
+  if (!existsSync5(root)) {
+    return [];
+  }
+  const paths = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
+      const abs = join6(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (entry.isFile() && entry.name === MANIFEST_FILE) {
+        continue;
+      }
+      const rel = relative2(root, abs).split(sep).join("/");
+      paths.push(rel);
+    }
+  };
+  walk(root);
+  return paths.sort();
+}
 function diffManifestPaths(remote, local) {
   const remoteMap = new Map(
     (remote?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
@@ -2721,7 +2779,11 @@ function diffManifestPaths(remote, local) {
   }
   return { download, deleteLocal };
 }
-async function resolveProjectIdForSync(api, workdirPath) {
+async function resolveProjectIdForSync(api, workdirPath, options) {
+  const explicit = options?.projectId?.trim();
+  if (explicit) {
+    return { projectId: explicit, diagnostic: null };
+  }
   try {
     const baseline = await api.cli.workspaceBaseline({ workdirPath });
     const projectId = baseline.projectId?.trim() || null;
@@ -2749,7 +2811,7 @@ async function resolveProjectIdForSync(api, workdirPath) {
     };
   }
 }
-async function syncProjectDocumentsPull(workdirPath, apmDir) {
+async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
   const empty = {
     synced: false,
     projectId: null,
@@ -2766,7 +2828,8 @@ async function syncProjectDocumentsPull(workdirPath, apmDir) {
   const api = createApmApiClient(cfg);
   const { projectId, diagnostic } = await resolveProjectIdForSync(
     api,
-    workdirPath
+    workdirPath,
+    options
   );
   if (!projectId) {
     console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
@@ -2774,14 +2837,16 @@ ${diagnostic ?? ""}`);
     return empty;
   }
   const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const docsDir = projectDocumentsDir(targetApmDir);
+  const docsDir = projectDocumentsDir(targetApmDir, projectId);
   await ensureDirExists(docsDir);
-  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest({ projectId });
+  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest(
+    { projectId }
+  );
   if (!remoteManifest) {
     console.log(`[apm] \u9879\u76EE ${projectId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`);
     return { ...empty, projectId };
   }
-  const localManifest = readLocalManifest(targetApmDir);
+  const localManifest = readLocalManifest(targetApmDir, projectId);
   const { download, deleteLocal } = diffManifestPaths(
     remoteManifest,
     localManifest
@@ -2794,7 +2859,7 @@ ${diagnostic ?? ""}`);
     });
     for (const doc of list) {
       const absPath = toFsPath(
-        projectDocumentLocalPath(targetApmDir, doc.path)
+        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
       );
       await ensureDirExists(dirname4(absPath));
       writeFileSync7(absPath, doc.content, "utf8");
@@ -2803,7 +2868,9 @@ ${diagnostic ?? ""}`);
   }
   let deleted = 0;
   for (const path of deleteLocal) {
-    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path));
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path)
+    );
     if (existsSync5(absPath)) {
       rmSync(absPath, { force: true });
       deleted += 1;
@@ -2816,7 +2883,7 @@ ${diagnostic ?? ""}`);
     "utf8"
   );
   console.log(
-    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted}`
+    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: projectId=${projectId} \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted} \u2192 .apm/project/${projectId}/`
   );
   return {
     synced: true,
@@ -2825,6 +2892,53 @@ ${diagnostic ?? ""}`);
     deleted
   };
 }
+async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
+  const api = createApmApiClient(cfg);
+  const { projectId } = await resolveProjectIdForSync(
+    api,
+    workdirPath,
+    options
+  );
+  if (!projectId) {
+    return 0;
+  }
+  const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
+  const localPaths = listLocalDocumentPaths(targetApmDir, projectId);
+  if (localPaths.length === 0) {
+    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+    return 0;
+  }
+  const remoteManifest = (await api.cli.getProjectDocumentManifest({ projectId })).manifest ?? null;
+  const remoteHashByPath = new Map(
+    (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
+  );
+  const remoteDescriptionByPath = new Map(
+    (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.description])
+  );
+  let synced = 0;
+  for (const path of localPaths) {
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path)
+    );
+    const content = readFileSync6(absPath, "utf8");
+    const contentHash = hashLocalFileContent(content);
+    if (remoteHashByPath.get(path) === contentHash) {
+      continue;
+    }
+    await api.cli.upsertProjectDocument({
+      projectId,
+      path,
+      content,
+      description: remoteDescriptionByPath.get(path) ?? void 0
+    });
+    synced += 1;
+    console.log(`[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: ${path}`);
+  }
+  if (synced === 0) {
+    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+  }
+  return synced;
+}
 
 // src/commands/init.ts
 async function ensureWorkspaceInitialized(workdir, options) {
@@ -3087,21 +3201,108 @@ async function syncWorkspaceSkills(cfg, workdir) {
   );
 }
 
-// src/commands/connect/cli-version-sync.ts
+// src/commands/sync-session-attachments.ts
 import { existsSync as existsSync8, readFileSync as readFileSync9, writeFileSync as writeFileSync10 } from "fs";
 import { join as join11 } from "path";
+var MANIFEST_FILE2 = ".sync-manifest.json";
+async function downloadAttachment(cfg, attachmentId) {
+  const base = cfg.baseUrl.trim().replace(/\/+$/, "");
+  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
+    attachmentId
+  })}`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(
+      `[apm] \u4E0B\u8F7D\u9644\u4EF6\u5931\u8D25 (${res.status}): attachmentId=${attachmentId}`
+    );
+  }
+  return Buffer.from(await res.arrayBuffer());
+}
+function loadManifest(dir) {
+  const path = join11(dir, MANIFEST_FILE2);
+  if (!existsSync8(path)) {
+    return { version: 1, attachments: {} };
+  }
+  try {
+    const parsed = JSON.parse(
+      readFileSync9(path, "utf8")
+    );
+    if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
+      return parsed;
+    }
+  } catch {
+  }
+  return { version: 1, attachments: {} };
+}
+function saveManifest(dir, manifest) {
+  writeFileSync10(
+    join11(dir, MANIFEST_FILE2),
+    `${JSON.stringify(manifest, null, 2)}
+`,
+    "utf8"
+  );
+}
+function isAttachmentUpToDate(entry, item, dest) {
+  if (!entry || !existsSync8(dest)) return false;
+  if (entry.name !== item.name) return false;
+  const createdAt = item.createdAt ?? "";
+  return entry.createdAt === createdAt;
+}
+async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
+  await ensureDirExists(dir);
+  if (attachments.length === 0) {
+    saveManifest(dir, { version: 1, attachments: {} });
+    return [];
+  }
+  const manifest = loadManifest(dir);
+  const nextManifest = { version: 1, attachments: {} };
+  const names = [];
+  for (const item of attachments) {
+    const dest = join11(dir, item.name);
+    const entry = manifest.attachments[item.id];
+    const createdAt = item.createdAt ?? "";
+    names.push(item.name);
+    if (isAttachmentUpToDate(entry, item, dest)) {
+      nextManifest.attachments[item.id] = entry;
+      console.log(`[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${logLabel}/${item.name}`);
+      continue;
+    }
+    const buffer = await downloadAttachment(cfg, item.id);
+    writeFileSync10(dest, buffer);
+    nextManifest.attachments[item.id] = {
+      name: item.name,
+      createdAt
+    };
+    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${logLabel}/${item.name}`);
+  }
+  saveManifest(dir, nextManifest);
+  return names;
+}
+async function syncWebIdeAttachments(cfg, taskId, workdir, attachments) {
+  const dir = webideAttachmentsDir(taskId, workdir);
+  return syncAttachmentsToDirectory(
+    cfg,
+    attachments,
+    dir,
+    `.apm/webide/${taskId}/attachments`
+  );
+}
+
+// src/commands/connect/cli-version-sync.ts
+import { existsSync as existsSync9, readFileSync as readFileSync10, writeFileSync as writeFileSync11 } from "fs";
+import { join as join12 } from "path";
 var CLI_VERSION_FILE = ".cli-version.json";
 function manifestPath2(apmDir) {
-  return join11(apmDir, CLI_VERSION_FILE);
+  return join12(apmDir, CLI_VERSION_FILE);
 }
-function loadManifest(apmDir) {
+function loadManifest2(apmDir) {
   const path = toFsPath(manifestPath2(apmDir));
-  if (!existsSync8(path)) {
+  if (!existsSync9(path)) {
     return null;
   }
   try {
     const parsed = JSON.parse(
-      readFileSync9(path, "utf8")
+      readFileSync10(path, "utf8")
     );
     if (parsed?.version === 1 && typeof parsed.cliVersion === "string" && parsed.cliVersion.trim()) {
       return parsed;
@@ -3110,9 +3311,9 @@ function loadManifest(apmDir) {
   }
   return null;
 }
-function saveManifest(apmDir, cliVersion) {
+function saveManifest2(apmDir, cliVersion) {
   const manifest = { version: 1, cliVersion };
-  writeFileSync10(
+  writeFileSync11(
     toFsPath(manifestPath2(apmDir)),
     `${JSON.stringify(manifest, null, 2)}
 `,
@@ -3125,7 +3326,7 @@ function shouldSyncSkillsForCliVersion(workdir, currentVersion) {
   if (cached === currentVersion) {
     return false;
   }
-  const stored = loadManifest(workspaceApmDir(workdir));
+  const stored = loadManifest2(workspaceApmDir(workdir));
   if (stored?.cliVersion === currentVersion) {
     syncedInSession.set(workdir, currentVersion);
     return false;
@@ -3133,7 +3334,7 @@ function shouldSyncSkillsForCliVersion(workdir, currentVersion) {
   return true;
 }
 function markSkillsSyncedForCliVersion(workdir, cliVersion) {
-  saveManifest(workspaceApmDir(workdir), cliVersion);
+  saveManifest2(workspaceApmDir(workdir), cliVersion);
   syncedInSession.set(workdir, cliVersion);
 }
 
@@ -3206,6 +3407,51 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
       if (signal.aborted) throw new Error("\u4EFB\u52A1\u5DF2\u53D6\u6D88");
       await ensureWebIdePullRequests(cfg, taskId, workdir);
     }
+    if (signal.aborted) throw new Error("\u4EFB\u52A1\u5DF2\u53D6\u6D88");
+    const api = createApmApiClient(cfg);
+    let projectId = null;
+    try {
+      const baseline = await api.cli.projectBaseBranch({ taskId });
+      projectId = baseline.projectId?.trim() || null;
+      if (projectId) {
+        const docs = await syncProjectDocumentsPull(workdir, void 0, {
+          projectId
+        });
+        if (docs.synced) {
+          console.log(
+            `[apm] webide \u9879\u76EE\u6587\u6863\u5DF2\u5C31\u7EEA projectId=${projectId} downloaded=${docs.downloaded} deleted=${docs.deleted}`
+          );
+        }
+      } else {
+        console.warn(
+          `[apm] WebIDE \u65E0\u6CD5\u89E3\u6790\u4EFB\u52A1\u6240\u5C5E\u9879\u76EE\uFF0C\u8DF3\u8FC7\u9879\u76EE\u6587\u6863\u540C\u6B65 taskId=${taskId}`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        "[apm] WebIDE \u9879\u76EE\u6587\u6863\u540C\u6B65\u5931\u8D25:",
+        err instanceof Error ? err.message : err
+      );
+    }
+    try {
+      const attachments = await api.cli.webideListAttachments({ taskId });
+      const names = await syncWebIdeAttachments(
+        cfg,
+        taskId,
+        workdir,
+        attachments ?? []
+      );
+      if (names.length > 0) {
+        console.log(
+          `[apm] webide \u9644\u4EF6\u5DF2\u5C31\u7EEA count=${names.length} dir=.apm/webide/${taskId}/attachments`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        "[apm] WebIDE \u9644\u4EF6\u540C\u6B65\u5931\u8D25:",
+        err instanceof Error ? err.message : err
+      );
+    }
     const savedAgentId = loadWebIdeAgentId(workdir, taskId);
     const logSyncRef = { current: null };
     const outcome = await runCursorAgent(
@@ -3272,7 +3518,6 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
       result: outcome.result,
       createPlan: outcome.createPlan
     });
-    const api = createApmApiClient(cfg);
     await api.cli.webideEnsureMessageContent({
       id: messageId,
       content: fallback
@@ -3305,6 +3550,16 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
         `[apm] webide \u81EA\u52A8 push action=${msg.action} repos=${pushed}`
       );
     }
+    if (projectId) {
+      try {
+        await syncProjectDocumentsPush(cfg, workdir, void 0, { projectId });
+      } catch (err) {
+        console.warn(
+          "[apm] WebIDE \u9879\u76EE\u6587\u6863\u63A8\u9001\u5931\u8D25:",
+          err instanceof Error ? err.message : err
+        );
+      }
+    }
     await logSyncRef.current?.markRun(outcome.runId, "finished");
     await updateStatus(cfg, messageId, "SUCCESS");
     console.log(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "7.1.15",
+  "version": "7.1.17",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/AGENTS.md

@@ -33,13 +33,15 @@
     - webide_testcase.md：WebIDE 生成测试用例时读取，按规范编写并提交用例
     - webide_merge.md：WebIDE 验收通过后读取；直接调用 MergeWebIdePullRequests 合并代码
 
-- 项目文档（`.apm/docs/`）:
+- 项目文档（`.apm/project/<项目ID>/`）:
 
-  - 索引: `.apm/docs/manifest.json` — 本项目在平台登记的文档列表
-  - 文档文件: `.apm/docs/{path}` — 与 manifest 中 path 对应；`apm pull` 自动同步，`apm connect` 消息结束后自动推回平台
+  - 索引: `.apm/project/<项目ID>/manifest.json` — 该项目在平台登记的文档列表
+  - 文档文件: `.apm/project/<项目ID>/{path}` — 与 manifest 中 path 对应；`apm pull` / Session `connect` 会同步；WebIDE 处理 `webide-message` 时按**任务所属项目**拉取到对应目录，结束后推回平台
+  - 部署/本地 dev：Read `.apm/project/<项目ID>/deploy.md`（完整路径以 prompt 为准）
   - 任务涉及菜单名、路由、业务术语等时，**先 Read manifest 与相关文档**，禁止猜测路径
 
 - 本轮任务需要关注的文档指引（.apm/sessions/<会话 ID>/\*）:
+
   - 本轮会话状态: `session.yaml`，从这里可以看到每个成员的信息，找到可以协助你一起解决问题的人，可以结合 `RULE.md`一起看
   - 群文档: `docs/xxxx.md`，当需要相关上下文可以在这里查找，按需阅读
   - 附件列表: `attachments/*`，当有文档中提及附件时，从这里查找
@@ -47,3 +49,6 @@
   - 协作 TODO: `TODO.md`，跨轮次任务清单（待办与已完成项），按需阅读
   - 历史消息记录: `messages.xml`，历史消息列表，数据量很大，按需阅读
   - 初始目标: `TASK.md`，最初的目标，不一定具体，团队成员会有人负责让这个任务变得具体，仅供参考。如果你是相关的角色，则你需要先读取这个目标，然后规划接下来的动作。
+
+- WebIDE 任务附件（`.apm/webide/<taskId>/attachments/`）:
+  - `apm connect` 处理 webide-message 时会自动同步；prompt 中若出现「任务附件」指引，请按路径查看相关文件

package/template/rules/webide_terminal.md

@@ -13,7 +13,7 @@
 
 ## 启动命令来源
 
-必须 Read `.apm/docs/deploy.md`，按文档中的 cwd / command / 服务划分调用 `StartWebIdeTerminal`。
+必须 Read `.apm/project/<项目ID>/deploy.md`（完整路径以本轮 prompt 中给出的为准，勿省略项目 ID），按文档中的 cwd / command / 服务划分调用 `StartWebIdeTerminal`。
 
 - 文档不存在或未写明启动方式 → 用 AppendMessage 说明无法启动本地环境，**禁止猜测命令**。
 
@@ -22,13 +22,13 @@
 固定顺序：
 
 1. **`ListWebIdeTerminals`**
-2. 若无活终端 → Read `deploy.md` → 按前后端分别 `StartWebIdeTerminal`；已有活终端则复用
+2. 若无活终端 → Read prompt 中的 `.apm/project/<项目ID>/deploy.md` 完整路径 → 按前后端分别 `StartWebIdeTerminal`；已有活终端则复用
 3. 等待 READY / 端口即可
 4. AppendMessage：可在「终端」面板观察本地日志；「浏览器」面板由平台打开本客户机外网地址（勿粘贴整段 stdout；无需 Agent 打开浏览器）
 
 后续改码（热更新）：有活终端则**复用，不重起**。
 
-显式重跑：`StopAllWebIdeTerminals` → 再 Read `deploy.md` → 重新 Start。
+显式重跑：`StopAllWebIdeTerminals` → 再 Read `.apm/project/<项目ID>/deploy.md` → 重新 Start。
 
 ## 规范