@crabcloud/cli 0.1.10 → 0.2.0

package/dist/crab.js

@@ -6503,6 +6503,9 @@ function exitCodeForApiError(body) {
     case "insufficient_credits":
     case "storage.quotaExceeded":
       return EXIT_QUOTA;
+    case "collab_space_not_bound":
+    case "collab_space_mismatch":
+      return EXIT_SCOPE;
     default:
       return 1;
   }
@@ -6550,6 +6553,9 @@ var usage = `crab — Crab Cloud CLI（Agent-first 入口）
   login                浏览器授权登录（设备授权流），保存 Agent Token
                        --scopes <scope|组名,...>  自定义 scope，支持组名整组授权
                                                   （默认 ${DEFAULT_SCOPES.join(",")}）
+                       --space <default|space:<名称>>
+                                                 含协作 scope 时必填：令牌绑定该协作
+                                                 空间，collab 命令只能作用于它
                        --no-open                 只打印链接，不自动打开浏览器
                        --api <url>               指定 API 地址
 
@@ -6601,6 +6607,30 @@ var usage = `crab — Crab Cloud CLI（Agent-first 入口）
   storage categories [--json]        分类列表
   storage mkcat <名称>               新建分类
   storage tags [--json]              标签汇总
+  collab spaces [--json]             列出我所在的协作空间（任务/成员计数与限额）
+  collab space create <名称> [--allocation-mb N] [--json]
+                                     创建独立协作空间（消耗 5 积分；默认自分配 500MB
+                                     存储占订阅总池，可随时调）
+  collab tasks [--space <arg>] [--status open|done] [--q 关键字]
+               [--limit N] [--cursor <cursor>] [--json]
+                                     列出任务（含摘要/记录数；--q 搜标题与记录正文）
+  collab task <id> [--json]          任务详情
+  collab task create --space <arg> --title "..." [--body "..." | --body-file <path>]
+               [--attach <fileId,...>] [--link <url,...>] [--json]
+                                     新建任务（首条记录即 body 入流）
+  collab task records <id> [--limit N] [--cursor <cursor>] [--json]
+                                     读任务记录流（倒序，Markdown 源文 + 附件/链接）
+  collab task done|reopen <id>       完成 / 重开（入流一条状态变更，占记录位）
+  collab task summary <id> (--text "..." | --text-file <path> | --clear) [--json]
+                                     更新任务摘要（可变「当前态」概览，不入记录流；
+                                     上限 2000 字符，--clear 清空）
+  collab members [--space <arg>] [--json]
+                                     协作空间成员列表
+  collab invite <username> [--space <arg>] [--json]
+                                     邀请联系人中已关联的平台用户进空间
+  collab activity [--json]           协作域活动事件（Agent 推送/读取、任务创建、摘要更新）
+  post <taskId> (--body "..." | --body-file <path>) [--attach <fileId,...>] [--link <url,...>] [--json]
+                                     推送任务记录（糖命令：等价 collab task records 的写入）
   credits [--json]                   积分余额（月送/充值/合计；需 credits.read scope）
   credits history [--limit N] [--offset N] [--json]
                                      积分流水（变动 ±：消耗为负；需 credits.read）
