@zentodo/cli 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin.cjs CHANGED
@@ -7978,11 +7978,12 @@ function describeGroup(name) {
7978
7978
  }
7979
7979
 
7980
7980
  // src/program.ts
7981
+ var CLI_VERSION = true ? "0.1.5" : "0.0.0";
7981
7982
  function buildProgram() {
7982
7983
  const program3 = new Command();
7983
- program3.name("zentodo").description("ZenTodo \u547D\u4EE4\u884C\u5DE5\u5177 \u2014 \u57FA\u4E8E\u6E05\u5355\u9A71\u52A8,\u8FDE\u63A5 ZenTodo \u540E\u7AEF\u3002\u6240\u6709\u8BF7\u6C42\u4F7F\u7528 FormData\u3002").version("0.1.0", "-V, --version", "\u6253\u5370 CLI \u7248\u672C").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F").addHelpCommand("help [command]", "\u67E5\u770B\u547D\u4EE4\u5E2E\u52A9").option("--profile <name>", "\u4F7F\u7528\u6307\u5B9A Profile(\u9ED8\u8BA4\u4F7F\u7528 current_profile)").option("--server <url>", "\u8986\u76D6\u540E\u7AEF\u5730\u5740").option("--token <token>", "\u8986\u76D6\u672C\u5730 Token").option("--log-level <level>", "\u65E5\u5FD7\u7EA7\u522B:trace|debug|info|warn|error", "info").option("--log-file <path>", "\u8FFD\u52A0\u65E5\u5FD7\u5230\u6307\u5B9A\u6587\u4EF6").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").option("--no-color", "\u5173\u95ED\u5F69\u8272\u8F93\u51FA").option("--dry-run", "\u53EA\u6253\u5370\u5C06\u53D1\u9001\u7684\u8BF7\u6C42,\u4E0D\u771F\u6B63\u8C03\u7528\u540E\u7AEF").option("--yes", "\u8DF3\u8FC7\u7834\u574F\u6027\u64CD\u4F5C\u7684\u786E\u8BA4\u63D0\u793A").option("--local", "\u4F18\u5148\u4F7F\u7528\u672C\u5730 SQLite(\u82E5\u53EF\u7528)").option("--remote", "\u5F3A\u5236\u4F7F\u7528\u8FDC\u7A0B HTTP \u6A21\u5F0F").option("--json", "JSON \u8F93\u51FA").option("--ndjson", "\u6309\u884C\u8F93\u51FA JSON(\u9002\u5408\u6D41\u5F0F\u5904\u7406)").option("--yaml", "YAML \u8F93\u51FA").option("--quiet", "\u9690\u85CF\u975E\u5FC5\u8981\u8F93\u51FA");
7984
+ program3.name("zentodo").description("ZenTodo \u547D\u4EE4\u884C\u5DE5\u5177 \u2014 \u57FA\u4E8E\u6E05\u5355\u9A71\u52A8,\u8FDE\u63A5 ZenTodo \u540E\u7AEF\u3002\u6240\u6709\u8BF7\u6C42\u4F7F\u7528 FormData\u3002").version(CLI_VERSION, "-V, --version", "\u6253\u5370 CLI \u7248\u672C").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F").addHelpCommand("help [command]", "\u67E5\u770B\u547D\u4EE4\u5E2E\u52A9").option("--profile <name>", "\u4F7F\u7528\u6307\u5B9A Profile(\u9ED8\u8BA4\u4F7F\u7528 current_profile)").option("--server <url>", "\u8986\u76D6\u540E\u7AEF\u5730\u5740").option("--token <token>", "\u8986\u76D6\u672C\u5730 Token").option("--log-level <level>", "\u65E5\u5FD7\u7EA7\u522B:trace|debug|info|warn|error", "info").option("--log-file <path>", "\u8FFD\u52A0\u65E5\u5FD7\u5230\u6307\u5B9A\u6587\u4EF6").option("--no-retry", "\u7981\u7528\u81EA\u52A8\u91CD\u8BD5").option("--no-color", "\u5173\u95ED\u5F69\u8272\u8F93\u51FA").option("--dry-run", "\u53EA\u6253\u5370\u5C06\u53D1\u9001\u7684\u8BF7\u6C42,\u4E0D\u771F\u6B63\u8C03\u7528\u540E\u7AEF").option("--yes", "\u8DF3\u8FC7\u7834\u574F\u6027\u64CD\u4F5C\u7684\u786E\u8BA4\u63D0\u793A").option("--local", "\u4F18\u5148\u4F7F\u7528\u672C\u5730 SQLite(\u82E5\u53EF\u7528)").option("--remote", "\u5F3A\u5236\u4F7F\u7528\u8FDC\u7A0B HTTP \u6A21\u5F0F").option("--json", "JSON \u8F93\u51FA").option("--ndjson", "\u6309\u884C\u8F93\u51FA JSON(\u9002\u5408\u6D41\u5F0F\u5904\u7406)").option("--yaml", "YAML \u8F93\u51FA").option("--quiet", "\u9690\u85CF\u975E\u5FC5\u8981\u8F93\u51FA");
7984
7985
  program3.command("version-full").description("\u6253\u5370\u7248\u672C\u53F7\u4E0E\u534F\u8BAE\u517C\u5BB9\u7248\u672C").action(() => {
7985
- process.stdout.write(JSON.stringify({ version: "0.1.0", apiCompat: "v1" }) + "\n");
7986
+ process.stdout.write(JSON.stringify({ version: CLI_VERSION, apiCompat: "v1" }) + "\n");
7986
7987
  });
