ai-project-manage-cli 7.1.37 → 7.1.39

package/dist/index.js

@@ -1000,8 +1000,8 @@ import { Command } from "commander";
 init_config();
 
 // src/commands/init.ts
-import { join as join6 } from "path";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
+import { join as join3 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 
 // src/command-utils.ts
 init_config();
@@ -1145,8 +1145,12 @@ var WORKSPACE_TEMPLATE_SUBDIRS = [
   "rules",
   "deploy"
 ];
+var WEBIDE_AGENTS_TEMPLATE_NAME = "AGENTS.webide.md";
 function shouldSkipTemplateEntry(name) {
-  return name === ".DS_Store" || name === "Thumbs.db";
+  return name === ".DS_Store" || name === "Thumbs.db" || name === WEBIDE_AGENTS_TEMPLATE_NAME;
+}
+function isWebIdeRuleFileName(name) {
+  return name.startsWith("webide");
 }
 function copyTemplateEntry(src, dest) {
   const fsSrc = toFsPath(src);
@@ -1212,11 +1216,126 @@ async function copyTemplateFiles(targetDir, workdir = resolveWorkdirPath()) {
   }
   assertTemplateCopiedToApm(resolvedTarget, resolve2(workdir));
 }
+function listWebIdeRuleFileNames(rulesDir) {
+  const fsRulesDir = toFsPath(rulesDir);
+  if (!existsSync(fsRulesDir) || !statSync(fsRulesDir).isDirectory()) {
+    return [];
+  }
+  return readdirSync(fsRulesDir).filter((name) => {
+    if (shouldSkipTemplateEntry(name) || !isWebIdeRuleFileName(name)) {
+      return false;
+    }
+    return statSync(toFsPath(join2(rulesDir, name))).isFile();
+  });
+}
+function assertWebIdeTemplateCopiedToApm(apmDir, workdir) {
+  const required = ["AGENTS.md", "apm.config.json", "rules"];
+  for (const item of required) {
+    const path19 = join2(apmDir, item);
+    if (!existsSync(toFsPath(path19))) {
+      throw new Error(`[apm] WebIDE \u521D\u59CB\u5316\u4E0D\u5B8C\u6574\uFF0C\u7F3A\u5C11: ${path19}`);
+    }
+  }
+  const rulesDir = join2(apmDir, "rules");
+  const ruleNames = listWebIdeRuleFileNames(rulesDir);
+  if (ruleNames.length === 0) {
+    throw new Error(`[apm] WebIDE \u521D\u59CB\u5316\u4E0D\u5B8C\u6574\uFF0C\u7F3A\u5C11 webide \u89C4\u5219: ${rulesDir}`);
+  }
+  const leakedRules = join2(workdir, "rules");
+  const apmRules = join2(apmDir, "rules");
+  if (existsSync(toFsPath(leakedRules)) && !existsSync(toFsPath(join2(apmRules, "webide_reply.md")))) {
+    throw new Error(
+      `[apm] \u6A21\u677F\u88AB\u590D\u5236\u5230\u9519\u8BEF\u4F4D\u7F6E: ${leakedRules}\uFF08\u5E94\u5728 ${apmRules}\uFF09`
+    );
+  }
+}
+async function copyWebIdeTemplateFiles(targetDir, workdir = resolveWorkdirPath()) {
+  const resolvedTarget = resolve2(targetDir);
+  const templateDir = resolve2(CLI_TEMPLATE_DIR);
+  const fsTemplateDir = toFsPath(templateDir);
+  if (!existsSync(fsTemplateDir) || !statSync(fsTemplateDir).isDirectory()) {
+    throw new Error(`[apm] \u672A\u627E\u5230 CLI \u6A21\u677F\u76EE\u5F55: ${templateDir}`);
+  }
+  const agentsSrc = join2(templateDir, WEBIDE_AGENTS_TEMPLATE_NAME);
+  if (!existsSync(toFsPath(agentsSrc))) {
+    throw new Error(`[apm] \u672A\u627E\u5230 WebIDE \u6307\u5357: ${agentsSrc}`);
+  }
+  const rulesSrc = join2(templateDir, "rules");
+  const ruleNames = listWebIdeRuleFileNames(rulesSrc);
+  if (ruleNames.length === 0) {
+    throw new Error(`[apm] CLI \u6A21\u677F\u4E2D\u6CA1\u6709 webide \u89C4\u5219: ${rulesSrc}`);
+  }
+  mkdirSync2(toFsPath(resolvedTarget), { recursive: true });
+  copyFileSync(toFsPath(agentsSrc), toFsPath(join2(resolvedTarget, "AGENTS.md")));
+  copyTemplateEntry(
+    join2(templateDir, "apm.config.json"),
+    join2(resolvedTarget, "apm.config.json")
+  );
+  const rulesDest = join2(resolvedTarget, "rules");
+  mkdirSync2(toFsPath(rulesDest), { recursive: true });
+  for (const name of ruleNames) {
+    copyTemplateEntry(join2(rulesSrc, name), join2(rulesDest, name));
+  }
+  assertWebIdeTemplateCopiedToApm(resolvedTarget, resolve2(workdir));
+}
+
+// src/commands/init.ts
+function applyWorkspaceName(apmDir, name) {
+  const trimmedName = name?.trim();
+  if (!trimmedName) return;
+  const apmConfigPath = toFsPath(join3(apmDir, "apm.config.json"));
+  const config = readFileSync2(apmConfigPath, "utf8");
+  const configJson = JSON.parse(config);
+  configJson.name = trimmedName;
+  writeFileSync2(
+    apmConfigPath,
+    `${JSON.stringify(configJson, null, 2)}
+`,
+    "utf8"
+  );
+}
+async function initializeWorkspace(workdir, options) {
+  await ensureWorkspaceApmDirForInit(workdir);
+  const apmDir = workspaceApmDir(workdir);
+  if (options?.webide) {
+    await copyWebIdeTemplateFiles(apmDir, workdir);
+  } else {
+    await copyTemplateFiles(apmDir, workdir);
+  }
+  applyWorkspaceName(apmDir, options?.name);
+  console.log(
+    options?.webide ? `[apm] \u5DF2\u6309 WebIDE \u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}` : `[apm] \u5DF2\u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}`
+  );
+  return { didInit: true };
+}
+async function ensureWorkspaceInitialized(workdir, options) {
+  if (isWorkspaceApmInitialized(workdir)) {
+    return { didInit: false };
+  }
+  console.log(
+    options?.webide ? `[apm] \u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u672A\u68C0\u6D4B\u5230\u5DF2\u521D\u59CB\u5316\u7684 .apm\uFF0C\u6B63\u5728\u6309 WebIDE \u81EA\u52A8\u521D\u59CB\u5316\u2026` : `[apm] \u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u672A\u68C0\u6D4B\u5230\u5DF2\u521D\u59CB\u5316\u7684 .apm\uFF0C\u6B63\u5728\u81EA\u52A8\u521D\u59CB\u5316\u2026`
+  );
+  return initializeWorkspace(workdir, options);
+}
+async function runInit(name, options) {
+  const workdir = resolveWorkdirPath();
+  await initializeWorkspace(workdir, {
+    name,
+    webide: options?.webide === true
+  });
+  console.log(`[apm] \u5DE5\u4F5C\u76EE\u5F55\u8DEF\u5F84\uFF1A${workdir}`);
+}
+
+// src/commands/login.ts
+init_config();
+init_client();
+import { existsSync as existsSync3 } from "fs";
+import { ApiError } from "listpage-http";
 
 // src/deployment-config-sync.ts
 init_client();
-import { join as join4 } from "path";
-import { writeFileSync as writeFileSync3 } from "fs";
+import { join as join5 } from "path";
+import { writeFileSync as writeFileSync4 } from "fs";
 
 // src/git-remote.ts
 import { execFile } from "child_process";
@@ -1455,16 +1574,16 @@ init_config();
 import {
   existsSync as existsSync2,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   readdirSync as readdirSync2,
   statSync as statSync2,
-  writeFileSync as writeFileSync2
+  writeFileSync as writeFileSync3
 } from "fs";
-import { basename as basename2, dirname as dirname2, join as join3, relative, resolve as resolve3 } from "path";
+import { basename as basename2, dirname as dirname2, join as join4, relative, resolve as resolve3 } from "path";
 var WORKSPACE_REPOS_MANIFEST = "workspace-repos.json";
 var WORKSPACE_REPOS_VERSION = 1;
 function manifestPath(workdir) {
-  return join3(workspaceApmDir(workdir), WORKSPACE_REPOS_MANIFEST);
+  return join4(workspaceApmDir(workdir), WORKSPACE_REPOS_MANIFEST);
 }
 function absoluteRepoPath(workdir, entry) {
   if (entry.path === "." || entry.path === "") {
@@ -1493,7 +1612,7 @@ function readManifest(workdir) {
   }
   try {
     const raw = JSON.parse(
-      readFileSync2(path19, "utf8")
+      readFileSync3(path19, "utf8")
     );
     if (raw?.version !== WORKSPACE_REPOS_VERSION) {
       return null;
@@ -1526,7 +1645,7 @@ function writeManifest(workdir, manifest) {
   const apmDir = toFsPath(workspaceApmDir(workdir));
   mkdirSync3(apmDir, { recursive: true });
   const path19 = toFsPath(manifestPath(workdir));
-  writeFileSync2(path19, `${JSON.stringify(manifest, null, 2)}
+  writeFileSync3(path19, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
 }
 function isPathInsideOrEqual(parentAbs, childAbs) {
@@ -1679,8 +1798,8 @@ async function writeDeploymentConfigContent(apmDir, content, configName) {
     );
     return false;
   }
-  const apmConfigPath = toFsPath(join4(apmDir, "apm.config.json"));
-  writeFileSync3(apmConfigPath, `${JSON.stringify(parsed, null, 2)}
+  const apmConfigPath = toFsPath(join5(apmDir, "apm.config.json"));
+  writeFileSync4(apmConfigPath, `${JSON.stringify(parsed, null, 2)}
 `, "utf8");
   console.log(`[apm] \u5DF2\u540C\u6B65\u5E73\u53F0\u90E8\u7F72\u914D\u7F6E: ${configName}`);
   console.log("[apm] \u5DF2\u5199\u5165 .apm/apm.config.json");
@@ -1732,324 +1851,7 @@ ${diagnostic ?? ""}
   return { synced: true, repositoryId, configName: config.name };
 }
 
-// src/project-documents-sync.ts
-init_client();
-init_config();
-import {
-  existsSync as existsSync3,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync3,
-  rmSync,
-  writeFileSync as writeFileSync4
-} from "fs";
-import { createHash } from "crypto";
-import { dirname as dirname3, join as join5, relative as relative2, sep } from "path";
-var MANIFEST_FILE = "manifest.json";
-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 join5(apmRoot ?? workspaceApmDir(), "project", id);
-}
-function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
-  const normalized = normalizeLocalDocumentPath(documentPath);
-  return join5(
-    projectDocumentsDir(apmRoot, projectId),
-    ...normalized.split("/")
-  );
-}
-function normalizeLocalDocumentPath(path19) {
-  const trimmed = path19.trim().replace(/\\/g, "/");
-  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path19}`);
-  }
-  const segments = trimmed.split("/").filter(Boolean);
-  if (segments.some((segment) => segment === ".." || segment === ".")) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path19}`);
-  }
-  return segments.join("/");
-}
-function hashLocalFileContent(content) {
-  return createHash("sha256").update(content, "utf8").digest("hex");
-}
-function readLocalManifest(apmRoot, projectId) {
-  const manifestPath3 = join5(
-    projectDocumentsDir(apmRoot, projectId),
-    MANIFEST_FILE
-  );
-  if (!existsSync3(manifestPath3)) {
-    return null;
-  }
-  try {
-    return JSON.parse(
-      readFileSync3(manifestPath3, "utf8")
-    );
-  } catch {
-    return null;
-  }
-}
-function listLocalDocumentPaths(apmRoot, projectId) {
-  const root = projectDocumentsDir(apmRoot, projectId);
-  if (!existsSync3(root)) {
-    return [];
-  }
-  const paths = [];
-  const walk = (dir) => {
-    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-      const abs = join5(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])
-  );
-  const localMap = new Map(
-    (local?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
-  );
-  const download = [];
-  for (const [path19, hash] of remoteMap) {
-    if (localMap.get(path19) !== hash) {
-      download.push(path19);
-    }
-  }
-  const deleteLocal = [];
-  for (const path19 of localMap.keys()) {
-    if (!remoteMap.has(path19)) {
-      deleteLocal.push(path19);
-    }
-  }
-  return { download, deleteLocal };
-}
-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;
-    if (projectId) {
-      return { projectId, diagnostic: null };
-    }
-    const projectIds = baseline.projectIds ?? [];
-    if (projectIds.length === 0) {
-      return {
-        projectId: null,
-        diagnostic: baseline.diagnostic?.message ?? `\u5DE5\u4F5C\u7A7A\u95F4\u672A\u5173\u8054\u9879\u76EE\uFF0C\u65E0\u6CD5\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF08\u76EE\u5F55\uFF1A${workdirPath}\uFF09\u3002
-\u8BF7\u5728\u5E73\u53F0\u5C06\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u5230\u552F\u4E00\u9879\u76EE\u3002`
-      };
-    }
-    return {
-      projectId: null,
-      diagnostic: `\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u4E86 ${projectIds.length} \u4E2A\u9879\u76EE\uFF0C\u65E0\u6CD5\u786E\u5B9A\u540C\u6B65\u76EE\u6807\u3002
-\u8BF7\u786E\u4FDD\u8BE5\u5DE5\u4F5C\u7A7A\u95F4\u53EA\u5173\u8054\u4E00\u4E2A\u9879\u76EE\u540E\u518D\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002`
-    };
-  } catch (err) {
-    const detail = err instanceof Error ? err.message : String(err);
-    return {
-      projectId: null,
-      diagnostic: detail.replace(/^\[apm\]\s*/, "")
-    };
-  }
-}
-async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
-  const empty = {
-    synced: false,
-    projectId: null,
-    downloaded: 0,
-    deleted: 0
-  };
-  const cfg = await tryReadApmConfig();
-  if (!cfg || !resolveApiKey(cfg)) {
-    console.log(
-      "[apm] \u672A\u68C0\u6D4B\u5230\u767B\u5F55\u4FE1\u606F\uFF0C\u8DF3\u8FC7\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
-    );
-    return empty;
-  }
-  const api = createApmApiClient(cfg);
-  const { projectId, diagnostic } = await resolveProjectIdForSync(
-    api,
-    workdirPath,
-    options
-  );
-  if (!projectId) {
-    console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
-${diagnostic ?? ""}`);
-    return empty;
-  }
-  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const docsDir = projectDocumentsDir(targetApmDir, projectId);
-  await ensureDirExists(docsDir);
-  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, projectId);
-  const { download, deleteLocal } = diffManifestPaths(
-    remoteManifest,
-    localManifest
-  );
-  let downloaded = 0;
-  if (download.length > 0) {
-    const { list } = await api.cli.listProjectDocuments({
-      projectId,
-      paths: download.join(",")
-    });
-    for (const doc of list) {
-      const absPath = toFsPath(
-        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
-      );
-      await ensureDirExists(dirname3(absPath));
-      writeFileSync4(absPath, doc.content, "utf8");
-      downloaded += 1;
-    }
-  }
-  let deleted = 0;
-  for (const path19 of deleteLocal) {
-    const absPath = toFsPath(
-      projectDocumentLocalPath(targetApmDir, projectId, path19)
-    );
-    if (existsSync3(absPath)) {
-      rmSync(absPath, { force: true });
-      deleted += 1;
-    }
-  }
-  writeFileSync4(
-    toFsPath(join5(docsDir, MANIFEST_FILE)),
-    `${JSON.stringify(remoteManifest, null, 2)}
-`,
-    "utf8"
-  );
-  console.log(
-    `[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,
-    projectId,
-    downloaded,
-    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 path19 of localPaths) {
-    const absPath = toFsPath(
-      projectDocumentLocalPath(targetApmDir, projectId, path19)
-    );
-    const content = readFileSync3(absPath, "utf8");
-    const contentHash = hashLocalFileContent(content);
-    if (remoteHashByPath.get(path19) === contentHash) {
-      continue;
-    }
-    await api.cli.upsertProjectDocument({
-      projectId,
-      path: path19,
-      content,
-      description: remoteDescriptionByPath.get(path19) ?? void 0
-    });
-    synced += 1;
-    console.log(`[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: ${path19}`);
-  }
-  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 initializeWorkspace(workdir, options) {
-  await ensureWorkspaceApmDirForInit(workdir);
-  const apmDir = workspaceApmDir(workdir);
-  await copyTemplateFiles(apmDir, workdir);
-  const syncResult = await syncRemoteDeploymentConfig(workdir, apmDir);
-  await syncProjectDocumentsPull(workdir, apmDir);
-  const trimmedName = options?.name?.trim();
-  if (trimmedName) {
-    const apmConfigPath = toFsPath(join6(apmDir, "apm.config.json"));
-    const config = readFileSync4(apmConfigPath, "utf8");
-    const configJson = JSON.parse(config);
-    configJson.name = trimmedName;
-    writeFileSync5(
-      apmConfigPath,
-      `${JSON.stringify(configJson, null, 2)}
-`,
-      "utf8"
-    );
-  }
-  console.log(`[apm] \u5DF2\u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}`);
-  return { didInit: true, syncResult };
-}
-async function ensureWorkspaceInitialized(workdir, options) {
-  if (isWorkspaceApmInitialized(workdir)) {
-    return { didInit: false };
-  }
-  console.log(
-    `[apm] \u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u672A\u68C0\u6D4B\u5230\u5DF2\u521D\u59CB\u5316\u7684 .apm\uFF0C\u6B63\u5728\u81EA\u52A8\u521D\u59CB\u5316\u2026`
-  );
-  return initializeWorkspace(workdir, options);
-}
-async function runInit(name) {
-  const workdir = resolveWorkdirPath();
-  const { syncResult } = await initializeWorkspace(workdir, { name });
-  console.log(`[apm] \u5DE5\u4F5C\u76EE\u5F55\u8DEF\u5F84\uFF1A${workdir}`);
-  if (syncResult && !syncResult.synced) {
-    console.log(
-      "[apm] \u5F53\u524D .apm/apm.config.json \u4E3A\u6A21\u677F\u9ED8\u8BA4\u503C\uFF1B\u5B8C\u6210\u5E73\u53F0\u767B\u8BB0\u540E\u6267\u884C apm sync-deploy-config"
-    );
-  }
-  console.log("[apm] \u8BF7\u5728\u5E73\u53F0\u300C\u63A5\u5165\u7BA1\u7406 \u2192 \u5DE5\u4F5C\u7A7A\u95F4\u300D\u767B\u8BB0\u4E0A\u8FF0\u76EE\u5F55\u8DEF\u5F84");
-}
-
 // src/commands/login.ts
-init_config();
-init_client();
-import { existsSync as existsSync4 } from "fs";
-import { ApiError } from "listpage-http";
 async function runLogin(opts) {
   const baseUrl = (opts.server?.trim() || process.env.AI_PM_SERVER?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
   const apiKey = (opts.apiKey?.trim() || process.env.APM_API_KEY?.trim() || "").replace(/^Bearer\s+/i, "");
@@ -2103,7 +1905,7 @@ async function runLogin(opts) {
   );
   const workdir = resolveWorkdirPath();
   const apmDir = workspaceApmDir(workdir);
-  if (existsSync4(apmDir)) {
+  if (existsSync3(apmDir)) {
     await syncRemoteDeploymentConfig(workdir, apmDir);
   }
 }
@@ -2593,9 +2395,9 @@ function formatSessionMessagesXml(sessionId, messages) {
 }
 
 // src/commands/sync-session-attachments.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
-import { join as join7 } from "path";
-var MANIFEST_FILE2 = ".sync-manifest.json";
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
+import { join as join6 } from "path";
+var MANIFEST_FILE = ".sync-manifest.json";
 async function downloadAttachment(cfg, attachmentId) {
   const base = cfg.baseUrl.trim().replace(/\/+$/, "");
   const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
@@ -2610,13 +2412,13 @@ async function downloadAttachment(cfg, attachmentId) {
   return Buffer.from(await res.arrayBuffer());
 }
 function loadManifest(dir) {
-  const path19 = join7(dir, MANIFEST_FILE2);
-  if (!existsSync5(path19)) {
+  const path19 = join6(dir, MANIFEST_FILE);
+  if (!existsSync4(path19)) {
     return { version: 1, attachments: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync5(path19, "utf8")
+      readFileSync4(path19, "utf8")
     );
     if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
       return parsed;
@@ -2626,15 +2428,15 @@ function loadManifest(dir) {
   return { version: 1, attachments: {} };
 }
 function saveManifest(dir, manifest) {
-  writeFileSync6(
-    join7(dir, MANIFEST_FILE2),
+  writeFileSync5(
+    join6(dir, MANIFEST_FILE),
     `${JSON.stringify(manifest, null, 2)}
 `,
     "utf8"
   );
 }
 function isAttachmentUpToDate(entry, item, dest) {
-  if (!entry || !existsSync5(dest)) return false;
+  if (!entry || !existsSync4(dest)) return false;
   if (entry.name !== item.name) return false;
   const createdAt = item.createdAt ?? "";
   return entry.createdAt === createdAt;
@@ -2649,7 +2451,7 @@ async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
   const nextManifest = { version: 1, attachments: {} };
   const names = [];
   for (const item of attachments) {
-    const dest = join7(dir, item.name);
+    const dest = join6(dir, item.name);
     const entry = manifest.attachments[item.id];
     const createdAt = item.createdAt ?? "";
     names.push(item.name);
@@ -2659,7 +2461,7 @@ async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
       continue;
     }
     const buffer = await downloadAttachment(cfg, item.id);
-    writeFileSync6(dest, buffer);
+    writeFileSync5(dest, buffer);
     nextManifest.attachments[item.id] = {
       name: item.name,
       createdAt
@@ -2670,7 +2472,7 @@ async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
   return names;
 }
 async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
-  const dir = join7(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
   return syncAttachmentsToDirectory(
     cfg,
     attachments,
@@ -2681,46 +2483,46 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
 
 // src/rules-sync.ts
 init_client();
-import { basename as basename3, extname as extname2, join as join9 } from "path";
-import { existsSync as existsSync7, readFileSync as readFileSync6, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "fs";
+import { basename as basename3, extname as extname2, join as join8 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync5, rmSync as rmSync2, writeFileSync as writeFileSync7 } from "fs";
 
 // src/skills-sync.ts
 import {
   copyFileSync as copyFileSync2,
   cpSync,
-  existsSync as existsSync6,
+  existsSync as existsSync5,
   mkdirSync as mkdirSync4,
-  readdirSync as readdirSync4,
-  rmSync as rmSync2,
+  readdirSync as readdirSync3,
+  rmSync,
   statSync as statSync3,
-  writeFileSync as writeFileSync7
+  writeFileSync as writeFileSync6
 } from "fs";
-import { join as join8 } from "path";
-var AGENTS_TEMPLATE_PATH = join8(CLI_TEMPLATE_DIR, "AGENTS.md");
-var BASE_SKILLS_TEMPLATE_DIR = join8(CLI_TEMPLATE_DIR, "skills");
-var BASE_RULES_TEMPLATE_DIR = join8(CLI_TEMPLATE_DIR, "rules");
+import { join as join7 } from "path";
+var AGENTS_TEMPLATE_PATH = join7(CLI_TEMPLATE_DIR, "AGENTS.md");
+var BASE_SKILLS_TEMPLATE_DIR = join7(CLI_TEMPLATE_DIR, "skills");
+var BASE_RULES_TEMPLATE_DIR = join7(CLI_TEMPLATE_DIR, "rules");
 function sanitizeSkillDirName(name) {
   const trimmed = name.trim();
   if (!trimmed) return "skill";
   return trimmed.replace(/[/\\:*?"<>|]/g, "_");
 }
 function listBaseSkillDirNames() {
-  if (!existsSync6(BASE_SKILLS_TEMPLATE_DIR)) return [];
-  return readdirSync4(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
-    const path19 = join8(BASE_SKILLS_TEMPLATE_DIR, name);
+  if (!existsSync5(BASE_SKILLS_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
+    const path19 = join7(BASE_SKILLS_TEMPLATE_DIR, name);
     return statSync3(path19).isDirectory();
   });
 }
 function syncAgentsGuide(apmDir) {
-  if (!existsSync6(AGENTS_TEMPLATE_PATH)) return false;
+  if (!existsSync5(AGENTS_TEMPLATE_PATH)) return false;
   mkdirSync4(apmDir, { recursive: true });
-  copyFileSync2(AGENTS_TEMPLATE_PATH, join8(apmDir, "AGENTS.md"));
+  copyFileSync2(AGENTS_TEMPLATE_PATH, join7(apmDir, "AGENTS.md"));
   return true;
 }
 function listBaseRuleFileNames() {
-  if (!existsSync6(BASE_RULES_TEMPLATE_DIR)) return [];
-  return readdirSync4(BASE_RULES_TEMPLATE_DIR).filter((name) => {
-    const path19 = join8(BASE_RULES_TEMPLATE_DIR, name);
+  if (!existsSync5(BASE_RULES_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_RULES_TEMPLATE_DIR).filter((name) => {
+    const path19 = join7(BASE_RULES_TEMPLATE_DIR, name);
     return statSync3(path19).isFile();
   });
 }
@@ -2728,8 +2530,8 @@ function syncBaseRules(rulesDir) {
   mkdirSync4(rulesDir, { recursive: true });
   const names = listBaseRuleFileNames();
   for (const name of names) {
-    const src = join8(BASE_RULES_TEMPLATE_DIR, name);
-    const dest = join8(rulesDir, name);
+    const src = join7(BASE_RULES_TEMPLATE_DIR, name);
+    const dest = join7(rulesDir, name);
     copyFileSync2(src, dest);
   }
   return names;
@@ -2738,8 +2540,8 @@ function syncBaseSkills(skillsDir) {
   mkdirSync4(skillsDir, { recursive: true });
   const names = listBaseSkillDirNames();
   for (const name of names) {
-    const src = join8(BASE_SKILLS_TEMPLATE_DIR, name);
-    const dest = join8(skillsDir, name);
+    const src = join7(BASE_SKILLS_TEMPLATE_DIR, name);
+    const dest = join7(skillsDir, name);
     cpSync(src, dest, { recursive: true, force: true });
   }
   return names;
@@ -2756,26 +2558,26 @@ function syncSupplementarySkills(skillsDir, list) {
       skipped.push(dirName);
       continue;
     }
-    const skillDir = join8(skillsDir, dirName);
+    const skillDir = join7(skillsDir, dirName);
     mkdirSync4(skillDir, { recursive: true });
-    writeFileSync7(join8(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
+    writeFileSync6(join7(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
     written.push(dirName);
   }
   const removed = [];
-  if (!existsSync6(skillsDir)) return { written, skipped, removed };
-  for (const entry of readdirSync4(skillsDir)) {
-    const full = join8(skillsDir, entry);
+  if (!existsSync5(skillsDir)) return { written, skipped, removed };
+  for (const entry of readdirSync3(skillsDir)) {
+    const full = join7(skillsDir, entry);
     if (!statSync3(full).isDirectory()) continue;
     if (baseNames.has(entry)) continue;
     if (apiDirNames.has(entry)) continue;
-    rmSync2(full, { recursive: true, force: true });
+    rmSync(full, { recursive: true, force: true });
     removed.push(entry);
   }
   return { written, skipped, removed };
 }
 
 // src/rules-sync.ts
-var MANIFEST_FILE3 = ".rules-sync-manifest.json";
+var MANIFEST_FILE2 = ".rules-sync-manifest.json";
 function ruleLocalFileName(ruleName) {
   const trimmed = ruleName.trim();
   if (!trimmed) return "rule.md";
@@ -2784,13 +2586,13 @@ function ruleLocalFileName(ruleName) {
   return `${sanitized}.md`;
 }
 function loadManifest2(rulesDir) {
-  const path19 = join9(rulesDir, MANIFEST_FILE3);
-  if (!existsSync7(toFsPath(path19))) {
+  const path19 = join8(rulesDir, MANIFEST_FILE2);
+  if (!existsSync6(toFsPath(path19))) {
     return { version: 1, rules: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync6(toFsPath(path19), "utf8")
+      readFileSync5(toFsPath(path19), "utf8")
     );
     if (parsed?.version === 1 && parsed.rules && typeof parsed.rules === "object") {
       return parsed;
@@ -2800,8 +2602,8 @@ function loadManifest2(rulesDir) {
   return { version: 1, rules: {} };
 }
 function saveManifest2(rulesDir, manifest) {
-  writeFileSync8(
-    toFsPath(join9(rulesDir, MANIFEST_FILE3)),
+  writeFileSync7(
+    toFsPath(join8(rulesDir, MANIFEST_FILE2)),
     `${JSON.stringify(manifest, null, 2)}
 `,
     "utf8"
@@ -2811,18 +2613,18 @@ function isBaseRuleFileName(fileName) {
   return listBaseRuleFileNames().includes(basename3(fileName));
 }
 function isRuleUpToDate(entry, rule, dest) {
-  if (!entry || !existsSync7(toFsPath(dest))) return false;
+  if (!entry || !existsSync6(toFsPath(dest))) return false;
   if (entry.fileName !== ruleLocalFileName(rule.name)) return false;
   const updatedAt = rule.updatedAt ?? "";
   if (entry.updatedAt !== updatedAt) return false;
-  const localContent = readFileSync6(toFsPath(dest), "utf8");
+  const localContent = readFileSync5(toFsPath(dest), "utf8");
   return localContent === (rule.content ?? "");
 }
 async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   const api = createApmApiClient(cfg);
   const baseline = await resolveBranchBaseline(api, sessionId, workdirPath);
   const repositoryId = baseline.repositoryId;
-  const rulesDir = join9(apmRoot ?? workspaceApmDir(workdirPath), "rules");
+  const rulesDir = join8(apmRoot ?? workspaceApmDir(workdirPath), "rules");
   await ensureDirExists(rulesDir);
   if (!repositoryId) {
     console.log(
@@ -2839,7 +2641,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   for (const rule of list) {
     remoteIds.add(rule.id);
     const fileName = ruleLocalFileName(rule.name);
-    const dest = join9(rulesDir, fileName);
+    const dest = join8(rulesDir, fileName);
     const entry = manifest.rules[rule.id];
     const updatedAt = rule.updatedAt ?? "";
     if (isRuleUpToDate(entry, rule, dest)) {
@@ -2848,7 +2650,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
       console.log(`[apm] \u89C4\u5219\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: rules/${fileName}`);
       continue;
     }
-    writeFileSync8(toFsPath(dest), rule.content ?? "", "utf8");
+    writeFileSync7(toFsPath(dest), rule.content ?? "", "utf8");
     nextManifest.rules[rule.id] = { fileName, updatedAt };
     written.push(fileName);
     console.log(`[apm] \u5DF2\u540C\u6B65\u5E73\u53F0\u89C4\u5219: rules/${fileName}`);
@@ -2857,9 +2659,9 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   for (const [ruleId, entry] of Object.entries(manifest.rules)) {
     if (remoteIds.has(ruleId)) continue;
     if (isBaseRuleFileName(entry.fileName)) continue;
-    const dest = join9(rulesDir, entry.fileName);
-    if (existsSync7(toFsPath(dest))) {
-      rmSync3(toFsPath(dest), { force: true });
+    const dest = join8(rulesDir, entry.fileName);
+    if (existsSync6(toFsPath(dest))) {
+      rmSync2(toFsPath(dest), { force: true });
     }
     removed.push(entry.fileName);
     console.log(`[apm] \u5DF2\u79FB\u9664\u5DF2\u4E0B\u7EBF\u7684\u5E73\u53F0\u89C4\u5219: rules/${entry.fileName}`);
@@ -2868,6 +2670,275 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   return { written, skipped, removed, repositoryId };
 }
 
+// src/project-documents-sync.ts
+init_client();
+init_config();
+import {
+  existsSync as existsSync7,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync6,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync8
+} from "fs";
+import { createHash } from "crypto";
+import { dirname as dirname3, join as join9, relative as relative2, sep } from "path";
+var MANIFEST_FILE3 = "manifest.json";
+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 join9(apmRoot ?? workspaceApmDir(), "project", id);
+}
+function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
+  const normalized = normalizeLocalDocumentPath(documentPath);
+  return join9(
+    projectDocumentsDir(apmRoot, projectId),
+    ...normalized.split("/")
+  );
+}
+function normalizeLocalDocumentPath(path19) {
+  const trimmed = path19.trim().replace(/\\/g, "/");
+  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path19}`);
+  }
+  const segments = trimmed.split("/").filter(Boolean);
+  if (segments.some((segment) => segment === ".." || segment === ".")) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path19}`);
+  }
+  return segments.join("/");
+}
+function hashLocalFileContent(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function readLocalManifest(apmRoot, projectId) {
+  const manifestPath3 = join9(
+    projectDocumentsDir(apmRoot, projectId),
+    MANIFEST_FILE3
+  );
+  if (!existsSync7(manifestPath3)) {
+    return null;
+  }
+  try {
+    return JSON.parse(
+      readFileSync6(manifestPath3, "utf8")
+    );
+  } catch {
+    return null;
+  }
+}
+function listLocalDocumentPaths(apmRoot, projectId) {
+  const root = projectDocumentsDir(apmRoot, projectId);
+  if (!existsSync7(root)) {
+    return [];
+  }
+  const paths = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync4(dir, { withFileTypes: true })) {
+      const abs = join9(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (entry.isFile() && entry.name === MANIFEST_FILE3) {
+        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])
+  );
+  const localMap = new Map(
+    (local?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
+  );
+  const download = [];
+  for (const [path19, hash] of remoteMap) {
+    if (localMap.get(path19) !== hash) {
+      download.push(path19);
+    }
+  }
+  const deleteLocal = [];
+  for (const path19 of localMap.keys()) {
+    if (!remoteMap.has(path19)) {
+      deleteLocal.push(path19);
+    }
+  }
+  return { download, deleteLocal };
+}
+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;
+    if (projectId) {
+      return { projectId, diagnostic: null };
+    }
+    const projectIds = baseline.projectIds ?? [];
+    if (projectIds.length === 0) {
+      return {
+        projectId: null,
+        diagnostic: baseline.diagnostic?.message ?? `\u5DE5\u4F5C\u7A7A\u95F4\u672A\u5173\u8054\u9879\u76EE\uFF0C\u65E0\u6CD5\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF08\u76EE\u5F55\uFF1A${workdirPath}\uFF09\u3002
+\u8BF7\u5728\u5E73\u53F0\u5C06\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u5230\u552F\u4E00\u9879\u76EE\u3002`
+      };
+    }
+    return {
+      projectId: null,
+      diagnostic: `\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u4E86 ${projectIds.length} \u4E2A\u9879\u76EE\uFF0C\u65E0\u6CD5\u786E\u5B9A\u540C\u6B65\u76EE\u6807\u3002
+\u8BF7\u786E\u4FDD\u8BE5\u5DE5\u4F5C\u7A7A\u95F4\u53EA\u5173\u8054\u4E00\u4E2A\u9879\u76EE\u540E\u518D\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002`
+    };
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return {
+      projectId: null,
+      diagnostic: detail.replace(/^\[apm\]\s*/, "")
+    };
+  }
+}
+async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
+  const empty = {
+    synced: false,
+    projectId: null,
+    downloaded: 0,
+    deleted: 0
+  };
+  const cfg = await tryReadApmConfig();
+  if (!cfg || !resolveApiKey(cfg)) {
+    console.log(
+      "[apm] \u672A\u68C0\u6D4B\u5230\u767B\u5F55\u4FE1\u606F\uFF0C\u8DF3\u8FC7\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
+    );
+    return empty;
+  }
+  const api = createApmApiClient(cfg);
+  const { projectId, diagnostic } = await resolveProjectIdForSync(
+    api,
+    workdirPath,
+    options
+  );
+  if (!projectId) {
+    console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
+${diagnostic ?? ""}`);
+    return empty;
+  }
+  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
+  const docsDir = projectDocumentsDir(targetApmDir, projectId);
+  await ensureDirExists(docsDir);
+  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, projectId);
+  const { download, deleteLocal } = diffManifestPaths(
+    remoteManifest,
+    localManifest
+  );
+  let downloaded = 0;
+  if (download.length > 0) {
+    const { list } = await api.cli.listProjectDocuments({
+      projectId,
+      paths: download.join(",")
+    });
+    for (const doc of list) {
+      const absPath = toFsPath(
+        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
+      );
+      await ensureDirExists(dirname3(absPath));
+      writeFileSync8(absPath, doc.content, "utf8");
+      downloaded += 1;
+    }
+  }
+  let deleted = 0;
+  for (const path19 of deleteLocal) {
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path19)
+    );
+    if (existsSync7(absPath)) {
+      rmSync3(absPath, { force: true });
+      deleted += 1;
+    }
+  }
+  writeFileSync8(
+    toFsPath(join9(docsDir, MANIFEST_FILE3)),
+    `${JSON.stringify(remoteManifest, null, 2)}
+`,
+    "utf8"
+  );
+  console.log(
+    `[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,
+    projectId,
+    downloaded,
+    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 path19 of localPaths) {
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path19)
+    );
+    const content = readFileSync6(absPath, "utf8");
+    const contentHash = hashLocalFileContent(content);
+    if (remoteHashByPath.get(path19) === contentHash) {
+      continue;
+    }
+    await api.cli.upsertProjectDocument({
+      projectId,
+      path: path19,
+      content,
+      description: remoteDescriptionByPath.get(path19) ?? void 0
+    });
+    synced += 1;
+    console.log(`[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: ${path19}`);
+  }
+  if (synced === 0) {
+    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+  }
+  return synced;
+}
+
 // src/commands/pull.ts
 async function runPull(sessionId, remoteWorkdir) {
   const trimmedId = sessionId.trim();
@@ -10557,10 +10628,11 @@ function buildProgram() {
   ).option("--api-key <key>", "\u5BA2\u6237\u673A API Key\uFF08cm_ \u5F00\u5934\uFF09").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(async (opts) => {
     await runLogin(opts);
   });
-  program.command("init").description(
-    "\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521B\u5EFA .apm \u5E76\u521D\u59CB\u5316\u6A21\u677F\uFF1B\u5DF2\u767B\u5F55\u4E14\u5E73\u53F0\u6709\u5339\u914D\u90E8\u7F72\u914D\u7F6E\u65F6\u4F1A\u540C\u6B65 apm.config.json"
-  ).option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").action(async (opts) => {
-    await runInit(opts.name);
+  program.command("init").description("\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521B\u5EFA .apm \u5E76\u521D\u59CB\u5316\u6A21\u677F").option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").option(
+    "--webide",
+    "\u6309 WebIDE \u5DE5\u4F5C\u533A\u521D\u59CB\u5316\uFF1A\u4EC5 webide \u89C4\u5219\u4E0E\u6307\u5357\uFF0C\u4E0D\u542B sessions / skills / deploy"
+  ).action(async (opts) => {
+    await runInit(opts.name, { webide: opts.webide === true });
   });
   program.command("update").description(
     `\u901A\u8FC7 npm \u5168\u5C40\u5B89\u88C5 ${CLI_PACKAGE_NAME}\uFF0C\u9ED8\u8BA4\u66F4\u65B0\u5230\u5F53\u524D\u5927\u7248\u672C\uFF08${parseMajorVersion(