@@ -6618,7 +6648,11 @@ ${scopeGroups.map((group) => `  ${group.id.padEnd(9)} ${group.scopes.join(", ")}
   CRAB_API          API 地址（默认 ${DEFAULT_API}）
   CRAB_CREDENTIALS  凭证文件路径（默认 ~/.config/crabcloud/credentials.json）
 
-退出码: 0 成功 · 2 用法错误 · 3 认证失效 · 4 scope 不足 · 5 资源不存在 · 7 配额/积分不足
+collab 命令的 <arg>（--space 值）: default（默认空间）| space:<名称>（按名唯一命中）| 空间 id；
+  缺省时你只在一个空间则自动采用，多个则列出候选要求显式指定。Agent 令牌绑定空间后，
+  越界访问一律 403（collab_space_mismatch）。
+
+退出码: 0 成功 · 2 用法错误 · 3 认证失效 · 4 scope 不足（含令牌未绑/绑错协作空间）· 5 资源不存在 · 7 配额/积分不足
 `;
 async function login() {
   const apiBase = process.env.CRAB_API ?? readFlag("--api") ?? DEFAULT_API;
@@ -6634,10 +6668,16 @@ async function login() {
     console.error(`--scopes 展开后为空（输入：${rawScopes.join(", ")}）`);
     return EXIT_USAGE;
   }
+  const spaceArg = readFlag("--space");
+  if (requested.some((s) => s === "collab.read" || s === "collab.write") && !spaceArg) {
+    console.error("含协作 scope（collab）时必须指定 --space <default|space:<名称>>——令牌将绑定该协作空间，越界访问一律拒绝。");
+    console.error("示例：crab login --scopes collab --space default");
+    return EXIT_USAGE;
+  }
   const openBrowser = !hasFlag("--no-open");
   const start = await api2(apiBase, "/v1/auth/device/start", {
     method: "POST",
-    body: JSON.stringify({ name: `${hostname()} · crab cli`, scopes: requested })
+    body: JSON.stringify({ name: `${hostname()} · crab cli`, scopes: requested, ...spaceArg ? { space: spaceArg } : {} })
   });
   if (start.status !== 200) {
     console.error(`发起授权失败（${start.status}）：`, errorMessage(start.body, JSON.stringify(start.body)));
@@ -6679,6 +6719,8 @@ async function login() {
       saveCredentials({ apiBase, token: poll.body.data.token, scopes: poll.body.data.scopes });
       console.log(`✓ 已登录，Agent Token 已保存到 ${CONFIG_PATH}`);
       console.log(`  scopes: ${poll.body.data.scopes.join(", ")}`);
+      if (spaceArg)
+        console.log(`  协作空间绑定: ${spaceArg}（collab 命令只能作用于该空间）`);
       return 0;
     }
   }
@@ -6825,7 +6867,7 @@ async function tokensList() {
     return 0;
   }
   for (const token of rows) {
-    console.log(`${token.id}  ${token.name}  [${token.scopes.join(", ")}]  ${token.revoked ? "已撤销" : "生效中"}`);
+    console.log(`${token.id}  ${token.name}  [${token.scopes.join(", ")}]  ${token.revoked ? "已撤销" : "生效中"}${token.collabSpace ? `  ⟨空间 ${token.collabSpace}⟩` : ""}`);
     console.log(`    创建 ${formatTime(token.createdAt)} · 最近使用 ${token.lastUsedAt ? formatTime(token.lastUsedAt) : "—"}${token.expiresAt ? ` · 过期 ${formatTime(token.expiresAt)}` : ""}`);
   }
   return 0;
@@ -7902,6 +7944,487 @@ async function storageTags() {
     console.log(`${row.tag}  (${row.count})`);
   return 0;
 }
+var COLLAB_TASK_STATUSES = ["open", "done"];
+function collabSpaceToken(space) {
+  return space.kind === "default" ? "default" : `space:${space.name}`;
+}
+function printCollabTaskRow(task) {
+  const flags = [task.status === "done" ? "已完成" : null, task.summary ? "有摘要" : null].filter(Boolean);
+  console.log(`${task.id}  ${task.title}  记录 ${task.recordCount}  ${formatTime(task.latestRecordAt)}${flags.length > 0 ? `  [${flags.join(" · ")}]` : ""}`);
+}
+async function resolveCollabSpace(credentials, arg) {
+  const res = await api2(credentials.apiBase, "/v1/collab/spaces", { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取协作空间失败。"));
+    if (res.body?.error?.code === "scope_denied") {
+      console.error("提示：协作命令需要 collab scope——运行 crab login --scopes collab --space default 重新授权。");
+    }
+    return exitCodeForApiError(res.body);
+  }
+  const spaces = res.body.data.spaces;
+  if (spaces.length === 0) {
+    console.error("你还没有可访问的协作空间。");
+    return EXIT_NOT_FOUND;
+  }
+  if (arg === undefined || arg === "") {
+    if (spaces.length === 1)
+      return spaces[0];
+    console.error("你所在的协作空间不止一个，请用 --space 指定（default / space:<名称> / 空间 id）：");
+    for (const s of spaces)
+      console.error(`  ${collabSpaceToken(s)}  （任务 ${s.taskCount}）`);
+    return EXIT_USAGE;
+  }
+  if (arg === "default") {
+    const hit = spaces.find((s) => s.kind === "default");
+    if (hit)
+      return hit;
+    console.error("没有找到你的默认协作空间。");
+    return EXIT_NOT_FOUND;
+  }
+  if (arg.startsWith("space:")) {
+    const name = arg.slice("space:".length).trim();
+    if (!name) {
+      console.error("space: 后面要跟空间名称（crab collab spaces 查看）。");
+      return EXIT_USAGE;
+    }
+    const hit = spaces.filter((s) => s.name === name && s.status === "active");
+    if (hit.length === 1)
+      return hit[0];
+    console.error(hit.length === 0 ? `没有名为「${name}」的 active 协作空间。` : `「${name}」命中多个空间，请用空间 id 指定。`);
+    return EXIT_NOT_FOUND;
+  }
+  const byId = spaces.find((s) => s.id === arg);
+  if (byId)
+    return byId;
+  console.error(`空间标识无效：${arg}
+应为 default、space:<名称> 或空间 id（crab collab spaces 查看）。`);
+  return EXIT_USAGE;
+}
+async function collabSpacesList() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const res = await api2(credentials.apiBase, "/v1/collab/spaces", { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取协作空间失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const data = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  if (data.spaces.length === 0) {
+    console.log("你还没有可访问的协作空间。");
+    return 0;
+  }
+  for (const s of data.spaces) {
+    const storage = s.kind === "independent" ? ` · 存储 ${formatBytesCli(s.storageUsedBytes)}/${formatBytesCli(s.storageAllocatedBytes)}` : "";
+    console.log(`${collabSpaceToken(s)}  ${s.status === "archived" ? "[已归档·只读] " : ""}任务 ${s.taskCount}/${s.limits.taskLimit} · 受邀成员 ${s.memberCount}/${s.limits.invitedMemberLimit}${storage}`);
+    console.log(`    id ${s.id}`);
+  }
+  console.log(`独立空间名额：${data.independentUsed}/${data.independentLimit}（创建消耗 5 积分：crab collab space create <名称>）`);
+  return 0;
+}
+async function collabSpaceCreate(name) {
+  if (!name) {
+    console.error("用法：crab collab space create <名称> [--allocation-mb <兆字节>] [--json]");
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const allocationMb = Number.parseInt(readFlag("--allocation-mb") ?? "", 10);
+  const body = { name };
+  if (Number.isFinite(allocationMb))
+    body.allocationBytes = allocationMb * 1024 * 1024;
+  const res = await api2(credentials.apiBase, "/v1/collab/spaces", {
+    method: "POST",
+    headers: authHeaders(credentials),
+    body: JSON.stringify(body)
+  });
+  if (res.status !== 200 && res.status !== 201) {
+    console.error(errorMessage(res.body, "创建失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const data = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  console.log(`✓ 独立协作空间已创建（id ${data.spaceId}）`);
+  console.log(`  消耗积分：${fmtCredits(data.chargedCredits)} · --space space:${name} 即可指向它`);
+  return 0;
+}
+async function collabTasksList() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const status = readFlag("--status");
+  if (status && !COLLAB_TASK_STATUSES.includes(status)) {
+    console.error(`未知状态：${status}
+可用：${COLLAB_TASK_STATUSES.join(", ")}`);
+    return EXIT_USAGE;
+  }
+  const space = await resolveCollabSpace(credentials, readFlag("--space"));
+  if (typeof space === "number")
+    return space;
+  const params = new URLSearchParams;
+  if (status)
+    params.set("status", status);
+  const q = readFlag("--q");
+  if (q)
+    params.set("q", q);
+  const limit = readFlag("--limit");
+  if (limit)
+    params.set("limit", limit);
+  const cursor = readFlag("--cursor");
+  if (cursor)
+    params.set("cursor", cursor);
+  const res = await api2(credentials.apiBase, `/v1/collab/spaces/${encodeURIComponent(space.id)}/tasks?${params}`, {
+    headers: authHeaders(credentials)
+  });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取任务列表失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const page = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify({ ...page, space: { id: space.id, kind: space.kind, name: space.name } }, null, 2));
+    return 0;
+  }
+  console.log(`空间：${collabSpaceToken(space)}${space.status === "archived" ? "（已归档·只读）" : ""}`);
+  if (page.tasks.length === 0) {
+    console.log('没有匹配的任务（crab collab task create --title "…" 新建）。');
+    return 0;
+  }
+  for (const task of page.tasks)
+    printCollabTaskRow(task);
+  if (page.nextCursor)
+    console.log(`（还有更多：--cursor ${page.nextCursor}）`);
+  return 0;
+}
+async function collabTaskDetail(id) {
+  if (!id) {
+    console.error("用法：crab collab task <id>（id 见 crab collab tasks）");
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const res = await api2(credentials.apiBase, `/v1/collab/tasks/${encodeURIComponent(id)}`, { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取任务失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const task = res.body.data.task;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(task, null, 2));
+    return 0;
+  }
+  console.log(`${task.title}  [${task.status === "done" ? "已完成" : "进行中"}]`);
+  console.log(`  id: ${task.id}`);
+  console.log(`  记录 ${task.recordCount} 条 · 最新 ${formatTime(task.latestRecordAt)} · 创建 ${formatTime(task.createdAt)}`);
+  if (task.summary)
+    console.log(`  摘要: ${task.summary}`);
+  console.log("  记录流：crab collab task records " + task.id);
+  return 0;
+}
+async function collabTaskCreate() {
+  const title = readFlag("--title");
+  const spaceArg = readFlag("--space");
+  const bodyFlag = readFlag("--body");
+  const bodyFile = readFlag("--body-file");
+  if (!title) {
+    console.error('用法：crab collab task create --space <arg> --title "..." [--body "..." | --body-file <path>] [--attach <fileId,...>] [--link <url,...>] [--json]');
+    return EXIT_USAGE;
+  }
+  if (bodyFlag && bodyFile) {
+    console.error("--body 与 --body-file 二选一。");
+    return EXIT_USAGE;
+  }
+  let body = bodyFlag ?? "";
+  if (bodyFile) {
+    try {
+      body = readFileSync2(bodyFile, "utf8");
+    } catch {
+      console.error(`读取正文文件失败：${bodyFile}`);
+      return EXIT_USAGE;
+    }
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const space = await resolveCollabSpace(credentials, spaceArg);
+  if (typeof space === "number")
+    return space;
+  const fileIds = (readFlag("--attach") ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const links = (readFlag("--link") ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const res = await api2(credentials.apiBase, `/v1/collab/spaces/${encodeURIComponent(space.id)}/tasks`, {
+    method: "POST",
+    headers: authHeaders(credentials),
+    body: JSON.stringify({ title, body, ...fileIds.length > 0 ? { fileIds } : {}, ...links.length > 0 ? { links } : {} })
+  });
+  if (res.status !== 200 && res.status !== 201) {
+    console.error(errorMessage(res.body, "创建任务失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const data = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  console.log(`✓ 任务已创建（id ${data.taskId}）`);
+  console.log(`  首条记录已入流；追加记录：crab post ${data.taskId} --body "..."`);
+  return 0;
+}
+async function collabTaskRecords(id) {
+  if (!id) {
+    console.error("用法：crab collab task records <id> [--limit N] [--cursor <cursor>] [--json]");
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const params = new URLSearchParams;
+  const limit = readFlag("--limit");
+  if (limit)
+    params.set("limit", limit);
+  const cursor = readFlag("--cursor");
+  if (cursor)
+    params.set("cursor", cursor);
+  const res = await api2(credentials.apiBase, `/v1/collab/tasks/${encodeURIComponent(id)}/records?${params}`, {
+    headers: authHeaders(credentials)
+  });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "读取记录流失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const page = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(page, null, 2));
+    return 0;
+  }
+  if (page.records.length === 0) {
+    console.log("该任务还没有记录。");
+    return 0;
+  }
+  for (const record of page.records) {
+    if (record.kind === "status_change") {
+      console.log(`—— ${record.authorName ?? record.authorAccountId} ${record.actorType === "agent" ? "（经 Agent）" : ""}变更了任务状态 · ${formatTime(record.createdAt)} ——`);
+      continue;
+    }
+    const via = record.via ? `（经 ${record.via.token}）` : record.actorType === "agent" ? "（经 Agent）" : "";
+    console.log(`【${record.authorName ?? record.authorAccountId}${via} · ${formatTime(record.createdAt)}】`);
+    if (record.body)
+      console.log(record.body);
+    for (const ref of record.refs) {
+      if (ref.kind === "link")
+        console.log(`  \uD83D\uDD17 ${ref.url}`);
+      else
+        console.log(`  \uD83D\uDCCE ${ref.filename ?? ref.fileId}${ref.sizeBytes ? `（${formatBytesCli(ref.sizeBytes)}${ref.spaceOwned ? " · 空间文件" : " · 云盘引用"}）` : ""}`);
+    }
+    console.log("");
+  }
+  if (page.nextCursor)
+    console.log(`（还有更早的记录：--cursor ${page.nextCursor}）`);
+  return 0;
+}
+async function collabPushRecord(taskId) {
+  if (!taskId) {
+    console.error('用法：crab post <taskId> (--body "..." | --body-file <path>) [--attach <fileId,...>] [--link <url,...>] [--json]');
+    return EXIT_USAGE;
+  }
+  const bodyFlag = readFlag("--body");
+  const bodyFile = readFlag("--body-file");
+  if (!bodyFlag && !bodyFile) {
+    console.error('需要 --body "..." 或 --body-file <path>（记录正文必填，Markdown）。');
+    return EXIT_USAGE;
+  }
+  if (bodyFlag && bodyFile) {
+    console.error("--body 与 --body-file 二选一。");
+    return EXIT_USAGE;
+  }
+  let body = bodyFlag ?? "";
+  if (bodyFile) {
+    try {
+      body = readFileSync2(bodyFile, "utf8");
+    } catch {
+      console.error(`读取正文文件失败：${bodyFile}`);
+      return EXIT_USAGE;
+    }
+  }
+  if (!body.trim()) {
+    console.error("记录正文不能为空。");
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const fileIds = (readFlag("--attach") ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const links = (readFlag("--link") ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const res = await api2(credentials.apiBase, `/v1/collab/tasks/${encodeURIComponent(taskId)}/records`, {
+    method: "POST",
+    headers: authHeaders(credentials),
+    body: JSON.stringify({ body, ...fileIds.length > 0 ? { fileIds } : {}, ...links.length > 0 ? { links } : {} })
+  });
+  if (res.status !== 200 && res.status !== 201) {
+    console.error(errorMessage(res.body, "推送失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const data = res.body.data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  console.log(`✓ 记录已推送（id ${data.recordId}）`);
+  if (data.via)
+    console.log(`  活动事件 evt: ${data.via.eventId}`);
+  return 0;
+}
+async function collabTaskStatus(action, id) {
+  if (!id) {
+    console.error(`用法：crab collab task ${action} <id>`);
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const res = await api2(credentials.apiBase, `/v1/collab/tasks/${encodeURIComponent(id)}/${action}`, {
+    method: "POST",
+    headers: authHeaders(credentials)
+  });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "状态更新失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const task = res.body.data.task;
+  console.log(`✓ ${action === "done" ? "已完成" : "已重开"}：${task.title}（状态变更已入记录流，记录 ${task.recordCount} 条）`);
+  return 0;
+}
+async function collabTaskSummary(id) {
+  if (!id) {
+    console.error('用法：crab collab task summary <id> (--text "..." | --text-file <path> | --clear) [--json]');
+    return EXIT_USAGE;
+  }
+  const text = readFlag("--text");
+  const textFile = readFlag("--text-file");
+  const clear = hasFlag("--clear");
+  const sources = [text !== undefined, textFile !== undefined, clear].filter(Boolean).length;
+  if (sources === 0) {
+    console.error('需要 --text "..."（新摘要）、--text-file <path> 或 --clear（清空）之一。');
+    return EXIT_USAGE;
+  }
+  if (sources > 1) {
+    console.error("--text / --text-file / --clear 三选一。");
+    return EXIT_USAGE;
+  }
+  let summary = text ?? "";
+  if (textFile) {
+    try {
+      summary = readFileSync2(textFile, "utf8");
+    } catch {
+      console.error(`读取摘要文件失败：${textFile}`);
+      return EXIT_USAGE;
+    }
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const res = await api2(credentials.apiBase, `/v1/collab/tasks/${encodeURIComponent(id)}/summary`, {
+    method: "PUT",
+    headers: authHeaders(credentials),
+    body: JSON.stringify({ summary })
+  });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "摘要更新失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const task = res.body.data.task;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(task, null, 2));
+    return 0;
+  }
+  console.log(task.summary ? `✓ 摘要已更新：${task.title}` : `✓ 摘要已清空：${task.title}`);
+  if (task.summary)
+    console.log(`  ${task.summary.length > 200 ? `${task.summary.slice(0, 200)}…` : task.summary}`);
+  return 0;
+}
+async function collabMembersList() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const space = await resolveCollabSpace(credentials, readFlag("--space"));
+  if (typeof space === "number")
+    return space;
+  const res = await api2(credentials.apiBase, `/v1/collab/spaces/${encodeURIComponent(space.id)}/members`, {
+    headers: authHeaders(credentials)
+  });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取成员失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const members = res.body.data.members;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(members, null, 2));
+    return 0;
+  }
+  console.log(`空间：${collabSpaceToken(space)}`);
+  for (const member of members) {
+    console.log(`${member.username}  ${member.displayName ?? ""}  [${member.role === "owner" ? "创建者" : "成员"}]  加入 ${formatTime(member.joinedAt)}`);
+  }
+  return 0;
+}
+async function collabInvite(username) {
+  if (!username) {
+    console.error("用法：crab collab invite <username> [--space <arg>] [--json]");
+    return EXIT_USAGE;
+  }
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const space = await resolveCollabSpace(credentials, readFlag("--space"));
+  if (typeof space === "number")
+    return space;
+  const res = await api2(credentials.apiBase, `/v1/collab/spaces/${encodeURIComponent(space.id)}/members`, {
+    method: "POST",
+    headers: authHeaders(credentials),
+    body: JSON.stringify({ username })
+  });
+  if (res.status !== 200 && res.status !== 201) {
+    console.error(errorMessage(res.body, "邀请失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify({ ok: true, spaceId: space.id, username }, null, 2));
+    return 0;
+  }
+  console.log(`✓ 已邀请 ${username} 加入 ${collabSpaceToken(space)}。`);
+  return 0;
+}
+async function collabActivity() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const res = await api2(credentials.apiBase, "/v1/collab/agent-activity", { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取协作活动失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const activity = res.body.data.activity;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(activity, null, 2));
+    return 0;
+  }
+  if (activity.length === 0) {
+    console.log("还没有协作活动事件。");
+    return 0;
+  }
+  for (const entry of activity) {
+    console.log(`${formatTime(entry.createdAt)}  ${entry.action.padEnd(15)}  ${entry.actorType === "agent" ? "agent" : "user "}  ${entry.actorLabel ?? "—"}${entry.taskId ? `  任务 ${entry.taskId}` : ""}`);
+  }
+  return 0;
+}
 async function init() {
   if (loadCredentials()) {
     console.log("已登录（crab whoami 查看身份）。");
@@ -8049,6 +8572,45 @@ switch (command) {
     console.log(usage);
     process.exit(EXIT_USAGE);
   }
+  case "collab": {
+    const sub = args[1];
+    if (sub === "spaces")
+      process.exit(await collabSpacesList());
+    if (sub === "space") {
+      if (args[2] === "create")
+        process.exit(await collabSpaceCreate(args.slice(3).find((x) => !x.startsWith("--"))));
+      console.error(`用法：crab collab space create <名称> [--allocation-mb <兆字节>] [--json]
+`);
+      process.exit(EXIT_USAGE);
+    }
+    if (sub === "tasks")
+      process.exit(await collabTasksList());
+    if (sub === "task") {
+      const op = args[2];
+      if (op === "create")
+        process.exit(await collabTaskCreate());
+      if (op === "records")
+        process.exit(await collabTaskRecords(args[3]));
+      if (op === "done" || op === "reopen")
+        process.exit(await collabTaskStatus(op, args[3]));
+      if (op === "summary")
+        process.exit(await collabTaskSummary(args[3]));
+      process.exit(await collabTaskDetail(op));
+    }
+    if (sub === "members")
+      process.exit(await collabMembersList());
+    if (sub === "invite")
+      process.exit(await collabInvite(args[2]));
+    if (sub === "activity")
+      process.exit(await collabActivity());
+    console.error(sub ? `未知子命令：collab ${sub}
+` : `缺少子命令：collab spaces | space create | tasks | task | members | invite | activity
+`);
+    console.log(usage);
+    process.exit(EXIT_USAGE);
+  }
+  case "post":
+    process.exit(await collabPushRecord(args[1]));
   case "logout":
     process.exit(await logout());
   case "version":

package/dist/skills/crabcloud-collab/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: crabcloud-collab
+description: Work in the user's Crab Cloud collaboration spaces (协作空间) through the `crab` CLI — list spaces and members, create and complete tasks, push immutable execution records (Markdown + attachments/links), maintain the mutable task summary, and invite linked contacts. Use this skill when the user asks to create/update/check collaboration tasks or spaces on Crab Cloud ("建个任务", "协作空间里有什么", "把这个进度推送到任务", "邀请他进空间", "crab collab"), or wants an agent to record work progress into a task — even if they never say "crab" or "Crab Cloud" explicitly.
+---
+
+# Crab Cloud 协作（crab collab）
+
+协作是用户的任务协作应用：容器是协作空间（默认个人空间注册即有 + 独立付费
+空间），原子单位是任务。任务 = 不可改的执行记录流（GitHub issue 式：什么节点
+做了什么，人机同写），另有一个可随时覆盖的「摘要」字段表达当前态概览。本
+skill 覆盖协作域的 agent 通道；账号/令牌管理见 `crabcloud` skill，邮箱见
+`crabcloud-mail`，云盘见 `crabcloud-storage`。
+
+## 第一步：确认可用
+
+- 运行 `crab --version` 确认已安装。命令不存在时让用户运行
+  `npx @crabcloud/cli init`（登录 + 安装本 skill 一步完成）；已装过但命令缺失
+  时运行 `npx @crabcloud/cli@latest init` 升级。
+- CLI 基于 npx 分发，**本机没有 `crab` 命令时，下文所有 `crab <命令>` 都可以
+  `npx @crabcloud/cli <命令>` 等价执行**（例如 `npx @crabcloud/cli collab tasks`）。
+- 未登录（退出码 3）引导用户 `crab login`。
+- **协作命令需要空间绑定**：授权时必须带 `--space`（`default` = 默认空间，
+  `space:<名称>` = 按名唯一命中）。含 collab scope 但没带 `--space` 会直接报
+  用法错误（退出码 2）。正确示例：
+  `crab login --scopes collab --space default`
+- 动作需要对应 scope：读（spaces/tasks/records/members）`collab.read`，写
+  （建任务/推送/完成/摘要/邀请）`collab.write`——一般整组授权 `--scopes collab`。
+- 退出码 4 有两种协作专属情形，处置都是重新授权：
+  - `collab_space_not_bound`：令牌没绑空间——按上面带 `--space` 重新 `crab login`；
+  - `collab_space_mismatch`：令牌绑的是别的空间——换绑到目标空间（`--space`
+    指对）重新授权。**不要**反复重试同一令牌。
+- 推送记录免费（不消耗积分）；建独立空间（5 积分）与扩容才计费，见「纪律」。
+
+## 空间怎么指（--space）
+
+所有落到一个空间的命令都接受 `--space <arg>`，`<arg>` 三种形态：
+
+1. `default` —— 用户的默认个人协作空间（注册即有）；
+2. `space:<名称>` —— 按名称唯一命中（active 空间）；
+3. 空间 id —— `crab collab spaces` 查到的 id。
+
+**缺省 `--space` 时**：只在一个空间则自动采用；多个则 CLI 列出候选并要求显式
+指定——不要瞎猜，先 `crab collab spaces` 看一眼再带上正确的 `--space`。
+
+## 意图 → 命令映射
+
+| 用户意图 | 命令 |
+|---|---|
+| 有哪些协作空间 | `crab collab spaces`（任务/成员计数、限额、独立空间名额） |
+| 建独立协作空间 | `crab collab space create <名称> [--allocation-mb 500]`（**消耗 5 积分**，见纪律） |
+| 空间里有什么任务 | `crab collab tasks [--space <arg>]`（倒序，含摘要/记录数；`--status open\|done`、`--q 关键字` 搜标题与记录正文） |
+| 任务详情 | `crab collab task <id>`（状态/摘要/记录数） |
+| 建任务 | `crab collab task create --space <arg> --title "..." --body "首条记录(Markdown)"`（也可 `--body-file <路径>`；附件 `--attach <fileId,...>`、链接 `--link <url,...>`） |
+| 读任务的来龙去脉 | `crab collab task records <id>`（倒序记录流，Markdown 源文；`--cursor` 翻更早） |
+| 推送工作记录 | `crab post <taskId> --body "做了什么(Markdown)"`（糖命令，等价 records 写入；免费） |
+| 任务做完了 | `crab collab task done <id>`（入流一条状态变更）；反悔 `crab collab task reopen <id>` |
+| 维护任务摘要 | `crab collab task summary <id> --text "当前态概览"`（可随时覆盖；`--clear` 清空；不入记录流） |
+| 谁在空间里 | `crab collab members [--space <arg>]` |
+| 邀人进空间 | `crab collab invite <username> [--space <arg>]`（**只能邀联系人中已关联的平台用户**，见纪律） |
+| 看协作活动 | `crab collab activity`（Agent 推送/读取、任务创建、摘要更新事件） |
+
+任务 id 从 `crab collab tasks` 拿；`crab post` 的 `<taskId>` 同源。
+
+## 机器可读输出
+
+程序化消费**始终加 `--json`**：
+
+- `collab spaces --json` → `{ spaces: [...], independentLimit, independentUsed }`，
+  条目含 `id / kind / name / status / taskCount / memberCount / limits`；
+- `collab tasks --json` → `{ tasks: [...], nextCursor }`，条目含
+  `id / title / status / summary / recordCount / latestRecordAt`（游标分页）；
+- `collab task records --json` → `{ records: [...], nextCursor }`，条目含
+  `id / kind / body / authorName / via / refs / createdAt`；
+- `post --json` → `{ recordId, via?: { token, eventId } }`（via.eventId 即该条
+  记录 id，可确定性回查）；
+- `collab task <id> --json` / `collab members --json` / `collab activity --json`
+  同构。
+
+## 纪律
+
+- **记录流不可改**：推上去就是历史，没有编辑/删除——推送前把内容写对；写错了
+  补一条更正记录，不要试图「撤回」。
+- **摘要是可变当前态**：表达「现在进展到哪」，不是流水账；每次推送记录后若
+  摘要已过时，顺手 `crab collab task summary` 刷新，让不看全程的人一眼看懂。
+- **建独立空间是付费动作（5 积分）**：先向用户复述名称与自分配存储（默认
+  500MB，占订阅总池），确认后再执行；`collab space create` 不要当作顺手操作。
+- **邀请有前置**：目标必须是联系人簿里已关联的平台用户（`crab contacts add`
+  站内地址自动关联）；报「只能邀请联系人中已关联的平台用户」时，先引导建联
+  系人，不要换名字硬试。
+- **附件引用不复制**：`--attach` 的 fileId 是云盘/空间已有文件的引用（≤10 个），
+  只能引用空间成员的云盘文件或本空间直传文件；跨空间文件会被 403 拒绝。
+- 单任务记录流上限 500 条（状态变更也占位）：任务粒度别太粗，做完就 `done`，
+  新工作开新任务。
+- 读记录流对 Agent 是一等审计事件（thread.read 入活动流）——正常读即可，但
+  不要在循环里无意义地反复拉全量记录。

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@crabcloud/cli",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Crab Cloud CLI (crab) \u2014 agent-first entry to your personal cloud, with skills bundled for Claude Code / Codex / ZCode.",
+  "description": "Crab Cloud CLI (crab) — agent-first entry to your personal cloud, with skills bundled for Claude Code / Codex / ZCode.",
   "bin": {
     "crab": "dist/crab.js"
   },