7987
7988
  registerAuth(program3);
7988
7989
  registerConfig(program3);
@@ -71,7 +71,31 @@ description: Manage the user's ZenTodo productivity workspace — tasks, subtask
71
71
 
72
72
  如果当前 shell 找不到 `zentodo`,设置环境变量 `ZENTODO_CLI` 指向绝对路径,并在所有命令前加 `node $ZENTODO_CLI`。
73
73
 
74
- ## 通用输出契约(**关键**)
74
+ ## ⚠️ 重要约束(必须遵守)
75
+
76
+ **绝对不要直接用 `curl` 或其他 HTTP 工具调用 ZenTodo 后端接口。**
77
+
78
+ 原因:
79
+ 1. 后端所有接口要求 `multipart/form-data` 格式,直接 curl 默认发 JSON 会导致 400 或 302 重定向
80
+ 2. `usrKey` 等认证参数必须通过 FormData 传递,JSON 格式无效
81
+ 3. CLI 已经处理好了格式转换、认证注入、错误映射
82
+
83
+ **正确做法:所有操作必须通过 `zentodo` CLI 命令完成。**
84
+
85
+ ```bash
86
+ # ✅ 正确
87
+ zentodo --json project list
88
+ zentodo --json task list
89
+
90
+ # ❌ 错误(不要这样做)
91
+ curl -X POST http://ztdfwq.qmlist.net:8082/zentodoserver/projectController/getAllProjectByUserId
92
+ ```
93
+
94
+ 如果 `zentodo` 命令不可用,先按"前置条件"安装,不要绕过 CLI 直接调接口。
95
+
96
+ ---
97
+
98
+
75
99
 
76
100
  所有命令加 `--json` 后,输出统一为:
77
101
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zentodo/cli",
3
- "version": "0.1.3",
3
+ "version": "0.1.5",
4
4
  "description": "ZenTodo 命令行工具 — 为 AI Agent 和开发者设计,覆盖任务、项目、番茄钟、日记、同步等全部能力。安装后自动配置 Claude Agent Skill。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -71,7 +71,31 @@ description: Manage the user's ZenTodo productivity workspace — tasks, subtask
71
71
 
72
72
  如果当前 shell 找不到 `zentodo`,设置环境变量 `ZENTODO_CLI` 指向绝对路径,并在所有命令前加 `node $ZENTODO_CLI`。
73
73
 
74
- ## 通用输出契约(**关键**)
74
+ ## ⚠️ 重要约束(必须遵守)
75
+
76
+ **绝对不要直接用 `curl` 或其他 HTTP 工具调用 ZenTodo 后端接口。**
77
+
78
+ 原因:
79
+ 1. 后端所有接口要求 `multipart/form-data` 格式,直接 curl 默认发 JSON 会导致 400 或 302 重定向
80
+ 2. `usrKey` 等认证参数必须通过 FormData 传递,JSON 格式无效
81
+ 3. CLI 已经处理好了格式转换、认证注入、错误映射
82
+
83
+ **正确做法:所有操作必须通过 `zentodo` CLI 命令完成。**
84
+
85
+ ```bash
86
+ # ✅ 正确
87
+ zentodo --json project list
88
+ zentodo --json task list
89
+
90
+ # ❌ 错误(不要这样做)
91
+ curl -X POST http://ztdfwq.qmlist.net:8082/zentodoserver/projectController/getAllProjectByUserId
92
+ ```
93
+
94
+ 如果 `zentodo` 命令不可用,先按"前置条件"安装,不要绕过 CLI 直接调接口。
95
+
96
+ ---
97
+
98
+
75
99
 
76
100
  所有命令加 `--json` 后,输出统一为:
77
101