@jackwener/opencli 1.5.5 → 1.5.7

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.
Files changed (540) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +31 -4
  3. package/README.zh-CN.md +40 -5
  4. package/SKILL.md +1 -1
  5. package/dist/browser/cdp.d.ts +1 -0
  6. package/dist/browser/cdp.js +30 -27
  7. package/dist/browser/daemon-client.d.ts +11 -1
  8. package/dist/browser/daemon-client.js +3 -0
  9. package/dist/browser/dom-helpers.js +1 -0
  10. package/dist/browser/dom-helpers.test.js +14 -1
  11. package/dist/browser/mcp.js +18 -13
  12. package/dist/browser/page.d.ts +6 -0
  13. package/dist/browser/page.js +37 -2
  14. package/dist/browser/page.test.d.ts +1 -0
  15. package/dist/browser/page.test.js +44 -0
  16. package/dist/browser/stealth.js +198 -0
  17. package/dist/browser/stealth.test.d.ts +1 -0
  18. package/dist/browser/stealth.test.js +134 -0
  19. package/dist/browser.test.js +1 -1
  20. package/dist/build-manifest.d.ts +1 -0
  21. package/dist/build-manifest.js +5 -1
  22. package/dist/build-manifest.test.js +2 -0
  23. package/dist/cli-manifest.json +1821 -252
  24. package/dist/cli.js +20 -3
  25. package/dist/clis/antigravity/serve.d.ts +1 -1
  26. package/dist/clis/antigravity/serve.js +5 -8
  27. package/dist/clis/band/bands.d.ts +1 -0
  28. package/dist/clis/band/bands.js +72 -0
  29. package/dist/clis/band/mentions.d.ts +1 -0
  30. package/dist/clis/band/mentions.js +127 -0
  31. package/dist/clis/band/post.d.ts +1 -0
  32. package/dist/clis/band/post.js +175 -0
  33. package/dist/clis/band/posts.d.ts +1 -0
  34. package/dist/clis/band/posts.js +94 -0
  35. package/dist/clis/bilibili/subtitle.js +4 -0
  36. package/dist/clis/bilibili/subtitle.test.d.ts +1 -0
  37. package/dist/clis/bilibili/subtitle.test.js +48 -0
  38. package/dist/clis/chatwise/ask.js +0 -2
  39. package/dist/clis/chatwise/export.js +0 -2
  40. package/dist/clis/chatwise/history.js +0 -2
  41. package/dist/clis/chatwise/model.js +0 -2
  42. package/dist/clis/chatwise/new.js +1 -2
  43. package/dist/clis/chatwise/read.js +0 -2
  44. package/dist/clis/chatwise/screenshot.js +1 -2
  45. package/dist/clis/chatwise/send.js +0 -2
  46. package/dist/clis/chatwise/status.js +1 -2
  47. package/dist/clis/ctrip/search.d.ts +13 -0
  48. package/dist/clis/ctrip/search.js +73 -48
  49. package/dist/clis/ctrip/search.test.d.ts +1 -0
  50. package/dist/clis/ctrip/search.test.js +64 -0
  51. package/dist/clis/doubao/detail.d.ts +1 -0
  52. package/dist/clis/doubao/detail.js +33 -0
  53. package/dist/clis/doubao/detail.test.d.ts +1 -0
  54. package/dist/clis/doubao/detail.test.js +42 -0
  55. package/dist/clis/doubao/history.d.ts +1 -0
  56. package/dist/clis/doubao/history.js +28 -0
  57. package/dist/clis/doubao/history.test.d.ts +1 -0
  58. package/dist/clis/doubao/history.test.js +37 -0
  59. package/dist/clis/doubao/meeting-summary.d.ts +1 -0
  60. package/dist/clis/doubao/meeting-summary.js +39 -0
  61. package/dist/clis/doubao/meeting-transcript.d.ts +1 -0
  62. package/dist/clis/doubao/meeting-transcript.js +36 -0
  63. package/dist/clis/doubao/utils.d.ts +27 -0
  64. package/dist/clis/doubao/utils.js +317 -0
  65. package/dist/clis/doubao/utils.test.d.ts +1 -0
  66. package/dist/clis/doubao/utils.test.js +24 -0
  67. package/dist/clis/douyin/_shared/public-api.d.ts +33 -0
  68. package/dist/clis/douyin/_shared/public-api.js +29 -0
  69. package/dist/clis/douyin/_shared/sts2.js +8 -2
  70. package/dist/clis/douyin/_shared/sts2.test.d.ts +1 -0
  71. package/dist/clis/douyin/_shared/sts2.test.js +27 -0
  72. package/dist/clis/douyin/activities.js +4 -2
  73. package/dist/clis/douyin/activities.test.js +34 -1
  74. package/dist/clis/douyin/collections.js +1 -1
  75. package/dist/clis/douyin/collections.test.js +24 -2
  76. package/dist/clis/douyin/draft.d.ts +8 -11
  77. package/dist/clis/douyin/draft.js +302 -185
  78. package/dist/clis/douyin/draft.test.d.ts +1 -1
  79. package/dist/clis/douyin/draft.test.js +357 -2
  80. package/dist/clis/douyin/hashtag.js +9 -2
  81. package/dist/clis/douyin/hashtag.test.js +35 -2
  82. package/dist/clis/douyin/profile.js +1 -1
  83. package/dist/clis/douyin/profile.test.js +36 -1
  84. package/dist/clis/douyin/user-videos.d.ts +5 -0
  85. package/dist/clis/douyin/user-videos.js +74 -0
  86. package/dist/clis/douyin/user-videos.test.d.ts +1 -0
  87. package/dist/clis/douyin/user-videos.test.js +108 -0
  88. package/dist/clis/douyin/videos.js +22 -5
  89. package/dist/clis/douyin/videos.test.js +45 -2
  90. package/dist/clis/facebook/search.test.d.ts +5 -0
  91. package/dist/clis/facebook/search.test.js +60 -0
  92. package/dist/clis/facebook/search.yaml +4 -3
  93. package/dist/clis/instagram/download.d.ts +16 -0
  94. package/dist/clis/instagram/download.js +225 -0
  95. package/dist/clis/instagram/download.test.d.ts +1 -0
  96. package/dist/clis/instagram/download.test.js +118 -0
  97. package/dist/clis/notebooklm/bind-current.d.ts +1 -0
  98. package/dist/clis/notebooklm/bind-current.js +29 -0
  99. package/dist/clis/notebooklm/bind-current.test.d.ts +1 -0
  100. package/dist/clis/notebooklm/bind-current.test.js +35 -0
  101. package/dist/clis/notebooklm/binding.test.d.ts +1 -0
  102. package/dist/clis/notebooklm/binding.test.js +44 -0
  103. package/dist/clis/notebooklm/compat.test.d.ts +3 -0
  104. package/dist/clis/notebooklm/compat.test.js +16 -0
  105. package/dist/clis/notebooklm/current.d.ts +1 -0
  106. package/dist/clis/notebooklm/current.js +28 -0
  107. package/dist/clis/notebooklm/get.d.ts +1 -0
  108. package/dist/clis/notebooklm/get.js +37 -0
  109. package/dist/clis/notebooklm/history.d.ts +1 -0
  110. package/dist/clis/notebooklm/history.js +25 -0
  111. package/dist/clis/notebooklm/history.test.d.ts +1 -0
  112. package/dist/clis/notebooklm/history.test.js +58 -0
  113. package/dist/clis/notebooklm/list.d.ts +1 -0
  114. package/dist/clis/notebooklm/list.js +35 -0
  115. package/dist/clis/notebooklm/note-list.d.ts +1 -0
  116. package/dist/clis/notebooklm/note-list.js +28 -0
  117. package/dist/clis/notebooklm/note-list.test.d.ts +1 -0
  118. package/dist/clis/notebooklm/note-list.test.js +56 -0
  119. package/dist/clis/notebooklm/notes-get.d.ts +1 -0
  120. package/dist/clis/notebooklm/notes-get.js +47 -0
  121. package/dist/clis/notebooklm/notes-get.test.d.ts +1 -0
  122. package/dist/clis/notebooklm/notes-get.test.js +72 -0
  123. package/dist/clis/notebooklm/rpc.d.ts +36 -0
  124. package/dist/clis/notebooklm/rpc.js +189 -0
  125. package/dist/clis/notebooklm/rpc.test.d.ts +1 -0
  126. package/dist/clis/notebooklm/rpc.test.js +105 -0
  127. package/dist/clis/notebooklm/shared.d.ts +87 -0
  128. package/dist/clis/notebooklm/shared.js +3 -0
  129. package/dist/clis/notebooklm/source-fulltext.d.ts +1 -0
  130. package/dist/clis/notebooklm/source-fulltext.js +44 -0
  131. package/dist/clis/notebooklm/source-fulltext.test.d.ts +1 -0
  132. package/dist/clis/notebooklm/source-fulltext.test.js +106 -0
  133. package/dist/clis/notebooklm/source-get.d.ts +1 -0
  134. package/dist/clis/notebooklm/source-get.js +40 -0
  135. package/dist/clis/notebooklm/source-get.test.d.ts +1 -0
  136. package/dist/clis/notebooklm/source-get.test.js +84 -0
  137. package/dist/clis/notebooklm/source-guide.d.ts +1 -0
  138. package/dist/clis/notebooklm/source-guide.js +44 -0
  139. package/dist/clis/notebooklm/source-guide.test.d.ts +1 -0
  140. package/dist/clis/notebooklm/source-guide.test.js +104 -0
  141. package/dist/clis/notebooklm/source-list.d.ts +1 -0
  142. package/dist/clis/notebooklm/source-list.js +30 -0
  143. package/dist/clis/notebooklm/status.d.ts +1 -0
  144. package/dist/clis/notebooklm/status.js +31 -0
  145. package/dist/clis/notebooklm/summary.d.ts +1 -0
  146. package/dist/clis/notebooklm/summary.js +30 -0
  147. package/dist/clis/notebooklm/summary.test.d.ts +1 -0
  148. package/dist/clis/notebooklm/summary.test.js +78 -0
  149. package/dist/clis/notebooklm/utils.d.ts +37 -0
  150. package/dist/clis/notebooklm/utils.js +739 -0
  151. package/dist/clis/notebooklm/utils.test.d.ts +1 -0
  152. package/dist/clis/notebooklm/utils.test.js +390 -0
  153. package/dist/clis/ones/common.d.ts +32 -0
  154. package/dist/clis/ones/common.js +144 -0
  155. package/dist/clis/ones/enrich-tasks.d.ts +5 -0
  156. package/dist/clis/ones/enrich-tasks.js +37 -0
  157. package/dist/clis/ones/login.d.ts +1 -0
  158. package/dist/clis/ones/login.js +80 -0
  159. package/dist/clis/ones/logout.d.ts +1 -0
  160. package/dist/clis/ones/logout.js +17 -0
  161. package/dist/clis/ones/me.d.ts +1 -0
  162. package/dist/clis/ones/me.js +30 -0
  163. package/dist/clis/ones/my-tasks.d.ts +1 -0
  164. package/dist/clis/ones/my-tasks.js +120 -0
  165. package/dist/clis/ones/resolve-labels.d.ts +10 -0
  166. package/dist/clis/ones/resolve-labels.js +64 -0
  167. package/dist/clis/ones/task-helpers.d.ts +29 -0
  168. package/dist/clis/ones/task-helpers.js +212 -0
  169. package/dist/clis/ones/task-helpers.test.d.ts +1 -0
  170. package/dist/clis/ones/task-helpers.test.js +12 -0
  171. package/dist/clis/ones/task.d.ts +1 -0
  172. package/dist/clis/ones/task.js +66 -0
  173. package/dist/clis/ones/tasks.d.ts +1 -0
  174. package/dist/clis/ones/tasks.js +79 -0
  175. package/dist/clis/ones/token-info.d.ts +1 -0
  176. package/dist/clis/ones/token-info.js +42 -0
  177. package/dist/clis/ones/worklog.d.ts +11 -0
  178. package/dist/clis/ones/worklog.js +267 -0
  179. package/dist/clis/ones/worklog.test.d.ts +1 -0
  180. package/dist/clis/ones/worklog.test.js +20 -0
  181. package/dist/clis/spotify/spotify.d.ts +1 -0
  182. package/dist/clis/spotify/spotify.js +316 -0
  183. package/dist/clis/spotify/utils.d.ts +21 -0
  184. package/dist/clis/spotify/utils.js +66 -0
  185. package/dist/clis/spotify/utils.test.d.ts +1 -0
  186. package/dist/clis/spotify/utils.test.js +67 -0
  187. package/dist/clis/substack/utils.d.ts +4 -0
  188. package/dist/clis/substack/utils.js +8 -2
  189. package/dist/clis/substack/utils.test.d.ts +1 -0
  190. package/dist/clis/substack/utils.test.js +46 -0
  191. package/dist/clis/tieba/commands.test.d.ts +4 -0
  192. package/dist/clis/tieba/commands.test.js +79 -0
  193. package/dist/clis/tieba/hot.d.ts +1 -0
  194. package/dist/clis/tieba/hot.js +48 -0
  195. package/dist/clis/tieba/posts.d.ts +1 -0
  196. package/dist/clis/tieba/posts.js +85 -0
  197. package/dist/clis/tieba/read.d.ts +1 -0
  198. package/dist/clis/tieba/read.js +140 -0
  199. package/dist/clis/tieba/search.d.ts +1 -0
  200. package/dist/clis/tieba/search.js +108 -0
  201. package/dist/clis/tieba/utils.d.ts +101 -0
  202. package/dist/clis/tieba/utils.js +240 -0
  203. package/dist/clis/tieba/utils.test.d.ts +1 -0
  204. package/dist/clis/tieba/utils.test.js +290 -0
  205. package/dist/clis/v2ex/hot.yaml +4 -1
  206. package/dist/clis/v2ex/latest.yaml +4 -1
  207. package/dist/clis/v2ex/topic.yaml +6 -1
  208. package/dist/clis/weixin/download.d.ts +9 -0
  209. package/dist/clis/weixin/download.js +76 -6
  210. package/dist/clis/weread/book.js +206 -13
  211. package/dist/clis/weread/commands.test.js +331 -0
  212. package/dist/clis/weread/private-api-regression.test.d.ts +1 -0
  213. package/dist/{weread-private-api-regression.test.js → clis/weread/private-api-regression.test.js} +92 -30
  214. package/dist/clis/weread/search-regression.test.d.ts +1 -0
  215. package/dist/clis/weread/search-regression.test.js +407 -0
  216. package/dist/clis/weread/search.js +143 -7
  217. package/dist/clis/weread/shelf.js +13 -95
  218. package/dist/clis/weread/utils.d.ts +56 -0
  219. package/dist/clis/weread/utils.js +234 -7
  220. package/dist/clis/weread/utils.test.js +71 -1
  221. package/dist/clis/xiaohongshu/comments.d.ts +3 -0
  222. package/dist/clis/xiaohongshu/comments.js +76 -17
  223. package/dist/clis/xiaohongshu/comments.test.js +70 -9
  224. package/dist/clis/xiaohongshu/download.d.ts +4 -1
  225. package/dist/clis/xiaohongshu/download.js +83 -22
  226. package/dist/clis/xiaohongshu/download.test.d.ts +1 -0
  227. package/dist/clis/xiaohongshu/download.test.js +75 -0
  228. package/dist/clis/xiaohongshu/note-helpers.d.ts +12 -0
  229. package/dist/clis/xiaohongshu/note-helpers.js +23 -0
  230. package/dist/clis/xiaohongshu/note.d.ts +7 -0
  231. package/dist/clis/xiaohongshu/note.js +76 -0
  232. package/dist/clis/xiaohongshu/note.test.d.ts +1 -0
  233. package/dist/clis/xiaohongshu/note.test.js +136 -0
  234. package/dist/clis/xiaohongshu/publish.d.ts +1 -1
  235. package/dist/clis/xiaohongshu/publish.js +78 -31
  236. package/dist/clis/xiaohongshu/publish.test.js +66 -1
  237. package/dist/clis/xiaohongshu/search.js +9 -0
  238. package/dist/clis/xiaohongshu/search.test.js +10 -4
  239. package/dist/clis/xiaohongshu/user-helpers.d.ts +1 -0
  240. package/dist/clis/xiaohongshu/user-helpers.js +2 -0
  241. package/dist/clis/xiaohongshu/user-helpers.test.js +18 -0
  242. package/dist/clis/xueqiu/comments.d.ts +118 -0
  243. package/dist/clis/xueqiu/comments.js +354 -0
  244. package/dist/clis/xueqiu/comments.test.d.ts +1 -0
  245. package/dist/clis/xueqiu/comments.test.js +696 -0
  246. package/dist/clis/youtube/search.js +57 -17
  247. package/dist/clis/youtube/transcript.js +2 -4
  248. package/dist/clis/youtube/utils.d.ts +9 -0
  249. package/dist/clis/youtube/utils.js +67 -3
  250. package/dist/clis/youtube/utils.test.d.ts +1 -0
  251. package/dist/clis/youtube/utils.test.js +37 -0
  252. package/dist/clis/youtube/video.js +16 -15
  253. package/dist/clis/zhihu/question.js +19 -17
  254. package/dist/clis/zhihu/question.test.d.ts +1 -0
  255. package/dist/clis/zhihu/question.test.js +54 -0
  256. package/dist/clis/zsxq/dynamics.d.ts +1 -0
  257. package/dist/clis/zsxq/dynamics.js +47 -0
  258. package/dist/clis/zsxq/groups.d.ts +1 -0
  259. package/dist/clis/zsxq/groups.js +32 -0
  260. package/dist/clis/zsxq/search.d.ts +1 -0
  261. package/dist/clis/zsxq/search.js +43 -0
  262. package/dist/clis/zsxq/search.test.d.ts +1 -0
  263. package/dist/clis/zsxq/search.test.js +24 -0
  264. package/dist/clis/zsxq/topic.d.ts +1 -0
  265. package/dist/clis/zsxq/topic.js +47 -0
  266. package/dist/clis/zsxq/topic.test.d.ts +1 -0
  267. package/dist/clis/zsxq/topic.test.js +29 -0
  268. package/dist/clis/zsxq/topics.d.ts +1 -0
  269. package/dist/clis/zsxq/topics.js +25 -0
  270. package/dist/clis/zsxq/topics.test.d.ts +1 -0
  271. package/dist/clis/zsxq/topics.test.js +24 -0
  272. package/dist/clis/zsxq/utils.d.ts +97 -0
  273. package/dist/clis/zsxq/utils.js +230 -0
  274. package/dist/commanderAdapter.js +10 -1
  275. package/dist/commanderAdapter.test.js +64 -0
  276. package/dist/commands/daemon.d.ts +9 -0
  277. package/dist/commands/daemon.js +124 -0
  278. package/dist/commands/daemon.test.d.ts +1 -0
  279. package/dist/commands/daemon.test.js +185 -0
  280. package/dist/completion.js +3 -1
  281. package/dist/constants.d.ts +2 -0
  282. package/dist/constants.js +2 -0
  283. package/dist/daemon.d.ts +1 -1
  284. package/dist/daemon.js +25 -14
  285. package/dist/daemon.test.d.ts +1 -0
  286. package/dist/daemon.test.js +65 -0
  287. package/dist/discovery.d.ts +9 -0
  288. package/dist/discovery.js +47 -2
  289. package/dist/electron-apps.d.ts +29 -0
  290. package/dist/electron-apps.js +65 -0
  291. package/dist/electron-apps.test.d.ts +1 -0
  292. package/dist/electron-apps.test.js +43 -0
  293. package/dist/engine.test.js +41 -9
  294. package/dist/execution.js +20 -16
  295. package/dist/external-clis.yaml +17 -0
  296. package/dist/idle-manager.d.ts +19 -0
  297. package/dist/idle-manager.js +54 -0
  298. package/dist/launcher.d.ts +36 -0
  299. package/dist/launcher.js +152 -0
  300. package/dist/launcher.test.d.ts +1 -0
  301. package/dist/launcher.test.js +57 -0
  302. package/dist/main.js +3 -3
  303. package/dist/registry.d.ts +1 -0
  304. package/dist/registry.js +31 -3
  305. package/dist/registry.test.js +13 -0
  306. package/dist/runtime.d.ts +5 -3
  307. package/dist/runtime.js +12 -5
  308. package/dist/serialization.d.ts +1 -0
  309. package/dist/serialization.js +3 -0
  310. package/dist/serialization.test.js +17 -1
  311. package/dist/tui.d.ts +7 -0
  312. package/dist/tui.js +52 -0
  313. package/dist/tui.test.d.ts +1 -0
  314. package/dist/tui.test.js +19 -0
  315. package/dist/types.d.ts +5 -0
  316. package/dist/weixin-download.test.js +14 -0
  317. package/docs/.vitepress/config.mts +4 -0
  318. package/docs/adapters/browser/band.md +63 -0
  319. package/docs/adapters/browser/notebooklm.md +69 -0
  320. package/docs/adapters/browser/ones.md +59 -0
  321. package/docs/adapters/browser/spotify.md +62 -0
  322. package/docs/adapters/browser/tieba.md +45 -0
  323. package/docs/adapters/browser/xiaohongshu.md +19 -10
  324. package/docs/adapters/browser/xueqiu.md +5 -0
  325. package/docs/adapters/browser/zsxq.md +49 -0
  326. package/docs/adapters/index.md +67 -63
  327. package/docs/adapters-doc/ones.md +32 -0
  328. package/docs/guide/browser-bridge.md +12 -0
  329. package/docs/guide/troubleshooting.md +9 -4
  330. package/docs/superpowers/plans/2026-03-31-daemon-lifecycle-redesign.md +857 -0
  331. package/docs/superpowers/specs/2026-03-31-daemon-lifecycle-redesign.md +208 -0
  332. package/docs/zh/guide/browser-bridge.md +12 -0
  333. package/extension/dist/background.js +794 -513
  334. package/extension/src/background.test.ts +202 -2
  335. package/extension/src/background.ts +189 -10
  336. package/extension/src/cdp.ts +54 -0
  337. package/extension/src/protocol.ts +11 -5
  338. package/package.json +1 -1
  339. package/scripts/postinstall.js +16 -0
  340. package/src/browser/cdp.ts +24 -17
  341. package/src/browser/daemon-client.ts +11 -1
  342. package/src/browser/dom-helpers.test.ts +15 -1
  343. package/src/browser/dom-helpers.ts +1 -0
  344. package/src/browser/mcp.ts +18 -13
  345. package/src/browser/page.test.ts +58 -0
  346. package/src/browser/page.ts +34 -2
  347. package/src/browser/stealth.test.ts +153 -0
  348. package/src/browser/stealth.ts +198 -0
  349. package/src/browser.test.ts +1 -1
  350. package/src/build-manifest.test.ts +2 -0
  351. package/src/build-manifest.ts +6 -1
  352. package/src/cli.ts +21 -3
  353. package/src/clis/antigravity/SKILL.md +3 -12
  354. package/src/clis/antigravity/serve.ts +5 -10
  355. package/src/clis/band/bands.ts +76 -0
  356. package/src/clis/band/mentions.ts +134 -0
  357. package/src/clis/band/post.ts +187 -0
  358. package/src/clis/band/posts.ts +106 -0
  359. package/src/clis/bilibili/subtitle.test.ts +60 -0
  360. package/src/clis/bilibili/subtitle.ts +4 -0
  361. package/src/clis/chatwise/ask.ts +0 -2
  362. package/src/clis/chatwise/export.ts +0 -2
  363. package/src/clis/chatwise/history.ts +0 -2
  364. package/src/clis/chatwise/model.ts +0 -2
  365. package/src/clis/chatwise/new.ts +1 -2
  366. package/src/clis/chatwise/read.ts +0 -2
  367. package/src/clis/chatwise/screenshot.ts +1 -2
  368. package/src/clis/chatwise/send.ts +0 -2
  369. package/src/clis/chatwise/status.ts +1 -2
  370. package/src/clis/ctrip/search.test.ts +73 -0
  371. package/src/clis/ctrip/search.ts +97 -47
  372. package/src/clis/doubao/detail.test.ts +53 -0
  373. package/src/clis/doubao/detail.ts +41 -0
  374. package/src/clis/doubao/history.test.ts +45 -0
  375. package/src/clis/doubao/history.ts +32 -0
  376. package/src/clis/doubao/meeting-summary.ts +53 -0
  377. package/src/clis/doubao/meeting-transcript.ts +48 -0
  378. package/src/clis/doubao/utils.test.ts +45 -0
  379. package/src/clis/doubao/utils.ts +371 -0
  380. package/src/clis/douyin/_shared/public-api.ts +84 -0
  381. package/src/clis/douyin/_shared/sts2.test.ts +31 -0
  382. package/src/clis/douyin/_shared/sts2.ts +11 -3
  383. package/src/clis/douyin/activities.test.ts +41 -1
  384. package/src/clis/douyin/activities.ts +12 -3
  385. package/src/clis/douyin/collections.test.ts +35 -2
  386. package/src/clis/douyin/collections.ts +1 -1
  387. package/src/clis/douyin/draft.test.ts +444 -2
  388. package/src/clis/douyin/draft.ts +382 -218
  389. package/src/clis/douyin/hashtag.test.ts +42 -2
  390. package/src/clis/douyin/hashtag.ts +11 -3
  391. package/src/clis/douyin/profile.test.ts +43 -1
  392. package/src/clis/douyin/profile.ts +9 -2
  393. package/src/clis/douyin/user-videos.test.ts +122 -0
  394. package/src/clis/douyin/user-videos.ts +101 -0
  395. package/src/clis/douyin/videos.test.ts +52 -2
  396. package/src/clis/douyin/videos.ts +49 -15
  397. package/src/clis/facebook/search.test.ts +70 -0
  398. package/src/clis/facebook/search.yaml +4 -3
  399. package/src/clis/instagram/download.test.ts +159 -0
  400. package/src/clis/instagram/download.ts +286 -0
  401. package/src/clis/notebooklm/bind-current.test.ts +43 -0
  402. package/src/clis/notebooklm/bind-current.ts +36 -0
  403. package/src/clis/notebooklm/binding.test.ts +53 -0
  404. package/src/clis/notebooklm/compat.test.ts +19 -0
  405. package/src/clis/notebooklm/current.ts +38 -0
  406. package/src/clis/notebooklm/get.ts +53 -0
  407. package/src/clis/notebooklm/history.test.ts +70 -0
  408. package/src/clis/notebooklm/history.ts +36 -0
  409. package/src/clis/notebooklm/list.ts +40 -0
  410. package/src/clis/notebooklm/note-list.test.ts +64 -0
  411. package/src/clis/notebooklm/note-list.ts +42 -0
  412. package/src/clis/notebooklm/notes-get.test.ts +88 -0
  413. package/src/clis/notebooklm/notes-get.ts +67 -0
  414. package/src/clis/notebooklm/rpc.test.ts +126 -0
  415. package/src/clis/notebooklm/rpc.ts +286 -0
  416. package/src/clis/notebooklm/shared.ts +98 -0
  417. package/src/clis/notebooklm/source-fulltext.test.ts +123 -0
  418. package/src/clis/notebooklm/source-fulltext.ts +69 -0
  419. package/src/clis/notebooklm/source-get.test.ts +100 -0
  420. package/src/clis/notebooklm/source-get.ts +60 -0
  421. package/src/clis/notebooklm/source-guide.test.ts +121 -0
  422. package/src/clis/notebooklm/source-guide.ts +69 -0
  423. package/src/clis/notebooklm/source-list.ts +45 -0
  424. package/src/clis/notebooklm/status.ts +34 -0
  425. package/src/clis/notebooklm/summary.test.ts +94 -0
  426. package/src/clis/notebooklm/summary.ts +45 -0
  427. package/src/clis/notebooklm/utils.test.ts +446 -0
  428. package/src/clis/notebooklm/utils.ts +893 -0
  429. package/src/clis/ones/common.ts +187 -0
  430. package/src/clis/ones/enrich-tasks.ts +47 -0
  431. package/src/clis/ones/login.ts +103 -0
  432. package/src/clis/ones/logout.ts +19 -0
  433. package/src/clis/ones/me.ts +34 -0
  434. package/src/clis/ones/my-tasks.ts +148 -0
  435. package/src/clis/ones/resolve-labels.ts +80 -0
  436. package/src/clis/ones/task-helpers.test.ts +14 -0
  437. package/src/clis/ones/task-helpers.ts +214 -0
  438. package/src/clis/ones/task.ts +79 -0
  439. package/src/clis/ones/tasks.ts +92 -0
  440. package/src/clis/ones/token-info.ts +46 -0
  441. package/src/clis/ones/worklog.test.ts +24 -0
  442. package/src/clis/ones/worklog.ts +306 -0
  443. package/src/clis/spotify/spotify.ts +328 -0
  444. package/src/clis/spotify/utils.test.ts +87 -0
  445. package/src/clis/spotify/utils.ts +92 -0
  446. package/src/clis/substack/utils.test.ts +54 -0
  447. package/src/clis/substack/utils.ts +10 -2
  448. package/src/clis/tieba/commands.test.ts +86 -0
  449. package/src/clis/tieba/hot.ts +52 -0
  450. package/src/clis/tieba/posts.ts +108 -0
  451. package/src/clis/tieba/read.ts +158 -0
  452. package/src/clis/tieba/search.ts +119 -0
  453. package/src/clis/tieba/utils.test.ts +322 -0
  454. package/src/clis/tieba/utils.ts +348 -0
  455. package/src/clis/v2ex/hot.yaml +4 -1
  456. package/src/clis/v2ex/latest.yaml +4 -1
  457. package/src/clis/v2ex/topic.yaml +6 -1
  458. package/src/clis/weixin/download.ts +95 -6
  459. package/src/clis/weread/book.ts +256 -13
  460. package/src/clis/weread/commands.test.ts +409 -0
  461. package/src/{weread-private-api-regression.test.ts → clis/weread/private-api-regression.test.ts} +108 -30
  462. package/src/clis/weread/search-regression.test.ts +440 -0
  463. package/src/clis/weread/search.ts +189 -9
  464. package/src/clis/weread/shelf.ts +20 -122
  465. package/src/clis/weread/utils.test.ts +81 -1
  466. package/src/clis/weread/utils.ts +293 -7
  467. package/src/clis/xiaohongshu/comments.test.ts +85 -9
  468. package/src/clis/xiaohongshu/comments.ts +76 -17
  469. package/src/clis/xiaohongshu/download.test.ts +96 -0
  470. package/src/clis/xiaohongshu/download.ts +83 -22
  471. package/src/clis/xiaohongshu/note-helpers.ts +25 -0
  472. package/src/clis/xiaohongshu/note.test.ts +164 -0
  473. package/src/clis/xiaohongshu/note.ts +86 -0
  474. package/src/clis/xiaohongshu/publish.test.ts +79 -1
  475. package/src/clis/xiaohongshu/publish.ts +84 -30
  476. package/src/clis/xiaohongshu/search.test.ts +11 -4
  477. package/src/clis/xiaohongshu/search.ts +13 -0
  478. package/src/clis/xiaohongshu/user-helpers.test.ts +23 -0
  479. package/src/clis/xiaohongshu/user-helpers.ts +4 -0
  480. package/src/clis/xueqiu/comments.test.ts +823 -0
  481. package/src/clis/xueqiu/comments.ts +461 -0
  482. package/src/clis/youtube/search.ts +57 -17
  483. package/src/clis/youtube/transcript.ts +2 -4
  484. package/src/clis/youtube/utils.test.ts +43 -0
  485. package/src/clis/youtube/utils.ts +69 -0
  486. package/src/clis/youtube/video.ts +16 -15
  487. package/src/clis/zhihu/question.test.ts +71 -0
  488. package/src/clis/zhihu/question.ts +27 -15
  489. package/src/clis/zsxq/dynamics.ts +60 -0
  490. package/src/clis/zsxq/groups.ts +41 -0
  491. package/src/clis/zsxq/search.test.ts +29 -0
  492. package/src/clis/zsxq/search.ts +54 -0
  493. package/src/clis/zsxq/topic.test.ts +34 -0
  494. package/src/clis/zsxq/topic.ts +68 -0
  495. package/src/clis/zsxq/topics.test.ts +29 -0
  496. package/src/clis/zsxq/topics.ts +36 -0
  497. package/src/clis/zsxq/utils.ts +351 -0
  498. package/src/commanderAdapter.test.ts +77 -0
  499. package/src/commanderAdapter.ts +8 -1
  500. package/src/commands/daemon.test.ts +238 -0
  501. package/src/commands/daemon.ts +135 -0
  502. package/src/completion.ts +2 -1
  503. package/src/constants.ts +3 -0
  504. package/src/daemon.test.ts +88 -0
  505. package/src/daemon.ts +26 -14
  506. package/src/discovery.ts +52 -2
  507. package/src/electron-apps.test.ts +50 -0
  508. package/src/electron-apps.ts +89 -0
  509. package/src/engine.test.ts +45 -9
  510. package/src/execution.ts +24 -19
  511. package/src/external-clis.yaml +17 -0
  512. package/src/idle-manager.ts +60 -0
  513. package/src/launcher.test.ts +67 -0
  514. package/src/launcher.ts +185 -0
  515. package/src/main.ts +3 -2
  516. package/src/registry.test.ts +15 -0
  517. package/src/registry.ts +32 -3
  518. package/src/runtime.ts +13 -7
  519. package/src/serialization.test.ts +19 -1
  520. package/src/serialization.ts +2 -0
  521. package/src/tui.test.ts +23 -0
  522. package/src/tui.ts +65 -0
  523. package/src/types.ts +5 -0
  524. package/src/weixin-download.test.ts +27 -0
  525. package/tests/e2e/band-auth.test.ts +20 -0
  526. package/tests/e2e/browser-auth-helpers.ts +18 -0
  527. package/tests/e2e/browser-auth.test.ts +35 -47
  528. package/tests/e2e/browser-public-extended.test.ts +6 -2
  529. package/tests/e2e/browser-public.test.ts +288 -0
  530. package/tests/e2e/management.test.ts +1 -1
  531. package/tests/e2e/plugin-management.test.ts +1 -1
  532. package/vitest.config.ts +1 -0
  533. package/chatwise-opencli.ps1 +0 -82
  534. package/dist/clis/chatwise/shared.d.ts +0 -2
  535. package/dist/clis/chatwise/shared.js +0 -6
  536. package/dist/weread-private-api-regression.test.d.ts +0 -1
  537. package/dist/weread-search-regression.test.d.ts +0 -1
  538. package/dist/weread-search-regression.test.js +0 -39
  539. package/src/clis/chatwise/shared.ts +0 -8
  540. package/src/weread-search-regression.test.ts +0 -44
