@zentodo/cli 0.1.11 → 0.1.12

package/dist/skills/zentodo/SKILL.md

@@ -208,7 +208,21 @@ zentodo doctor
 
 2. **不要误判 "Session 过期"**
    ZenTodo 后端用 Spring Security + Session Cookie。CLI 是无状态 HTTP，不带 Cookie。
-   大部分接口用 `usrKey` 参数就能工作。极少数旧接口走 Session，会 302 重定向——这**不是** session 过期，是本来就没 session。不要劝用户"重新登录"，请直接使用有 `usrKey` 参数的替代接口。
+   大部分接口用 `usrKey` 参数就能工作，**不需要** session。
+
+   如果 CLI 调用接口被 302 重定向到 `/login`，**99% 不是 session 过期**，而是下列原因之一：
+   - `config.json` 里 `user_key` 是坏对象（老版 CLI bug，值像 `{data:466,code:0,msg:"ok"}`），发出去变成 `[object Object]`，后端解析失败 → 302。**解决：升级 CLI 到最新版，启动时会自动修复。**
+   - 个别旧接口强依赖 Session Cookie，CLI 永远触发 302。**解决：换有 `usrKey` 参数的同类接口。**
+
+   诊断步骤：
+   ```bash
+   zentodo --dry-run --json project list
+   # 看 fields 里 usrKey 是不是纯数字，如果是 [object Object] 就是坏数据
+   zentodo auth whoami
+   # user_key 应该显示数字，不是 JSON 对象
+   ```
+
+   **不要**劝用户"重新登录"——CLI 根本不维护 session，重新登录也没用；只会再存一次坏数据。
 
 3. **不要拉全量再过滤，能用专用接口就用**
    - ❌ 不要：`zentodo task list | jq '.data[] | select(.isMIT == true)'`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zentodo/cli",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "ZenTodo 命令行工具 — 为 AI Agent 和开发者设计，覆盖任务、项目、番茄钟、日记、同步等全部能力。安装后自动配置 Claude Agent Skill。",
   "type": "module",
   "bin": {

package/skills/zentodo/SKILL.md

@@ -208,7 +208,21 @@ zentodo doctor
 
 2. **不要误判 "Session 过期"**
    ZenTodo 后端用 Spring Security + Session Cookie。CLI 是无状态 HTTP，不带 Cookie。
-   大部分接口用 `usrKey` 参数就能工作。极少数旧接口走 Session，会 302 重定向——这**不是** session 过期，是本来就没 session。不要劝用户"重新登录"，请直接使用有 `usrKey` 参数的替代接口。
+   大部分接口用 `usrKey` 参数就能工作，**不需要** session。
+
+   如果 CLI 调用接口被 302 重定向到 `/login`，**99% 不是 session 过期**，而是下列原因之一：
+   - `config.json` 里 `user_key` 是坏对象（老版 CLI bug，值像 `{data:466,code:0,msg:"ok"}`），发出去变成 `[object Object]`，后端解析失败 → 302。**解决：升级 CLI 到最新版，启动时会自动修复。**
+   - 个别旧接口强依赖 Session Cookie，CLI 永远触发 302。**解决：换有 `usrKey` 参数的同类接口。**
+
+   诊断步骤：
+   ```bash
+   zentodo --dry-run --json project list
+   # 看 fields 里 usrKey 是不是纯数字，如果是 [object Object] 就是坏数据
+   zentodo auth whoami
+   # user_key 应该显示数字，不是 JSON 对象
+   ```
+
+   **不要**劝用户"重新登录"——CLI 根本不维护 session，重新登录也没用；只会再存一次坏数据。
 
 3. **不要拉全量再过滤，能用专用接口就用**
    - ❌ 不要：`zentodo task list | jq '.data[] | select(.isMIT == true)'`