watcha-cli 0.1.0 → 0.2.0

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/README.md CHANGED
@@ -102,7 +102,11 @@ $ watcha product show claude-code | jq '.data.stats' # 节选,数值随
102
102
  | 猹馆帖子 | `post list [--topic]` · `show` · `floors` · `subfloors` · `hot` | 否 |
103
103
  | 话题 | `topic list` · `hot` · `show` · `posts [--featured]` | 否 |
104
104
  | 榜单 | `rank [key] [--top N] [--archives]`(不传 key 列出全部) | 否 |
105
- | 活动 | `activity list [--q] [--city]` · `show` · `mine` | `mine` 需要 |
105
+ | 活动(逛) | `activity list`:不带 `--q` 吃 `[--city] [--location-type] [--date] [--period] [--sort]`,带 `--q` 走搜索只吃 `[--location-type] [--date] [--time-scope] [--hybrid]`(两边参数不通用,混用直接报错) · `show` · `cities` · `calendar` · `upcoming` · `hosted` | 否 |
106
+ | 活动(我的) | `activity mine [--role registered\|managed\|checkin] [--period] [--status]` · `form <活动>` | 是 |
107
+ | 活动(报名) | `activity register <活动> [--ticket] [--field k=v] [--answer 题号=答案] [--form file.json]` · `unregister`(非交互环境需 `--yes`) | 是 |
108
+ | 活动(主办) | `activity manage show\|create\|edit\|cancel\|guests\|review\|invite\|export\|stats\|form\|form-set\|ticket\|collaborators\|host\|staff` | 是 |
109
+ | 活动(签到) | `activity check-in <活动> <票码或报名ID> [--resolve] [--undo] [--full]` | 是 |
106
110
  | 用户 | `user show` · `search` · `reviews` · `posts` · `me` | `me` 需要 |
107
111
  | 信息流 | `feed` | 否(登录后个性化) |
108
112
  | AI 搜索 | `ask <question> [--resume id] [--share] [--raw] [--watch\|--no-watch]` · `ask-sessions list\|show\|delete\|shared` · `watch [file]`(实时视图窗口里跑的渲染器) | 是 |
@@ -263,10 +267,26 @@ watcha product update claude-code --slogan "新的一句话" --yes
263
267
  | `XDG_CONFIG_HOME` | 默认配置目录的上级(标准 XDG 约定) |
264
268
  | `WATCHA_CREDENTIALS_BACKEND=file` | 不使用系统钥匙串 |
265
269
  | `WATCHA_NO_INPUT=1` | 永不交互提问(等同 CI) |
270
+ | `WATCHA_NO_UPDATE_CHECK=1` | 不做版本检查(`CI`、Codex 禁网、`npx` 安装本来就不查) |
266
271
  | `WATCHA_IMAGE_PROTOCOL=iterm2\|kitty\|none` | 强制指定终端图片协议 |
267
272
  | `WATCHA_DEBUG=1` | 把每个请求的方法与 URL 打到 stderr |
268
273
  | `WATCHA_WATCH=1\|0` | `ask` 是否把实时视图开到新终端窗口;不设则在被 agent 调用且非 TTY 时自动开(`CI` 下不开,30 秒内只开一次) |
269
274
 
275
+ ### 版本更新提示
276
+
277
+ 装的版本落后于 npm 上的 latest 时,成功信封会多带一段:
278
+
279
+ ```json
280
+ {"ok":true,"data":{},"meta":{"update_available":{"current":"0.1.0","latest":"0.2.0","upgrade":"npm i -g watcha-cli@0.2.0"}}}
281
+ ```
282
+
283
+ `upgrade` 是可以直接跑的命令。pretty 模式下另有一行提示打到 stderr,按 2 小时节流;
284
+ `meta` 里的字段不节流——agent 每次都是新进程,节流只会让它随机性地看不见。
285
+
286
+ 版本缓存每 2 小时后台刷新一次,刷新由一个 detach 出去的子进程完成,不占用任何命令的时间;
287
+ 断网、超时、registry 抽风都只是不更新缓存。请求只出不进,不带任何用户信息。
288
+ 升级完记得重跑 `watcha skills install`,否则装在用户机器上的那份用法说明还是旧的。
289
+
270
290
  全局选项:`--format` `--json` `--profile` `--base-url` `--dry-run` `-y/--yes` `-q/--quiet` `--debug`,可以放在任意子命令之后。`--dry-run` 下写操作只打印将发送的请求(Authorization 已脱敏),连图片都不会上传;未登录时会先报退出码 2,`--dry-run` 不能绕过登录。
271
291
 
272
292
  ## 常见问题
@@ -1,5 +1,5 @@
1
- watcha-cli 0.1.0 内联了以下开源组件,它们按各自的许可证授权;以下为原始许可证与版权声明。
2
- The following open-source components are bundled into watcha-cli 0.1.0 and licensed under their respective licenses.
1
+ watcha-cli 0.2.0 内联了以下开源组件,它们按各自的许可证授权;以下为原始许可证与版权声明。
2
+ The following open-source components are bundled into watcha-cli 0.2.0 and licensed under their respective licenses.
3
3
 
4
4
  ========================================================================
5
5
  character-entities 2.0.2 (MIT) wooorm/character-entities