@crabcloud/cli 0.1.9 → 0.2.0

package/dist/crab.js

@@ -1,4 +1,18 @@
 #!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
 
 // src/index.ts
 import { hostname, homedir as homedir2 } from "node:os";
@@ -980,6 +994,7 @@ function datetime(args) {
   return new RegExp(`^${dateSource}T(?:${timeRegex})$`);
 }
 var anyString = /^[\s\S]{0,}$/;
+var bigint = /^-?\d+n?$/;
 var integer = /^-?\d+$/;
 var number = /^-?\d+(?:\.\d+)?$/;
 var boolean = /^(?:true|false)$/i;
@@ -1885,6 +1900,25 @@ var $ZodBoolean = /* @__PURE__ */ $constructor("$ZodBoolean", (inst, def) => {
     return payload;
   };
 });
+var $ZodBigInt = /* @__PURE__ */ $constructor("$ZodBigInt", (inst, def) => {
+  $ZodType.init(inst, def);
+  inst._zod.pattern = bigint;
+  inst._zod.parse = (payload, _ctx) => {
+    if (def.coerce)
+      try {
+        payload.value = BigInt(payload.value);
+      } catch (_) {}
+    if (typeof payload.value === "bigint")
+      return payload;
+    payload.issues.push({
+      expected: "bigint",
+      code: "invalid_type",
+      input: payload.value,
+      inst
+    });
+    return payload;
+  };
+});
 var $ZodNull = /* @__PURE__ */ $constructor("$ZodNull", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.pattern = _null;
@@ -1918,6 +1952,29 @@ var $ZodNever = /* @__PURE__ */ $constructor("$ZodNever", (inst, def) => {
     return payload;
   };
 });
