ai-project-manage-cli 5.0.14 → 5.0.16

package/dist/index.js

@@ -10,6 +10,12 @@ import { join } from "path";
 var APM_CONFIG_DIR = join(homedir(), ".config", "apm");
 var APM_CONFIG_PATH = join(APM_CONFIG_DIR, "config.json");
 var DEFAULT_BASE_URL = "http://127.0.0.1:3000";
+function resolveClientMachineId(cfg) {
+  return (cfg.clientMachineId ?? cfg.userId ?? "").trim();
+}
+function resolveAccount(cfg) {
+  return (cfg.account ?? cfg.email ?? "").trim();
+}
 async function readApmConfig() {
   try {
     const raw = readFileSync(APM_CONFIG_PATH, "utf8");
@@ -18,14 +24,17 @@ async function readApmConfig() {
       return null;
     }
     const rawCfg = v;
-    if (typeof rawCfg.baseUrl !== "string" || typeof rawCfg.userId !== "string" || typeof rawCfg.token !== "string") {
+    if (typeof rawCfg.baseUrl !== "string" || typeof rawCfg.token !== "string") {
       return null;
     }
     const cfg = v;
+    const clientMachineId = resolveClientMachineId(cfg);
+    const account = resolveAccount(cfg);
     return {
       baseUrl: cfg.baseUrl.trim().replace(/\/+$/, ""),
-      userId: cfg.userId,
       token: cfg.token,
+      ...clientMachineId ? { clientMachineId } : {},
+      ...account ? { account } : {},
       ...typeof cfg.email === "string" ? { email: cfg.email } : {}
     };
   } catch {
@@ -35,8 +44,9 @@ async function readApmConfig() {
 function defaultApmConfig() {
   return {
     baseUrl: DEFAULT_BASE_URL,
-    userId: "",
+    clientMachineId: "",
     token: "",
+    account: "",
     email: ""
   };
 }
@@ -54,11 +64,13 @@ async function ensureApmConfig() {
   return defaults;
 }
 async function writeApmConfig(cfg) {
+  const clientMachineId = resolveClientMachineId(cfg);
+  const account = resolveAccount(cfg);
   const normalized = {
     baseUrl: cfg.baseUrl.trim().replace(/\/+$/, ""),
-    userId: cfg.userId,
     token: cfg.token,
-    ...typeof cfg.email === "string" ? { email: cfg.email } : {}
+    ...clientMachineId ? { clientMachineId } : {},
+    ...account ? { account, email: account } : {}
   };
   mkdirSync(APM_CONFIG_DIR, { recursive: true });
   writeFileSync(APM_CONFIG_PATH, JSON.stringify(normalized, null, 2) + "\n", {
@@ -96,6 +108,12 @@ function sessionDocsDir(sessionId, apmRoot) {
 function sessionRulePath(sessionId, apmRoot) {
   return join2(sessionDir(sessionId, apmRoot), "RULE.md");
 }
+function sessionTaskPath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "TASK.md");
+}
+function sessionLogPath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "LOG.md");
+}
 function sessionYamlPath(sessionId, apmRoot) {
   return join2(sessionDir(sessionId, apmRoot), "session.yaml");
 }
@@ -231,7 +249,7 @@ var requestConfig = {
     }),
     branchBaseline: defineEndpoint({
       method: "GET",
-      path: "/cli/requirements/branch-baseline"
+      path: "/cli/tasks/branch-baseline"
     }),
     listSkills: defineEndpoint({
       method: "GET",
@@ -256,13 +274,13 @@ async function runLogin(opts) {
   const baseUrl = (opts.server?.trim() || process.env.AI_PM_SERVER?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
   const api = createApmApiClient({
     baseUrl,
-    userId: "",
+    clientMachineId: "",
     token: ""
   });
   let data;
   try {
     data = await api.auth.login({
-      email: opts.email,
+      account: opts.email,
       password: opts.password
     });
   } catch (raw) {
@@ -277,24 +295,29 @@ async function runLogin(opts) {
     console.error("[apm] \u8BF7\u6C42\u5931\u8D25:", raw instanceof Error ? raw.message : raw);
     process.exit(1);
   }
-  const userId = data?.user?.id;
+  const clientMachineId = data?.clientMachine?.id;
   const token = data?.token;
-  if (!userId || !token) {
+  if (!clientMachineId || !token) {
     console.error(
-      "[apm] \u54CD\u5E94\u7F3A\u5C11 user.id / token\uFF08\u8BF7\u786E\u8BA4\u670D\u52A1\u7AEF\u4E3A /api/v1/auth/login\uFF09"
+      "[apm] \u54CD\u5E94\u7F3A\u5C11 clientMachine.id / token\uFF08\u8BF7\u786E\u8BA4\u670D\u52A1\u7AEF\u4E3A /api/v1/auth/login\uFF09"
     );
     process.exit(1);
   }
   const cfg = {
     baseUrl,
-    userId,
+    clientMachineId,
     token,
+    account: opts.email,
     email: opts.email
   };
   await writeApmConfig(cfg);
   console.error(`[apm] \u5DF2\u4FDD\u5B58\u767B\u5F55\u4FE1\u606F: ${APM_CONFIG_PATH}`);
   console.log(
-    JSON.stringify({ userId: cfg.userId, baseUrl: cfg.baseUrl }, null, 2)
+    JSON.stringify(
+      { clientMachineId: cfg.clientMachineId, baseUrl: cfg.baseUrl },
+      null,
+      2
+    )
   );
 }
 
@@ -489,7 +512,7 @@ function formatSessionMessagesXml(sessionId, messages) {
     lines.push(
       `  <message id="${escapeXmlAttr(message.id)}" name="${escapeXmlAttr(
         message.name
-      )}" position="${escapeXmlAttr(message.position)}"${roundAttr}>`,
+      )}" expert="${escapeXmlAttr(message.expert)}"${roundAttr}>`,
       `    <content>${wrapCdata(message.content)}</content>`,
       "  </message>"
     );
@@ -603,6 +626,12 @@ async function runPull(sessionId, apmRoot) {
     detail.description ?? "",
     "utf8"
   );
+  writeFileSync4(
+    sessionTaskPath(trimmedId, apmRoot),
+    detail.task.description ?? "",
+    "utf8"
+  );
+  writeFileSync4(sessionLogPath(trimmedId, apmRoot), detail.log ?? "", "utf8");
   for (const doc of documents) {
     const fileName = documentLocalFileName(doc.name);
     writeFileSync4(join5(docsDir, fileName), doc.content ?? "", "utf8");
@@ -613,7 +642,7 @@ async function runPull(sessionId, apmRoot) {
       description: "./RULE.md",
       members: members.map((m) => ({
         name: m.displayName,
-        position: m.position,
+        expert: m.expert,
         system_persona: m.systemPersona,
         skills: []
       })),
@@ -734,6 +763,7 @@ import {
 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";
@@ -752,6 +782,23 @@ function syncAgentsGuide(apmDir) {
   copyFileSync(AGENTS_TEMPLATE_PATH, join7(apmDir, "AGENTS.md"));
   return true;
 }
+function listBaseRuleFileNames() {
+  if (!existsSync3(BASE_RULES_TEMPLATE_DIR)) return [];
+  return readdirSync2(BASE_RULES_TEMPLATE_DIR).filter((name) => {
+    const path8 = join7(BASE_RULES_TEMPLATE_DIR, name);
+    return statSync2(path8).isFile();
+  });
+}
+function syncBaseRules(rulesDir) {
+  mkdirSync3(rulesDir, { recursive: true });
+  const names = listBaseRuleFileNames();
+  for (const name of names) {
+    const src = join7(BASE_RULES_TEMPLATE_DIR, name);
+    const dest = join7(rulesDir, name);
+    copyFileSync(src, dest);
+  }
+  return names;
+}
 function syncBaseSkills(skillsDir) {
   mkdirSync3(skillsDir, { recursive: true });
   const names = listBaseSkillDirNames();
@@ -809,6 +856,11 @@ async function runUpdateSkills() {
   if (syncAgentsGuide(apmDir)) {
     console.log("[apm] \u5DF2\u540C\u6B65 APM \u6307\u5357: .apm/AGENTS.md");
   }
+  const rulesDir = join8(apmDir, "rules");
+  const ruleNames = syncBaseRules(rulesDir);
+  for (const name of ruleNames) {
+    console.log(`[apm] \u5DF2\u540C\u6B65\u57FA\u7840\u89C4\u5219: rules/${name}`);
+  }
   const skillsDir = join8(apmDir, "skills");
   mkdirSync4(skillsDir, { recursive: true });
   const baseNames = syncBaseSkills(skillsDir);
@@ -831,7 +883,7 @@ async function runUpdateSkills() {
     console.log(`[apm] \u5DF2\u79FB\u9664\u5DF2\u4E0B\u7EBF\u7684\u8865\u5145\u6280\u80FD: skills/${name}/`);
   }
   console.log(
-    `[apm] \u6280\u80FD\u540C\u6B65\u5B8C\u6210\uFF1A${baseNames.length} \u4E2A\u57FA\u7840\u6280\u80FD\uFF0C${written.length} \u4E2A\u8865\u5145\u6280\u80FD`
+    `[apm] \u540C\u6B65\u5B8C\u6210\uFF1A${ruleNames.length} \u4E2A\u57FA\u7840\u89C4\u5219\uFF0C${baseNames.length} \u4E2A\u57FA\u7840\u6280\u80FD\uFF0C${written.length} \u4E2A\u8865\u5145\u6280\u80FD`
   );
 }
 
@@ -1102,6 +1154,7 @@ async function handleInboundMessage(cfg, raw) {
   try {
     await runBranch(msg.sessionId, { cwd: msg.workdir });
     await runPull(msg.sessionId, workspaceApmDir(msg.workdir));
+    await commitWorkingTreeIfDirty(msg.workdir, "fix: apm pull");
     await updateMessageStatus(cfg, messageId, "TYPING");
     await runCursorAgent(cfg, {
       messageId: msg.messageId,
@@ -1134,13 +1187,13 @@ async function handleInboundMessage(cfg, raw) {
     }
   }
 }
-function startHeartbeat(ws, userId) {
+function startHeartbeat(ws, clientMachineId) {
   const send = () => {
     if (ws.readyState === WebSocket.OPEN) {
       ws.send(
         serializeAgentWsMessage({
           type: "heartbeat",
-          userId
+          userId: clientMachineId
         })
       );
     }
@@ -1154,8 +1207,9 @@ async function runConnect(options) {
   if (options.server?.trim()) {
     cfg.baseUrl = options.server.trim().replace(/\/+$/, "");
   }
-  if (!cfg.userId?.trim()) {
-    console.error("[apm] config \u7F3A\u5C11 userId\uFF0C\u8BF7\u91CD\u65B0 apm login");
+  const clientMachineId = resolveClientMachineId(cfg);
+  if (!clientMachineId) {
+    console.error("[apm] config \u7F3A\u5C11 clientMachineId\uFF0C\u8BF7\u91CD\u65B0 apm login");
     process.exit(1);
   }
   const url = buildAgentWsUrl(cfg.baseUrl, cfg.token);
@@ -1178,7 +1232,7 @@ async function runConnect(options) {
     };
     ws.on("open", () => {
       console.log("[apm] WebSocket \u5DF2\u8FDE\u63A5");
-      stopHeartbeat = startHeartbeat(ws, cfg.userId);
+      stopHeartbeat = startHeartbeat(ws, clientMachineId);
     });
     ws.on("message", (data) => {
       const text = Buffer.isBuffer(data) ? data.toString("utf8") : String(data);
@@ -1862,40 +1916,6 @@ function registerDeployBackendCommands(program) {
 import { copyFile, readdir as readdir2, stat } from "node:fs/promises";
 import path7 from "node:path";
 
-// src/commands/deploy/internal/load-apm-dotenv.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
-import { join as join9 } from "node:path";
-function loadApmDotEnvIfPresent() {
-  const p = join9(workspaceApmDir(), ".env");
-  if (!existsSync10(p)) {
-    return;
-  }
-  let text;
-  try {
-    text = readFileSync9(p, "utf8");
-  } catch {
-    return;
-  }
-  for (const line of text.split("\n")) {
-    const t = line.trim();
-    if (!t || t.startsWith("#")) {
-      continue;
-    }
-    const eq = t.indexOf("=");
-    if (eq <= 0) {
-      continue;
-    }
-    const key = t.slice(0, eq).trim();
-    let val = t.slice(eq + 1).trim();
-    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
-      val = val.slice(1, -1);
-    }
-    if (process.env[key] === void 0) {
-      process.env[key] = val;
-    }
-  }
-}
-
 // src/commands/deploy/internal/minio.ts
 import { statSync as statSync5 } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
@@ -2059,31 +2079,6 @@ function artifactObjectKey(namePrefix, branchSegment, relativePath) {
   const rel = sanitizeRelativePath(relativePath);
   return `${base}/${branchSegment}/dist/${rel}`;
 }
-function mergeMinioFromEnv(settings) {
-  const ep = process.env.MINIO_ENDPOINT?.trim();
-  const portRaw = process.env.MINIO_PORT?.trim();
-  const sslRaw = process.env.MINIO_USE_SSL?.trim().toLowerCase();
-  const ak = process.env.MINIO_ACCESS_KEY?.trim();
-  const sk = process.env.MINIO_SECRET_KEY?.trim();
-  const bucket = process.env.MINIO_BUCKET?.trim();
-  const port = portRaw ? Number.parseInt(portRaw, 10) : void 0;
-  let useSsl = settings.useSsl;
-  if (sslRaw === "true" || sslRaw === "1") {
-    useSsl = true;
-  }
-  if (sslRaw === "false" || sslRaw === "0") {
-    useSsl = false;
-  }
-  return {
-    ...settings,
-    endpoint: ep || settings.endpoint,
-    port: port !== void 0 && Number.isFinite(port) && port > 0 ? port : settings.port,
-    useSsl,
-    accessKey: ak || settings.accessKey,
-    secretKey: sk || settings.secretKey,
-    bucket: bucket || settings.bucket
-  };
-}
 async function ensureArtifactRootIndexHtml(root) {
   const indexHtmlPath = path7.join(root, "index.html");
   try {
@@ -2124,7 +2119,7 @@ async function ensureArtifactRootIndexHtml(root) {
 }
 function registerDeployFrontendCommands(program) {
   program.command("deploy-frontend").description(
-    "\u9012\u5F52\u4E0A\u4F20\u524D\u7AEF\u4EA7\u7269\u76EE\u5F55\u5230 MinIO\uFF0C\u5E76\u5728\u6210\u529F\u540E\u4E3A\u8BE5\u6876\u8BBE\u7F6E\u533F\u540D\u53EF\u8BFB\u7B56\u7565\uFF08\u53EF\u5148\u914D\u7F6E .apm/.env \u7684 MINIO_*\uFF0C\u5DF2\u6709\u73AF\u5883\u53D8\u91CF\u4F18\u5148\uFF09"
+    "\u9012\u5F52\u4E0A\u4F20\u524D\u7AEF\u4EA7\u7269\u76EE\u5F55\u5230 MinIO\uFF0C\u5E76\u5728\u6210\u529F\u540E\u4E3A\u8BE5\u6876\u8BBE\u7F6E\u533F\u540D\u53EF\u8BFB\u7B56\u7565\uFF08MinIO \u8FDE\u63A5\u4FE1\u606F\u4EC5\u6765\u81EA apm.config.json frontendDeploy\uFF09"
   ).argument("[name]", "\u73AF\u5883\u540D", "online").option(
     "--dir <path>",
     "\u4EA7\u7269\u76EE\u5F55\uFF1B\u5355\u4ED3\u9ED8\u8BA4 apps/web/dist\uFF08\u9700\u5148 rush build / vite build\uFF09",
@@ -2138,12 +2133,9 @@ function registerDeployFrontendCommands(program) {
     (v) => Number.parseInt(String(v), 10)
   ).action(
     async (name, opts) => {
-      loadApmDotEnvIfPresent();
       const cfg = loadApmConfig({ configPath: opts.config });
       const namePrefix = resolveArtifactNamePrefix(cfg);
-      const settings = mergeMinioFromEnv(
-        resolveFrontendDeployFromApmConfig(cfg)
-      );
+      const settings = resolveFrontendDeployFromApmConfig(cfg);
       const minio = new MinioClient({
         endPoint: settings.endpoint,
         port: settings.port,
@@ -2249,16 +2241,16 @@ function buildProgram() {
     await runUpdate();
   });
   program.command("update-skills").description(
-    "\u540C\u6B65\u6280\u80FD\u5230 .apm/skills/\uFF1A\u57FA\u7840\u6280\u80FD\u6765\u81EA CLI \u6A21\u677F\uFF0C\u8865\u5145\u6280\u80FD\u6765\u81EA\u5E73\u53F0"
+    "\u540C\u6B65 .apm/ \u4E0B\u7684\u89C4\u5219\u4E0E\u6280\u80FD\uFF1A\u57FA\u7840\u5185\u5BB9\u6765\u81EA CLI \u6A21\u677F\uFF0C\u8865\u5145\u6280\u80FD\u6765\u81EA\u5E73\u53F0"
   ).action(async () => {
     await runUpdateSkills();
   });
   program.command("pull").description(
-    "\u62C9\u53D6\u6C9F\u901A\u7FA4\u6570\u636E\u5230 .apm/sessions/<sessionId>/\uFF08session.yaml\u3001RULE.md\u3001docs\u3001attachments\uFF09"
+    "\u62C9\u53D6\u6C9F\u901A\u7FA4\u6570\u636E\u5230 .apm/sessions/<sessionId>/\uFF08session.yaml\u3001RULE.md\u3001TASK.md\u3001LOG.md\u3001docs\u3001attachments\uFF09"
   ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
     await runPull(sessionId);
   });
-  program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u9700\u6C42\u6587\u6863").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption(
+  program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u4EFB\u52A1\u6587\u6863").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption(
     "--file <name>",
     "\u6587\u6863\u540D\u79F0\uFF08\u5982 PRD \u6216 PRD.md\uFF09\uFF0C\u8BFB\u53D6 .apm/sessions/<sessionId>/docs/ \u4E0B\u5BF9\u5E94\u6587\u4EF6"
   ).action(async (sessionId, opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "5.0.14",
+  "version": "5.0.16",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,
@@ -37,4 +37,4 @@
     "minio": "~8.0.7",
     "dockerode": "~5.0.0"
   }
-}
+}

package/template/AGENTS.md

@@ -1,12 +1,5 @@
 ## APM 指南
 
-### 回复消息命令
-
-- 命令: `apm append-message --id=<消息ID> --content=<消息内容>`
-- 注意事项：
-  - 如果消息内容中包含文档地址，不要把前缀也写出来，直接用文档名称即可，并且文档名称要用倒引号包裹
-  - 这个是补充消息内容，只要消息没有结束，都可以用这个命令来继续补充发言。
-
 ### 创建/更新群文档命令
 
 - 命令: `apm sync-document <会话ID> --file <文档名称>`
@@ -17,13 +10,19 @@
 1. 读取 `.apm/sessions/<会话ID>/session.yaml`，必要时读取`messages.xml` 了解当前会话状态与历史消息
 2. 根据你的名字从 session.yaml 中找到你对应的人设(system_persona)
 3. 根据人设完成用户指定的任务
-4. 任务有阶段行进展或者任务完成后必须使用 `apm append-message` 回复消息，回复要求简洁不用对本轮工作进行总结
-5. 工作日志放到 `.apm/sessions/<会话ID>/docs/<position>.md` 中，并执行`apm sync-document <会话ID> --file=<position>`同步到远程
+4. 任务有阶段行进展或者任务完成后必须回复消息(具体见规则 `reply.md`)
+5. 写工作日志(具体见规则 `write_doc.md`)
 
 ## 目录声明
-
-- APM 指南: `.apm/AGENTS.md`
-- 技能: `.apm/skills/<技能名称>/SKILL.md`，当 `system_persona` 依赖相关技能时可以在这里按需查找
-- 群文档: `.apm/sessions/<会话 ID>/docs/xxxx.md`，当需要相关上下文可以在这里查找
-- 协作规则: `.apm/sessions/<会话 ID>/RULE.md`，在这里可以看到不同成员的协作规则
-- 历史消息记录: `.apm/sessions/<会话 ID>/message.xml`，当需要查看历史消息记录时可以阅读这个文档
+**除了技能和规则**，后面的所有文件都在 `.apm/sessions/<会话ID>` 下，
+
++ 技能: `.apm/skills/<技能名称>/SKILL.md`，一些常用的工作方法，根据你当前的角色按需阅读
++ 规则: `.apm/rules/*`
+  - reply.md：当需要回复消息时需要读取这个文档，记住回复规则
+  - write_doc.md：当需要写文档时需要读取这个文档，记住写文档的规则
++ 本轮会话状态: `session.yaml`，从这里可以看到每个成员的信息，找到可以协助你一起解决问题的人，可以结合 `RULE.md`一起看
++ 群文档: `docs/xxxx.md`，当需要相关上下文可以在这里查找，按需阅读
++ 协作规则: `RULE.md`，在这里可以看到不同成员的协作规则，从而找其他成员协助你一起解决问题，按需阅读
++ 团队日志: `LOG.md`，在这里可以看到之前每个成员都做了什么，按需阅读
++ 历史消息记录: `message.xml`，历史消息列表，数据量很大，按需阅读
++ 初始目标: `TASK.md`，最初的目标，不一定具体，团队成员会有人负责让这个任务变得具体，仅供参考。如果你是相关的角色，则你需要先读取这个目标，然后规划接下来的动作。

package/template/rules/reply.md

@@ -0,0 +1,15 @@
+## 群内回复规则
+
+1. 如果回复的内容包含文档地址，不要把前缀也写出来，直接用文档名称即可。例如: 我已经把待处理的内容更新到了 `PRD.md` 中，请查阅。
+2. 回复的内容并非对你工作的总结，要尽可能简洁，不要长篇大论，如果同步的内容确实较多，你可以先写文档，然后指引用户去阅读你写的文档。
+3. 只要你有任何进展都想都可以调用下面的命令进行回复，你可以一直补充内容。
+
+## 执行回复的方法
+
+命令: `apm append-message --id=<消息ID> --content=<你要回复的消息内容>`
+
+示例: apm append-message --id=xxxxx --content="我已经把待处理的内容更新到了 `PRD.md`，请查阅"
+
+## 写文档的方法
+
+如果知道写文档的方法，可以阅读 `./write_doc.md`

package/template/rules/write_doc.md

@@ -0,0 +1,30 @@
+## 写工作日志
+
+命名方式： <你的名字>-工作日志.md
+保存位置: .apm/sessions/<会话 ID>/docs/<文件名>
+日志格式：见如下 markdown 中间的内容
+
+```markdown
+## <简要总结本轮干了什么>
+
+<内容>
+```
+
+## 写其他文件
+
+命名方式: <你的名字>-<主题>.md
+保存位置: .apm/sessions/<会话 ID>/docs/<文件名>
+文档内容格式: 根据你的主题来，不限制，禁止记流水账。
+
+## 在保存完成之后需要同步到远程
+
+同步命令: `apm sync-document <会话 ID> --file=<文档名称>
+
+示例: `apm sync-document <会话ID> --file=张三.md`
+
+## 注意事项
+
+1. 文档内容可以被其他团队成员看到，要有价值，禁止记流水账
+2. 你可以根据你的名字查到自己写的文档，并且禁止更改其他人写的文档
+3. 不要随便创建新文档，可以在已有文档的基础上添加内容
+4. 文档不可删除，不可更新文档名称，在写入时要谨慎