package/dist/clis/xueqiu/comments.test.js ADDED
@@ -0,0 +1,696 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ const { mockWarn } = vi.hoisted(() => ({
3
+ mockWarn: vi.fn(),
4
+ }));
5
+ vi.mock('../../logger.js', () => ({
6
+ log: {
7
+ info: vi.fn(),
8
+ warn: mockWarn,
9
+ error: vi.fn(),
10
+ verbose: vi.fn(),
11
+ debug: vi.fn(),
12
+ step: vi.fn(),
13
+ stepResult: vi.fn(),
14
+ },
15
+ }));
16
+ import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '../../errors.js';
17
+ import { getRegistry } from '../../registry.js';
18
+ import { classifyXueqiuCommentsResponse, collectCommentRows, mergeUniqueCommentRows, normalizeCommentItem, normalizeSymbolInput, } from './comments.js';
19
+ const command = getRegistry().get('xueqiu/comments');
20
+ function createCommandPage(response) {
21
+ return {
22
+ goto: vi.fn().mockResolvedValue(undefined),
23
+ evaluate: vi.fn().mockResolvedValue(response),
24
+ };
25
+ }
26
+ describe('xueqiu comments', () => {
27
+ beforeEach(() => {
28
+ mockWarn.mockReset();
29
+ });
30
+ it('rejects blank symbol before any request is made', () => {
31
+ expect(() => normalizeSymbolInput(' ')).toThrow(ArgumentError);
32
+ });
33
+ it('rejects URL-like input before any request is made', () => {
34
+ expect(() => normalizeSymbolInput('https://xueqiu.com/S/SH600519')).toThrow(ArgumentError);
35
+ });
36
+ it('normalizes symbol by trimming and upper-casing it', () => {
37
+ expect(normalizeSymbolInput(' sh600519 ')).toBe('SH600519');
38
+ });
39
+ it('accepts supported US and HK-style symbols', () => {
40
+ expect(normalizeSymbolInput('aapl')).toBe('AAPL');
41
+ expect(normalizeSymbolInput('00700')).toBe('00700');
42
+ });
43
+ it('rejects obviously invalid symbols before any request is made', () => {
44
+ expect(() => normalizeSymbolInput('INVALID')).toThrow(ArgumentError);
45
+ });
46
+ it('classifies 401 responses as auth failures', () => {
47
+ expect(classifyXueqiuCommentsResponse({
48
+ status: 401,
49
+ contentType: 'application/json',
50
+ json: null,
51
+ textSnippet: '',
52
+ })).toMatchObject({ kind: 'auth' });
53
+ });
54
+ it('classifies html challenge pages as anti-bot failures', () => {
55
+ expect(classifyXueqiuCommentsResponse({
56
+ status: 200,
57
+ contentType: 'text/html',
58
+ json: null,
59
+ textSnippet: '<textarea id="renderData">{"_waf_bd8ce2ce37":"token"}</textarea>',
60
+ })).toMatchObject({ kind: 'anti-bot' });
61
+ });
62
+ it('classifies 403 html challenge pages as anti-bot failures', () => {
63
+ expect(classifyXueqiuCommentsResponse({
64
+ status: 403,
65
+ contentType: 'text/html',
66
+ json: null,
67
+ textSnippet: '<textarea id="renderData">{"_waf_bd8ce2ce37":"token"}</textarea>',
68
+ })).toMatchObject({ kind: 'anti-bot' });
69
+ });
70
+ it('classifies 403 html challenge pages without waf markers as anti-bot failures', () => {
71
+ expect(classifyXueqiuCommentsResponse({
72
+ status: 403,
73
+ contentType: 'text/html',
74
+ json: null,
75
+ textSnippet: '<html><body>security challenge required</body></html>',
76
+ })).toMatchObject({ kind: 'anti-bot' });
77
+ });
78
+ it('does not misclassify generic html error pages as anti-bot failures', () => {
79
+ expect(classifyXueqiuCommentsResponse({
80
+ status: 500,
81
+ contentType: 'text/html',
82
+ json: null,
83
+ textSnippet: '<html><body>server error</body></html>',
84
+ })).toMatchObject({ kind: 'unknown' });
85
+ });
86
+ it('classifies html login pages as auth failures', () => {
87
+ expect(classifyXueqiuCommentsResponse({
88
+ status: 200,
89
+ contentType: 'text/html',
90
+ json: null,
91
+ textSnippet: '<html><body>login required</body></html>',
92
+ })).toMatchObject({ kind: 'auth' });
93
+ });
94
+ it('classifies invalid-symbol json envelopes as argument failures', () => {
95
+ expect(classifyXueqiuCommentsResponse({
96
+ status: 200,
97
+ contentType: 'application/json',
98
+ json: { success: false, error: 'invalid symbol format' },
99
+ textSnippet: '',
100
+ })).toMatchObject({ kind: 'argument' });
101
+ });
102
+ it('does not misclassify required-field backend errors as auth failures', () => {
103
+ expect(classifyXueqiuCommentsResponse({
104
+ status: 200,
105
+ contentType: 'application/json',
106
+ json: { success: false, message: 'symbol is required' },
107
+ textSnippet: '',
108
+ })).toMatchObject({ kind: 'incompatible' });
109
+ });
110
+ it('classifies json responses without a usable list as incompatible', () => {
111
+ expect(classifyXueqiuCommentsResponse({
112
+ status: 200,
113
+ contentType: 'application/json',
114
+ json: { success: true, data: { next_max_id: 1 } },
115
+ textSnippet: '',
116
+ })).toMatchObject({ kind: 'incompatible' });
117
+ });
118
+ it('classifies empty discussion lists as empty results', () => {
119
+ expect(classifyXueqiuCommentsResponse({
120
+ status: 200,
121
+ contentType: 'application/json',
122
+ json: { list: [] },
123
+ textSnippet: '',
124
+ })).toMatchObject({ kind: 'empty' });
125
+ });
126
+ it('classifies unclear json error envelopes as incompatible', () => {
127
+ expect(classifyXueqiuCommentsResponse({
128
+ status: 200,
129
+ contentType: 'application/json',
130
+ json: { success: false, message: 'unexpected backend state' },
131
+ textSnippet: '',
132
+ })).toMatchObject({ kind: 'incompatible' });
133
+ });
134
+ it('deduplicates rows by stable id while preserving order', () => {
135
+ expect(mergeUniqueCommentRows([], [
136
+ { id: 'a', author: 'alice' },
137
+ { id: 'b', author: 'bob' },
138
+ { id: 'a', author: 'alice-duplicate' },
139
+ ])).toEqual([
140
+ { id: 'a', author: 'alice' },
141
+ { id: 'b', author: 'bob' },
142
+ ]);
143
+ });
144
+ it('normalizes one raw discussion item into a cleaned row', () => {
145
+ expect(normalizeCommentItem({
146
+ id: 123,
147
+ description: '<p>hello&nbsp;<b>world</b></p>',
148
+ created_at: 1700000000000,
149
+ user: { screen_name: 'alice', id: 99 },
150
+ reply_count: 2,
151
+ retweet_count: 3,
152
+ fav_count: 4,
153
+ })).toEqual({
154
+ id: '123',
155
+ author: 'alice',
156
+ text: 'hello world',
157
+ likes: 4,
158
+ replies: 2,
159
+ retweets: 3,
160
+ created_at: new Date(1700000000000).toISOString(),
161
+ url: 'https://xueqiu.com/99/123',
162
+ });
163
+ });
164
+ it('drops invalid created_at values instead of throwing', () => {
165
+ expect(normalizeCommentItem({
166
+ id: 456,
167
+ description: 'hello',
168
+ created_at: 'not-a-date',
169
+ user: { screen_name: 'bob', id: 100 },
170
+ })).toEqual({
171
+ id: '456',
172
+ author: 'bob',
173
+ text: 'hello',
174
+ likes: 0,
175
+ replies: 0,
176
+ retweets: 0,
177
+ created_at: null,
178
+ url: 'https://xueqiu.com/100/456',
179
+ });
180
+ });
181
+ it('drops object-like ids instead of turning them into fake identifiers', () => {
182
+ expect(normalizeCommentItem({
183
+ id: { broken: true },
184
+ description: 'hello',
185
+ created_at: 1700000000000,
186
+ user: { screen_name: 'eve', id: { broken: true } },
187
+ })).toEqual({
188
+ id: '',
189
+ author: 'eve',
190
+ text: 'hello',
191
+ likes: 0,
192
+ replies: 0,
193
+ retweets: 0,
194
+ created_at: new Date(1700000000000).toISOString(),
195
+ url: null,
196
+ });
197
+ });
198
+ it('normalizes invalid count fields to zero', () => {
199
+ expect(normalizeCommentItem({
200
+ id: 789,
201
+ description: 'hello',
202
+ created_at: 1700000000000,
203
+ user: { screen_name: 'carol', id: 101 },
204
+ reply_count: 'oops',
205
+ retweet_count: Infinity,
206
+ fav_count: '',
207
+ })).toEqual({
208
+ id: '789',
209
+ author: 'carol',
210
+ text: 'hello',
211
+ likes: 0,
212
+ replies: 0,
213
+ retweets: 0,
214
+ created_at: new Date(1700000000000).toISOString(),
215
+ url: 'https://xueqiu.com/101/789',
216
+ });
217
+ });
218
+ it('registers the xueqiu comments command', () => {
219
+ expect(command).toMatchObject({
220
+ site: 'xueqiu',
221
+ name: 'comments',
222
+ });
223
+ });
224
+ it('rejects blank symbol before navigating the page', async () => {
225
+ const page = {
226
+ goto: vi.fn(),
227
+ };
228
+ await expect(command.func(page, { symbol: ' ', limit: 5 })).rejects.toThrow(ArgumentError);
229
+ expect(page.goto).not.toHaveBeenCalled();
230
+ });
231
+ it('throws auth error when the first page responds with 401', async () => {
232
+ const page = createCommandPage({
233
+ status: 401,
234
+ contentType: 'application/json',
235
+ json: null,
236
+ textSnippet: '',
237
+ });
238
+ await expect(command.func(page, { symbol: 'sh600519', limit: 5 })).rejects.toThrow(AuthRequiredError);
239
+ expect(page.goto).toHaveBeenCalledWith('https://xueqiu.com');
240
+ });
241
+ it('rejects invalid symbols before navigating the page', async () => {
242
+ const page = {
243
+ goto: vi.fn(),
244
+ };
245
+ await expect(command.func(page, { symbol: 'INVALID', limit: 5 })).rejects.toThrow(ArgumentError);
246
+ expect(page.goto).not.toHaveBeenCalled();
247
+ });
248
+ it('rejects non-positive limit before navigating the page', async () => {
249
+ const page = {
250
+ goto: vi.fn(),
251
+ };
252
+ await expect(command.func(page, { symbol: 'SH600519', limit: 0 })).rejects.toThrow(ArgumentError);
253
+ await expect(command.func(page, { symbol: 'SH600519', limit: -1 })).rejects.toThrow(ArgumentError);
254
+ expect(page.goto).not.toHaveBeenCalled();
255
+ });
256
+ it('rejects limits above the supported maximum before navigating the page', async () => {
257
+ const page = {
258
+ goto: vi.fn(),
259
+ };
260
+ await expect(command.func(page, { symbol: 'SH600519', limit: 101 })).rejects.toThrow(ArgumentError);
261
+ expect(page.goto).not.toHaveBeenCalled();
262
+ });
263
+ it('throws empty-result error with normalized symbol when the first page is empty', async () => {
264
+ const page = createCommandPage({
265
+ status: 200,
266
+ contentType: 'application/json',
267
+ json: { list: [] },
268
+ textSnippet: '',
269
+ });
270
+ const rejection = command.func(page, { symbol: 'sh600519', limit: 5 });
271
+ await expect(rejection).rejects.toThrow(EmptyResultError);
272
+ await expect(rejection).rejects.toThrow('SH600519');
273
+ });
274
+ it('throws argument error when the first page reports an invalid symbol', async () => {
275
+ const page = createCommandPage({
276
+ status: 200,
277
+ contentType: 'application/json',
278
+ json: { success: false, error: 'invalid symbol format' },
279
+ textSnippet: '',
280
+ });
281
+ const rejection = command.func(page, { symbol: 'sh600519', limit: 5 });
282
+ await expect(rejection).rejects.toThrow(ArgumentError);
283
+ await expect(rejection).rejects.toThrow('SH600519');
284
+ });
285
+ it('throws a compact incompatible-response error when json shape is unusable', async () => {
286
+ const page = createCommandPage({
287
+ status: 200,
288
+ contentType: 'application/json',
289
+ json: { success: true, data: { next_max_id: 1 } },
290
+ textSnippet: '',
291
+ });
292
+ const rejection = command.func(page, { symbol: 'sh600519', limit: 5 });
293
+ await expect(rejection).rejects.toThrow(CommandExecutionError);
294
+ await expect(rejection).rejects.toThrow('Unexpected response');
295
+ });
296
+ it('throws auth-required error when the first page is an html challenge', async () => {
297
+ const page = createCommandPage({
298
+ status: 200,
299
+ contentType: 'text/html',
300
+ json: null,
301
+ textSnippet: '<textarea id="renderData">{"_waf_bd8ce2ce37":"token"}</textarea>',
302
+ });
303
+ await expect(command.func(page, { symbol: 'sh600519', limit: 5 })).rejects.toThrow(AuthRequiredError);
304
+ });
305
+ it('throws command-execution error when the first page fetch fails before any rows are available', async () => {
306
+ const page = createCommandPage({
307
+ status: 0,
308
+ contentType: 'text/plain',
309
+ json: null,
310
+ textSnippet: 'network failed',
311
+ });
312
+ const rejection = command.func(page, { symbol: 'sh600519', limit: 5 });
313
+ await expect(rejection).rejects.toThrow(CommandExecutionError);
314
+ await expect(rejection).rejects.toThrow('Unexpected response');
315
+ });
316
+ it('returns normalized rows when the first page includes discussion items', async () => {
317
+ const page = createCommandPage({
318
+ status: 200,
319
+ contentType: 'application/json',
320
+ json: {
321
+ list: [
322
+ {
323
+ id: 123,
324
+ description: '<p>hello&nbsp;<b>world</b></p>',
325
+ created_at: 1700000000000,
326
+ user: { screen_name: 'alice', id: 99 },
327
+ reply_count: 2,
328
+ retweet_count: 3,
329
+ fav_count: 4,
330
+ },
331
+ ],
332
+ },
333
+ textSnippet: '',
334
+ });
335
+ const result = await command.func(page, { symbol: 'sh600519', limit: 5 });
336
+ expect(result).toEqual([
337
+ {
338
+ author: 'alice',
339
+ text: 'hello world',
340
+ likes: 4,
341
+ replies: 2,
342
+ retweets: 3,
343
+ created_at: new Date(1700000000000).toISOString(),
344
+ url: 'https://xueqiu.com/99/123',
345
+ },
346
+ ]);
347
+ expect(Object.keys(result[0]).sort()).toEqual([
348
+ 'author',
349
+ 'created_at',
350
+ 'likes',
351
+ 'replies',
352
+ 'retweets',
353
+ 'text',
354
+ 'url',
355
+ ]);
356
+ });
357
+ it('collects later pages, deduplicates rows, and trims to limit', async () => {
358
+ const fetchPage = vi
359
+ .fn()
360
+ .mockResolvedValueOnce({
361
+ status: 200,
362
+ contentType: 'application/json',
363
+ json: {
364
+ list: [
365
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
366
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
367
+ ],
368
+ },
369
+ textSnippet: '',
370
+ })
371
+ .mockResolvedValueOnce({
372
+ status: 200,
373
+ contentType: 'application/json',
374
+ json: {
375
+ list: [
376
+ { id: 2, description: 'beta-duplicate', user: { screen_name: 'bob', id: 11 } },
377
+ { id: 3, description: 'gamma', user: { screen_name: 'carol', id: 12 } },
378
+ ],
379
+ },
380
+ textSnippet: '',
381
+ });
382
+ await expect(collectCommentRows({
383
+ symbol: 'SH600519',
384
+ limit: 3,
385
+ pageSize: 2,
386
+ maxRequests: 5,
387
+ fetchPage,
388
+ warn: mockWarn,
389
+ })).resolves.toMatchObject([
390
+ { id: '1', text: 'alpha' },
391
+ { id: '2', text: 'beta' },
392
+ { id: '3', text: 'gamma' },
393
+ ]);
394
+ expect(fetchPage).toHaveBeenCalledTimes(2);
395
+ expect(mockWarn).not.toHaveBeenCalled();
396
+ });
397
+ it('returns partial rows and emits warning when a later page fails', async () => {
398
+ const fetchPage = vi
399
+ .fn()
400
+ .mockResolvedValueOnce({
401
+ status: 200,
402
+ contentType: 'application/json',
403
+ json: {
404
+ list: [
405
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
406
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
407
+ ],
408
+ },
409
+ textSnippet: '',
410
+ })
411
+ .mockResolvedValueOnce({
412
+ status: 200,
413
+ contentType: 'text/html',
414
+ json: null,
415
+ textSnippet: '<textarea id="renderData">{"_waf_bd8ce2ce37":"token"}</textarea>',
416
+ });
417
+ await expect(collectCommentRows({
418
+ symbol: 'SH600519',
419
+ limit: 3,
420
+ pageSize: 2,
421
+ maxRequests: 5,
422
+ fetchPage,
423
+ warn: mockWarn,
424
+ })).resolves.toMatchObject([
425
+ { id: '1', text: 'alpha' },
426
+ { id: '2', text: 'beta' },
427
+ ]);
428
+ expect(mockWarn).toHaveBeenCalledTimes(1);
429
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('2/3'));
430
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('anti-bot'));
431
+ });
432
+ it('returns partial rows and emits warning when a later page has an unknown fetch failure', async () => {
433
+ const fetchPage = vi
434
+ .fn()
435
+ .mockResolvedValueOnce({
436
+ status: 200,
437
+ contentType: 'application/json',
438
+ json: {
439
+ list: [
440
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
441
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
442
+ ],
443
+ },
444
+ textSnippet: '',
445
+ })
446
+ .mockResolvedValueOnce({
447
+ status: 0,
448
+ contentType: 'text/plain',
449
+ json: null,
450
+ textSnippet: 'network failed',
451
+ });
452
+ await expect(collectCommentRows({
453
+ symbol: 'SH600519',
454
+ limit: 3,
455
+ pageSize: 2,
456
+ maxRequests: 5,
457
+ fetchPage,
458
+ warn: mockWarn,
459
+ })).resolves.toMatchObject([
460
+ { id: '1', text: 'alpha' },
461
+ { id: '2', text: 'beta' },
462
+ ]);
463
+ expect(mockWarn).toHaveBeenCalledTimes(1);
464
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('2/3'));
465
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('unknown request failure'));
466
+ });
467
+ it('ends pagination quietly when a later page returns an empty list', async () => {
468
+ const fetchPage = vi
469
+ .fn()
470
+ .mockResolvedValueOnce({
471
+ status: 200,
472
+ contentType: 'application/json',
473
+ json: {
474
+ list: [
475
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
476
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
477
+ ],
478
+ },
479
+ textSnippet: '',
480
+ })
481
+ .mockResolvedValueOnce({
482
+ status: 200,
483
+ contentType: 'application/json',
484
+ json: { list: [] },
485
+ textSnippet: '',
486
+ });
487
+ const result = await collectCommentRows({
488
+ symbol: 'SH600519',
489
+ limit: 3,
490
+ pageSize: 2,
491
+ maxRequests: 5,
492
+ fetchPage,
493
+ warn: mockWarn,
494
+ });
495
+ expect(result).toMatchObject([
496
+ { id: '1', text: 'alpha' },
497
+ { id: '2', text: 'beta' },
498
+ ]);
499
+ expect(fetchPage).toHaveBeenCalledTimes(2);
500
+ expect(mockWarn).not.toHaveBeenCalled();
501
+ });
502
+ it('returns partial rows and emits warning when a later page does not advance pagination', async () => {
503
+ const fetchPage = vi
504
+ .fn()
505
+ .mockResolvedValueOnce({
506
+ status: 200,
507
+ contentType: 'application/json',
508
+ json: {
509
+ list: [
510
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
511
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
512
+ ],
513
+ },
514
+ textSnippet: '',
515
+ })
516
+ .mockResolvedValueOnce({
517
+ status: 200,
518
+ contentType: 'application/json',
519
+ json: {
520
+ list: [
521
+ { id: 1, description: 'alpha-duplicate', user: { screen_name: 'alice', id: 10 } },
522
+ { id: 2, description: 'beta-duplicate', user: { screen_name: 'bob', id: 11 } },
523
+ ],
524
+ },
525
+ textSnippet: '',
526
+ });
527
+ const result = await collectCommentRows({
528
+ symbol: 'SH600519',
529
+ limit: 3,
530
+ pageSize: 2,
531
+ maxRequests: 5,
532
+ fetchPage,
533
+ warn: mockWarn,
534
+ });
535
+ expect(result).toMatchObject([
536
+ { id: '1', text: 'alpha' },
537
+ { id: '2', text: 'beta' },
538
+ ]);
539
+ expect(fetchPage).toHaveBeenCalledTimes(2);
540
+ expect(mockWarn).toHaveBeenCalledTimes(1);
541
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('2/3'));
542
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('pagination did not advance'));
543
+ });
544
+ it('drops rows without ids and warns when pagination cannot advance', async () => {
545
+ const fetchPage = vi
546
+ .fn()
547
+ .mockResolvedValueOnce({
548
+ status: 200,
549
+ contentType: 'application/json',
550
+ json: {
551
+ list: [
552
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
553
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
554
+ ],
555
+ },
556
+ textSnippet: '',
557
+ })
558
+ .mockResolvedValueOnce({
559
+ status: 200,
560
+ contentType: 'application/json',
561
+ json: {
562
+ list: [
563
+ { description: 'missing-id-a', user: { screen_name: 'carol', id: 12 } },
564
+ { description: 'missing-id-b', user: { screen_name: 'dave', id: 13 } },
565
+ ],
566
+ },
567
+ textSnippet: '',
568
+ });
569
+ const result = await collectCommentRows({
570
+ symbol: 'SH600519',
571
+ limit: 3,
572
+ pageSize: 2,
573
+ maxRequests: 5,
574
+ fetchPage,
575
+ warn: mockWarn,
576
+ });
577
+ expect(result).toMatchObject([
578
+ { id: '1', text: 'alpha' },
579
+ { id: '2', text: 'beta' },
580
+ ]);
581
+ expect(result).toHaveLength(2);
582
+ expect(fetchPage).toHaveBeenCalledTimes(2);
583
+ expect(mockWarn).toHaveBeenCalledTimes(1);
584
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('2/3'));
585
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('unknown request failure'));
586
+ });
587
+ it('continues pagination when a full page contains both valid rows and missing-id rows', async () => {
588
+ const fetchPage = vi
589
+ .fn()
590
+ .mockResolvedValueOnce({
591
+ status: 200,
592
+ contentType: 'application/json',
593
+ json: {
594
+ list: [
595
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
596
+ { description: 'missing-id', user: { screen_name: 'carol', id: 12 } },
597
+ ],
598
+ },
599
+ textSnippet: '',
600
+ })
601
+ .mockResolvedValueOnce({
602
+ status: 200,
603
+ contentType: 'application/json',
604
+ json: {
605
+ list: [
606
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
607
+ { id: 3, description: 'gamma', user: { screen_name: 'dave', id: 13 } },
608
+ ],
609
+ },
610
+ textSnippet: '',
611
+ });
612
+ const result = await collectCommentRows({
613
+ symbol: 'SH600519',
614
+ limit: 3,
615
+ pageSize: 2,
616
+ maxRequests: 5,
617
+ fetchPage,
618
+ warn: mockWarn,
619
+ });
620
+ expect(result).toMatchObject([
621
+ { id: '1', text: 'alpha' },
622
+ { id: '2', text: 'beta' },
623
+ { id: '3', text: 'gamma' },
624
+ ]);
625
+ expect(fetchPage).toHaveBeenCalledTimes(2);
626
+ expect(mockWarn).not.toHaveBeenCalled();
627
+ });
628
+ it('does not warn when a short final page contains only duplicate rows', async () => {
629
+ const fetchPage = vi
630
+ .fn()
631
+ .mockResolvedValueOnce({
632
+ status: 200,
633
+ contentType: 'application/json',
634
+ json: {
635
+ list: [
636
+ { id: 1, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
637
+ { id: 2, description: 'beta', user: { screen_name: 'bob', id: 11 } },
638
+ ],
639
+ },
640
+ textSnippet: '',
641
+ })
642
+ .mockResolvedValueOnce({
643
+ status: 200,
644
+ contentType: 'application/json',
645
+ json: {
646
+ list: [
647
+ { id: 2, description: 'beta-duplicate', user: { screen_name: 'bob', id: 11 } },
648
+ ],
649
+ },
650
+ textSnippet: '',
651
+ });
652
+ const result = await collectCommentRows({
653
+ symbol: 'SH600519',
654
+ limit: 5,
655
+ pageSize: 2,
656
+ maxRequests: 5,
657
+ fetchPage,
658
+ warn: mockWarn,
659
+ });
660
+ expect(result).toMatchObject([
661
+ { id: '1', text: 'alpha' },
662
+ { id: '2', text: 'beta' },
663
+ ]);
664
+ expect(fetchPage).toHaveBeenCalledTimes(2);
665
+ expect(mockWarn).not.toHaveBeenCalled();
666
+ });
667
+ it('emits warning when pagination stops at the safety cap', async () => {
668
+ let nextId = 1;
669
+ const fetchPage = vi
670
+ .fn()
671
+ .mockImplementation(async () => ({
672
+ status: 200,
673
+ contentType: 'application/json',
674
+ json: {
675
+ list: [
676
+ { id: nextId++, description: 'alpha', user: { screen_name: 'alice', id: 10 } },
677
+ { id: nextId++, description: 'beta', user: { screen_name: 'bob', id: 11 } },
678
+ ],
679
+ },
680
+ textSnippet: '',
681
+ }));
682
+ const result = await collectCommentRows({
683
+ symbol: 'SH600519',
684
+ limit: 12,
685
+ pageSize: 2,
686
+ maxRequests: 5,
687
+ fetchPage,
688
+ warn: mockWarn,
689
+ });
690
+ expect(result).toHaveLength(10);
691
+ expect(fetchPage).toHaveBeenCalledTimes(5);
692
+ expect(mockWarn).toHaveBeenCalledTimes(1);
693
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('10/12'));
694
+ expect(mockWarn).toHaveBeenCalledWith(expect.stringContaining('reached safety cap'));
695
+ });
696
+ });