pdlab-cli 0.2.2 → 0.4.0

package/README.md

@@ -50,8 +50,10 @@ pdlab schema          # 一次性 JSON 输出全部命令、参数、权限要
 | `pdlab project join \| leave <id>` | 报名共建 / 撤回申请或退出共建 |
 | `pdlab project member review \| set-role \| remove <projectId> <userId>` | 审核报名、设置协作者角色、移除参与者（仅项目发起人本人） |
 | `pdlab project revenue <id>` | 查看项目的积分分成明细（只读） |
-| `pdlab post list \| get \| create \| update \| delete` | 内容的增删改查 |
+| `pdlab post list \| get \| create \| update \| delete` | 内容的增删改查（`--project-id` 选填，不填即独立发布，不挂任何项目） |
 | `pdlab post review <id> --action approve\|reject` | 审核一条待审内容 |
+| `pdlab taxonomy list \| create \| update \| delete` | 分类标签的增删改查（列表公开只读，写操作需 `taxonomy:manage`） |
+| `pdlab taxonomy dimension list \| create \| update \| delete <key>` | 分类维度的增删改查（内置维度不可删） |
 
 任何命令加 `--help` 看具体参数——示例已经直接打在 `--help` 末尾，不用等一次报错才能看到。
 
@@ -88,6 +90,17 @@ pdlab post list --project-id <项目 id>
 # 审核待审内容（需要 content:review 权限）
 pdlab post review post_123 --action approve
 pdlab post review post_123 --action reject --comment "缺少数据来源，请补充引用"
