ai-project-manage-cli 7.1.16 → 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

@@ -1671,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, "/");
@@ -1692,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;
   }
@@ -1705,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 [];
   }
@@ -1749,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;
@@ -1777,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,
@@ -1794,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
@@ -1802,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
@@ -1822,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");
@@ -1831,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;
@@ -1844,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,
@@ -1853,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;
@@ -1870,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) {
@@ -10048,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

@@ -2681,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, "/");
@@ -2701,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;
   }
@@ -2714,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])
@@ -2735,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;
@@ -2763,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,
@@ -2780,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
@@ -2788,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
@@ -2808,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");
@@ -2817,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;
@@ -2830,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,
@@ -2839,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) {
@@ -3309,6 +3409,30 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
     }
     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(
@@ -3426,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.16",
+  "version": "7.1.17",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/AGENTS.md

@@ -33,10 +33,11 @@
     - 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>/\*）:

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。
 
 ## 规范