+var $ZodDate = /* @__PURE__ */ $constructor("$ZodDate", (inst, def) => {
+  $ZodType.init(inst, def);
+  inst._zod.parse = (payload, _ctx) => {
+    if (def.coerce) {
+      try {
+        payload.value = new Date(payload.value);
+      } catch (_err) {}
+    }
+    const input = payload.value;
+    const isDate = input instanceof Date;
+    const isValidDate = isDate && !Number.isNaN(input.getTime());
+    if (isValidDate)
+      return payload;
+    payload.issues.push({
+      expected: "date",
+      code: "invalid_type",
+      input,
+      ...isDate ? { received: "Invalid Date" } : {},
+      inst
+    });
+    return payload;
+  };
+});
 function handleArrayResult(result, final, index) {
   if (result.issues.length) {
     final.issues.push(...prefixIssues(index, result.issues));
@@ -3323,6 +3380,9 @@ function snapshotChecks(def) {
 function _string(Class, params) {
   return new Class(snapshotChecks({ type: "string", ...normalizeParams(params) }));
 }
+function _coercedString(Class, params) {
+  return new Class(snapshotChecks({ type: "string", coerce: true, ...normalizeParams(params) }));
+}
 function _email(Class, params) {
   return new Class({
     type: "string",
@@ -3563,6 +3623,9 @@ function _isoDuration(Class, params) {
 function _number(Class, params) {
   return new Class(snapshotChecks({ type: "number", checks: [], ...normalizeParams(params) }));
 }
+function _coercedNumber(Class, params) {
+  return new Class(snapshotChecks({ type: "number", coerce: true, checks: [], ...normalizeParams(params) }));
+}
 function _int(Class, params) {
   return new Class({
     type: "number",
@@ -3578,6 +3641,20 @@ function _boolean(Class, params) {
     ...normalizeParams(params)
   });
 }
+function _coercedBoolean(Class, params) {
+  return new Class({
+    type: "boolean",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
+function _coercedBigint(Class, params) {
+  return new Class({
+    type: "bigint",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
 function _null2(Class, params) {
   return new Class({
     type: "null",
@@ -3595,6 +3672,13 @@ function _never(Class, params) {
     ...normalizeParams(params)
   });
 }
+function _coercedDate(Class, params) {
+  return new Class({
+    type: "date",
+    coerce: true,
+    ...normalizeParams(params)
+  });
+}
 function _lt(value, params) {
   return new $ZodCheckLessThan({
     check: "less_than",
@@ -4469,6 +4553,9 @@ var numberProcessor = (schema, ctx, _json, params) => {
 var booleanProcessor = (_schema, _ctx, json, _params) => {
   json.type = "boolean";
 };
+var bigintProcessor = (schema, ctx, json, params) => {
+  handleUnrepresentable(schema, ctx, json, params, "BigInt cannot be represented in JSON Schema");
+};
 var nullProcessor = (_schema, ctx, json, _params) => {
   if (ctx.target === "openapi-3.0") {
     json.type = "string";
@@ -4482,6 +4569,9 @@ var neverProcessor = (_schema, _ctx, json, _params) => {
   json.not = {};
 };
 var unknownProcessor = (_schema, _ctx, _json, _params) => {};
+var dateProcessor = (schema, ctx, json, params) => {
+  handleUnrepresentable(schema, ctx, json, params, "Date cannot be represented in JSON Schema");
+};
 var enumProcessor = (schema, _ctx, json, _params) => {
   const def = schema._zod.def;
   const values = getEnumValues(def.entries);
@@ -5346,6 +5436,49 @@ var ZodBoolean = /* @__PURE__ */ $constructor("ZodBoolean", (inst, def) => {
 function boolean2(params) {
   return _boolean(ZodBoolean, params);
 }
+var ZodBigInt = /* @__PURE__ */ $constructor("ZodBigInt", (inst, def) => {
+  $ZodBigInt.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => bigintProcessor(inst, ctx, json, params);
+}, /* @__PURE__ */ derived({
+  minValue: (inst) => aggregateChecks(inst).minimum ?? null,
+  maxValue: (inst) => aggregateChecks(inst).maximum ?? null,
+  format: (inst) => aggregateChecks(inst).format ?? null
+}, {
+  gte(value, params) {
+    return this.check(_gte(value, params));
+  },
+  min(value, params) {
+    return this.check(_gte(value, params));
+  },
+  gt(value, params) {
+    return this.check(_gt(value, params));
+  },
+  lt(value, params) {
+    return this.check(_lt(value, params));
+  },
+  lte(value, params) {
+    return this.check(_lte(value, params));
+  },
+  max(value, params) {
+    return this.check(_lte(value, params));
+  },
+  positive(params) {
+    return this.check(_gt(BigInt(0), params));
+  },
+  negative(params) {
+    return this.check(_lt(BigInt(0), params));
+  },
+  nonpositive(params) {
+    return this.check(_lte(BigInt(0), params));
+  },
+  nonnegative(params) {
+    return this.check(_gte(BigInt(0), params));
+  },
+  multipleOf(value, params) {
+    return this.check(_multipleOf(value, params));
+  }
+}));
 var ZodNull = /* @__PURE__ */ $constructor("ZodNull", (inst, def) => {
   $ZodNull.init(inst, def);
   ZodType.init(inst, def);
@@ -5370,6 +5503,22 @@ var ZodNever = /* @__PURE__ */ $constructor("ZodNever", (inst, def) => {
 function never(params) {
   return _never(ZodNever, params);
 }
+var ZodDate = /* @__PURE__ */ $constructor("ZodDate", (inst, def) => {
+  $ZodDate.init(inst, def);
+  ZodType.init(inst, def);
+  inst._zod.processJSONSchema = (ctx, json, params) => dateProcessor(inst, ctx, json, params);
+  inst.min = (value, params) => inst.check(_gte(value, params));
+  inst.max = (value, params) => inst.check(_lte(value, params));
+}, /* @__PURE__ */ derived({
+  minDate: (inst) => {
+    const { minimum } = aggregateChecks(inst);
+    return minimum ? new Date(minimum) : null;
+  },
+  maxDate: (inst) => {
+    const { maximum } = aggregateChecks(inst);
+    return maximum ? new Date(maximum) : null;
+  }
+}, {}));
 var ZodArray = /* @__PURE__ */ $constructor("ZodArray", (inst, def) => {
   _ensureDefaultMemoizer();
   $ZodArray.init(inst, def);
@@ -5720,6 +5869,30 @@ function refine(fn, _params = {}) {
 function superRefine(fn, params) {
   return _superRefine(fn, params);
 }
+// ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/coerce.js
+var exports_coerce = {};
+__export(exports_coerce, {
+  bigint: () => bigint2,
+  boolean: () => boolean3,
+  date: () => date2,
+  number: () => number3,
+  string: () => string3
+});
+function string3(params) {
+  return _coercedString(ZodString, params);
+}
+function number3(params) {
+  return _coercedNumber(ZodNumber, params);
+}
+function boolean3(params) {
+  return _coercedBoolean(ZodBoolean, params);
+}
+function bigint2(params) {
+  return _coercedBigint(ZodBigInt, params);
+}
+function date2(params) {
+  return _coercedDate(ZodDate, params);
+}
 // ../../packages/contracts/src/index.ts
 var accountDomain = "crabcloud.cc";
 var adminDomain = `admin.${accountDomain}`;
@@ -5773,6 +5946,8 @@ var apiErrorSchema = object({
     "expired",
     "insufficient_credits",
     "payload_too_large",
+    "collab_space_not_bound",
+    "collab_space_mismatch",
     "internal"
   ]),
   message: string2()
@@ -5827,7 +6002,8 @@ var sessionSummarySchema = object({
 });
 var deviceStartInput = object({
   name: string2().trim().min(1).max(80),
-  scopes: array(_enum(scopes)).min(1).max(scopes.length)
+  scopes: array(_enum(scopes)).min(1).max(scopes.length),
+  space: string2().trim().min(1).max(80).optional()
 });
 var devicePollInput = object({ deviceCode: string2().min(16).max(200) });
 var deviceDecisionInput = object({
@@ -5839,6 +6015,7 @@ var agentTokenSummarySchema = object({
   id: string2(),
   name: string2(),
   scopes: array(_enum(scopes)),
+  collabSpace: string2().nullable().optional(),
   createdAt: number2(),
   lastUsedAt: number2().nullable(),
   expiresAt: number2().nullable(),
@@ -5886,6 +6063,13 @@ var adminPlanTierUpdateInput = object({
   quotaJson: record(string2(), unknown()).optional(),
   status: _enum(adminPlanTierStatuses).optional()
 });
+var subscriptionChangeInput = object({
+  tierId: string2().trim().min(1).max(50)
+});
+var adminUserSubscriptionInput = object({
+  tierId: string2().trim().min(1).max(50),
+  reason: string2().trim().min(1).max(500)
+});
 var giftFulfillments = ["stock", "webhook"];
 var giftMerchantStatuses = ["active", "disabled"];
 var giftProductStatuses = ["draft", "live", "delisted"];
@@ -5990,6 +6174,49 @@ var contactQueryInput = object({
   limit: number2().int().min(1).max(50).default(20),
   offset: number2().int().min(0).default(0)
 });
+var collabTaskStatuses = ["open", "done"];
+var collabBoostKinds = ["tasks", "members"];
+var COLLAB_RECORD_BODY_MAX = 20000;
+var COLLAB_RECORD_FILES_MAX = 10;
+var COLLAB_RECORD_LINKS_MAX = 10;
+var COLLAB_TITLE_MAX = 200;
+var COLLAB_SPACE_NAME_MAX = 64;
+var COLLAB_SUMMARY_MAX = 2000;
+var collabCreateSpaceInput = object({
+  name: string2().trim().min(1).max(COLLAB_SPACE_NAME_MAX),
+  allocationBytes: number2().int().min(1).max(10 * 1024 * 1024 * 1024).optional()
+});
+var collabRenameSpaceInput = object({ name: string2().trim().min(1).max(COLLAB_SPACE_NAME_MAX) });
+var collabAllocationInput = object({
+  allocationBytes: number2().int().min(1).max(10 * 1024 * 1024 * 1024)
+});
+var collabBoostInput = object({ kind: _enum(collabBoostKinds) });
+var collabInviteInput = object({ username: usernameSchema });
+var collabLinkInput = string2().trim().url().max(2000);
+var collabCreateTaskInput = object({
+  title: string2().trim().min(1).max(COLLAB_TITLE_MAX),
+  body: string2().max(COLLAB_RECORD_BODY_MAX).default(""),
+  fileIds: array(string2().trim().min(1).max(64)).max(COLLAB_RECORD_FILES_MAX).optional(),
+  links: array(collabLinkInput).max(COLLAB_RECORD_LINKS_MAX).optional()
+});
+var collabPushRecordInput = object({
+  body: string2().min(1).max(COLLAB_RECORD_BODY_MAX),
+  fileIds: array(string2().trim().min(1).max(64)).max(COLLAB_RECORD_FILES_MAX).optional(),
+  links: array(collabLinkInput).max(COLLAB_RECORD_LINKS_MAX).optional()
+});
+var collabUpdateSummaryInput = object({
+  summary: string2().trim().max(COLLAB_SUMMARY_MAX)
+});
+var collabTaskListQuery = object({
+  status: _enum(collabTaskStatuses).optional(),
+  q: string2().trim().max(200).optional(),
+  cursor: string2().trim().max(200).optional(),
+  limit: exports_coerce.number().int().min(1).max(100).optional()
+});
+var collabRecordListQuery = object({
+  cursor: string2().trim().max(200).optional(),
+  limit: exports_coerce.number().int().min(1).max(200).optional()
+});
 
 // ../../packages/cloudkit/src/crypto.ts
 var enc = new TextEncoder;
@@ -6276,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;
   }
@@ -6309,6 +6539,9 @@ function requireCredentials() {
 function formatTime(ms) {
   return new Date(ms).toLocaleString("sv", { year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
 }
+function fmtCredits(cents) {
+  return cents.toLocaleString("en-US");
+}
 var usage = `crab — Crab Cloud CLI（Agent-first 入口）
 发布物经 npm 分发：npx @crabcloud/cli <command>（全局安装后短名 crab 等价）
 
@@ -6320,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 地址
 
@@ -6371,6 +6607,34 @@ 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）
+  credits pricing [--json]           动作计价标准（公开：动作单价/档位/充值包）
   skills install|list|uninstall [--agent claude,zcode,codex,agents]
                        skills 管理（claude/zcode/agents 复制目录，codex 写 AGENTS.md 段）
   logout               撤销当前 Agent Token 并清除本地凭证
@@ -6384,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;
@@ -6400,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)));
@@ -6445,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;
     }
   }
@@ -6473,11 +6749,105 @@ async function whoami() {
   if (subscription)
     console.log(`  订阅: ${subscription.tier_name}`);
   if (credits !== undefined)
-    console.log(`  积分余额: $${(credits / 100).toFixed(2)} (${credits} credit_cents)`);
+    console.log(`  积分余额: ${fmtCredits(credits)} 积分`);
   if (apps?.length)
     console.log(`  已启用应用: ${apps.map((a) => a.title).join("、")}`);
   return 0;
 }
+var CREDIT_REASON_LABELS = {
+  subscription_grant: "月送发放",
+  topup: "充值入账",
+  consume: "动作消耗",
+  refund: "退款",
+  adjustment: "人工调整"
+};
+var CREDIT_ACTION_LABELS = {
+  "mail.send_outbound": "外部出站邮件",
+  "collab.space_create": "创建独立协作空间",
+  "collab.boost_tasks": "协作任务扩容（+20）",
+  "collab.boost_members": "协作成员扩容（+5）"
+};
+function creditMovement(entry) {
+  if (entry.grantedDelta === null && entry.topupDelta === null)
+    return entry.delta;
+  return (entry.grantedDelta ?? 0) + (entry.topupDelta ?? 0);
+}
+async function fetchCredits(credentials, limit, offset) {
+  const res = await api2(credentials.apiBase, `/v1/me/credits?limit=${limit}&offset=${offset}`, { headers: authHeaders(credentials) });
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取积分数据失败。"));
+    if (res.body?.error?.code === "scope_denied") {
+      console.error("提示：积分命令需要 credits.read scope——运行 crab login --scopes account 重新授权。");
+    }
+    return exitCodeForApiError(res.body);
+  }
+  return res.body.data;
+}
+async function creditsBalance() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const data = await fetchCredits(credentials, 1, 0);
+  if (typeof data === "number")
+    return data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data.balance, null, 2));
+    return 0;
+  }
+  console.log(`积分余额：${fmtCredits(data.balance.balance)}`);
+  console.log(`  月送 ${fmtCredits(data.balance.granted)}（每周期刷新清零） · 充值 ${fmtCredits(data.balance.topup)}（长期有效）`);
+  return 0;
+}
+async function creditsHistory() {
+  const credentials = requireCredentials();
+  if (typeof credentials === "number")
+    return credentials;
+  const limit = Math.min(Math.max(Number.parseInt(readFlag("--limit") ?? "", 10) || 20, 1), 100);
+  const offset = Math.max(Number.parseInt(readFlag("--offset") ?? "", 10) || 0, 0);
+  const data = await fetchCredits(credentials, limit, offset);
+  if (typeof data === "number")
+    return data;
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return 0;
+  }
+  if (data.ledger.length === 0) {
+    console.log("还没有积分流水。");
+    return 0;
+  }
+  for (const entry of data.ledger) {
+    const movement = creditMovement(entry);
+    const signed = movement > 0 ? `+${fmtCredits(movement)}` : fmtCredits(movement);
+    console.log(`${formatTime(entry.createdAt)}  ${CREDIT_REASON_LABELS[entry.reason] ?? entry.reason}  ${signed}`);
+  }
+  console.log(`
+共 ${fmtCredits(data.total)} 条（本页 ${data.ledger.length} 条，--offset 翻页）`);
+  return 0;
+}
+async function creditsPricing() {
+  const credentials = loadCredentials();
+  const apiBase = credentials ? credentials.apiBase : process.env.CRAB_API ?? readFlag("--api") ?? DEFAULT_API;
+  const res = await api2(apiBase, "/v1/pricing/standard");
+  if (res.status !== 200) {
+    console.error(errorMessage(res.body, "获取动作计价失败。"));
+    return exitCodeForApiError(res.body);
+  }
+  const actions = res.body.data?.actions ?? [];
+  if (hasFlag("--json")) {
+    console.log(JSON.stringify(res.body.data, null, 2));
+    return 0;
+  }
+  if (actions.length === 0) {
+    console.log("暂无动作计价项。");
+    return 0;
+  }
+  console.log("动作计价（credit_cents，100 = $1.00）：");
+  for (const item of actions) {
+    const label = CREDIT_ACTION_LABELS[item.action] ?? item.action;
+    console.log(`  ${item.action.padEnd(24)} ${label}  ${fmtCredits(item.creditCents)} 积分`);
+  }
+  return 0;
+}
 async function tokensList() {
   const credentials = requireCredentials();
   if (typeof credentials === "number")
@@ -6497,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;
@@ -6752,7 +7122,7 @@ async function mailSend() {
   if (attachmentIds.length > 0)
     console.log(`  附件 ${attachmentIds.length} 个（云盘引用，不复制）`);
   if (result.chargedCredits > 0)
-    console.log(`  消耗积分：$${(result.chargedCredits / 100).toFixed(2)}（${result.chargedCredits} credit_cents）`);
+    console.log(`  消耗积分：${fmtCredits(result.chargedCredits)}`);
   if (result.failedExternal > 0)
     console.log(`  ⚠ ${result.failedExternal} 个外部收件人发送失败，对应积分已退回`);
   return 0;
@@ -7574,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 查看身份）。");
@@ -7708,6 +8559,58 @@ switch (command) {
     console.log(usage);
     process.exit(EXIT_USAGE);
   }
+  case "credits": {
+    const sub = args[1];
+    if (!sub || sub === "balance")
+      process.exit(await creditsBalance());
+    if (sub === "history")
+      process.exit(await creditsHistory());
+    if (sub === "pricing")
+      process.exit(await creditsPricing());
+    console.error(`未知子命令：credits ${sub}
+`);
+    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/SKILL.md

@@ -30,6 +30,9 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
 |---|---|
 | 看账号身份 / 订阅 / 积分 | `crab whoami` |
 | 程序化读取身份 | `crab whoami --json` |
+| 积分余额（月送/充值/合计） | `crab credits`（需 `credits.read`，脚本消费加 `--json`） |
+| 积分流水（花了多少、花在哪） | `crab credits history [--limit N] [--offset N]`（变动 ±：消耗为负；`--json` 含 total） |
+| 查动作计价（如发一封外域邮件扣多少） | `crab credits pricing`（公开端点，无需登录） |
 | 列出已授权的 Agent 令牌 | `crab tokens list`（脚本消费加 `--json`） |
 | 撤销某个令牌（高危，先确认） | `crab tokens revoke <id>` |
 | 重新授权 / 调整 scope | `crab login --scopes mail`（组名整组授权；也可单 scope 如 `mail.read`。浏览器确认，你只发起） |
@@ -39,6 +42,10 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
 | 我的邀请码、邀请链接与受邀名单 | `crab contacts invite [--reset]` / `crab contacts invitees` |
 | 管理登录设备 / 会话、修改密码 | 网页个人中心（crabcloud.cc/account）——CLI 有意不开放 |
 
+积分命令需 `credits.read` scope（`account` 组含它）：退出码 4 报缺该 scope 时，
+引导 `crab login --scopes account` 重新授权。积分额度一律以**积分数**表述
+（100 积分 = $1.00，仅价格类口径用美元）；充值/下单是 Web 会话能力，CLI/Agent
+令牌不动账——用户要充值时引导网页账单页（crabcloud.cc/account/billing）。
 拿不准令牌 id 时先 `crab tokens list` 核对；`revoke` 只接受列表里的 id。
 
 ## 机器可读输出

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,6 +1,6 @@
 {
   "name": "@crabcloud/cli",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "type": "module",
   "description": "Crab Cloud CLI (crab) — agent-first entry to your personal cloud, with skills bundled for Claude Code / Codex / ZCode.",
   "bin": {