@tikomni/skills 0.1.2 → 0.1.4

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 (480) hide show
  1. package/.skill-package-allowlist.txt +1 -3
  2. package/README.md +41 -49
  3. package/README.zh-CN.md +43 -51
  4. package/bin/tikomni-skills.js +2 -2
  5. package/env.example +37 -56
  6. package/package.json +7 -3
  7. package/skills/social-media-crawl/SKILL.md +53 -0
  8. package/skills/social-media-crawl/agents/openai.yaml +5 -0
  9. package/skills/social-media-crawl/references/contracts/output-envelope.md +22 -0
  10. package/skills/social-media-crawl/references/contracts/work-fact-card-fields.md +48 -0
  11. package/skills/social-media-crawl/references/guides/generic-mcp-objects.md +30 -0
  12. package/skills/social-media-crawl/references/mcp-usage-contract.md +30 -0
  13. package/skills/social-media-crawl/references/pipelines/douyin-creator-home.md +7 -0
  14. package/skills/social-media-crawl/references/pipelines/douyin-single-work.md +7 -0
  15. package/skills/social-media-crawl/references/pipelines/xiaohongshu-creator-home.md +7 -0
  16. package/skills/social-media-crawl/references/pipelines/xiaohongshu-single-work.md +7 -0
  17. package/skills/social-media-crawl/references/schemas/creator-profile.schema.json +33 -0
  18. package/skills/social-media-crawl/references/schemas/output-envelope.schema.json +41 -0
  19. package/skills/social-media-crawl/references/schemas/work-collection.schema.json +29 -0
  20. package/skills/social-media-crawl/references/schemas/work-fact-card.schema.json +67 -0
  21. package/skills/social-media-crawl/references/service-guides/u2-u3-mandatory-fallback.md +21 -0
  22. package/skills/social-media-crawl/scripts/__init__.py +2 -0
  23. package/skills/social-media-crawl/scripts/core/__init__.py +2 -0
  24. package/skills/{creator-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/asr_pipeline.py +252 -9
  25. package/skills/social-media-crawl/scripts/core/completeness.py +83 -0
  26. package/skills/{single-work-analysis → social-media-crawl}/scripts/core/config_loader.py +108 -167
  27. package/skills/social-media-crawl/scripts/core/mcp_dispatch.py +145 -0
  28. package/skills/social-media-crawl/scripts/core/object_detection.py +63 -0
  29. package/skills/{creator-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/poll_u2_task.py +6 -2
  30. package/skills/{single-work-analysis → social-media-crawl}/scripts/core/progress_report.py +32 -0
  31. package/skills/social-media-crawl/scripts/core/storage_router.py +160 -0
  32. package/skills/{creator-analysis → social-media-crawl}/scripts/core/tikomni_common.py +13 -3
  33. package/skills/social-media-crawl/scripts/core/u3_fallback.py +328 -0
  34. package/skills/social-media-crawl/scripts/pipelines/__init__.py +2 -0
  35. package/skills/social-media-crawl/scripts/pipelines/douyin_creator_home_helpers.py +35 -0
  36. package/skills/social-media-crawl/scripts/pipelines/douyin_platform_adapter.py +7 -0
  37. package/skills/{creator-analysis/scripts/author_home/asr → social-media-crawl/scripts/pipelines}/home_asr.py +1 -1
  38. package/skills/{creator-analysis/scripts/author_home/adapters → social-media-crawl/scripts/pipelines}/platform_adapters.py +8 -2
  39. package/skills/social-media-crawl/scripts/pipelines/run_douyin_creator_home.py +237 -0
  40. package/skills/{single-work-analysis/scripts/platform/douyin/run_douyin_single_video.py → social-media-crawl/scripts/pipelines/run_douyin_single_work.py} +282 -174
  41. package/skills/social-media-crawl/scripts/pipelines/run_xiaohongshu_creator_home.py +237 -0
  42. package/skills/{single-work-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py → social-media-crawl/scripts/pipelines/run_xiaohongshu_single_work.py} +290 -141
  43. package/skills/{creator-analysis/scripts/author_home → social-media-crawl/scripts/pipelines}/schema.py +1 -1
  44. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_creator_home_helpers.py +35 -0
  45. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_platform_adapter.py +7 -0
  46. package/skills/social-media-crawl/scripts/writers/__init__.py +1 -0
  47. package/skills/social-media-crawl/scripts/writers/write_work_fact_card.py +391 -0
  48. package/skills/creator-analysis/SKILL.md +0 -95
  49. package/skills/creator-analysis/agents/openai.yaml +0 -4
  50. package/skills/creator-analysis/env.example +0 -36
  51. package/skills/creator-analysis/references/api-capability-index.md +0 -92
  52. package/skills/creator-analysis/references/api-contracts/asr-api.md +0 -130
  53. package/skills/creator-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  54. package/skills/creator-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  55. package/skills/creator-analysis/references/api-contracts/demo-api.md +0 -717
  56. package/skills/creator-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  57. package/skills/creator-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  58. package/skills/creator-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  59. package/skills/creator-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  60. package/skills/creator-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  61. package/skills/creator-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  62. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  63. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  64. package/skills/creator-analysis/references/api-contracts/health-check.md +0 -69
  65. package/skills/creator-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  66. package/skills/creator-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  67. package/skills/creator-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  68. package/skills/creator-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  69. package/skills/creator-analysis/references/api-contracts/ios-shortcut.md +0 -44
  70. package/skills/creator-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  71. package/skills/creator-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  72. package/skills/creator-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  73. package/skills/creator-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  74. package/skills/creator-analysis/references/api-contracts/media-ingest-api.md +0 -126
  75. package/skills/creator-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  76. package/skills/creator-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  77. package/skills/creator-analysis/references/api-contracts/sora2-api.md +0 -2266
  78. package/skills/creator-analysis/references/api-contracts/temp-mail-api.md +0 -208
  79. package/skills/creator-analysis/references/api-contracts/threads-web-api.md +0 -897
  80. package/skills/creator-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  81. package/skills/creator-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  82. package/skills/creator-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  83. package/skills/creator-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  84. package/skills/creator-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  85. package/skills/creator-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  86. package/skills/creator-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  87. package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  88. package/skills/creator-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  89. package/skills/creator-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  90. package/skills/creator-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  91. package/skills/creator-analysis/references/api-contracts/twitter-web-api.md +0 -989
  92. package/skills/creator-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  93. package/skills/creator-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  94. package/skills/creator-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  95. package/skills/creator-analysis/references/api-contracts/weibo-web-api.md +0 -798
  96. package/skills/creator-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  97. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  98. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  99. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  100. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  101. package/skills/creator-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  102. package/skills/creator-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  103. package/skills/creator-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  104. package/skills/creator-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  105. package/skills/creator-analysis/references/api-tags/asr-api.md +0 -100
  106. package/skills/creator-analysis/references/api-tags/bilibili-app-api.md +0 -482
  107. package/skills/creator-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  108. package/skills/creator-analysis/references/api-tags/demo-api.md +0 -365
  109. package/skills/creator-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  110. package/skills/creator-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  111. package/skills/creator-analysis/references/api-tags/douyin-creator-api.md +0 -694
  112. package/skills/creator-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  113. package/skills/creator-analysis/references/api-tags/douyin-search-api.md +0 -1059
  114. package/skills/creator-analysis/references/api-tags/douyin-web-api.md +0 -3314
  115. package/skills/creator-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  116. package/skills/creator-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  117. package/skills/creator-analysis/references/api-tags/health-check.md +0 -40
  118. package/skills/creator-analysis/references/api-tags/hybrid-parsing.md +0 -57
  119. package/skills/creator-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  120. package/skills/creator-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  121. package/skills/creator-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  122. package/skills/creator-analysis/references/api-tags/ios-shortcut.md +0 -45
  123. package/skills/creator-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  124. package/skills/creator-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  125. package/skills/creator-analysis/references/api-tags/lemon8-app-api.md +0 -687
  126. package/skills/creator-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  127. package/skills/creator-analysis/references/api-tags/media-ingest-api.md +0 -112
  128. package/skills/creator-analysis/references/api-tags/pipixia-app-api.md +0 -721
  129. package/skills/creator-analysis/references/api-tags/reddit-app-api.md +0 -1057
  130. package/skills/creator-analysis/references/api-tags/sora2-api.md +0 -737
  131. package/skills/creator-analysis/references/api-tags/temp-mail-api.md +0 -136
  132. package/skills/creator-analysis/references/api-tags/threads-web-api.md +0 -472
  133. package/skills/creator-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  134. package/skills/creator-analysis/references/api-tags/tikhub-user-api.md +0 -253
  135. package/skills/creator-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  136. package/skills/creator-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  137. package/skills/creator-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  138. package/skills/creator-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  139. package/skills/creator-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  140. package/skills/creator-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  141. package/skills/creator-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  142. package/skills/creator-analysis/references/api-tags/toutiao-app-api.md +0 -220
  143. package/skills/creator-analysis/references/api-tags/toutiao-web-api.md +0 -96
  144. package/skills/creator-analysis/references/api-tags/twitter-web-api.md +0 -562
  145. package/skills/creator-analysis/references/api-tags/wechat-channels-api.md +0 -405
  146. package/skills/creator-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  147. package/skills/creator-analysis/references/api-tags/weibo-app-api.md +0 -851
  148. package/skills/creator-analysis/references/api-tags/weibo-web-api.md +0 -470
  149. package/skills/creator-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  150. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  151. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  152. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  153. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  154. package/skills/creator-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  155. package/skills/creator-analysis/references/api-tags/youtube-web-api.md +0 -934
  156. package/skills/creator-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  157. package/skills/creator-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  158. package/skills/creator-analysis/references/asr-orchestration.md +0 -33
  159. package/skills/creator-analysis/references/config-templates/defaults.yaml +0 -60
  160. package/skills/creator-analysis/references/contracts/creator-card-fields.md +0 -25
  161. package/skills/creator-analysis/references/contracts/work-card-fields.md +0 -68
  162. package/skills/creator-analysis/references/platform-guides/douyin.md +0 -54
  163. package/skills/creator-analysis/references/platform-guides/generic.md +0 -50
  164. package/skills/creator-analysis/references/platform-guides/xiaohongshu.md +0 -69
  165. package/skills/creator-analysis/references/prompt-contracts/asr-clean.md +0 -28
  166. package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md +0 -46
  167. package/skills/creator-analysis/references/prompt-contracts/author-analysis.md +0 -49
  168. package/skills/creator-analysis/references/prompt-contracts/cta.md +0 -24
  169. package/skills/creator-analysis/references/prompt-contracts/hook.md +0 -25
  170. package/skills/creator-analysis/references/prompt-contracts/insight.md +0 -47
  171. package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md +0 -30
  172. package/skills/creator-analysis/references/prompt-contracts/structure.md +0 -25
  173. package/skills/creator-analysis/references/prompt-contracts/style.md +0 -27
  174. package/skills/creator-analysis/references/prompt-contracts/summary.md +0 -29
  175. package/skills/creator-analysis/references/prompt-contracts/topic.md +0 -29
  176. package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json +0 -325
  177. package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json +0 -287
  178. package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json +0 -41
  179. package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  180. package/skills/creator-analysis/references/workflow.md +0 -23
  181. package/skills/creator-analysis/scripts/__init__.py +0 -0
  182. package/skills/creator-analysis/scripts/author_home/__init__.py +0 -0
  183. package/skills/creator-analysis/scripts/author_home/adapters/__init__.py +0 -0
  184. package/skills/creator-analysis/scripts/author_home/analyzers/__init__.py +0 -0
  185. package/skills/creator-analysis/scripts/author_home/analyzers/author_analysis_v2_support.py +0 -1165
  186. package/skills/creator-analysis/scripts/author_home/analyzers/prompt_first_analyzers.py +0 -447
  187. package/skills/creator-analysis/scripts/author_home/analyzers/sampled_work_batch_explainer.py +0 -331
  188. package/skills/creator-analysis/scripts/author_home/asr/__init__.py +0 -5
  189. package/skills/creator-analysis/scripts/author_home/builders/__init__.py +0 -0
  190. package/skills/creator-analysis/scripts/author_home/builders/home_builders.py +0 -213
  191. package/skills/creator-analysis/scripts/author_home/collectors/__init__.py +0 -0
  192. package/skills/creator-analysis/scripts/author_home/orchestrator/__init__.py +0 -0
  193. package/skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py +0 -834
  194. package/skills/creator-analysis/scripts/author_home/orchestrator/work_analysis_artifacts.py +0 -609
  195. package/skills/creator-analysis/scripts/core/__init__.py +0 -0
  196. package/skills/creator-analysis/scripts/core/analysis_pipeline.py +0 -133
  197. package/skills/creator-analysis/scripts/core/config_loader.py +0 -418
  198. package/skills/creator-analysis/scripts/core/progress_report.py +0 -111
  199. package/skills/creator-analysis/scripts/core/storage_router.py +0 -256
  200. package/skills/creator-analysis/scripts/pipeline/__init__.py +0 -0
  201. package/skills/creator-analysis/scripts/pipeline/asr/__init__.py +0 -0
  202. package/skills/creator-analysis/scripts/platform/__init__.py +0 -0
  203. package/skills/creator-analysis/scripts/platform/douyin/__init__.py +0 -0
  204. package/skills/creator-analysis/scripts/platform/douyin/run_douyin_single_video.py +0 -1208
  205. package/skills/creator-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  206. package/skills/creator-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +0 -2128
  207. package/skills/creator-analysis/scripts/writers/__init__.py +0 -0
  208. package/skills/creator-analysis/scripts/writers/write_author_homepage_samples.py +0 -107
  209. package/skills/creator-analysis/scripts/writers/write_benchmark_card.py +0 -1579
  210. package/skills/meta-capability/SKILL.md +0 -69
  211. package/skills/meta-capability/agents/openai.yaml +0 -4
  212. package/skills/meta-capability/env.example +0 -42
  213. package/skills/meta-capability/references/api-capability-index.md +0 -92
  214. package/skills/meta-capability/references/api-contracts/asr-api.md +0 -130
  215. package/skills/meta-capability/references/api-contracts/bilibili-app-api.md +0 -776
  216. package/skills/meta-capability/references/api-contracts/bilibili-web-api.md +0 -2017
  217. package/skills/meta-capability/references/api-contracts/demo-api.md +0 -717
  218. package/skills/meta-capability/references/api-contracts/douyin-app-v3-api.md +0 -3594
  219. package/skills/meta-capability/references/api-contracts/douyin-billboard-api.md +0 -2274
  220. package/skills/meta-capability/references/api-contracts/douyin-creator-api.md +0 -1575
  221. package/skills/meta-capability/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  222. package/skills/meta-capability/references/api-contracts/douyin-search-api.md +0 -4118
  223. package/skills/meta-capability/references/api-contracts/douyin-web-api.md +0 -5544
  224. package/skills/meta-capability/references/api-contracts/douyin-xingtu-api.md +0 -1916
  225. package/skills/meta-capability/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  226. package/skills/meta-capability/references/api-contracts/health-check.md +0 -69
  227. package/skills/meta-capability/references/api-contracts/hybrid-parsing.md +0 -78
  228. package/skills/meta-capability/references/api-contracts/instagram-v1-api.md +0 -2256
  229. package/skills/meta-capability/references/api-contracts/instagram-v2-api.md +0 -2011
  230. package/skills/meta-capability/references/api-contracts/instagram-v3-api.md +0 -2630
  231. package/skills/meta-capability/references/api-contracts/ios-shortcut.md +0 -44
  232. package/skills/meta-capability/references/api-contracts/kuaishou-app-api.md +0 -1518
  233. package/skills/meta-capability/references/api-contracts/kuaishou-web-api.md +0 -1242
  234. package/skills/meta-capability/references/api-contracts/lemon8-app-api.md +0 -1088
  235. package/skills/meta-capability/references/api-contracts/linkedin-web-api.md +0 -1949
  236. package/skills/meta-capability/references/api-contracts/media-ingest-api.md +0 -126
  237. package/skills/meta-capability/references/api-contracts/pipixia-app-api.md +0 -1142
  238. package/skills/meta-capability/references/api-contracts/reddit-app-api.md +0 -2025
  239. package/skills/meta-capability/references/api-contracts/sora2-api.md +0 -2266
  240. package/skills/meta-capability/references/api-contracts/temp-mail-api.md +0 -208
  241. package/skills/meta-capability/references/api-contracts/threads-web-api.md +0 -897
  242. package/skills/meta-capability/references/api-contracts/tikhub-downloader-api.md +0 -134
  243. package/skills/meta-capability/references/api-contracts/tikhub-user-api.md +0 -494
  244. package/skills/meta-capability/references/api-contracts/tiktok-ads-api.md +0 -5947
  245. package/skills/meta-capability/references/api-contracts/tiktok-analytics-api.md +0 -968
  246. package/skills/meta-capability/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  247. package/skills/meta-capability/references/api-contracts/tiktok-creator-api.md +0 -1951
  248. package/skills/meta-capability/references/api-contracts/tiktok-interaction-api.md +0 -742
  249. package/skills/meta-capability/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  250. package/skills/meta-capability/references/api-contracts/tiktok-web-api.md +0 -4448
  251. package/skills/meta-capability/references/api-contracts/toutiao-app-api.md +0 -342
  252. package/skills/meta-capability/references/api-contracts/toutiao-web-api.md +0 -143
  253. package/skills/meta-capability/references/api-contracts/twitter-web-api.md +0 -989
  254. package/skills/meta-capability/references/api-contracts/wechat-channels-api.md +0 -809
  255. package/skills/meta-capability/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  256. package/skills/meta-capability/references/api-contracts/weibo-app-api.md +0 -1547
  257. package/skills/meta-capability/references/api-contracts/weibo-web-api.md +0 -798
  258. package/skills/meta-capability/references/api-contracts/weibo-web-v2-api.md +0 -2459
  259. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  260. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  261. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  262. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  263. package/skills/meta-capability/references/api-contracts/xigua-app-v2-api.md +0 -489
  264. package/skills/meta-capability/references/api-contracts/youtube-web-api.md +0 -2636
  265. package/skills/meta-capability/references/api-contracts/youtube-web-v2-api.md +0 -2660
  266. package/skills/meta-capability/references/api-contracts/zhihu-web-api.md +0 -2315
  267. package/skills/meta-capability/references/api-tags/asr-api.md +0 -100
  268. package/skills/meta-capability/references/api-tags/bilibili-app-api.md +0 -482
  269. package/skills/meta-capability/references/api-tags/bilibili-web-api.md +0 -1267
  270. package/skills/meta-capability/references/api-tags/demo-api.md +0 -365
  271. package/skills/meta-capability/references/api-tags/douyin-app-v3-api.md +0 -2012
  272. package/skills/meta-capability/references/api-tags/douyin-billboard-api.md +0 -1428
  273. package/skills/meta-capability/references/api-tags/douyin-creator-api.md +0 -694
  274. package/skills/meta-capability/references/api-tags/douyin-creator-v2-api.md +0 -694
  275. package/skills/meta-capability/references/api-tags/douyin-search-api.md +0 -1059
  276. package/skills/meta-capability/references/api-tags/douyin-web-api.md +0 -3314
  277. package/skills/meta-capability/references/api-tags/douyin-xingtu-api.md +0 -935
  278. package/skills/meta-capability/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  279. package/skills/meta-capability/references/api-tags/health-check.md +0 -40
  280. package/skills/meta-capability/references/api-tags/hybrid-parsing.md +0 -57
  281. package/skills/meta-capability/references/api-tags/instagram-v1-api.md +0 -1224
  282. package/skills/meta-capability/references/api-tags/instagram-v2-api.md +0 -1147
  283. package/skills/meta-capability/references/api-tags/instagram-v3-api.md +0 -1123
  284. package/skills/meta-capability/references/api-tags/ios-shortcut.md +0 -45
  285. package/skills/meta-capability/references/api-tags/kuaishou-app-api.md +0 -846
  286. package/skills/meta-capability/references/api-tags/kuaishou-web-api.md +0 -551
  287. package/skills/meta-capability/references/api-tags/lemon8-app-api.md +0 -687
  288. package/skills/meta-capability/references/api-tags/linkedin-web-api.md +0 -1105
  289. package/skills/meta-capability/references/api-tags/media-ingest-api.md +0 -112
  290. package/skills/meta-capability/references/api-tags/pipixia-app-api.md +0 -721
  291. package/skills/meta-capability/references/api-tags/reddit-app-api.md +0 -1057
  292. package/skills/meta-capability/references/api-tags/sora2-api.md +0 -737
  293. package/skills/meta-capability/references/api-tags/temp-mail-api.md +0 -136
  294. package/skills/meta-capability/references/api-tags/threads-web-api.md +0 -472
  295. package/skills/meta-capability/references/api-tags/tikhub-downloader-api.md +0 -65
  296. package/skills/meta-capability/references/api-tags/tikhub-user-api.md +0 -253
  297. package/skills/meta-capability/references/api-tags/tiktok-ads-api.md +0 -1393
  298. package/skills/meta-capability/references/api-tags/tiktok-analytics-api.md +0 -179
  299. package/skills/meta-capability/references/api-tags/tiktok-app-v3-api.md +0 -3264
  300. package/skills/meta-capability/references/api-tags/tiktok-creator-api.md +0 -709
  301. package/skills/meta-capability/references/api-tags/tiktok-interaction-api.md +0 -366
  302. package/skills/meta-capability/references/api-tags/tiktok-shop-web-api.md +0 -663
  303. package/skills/meta-capability/references/api-tags/tiktok-web-api.md +0 -2516
  304. package/skills/meta-capability/references/api-tags/toutiao-app-api.md +0 -220
  305. package/skills/meta-capability/references/api-tags/toutiao-web-api.md +0 -96
  306. package/skills/meta-capability/references/api-tags/twitter-web-api.md +0 -562
  307. package/skills/meta-capability/references/api-tags/wechat-channels-api.md +0 -405
  308. package/skills/meta-capability/references/api-tags/wechat-media-platform-web-api.md +0 -431
  309. package/skills/meta-capability/references/api-tags/weibo-app-api.md +0 -851
  310. package/skills/meta-capability/references/api-tags/weibo-web-api.md +0 -470
  311. package/skills/meta-capability/references/api-tags/weibo-web-v2-api.md +0 -1405
  312. package/skills/meta-capability/references/api-tags/xiaohongshu-app-api.md +0 -534
  313. package/skills/meta-capability/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  314. package/skills/meta-capability/references/api-tags/xiaohongshu-web-api.md +0 -757
  315. package/skills/meta-capability/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  316. package/skills/meta-capability/references/api-tags/xigua-app-v2-api.md +0 -308
  317. package/skills/meta-capability/references/api-tags/youtube-web-api.md +0 -934
  318. package/skills/meta-capability/references/api-tags/youtube-web-v2-api.md +0 -717
  319. package/skills/meta-capability/references/api-tags/zhihu-web-api.md +0 -1384
  320. package/skills/meta-capability/references/config-templates/defaults.yaml +0 -18
  321. package/skills/meta-capability/references/dispatch.md +0 -27
  322. package/skills/meta-capability/references/execution-guidelines.md +0 -25
  323. package/skills/meta-capability/references/implemented-route-map.md +0 -177
  324. package/skills/meta-capability/references/service-guides/asr-u2-u3-fallback.md +0 -75
  325. package/skills/meta-capability/scripts/__init__.py +0 -1
  326. package/skills/meta-capability/scripts/call_route.py +0 -141
  327. package/skills/meta-capability/scripts/core/__init__.py +0 -1
  328. package/skills/meta-capability/scripts/core/bootstrap_env.py +0 -32
  329. package/skills/meta-capability/scripts/core/config_loader.py +0 -204
  330. package/skills/meta-capability/scripts/core/tikomni_common.py +0 -443
  331. package/skills/meta-capability/scripts/test_auth.py +0 -98
  332. package/skills/single-work-analysis/SKILL.md +0 -62
  333. package/skills/single-work-analysis/agents/openai.yaml +0 -4
  334. package/skills/single-work-analysis/env.example +0 -36
  335. package/skills/single-work-analysis/references/api-capability-index.md +0 -92
  336. package/skills/single-work-analysis/references/api-contracts/asr-api.md +0 -130
  337. package/skills/single-work-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  338. package/skills/single-work-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  339. package/skills/single-work-analysis/references/api-contracts/demo-api.md +0 -717
  340. package/skills/single-work-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  341. package/skills/single-work-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  342. package/skills/single-work-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  343. package/skills/single-work-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  344. package/skills/single-work-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  345. package/skills/single-work-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  346. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  347. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  348. package/skills/single-work-analysis/references/api-contracts/health-check.md +0 -69
  349. package/skills/single-work-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  350. package/skills/single-work-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  351. package/skills/single-work-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  352. package/skills/single-work-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  353. package/skills/single-work-analysis/references/api-contracts/ios-shortcut.md +0 -44
  354. package/skills/single-work-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  355. package/skills/single-work-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  356. package/skills/single-work-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  357. package/skills/single-work-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  358. package/skills/single-work-analysis/references/api-contracts/media-ingest-api.md +0 -126
  359. package/skills/single-work-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  360. package/skills/single-work-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  361. package/skills/single-work-analysis/references/api-contracts/sora2-api.md +0 -2266
  362. package/skills/single-work-analysis/references/api-contracts/temp-mail-api.md +0 -208
  363. package/skills/single-work-analysis/references/api-contracts/threads-web-api.md +0 -897
  364. package/skills/single-work-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  365. package/skills/single-work-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  366. package/skills/single-work-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  367. package/skills/single-work-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  368. package/skills/single-work-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  369. package/skills/single-work-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  370. package/skills/single-work-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  371. package/skills/single-work-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  372. package/skills/single-work-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  373. package/skills/single-work-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  374. package/skills/single-work-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  375. package/skills/single-work-analysis/references/api-contracts/twitter-web-api.md +0 -989
  376. package/skills/single-work-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  377. package/skills/single-work-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  378. package/skills/single-work-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  379. package/skills/single-work-analysis/references/api-contracts/weibo-web-api.md +0 -798
  380. package/skills/single-work-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  381. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  382. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  383. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  384. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  385. package/skills/single-work-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  386. package/skills/single-work-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  387. package/skills/single-work-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  388. package/skills/single-work-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  389. package/skills/single-work-analysis/references/api-tags/asr-api.md +0 -100
  390. package/skills/single-work-analysis/references/api-tags/bilibili-app-api.md +0 -482
  391. package/skills/single-work-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  392. package/skills/single-work-analysis/references/api-tags/demo-api.md +0 -365
  393. package/skills/single-work-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  394. package/skills/single-work-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  395. package/skills/single-work-analysis/references/api-tags/douyin-creator-api.md +0 -694
  396. package/skills/single-work-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  397. package/skills/single-work-analysis/references/api-tags/douyin-search-api.md +0 -1059
  398. package/skills/single-work-analysis/references/api-tags/douyin-web-api.md +0 -3314
  399. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  400. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  401. package/skills/single-work-analysis/references/api-tags/health-check.md +0 -40
  402. package/skills/single-work-analysis/references/api-tags/hybrid-parsing.md +0 -57
  403. package/skills/single-work-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  404. package/skills/single-work-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  405. package/skills/single-work-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  406. package/skills/single-work-analysis/references/api-tags/ios-shortcut.md +0 -45
  407. package/skills/single-work-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  408. package/skills/single-work-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  409. package/skills/single-work-analysis/references/api-tags/lemon8-app-api.md +0 -687
  410. package/skills/single-work-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  411. package/skills/single-work-analysis/references/api-tags/media-ingest-api.md +0 -112
  412. package/skills/single-work-analysis/references/api-tags/pipixia-app-api.md +0 -721
  413. package/skills/single-work-analysis/references/api-tags/reddit-app-api.md +0 -1057
  414. package/skills/single-work-analysis/references/api-tags/sora2-api.md +0 -737
  415. package/skills/single-work-analysis/references/api-tags/temp-mail-api.md +0 -136
  416. package/skills/single-work-analysis/references/api-tags/threads-web-api.md +0 -472
  417. package/skills/single-work-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  418. package/skills/single-work-analysis/references/api-tags/tikhub-user-api.md +0 -253
  419. package/skills/single-work-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  420. package/skills/single-work-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  421. package/skills/single-work-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  422. package/skills/single-work-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  423. package/skills/single-work-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  424. package/skills/single-work-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  425. package/skills/single-work-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  426. package/skills/single-work-analysis/references/api-tags/toutiao-app-api.md +0 -220
  427. package/skills/single-work-analysis/references/api-tags/toutiao-web-api.md +0 -96
  428. package/skills/single-work-analysis/references/api-tags/twitter-web-api.md +0 -562
  429. package/skills/single-work-analysis/references/api-tags/wechat-channels-api.md +0 -405
  430. package/skills/single-work-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  431. package/skills/single-work-analysis/references/api-tags/weibo-app-api.md +0 -851
  432. package/skills/single-work-analysis/references/api-tags/weibo-web-api.md +0 -470
  433. package/skills/single-work-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  434. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  435. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  436. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  437. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  438. package/skills/single-work-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  439. package/skills/single-work-analysis/references/api-tags/youtube-web-api.md +0 -934
  440. package/skills/single-work-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  441. package/skills/single-work-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  442. package/skills/single-work-analysis/references/asr-and-fallback.md +0 -20
  443. package/skills/single-work-analysis/references/config-templates/defaults.yaml +0 -58
  444. package/skills/single-work-analysis/references/contracts/work-card-fields.md +0 -41
  445. package/skills/single-work-analysis/references/platform-guides/douyin.md +0 -47
  446. package/skills/single-work-analysis/references/platform-guides/generic.md +0 -43
  447. package/skills/single-work-analysis/references/platform-guides/xiaohongshu.md +0 -54
  448. package/skills/single-work-analysis/references/prompt-contracts/asr-clean.md +0 -28
  449. package/skills/single-work-analysis/references/prompt-contracts/cta.md +0 -24
  450. package/skills/single-work-analysis/references/prompt-contracts/hook.md +0 -25
  451. package/skills/single-work-analysis/references/prompt-contracts/insight.md +0 -47
  452. package/skills/single-work-analysis/references/prompt-contracts/structure.md +0 -25
  453. package/skills/single-work-analysis/references/prompt-contracts/style.md +0 -27
  454. package/skills/single-work-analysis/references/prompt-contracts/summary.md +0 -29
  455. package/skills/single-work-analysis/references/prompt-contracts/topic.md +0 -29
  456. package/skills/single-work-analysis/references/schemas/work-card.schema.json +0 -39
  457. package/skills/single-work-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  458. package/skills/single-work-analysis/scripts/__init__.py +0 -0
  459. package/skills/single-work-analysis/scripts/core/__init__.py +0 -0
  460. package/skills/single-work-analysis/scripts/core/analysis_pipeline.py +0 -133
  461. package/skills/single-work-analysis/scripts/core/bootstrap_env.py +0 -35
  462. package/skills/single-work-analysis/scripts/core/extract_pipeline.py +0 -173
  463. package/skills/single-work-analysis/scripts/core/storage_router.py +0 -253
  464. package/skills/single-work-analysis/scripts/core/tikomni_common.py +0 -588
  465. package/skills/single-work-analysis/scripts/pipeline/__init__.py +0 -0
  466. package/skills/single-work-analysis/scripts/pipeline/asr/__init__.py +0 -0
  467. package/skills/single-work-analysis/scripts/pipeline/asr/asr_pipeline.py +0 -1189
  468. package/skills/single-work-analysis/scripts/pipeline/asr/poll_u2_task.py +0 -95
  469. package/skills/single-work-analysis/scripts/platform/__init__.py +0 -0
  470. package/skills/single-work-analysis/scripts/platform/douyin/__init__.py +0 -0
  471. package/skills/single-work-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +0 -224
  472. package/skills/single-work-analysis/scripts/platform/douyin/select_low_quality_video_url.py +0 -200
  473. package/skills/single-work-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  474. package/skills/single-work-analysis/scripts/writers/__init__.py +0 -0
  475. package/skills/single-work-analysis/scripts/writers/write_benchmark_card.py +0 -1402
  476. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/bootstrap_env.py +0 -0
  477. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/extract_pipeline.py +0 -0
  478. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/douyin_video_type_matrix.py +0 -0
  479. /package/skills/{creator-analysis/scripts/author_home/collectors → social-media-crawl/scripts/pipelines}/homepage_collectors.py +0 -0
  480. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/select_low_quality_video_url.py +0 -0
@@ -17,9 +17,9 @@ from scripts.core.bootstrap_env import bootstrap_for_direct_run
17
17
  bootstrap_for_direct_run(__file__, __package__)
18
18
 
19
19
  import argparse
20
- from typing import Any, Dict
20
+ from typing import Any, Callable, Dict, Optional
21
21
 
22
- from scripts.pipeline.asr.asr_pipeline import poll_u2_task_core
22
+ from scripts.core.asr_pipeline import poll_u2_task_core
23
23
  from scripts.core.tikomni_common import extract_error_reason, resolve_runtime, write_json_stdout
24
24
 
25
25
 
@@ -31,6 +31,8 @@ def poll_u2_task(
31
31
  task_id: str,
32
32
  poll_interval_sec: float,
33
33
  max_polls: int,
34
+ pending_timeout_sec: Optional[int] = None,
35
+ progress_callback: Optional[Callable[[Dict[str, Any]], None]] = None,
34
36
  ) -> Dict[str, Any]:
35
37
  return poll_u2_task_core(
36
38
  base_url=base_url,
@@ -39,6 +41,8 @@ def poll_u2_task(
39
41
  task_id=task_id,
40
42
  poll_interval_sec=poll_interval_sec,
41
43
  max_polls=max_polls,
44
+ pending_timeout_sec=pending_timeout_sec,
45
+ progress_callback=progress_callback,
42
46
  )
43
47
 
44
48
 
@@ -15,6 +15,10 @@ from datetime import datetime, timezone
15
15
  from typing import Any, Dict, Optional
16
16
 
17
17
 
18
+ def _normalize_http_summary(summary: Optional[Dict[str, Any]]) -> Dict[str, Any]:
19
+ return dict(summary) if isinstance(summary, dict) else {}
20
+
21
+
18
22
  VALID_EVENTS = {"started", "progress", "done", "failed"}
19
23
 
20
24
 
@@ -92,6 +96,32 @@ class ProgressReporter:
92
96
  def failed(self, *, stage: str, message: str = "", data: Optional[Dict[str, Any]] = None) -> None:
93
97
  self.emit("failed", stage=stage, message=message, data=data)
94
98
 
99
+ def http_event(
100
+ self,
101
+ *,
102
+ stage: str,
103
+ endpoint: Optional[str],
104
+ response: Optional[Dict[str, Any]],
105
+ route_label: Optional[str] = None,
106
+ summary: Optional[Dict[str, Any]] = None,
107
+ ) -> None:
108
+ response_obj = response if isinstance(response, dict) else {}
109
+ payload = _normalize_http_summary(summary)
110
+ payload.update(
111
+ {
112
+ "endpoint": str(endpoint or ""),
113
+ "route_label": str(route_label or ""),
114
+ "ok": bool(response_obj.get("ok")),
115
+ "status_code": response_obj.get("status_code"),
116
+ "request_id": response_obj.get("request_id"),
117
+ "error_reason": response_obj.get("error_reason"),
118
+ }
119
+ )
120
+ self.progress(stage=stage, message="http event", data=payload)
121
+
122
+ def heartbeat(self, *, stage: str, message: str = "", data: Optional[Dict[str, Any]] = None) -> None:
123
+ self.progress(stage=stage, message=message, data=data)
124
+
95
125
 
96
126
  def build_progress_reporter(
97
127
  *,
@@ -99,6 +129,7 @@ def build_progress_reporter(
99
129
  platform: str,
100
130
  content_kind: str,
101
131
  input_value: Optional[str] = None,
132
+ scope: str = "workflow",
102
133
  enabled: bool = True,
103
134
  ) -> ProgressReporter:
104
135
  return ProgressReporter(
@@ -106,6 +137,7 @@ def build_progress_reporter(
106
137
  platform=platform,
107
138
  content_kind=content_kind,
108
139
  run_id=f"{platform}.{content_kind}",
140
+ scope=scope,
109
141
  enabled=enabled,
110
142
  defaults={"input_value": str(input_value or "")[:240]},
111
143
  )
@@ -0,0 +1,160 @@
1
+ #!/usr/bin/env python3
2
+ """Storage routing helpers for work fact cards."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import re
7
+ from pathlib import Path
8
+ from typing import Any, Dict, List, Optional
9
+
10
+ DEFAULT_CARD_FILENAME_PATTERN = "{identifier}{ext}"
11
+ DEFAULT_JSON_FILENAME_PATTERN = "{timestamp}-{platform}-{identifier}{ext}"
12
+ _INVALID_FILENAME_CHARS = re.compile(r"[\\\\/:*?\"<>|]+")
13
+ _SPACE_RUN = re.compile(r"\s+")
14
+ _INVALID_AUTHOR_SLUGS = {"0", "unknown", "none", "null", "nil", "na", "n-a"}
15
+
16
+
17
+ def slugify_token(value: Any, fallback: str = "unknown") -> str:
18
+ text = str(value or "").strip().lower()
19
+ if not text:
20
+ text = fallback
21
+ text = text.replace(" ", "-")
22
+ text = _INVALID_FILENAME_CHARS.sub("-", text)
23
+ text = re.sub(r"[^a-z0-9_-]+", "-", text)
24
+ text = re.sub(r"-{2,}", "-", text).strip("-_")
25
+ return text or fallback
26
+
27
+
28
+ def resolve_card_filename_pattern(storage_config: Optional[Dict[str, Any]]) -> str:
29
+ if not isinstance(storage_config, dict):
30
+ return DEFAULT_CARD_FILENAME_PATTERN
31
+ naming_rules = storage_config.get("naming_rules")
32
+ if not isinstance(naming_rules, dict):
33
+ return DEFAULT_CARD_FILENAME_PATTERN
34
+ return str(naming_rules.get("card_filename_pattern") or "").strip() or DEFAULT_CARD_FILENAME_PATTERN
35
+
36
+
37
+ def resolve_json_filename_pattern(storage_config: Optional[Dict[str, Any]]) -> str:
38
+ if not isinstance(storage_config, dict):
39
+ return DEFAULT_JSON_FILENAME_PATTERN
40
+ naming_rules = storage_config.get("naming_rules")
41
+ if not isinstance(naming_rules, dict):
42
+ return DEFAULT_JSON_FILENAME_PATTERN
43
+ return str(naming_rules.get("json_filename_pattern") or "").strip() or DEFAULT_JSON_FILENAME_PATTERN
44
+
45
+
46
+ def render_output_filename(
47
+ *,
48
+ pattern: str,
49
+ context: Dict[str, Any],
50
+ default_filename: str,
51
+ default_ext: str,
52
+ ) -> str:
53
+ safe_context = {key: slugify_token(value, fallback=key) for key, value in context.items()}
54
+ safe_context["ext"] = default_ext
55
+ try:
56
+ rendered = str(pattern).format(**safe_context).strip()
57
+ except Exception:
58
+ rendered = default_filename
59
+ rendered = _INVALID_FILENAME_CHARS.sub("-", rendered)
60
+ rendered = _SPACE_RUN.sub("-", rendered)
61
+ rendered = rendered.replace("/", "-").replace("\\", "-").strip()
62
+ if not rendered:
63
+ rendered = default_filename
64
+ if not Path(rendered).suffix:
65
+ rendered = f"{rendered}{default_ext}"
66
+ return rendered
67
+
68
+
69
+ def _storage_routes_cfg(storage_config: Optional[Dict[str, Any]]) -> Dict[str, Any]:
70
+ if not isinstance(storage_config, dict):
71
+ return {}
72
+ routes = storage_config.get("storage_routes")
73
+ return routes if isinstance(routes, dict) else {}
74
+
75
+
76
+ def resolve_card_root(storage_config: Optional[Dict[str, Any]], explicit_card_root: Optional[str] = None) -> str:
77
+ if explicit_card_root:
78
+ candidate = Path(explicit_card_root).expanduser()
79
+ if not candidate.is_absolute():
80
+ raise ValueError("card_root must be an absolute path")
81
+ return str(candidate.resolve())
82
+
83
+ routes = _storage_routes_cfg(storage_config)
84
+ default_route = routes.get("default") if isinstance(routes.get("default"), dict) else {}
85
+ card_root = str(default_route.get("card_root") or "").strip()
86
+ if not card_root:
87
+ raise ValueError("missing_card_root")
88
+ return str(Path(card_root).expanduser().resolve())
89
+
90
+
91
+ def resolve_author_slug(platform: str, author_handle: str, platform_author_id: str) -> str:
92
+ handle_slug = slugify_token(author_handle, fallback="")
93
+ if handle_slug and handle_slug not in _INVALID_AUTHOR_SLUGS:
94
+ return handle_slug
95
+ author_id_slug = slugify_token(platform_author_id, fallback="")
96
+ if author_id_slug:
97
+ return author_id_slug
98
+ return f"{slugify_token(platform)}-unknown"
99
+
100
+
101
+ def resolve_author_directory_name(platform: str, author_handle: str, platform_author_id: str) -> str:
102
+ return f"{slugify_token(platform)}-{resolve_author_slug(platform, author_handle, platform_author_id)}"
103
+
104
+
105
+ def resolve_card_route_parts(
106
+ storage_config: Optional[Dict[str, Any]],
107
+ *,
108
+ platform: str,
109
+ author_slug: str,
110
+ ) -> List[str]:
111
+ routes = _storage_routes_cfg(storage_config)
112
+ card_type_routes = routes.get("card_type_routes") if isinstance(routes.get("card_type_routes"), dict) else {}
113
+ work_route = card_type_routes.get("work") if isinstance(card_type_routes.get("work"), dict) else {}
114
+ parts = work_route.get("parts") if isinstance(work_route.get("parts"), list) else ["内容系统", "作品库", "{platform}-{author_slug}"]
115
+ rendered: List[str] = []
116
+ context = {"platform": slugify_token(platform), "author_slug": author_slug}
117
+ for part in parts:
118
+ try:
119
+ rendered.append(str(part).format(**context))
120
+ except Exception:
121
+ rendered.append(str(part))
122
+ return rendered
123
+
124
+
125
+ def build_work_fact_card_paths(
126
+ *,
127
+ card_root: str,
128
+ platform: str,
129
+ platform_work_id: str,
130
+ author_handle: str,
131
+ platform_author_id: str,
132
+ storage_config: Optional[Dict[str, Any]],
133
+ fallback_identifier: str,
134
+ ) -> Dict[str, str]:
135
+ author_slug = resolve_author_slug(platform, author_handle, platform_author_id)
136
+ route_parts = resolve_card_route_parts(storage_config, platform=platform, author_slug=author_slug)
137
+ directory = Path(card_root).joinpath(*route_parts)
138
+ directory.mkdir(parents=True, exist_ok=True)
139
+
140
+ identifier = slugify_token(platform_work_id, fallback="") or slugify_token(fallback_identifier, fallback="unknown")
141
+ json_filename = render_output_filename(
142
+ pattern=resolve_card_filename_pattern(storage_config),
143
+ context={"identifier": identifier, "platform": platform, "author_slug": author_slug, "ext": ".json"},
144
+ default_filename=f"{identifier}.json",
145
+ default_ext=".json",
146
+ )
147
+ markdown_filename = render_output_filename(
148
+ pattern=resolve_card_filename_pattern(storage_config),
149
+ context={"identifier": identifier, "platform": platform, "author_slug": author_slug, "ext": ".md"},
150
+ default_filename=f"{identifier}.md",
151
+ default_ext=".md",
152
+ )
153
+ return {
154
+ "identifier": identifier,
155
+ "author_slug": author_slug,
156
+ "directory": str(directory),
157
+ "route": "/".join(route_parts),
158
+ "json_path": str(directory / json_filename),
159
+ "markdown_path": str(directory / markdown_filename),
160
+ }
@@ -69,9 +69,19 @@ def _resolve_env_file_path(env_file: Optional[str]) -> Path:
69
69
  return (skills_root / ".env").resolve()
70
70
 
71
71
  candidate = Path(env_file).expanduser()
72
- if not candidate.is_absolute():
73
- candidate = skills_root / candidate
74
- return candidate.resolve()
72
+ if candidate.is_absolute():
73
+ return candidate.resolve()
74
+
75
+ search_roots = [
76
+ Path.cwd(),
77
+ get_repo_root(),
78
+ skills_root,
79
+ ]
80
+ for root in search_roots:
81
+ resolved = (root / candidate).resolve()
82
+ if resolved.exists():
83
+ return resolved
84
+ return (Path.cwd() / candidate).resolve()
75
85
 
76
86
 
77
87
  def _infer_default_env_paths(primary_env_file: Optional[str]) -> Tuple[Path, Path]:
@@ -0,0 +1,328 @@
1
+ #!/usr/bin/env python3
2
+ """U3 public URL fallback helpers."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import mimetypes
7
+ import os
8
+ import tempfile
9
+ import urllib.error
10
+ import urllib.parse
11
+ import urllib.request
12
+ from pathlib import Path
13
+ from typing import Any, Dict, Optional
14
+
15
+ from scripts.core.tikomni_common import DEFAULT_USER_AGENT, call_json_api, normalize_text
16
+
17
+ DEFAULT_U3_PROVIDER = "oss"
18
+ DEFAULT_CONTENT_TYPE = "video/mp4"
19
+ DOWNLOAD_CHUNK_SIZE = 1024 * 1024
20
+
21
+
22
+ def _safe_name_from_url(source_url: str) -> str:
23
+ parsed = urllib.parse.urlparse(source_url)
24
+ name = Path(parsed.path).name.strip()
25
+ return name or "media.bin"
26
+
27
+
28
+ def _guess_content_type(file_name: str, header_value: Optional[str]) -> str:
29
+ header_text = normalize_text(header_value)
30
+ if header_text:
31
+ return header_text.split(";", 1)[0].strip() or DEFAULT_CONTENT_TYPE
32
+ guessed, _ = mimetypes.guess_type(file_name)
33
+ return guessed or DEFAULT_CONTENT_TYPE
34
+
35
+
36
+ def download_media_to_tempfile(
37
+ *,
38
+ source_url: str,
39
+ timeout_ms: int,
40
+ ) -> Dict[str, Any]:
41
+ parsed = urllib.parse.urlparse(source_url)
42
+ host = parsed.netloc.lower()
43
+ headers = {
44
+ "User-Agent": os.getenv("TIKOMNI_HTTP_USER_AGENT", DEFAULT_USER_AGENT),
45
+ "Accept": "*/*",
46
+ }
47
+ if "xhscdn.com" in host:
48
+ headers.update(
49
+ {
50
+ "Referer": "https://www.xiaohongshu.com/",
51
+ "Origin": "https://www.xiaohongshu.com",
52
+ "Range": "bytes=0-",
53
+ }
54
+ )
55
+ request = urllib.request.Request(
56
+ source_url,
57
+ headers=headers,
58
+ method="GET",
59
+ )
60
+
61
+ temp_path = ""
62
+ file_size = 0
63
+ request_id = None
64
+ try:
65
+ with urllib.request.urlopen(request, timeout=max(timeout_ms / 1000.0, 1.0)) as response:
66
+ final_url = response.geturl() or source_url
67
+ content_type = response.headers.get("Content-Type")
68
+ file_name = _safe_name_from_url(final_url)
69
+ suffix = Path(file_name).suffix or ".bin"
70
+ with tempfile.NamedTemporaryFile(prefix="tikomni-u3-", suffix=suffix, delete=False) as handle:
71
+ temp_path = handle.name
72
+ while True:
73
+ chunk = response.read(DOWNLOAD_CHUNK_SIZE)
74
+ if not chunk:
75
+ break
76
+ handle.write(chunk)
77
+ file_size += len(chunk)
78
+
79
+ return {
80
+ "ok": file_size > 0,
81
+ "file_path": temp_path,
82
+ "size_bytes": file_size,
83
+ "file_name": file_name,
84
+ "content_type": _guess_content_type(file_name, content_type),
85
+ "final_url": final_url,
86
+ "request_id": request_id,
87
+ "error_reason": None if file_size > 0 else "u3_download_empty",
88
+ }
89
+ except urllib.error.HTTPError as error:
90
+ return {
91
+ "ok": False,
92
+ "file_path": temp_path,
93
+ "size_bytes": file_size,
94
+ "file_name": _safe_name_from_url(source_url),
95
+ "content_type": DEFAULT_CONTENT_TYPE,
96
+ "final_url": source_url,
97
+ "request_id": request_id,
98
+ "error_reason": f"u3_download_http_{error.code}",
99
+ }
100
+ except Exception as error:
101
+ return {
102
+ "ok": False,
103
+ "file_path": temp_path,
104
+ "size_bytes": file_size,
105
+ "file_name": _safe_name_from_url(source_url),
106
+ "content_type": DEFAULT_CONTENT_TYPE,
107
+ "final_url": source_url,
108
+ "request_id": request_id,
109
+ "error_reason": f"u3_download_failed:{normalize_text(error)}",
110
+ }
111
+
112
+
113
+ def create_u3_upload(
114
+ *,
115
+ base_url: str,
116
+ token: str,
117
+ timeout_ms: int,
118
+ file_name: str,
119
+ content_type: str,
120
+ size_bytes: int,
121
+ provider: str = DEFAULT_U3_PROVIDER,
122
+ ) -> Dict[str, Any]:
123
+ return call_json_api(
124
+ base_url=base_url,
125
+ path="/api/u3/v1/uploads",
126
+ token=token,
127
+ method="POST",
128
+ timeout_ms=timeout_ms,
129
+ body={
130
+ "provider": provider,
131
+ "file_name": file_name,
132
+ "content_type": content_type,
133
+ "size_bytes": int(size_bytes),
134
+ },
135
+ )
136
+
137
+
138
+ def upload_file_to_presigned_url(
139
+ *,
140
+ upload_url: str,
141
+ upload_headers: Optional[Dict[str, Any]],
142
+ upload_method: str,
143
+ file_path: str,
144
+ content_type: str,
145
+ timeout_ms: int,
146
+ ) -> Dict[str, Any]:
147
+ try:
148
+ with open(file_path, "rb") as handle:
149
+ data = handle.read()
150
+
151
+ headers = {
152
+ "Content-Type": content_type or DEFAULT_CONTENT_TYPE,
153
+ "User-Agent": os.getenv("TIKOMNI_HTTP_USER_AGENT", DEFAULT_USER_AGENT),
154
+ }
155
+ if isinstance(upload_headers, dict):
156
+ for key, value in upload_headers.items():
157
+ header_key = str(key).strip()
158
+ if not header_key:
159
+ continue
160
+ headers[header_key] = str(value)
161
+
162
+ request = urllib.request.Request(
163
+ upload_url,
164
+ data=data,
165
+ headers=headers,
166
+ method=(upload_method or "PUT").upper(),
167
+ )
168
+ with urllib.request.urlopen(request, timeout=max(timeout_ms / 1000.0, 1.0)) as response:
169
+ status_code = response.getcode()
170
+ return {
171
+ "ok": 200 <= int(status_code) < 300,
172
+ "status_code": status_code,
173
+ "error_reason": None if 200 <= int(status_code) < 300 else f"u3_upload_http_{status_code}",
174
+ }
175
+ except urllib.error.HTTPError as error:
176
+ return {"ok": False, "status_code": error.code, "error_reason": f"u3_upload_http_{error.code}"}
177
+ except Exception as error:
178
+ return {"ok": False, "status_code": None, "error_reason": f"u3_upload_failed:{normalize_text(error)}"}
179
+
180
+
181
+ def complete_u3_upload(
182
+ *,
183
+ base_url: str,
184
+ token: str,
185
+ timeout_ms: int,
186
+ upload_id: str,
187
+ ) -> Dict[str, Any]:
188
+ return call_json_api(
189
+ base_url=base_url,
190
+ path=f"/api/u3/v1/uploads/{upload_id}/complete",
191
+ token=token,
192
+ method="POST",
193
+ timeout_ms=timeout_ms,
194
+ body={},
195
+ )
196
+
197
+
198
+ def cleanup_temp_file(file_path: Optional[str]) -> None:
199
+ if not file_path:
200
+ return
201
+ try:
202
+ Path(file_path).unlink(missing_ok=True)
203
+ except Exception:
204
+ pass
205
+
206
+
207
+ def run_u3_public_url_fallback(
208
+ *,
209
+ base_url: str,
210
+ token: str,
211
+ timeout_ms: int,
212
+ source_url: str,
213
+ provider: str = DEFAULT_U3_PROVIDER,
214
+ ) -> Dict[str, Any]:
215
+ download_bundle = download_media_to_tempfile(source_url=source_url, timeout_ms=timeout_ms)
216
+ trace = [
217
+ {
218
+ "step": "u3_download_source",
219
+ "ok": bool(download_bundle.get("ok")),
220
+ "error_reason": download_bundle.get("error_reason"),
221
+ "size_bytes": download_bundle.get("size_bytes"),
222
+ "content_type": download_bundle.get("content_type"),
223
+ "file_name": download_bundle.get("file_name"),
224
+ }
225
+ ]
226
+ if not download_bundle.get("ok"):
227
+ cleanup_temp_file(download_bundle.get("file_path"))
228
+ return {
229
+ "ok": False,
230
+ "error_reason": download_bundle.get("error_reason") or "u3_download_failed",
231
+ "public_url": "",
232
+ "trace": trace,
233
+ "request_id": download_bundle.get("request_id"),
234
+ }
235
+
236
+ create_response = create_u3_upload(
237
+ base_url=base_url,
238
+ token=token,
239
+ timeout_ms=timeout_ms,
240
+ provider=provider,
241
+ file_name=str(download_bundle.get("file_name") or "media.bin"),
242
+ content_type=str(download_bundle.get("content_type") or DEFAULT_CONTENT_TYPE),
243
+ size_bytes=int(download_bundle.get("size_bytes") or 0),
244
+ )
245
+ create_body = create_response.get("data") if isinstance(create_response.get("data"), dict) else {}
246
+ create_payload = create_body.get("data") if isinstance(create_body.get("data"), dict) else {}
247
+ upload_id = normalize_text(create_payload.get("upload_id"))
248
+ upload_url = normalize_text(create_payload.get("upload_url"))
249
+ upload_method = normalize_text(create_payload.get("upload_method")) or "PUT"
250
+ upload_headers = create_payload.get("upload_headers") if isinstance(create_payload.get("upload_headers"), dict) else {}
251
+ trace.append(
252
+ {
253
+ "step": "u3_create_upload",
254
+ "ok": bool(create_response.get("ok") and upload_id and upload_url),
255
+ "request_id": create_response.get("request_id"),
256
+ "status_code": create_response.get("status_code"),
257
+ "error_reason": create_response.get("error_reason"),
258
+ "upload_id": upload_id,
259
+ "provider": create_payload.get("provider"),
260
+ "upload_method": upload_method,
261
+ }
262
+ )
263
+ if not create_response.get("ok") or not upload_id or not upload_url:
264
+ cleanup_temp_file(download_bundle.get("file_path"))
265
+ return {
266
+ "ok": False,
267
+ "error_reason": create_response.get("error_reason") or "u3_create_upload_failed",
268
+ "public_url": "",
269
+ "trace": trace,
270
+ "request_id": create_response.get("request_id"),
271
+ }
272
+
273
+ upload_response = upload_file_to_presigned_url(
274
+ upload_url=upload_url,
275
+ upload_headers=upload_headers,
276
+ upload_method=upload_method,
277
+ file_path=str(download_bundle.get("file_path") or ""),
278
+ content_type=str(download_bundle.get("content_type") or DEFAULT_CONTENT_TYPE),
279
+ timeout_ms=timeout_ms,
280
+ )
281
+ trace.append(
282
+ {
283
+ "step": "u3_upload_object",
284
+ "ok": bool(upload_response.get("ok")),
285
+ "status_code": upload_response.get("status_code"),
286
+ "error_reason": upload_response.get("error_reason"),
287
+ }
288
+ )
289
+ if not upload_response.get("ok"):
290
+ cleanup_temp_file(download_bundle.get("file_path"))
291
+ return {
292
+ "ok": False,
293
+ "error_reason": upload_response.get("error_reason") or "u3_upload_failed",
294
+ "public_url": "",
295
+ "trace": trace,
296
+ "request_id": create_response.get("request_id"),
297
+ }
298
+
299
+ complete_response = complete_u3_upload(
300
+ base_url=base_url,
301
+ token=token,
302
+ timeout_ms=timeout_ms,
303
+ upload_id=upload_id,
304
+ )
305
+ complete_body = complete_response.get("data") if isinstance(complete_response.get("data"), dict) else {}
306
+ complete_payload = complete_body.get("data") if isinstance(complete_body.get("data"), dict) else {}
307
+ public_url = normalize_text(complete_payload.get("file_url"))
308
+ trace.append(
309
+ {
310
+ "step": "u3_complete_upload",
311
+ "ok": bool(complete_response.get("ok") and public_url),
312
+ "request_id": complete_response.get("request_id"),
313
+ "status_code": complete_response.get("status_code"),
314
+ "error_reason": complete_response.get("error_reason"),
315
+ "upload_id": upload_id,
316
+ "public_url_present": bool(public_url),
317
+ }
318
+ )
319
+ cleanup_temp_file(download_bundle.get("file_path"))
320
+ return {
321
+ "ok": bool(complete_response.get("ok") and public_url),
322
+ "error_reason": None if complete_response.get("ok") and public_url else (complete_response.get("error_reason") or "u3_complete_failed"),
323
+ "public_url": public_url,
324
+ "upload_id": upload_id,
325
+ "provider": complete_payload.get("provider") or provider,
326
+ "request_id": complete_response.get("request_id") or create_response.get("request_id"),
327
+ "trace": trace,
328
+ }
@@ -0,0 +1,2 @@
1
+ """Fixed pipelines for social-media-crawl."""
2
+
@@ -0,0 +1,35 @@
1
+ #!/usr/bin/env python3
2
+ """Douyin creator-home helper entrypoints."""
3
+
4
+ from __future__ import annotations
5
+
6
+ from typing import Any, Dict, List, Tuple
7
+
8
+ from scripts.pipelines.homepage_collectors import collect_douyin_author_home_raw
9
+ from scripts.pipelines.platform_adapters import adapt_douyin_author_home
10
+
11
+
12
+ def collect_and_adapt(
13
+ *,
14
+ input_value: str,
15
+ base_url: str,
16
+ token: str,
17
+ timeout_ms: int,
18
+ page_size: int,
19
+ pages_max: int,
20
+ max_items: int,
21
+ progress: Any = None,
22
+ ) -> Tuple[Dict[str, Any], Dict[str, Any], List[Dict[str, Any]], List[Dict[str, str]]]:
23
+ raw = collect_douyin_author_home_raw(
24
+ input_value=input_value,
25
+ base_url=base_url,
26
+ token=token,
27
+ timeout_ms=timeout_ms,
28
+ page_size=page_size,
29
+ pages_max=pages_max,
30
+ max_items=max_items,
31
+ progress=progress,
32
+ )
33
+ profile, works, missing = adapt_douyin_author_home(raw)
34
+ return raw, profile, works, missing
35
+
@@ -0,0 +1,7 @@
1
+ #!/usr/bin/env python3
2
+ """Compatibility wrapper for douyin platform adapter."""
3
+
4
+ from scripts.pipelines.platform_adapters import adapt_douyin_author_home
5
+
6
+ __all__ = ["adapt_douyin_author_home"]
7
+
@@ -10,7 +10,7 @@ from typing import Any, Dict, List, Optional, Tuple
10
10
 
11
11
  from scripts.core.progress_report import ProgressReporter
12
12
  from scripts.core.tikomni_common import normalize_text
13
- from scripts.pipeline.asr.asr_pipeline import (
13
+ from scripts.core.asr_pipeline import (
14
14
  clamp_u2_batch_submit_size,
15
15
  normalize_media_url,
16
16
  run_u2_asr_batch_with_timeout_retry,
@@ -6,9 +6,15 @@ from __future__ import annotations
6
6
  from datetime import datetime
7
7
  from typing import Any, Dict, List, Tuple
8
8
 
9
- from scripts.author_home.schema import build_author_profile, build_work_item, validate_author_profile, validate_work_item, validate_works_collection
9
+ from scripts.pipelines.schema import (
10
+ build_author_profile,
11
+ build_work_item,
12
+ validate_author_profile,
13
+ validate_work_item,
14
+ validate_works_collection,
15
+ )
10
16
  from scripts.core.tikomni_common import deep_find_all, deep_find_first
11
- from scripts.platform.douyin.select_low_quality_video_url import select_low_quality_video_url
17
+ from scripts.pipelines.select_low_quality_video_url import select_low_quality_video_url
12
18
 
13
19
 
14
20
  def _t(value: Any) -> str: