pdlab-cli 0.3.0 → 0.5.0

package/README.md

@@ -50,6 +50,7 @@ pdlab schema          # 一次性 JSON 输出全部命令、参数、权限要
 | `pdlab project join \| leave <id>` | 报名共建 / 撤回申请或退出共建 |
 | `pdlab project member review \| set-role \| remove <projectId> <userId>` | 审核报名、设置协作者角色、移除参与者（仅项目发起人本人） |
 | `pdlab project revenue <id>` | 查看项目的积分分成明细（只读） |
+| `pdlab collection list \| create \| update \| delete` | 项目集合（「解决方案云展厅」）的增删改查（列表 public 集合公开只读，写操作需 `collection:manage`） |
 | `pdlab post list \| get \| create \| update \| delete` | 内容的增删改查（`--project-id` 选填，不填即独立发布，不挂任何项目） |
 | `pdlab post review <id> --action approve\|reject` | 审核一条待审内容 |
 | `pdlab taxonomy list \| create \| update \| delete` | 分类标签的增删改查（列表公开只读，写操作需 `taxonomy:manage`） |
@@ -77,6 +78,17 @@ pdlab project leave proj_123
 pdlab project member review proj_123 user_456 --status approved
 pdlab project member set-role proj_123 user_456 --role maintainer
 
+# 创建项目集合，按顺序关联项目（需要 collection:manage 权限，即「1836发起人」角色）
+pdlab collection create \
+  --title "1836钠电与AIDC产业白皮书" \
+  --description "汇集多个共建项目的研究成果与产业洞察" \
+  --visibility public \
+  --project-ids proj_a,proj_b,proj_c
+
+# 更新集合关联的项目（全量替换）、排序、可见范围
+pdlab collection update coll_123 --project-ids proj_a,proj_c --sort-order 1
+pdlab collection list      # public 集合公开只读，不登录也能用
+
 # 往自己参与的项目发布内容（共建者发布后进待审队列）
 pdlab post create \
   --project-id <项目 id> \
@@ -149,6 +161,22 @@ API 地址的解析顺序：`--api-url` 参数 > `PDLAB_API_URL` 环境变量 >
 作者也才能 `post get` 到自己那篇还没过审的稿子。没登录则匿名读公开内容，照常可用。
 在 CI 里可以只给环境变量，不落配置文件。
 
+## 版本更新提示
+
+`pdlab` 每次运行都会顺手看一眼本地缓存的版本信息，如果有新版本会在命令结束时打印一行提示到
+**stderr**（不影响 stdout 的 JSON 输出，脚本/agent 该怎么解析还怎么解析）：
+
+```
+※ pdlab-cli 有新版本可用：0.3.0 → 0.4.0
+  运行 npm install -g pdlab-cli@latest 升级（可用 PDLAB_NO_UPDATE_CHECK=1 关闭此提示）
+```
+
+这个检查本身不会拖慢任何命令：真正去问 npm registry 的动作放在一个独立的后台进程里做，
+每 24 小时最多问一次，前台命令只读本地缓存（一次磁盘读，微秒级）。离线或连不上 registry
+时静默跳过，不影响命令本身的执行结果。
+
+不想看到这个提示：设置环境变量 `PDLAB_NO_UPDATE_CHECK=1`（CI/自动化脚本建议直接设置）。
+
 ## 凭证与安全
 
 - **凭证怎么来的**：走设备码授权——CLI 生成一次性 code，你在浏览器里确认后服务端才签发。

package/dist/index.js

@@ -24,8 +24,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_fs2 = require("fs");
-var import_path2 = require("path");
+var import_fs3 = require("fs");
+var import_path3 = require("path");
 var import_commander2 = require("commander");
 
 // src/commands/login.ts
@@ -354,38 +354,58 @@ var postReviewSchema = import_zod3.z.object({
   reviewComment: import_zod3.z.string().trim().max(500, "\u5BA1\u6838\u610F\u89C1\u6700\u591A 500 \u5B57").optional().describe("\u5BA1\u6838\u610F\u89C1\uFF08\u9A73\u56DE\u65F6\u5FC5\u586B\uFF09")
 });
 
-// ../shared-schemas/src/taxonomies.ts
+// ../shared-schemas/src/collections.ts
 var import_zod4 = require("zod");
