@zentodo/cli 0.1.7 → 0.1.8

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
@@ -8143,7 +8143,7 @@ function describeGroup(name) {
8143
8143
  }
8144
8144
 
8145
8145
  // src/program.ts
8146
- var CLI_VERSION = true ? "0.1.7" : "0.0.0";
8146
+ var CLI_VERSION = true ? "0.1.8" : "0.0.0";
8147
8147
  function buildProgram() {
8148
8148
  const program3 = new Command();
8149
8149
  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");
@@ -93,6 +93,16 @@ curl -X POST http://ztdfwq.qmlist.net:8082/zentodoserver/projectController/getAl
93
93
 
94
94
  如果 `zentodo` 命令不可用,先按"前置条件"安装,不要绕过 CLI 直接调接口。
95
95
 
96
+ **关于 "Session 过期 / 302 重定向"的常见误解:**
97
+
98
+ ZenTodo 后端使用 Spring Security + Session Cookie 认证。CLI 是无状态 HTTP 调用,不带 Cookie。
99
+ 大部分接口(以 `usrKey` 参数形式设计)对 CLI 完全可用;**极少数旧接口依赖 Session,CLI 调它们会被 302 重定向到 `/login`**。
100
+
101
+ 遇到这种情况:
102
+ - **不要**提示用户"session 过期,请重新登录"——CLI 本来就不走 session
103
+ - 应该选用替代接口(几乎每种查询都有 `usrKey` 版本)
104
+ - 或者让用户反馈,由后端把该接口改造成 FormData 传 `usrKey` 模式
105
+
96
106
  ---
97
107
 
98
108
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zentodo/cli",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "description": "ZenTodo 命令行工具 — 为 AI Agent 和开发者设计,覆盖任务、项目、番茄钟、日记、同步等全部能力。安装后自动配置 Claude Agent Skill。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -93,6 +93,16 @@ curl -X POST http://ztdfwq.qmlist.net:8082/zentodoserver/projectController/getAl
93
93
 
94
94
  如果 `zentodo` 命令不可用,先按"前置条件"安装,不要绕过 CLI 直接调接口。
95
95
 
96
+ **关于 "Session 过期 / 302 重定向"的常见误解:**
97
+
98
+ ZenTodo 后端使用 Spring Security + Session Cookie 认证。CLI 是无状态 HTTP 调用,不带 Cookie。
99
+ 大部分接口(以 `usrKey` 参数形式设计)对 CLI 完全可用;**极少数旧接口依赖 Session,CLI 调它们会被 302 重定向到 `/login`**。
100
+
101
+ 遇到这种情况:
102
+ - **不要**提示用户"session 过期,请重新登录"——CLI 本来就不走 session
103
+ - 应该选用替代接口(几乎每种查询都有 `usrKey` 版本)
104
+ - 或者让用户反馈,由后端把该接口改造成 FormData 传 `usrKey` 模式
105
+
96
106
  ---
97
107
 
98
108