+
+# 独立发布内容（不挂任何项目），任何已生效账号都能发；非免审角色发出去要等发起人审
+pdlab post create --title "钠电产业观察" --body "……"
+
+# 分类维度与标签管理（需要 taxonomy:manage 权限，即「1836发起人」角色）
+pdlab taxonomy dimension list                                          # 公开只读
+pdlab taxonomy dimension create --key region --label "地区" --sort-order 3
+pdlab taxonomy create --dimension domain --label "钠电固态化" --weight 0.2
+pdlab taxonomy update tax_123 --weight 0.3
+pdlab taxonomy delete tax_123
+pdlab taxonomy dimension delete region   # 内置维度（domain/attribute/commercial）不可删
 ```
 
 ### 分页
@@ -136,6 +149,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
@@ -297,27 +297,42 @@ function isSafeHttpUrl(raw) {
   return ALLOWED_PROTOCOLS.has(url.protocol);
 }
 var safeHttpUrl = import_zod.z.string().trim().max(2048, "\u94FE\u63A5\u8FC7\u957F").refine(isSafeHttpUrl, "\u53EA\u652F\u6301 http/https \u5F00\u5934\u7684\u94FE\u63A5");
+var INTERNAL_IMAGE_PATH = /^\/api\/images\/[a-z0-9]{1,64}$/;
+function isInternalImagePath(raw) {
+  return INTERNAL_IMAGE_PATH.test(raw.trim());
+}
+function isSafeImageSrc(raw) {
+  return isInternalImagePath(raw) || isSafeHttpUrl(raw);
+}
+var safeImageUrl = import_zod.z.string().trim().max(2048, "\u94FE\u63A5\u8FC7\u957F").refine(isSafeImageSrc, "\u53EA\u652F\u6301 http/https \u94FE\u63A5\u6216\u5E73\u53F0\u5185\u4E0A\u4F20\u7684\u56FE\u7247");
 
 // ../shared-schemas/src/projects.ts
 var import_zod2 = require("zod");
+var taxonomySelectionSchema = import_zod2.z.object({
+  taxonomyId: import_zod2.z.string().min(1).describe("\u5206\u7C7B\u6807\u7B7E id"),
+  weight: import_zod2.z.number().min(0).max(1).describe("\u8BE5\u6807\u7B7E\u5728\u672C\u9879\u76EE\u91CC\u7684\u6743\u91CD 0~1")
+});
 var PROJECT_STATUS_VALUES = ["planning", "active", "review", "completed"];
 var projectCreateSchema = import_zod2.z.object({
   title: import_zod2.z.string().trim().min(1, "\u9879\u76EE\u6807\u9898\u4E0D\u80FD\u4E3A\u7A7A").max(200).describe("\u9879\u76EE\u6807\u9898"),
   description: import_zod2.z.string().max(2e4).optional().describe("\u9879\u76EE\u63CF\u8FF0"),
-  coverImage: safeHttpUrl.optional().describe("\u5C01\u9762\u56FE http/https \u94FE\u63A5"),
-  commercialType: import_zod2.z.string().max(100).optional().describe("\u5546\u4E1A\u5C5E\u6027"),
+  coverImage: safeImageUrl.optional().describe("\u5C01\u9762\u56FE\u94FE\u63A5\u6216\u4E0A\u4F20\u56FE\u7247\u5730\u5740"),
+  commercialType: import_zod2.z.string().max(100).optional().describe("\u5546\u4E1A\u5408\u4F5C\u72B6\u6001\uFF0C\u5982\u300C\u4E0E\u67D0IDC\u5382\u5546\u63A5\u6D3D\u4E2D\u300D"),
   status: import_zod2.z.enum(PROJECT_STATUS_VALUES).optional().describe("\u9879\u76EE\u72B6\u6001\uFF1Aplanning/active/review/completed"),
   progress: import_zod2.z.number().int().min(0).max(100).optional().describe("\u9879\u76EE\u8FDB\u5EA6\u767E\u5206\u6BD4 0-100"),
-  taxonomyIds: import_zod2.z.array(import_zod2.z.string().min(1)).max(50).optional().default([]).describe("\u5206\u7C7B\u6807\u7B7E id \u5217\u8868")
+  taxonomies: import_zod2.z.array(taxonomySelectionSchema).max(50).optional().describe("\u5206\u7C7B\u6807\u7B7E\u53CA\u5176\u5728\u672C\u9879\u76EE\u91CC\u7684\u6743\u91CD\uFF0C\u6BCF\u4E2A\u7EF4\u5EA6\u6700\u591A\u4E00\u4E2A\u6807\u7B7E"),
+  // 兼容 pdlab CLI 的旧参数：只给 id、不给权重时，服务端按标签的全局建议权重（Taxonomy.weight）填充
+  taxonomyIds: import_zod2.z.array(import_zod2.z.string().min(1)).max(50).optional().default([]).describe("\u5206\u7C7B\u6807\u7B7E id \u5217\u8868\uFF08\u65E7\u53C2\u6570\uFF0C\u6743\u91CD\u53D6\u6807\u7B7E\u9ED8\u8BA4\u503C\uFF09")
 });
 var projectUpdateSchema = import_zod2.z.object({
   title: import_zod2.z.string().trim().min(1, "\u9879\u76EE\u6807\u9898\u4E0D\u80FD\u4E3A\u7A7A").max(200).optional().describe("\u9879\u76EE\u6807\u9898"),
   description: import_zod2.z.string().max(2e4).nullable().optional().describe("\u9879\u76EE\u63CF\u8FF0"),
-  coverImage: safeHttpUrl.nullable().optional().describe("\u5C01\u9762\u56FE http/https \u94FE\u63A5"),
-  commercialType: import_zod2.z.string().max(100).nullable().optional().describe("\u5546\u4E1A\u5C5E\u6027"),
+  coverImage: safeImageUrl.nullable().optional().describe("\u5C01\u9762\u56FE\u94FE\u63A5\u6216\u4E0A\u4F20\u56FE\u7247\u5730\u5740"),
+  commercialType: import_zod2.z.string().max(100).nullable().optional().describe("\u5546\u4E1A\u5408\u4F5C\u72B6\u6001"),
   progress: import_zod2.z.number().int().min(0).max(100).optional().describe("\u9879\u76EE\u8FDB\u5EA6\u767E\u5206\u6BD4 0-100"),
   status: import_zod2.z.enum(PROJECT_STATUS_VALUES).optional().describe("\u9879\u76EE\u72B6\u6001\uFF1Aplanning/active/review/completed"),
-  taxonomyIds: import_zod2.z.array(import_zod2.z.string().min(1)).max(50).optional().describe("\u5206\u7C7B\u6807\u7B7E id \u5217\u8868\uFF08\u5168\u91CF\u66FF\u6362\uFF09")
+  taxonomies: import_zod2.z.array(taxonomySelectionSchema).max(50).optional().describe("\u5206\u7C7B\u6807\u7B7E\u53CA\u5176\u6743\u91CD\uFF08\u5168\u91CF\u66FF\u6362\uFF09"),
+  taxonomyIds: import_zod2.z.array(import_zod2.z.string().min(1)).max(50).optional().describe("\u5206\u7C7B\u6807\u7B7E id \u5217\u8868\uFF08\u65E7\u53C2\u6570\uFF0C\u5168\u91CF\u66FF\u6362\uFF0C\u6743\u91CD\u53D6\u6807\u7B7E\u9ED8\u8BA4\u503C\uFF09")
 }).refine((v) => Object.keys(v).length > 0, "\u6CA1\u6709\u9700\u8981\u66F4\u65B0\u7684\u5B57\u6BB5");
 
 // ../shared-schemas/src/posts.ts
@@ -325,22 +340,52 @@ var import_zod3 = require("zod");
 var postCreateSchema = import_zod3.z.object({
   title: import_zod3.z.string().min(1).describe("\u5185\u5BB9\u6807\u9898"),
   body: import_zod3.z.string().min(1).describe("\u5185\u5BB9\u6B63\u6587"),
-  projectId: import_zod3.z.string().describe("\u6240\u5C5E\u9879\u76EE id"),
-  mediaLinks: import_zod3.z.array(safeHttpUrl).max(20, "\u5A92\u4F53\u94FE\u63A5\u6700\u591A 20 \u6761").optional().default([]).describe("\u5A92\u4F53\u94FE\u63A5\u5217\u8868")
+  // V3.1：可以不挂项目独立发布。挂项目时仍然要求发布者是该项目的发起人或已通过审核的参与者。
+  projectId: import_zod3.z.string().min(1).nullish().describe("\u6240\u5C5E\u9879\u76EE id\uFF0C\u4E0D\u586B\u8868\u793A\u72EC\u7ACB\u53D1\u5E03"),
+  mediaLinks: import_zod3.z.array(safeImageUrl).max(20, "\u5A92\u4F53\u4E0E\u56FE\u7247\u6700\u591A 20 \u6761").optional().default([]).describe("\u4E0A\u4F20\u7684\u56FE\u7247\u5730\u5740\u3001\u89C6\u9891\u94FE\u63A5\u4E0E\u5916\u90E8\u94FE\u63A5")
 });
 var postUpdateSchema = import_zod3.z.object({
   title: import_zod3.z.string().trim().min(1, "\u6807\u9898\u4E0D\u80FD\u4E3A\u7A7A").max(200).describe("\u5185\u5BB9\u6807\u9898"),
   body: import_zod3.z.string().trim().min(1, "\u6B63\u6587\u4E0D\u80FD\u4E3A\u7A7A").max(5e4).describe("\u5185\u5BB9\u6B63\u6587"),
-  mediaLinks: import_zod3.z.array(safeHttpUrl).max(20).optional().default([]).describe("\u5A92\u4F53\u94FE\u63A5\u5217\u8868")
+  mediaLinks: import_zod3.z.array(safeImageUrl).max(20).optional().default([]).describe("\u4E0A\u4F20\u7684\u56FE\u7247\u5730\u5740\u3001\u89C6\u9891\u94FE\u63A5\u4E0E\u5916\u90E8\u94FE\u63A5")
 });
 var postReviewSchema = import_zod3.z.object({
   action: import_zod3.z.enum(["approve", "reject"]).describe("\u5BA1\u6838\u7ED3\u679C\uFF1Aapprove/reject"),
   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
+var import_zod4 = require("zod");
+var taxonomyDimensionCreateSchema = import_zod4.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")
+});
+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 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 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")
+});
+
 // src/errors.ts
 var import_commander = require("commander");
-var import_zod4 = require("zod");
+var import_zod5 = require("zod");
 var EXIT_CODES = {
   ok: 0,
   unhandled: 1,
@@ -373,7 +418,7 @@ function exampleHint(examples) {
 }
 function handleCommandError(error, examples = []) {
   let structured;
-  if (error instanceof import_zod4.ZodError) {
+  if (error instanceof import_zod5.ZodError) {
     structured = {
       error: "\u53C2\u6570\u6821\u9A8C\u5931\u8D25",
       code: "validation",
@@ -636,9 +681,13 @@ function registerProjectCommand(program2) {
 
 // src/commands/post.ts
 var CREATE_EXAMPLES2 = [
+  {
+    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"
+  },
   {
     command: 'pdlab post create --title "\u7B2C\u4E00\u5468\u8FDB\u5C55" --body "..." --project-id proj_123 --media-links https://example.com/a.png',
-    note: "title / body / project-id \u5FC5\u586B\uFF1B\u9700\u8981\u662F\u9879\u76EE\u53D1\u8D77\u4EBA\u6216\u5DF2\u62A5\u540D\u5171\u5EFA\u8BE5\u9879\u76EE"
+    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 = [
@@ -646,6 +695,7 @@ var UPDATE_EXAMPLES2 = [
 ];
 var LIST_EXAMPLES2 = [
   { 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" }
 ];
@@ -670,7 +720,7 @@ function toMediaLinks(value) {
 function registerPostCommand(program2) {
   const post = program2.command("post").description("\u5185\u5BB9\uFF08\u5E16\u5B50\uFF09\u7684\u589E\u5220\u6539\u67E5\u4E0E\u5BA1\u6838");
   attachMeta(
-    withApiUrl(post.command("list").description("\u5217\u51FA\u5185\u5BB9\uFF08approved \u5185\u5BB9\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528\uFF09")).option("--project-id <id>", "\u6309\u9879\u76EE\u7B5B\u9009").option("--status <status>", "pending | approved | rejected\uFF08\u67E5\u770B\u975E approved \u9700\u8981\u5BA1\u6838\u6743\u9650\uFF09").option("--limit <n>", "\u5355\u9875\u6570\u91CF\uFF0C\u9ED8\u8BA4 30\uFF0C\u4E0A\u9650 100").option("--cursor <token>", "\u7FFB\u9875\u6E38\u6807\uFF0C\u53D6\u4E0A\u4E00\u9875\u54CD\u5E94\u91CC\u7684 nextCursor").action(async (opts) => {
+    withApiUrl(post.command("list").description("\u5217\u51FA\u5185\u5BB9\uFF08approved \u5185\u5BB9\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528\uFF09")).option("--project-id <id>", "\u6309\u9879\u76EE\u7B5B\u9009\uFF1B\u4F20 none \u53EA\u770B\u72EC\u7ACB\u53D1\u5E03\uFF08\u4E0D\u6302\u9879\u76EE\uFF09\u7684\u5185\u5BB9").option("--status <status>", "pending | approved | rejected\uFF08\u67E5\u770B\u975E approved \u9700\u8981\u5BA1\u6838\u6743\u9650\uFF09").option("--limit <n>", "\u5355\u9875\u6570\u91CF\uFF0C\u9ED8\u8BA4 30\uFF0C\u4E0A\u9650 100").option("--cursor <token>", "\u7FFB\u9875\u6E38\u6807\uFF0C\u53D6\u4E0A\u4E00\u9875\u54CD\u5E94\u91CC\u7684 nextCursor").action(async (opts) => {
       const data = await apiRequest("/api/posts", {
         query: { projectId: opts.projectId, status: opts.status, limit: opts.limit, cursor: opts.cursor },
         token: optionalToken(),
@@ -690,7 +740,7 @@ function registerPostCommand(program2) {
     { examples: GET_EXAMPLES2 }
   );
   attachMeta(
-    withApiUrl(post.command("create").description("\u53D1\u5E03\u5185\u5BB9")).option("--title <title>", "\u5185\u5BB9\u6807\u9898\uFF08\u5FC5\u586B\uFF09").option("--body <body>", "\u5185\u5BB9\u6B63\u6587\uFF08\u5FC5\u586B\uFF09").option("--project-id <id>", "\u6240\u5C5E\u9879\u76EE id\uFF08\u5FC5\u586B\uFF09").option("--media-links <urls>", "\u9017\u53F7\u5206\u9694\u7684\u5A92\u4F53\u94FE\u63A5\uFF08\u9009\u586B\uFF0C\u6700\u591A 20 \u6761\uFF0Chttp/https\uFF09").action(async (opts) => {
+    withApiUrl(post.command("create").description("\u53D1\u5E03\u5185\u5BB9")).option("--title <title>", "\u5185\u5BB9\u6807\u9898\uFF08\u5FC5\u586B\uFF09").option("--body <body>", "\u5185\u5BB9\u6B63\u6587\uFF08\u5FC5\u586B\uFF09").option("--project-id <id>", "\u6240\u5C5E\u9879\u76EE id\uFF08\u9009\u586B\uFF0C\u4E0D\u586B\u5373\u72EC\u7ACB\u53D1\u5E03\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 (opts) => {
       const token = requireToken();
       try {
         const body = postCreateSchema.parse({
@@ -705,10 +755,10 @@ function registerPostCommand(program2) {
         handleCommandError(error, CREATE_EXAMPLES2);
       }
     }),
-    { permission: "content:create\uFF0C\u4E14\u662F\u9879\u76EE\u53D1\u8D77\u4EBA\u6216\u5DF2\u62A5\u540D\u5171\u5EFA\u8BE5\u9879\u76EE", 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_EXAMPLES2 }
   );
   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\u5A92\u4F53\u94FE\u63A5\uFF08\u9009\u586B\uFF0C\u6700\u591A 20 \u6761\uFF0Chttp/https\uFF09").action(async (id, opts) => {
+    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) => {
       const token = requireToken();
       try {
         const body = postUpdateSchema.parse({
@@ -749,6 +799,163 @@ function registerPostCommand(program2) {
   );
 }
 
+// src/commands/taxonomy.ts
+var PERMISSION = "taxonomy:manage\uFF08\u4EC5\u300C1836\u53D1\u8D77\u4EBA\u300D\u89D2\u8272\uFF09";
+var DIM_LIST_EXAMPLES = [
+  { command: "pdlab taxonomy dimension list", note: "\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528" }
+];
+var DIM_CREATE_EXAMPLES = [
+  {
+    command: 'pdlab taxonomy dimension create --key region --label "\u5730\u533A" --sort-order 3',
+    note: "key \u53EA\u80FD\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF\u4E14\u4EE5\u5B57\u6BCD\u5F00\u5934\uFF0C\u5EFA\u597D\u4E4B\u540E\u4E0D\u80FD\u6539"
+  }
+];
+var DIM_UPDATE_EXAMPLES = [
+  { command: 'pdlab taxonomy dimension update domain --label "\u9886\u57DF\uFF08\u66F4\u65B0\uFF09"', note: "key \u4E0D\u53EF\u6539\uFF0C\u53EA\u80FD\u6539\u5C55\u793A\u5C5E\u6027" }
+];
+var DIM_DELETE_EXAMPLES = [
+  {
+    command: "pdlab taxonomy dimension delete region",
+    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 = [
+  {
+    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 = [
+  { 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" }];
+function toDimensionBody(opts) {
+  const body = {};
+  if (opts.key !== void 0) body.key = opts.key;
+  if (opts.label !== void 0) body.label = opts.label;
+  if (opts.description !== void 0) body.description = opts.description;
+  if (opts.sortOrder !== void 0) body.sortOrder = Number(opts.sortOrder);
+  return body;
+}
+function toTaxonomyBody(opts) {
+  const body = {};
+  if (opts.dimension !== void 0) body.dimension = opts.dimension;
+  if (opts.label !== void 0) body.label = opts.label;
+  if (opts.weight !== void 0) body.weight = Number(opts.weight);
+  if (opts.sortOrder !== void 0) body.sortOrder = Number(opts.sortOrder);
+  if (opts.description !== void 0) body.description = opts.description;
+  return body;
+}
+function registerTaxonomyCommand(program2) {
+  const taxonomy = program2.command("taxonomy").description("\u5206\u7C7B\u7EF4\u5EA6\u4E0E\u5206\u7C7B\u6807\u7B7E\u7684\u589E\u5220\u6539\u67E5\uFF08PRD 4.2.4\uFF09");
+  const dimension = taxonomy.command("dimension").description("\u5206\u7C7B\u7EF4\u5EA6\uFF08\u9886\u57DF/\u5C5E\u6027/\u5546\u4E1A\u2026\u2026\uFF09\u7684\u589E\u5220\u6539\u67E5");
+  attachMeta(
+    withApiUrl(dimension.command("list").description("\u5217\u51FA\u5168\u90E8\u5206\u7C7B\u7EF4\u5EA6\uFF08\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528\uFF09")).action(
+      async (opts) => {
+        const data = await apiRequest("/api/taxonomy-dimensions", { token: optionalToken(), apiUrl: opts.apiUrl });
+        console.log(JSON.stringify(data, null, 2));
+      }
+    ),
+    { examples: DIM_LIST_EXAMPLES }
+  );
+  attachMeta(
+    withApiUrl(dimension.command("create").description("\u65B0\u5EFA\u5206\u7C7B\u7EF4\u5EA6")).option("--key <key>", "\u7EF4\u5EA6\u6807\u8BC6\uFF08\u5FC5\u586B\uFF0C\u5C0F\u5199\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF\uFF0C\u4EE5\u5B57\u6BCD\u5F00\u5934\uFF0C\u521B\u5EFA\u540E\u4E0D\u53EF\u6539\uFF09").option("--label <label>", "\u7EF4\u5EA6\u4E2D\u6587\u540D\uFF08\u5FC5\u586B\uFF09").option("--description <text>", "\u7EF4\u5EA6\u8BF4\u660E\uFF08\u9009\u586B\uFF09").option("--sort-order <n>", "\u5C55\u793A\u6392\u5E8F\uFF0C\u6574\u6570 0-999\uFF08\u9009\u586B\uFF09").action(async (opts) => {
+      const token = requireToken();
+      try {
+        const body = taxonomyDimensionCreateSchema.parse(toDimensionBody(opts));
+        const data = await apiRequest("/api/taxonomy-dimensions", {
+          method: "POST",
+          body,
+          token,
+          apiUrl: opts.apiUrl
+        });
+        console.log(JSON.stringify(data, null, 2));
+      } catch (error) {
+        handleCommandError(error, DIM_CREATE_EXAMPLES);
+      }
+    }),
+    { permission: PERMISSION, examples: DIM_CREATE_EXAMPLES }
+  );
+  attachMeta(
+    withApiUrl(dimension.command("update <key>").description("\u66F4\u65B0\u5206\u7C7B\u7EF4\u5EA6\u7684\u5C55\u793A\u5C5E\u6027\uFF08key \u672C\u8EAB\u4E0D\u53EF\u6539\uFF09")).option("--label <label>", "\u7EF4\u5EA6\u4E2D\u6587\u540D").option("--description <text>", "\u7EF4\u5EA6\u8BF4\u660E").option("--sort-order <n>", "\u5C55\u793A\u6392\u5E8F\uFF0C\u6574\u6570 0-999").action(async (key, opts) => {
+      const token = requireToken();
+      try {
+        const body = taxonomyDimensionUpdateSchema.parse(toDimensionBody(opts));
+        const data = await apiRequest(`/api/taxonomy-dimensions/${key}`, {
+          method: "PATCH",
+          body,
+          token,
+          apiUrl: opts.apiUrl
+        });
+        console.log(JSON.stringify(data, null, 2));
+      } catch (error) {
+        handleCommandError(error, DIM_UPDATE_EXAMPLES);
+      }
+    }),
+    { permission: PERMISSION, examples: DIM_UPDATE_EXAMPLES }
+  );
+  attachMeta(
+    withApiUrl(
+      dimension.command("delete <key>").description("\u5220\u9664\u5206\u7C7B\u7EF4\u5EA6\uFF08\u5185\u7F6E\u7EF4\u5EA6\u4E0D\u53EF\u5220\uFF1B\u7EF4\u5EA6\u4E0B\u8FD8\u6709\u6807\u7B7E\u65F6\u4F1A 409\uFF09")
+    ).action(async (key, opts) => {
+      const token = requireToken();
+      const data = await apiRequest(`/api/taxonomy-dimensions/${key}`, {
+        method: "DELETE",
+        token,
+        apiUrl: opts.apiUrl
+      });
+      console.log(JSON.stringify(data, null, 2));
+    }),
+    { permission: PERMISSION, examples: DIM_DELETE_EXAMPLES }
+  );
+  attachMeta(
+    withApiUrl(taxonomy.command("list").description("\u5217\u51FA\u5168\u90E8\u5206\u7C7B\u6807\u7B7E\uFF08\u516C\u5F00\u53EA\u8BFB\uFF0C\u4E0D\u767B\u5F55\u4E5F\u80FD\u7528\uFF09")).action(
+      async (opts) => {
+        const data = await apiRequest("/api/taxonomies", { token: optionalToken(), apiUrl: opts.apiUrl });
+        console.log(JSON.stringify(data, null, 2));
+      }
+    ),
+    { examples: LIST_EXAMPLES3 }
+  );
+  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) => {
+      const token = requireToken();
+      try {
+        const body = taxonomyCreateSchema.parse(toTaxonomyBody(opts));
+        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);
+      }
+    }),
+    { permission: PERMISSION, examples: CREATE_EXAMPLES3 }
+  );
+  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) => {
+      const token = requireToken();
+      try {
+        const body = taxonomyUpdateSchema.parse(toTaxonomyBody(opts));
+        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);
+      }
+    }),
+    { permission: PERMISSION, examples: UPDATE_EXAMPLES3 }
+  );
+  attachMeta(
+    withApiUrl(taxonomy.command("delete <id>").description("\u5220\u9664\u5206\u7C7B\u6807\u7B7E")).action(
+      async (id, opts) => {
+        const token = requireToken();
+        const data = await apiRequest(`/api/taxonomies/${id}`, { method: "DELETE", token, apiUrl: opts.apiUrl });
+        console.log(JSON.stringify(data, null, 2));
+      }
+    ),
+    { permission: PERMISSION, examples: DELETE_EXAMPLES3 }
+  );
+}
+
 // src/commands/schema.ts
 var CODE_DESCRIPTION = {
   ok: "\u6210\u529F",
@@ -768,6 +975,9 @@ function exitCodeTable() {
   }
   return table;
 }
+function isInternalCommand(command) {
+  return command.name().startsWith("__");
+}
 function serialize(command) {
   const meta = getMeta(command);
   return {
@@ -777,7 +987,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) {
@@ -786,7 +996,7 @@ function registerSchemaCommand(program2) {
       JSON.stringify(
         {
           exitCodes: exitCodeTable(),
-          commands: program2.commands.map(serialize)
+          commands: program2.commands.filter((c) => !isInternalCommand(c)).map(serialize)
         },
         null,
         2
@@ -795,8 +1005,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();
@@ -809,7 +1107,13 @@ registerWhoamiCommand(program);
 registerConfigCommand(program);
 registerProjectCommand(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.2.2",
+  "version": "0.4.0",
   "private": false,
   "description": "1836 开源共建平台（problem-driven-lab）的命令行工具：项目、内容的增删改查，浏览器授权登录",
   "keywords": [