-var taxonomyDimensionCreateSchema = import_zod4.z.object({
+var COLLECTION_VISIBILITY_VALUES = ["public", "private", "members"];
+var collectionCreateSchema = import_zod4.z.object({
+  title: import_zod4.z.string().trim().min(1, "\u96C6\u5408\u6807\u9898\u4E0D\u80FD\u4E3A\u7A7A").max(200).describe("\u96C6\u5408\u6807\u9898"),
+  description: import_zod4.z.string().max(2e4).optional().describe("\u96C6\u5408\u63CF\u8FF0"),
+  coverImage: safeImageUrl.optional().describe("\u5C01\u9762\u56FE\u94FE\u63A5\u6216\u4E0A\u4F20\u56FE\u7247\u5730\u5740"),
+  visibility: import_zod4.z.enum(COLLECTION_VISIBILITY_VALUES).optional().default("public").describe("\u53EF\u89C1\u8303\u56F4\uFF1Apublic \u6240\u6709\u4EBA\u53EF\u89C1 / private \u4E0D\u5BF9\u5916\u5217\u51FA / members \u4EC5\u767B\u5F55\u7528\u6237\u53EF\u89C1"),
+  // 关联项目按传入顺序落成 CollectionProject.position
+  projectIds: import_zod4.z.array(import_zod4.z.string().min(1)).max(100).optional().default([]).describe("\u6309\u987A\u5E8F\u5173\u8054\u7684\u9879\u76EE id \u5217\u8868")
+});
+var collectionUpdateSchema = import_zod4.z.object({
+  title: import_zod4.z.string().trim().min(1, "\u96C6\u5408\u6807\u9898\u4E0D\u80FD\u4E3A\u7A7A").max(200).optional().describe("\u96C6\u5408\u6807\u9898"),
+  description: import_zod4.z.string().max(2e4).optional().describe("\u96C6\u5408\u63CF\u8FF0"),
+  coverImage: safeImageUrl.optional().describe("\u5C01\u9762\u56FE\u94FE\u63A5\u6216\u4E0A\u4F20\u56FE\u7247\u5730\u5740"),
+  visibility: import_zod4.z.enum(COLLECTION_VISIBILITY_VALUES).optional().describe("\u53EF\u89C1\u8303\u56F4\uFF1Apublic/private/members"),
+  sortOrder: import_zod4.z.number().int().optional().describe("\u6392\u5E8F\u5E8F\u53F7\uFF0C\u8D8A\u5C0F\u8D8A\u9760\u524D"),
+  projectIds: import_zod4.z.array(import_zod4.z.string().min(1)).max(100).optional().describe("\u5173\u8054\u9879\u76EE id \u5217\u8868\uFF08\u5168\u91CF\u66FF\u6362\uFF09")
+}).refine((v) => Object.keys(v).length > 0, "\u6CA1\u6709\u9700\u8981\u66F4\u65B0\u7684\u5B57\u6BB5");
+
+// ../shared-schemas/src/taxonomies.ts
+var import_zod5 = require("zod");
+var taxonomyDimensionCreateSchema = import_zod5.z.object({
   // key 会进 URL 查询串和导出文件，限制成 slug 形态
-  key: import_zod4.z.string().trim().min(1).max(40).regex(/^[a-z][a-z0-9_]*$/, "\u7EF4\u5EA6\u6807\u8BC6\u53EA\u80FD\u7528\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u4E0B\u5212\u7EBF\uFF0C\u4E14\u4EE5\u5B57\u6BCD\u5F00\u5934").describe("\u7EF4\u5EA6\u6807\u8BC6\uFF0C\u5982 domain\uFF08\u521B\u5EFA\u540E\u4E0D\u53EF\u6539\uFF09"),
-  label: import_zod4.z.string().trim().min(1, "\u7EF4\u5EA6\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A").max(40).describe("\u7EF4\u5EA6\u4E2D\u6587\u540D\uFF0C\u5982\u300C\u9886\u57DF\u300D"),
-  description: import_zod4.z.string().max(500).optional().describe("\u7EF4\u5EA6\u8BF4\u660E"),
-  sortOrder: import_zod4.z.number().int().min(0).max(999).optional().default(0).describe("\u5C55\u793A\u6392\u5E8F")
+  key: import_zod5.z.string().trim().min(1).max(40).regex(/^[a-z][a-z0-9_]*$/, "\u7EF4\u5EA6\u6807\u8BC6\u53EA\u80FD\u7528\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u4E0B\u5212\u7EBF\uFF0C\u4E14\u4EE5\u5B57\u6BCD\u5F00\u5934").describe("\u7EF4\u5EA6\u6807\u8BC6\uFF0C\u5982 domain\uFF08\u521B\u5EFA\u540E\u4E0D\u53EF\u6539\uFF09"),
+  label: import_zod5.z.string().trim().min(1, "\u7EF4\u5EA6\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A").max(40).describe("\u7EF4\u5EA6\u4E2D\u6587\u540D\uFF0C\u5982\u300C\u9886\u57DF\u300D"),
+  description: import_zod5.z.string().max(500).optional().describe("\u7EF4\u5EA6\u8BF4\u660E"),
+  sortOrder: import_zod5.z.number().int().min(0).max(999).optional().default(0).describe("\u5C55\u793A\u6392\u5E8F")
 });
-var taxonomyDimensionUpdateSchema = import_zod4.z.object({
-  label: import_zod4.z.string().trim().min(1).max(40).optional().describe("\u7EF4\u5EA6\u4E2D\u6587\u540D"),
-  description: import_zod4.z.string().max(500).nullable().optional().describe("\u7EF4\u5EA6\u8BF4\u660E"),
-  sortOrder: import_zod4.z.number().int().min(0).max(999).optional().describe("\u5C55\u793A\u6392\u5E8F")
+var taxonomyDimensionUpdateSchema = import_zod5.z.object({
+  label: import_zod5.z.string().trim().min(1).max(40).optional().describe("\u7EF4\u5EA6\u4E2D\u6587\u540D"),
+  description: import_zod5.z.string().max(500).nullable().optional().describe("\u7EF4\u5EA6\u8BF4\u660E"),
+  sortOrder: import_zod5.z.number().int().min(0).max(999).optional().describe("\u5C55\u793A\u6392\u5E8F")
 });
-var taxonomyCreateSchema = import_zod4.z.object({
-  dimension: import_zod4.z.string().min(1).describe("\u6240\u5C5E\u7EF4\u5EA6\u7684 key\uFF0C\u5982 domain"),
-  label: import_zod4.z.string().trim().min(1, "\u6807\u7B7E\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A").max(100).describe("\u6807\u7B7E\u503C\uFF0C\u5982\u300C\u94A0\u7535\u4E0EAIDC\u5168\u7403\u57FA\u5EFA\u300D"),
-  weight: import_zod4.z.number().min(0).max(1).optional().default(0).describe("\u5EFA\u8BAE\u6743\u91CD 0~1\uFF1A\u53D1\u8D77\u9879\u76EE\u65F6\u9884\u586B\u7ED9\u53D1\u8D77\u4EBA\uFF0C\u53EF\u518D\u8C03"),
-  sortOrder: import_zod4.z.number().int().min(0).max(999).optional().default(0).describe("\u5C55\u793A\u6392\u5E8F"),
-  description: import_zod4.z.string().max(500).optional().describe("\u6807\u7B7E\u8BF4\u660E")
+var taxonomyCreateSchema = import_zod5.z.object({
+  dimension: import_zod5.z.string().min(1).describe("\u6240\u5C5E\u7EF4\u5EA6\u7684 key\uFF0C\u5982 domain"),
+  label: import_zod5.z.string().trim().min(1, "\u6807\u7B7E\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A").max(100).describe("\u6807\u7B7E\u503C\uFF0C\u5982\u300C\u94A0\u7535\u4E0EAIDC\u5168\u7403\u57FA\u5EFA\u300D"),
+  weight: import_zod5.z.number().min(0).max(1).optional().default(0).describe("\u5EFA\u8BAE\u6743\u91CD 0~1\uFF1A\u53D1\u8D77\u9879\u76EE\u65F6\u9884\u586B\u7ED9\u53D1\u8D77\u4EBA\uFF0C\u53EF\u518D\u8C03"),
+  sortOrder: import_zod5.z.number().int().min(0).max(999).optional().default(0).describe("\u5C55\u793A\u6392\u5E8F"),
+  description: import_zod5.z.string().max(500).optional().describe("\u6807\u7B7E\u8BF4\u660E")
 });
-var taxonomyUpdateSchema = import_zod4.z.object({
-  dimension: import_zod4.z.string().min(1).optional().describe("\u6240\u5C5E\u7EF4\u5EA6\u7684 key"),
-  label: import_zod4.z.string().min(1).optional().describe("\u6807\u7B7E\u503C"),
-  weight: import_zod4.z.number().min(0).max(1).optional().describe("\u5EFA\u8BAE\u6743\u91CD 0~1"),
-  sortOrder: import_zod4.z.number().int().optional().describe("\u5C55\u793A\u6392\u5E8F"),
-  description: import_zod4.z.string().optional().describe("\u6807\u7B7E\u8BF4\u660E")
+var taxonomyUpdateSchema = import_zod5.z.object({
+  dimension: import_zod5.z.string().min(1).optional().describe("\u6240\u5C5E\u7EF4\u5EA6\u7684 key"),
+  label: import_zod5.z.string().min(1).optional().describe("\u6807\u7B7E\u503C"),
+  weight: import_zod5.z.number().min(0).max(1).optional().describe("\u5EFA\u8BAE\u6743\u91CD 0~1"),
+  sortOrder: import_zod5.z.number().int().optional().describe("\u5C55\u793A\u6392\u5E8F"),
+  description: import_zod5.z.string().optional().describe("\u6807\u7B7E\u8BF4\u660E")
 });
 
 // src/errors.ts
 var import_commander = require("commander");
-var import_zod5 = require("zod");
+var import_zod6 = require("zod");
 var EXIT_CODES = {
   ok: 0,
   unhandled: 1,
@@ -418,7 +438,7 @@ function exampleHint(examples) {
 }
 function handleCommandError(error, examples = []) {
   let structured;
-  if (error instanceof import_zod5.ZodError) {
+  if (error instanceof import_zod6.ZodError) {
     structured = {
       error: "\u53C2\u6570\u6821\u9A8C\u5931\u8D25",
       code: "validation",
@@ -679,8 +699,100 @@ function registerProjectCommand(program2) {
   );
 }
 
-// src/commands/post.ts
+// src/commands/collection.ts
+var VISIBILITY_LIST = COLLECTION_VISIBILITY_VALUES.join(" | ");
+var LIST_EXAMPLES2 = [
+  { command: "pdlab collection list", note: "\u4E0D\u767B\u5F55\u53EA\u770B public \u96C6\u5408\uFF1B\u767B\u5F55\u540E\u540C\u65F6\u770B\u5F97\u5230 members \u96C6\u5408" }
+];
 var CREATE_EXAMPLES2 = [
+  {
+    command: 'pdlab collection create --title "1836\u94A0\u7535\u4E0EAIDC\u4EA7\u4E1A\u767D\u76AE\u4E66" --description "..." --project-ids proj_a,proj_b',
+    note: "title \u5FC5\u586B\uFF0C\u5176\u4F59\u5B57\u6BB5\u53EF\u7701\u7565\uFF1B\u9700\u8981\u300C1836\u53D1\u8D77\u4EBA\u300D\u89D2\u8272\uFF08collection:manage \u6743\u9650\uFF09"
+  }
+];
+var UPDATE_EXAMPLES2 = [
+  { command: "pdlab collection update coll_123 --sort-order 1", note: "\u53EA\u4F20\u8981\u6539\u7684\u5B57\u6BB5" },
+  { command: "pdlab collection update coll_123 --project-ids proj_a,proj_c", note: "project-ids \u4F1A\u5168\u91CF\u66FF\u6362\u8BE5\u96C6\u5408\u5173\u8054\u7684\u9879\u76EE\u53CA\u987A\u5E8F" }
+];
+var DELETE_EXAMPLES2 = [{ command: "pdlab collection delete coll_123" }];
+function toProjectIds(value) {
+  if (value === void 0) return void 0;
+  return value.split(",").map((id) => id.trim()).filter(Boolean);
+}
+function withCollectionFlags(cmd) {
+  return withApiUrl(cmd).option("--title <title>", "\u96C6\u5408\u6807\u9898\uFF08\u5FC5\u586B\uFF0C1-200 \u5B57\uFF09").option("--description <description>", "\u96C6\u5408\u63CF\u8FF0\uFF08\u9009\u586B\uFF0C\u6700\u591A 20000 \u5B57\uFF09").option("--cover-image <url>", "\u5C01\u9762\u56FE http/https \u94FE\u63A5\u6216\u5E73\u53F0\u5185\u4E0A\u4F20\u56FE\u7247\u5730\u5740\uFF08\u9009\u586B\uFF09").option("--visibility <visibility>", `\u53EF\u89C1\u8303\u56F4\uFF1A${VISIBILITY_LIST}\uFF08\u9009\u586B\uFF0C\u9ED8\u8BA4 public\uFF09`).option("--project-ids <ids>", "\u9017\u53F7\u5206\u9694\u7684\u9879\u76EE id \u5217\u8868\uFF0C\u6309\u987A\u5E8F\u5173\u8054\uFF0C\u5168\u91CF\u66FF\u6362\uFF08\u9009\u586B\uFF09");
+}
+function registerCollectionCommand(program2) {
+  const collection = program2.command("collection").description("\u9879\u76EE\u96C6\u5408\uFF08PRD\u300C\u89E3\u51B3\u65B9\u6848\u4E91\u5C55\u5385\u300D\uFF09\u7684\u589E\u5220\u6539\u67E5");
+  attachMeta(
+    withApiUrl(collection.command("list").description("\u5217\u51FA\u96C6\u5408\uFF08public \u96C6\u5408\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528\uFF09")).action(
+      async (opts) => {
+        const data = await apiRequest("/api/collections", { token: optionalToken(), apiUrl: opts.apiUrl });
+        console.log(JSON.stringify(data, null, 2));
+      }
+    ),
+    { examples: LIST_EXAMPLES2 }
+  );
+  attachMeta(
+    withCollectionFlags(collection.command("create").description("\u521B\u5EFA\u96C6\u5408")).action(
+      async (opts) => {
+        const token = requireToken();
+        try {
+          const body = collectionCreateSchema.parse({
+            title: opts.title,
+            description: opts.description,
+            coverImage: opts.coverImage,
+            visibility: opts.visibility,
+            projectIds: toProjectIds(opts.projectIds)
+          });
+          const data = await apiRequest("/api/collections", { method: "POST", body, token, apiUrl: opts.apiUrl });
+          console.log(JSON.stringify(data, null, 2));
+        } catch (error) {
+          handleCommandError(error, CREATE_EXAMPLES2);
+        }
+      }
+    ),
+    { permission: "collection:manage\uFF081836\u53D1\u8D77\u4EBA\u89D2\u8272\uFF09", examples: CREATE_EXAMPLES2 }
+  );
+  attachMeta(
+    withCollectionFlags(collection.command("update <id>").description("\u66F4\u65B0\u96C6\u5408")).option("--sort-order <n>", "\u6392\u5E8F\u5E8F\u53F7\uFF0C\u6574\u6570\uFF0C\u8D8A\u5C0F\u8D8A\u9760\u524D\uFF08\u9009\u586B\uFF09").action(async (id, opts) => {
+      const token = requireToken();
+      try {
+        const body = collectionUpdateSchema.parse({
+          title: opts.title,
+          description: opts.description,
+          coverImage: opts.coverImage,
+          visibility: opts.visibility,
+          sortOrder: opts.sortOrder !== void 0 ? Number(opts.sortOrder) : void 0,
+          projectIds: toProjectIds(opts.projectIds)
+        });
+        const data = await apiRequest(`/api/collections/${id}`, {
+          method: "PATCH",
+          body,
+          token,
+          apiUrl: opts.apiUrl
+        });
+        console.log(JSON.stringify(data, null, 2));
+      } catch (error) {
+        handleCommandError(error, UPDATE_EXAMPLES2);
+      }
+    }),
+    { permission: "collection:manage\uFF081836\u53D1\u8D77\u4EBA\u89D2\u8272\uFF09", examples: UPDATE_EXAMPLES2 }
+  );
+  attachMeta(
+    withApiUrl(collection.command("delete <id>").description("\u5220\u9664\u96C6\u5408")).action(
+      async (id, opts) => {
+        const token = requireToken();
+        const data = await apiRequest(`/api/collections/${id}`, { method: "DELETE", token, apiUrl: opts.apiUrl });
+        console.log(JSON.stringify(data, null, 2));
+      }
+    ),
+    { permission: "collection:manage\uFF081836\u53D1\u8D77\u4EBA\u89D2\u8272\uFF09", examples: DELETE_EXAMPLES2 }
+  );
+}
+
+// src/commands/post.ts
+var CREATE_EXAMPLES3 = [
   {
     command: 'pdlab post create --title "\u94A0\u7535\u4EA7\u4E1A\u89C2\u5BDF" --body "..."',
     note: "\u53EA\u6709 title / body \u5FC5\u586B\uFF1A\u4E0D\u5E26 --project-id \u5C31\u662F\u72EC\u7ACB\u53D1\u5E03\uFF0C\u4E0D\u6302\u4EFB\u4F55\u5171\u5EFA\u9879\u76EE"
@@ -690,17 +802,17 @@ var CREATE_EXAMPLES2 = [
     note: "\u6302\u5230\u9879\u76EE\u4E0B\u65F6\uFF0C\u9700\u8981\u662F\u8BE5\u9879\u76EE\u53D1\u8D77\u4EBA\u6216\u5DF2\u901A\u8FC7\u5BA1\u6838\u7684\u53C2\u4E0E\u8005"
   }
 ];
-var UPDATE_EXAMPLES2 = [
+var UPDATE_EXAMPLES3 = [
   { command: 'pdlab post update post_123 --title "..." --body "..."', note: "title \u548C body \u90FD\u5FC5\u987B\u4F20" }
 ];
-var LIST_EXAMPLES2 = [
+var LIST_EXAMPLES3 = [
   { command: "pdlab post list --project-id proj_123", note: "\u53EA\u770B\u67D0\u4E2A\u9879\u76EE\u4E0B\u7684\u5185\u5BB9" },
   { command: "pdlab post list --project-id none", note: "\u53EA\u770B\u72EC\u7ACB\u53D1\u5E03\uFF08\u4E0D\u6302\u4EFB\u4F55\u9879\u76EE\uFF09\u7684\u5185\u5BB9" },
   { command: "pdlab post list --status pending", note: "\u67E5\u770B\u5F85\u5BA1\u6838\u5185\u5BB9\uFF0C\u9700\u8981 content:review \u6743\u9650\uFF0C\u5426\u5219 403" },
   { command: "pdlab post list --limit 10 --cursor <\u4E0A\u4E00\u9875\u8FD4\u56DE\u7684 nextCursor>", note: "\u7FFB\u9875\uFF1BnextCursor \u4E3A null \u8868\u793A\u6CA1\u6709\u4E0B\u4E00\u9875\u4E86" }
 ];
 var GET_EXAMPLES2 = [{ command: "pdlab post get post_123" }];
-var DELETE_EXAMPLES2 = [
+var DELETE_EXAMPLES3 = [
   { command: "pdlab post delete post_123", note: "\u4F5C\u8005\u672C\u4EBA\uFF0C\u6216\u6709\u5220\u9664\u4EFB\u610F\u5185\u5BB9\u7684\u6743\u9650" }
 ];
 var REVIEW_EXAMPLES = [
@@ -728,7 +840,7 @@ function registerPostCommand(program2) {
       });
       console.log(JSON.stringify(data, null, 2));
     }),
-    { examples: LIST_EXAMPLES2 }
+    { examples: LIST_EXAMPLES3 }
   );
   attachMeta(
     withApiUrl(post.command("get <id>").description("\u67E5\u770B\u5185\u5BB9\u8BE6\u60C5")).action(
@@ -752,10 +864,10 @@ function registerPostCommand(program2) {
         const data = await apiRequest("/api/posts", { method: "POST", body, token, apiUrl: opts.apiUrl });
         console.log(JSON.stringify(data, null, 2));
       } catch (error) {
-        handleCommandError(error, CREATE_EXAMPLES2);
+        handleCommandError(error, CREATE_EXAMPLES3);
       }
     }),
-    { permission: "content:create\uFF1B\u5E26 --project-id \u65F6\u8FD8\u9700\u662F\u8BE5\u9879\u76EE\u53D1\u8D77\u4EBA\u6216\u5DF2\u901A\u8FC7\u5BA1\u6838\u7684\u53C2\u4E0E\u8005", examples: CREATE_EXAMPLES2 }
+    { permission: "content:create\uFF1B\u5E26 --project-id \u65F6\u8FD8\u9700\u662F\u8BE5\u9879\u76EE\u53D1\u8D77\u4EBA\u6216\u5DF2\u901A\u8FC7\u5BA1\u6838\u7684\u53C2\u4E0E\u8005", examples: CREATE_EXAMPLES3 }
   );
   attachMeta(
     withApiUrl(post.command("update <id>").description("\u7F16\u8F91\u5185\u5BB9\uFF08\u4F5C\u8005\u672C\u4EBA\uFF0C\u6216\u6709\u7F16\u8F91\u4EFB\u610F\u5185\u5BB9\u7684\u6743\u9650\uFF09")).option("--title <title>", "\u5185\u5BB9\u6807\u9898\uFF08\u5FC5\u586B\uFF09").option("--body <body>", "\u5185\u5BB9\u6B63\u6587\uFF08\u5FC5\u586B\uFF09").option("--media-links <urls>", "\u9017\u53F7\u5206\u9694\u7684\u56FE\u7247/\u89C6\u9891/\u5916\u94FE\u5730\u5740\uFF08\u9009\u586B\uFF0C\u6700\u591A 20 \u6761\uFF09").action(async (id, opts) => {
@@ -769,10 +881,10 @@ function registerPostCommand(program2) {
         const data = await apiRequest(`/api/posts/${id}`, { method: "PATCH", body, token, apiUrl: opts.apiUrl });
         console.log(JSON.stringify(data, null, 2));
       } catch (error) {
-        handleCommandError(error, UPDATE_EXAMPLES2);
+        handleCommandError(error, UPDATE_EXAMPLES3);
       }
     }),
-    { examples: UPDATE_EXAMPLES2 }
+    { examples: UPDATE_EXAMPLES3 }
   );
   attachMeta(
     withApiUrl(post.command("delete <id>").description("\u5220\u9664\u5185\u5BB9\uFF08\u4F5C\u8005\u672C\u4EBA\uFF0C\u6216\u6709\u5220\u9664\u4EFB\u610F\u5185\u5BB9\u7684\u6743\u9650\uFF09")).action(
@@ -782,7 +894,7 @@ function registerPostCommand(program2) {
         console.log(JSON.stringify(data, null, 2));
       }
     ),
-    { examples: DELETE_EXAMPLES2 }
+    { examples: DELETE_EXAMPLES3 }
   );
   attachMeta(
     withApiUrl(post.command("review <id>").description("\u5BA1\u6838\u4E00\u6761\u5F85\u5BA1\u5185\u5BB9\uFF08approve / reject\uFF09")).requiredOption("--action <action>", "approve | reject").option("--comment <text>", "\u5BA1\u6838\u610F\u89C1\uFF0C\u6700\u591A 500 \u5B57\uFF08reject \u65F6\u5FC5\u586B\uFF09").action(async (id, opts) => {
@@ -819,17 +931,17 @@ var DIM_DELETE_EXAMPLES = [
     note: "\u5185\u7F6E\u7EF4\u5EA6\uFF08domain/attribute/commercial\uFF09\u4E0D\u53EF\u5220\uFF1B\u7EF4\u5EA6\u4E0B\u8FD8\u6709\u6807\u7B7E\u65F6\u4F1A 409"
   }
 ];
-var LIST_EXAMPLES3 = [{ command: "pdlab taxonomy list", note: "\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528" }];
-var CREATE_EXAMPLES3 = [
+var LIST_EXAMPLES4 = [{ command: "pdlab taxonomy list", note: "\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528" }];
+var CREATE_EXAMPLES4 = [
   {
     command: 'pdlab taxonomy create --dimension domain --label "\u94A0\u7535\u56FA\u6001\u5316" --weight 0.2',
     note: "dimension \u5FC5\u987B\u662F\u5DF2\u5B58\u5728\u7684\u7EF4\u5EA6 key\uFF1Bweight \u662F\u53D1\u8D77\u9879\u76EE\u65F6\u9884\u586B\u7ED9\u53D1\u8D77\u4EBA\u7684\u5EFA\u8BAE\u503C\uFF0C\u4E0D\u662F\u6700\u7EC8\u53C2\u4E0E\u8BA1\u7B97\u7684\u90A3\u4EFD"
   }
 ];
-var UPDATE_EXAMPLES3 = [
+var UPDATE_EXAMPLES4 = [
   { command: "pdlab taxonomy update tax_123 --weight 0.3", note: "\u53EA\u4F20\u8981\u6539\u7684\u5B57\u6BB5" }
 ];
-var DELETE_EXAMPLES3 = [{ command: "pdlab taxonomy delete tax_123" }];
+var DELETE_EXAMPLES4 = [{ command: "pdlab taxonomy delete tax_123" }];
 function toDimensionBody(opts) {
   const body = {};
   if (opts.key !== void 0) body.key = opts.key;
@@ -916,7 +1028,7 @@ function registerTaxonomyCommand(program2) {
         console.log(JSON.stringify(data, null, 2));
       }
     ),
-    { examples: LIST_EXAMPLES3 }
+    { examples: LIST_EXAMPLES4 }
   );
   attachMeta(
     withApiUrl(taxonomy.command("create").description("\u65B0\u5EFA\u5206\u7C7B\u6807\u7B7E")).option("--dimension <key>", "\u6240\u5C5E\u7EF4\u5EA6\u7684 key\uFF08\u5FC5\u586B\uFF0C\u987B\u662F\u5DF2\u5B58\u5728\u7684\u7EF4\u5EA6\uFF09").option("--label <label>", "\u6807\u7B7E\u503C\uFF08\u5FC5\u586B\uFF09").option("--weight <n>", "\u5EFA\u8BAE\u6743\u91CD 0~1\uFF08\u9009\u586B\uFF0C\u9ED8\u8BA4 0\uFF09").option("--sort-order <n>", "\u5C55\u793A\u6392\u5E8F\uFF0C\u6574\u6570 0-999\uFF08\u9009\u586B\uFF09").option("--description <text>", "\u6807\u7B7E\u8BF4\u660E\uFF08\u9009\u586B\uFF09").action(async (opts) => {
@@ -926,10 +1038,10 @@ function registerTaxonomyCommand(program2) {
         const data = await apiRequest("/api/taxonomies", { method: "POST", body, token, apiUrl: opts.apiUrl });
         console.log(JSON.stringify(data, null, 2));
       } catch (error) {
-        handleCommandError(error, CREATE_EXAMPLES3);
+        handleCommandError(error, CREATE_EXAMPLES4);
       }
     }),
-    { permission: PERMISSION, examples: CREATE_EXAMPLES3 }
+    { permission: PERMISSION, examples: CREATE_EXAMPLES4 }
   );
   attachMeta(
     withApiUrl(taxonomy.command("update <id>").description("\u66F4\u65B0\u5206\u7C7B\u6807\u7B7E")).option("--dimension <key>", "\u6240\u5C5E\u7EF4\u5EA6\u7684 key").option("--label <label>", "\u6807\u7B7E\u503C").option("--weight <n>", "\u5EFA\u8BAE\u6743\u91CD 0~1").option("--sort-order <n>", "\u5C55\u793A\u6392\u5E8F").option("--description <text>", "\u6807\u7B7E\u8BF4\u660E").action(async (id, opts) => {
@@ -939,10 +1051,10 @@ function registerTaxonomyCommand(program2) {
         const data = await apiRequest(`/api/taxonomies/${id}`, { method: "PATCH", body, token, apiUrl: opts.apiUrl });
         console.log(JSON.stringify(data, null, 2));
       } catch (error) {
-        handleCommandError(error, UPDATE_EXAMPLES3);
+        handleCommandError(error, UPDATE_EXAMPLES4);
       }
     }),
-    { permission: PERMISSION, examples: UPDATE_EXAMPLES3 }
+    { permission: PERMISSION, examples: UPDATE_EXAMPLES4 }
   );
   attachMeta(
     withApiUrl(taxonomy.command("delete <id>").description("\u5220\u9664\u5206\u7C7B\u6807\u7B7E")).action(
@@ -952,7 +1064,7 @@ function registerTaxonomyCommand(program2) {
         console.log(JSON.stringify(data, null, 2));
       }
     ),
-    { permission: PERMISSION, examples: DELETE_EXAMPLES3 }
+    { permission: PERMISSION, examples: DELETE_EXAMPLES4 }
   );
 }
 
@@ -975,6 +1087,9 @@ function exitCodeTable() {
   }
   return table;
 }
+function isInternalCommand(command) {
+  return command.name().startsWith("__");
+}
 function serialize(command) {
   const meta = getMeta(command);
   return {
@@ -984,7 +1099,7 @@ function serialize(command) {
     arguments: command.registeredArguments.map((a) => ({ name: a.name(), required: a.required })),
     options: command.options.map((o) => ({ flags: o.flags, description: o.description, required: o.mandatory })),
     examples: meta.examples ?? [],
-    subcommands: command.commands.map(serialize)
+    subcommands: command.commands.filter((c) => !isInternalCommand(c)).map(serialize)
   };
 }
 function registerSchemaCommand(program2) {
@@ -993,7 +1108,7 @@ function registerSchemaCommand(program2) {
       JSON.stringify(
         {
           exitCodes: exitCodeTable(),
-          commands: program2.commands.map(serialize)
+          commands: program2.commands.filter((c) => !isInternalCommand(c)).map(serialize)
         },
         null,
         2
@@ -1002,8 +1117,96 @@ function registerSchemaCommand(program2) {
   });
 }
 
+// src/update-check.ts
+var import_fs2 = require("fs");
+var import_child_process = require("child_process");
+var import_path2 = require("path");
+var CACHE_FILE = (0, import_path2.join)(CONFIG_DIR, "update-check.json");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 3e3;
+function readUpdateCache() {
+  if (!(0, import_fs2.existsSync)(CACHE_FILE)) return { lastCheckedAt: 0 };
+  try {
+    return JSON.parse((0, import_fs2.readFileSync)(CACHE_FILE, "utf8"));
+  } catch {
+    return { lastCheckedAt: 0 };
+  }
+}
+function writeUpdateCache(cache) {
+  if (!(0, import_fs2.existsSync)(CONFIG_DIR)) (0, import_fs2.mkdirSync)(CONFIG_DIR, { recursive: true, mode: 448 });
+  (0, import_fs2.writeFileSync)(CACHE_FILE, JSON.stringify(cache, null, 2));
+}
+function parseVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isNewerVersion(candidate, current) {
+  const a = parseVersion(candidate);
+  const b = parseVersion(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    if (a[i] !== b[i]) return a[i] > b[i];
+  }
+  return false;
+}
+async function fetchLatestVersion(packageName) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(`https://registry.npmjs.org/-/package/${packageName}/dist-tags`, {
+      signal: controller.signal
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.latest ?? null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function refreshUpdateCache(packageName) {
+  const latestVersion = await fetchLatestVersion(packageName);
+  const previous = readUpdateCache();
+  writeUpdateCache({
+    lastCheckedAt: Date.now(),
+    latestVersion: latestVersion ?? previous.latestVersion
+  });
+}
+function spawnBackgroundRefresh(packageName) {
+  try {
+    const entry = process.argv[1];
+    if (!entry) return;
+    const child = (0, import_child_process.spawn)(process.execPath, [entry, "__update-check-worker", packageName], {
+      detached: true,
+      stdio: "ignore"
+    });
+    child.unref();
+  } catch {
+  }
+}
+function notifyIfUpdateAvailable(currentVersion, packageName) {
+  if (process.env.PDLAB_NO_UPDATE_CHECK) return;
+  try {
+    const cache = readUpdateCache();
+    if (cache.latestVersion && isNewerVersion(cache.latestVersion, currentVersion)) {
+      console.error(
+        `
+\u203B ${packageName} \u6709\u65B0\u7248\u672C\u53EF\u7528\uFF1A${currentVersion} \u2192 ${cache.latestVersion}
+  \u8FD0\u884C npm install -g ${packageName}@latest \u5347\u7EA7\uFF08\u53EF\u7528 PDLAB_NO_UPDATE_CHECK=1 \u5173\u95ED\u6B64\u63D0\u793A\uFF09
+`
+      );
+    }
+    if (Date.now() - cache.lastCheckedAt > CHECK_INTERVAL_MS) {
+      spawnBackgroundRefresh(packageName);
+    }
+  } catch {
+  }
+}
+
 // src/index.ts
-var pkg = JSON.parse((0, import_fs2.readFileSync)((0, import_path2.join)(__dirname, "../package.json"), "utf8"));
+var pkg = JSON.parse((0, import_fs3.readFileSync)((0, import_path3.join)(__dirname, "../package.json"), "utf8"));
 var program = new import_commander2.Command();
 program.name("pdlab").description("1836 \u5F00\u6E90\u5171\u5EFA\u5E73\u53F0\u547D\u4EE4\u884C\u5DE5\u5177\u2014\u2014\u662F\u73B0\u6709 REST API \u7684\u8584\u5C01\u88C5\u3002\u7ED9 agent/\u811A\u672C\u7528\uFF1Apdlab schema \u4E00\u6B21\u6027\u5217\u51FA\u5168\u90E8\u547D\u4EE4\u3001\u53C2\u6570\u4E0E\u9000\u51FA\u7801\u542B\u4E49\u3002").version(pkg.version);
 program.exitOverride();
@@ -1015,9 +1218,15 @@ registerLogoutCommand(program);
 registerWhoamiCommand(program);
 registerConfigCommand(program);
 registerProjectCommand(program);
+registerCollectionCommand(program);
 registerPostCommand(program);
 registerTaxonomyCommand(program);
 registerSchemaCommand(program);
+program.command("__update-check-worker <packageName>", { hidden: true }).action(async (packageName) => {
+  await refreshUpdateCache(packageName);
+  process.exit(0);
+});
+notifyIfUpdateAvailable(pkg.version, "pdlab-cli");
 program.parseAsync(process.argv).catch((error) => {
   if (error instanceof import_commander2.CommanderError && error.exitCode === 0) {
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdlab-cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "private": false,
   "description": "1836 开源共建平台（problem-driven-lab）的命令行工具：项目、内容的增删改查，浏览器授权登录",
   "keywords": [