vps-work 1.0.1 → 1.1.0

package/.well-known/skills/index.json

@@ -128,7 +128,7 @@
     },
     {
       "name": "vps-documents",
-      "description": "查询、读取、新建、重命名、复制、导出和共享 Vertu 企业云文档、智能表格与文件夹，读取智能表格工作簿并批量更新单元格，以及将文档卡片发送到当前 VPS IM 会话。用户提到云文档、V盘文档、企业文档、智能表格、创建文档、读取或更新表格单元格、修改标题、复制文档、导出 Markdown、设置文档权限或把文档发到当前会话时使用。入口为 `vps-work docs +…`。",
+      "description": "查询、读取、新建、重命名、复制、导出和共享 Vertu 企业云文档、智能表格、多维表与文件夹，读取智能表格工作簿并批量更新单元格，操作多维表记录/字段/视图，以及将文档卡片发送到当前 VPS IM 会话。用户提到云文档、V盘文档、企业文档、智能表格、多维表、创建文档、读取或更新表格单元格、修改标题、复制文档、导出 Markdown、设置文档权限或把文档发到当前会话时使用。入口为 `vps-work docs +…`。",
       "files": [
         "skills/vps-documents/SKILL.md",
         "skills/vps-documents/agents/openai.yaml",

package/USAGE.md

@@ -145,7 +145,7 @@ vps-work attendance +schedules --rule-id <rule-id> --from-date 2026-08-26 --to-d
 vps-work attendance +schedule-preview --rule-id <rule-id> --employee-ids 123,456 --from-date 2026-08-26 --to-date 2026-08-31 --shift-template-id <shift-id>
 vps-work attendance +schedule-apply --rule-id <rule-id> --items-file ./schedule-plan.json --mode fill_missing --preview-token <token> --client-request-id <uuid>
 vps-work creative +models --type image
-vps-work creative +image --model <id> --prompt "一只金丝猴在雪山上" --aspect-ratio 16:9
+vps-work creative +image --model openai/gpt-image-2.5-sunburst --prompt "一只金丝猴在雪山上" --aspect-ratio 16:9
 vps-work creative +video --model <id> --prompt "..." --ratio 16:9 --duration 5 --wait
 vps-work creative +video-status --model <id> --task-id <task_id>
 vps-work creative +tts --model <id> --text "你好，欢迎使用"

package/dist/vps-work.cjs

@@ -61467,7 +61467,7 @@ function attachCreativeShortcuts(parent) {
     printResult5(opts, await vpsServiceGet("/v1/creative/models", query2, baseUrl4, "\u521B\u610F\u5DE5\u574A\u6A21\u578B"));
   });
   attachSharedShortcutOptions(
-    parent.command("+image").description("AI \u751F\u56FE / \u6539\u56FE\uFF0C\u8FD4\u56DE image_url \u4E0E\u8BA1\u8D39\uFF08POST /api/aigc/image-edit\uFF09").option("--model <id>", "\u6A21\u578B id \u6216 model_id\uFF08\u5FC5\u586B\uFF09").option("--prompt <text>", "\u753B\u9762\u63D0\u793A\u8BCD\uFF08\u5FC5\u586B\uFF09").option("--source-image-url <url>", "\u53C2\u8003/\u5E95\u56FE URL").option("--reference-images <urls>", "\u53C2\u8003\u56FE URL \u5217\u8868\uFF08\u9017\u53F7\u5206\u9694\uFF09").option("--size <size>", "\u8F93\u51FA\u5C3A\u5BF8\uFF0C\u5982 1024x1024 / auto").option("--quality <q>", "\u8D28\u91CF\uFF1Alow|medium|high|auto").option("--resolution <r>", "\u5206\u8FA8\u7387\u6863\uFF1A512|1K|2K|4K").option("--aspect-ratio <ratio>", "\u5BBD\u9AD8\u6BD4\uFF0C\u5982 1:1 / 16:9").option("--background <text>", "\u80CC\u666F\u63CF\u8FF0").option("--output-compression <n>", "\u8F93\u51FA\u538B\u7F29\u7EA7\u522B\uFF08\u6574\u6570\uFF09").option("--n <n>", "\u751F\u6210\u5F20\u6570\uFF08\u5F53\u524D\u63A5\u53E3\u56FA\u5B9A\u5355\u56FE\uFF09")
+    parent.command("+image").description("AI \u751F\u56FE / \u6539\u56FE\uFF0C\u8FD4\u56DE image_url \u4E0E\u8BA1\u8D39\uFF08POST /api/aigc/image-edit\uFF09").option("--model <id>", "\u6A21\u578B id \u6216 model_id\uFF08\u5FC5\u586B\uFF09").option("--prompt <text>", "\u753B\u9762\u63D0\u793A\u8BCD\uFF08\u5FC5\u586B\uFF09").option("--source-image-url <url>", "\u53C2\u8003/\u5E95\u56FE URL").option("--reference-images <urls>", "\u53C2\u8003\u56FE URL \u5217\u8868\uFF08\u9017\u53F7\u5206\u9694\uFF09").option("--size <size>", "\u8F93\u51FA\u5C3A\u5BF8\uFF0C\u5982 1024x1024 / auto").option("--quality <q>", "\u8D28\u91CF\uFF1Aauto|low|medium|high|xhigh|max\uFF08\u540E\u4E24\u6863\u4EC5 gpt-image-2.5-sunburst\uFF09").option("--resolution <r>", "\u5206\u8FA8\u7387\u6863\uFF1A512|1K|2K|4K").option("--aspect-ratio <ratio>", "\u5BBD\u9AD8\u6BD4\uFF0C\u5982 1:1 / 16:9").option("--background <text>", "\u80CC\u666F\uFF1Aauto|opaque|transparent\uFF08transparent \u4EC5 gpt-image-2.5-sunburst\uFF09").option("--output-compression <n>", "\u8F93\u51FA\u538B\u7F29\u7EA7\u522B\uFF08\u6574\u6570\uFF09").option("--n <n>", "\u751F\u6210\u5F20\u6570\uFF08\u5F53\u524D\u63A5\u53E3\u56FA\u5B9A\u5355\u56FE\uFF09")
   ).action(async (opts, cmd) => {
     if (!opts.model || !opts.prompt) {
       throw new VertuError("\u751F\u56FE\u9700\u8981 --model \u4E0E --prompt");
@@ -61988,10 +61988,10 @@ async function resolveBlockPatch(opts) {
 }
 function parseDocType(value) {
   const normalized = value?.trim() || "block";
-  if (normalized === "block" || normalized === "sheet" || normalized === "folder") {
+  if (normalized === "block" || normalized === "sheet" || normalized === "folder" || normalized === "base") {
     return normalized;
   }
-  throw new VertuError("--type \u9700\u4E3A block\u3001sheet \u6216 folder\u3002");
+  throw new VertuError("--type \u9700\u4E3A block\u3001sheet\u3001folder \u6216 base\u3002");
 }
 function parseScope(value) {
   const normalized = value?.trim() || "mine";
@@ -62032,7 +62032,7 @@ function text2(recordValue, ...keys) {
   return "";
 }
 function documentType(value) {
-  return value === "sheet" || value === "folder" || value === "html" ? value : "block";
+  return value === "sheet" || value === "folder" || value === "html" || value === "base" ? value : "block";
 }
 function documentExcerpt(value) {
   return typeof value === "string" ? value.replace(/\s+/g, " ").trim().slice(0, 800) : "";
@@ -62059,6 +62059,20 @@ async function resolveSheetUpdates(opts) {
   }
   return parsed;
 }
+async function resolveJsonRecords(opts) {
+  if (opts.records !== void 0 && opts.recordsFile !== void 0) {
+    throw new VertuError("--records \u548C --records-file \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528\u3002");
+  }
+  const raw = await resolveContent({ content: opts.records, contentFile: opts.recordsFile });
+  if (raw === void 0) {
+    throw new VertuError("\u8BF7\u63D0\u4F9B --records \u6216 --records-file\u3002");
+  }
+  const parsed = parseJsonArg(raw, "--records", { fileFlagSuggestion: "--records-file" });
+  if (!Array.isArray(parsed) || parsed.length === 0) {
+    throw new VertuError("\u8BB0\u5F55\u5FC5\u987B\u662F\u975E\u7A7A JSON \u6570\u7EC4\u3002");
+  }
+  return parsed;
+}
 function positiveIntegerEnv(...keys) {
   for (const key of keys) {
     const raw = process.env[key]?.trim();
@@ -62109,7 +62123,7 @@ function buildDocumentsCommand() {
     printDocumentsResult(opts.json, payload);
   });
   attachBaseOptions(
-    documents.command("+create").description("\u65B0\u5EFA\u6587\u6863\u3001\u667A\u80FD\u8868\u683C\u6216\u6587\u4EF6\u5939").requiredOption("--title <title>", "\u6807\u9898").option("--type <type>", "block / sheet / folder", "block").option("--content <text>", "\u65B0\u5EFA\u6587\u6863\u7684 Markdown \u521D\u59CB\u6B63\u6587").option("--content-file <path>", "\u4ECE UTF-8 \u6587\u4EF6\u8BFB\u53D6\u521D\u59CB\u6B63\u6587\uFF1B- \u8868\u793A stdin").option("--parent-id <id>", "\u7236\u6587\u4EF6\u5939 ID")
+    documents.command("+create").description("\u65B0\u5EFA\u6587\u6863\u3001\u667A\u80FD\u8868\u683C\u3001\u591A\u7EF4\u8868\u6216\u6587\u4EF6\u5939").requiredOption("--title <title>", "\u6807\u9898").option("--type <type>", "block / sheet / folder / base", "block").option("--content <text>", "\u65B0\u5EFA\u6587\u6863\u7684 Markdown \u521D\u59CB\u6B63\u6587").option("--content-file <path>", "\u4ECE UTF-8 \u6587\u4EF6\u8BFB\u53D6\u521D\u59CB\u6B63\u6587\uFF1B- \u8868\u793A stdin").option("--parent-id <id>", "\u7236\u6587\u4EF6\u5939 ID")
   ).action(async (opts) => {
     const type = parseDocType(opts.type);
     const content = await resolveContent(opts);
@@ -62231,6 +62245,160 @@ Notes:
     );
     printDocumentsResult(opts.json, payload);
   });
+  attachBaseOptions(
+    documents.command("+base-schema").description("\u8BFB\u53D6\u591A\u7EF4\u8868\u7684\u8868\u3001\u5B57\u6BB5\u548C\u89C6\u56FE").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest("GET", documentPath(required(opts.docId, "--doc-id"), "/base"), {
+        baseUrl: opts.baseUrl
+      })
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-tables").description("\u5217\u51FA\u591A\u7EF4\u8868\u4E2D\u7684\u6570\u636E\u8868").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID")
+  ).action(async (opts) => {
+    const payload = await documentsRequest(
+      "GET",
+      documentPath(required(opts.docId, "--doc-id"), "/base"),
+      { baseUrl: opts.baseUrl }
+    );
+    printDocumentsResult(opts.json, { tables: payload.base?.tables ?? [] });
+  });
+  attachBaseOptions(
+    documents.command("+base-create-table").description("\u65B0\u5EFA\u4E00\u5F20\u6570\u636E\u8868").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--name <name>", "\u6570\u636E\u8868\u540D\u79F0")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest("POST", documentPath(required(opts.docId, "--doc-id"), "/base/tables"), {
+        baseUrl: opts.baseUrl,
+        body: { name: required(opts.name, "--name") }
+      })
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-records").description("\u8BFB\u53D6\u591A\u7EF4\u8868\u8BB0\u5F55").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").option("--view-id <id>", "\u6309\u89C6\u56FE\u8FC7\u6EE4").option("--query <text>", "\u5173\u952E\u5B57\u641C\u7D22").option("--limit <n>", "\u8FD4\u56DE\u6761\u6570")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "GET",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/records`),
+        {
+          baseUrl: opts.baseUrl,
+          query: {
+            limit: opts.limit,
+            q: opts.query,
+            viewId: opts.viewId
+          }
+        }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-create-records").description("\u6279\u91CF\u65B0\u589E\u8BB0\u5F55\uFF0Cfields \u4F7F\u7528\u5B57\u6BB5 ID").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").option("--records <json>", "\u8BB0\u5F55 JSON \u6570\u7EC4").option("--records-file <path>", "\u4ECE UTF-8 JSON \u6587\u4EF6\u8BFB\u53D6\u8BB0\u5F55\uFF1B- \u8868\u793A stdin")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "POST",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/records`),
+        {
+          baseUrl: opts.baseUrl,
+          body: { records: await resolveJsonRecords(opts) }
+        }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-update-records").description("\u6279\u91CF\u66F4\u65B0\u8BB0\u5F55\uFF0C\u6BCF\u9879\u9700\u542B id \u548C fields").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").option("--records <json>", "\u66F4\u65B0 JSON \u6570\u7EC4").option("--records-file <path>", "\u4ECE UTF-8 JSON \u6587\u4EF6\u8BFB\u53D6\u66F4\u65B0\uFF1B- \u8868\u793A stdin")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "PATCH",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/records`),
+        {
+          baseUrl: opts.baseUrl,
+          body: { records: await resolveJsonRecords(opts) }
+        }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-create-field").description("\u65B0\u589E\u5B57\u6BB5").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").requiredOption("--name <name>", "\u5B57\u6BB5\u540D\u79F0").requiredOption("--type <type>", "singleLineText / longText / number / singleSelect / multipleSelect / checkbox / date / attachment").option("--choices <json>", "\u5355\u9009/\u591A\u9009\u9009\u9879 JSON \u6570\u7EC4")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "POST",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/fields`),
+        {
+          baseUrl: opts.baseUrl,
+          body: {
+            name: required(opts.name, "--name"),
+            options: opts.choices ? { choices: parseJsonArg(opts.choices, "--choices") } : void 0,
+            type: required(opts.type, "--type")
+          }
+        }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-views").description("\u5217\u51FA\u6570\u636E\u8868\u89C6\u56FE").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "GET",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/views`),
+        { baseUrl: opts.baseUrl }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-create-view").description("\u65B0\u5EFA\u53EA\u8BFB\u89C6\u56FE\u5B9A\u4E49").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").requiredOption("--name <name>", "\u89C6\u56FE\u540D\u79F0").option("--type <type>", "grid / kanban / form", "grid")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "POST",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/views`),
+        {
+          baseUrl: opts.baseUrl,
+          body: { name: required(opts.name, "--name"), type: opts.type ?? "grid" }
+        }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-import").description("\u4ECE CSV \u5BFC\u5165\u8BB0\u5F55").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").option("--csv <text>", "CSV \u6587\u672C").option("--csv-file <path>", "\u4ECE UTF-8 \u6587\u4EF6\u8BFB\u53D6 CSV\uFF1B- \u8868\u793A stdin")
+  ).action(async (opts) => {
+    const csv = await resolveContent({ content: opts.csv, contentFile: opts.csvFile });
+    if (csv === void 0) {
+      throw new VertuError("\u8BF7\u63D0\u4F9B --csv \u6216 --csv-file\u3002");
+    }
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "POST",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/import`),
+        { baseUrl: opts.baseUrl, body: { csv, hasHeader: true } }
+      )
+    );
+  });
+  attachBaseOptions(
+    documents.command("+base-export").description("\u5BFC\u51FA\u5F53\u524D\u89C6\u56FE\u6216\u5168\u8868\u4E3A CSV").requiredOption("--doc-id <id>", "\u591A\u7EF4\u8868\u6587\u6863 ID").requiredOption("--table <id>", "\u6570\u636E\u8868 ID").option("--view-id <id>", "\u6309\u89C6\u56FE\u5BFC\u51FA")
+  ).action(async (opts) => {
+    printDocumentsResult(
+      opts.json,
+      await documentsRequest(
+        "GET",
+        documentPath(required(opts.docId, "--doc-id"), `/base/tables/${encodeURIComponent(required(opts.table, "--table"))}/export`),
+        { baseUrl: opts.baseUrl, query: { viewId: opts.viewId } }
+      )
+    );
+  });
   attachBaseOptions(
     documents.command("+share").description("\u8BBE\u7F6E\u94FE\u63A5\u6216\u4F01\u4E1A\u5185\u90E8\u5171\u4EAB\u6743\u9650").requiredOption("--doc-id <id>", "\u6587\u6863 ID").requiredOption("--mode <mode>", "private / public-view / public-edit / login-view / login-edit / team-view / team-edit")
   ).action(async (opts) => {
@@ -63948,7 +64116,7 @@ function buildCliRootHelpAfter() {
     "",
     "    # Content creation (AI image / video / audio)",
     `    ${b} creative +models --type image`,
-    `    ${b} creative +image --model <id> --prompt "\u4E00\u53EA\u91D1\u4E1D\u7334\u5728\u96EA\u5C71\u4E0A" --aspect-ratio 16:9`,
+    `    ${b} creative +image --model openai/gpt-image-2.5-sunburst --prompt "\u4E00\u53EA\u91D1\u4E1D\u7334\u5728\u96EA\u5C71\u4E0A" --aspect-ratio 16:9`,
     `    ${b} creative +video --model <id> --prompt "..." --ratio 16:9 --duration 5 --wait`,
     `    ${b} creative +video-status --model <id> --task-id <task_id>`,
     `    ${b} creative +tts --model <id> --text "\u4F60\u597D\uFF0C\u6B22\u8FCE\u4F7F\u7528" --voice-id <voice_id>`,
@@ -64041,7 +64209,7 @@ function rewriteLongFlag(tok) {
 }
 
 // src/bin/vps-work.ts
-var PKG_VERSION = "1.0.1" ? "1.0.1" : "0.0.0-dev";
+var PKG_VERSION = "1.1.0" ? "1.1.0" : "0.0.0-dev";
 function smartFlagSuggest(flag, candidates) {
   if (!flag.startsWith("--") || flag.length < 4) return "";
   const word = flag.slice(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vps-work",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "VPS Work CLI - tenant-aware domain shortcuts and bundled agent skills for Cursor / Claude Code / Trae.",
   "license": "MIT",
   "author": "he-linyan",

package/skills/vps-creative/SKILL.md

@@ -27,13 +27,13 @@ description: "内容创作画布（创意工坊）AI 生成：生图/改图、
 | Shortcut | flags |
 |----------|-------|
 | `+models` | `--type`（image / video / audio / tts / text） |
-| `+image` | `--model`（必填）`--prompt`（必填）`--source-image-url` `--reference-images`（逗号分隔）`--size` `--quality` `--resolution` `--aspect-ratio` `--background` `--output-compression` `--n` |
+| `+image` | `--model`（必填）`--prompt`（必填）`--source-image-url` `--reference-images`（逗号分隔）`--size` `--quality`（`auto\|low\|medium\|high`，Sunburst 另有 `xhigh\|max`）`--resolution` `--aspect-ratio` `--background`（`auto\|opaque`，Sunburst 另有 `transparent`）`--output-compression` `--n` |
 | `+video` | `--model`（必填）`--prompt` `--reference-images` `--reference-videos` `--reference-audios` `--reference-audio-durations-sec` `--first-frame-image` `--last-frame-image` `--ratio` `--resolution` `--duration` `--generate-audio` `--watermark` `--wait` `--wait-timeout` `--poll-interval` |
 | `+video-status` | `--model`（必填）`--task-id`（必填） |
 | `+tts` | `--model`（必填）`--text`（必填）`--voice-id` `--speed` `--vol` `--pitch` `--emotion` `--format` `--sample-rate` `--bitrate` |
 | `+music` | `--model`（必填）`--prompt`（必填）`--lyrics` `--instrumental` `--lyrics-optimizer` `--format` `--sample-rate` `--bitrate` |
 
-`model` 可填 `model_id`（如 `gpt-image-1`、`doubao-seedance-2-0-*`、`speech-2.8-hd`、`music-2.6`）或模型行 UUID；不确定时先 `creative +models --type <image|video|tts|audio>` 查。
+`model` 可填 `model_id`（如 `openai/gpt-image-2.5-sunburst`、`openai/gpt-image-2`、`google/gemini-3.1-flash-image`、`doubao-seedance-2-0-*`）或模型行 UUID；不确定时先 `creative +models --type <image|video|tts|audio>` 查。
 
 ## 生视频（异步）流程
 

package/skills/vps-documents/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vps-documents
-description: 查询、读取、新建、重命名、复制、导出和共享 Vertu 企业云文档、智能表格与文件夹，读取智能表格工作簿并批量更新单元格，以及将文档卡片发送到当前 VPS IM 会话。用户提到云文档、V盘文档、企业文档、智能表格、创建文档、读取或更新表格单元格、修改标题、复制文档、导出 Markdown、设置文档权限或把文档发到当前会话时使用。入口为 `vps-work docs +…`。
+description: 查询、读取、新建、重命名、复制、导出和共享 Vertu 企业云文档、智能表格、多维表与文件夹，读取智能表格工作簿并批量更新单元格，操作多维表记录/字段/视图，以及将文档卡片发送到当前 VPS IM 会话。用户提到云文档、V盘文档、企业文档、智能表格、多维表、创建文档、读取或更新表格单元格、修改标题、复制文档、导出 Markdown、设置文档权限或把文档发到当前会话时使用。入口为 `vps-work docs +…`。
 ---
 
 # Vertu 企业云文档
@@ -20,6 +20,14 @@ description: 查询、读取、新建、重命名、复制、导出和共享 Ver
 | 精确修改段落格式 | `vps-work docs +update-block --doc-id <uuid> --block-id <id> --patch <json>` |
 | 新建文档 | `vps-work docs +create --title <标题> [--content-file <md>]` |
 | 新建智能表格 | `vps-work docs +create --title <标题> --type sheet` |
+| 新增多维表 | `vps-work docs +create --title <标题> --type base` |
+| 读取多维表结构 | `vps-work docs +base-schema --doc-id <uuid>` |
+| 读取多维表记录 | `vps-work docs +base-records --doc-id <uuid> --table <id>` |
+| 新增多维表记录 | `vps-work docs +base-create-records --doc-id <uuid> --table <id> --records-file <json>` |
+| 更新多维表记录 | `vps-work docs +base-update-records --doc-id <uuid> --table <id> --records-file <json>` |
+| 新增多维表字段 | `vps-work docs +base-create-field --doc-id <uuid> --table <id> --name <名称> --type <类型>` |
+| 导入 CSV | `vps-work docs +base-import --doc-id <uuid> --table <id> --csv-file <csv>` |
+| 导出 CSV | `vps-work docs +base-export --doc-id <uuid> --table <id>` |
 | 读取智能表格 | `vps-work docs +sheet-get --doc-id <uuid>` |
 | 更新智能表格单元格 | `vps-work docs +sheet-set-cells --doc-id <uuid> --updates-file <json>` |
 | 新建文件夹 | `vps-work docs +create --title <标题> --type folder` |
@@ -53,6 +61,7 @@ description: 查询、读取、新建、重命名、复制、导出和共享 Ver
 - `public-edit` 会允许持链接编辑，风险较高；用户没有明确要求时不得启用。
 - 复制、创建、重命名和共享是写操作；根据用户意图执行。删除能力目前不向 Agent CLI 开放。
 - 命令默认输出 JSON，优先读取 `id`、`title`、`type`、`role`、`shareMode`、`content`。
+- 多维表字段 `--type`：`singleLineText`、`longText`、`number`、`singleSelect`、`multipleSelect`、`checkbox`、`date`、`attachment`。附件字段值为 `{ name, url, mimeType?, sizeBytes? }` 数组。
 
 ## 示例
 

package/skills/vps-documents/references/api.md

@@ -14,6 +14,17 @@ CLI 统一请求 `vps-service`，由服务端校验 Hermes Agent Key、解析当
 | `docs +update-block` | `PATCH /v1/documents/:id/blocks/:blockId` | 在协作事务内精确修改一个块的白名单格式 |
 | `docs +sheet-get` | `GET /v1/documents/:id/sheet` | 返回智能表格当前工作簿 JSON |
 | `docs +sheet-set-cells` | `PUT /v1/documents/:id/sheet` | 通过实时协作工作簿批量更新 A1 单元格 |
+| `docs +base-schema` | `GET /v1/documents/:id/base` | 多维表结构 |
+| `docs +base-tables` | `GET /v1/documents/:id/base` | 从 schema 取出 tables |
+| `docs +base-create-table` | `POST /v1/documents/:id/base/tables` | 新建数据表 |
+| `docs +base-records` | `GET /v1/documents/:id/base/tables/:tableId/records` | 记录列表 |
+| `docs +base-create-records` | `POST /v1/documents/:id/base/tables/:tableId/records` | 批量新增记录 |
+| `docs +base-update-records` | `PATCH /v1/documents/:id/base/tables/:tableId/records` | 批量更新记录 |
+| `docs +base-create-field` | `POST /v1/documents/:id/base/tables/:tableId/fields` | 新增字段 |
+| `docs +base-views` | `GET /v1/documents/:id/base/tables/:tableId/views` | 视图列表 |
+| `docs +base-create-view` | `POST /v1/documents/:id/base/tables/:tableId/views` | 新建视图 |
+| `docs +base-import` | `POST /v1/documents/:id/base/tables/:tableId/import` | CSV 导入 |
+| `docs +base-export` | `GET /v1/documents/:id/base/tables/:tableId/export` | CSV 导出 |
 | `docs +share` | `POST /v1/documents/:id/share` | 修改共享模式 |
 | `docs +send` | `GET /v1/documents/:id` + 可选 `POST /share` + IM 消息接口 | 生成 `document_share` 卡片并发送到当前 Hermes/VPS IM 会话 |
 | `docs +duplicate` | `POST /v1/documents/:id/duplicate` | 复制文档 |
@@ -36,6 +47,7 @@ API 调用方若不是 `vps-work`，也应调用公开的 `/v1/documents` 接口
 
 - `block`：块文档，创建时支持 Markdown 初始正文。
 - `sheet`：智能表格，支持创建、查询、读取工作簿、批量更新单元格、重命名、复制、共享和导出。
+- `base`：多维表，独立服务保存表/字段/记录/视图；权限继承云文档 ACL。
 - `folder`：文件夹，用 `parentId` 组织层级。
 
 ## 共享模式