dsh-creation-mode 0.0.0-stage → 3.0.1

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 (369) hide show
  1. package/LICENSE +33 -0
  2. package/README.md +26 -2
  3. package/client.js +1581 -0
  4. package/cordis.patch.yml +106 -0
  5. package/data.js +386 -0
  6. package/flow.js +263 -0
  7. package/icon.svg +13 -0
  8. package/index.js +344 -0
  9. package/locale/en.json +6 -0
  10. package/locale/zh.json +6 -0
  11. package/package.json +53 -4
  12. package/references/audio.md +167 -0
  13. package/references/camera.md +168 -0
  14. package/references/color.md +272 -0
  15. package/references/copy.md +121 -0
  16. package/references/data-viz.md +189 -0
  17. package/references/effects.md +236 -0
  18. package/references/motion.md +322 -0
  19. package/references/particles.md +166 -0
  20. package/references/sequencing.md +143 -0
  21. package/references/text-animation.md +213 -0
  22. package/references/timbre.md +182 -0
  23. package/references/transitions.md +231 -0
  24. package/references/typography.md +276 -0
  25. package/stills/A1.jpg +0 -0
  26. package/stills/A2.jpg +0 -0
  27. package/stills/A3.jpg +0 -0
  28. package/stills/A4.jpg +0 -0
  29. package/stills/A5.jpg +0 -0
  30. package/stills/B1.jpg +0 -0
  31. package/stills/B2.jpg +0 -0
  32. package/stills/B3.jpg +0 -0
  33. package/stills/B4.jpg +0 -0
  34. package/stills/B5.jpg +0 -0
  35. package/stills/C1.jpg +0 -0
  36. package/stills/C2.jpg +0 -0
  37. package/stills/C3.jpg +0 -0
  38. package/stills/C4.jpg +0 -0
  39. package/stills/D1.jpg +0 -0
  40. package/stills/D2.jpg +0 -0
  41. package/stills/D3.jpg +0 -0
  42. package/stills/D4.jpg +0 -0
  43. package/stills/E1.jpg +0 -0
  44. package/stills/E2.jpg +0 -0
  45. package/stills/E3.jpg +0 -0
  46. package/stills/F1.jpg +0 -0
  47. package/stills/F2.jpg +0 -0
  48. package/stills/F3.jpg +0 -0
  49. package/stills/G1.jpg +0 -0
  50. package/stills/G2.jpg +0 -0
  51. package/stills/H1.jpg +0 -0
  52. package/stills/H10.jpg +0 -0
  53. package/stills/H11.jpg +0 -0
  54. package/stills/H12.jpg +0 -0
  55. package/stills/H2.jpg +0 -0
  56. package/stills/H3.jpg +0 -0
  57. package/stills/H4.jpg +0 -0
  58. package/stills/H5.jpg +0 -0
  59. package/stills/H6.jpg +0 -0
  60. package/stills/H7.jpg +0 -0
  61. package/stills/H8.jpg +0 -0
  62. package/stills/H9.jpg +0 -0
  63. package/stills/K1.jpg +0 -0
  64. package/stills/K10.jpg +0 -0
  65. package/stills/K11.jpg +0 -0
  66. package/stills/K12.jpg +0 -0
  67. package/stills/K13.jpg +0 -0
  68. package/stills/K14.jpg +0 -0
  69. package/stills/K15.jpg +0 -0
  70. package/stills/K16.jpg +0 -0
  71. package/stills/K17.jpg +0 -0
  72. package/stills/K18.jpg +0 -0
  73. package/stills/K19.jpg +0 -0
  74. package/stills/K2.jpg +0 -0
  75. package/stills/K20.jpg +0 -0
  76. package/stills/K21.jpg +0 -0
  77. package/stills/K22.jpg +0 -0
  78. package/stills/K23.jpg +0 -0
  79. package/stills/K24.jpg +0 -0
  80. package/stills/K25.jpg +0 -0
  81. package/stills/K26.jpg +0 -0
  82. package/stills/K27.jpg +0 -0
  83. package/stills/K28.jpg +0 -0
  84. package/stills/K29.jpg +0 -0
  85. package/stills/K3.jpg +0 -0
  86. package/stills/K30.jpg +0 -0
  87. package/stills/K31.jpg +0 -0
  88. package/stills/K32.jpg +0 -0
  89. package/stills/K33.jpg +0 -0
  90. package/stills/K34.jpg +0 -0
  91. package/stills/K35.jpg +0 -0
  92. package/stills/K36.jpg +0 -0
  93. package/stills/K37.jpg +0 -0
  94. package/stills/K38.jpg +0 -0
  95. package/stills/K4.jpg +0 -0
  96. package/stills/K5.jpg +0 -0
  97. package/stills/K6.jpg +0 -0
  98. package/stills/K7.jpg +0 -0
  99. package/stills/K8.jpg +0 -0
  100. package/stills/K9.jpg +0 -0
  101. package/stills/L1.jpg +0 -0
  102. package/stills/L10.jpg +0 -0
  103. package/stills/L11.jpg +0 -0
  104. package/stills/L12.jpg +0 -0
  105. package/stills/L13.jpg +0 -0
  106. package/stills/L14.jpg +0 -0
  107. package/stills/L15.jpg +0 -0
  108. package/stills/L16.jpg +0 -0
  109. package/stills/L17.jpg +0 -0
  110. package/stills/L18.jpg +0 -0
  111. package/stills/L19.jpg +0 -0
  112. package/stills/L2.jpg +0 -0
  113. package/stills/L20.jpg +0 -0
  114. package/stills/L21.jpg +0 -0
  115. package/stills/L22.jpg +0 -0
  116. package/stills/L23.jpg +0 -0
  117. package/stills/L24.jpg +0 -0
  118. package/stills/L25.jpg +0 -0
  119. package/stills/L26.jpg +0 -0
  120. package/stills/L27.jpg +0 -0
  121. package/stills/L28.jpg +0 -0
  122. package/stills/L29.jpg +0 -0
  123. package/stills/L3.jpg +0 -0
  124. package/stills/L30.jpg +0 -0
  125. package/stills/L31.jpg +0 -0
  126. package/stills/L32.jpg +0 -0
  127. package/stills/L33.jpg +0 -0
  128. package/stills/L34.jpg +0 -0
  129. package/stills/L35.jpg +0 -0
  130. package/stills/L36.jpg +0 -0
  131. package/stills/L37.jpg +0 -0
  132. package/stills/L38.jpg +0 -0
  133. package/stills/L39.jpg +0 -0
  134. package/stills/L4.jpg +0 -0
  135. package/stills/L40.jpg +0 -0
  136. package/stills/L41.jpg +0 -0
  137. package/stills/L42.jpg +0 -0
  138. package/stills/L43.jpg +0 -0
  139. package/stills/L44.jpg +0 -0
  140. package/stills/L45.jpg +0 -0
  141. package/stills/L46.jpg +0 -0
  142. package/stills/L47.jpg +0 -0
  143. package/stills/L48.jpg +0 -0
  144. package/stills/L49.jpg +0 -0
  145. package/stills/L5.jpg +0 -0
  146. package/stills/L50.jpg +0 -0
  147. package/stills/L51.jpg +0 -0
  148. package/stills/L52.jpg +0 -0
  149. package/stills/L53.jpg +0 -0
  150. package/stills/L54.jpg +0 -0
  151. package/stills/L55.jpg +0 -0
  152. package/stills/L56.jpg +0 -0
  153. package/stills/L57.jpg +0 -0
  154. package/stills/L58.jpg +0 -0
  155. package/stills/L59.jpg +0 -0
  156. package/stills/L6.jpg +0 -0
  157. package/stills/L7.jpg +0 -0
  158. package/stills/L8.jpg +0 -0
  159. package/stills/L9.jpg +0 -0
  160. package/stills/M1.jpg +0 -0
  161. package/stills/M10.jpg +0 -0
  162. package/stills/M11.jpg +0 -0
  163. package/stills/M12.jpg +0 -0
  164. package/stills/M13.jpg +0 -0
  165. package/stills/M14.jpg +0 -0
  166. package/stills/M15.jpg +0 -0
  167. package/stills/M16.jpg +0 -0
  168. package/stills/M17.jpg +0 -0
  169. package/stills/M18.jpg +0 -0
  170. package/stills/M19.jpg +0 -0
  171. package/stills/M2.jpg +0 -0
  172. package/stills/M20.jpg +0 -0
  173. package/stills/M21.jpg +0 -0
  174. package/stills/M22.jpg +0 -0
  175. package/stills/M23.jpg +0 -0
  176. package/stills/M24.jpg +0 -0
  177. package/stills/M25.jpg +0 -0
  178. package/stills/M26.jpg +0 -0
  179. package/stills/M27.jpg +0 -0
  180. package/stills/M28.jpg +0 -0
  181. package/stills/M29.jpg +0 -0
  182. package/stills/M3.jpg +0 -0
  183. package/stills/M30.jpg +0 -0
  184. package/stills/M31.jpg +0 -0
  185. package/stills/M32.jpg +0 -0
  186. package/stills/M33.jpg +0 -0
  187. package/stills/M34.jpg +0 -0
  188. package/stills/M35.jpg +0 -0
  189. package/stills/M36.jpg +0 -0
  190. package/stills/M37.jpg +0 -0
  191. package/stills/M38.jpg +0 -0
  192. package/stills/M39.jpg +0 -0
  193. package/stills/M4.jpg +0 -0
  194. package/stills/M40.jpg +0 -0
  195. package/stills/M5.jpg +0 -0
  196. package/stills/M6.jpg +0 -0
  197. package/stills/M7.jpg +0 -0
  198. package/stills/M8.jpg +0 -0
  199. package/stills/M9.jpg +0 -0
  200. package/stills/O1.jpg +0 -0
  201. package/stills/O10.jpg +0 -0
  202. package/stills/O11.jpg +0 -0
  203. package/stills/O12.jpg +0 -0
  204. package/stills/O13.jpg +0 -0
  205. package/stills/O14.jpg +0 -0
  206. package/stills/O15.jpg +0 -0
  207. package/stills/O16.jpg +0 -0
  208. package/stills/O17.jpg +0 -0
  209. package/stills/O18.jpg +0 -0
  210. package/stills/O19.jpg +0 -0
  211. package/stills/O2.jpg +0 -0
  212. package/stills/O20.jpg +0 -0
  213. package/stills/O21.jpg +0 -0
  214. package/stills/O22.jpg +0 -0
  215. package/stills/O23.jpg +0 -0
  216. package/stills/O24.jpg +0 -0
  217. package/stills/O25.jpg +0 -0
  218. package/stills/O26.jpg +0 -0
  219. package/stills/O27.jpg +0 -0
  220. package/stills/O28.jpg +0 -0
  221. package/stills/O29.jpg +0 -0
  222. package/stills/O3.jpg +0 -0
  223. package/stills/O30.jpg +0 -0
  224. package/stills/O31.jpg +0 -0
  225. package/stills/O32.jpg +0 -0
  226. package/stills/O33.jpg +0 -0
  227. package/stills/O34.jpg +0 -0
  228. package/stills/O35.jpg +0 -0
  229. package/stills/O36.jpg +0 -0
  230. package/stills/O37.jpg +0 -0
  231. package/stills/O38.jpg +0 -0
  232. package/stills/O39.jpg +0 -0
  233. package/stills/O4.jpg +0 -0
  234. package/stills/O40.jpg +0 -0
  235. package/stills/O41.jpg +0 -0
  236. package/stills/O42.jpg +0 -0
  237. package/stills/O43.jpg +0 -0
  238. package/stills/O44.jpg +0 -0
  239. package/stills/O45.jpg +0 -0
  240. package/stills/O46.jpg +0 -0
  241. package/stills/O47.jpg +0 -0
  242. package/stills/O48.jpg +0 -0
  243. package/stills/O49.jpg +0 -0
  244. package/stills/O5.jpg +0 -0
  245. package/stills/O50.jpg +0 -0
  246. package/stills/O51.jpg +0 -0
  247. package/stills/O52.jpg +0 -0
  248. package/stills/O53.jpg +0 -0
  249. package/stills/O54.jpg +0 -0
  250. package/stills/O55.jpg +0 -0
  251. package/stills/O56.jpg +0 -0
  252. package/stills/O57.jpg +0 -0
  253. package/stills/O58.jpg +0 -0
  254. package/stills/O59.jpg +0 -0
  255. package/stills/O6.jpg +0 -0
  256. package/stills/O60.jpg +0 -0
  257. package/stills/O61.jpg +0 -0
  258. package/stills/O62.jpg +0 -0
  259. package/stills/O63.jpg +0 -0
  260. package/stills/O64.jpg +0 -0
  261. package/stills/O65.jpg +0 -0
  262. package/stills/O66.jpg +0 -0
  263. package/stills/O67.jpg +0 -0
  264. package/stills/O68.jpg +0 -0
  265. package/stills/O69.jpg +0 -0
  266. package/stills/O7.jpg +0 -0
  267. package/stills/O70.jpg +0 -0
  268. package/stills/O71.jpg +0 -0
  269. package/stills/O72.jpg +0 -0
  270. package/stills/O73.jpg +0 -0
  271. package/stills/O74.jpg +0 -0
  272. package/stills/O75.jpg +0 -0
  273. package/stills/O76.jpg +0 -0
  274. package/stills/O77.jpg +0 -0
  275. package/stills/O78.jpg +0 -0
  276. package/stills/O79.jpg +0 -0
  277. package/stills/O8.jpg +0 -0
  278. package/stills/O80.jpg +0 -0
  279. package/stills/O81.jpg +0 -0
  280. package/stills/O82.jpg +0 -0
  281. package/stills/O83.jpg +0 -0
  282. package/stills/O84.jpg +0 -0
  283. package/stills/O85.jpg +0 -0
  284. package/stills/O86.jpg +0 -0
  285. package/stills/O87.jpg +0 -0
  286. package/stills/O88.jpg +0 -0
  287. package/stills/O89.jpg +0 -0
  288. package/stills/O9.jpg +0 -0
  289. package/stills/O90.jpg +0 -0
  290. package/stills/O91.jpg +0 -0
  291. package/stills/O92.jpg +0 -0
  292. package/stills/O93.jpg +0 -0
  293. package/stills/O94.jpg +0 -0
  294. package/stills/O95.jpg +0 -0
  295. package/stills/O96.jpg +0 -0
  296. package/stills/O97.jpg +0 -0
  297. package/stills/O98.jpg +0 -0
  298. package/stills/R1.jpg +0 -0
  299. package/stills/R2.jpg +0 -0
  300. package/stills/R3.jpg +0 -0
  301. package/stills/R4.jpg +0 -0
  302. package/stills/R5.jpg +0 -0
  303. package/stills/R6.jpg +0 -0
  304. package/stills/R7.jpg +0 -0
  305. package/stills/V1.jpg +0 -0
  306. package/stills/V10.jpg +0 -0
  307. package/stills/V11.jpg +0 -0
  308. package/stills/V12.jpg +0 -0
  309. package/stills/V13.jpg +0 -0
  310. package/stills/V14.jpg +0 -0
  311. package/stills/V15.jpg +0 -0
  312. package/stills/V2.jpg +0 -0
  313. package/stills/V3.jpg +0 -0
  314. package/stills/V4.jpg +0 -0
  315. package/stills/V5.jpg +0 -0
  316. package/stills/V6.jpg +0 -0
  317. package/stills/V7.jpg +0 -0
  318. package/stills/V8.jpg +0 -0
  319. package/stills/V9.jpg +0 -0
  320. package/stills/X1.jpg +0 -0
  321. package/stills/X10.jpg +0 -0
  322. package/stills/X11.jpg +0 -0
  323. package/stills/X12.jpg +0 -0
  324. package/stills/X13.jpg +0 -0
  325. package/stills/X14.jpg +0 -0
  326. package/stills/X15.jpg +0 -0
  327. package/stills/X16.jpg +0 -0
  328. package/stills/X17.jpg +0 -0
  329. package/stills/X18.jpg +0 -0
  330. package/stills/X19.jpg +0 -0
  331. package/stills/X2.jpg +0 -0
  332. package/stills/X20.jpg +0 -0
  333. package/stills/X21.jpg +0 -0
  334. package/stills/X22.jpg +0 -0
  335. package/stills/X23.jpg +0 -0
  336. package/stills/X24.jpg +0 -0
  337. package/stills/X25.jpg +0 -0
  338. package/stills/X26.jpg +0 -0
  339. package/stills/X27.jpg +0 -0
  340. package/stills/X28.jpg +0 -0
  341. package/stills/X29.jpg +0 -0
  342. package/stills/X3.jpg +0 -0
  343. package/stills/X30.jpg +0 -0
  344. package/stills/X31.jpg +0 -0
  345. package/stills/X4.jpg +0 -0
  346. package/stills/X5.jpg +0 -0
  347. package/stills/X6.jpg +0 -0
  348. package/stills/X7.jpg +0 -0
  349. package/stills/X8.jpg +0 -0
  350. package/stills/X9.jpg +0 -0
  351. package/stills/Z1.jpg +0 -0
  352. package/stills/Z10.jpg +0 -0
  353. package/stills/Z11.jpg +0 -0
  354. package/stills/Z12.jpg +0 -0
  355. package/stills/Z13.jpg +0 -0
  356. package/stills/Z14.jpg +0 -0
  357. package/stills/Z15.jpg +0 -0
  358. package/stills/Z2.jpg +0 -0
  359. package/stills/Z3.jpg +0 -0
  360. package/stills/Z4.jpg +0 -0
  361. package/stills/Z5.jpg +0 -0
  362. package/stills/Z6.jpg +0 -0
  363. package/stills/Z7.jpg +0 -0
  364. package/stills/Z8.jpg +0 -0
  365. package/stills/Z9.jpg +0 -0
  366. package/stills/approved.json +198 -0
  367. package/stills/index.json +1 -0
  368. package/styles.json +5090 -0
  369. package/tools.js +982 -0
package/flow.js ADDED
@@ -0,0 +1,263 @@
1
+ /**
2
+ * The creation workflow, injected as a system-prompt section.
3
+ *
4
+ * This is the real gate for the staged flow. Tools can only advise; the prompt is
5
+ * what keeps the Agent from jumping straight from "帮我做个视频" to writing code
6
+ * before the user has seen a reference still and signed off on a storyboard.
7
+ */
8
+
9
+ export const FLOW_SECTION_NAME = 'code-animation-flow';
10
+
11
+ /**
12
+ * Policy band: the harness places plan policy at 500 and tool documentation from
13
+ * 1000 up, so a workflow policy belongs just before those.
14
+ */
15
+ export const FLOW_SECTION_ORDER = 450;
16
+
17
+ export const FLOW_PROMPT = `## 创作流程
18
+
19
+ 在这个模式下你是导演,不是代码生成器。用户来找你是为了做出一个片子,不是要一段代码。
20
+ 按下面的顺序推进;每一步都要拿到用户明确的答复才能往下走。
21
+
22
+ ### 第 1 步 · 问清要做什么
23
+ 只要用户还没明确具体做什么,**必须立即调用 ask_user_question 工具**向用户提问,弹出交互选项卡片:
24
+ - 问题 1(必须):询问视频主题——"这个片子要表达什么主题?有没有核心文案或关键词?"
25
+ - 问题 2:画幅与平台(提供选项:横屏 16:9、竖屏 9:16、方形 1:1)
26
+ - 问题 3:时长(提供选项:3-5秒 极速冲击、8-10秒 标准短片、12秒以上 丰富叙事)
27
+
28
+ 绝对不要只用普通聊天文字问用户,必须调用 ask_user_question 工具弹出输入和选项!
29
+
30
+ ### 第 2 步 · 推荐风格,并把参考图画给用户看
31
+ 按第 1 步的答案挑 2–3 条候选,先 list_styles 确认它们存在,然后**必须调用 show_stills** 把参考静帧贴进对话。
32
+ 只用文字描述风格是不够的:用户要先看到画面才能判断。
33
+
34
+ 每条候选都要说清:编号、名称、画面长什么样、为什么适合这个主题。
35
+ 选风格时不要把多条约束机械叠加——主画风、运动方式、版式各选一条,各自负责一件事。
36
+
37
+ ### 第 3 步 · 等用户拍板风格(硬门禁)
38
+ 展示完 show_stills 之后,**必须立即调用 ask_user_question 工具**让用户点击选择风格!
39
+ 在 ask_user_question 的 options 里列出展示的各款风格(例如 label: "C1 水墨晕染"、label: "L19 写意山水"、label: "R6 东方赛博"、以及 label: "换一批风格")。
40
+ **绝对禁止用普通文本让用户回复,必须调用 ask_user_question 工具生成点击按钮!**
41
+
42
+ - 用户点击选定了 → get_style 取完整规范,然后**先取两份参考再写分镜**:
43
+ get_reference("color") 定调色板,get_reference("typography") 定字号阶梯。
44
+ 这两件事必须在分镜之前定,因为分镜里的「画面内容」和「字幕长度」都依赖它们——
45
+ 字号没定,你根本不知道一条字幕能放几个字。
46
+ - 定完不用给用户看,自己记住即可,进入第 4 步。
47
+ - 都不满意 → 回第 2 步换一批候选,或问清他想要什么感觉再选。
48
+ - 用户说"你定" → 你选最匹配的一条,但仍要把选择说清楚并给出理由。
49
+
50
+ ### 第 4 步 · 出分镜草稿与配乐卡点谱
51
+
52
+ **先取两份参考,再拆镜头:**
53
+
54
+ - get_reference("sequencing") —— 分镜就是时间轴。每场多长、节奏曲线怎么走、
55
+ 哪里密哪里疏、开场三秒怎么抓人、收尾留几秒,都在这一份里。**不先读它,
56
+ 分镜的时长和顺序一定是拍脑袋定的。**
57
+ - get_reference("audio") —— 分镜要同时给出配乐卡点谱,那就得知道卡点怎么落、
58
+ 重音怎么分档。
59
+
60
+ 拆成 3–8 个镜头,调用 save_storyboard 提交草稿。每个镜头写清:
61
+ - 起止时间(秒)与时长
62
+ - 画面内容:谁 / 在哪 / 在做什么
63
+ - 画面上的文字:字幕与标题,写原文
64
+ - 运镜与转场
65
+ - **镜头内关键动作与卡点(cues)**:除了镜头切点外,镜头内部若有关键视觉动作(如「0.8s 粒子汇聚成核心标题」、「2.4s 数据狂飙冲顶」、「4.1s 画面反转炸开」),必须在 cues 数组中精确标注时间秒数与类型(impact 重击、drop 段落转折、hit 清脆打击、rise 聚能上扬、whoosh 呼啸)!
66
+
67
+ #### 文案标准
68
+
69
+ 字幕与标题怎么写,见 get_reference("copy")。三条会被 save_storyboard 直接打回:
70
+ 单条字幕超过「镜头时长 × 5.5 字」、一条字幕说两件事、通篇没有一个可核查的具体信息。
71
+
72
+ #### 音乐风格提示词(music)的推导规则(无任何预设限制):
73
+ 不要使用机械死板的固定预设!音乐必须像专业电影原声一样,根据【视频画风 + 剧情情绪起伏】量身定制自由的音乐提示词:
74
+ 1. **调性对齐画风**:国风/水墨应是「古筝泛音悠扬、竹笛空灵铺底、兼有温润大堂鼓」;赛博霓虹应是「失真酸性贝斯、极速脉冲琶音、冷冽数字合成音」;扁平科普应是「轻快顿音拨弦、明朗马林巴、清脆鼓点」;史诗宏大应是「深邃弦乐群长音、大堂鼓重击与铜管齐鸣」。
75
+ 2. **情绪动态曲线**:开头如何铺垫、高潮在第几秒爆发、收尾如何淡出。
76
+ 3. **不许写低频扫频底鼓**:把正弦从一两百赫兹滑到三四十赫兹那种声音,听感像放屁,
77
+ 不是鼓。要重音就用固定频率的低正弦加鼓皮噪声,靠包络做冲击。这条没有例外。
78
+ 4. 把这段自由定制的音乐描述填入 save_storyboard 与 save_animation 的 music 字段,作为写 score_js 的依据。
79
+
80
+ **每个镜头切点与内部 cues 都会成为配乐的绝对卡点!** 你在 score_js 里按这些毫秒落声学重音与转场冲击,画面动、声音同时炸裂。
81
+
82
+ ### 第 5 步 · 等用户拍板分镜(硬门禁)
83
+ 提交分镜后,**必须调用 ask_user_question 工具**让用户确认分镜,提供选项(如 label: "确认分镜,开始制作"、label: "需要调整分镜或文案")。
84
+ 绝对禁止只用普通文本让用户回复!
85
+ 用户确认之前不要进入第 6 步。提了修改意见就改分镜并重新提交。
86
+
87
+ ### 第 6 步 · 写动画与配乐,然后交付
88
+
89
+ **两样东西都是你现写的代码,没有预设素材:**
90
+ 1. 动画 HTML(画面)
91
+ 2. 配乐合成代码(声音)
92
+
93
+ 现在动手写 HTML + Canvas 动画,然后调用 save_animation。
94
+
95
+ 画面必须满足:
96
+ - 页面 HTML 必须显式包含一个 <canvas> 元素,画面全部用 Canvas 2D 或 WebGL 绘制,绝对禁止写纯 DOM/CSS 动效(DOM 元素无法被浏览器 MediaRecorder 捕获导出为视频)。
97
+ - 必须实现 window.renderAt(t) 接口(t 为秒,同一时刻 t 渲染同一帧)。
98
+ - 画布可以按 1920×1080 或 1280×720 这样的固定像素画,但页面要能自适应:
99
+ 给 canvas 加 max-width:100% / max-height:100%,让它按原比例缩进预览框。
100
+ 写死 width:1280px 又没有任何约束,卡片里就会溢出、出滚动条、画面看不全。
101
+
102
+ #### 交付之后的修改:必须重新调用 save_animation
103
+
104
+ 卡片只在 save_animation 的返回里出现。**只改磁盘上的文件、或只回一句「改好了」,用户那边什么都不会变。**
105
+
106
+ 所以交付后用户提出任何改动——配乐、时长、字幕、画面、节奏——都按这个来:
107
+
108
+ 1. **只改一部分时,传 base_id。** 上一版的 id 在 save_animation 的返回值里。
109
+ 系统会读回上一版的正文与元数据,你只传这次要改的字段:
110
+
111
+ - 只换配乐 → base_id + 新的 score_js
112
+ - 只改画面 → base_id + 新的 html(配乐会自动沿用上一版)
113
+ - 改时长 → base_id + 新的 duration(会重新算切点)
114
+
115
+ 2. **整份重写时**,才把完整 html 与 score_js 一起传。
116
+ 3. 不要为了「省一次调用」去写文件然后说改完了——用户看不到,等于没改。
117
+ 4. **工作区只留最新一版。** 每次保存都会删掉上一版动画与上一版分镜,中间稿不保留;
118
+ 所以不要引用旧 id 的文件路径,也不要在回复里提「历史版本」。每次提交生成新卡片,
119
+ 旧卡片会随旧稿一起失效,这是预期行为。
120
+ 5. 修改阶段**不必重走风格与分镜门禁**;只有用户要换风格或改分镜结构时才回到第 3、5 步。
121
+ 6. 改完说清楚改了什么,别只说「已优化」。
122
+
123
+ #### 写动画前要取的参考
124
+
125
+ 前面几步已经取过 sequencing / color / typography / audio / copy,不用重取。
126
+ 下面这些是写代码时才用得上的,按这条片子实际需要取,**至少取 motion**:
127
+
128
+ | 调用 | 什么时候取 |
129
+ |---|---|
130
+ | get_reference("motion") | 必取。缓动、夹紧、帧预算、运动模糊、预备-动作-跟随 |
131
+ | get_reference("transitions") | 有 2 个以上镜头时。硬切/叠化/擦除,叠化会吃时长 |
132
+ | get_reference("text-animation") | 文字要动的时候。进场、出场、强调、数字滚动 |
133
+ | get_reference("effects") | 需要模糊、发光、故障、拖影、扫描线时 |
134
+ | get_reference("particles") | 用粒子做氛围或特效时 |
135
+ | get_reference("camera") | 推拉摇移、视差、伪 3D 时 |
136
+ | get_reference("data-viz") | 画面里有图表、数字对比时 |
137
+ | get_reference("timbre") | 写 score_js 之前。28 条音色配方 + 编曲层次 |
138
+
139
+ 一条 30 秒的片子,通常取 3–5 份就够。取太多反而抓不住重点。
140
+
141
+ #### 交付前自检
142
+
143
+ 保存之前,用取过的那几份参考末尾的自检清单过一遍。至少这三条必须成立:
144
+
145
+ 1. renderAt(0)、renderAt(duration/2)、renderAt(duration-0.05) 三帧都不是黑屏、
146
+ 不是静止、不是被截断的半截动作。
147
+ 2. 没有任何 Math.random() 或 Date.now()——它们会让导出和预览不一致。
148
+ 3. 每个 beats 里的 impact 在 score_js 里都有对应的声音事件。
149
+
150
+ #### 卡点:先把 beats 导出来,再写配乐
151
+
152
+ 这是整条流程里最要紧的一步。**动画代码是你自己写的,所以每个画面动作发生在第几秒,你本来就知道。**
153
+ 不要让它只存在于你的脑子里——写进 save_animation 的 beats 参数。
154
+
155
+ 写动画时,把每一个「画面值得被听见」的时刻记下来:
156
+
157
+ - 文字出现 / 砸下 / 逐字显完
158
+ - 元素爆开、聚合、断裂
159
+ - 镜头切换、故障闪烁、闪白
160
+ - 数字跳到终点、进度条走满
161
+ - 最重要那一帧的定格
162
+
163
+ 每条给 \`time\`(精确到 0.01 秒,如 2.87 而不是 3)、\`type\`、\`label\`、\`power\`(0–1)。
164
+
165
+ \`\`\`json
166
+ "beats": [
167
+ { "time": 0.41, "type": "rise", "label": "砖墙从暗处浮现", "power": 0.5 },
168
+ { "time": 1.24, "type": "hit", "label": "第一个字母通电", "power": 0.7 },
169
+ { "time": 2.87, "type": "impact", "label": "故障闪烁撕裂", "power": 1.0 },
170
+ { "time": 3.72, "type": "impact", "label": "中文标题砸下", "power": 0.95 },
171
+ { "time": 4.55, "type": "hit", "label": "副标题浮现", "power": 0.6 }
172
+ ]
173
+ \`\`\`
174
+
175
+ **beats 会原样传进 score_js 的 beats 形参,时间误差是 0 毫秒**(已实测)。
176
+ 你的配乐只要写 \`for (const b of beats) 打击(b.time, b.power)\` 就是精确卡点,不需要猜。
177
+
178
+ 一次完整动作最好是:**rise 在峰值前 0.3–0.5 秒起势,impact 正好落在峰值上,之后留一点余响。**
179
+
180
+ ##### power 决定这是普通卡点还是高潮卡点
181
+
182
+ 引擎按 power 自动分两档处理铺底,**你必须把 power 标对**,否则高潮会被当普通处理:
183
+
184
+ | power | 档位 | 引擎对铺底做什么 | 用在哪 |
185
+ |---|---|---|---|
186
+ | 0.0–0.71 | 普通卡点 | 重音前后轻微下压,**律动不停** | 文字出现、元素入场、一般转场 |
187
+ | 0.72–1.0 | **高潮卡点** | 铺底提前 200–320ms **渐出**到近乎无声,重音落下后回升 | 全片最重的那一下、故障炸裂、标题砸下 |
188
+
189
+ 普通卡点的意思是「音乐里该有的一个重拍」,不该打断律动;
190
+ 高潮卡点的意思是「此刻除了这一下什么都不该响」。
191
+
192
+ **一片里高潮卡点不要超过 2–3 个**,多了就不稀罕了。其余都属于普通卡点。
193
+
194
+ 渐出不是硬切——引擎已经把铺底做成分段下降(快→慢→贴近静音),听感上是音乐让位而不是断带。
195
+ 你不要在 score_js 里自己再做一遍这件事,只要把 power 标对即可。
196
+
197
+ #### 配乐:必须由你当场写 score_js
198
+
199
+ save_animation 的 score_js 参数是一段 Web Audio 合成代码,直接决定这条片子听起来是什么声音。
200
+ **它是必填项,没有兜底引擎**:不写就没有声音,保存会直接报错打回。没有现成音色库可以套,
201
+ 每一段配乐都要按这条片子的节奏、情绪、卡点现写。
202
+
203
+ 代码是一个**函数体**(不要写 \`function(...)\` 头,不要 return),可用形参:
204
+ - \`ctx\` — OfflineAudioContext
205
+ - \`dest\` — 输出节点:**重音、打击乐接到这里**,不受铺底渐出影响
206
+ - \`bed\` — 铺底总线:**持续的旋律、和弦、律动接到这里**,引擎会在卡点前后对它做渐出/下压
207
+ - \`duration\` — 片长(秒)
208
+ - \`beats\` — 你刚导出的精确节奏点,\`[{time, type, label, power}]\`,**卡点用这个**
209
+ - \`cuts\` — 分镜切点秒数数组(比 beats 粗,只在没有 beats 时用)
210
+ - \`cues\` — 分镜里的镜头重点
211
+ - \`rand()\` — 可复现随机
212
+ - \`hz(midi)\` — MIDI 转频率
213
+
214
+ **分线是卡点能不能听出来的关键**:铺底全接 \`bed\`,重音全接 \`dest\`。
215
+ 如果两者都接到同一个总线,引擎就没法在卡点前让铺底让位,重音会被淹没。
216
+
217
+ 写法要点:
218
+ - 用 ctx.createOscillator / createBufferSource / createBiquadFilter / createGain / createConvolver / createWaveShaper 现场搭音色。
219
+ - **每一个 beats 时间点都必须有明确的声音事件**,直接用 start(b.time) 落在那个秒数上。这是卡点的全部意义。
220
+ - 重击之前让铺底让位(那 0.1 秒内把伴奏增益压到 0.2 左右),重击才听得出来。
221
+ - 背景铺底要比卡点轻很多(大约 1/10),否则重击会被淹掉。
222
+ - 所有节点必须在 duration 内收尾,函数里不要 await。
223
+
224
+ #### 音色配方
225
+
226
+ 28 条配方和三个完整代码示例在 get_reference("timbre"),写 score_js 前先取。
227
+ 里面含一条硬禁令:任何音色都不许做低频扫频(正弦从一两百赫兹滑到三四十赫兹),
228
+ 要重音就给固定频率的低正弦加鼓皮噪声,让包络做冲击。
229
+
230
+ ### 不要自己造轮子
231
+
232
+ 出片这件事已经由插件接管,以下做法都是错的,会白费功夫:
233
+
234
+ - **不要写录制脚本**(录屏、逐帧截图、record.mjs 之类)——导出一键完成。
235
+ - **不要找 ffmpeg**,不要检查它是否安装,不要建议用户去装。本流程完全不需要它。
236
+ - **不要用 playwright / puppeteer** 打开动画去截图。
237
+ - **不要手工拼视频文件**,也不要写自定义的 muxer。
238
+
239
+ 你要做的只有两件事:写 HTML、写配乐代码,然后调用 save_animation。预览、合成、导出都由对话末尾的卡片完成。
240
+
241
+ ### 交付物在哪里
242
+
243
+ - 动画 HTML 由 save_animation 落盘,卡片内可直接预览。
244
+ - 导出视频时,浏览器会把成片**写入会话工作目录下的 code-animation/ 子目录**,卡片上会显示完整路径。
245
+ - 不要为了"让用户能找到文件"而额外搬运或复制文件;卡片已经显示了准确路径。
246
+
247
+ ### 唯一可以跳步的情况
248
+ 用户在一句话里已经把风格编号和内容都给全了("用 B3 做一个 3 秒的粒子聚形,内容是 XXX")。
249
+ 这时可以跳过第 1–3 步,但**第 4、5 步的分镜确认不能跳过**。`;
250
+
251
+ /**
252
+ * Register the workflow section.
253
+ * @param systemPrompt - the \`ctx.systemPrompt\` registry of the realm that should own it.
254
+ * @returns a disposer, or undefined when the registry is unavailable.
255
+ */
256
+ export function registerFlowSection(systemPrompt) {
257
+ if (!systemPrompt) return undefined;
258
+ return systemPrompt.section({
259
+ name: FLOW_SECTION_NAME,
260
+ order: FLOW_SECTION_ORDER,
261
+ text: FLOW_PROMPT,
262
+ });
263
+ }
package/icon.svg ADDED
@@ -0,0 +1,13 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Code Animation Studio">
2
+ <defs>
3
+ <linearGradient id="cas-g" x1="0" y1="0" x2="1" y2="1">
4
+ <stop offset="0" stop-color="#ff8a3d"/>
5
+ <stop offset="1" stop-color="#e0457b"/>
6
+ </linearGradient>
7
+ </defs>
8
+ <rect x="6" y="10" width="52" height="44" rx="9" fill="url(#cas-g)"/>
9
+ <path d="M6 24h52" stroke="#12121a" stroke-opacity=".28" stroke-width="2"/>
10
+ <path d="M17 10l7 12M30 10l7 12M43 10l7 12" stroke="#12121a" stroke-opacity=".28" stroke-width="2" stroke-linecap="round"/>
11
+ <path d="M26 34.5v11.5l9.5-5.75z" fill="#fff"/>
12
+ <circle cx="47" cy="43" r="3.2" fill="#fff" fill-opacity=".9"/>
13
+ </svg>
package/index.js ADDED
@@ -0,0 +1,344 @@
1
+ /**
2
+ * Host half of the Code Animation Studio bundle.
3
+ *
4
+ * The bundle is used twice, on purpose, with different configs:
5
+ * - once at the profile root (`tools: false`) to serve catalog assets and the
6
+ * animations the Agent wrote;
7
+ * - once inside the 创作模式 preset (`tools: true`) to mount the creation tools
8
+ * in the sessions created under that mode.
9
+ *
10
+ * Routes are profile-wide, so only the root row registers them; the preset row is
11
+ * mounted per preset and would otherwise collide on the same prefix.
12
+ */
13
+ import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
14
+ import { isAbsolute, join, resolve } from 'node:path';
15
+ import { fileURLToPath } from 'node:url';
16
+
17
+ import { BUILD_REV, EXPORT_DIR_NAME, OUTPUT_DIR, STILLS_DIR, TOOL_NAMES, catalog, isApproved } from './data.js';
18
+ import { registerFlowSection } from './flow.js';
19
+ import { registerCreationTools } from './tools.js';
20
+
21
+ const PREFIX = '/code-animation-api';
22
+ const LOG_FILE = fileURLToPath(new URL('./api.log', import.meta.url));
23
+ /** Rendered clips reach the host as one body; 8s of 1080p is tens of megabytes. */
24
+ const EXPORT_MAX_BYTES = 512 * 1024 * 1024;
25
+
26
+ function trace(line) {
27
+ try {
28
+ appendFileSync(LOG_FILE, `${new Date().toISOString()} ${line}\n`);
29
+ } catch {
30
+ /* diagnostics must never break a request */
31
+ }
32
+ }
33
+
34
+ function send(res, status, body, type) {
35
+ res.writeHead(status, {
36
+ 'content-type': type || 'text/plain; charset=utf-8',
37
+ 'cache-control': 'no-store',
38
+ 'content-length': Buffer.byteLength(body),
39
+ });
40
+ res.end(body);
41
+ }
42
+
43
+ /** One exact id, no traversal: the id grammar is the allowlist. */
44
+ function safeId(raw) {
45
+ const id = String(raw || '').split('?')[0];
46
+ return /^[A-Za-z0-9_-]{1,80}$/.test(id) ? id : '';
47
+ }
48
+
49
+ /** Keep a client-supplied name to a single safe path segment. */
50
+ function safeFileName(raw, fallback) {
51
+ const base = String(raw || '').split(/[\\/]/).pop() || '';
52
+ const cleaned = base.replace(/[^\w.\-\u4e00-\u9fa5]+/g, '_').replace(/^[._]+/, '').slice(0, 120);
53
+ return cleaned || fallback;
54
+ }
55
+
56
+ /**
57
+ * Resolve where an export lands.
58
+ *
59
+ * The session directory is used when the caller supplies one, so the clip appears
60
+ * beside the user's other files rather than inside the plugin package. A supplied
61
+ * path is accepted only when it is absolute, already a directory, and the final
62
+ * target stays inside it.
63
+ */
64
+ function resolveExportDir(requested, fallbackRoot) {
65
+ // If user explicitly picked a directory, honor it directly
66
+ if (typeof requested === 'string' && requested.trim()) {
67
+ const chosen = resolve(requested.trim());
68
+ if (isAbsolute(chosen) && existsSync(chosen)) {
69
+ try {
70
+ if (statSync(chosen).isDirectory()) return chosen;
71
+ } catch {}
72
+ }
73
+ }
74
+
75
+ // Fallback to session working directory / code-animation
76
+ if (typeof fallbackRoot === 'string' && fallbackRoot.trim()) {
77
+ const root = resolve(fallbackRoot.trim());
78
+ if (isAbsolute(root) && existsSync(root)) {
79
+ try {
80
+ if (statSync(root).isDirectory()) return join(root, EXPORT_DIR_NAME);
81
+ } catch {}
82
+ }
83
+ }
84
+
85
+ return join(OUTPUT_DIR, 'exports');
86
+ }
87
+
88
+ /**
89
+ * 让动画在预览框里按原比例缩放到完整可见。
90
+ *
91
+ * 生成的动画多半把画布写成固定像素(`canvas{width:1280px;height:720px}`),而卡片
92
+ * 里的预览框只有几百像素宽,于是 iframe 内部出现滚动条、画面被切掉。
93
+ *
94
+ * 补的这层样式只影响显示尺寸:canvas 的 width/height 属性(像素缓冲区)不动,
95
+ * 所以 recordAnimation 走 captureStream 导出时拿到的仍是原始分辨率。
96
+ *
97
+ * 用 !important 是因为动画自己那条 `canvas{width:1280px}` 和本规则同等特异性,
98
+ * 而它的 <style> 可能排在后面;不压制的话自适应会失效。
99
+ */
100
+ const FIT_STYLE = [
101
+ '<style data-creation-mode-fit>',
102
+ 'html,body{margin:0;padding:0;height:100%;overflow:hidden;background:#05070b}',
103
+ 'body{display:flex;align-items:center;justify-content:center}',
104
+ 'canvas{max-width:100%!important;max-height:100%!important;',
105
+ 'width:auto!important;height:auto!important;object-fit:contain}',
106
+ '</style>',
107
+ ].join('');
108
+
109
+ function fitToFrame(html) {
110
+ if (/<\/head>/i.test(html)) return html.replace(/<\/head>/i, `${FIT_STYLE}</head>`);
111
+ if (/<body[^>]*>/i.test(html)) return html.replace(/<body[^>]*>/i, (tag) => `${tag}${FIT_STYLE}`);
112
+ return FIT_STYLE + html;
113
+ }
114
+
115
+ /** 导出目录里记录「本插件写过哪些成片」的清单,只用来删自己写过的文件。 */
116
+ const EXPORT_INDEX = '.creation-mode-exports.json';
117
+
118
+ /**
119
+ * 只留成品:导出目录里也只保留这一次的成片。
120
+ *
121
+ * 只删清单里记过的、由本插件自己写出来的文件,用户放在同一目录的其他视频不会被碰。
122
+ * 清单本身用点号开头,导出卡片里不会显示它。
123
+ *
124
+ * @returns 被删掉的旧成片文件名。
125
+ */
126
+ function pruneExports(dir, keepName) {
127
+ const index = join(dir, EXPORT_INDEX);
128
+ let previous = [];
129
+ try {
130
+ const parsed = JSON.parse(readFileSync(index, 'utf8'));
131
+ if (Array.isArray(parsed?.files)) previous = parsed.files.filter((n) => typeof n === 'string');
132
+ } catch { /* 第一次导出:还没有清单 */ }
133
+
134
+ const removed = [];
135
+ for (const name of previous) {
136
+ if (name === keepName) continue;
137
+ const file = join(dir, name);
138
+ if (!existsSync(file)) continue;
139
+ try { unlinkSync(file); removed.push(name); } catch { /* 删不掉就留着 */ }
140
+ }
141
+
142
+ try {
143
+ writeFileSync(index, JSON.stringify({ files: [keepName] }, null, 2), 'utf8');
144
+ } catch { /* 清单写不了不影响导出本身 */ }
145
+ return removed;
146
+ }
147
+
148
+ function readBody(req, limit) {
149
+ return new Promise((resolvePromise, reject) => {
150
+ const chunks = [];
151
+ let size = 0;
152
+ req.on('data', (chunk) => {
153
+ size += chunk.length;
154
+ if (size > limit) {
155
+ reject(new Error(`请求体超过上限 ${Math.round(limit / 1048576)} MB`));
156
+ req.destroy();
157
+ return;
158
+ }
159
+ chunks.push(chunk);
160
+ });
161
+ req.on('end', () => resolvePromise(Buffer.concat(chunks)));
162
+ req.on('error', reject);
163
+ });
164
+ }
165
+
166
+ /**
167
+ * No `inject` declaration: the same module is mounted twice with different configs,
168
+ * and each placement only owns one half. Declaring either service would leave the
169
+ * other placement waiting forever, so both are read lazily and each half no-ops
170
+ * when its service is absent.
171
+ */
172
+ export function apply(ctx, config = {}) {
173
+ const withTools = config.tools !== false;
174
+ const withRoutes = config.routes !== false;
175
+
176
+ if (withTools) {
177
+ // `ctx.inject` runs the callback once the service is present, and again if it is
178
+ // replaced. Reading `ctx.get('tools')` directly races plugin activation order and
179
+ // silently skips registration when the service is not ready yet.
180
+ ctx.inject(['tools'], (scoped) => {
181
+ scoped.effect(() => registerCreationTools({
182
+ tools: scoped.tools,
183
+ getAttachments: () => scoped.get('attachments'),
184
+ }), 'code-animation-studio:tools');
185
+ });
186
+
187
+ // The staged flow is a policy, so it lives in the prompt rather than in a tool.
188
+ ctx.inject(['systemPrompt'], (scoped) => {
189
+ scoped.effect(() => registerFlowSection(scoped.systemPrompt), 'code-animation-studio:flow');
190
+ });
191
+ }
192
+
193
+ if (withRoutes) {
194
+ ctx.inject(['webServer'], (scoped) => {
195
+ const handler = async (req, res) => {
196
+ const url = req.url || '';
197
+ try {
198
+ if (url.startsWith(`${PREFIX}/health`) && req.method === 'GET') {
199
+ return send(res, 200, JSON.stringify({
200
+ ok: true,
201
+ rev: BUILD_REV,
202
+ tools: TOOL_NAMES,
203
+ styles: catalog().styles.length,
204
+ stills: catalog().styles.filter((s) => s.still).length,
205
+ }), 'application/json; charset=utf-8');
206
+ }
207
+
208
+ // Rendered clips land where the user can find them, and the absolute path
209
+ // is echoed back so the card can show exactly where the file went.
210
+ if (url.startsWith(`${PREFIX}/export`) && req.method === 'POST') {
211
+ const query = new URL(url, 'http://localhost').searchParams;
212
+ const body = await readBody(req, EXPORT_MAX_BYTES);
213
+ if (!body.length) {
214
+ return send(res, 400, JSON.stringify({ error: '空文件' }), 'application/json; charset=utf-8');
215
+ }
216
+
217
+ const fallbackRoot = scoped.get('workingDirectory')?.defaultDirectory;
218
+ const dir = resolveExportDir(query.get('dir'), fallbackRoot);
219
+ const name = safeFileName(query.get('name'), `animation-${Date.now()}.mp4`);
220
+ mkdirSync(dir, { recursive: true });
221
+ const file = join(dir, name);
222
+ writeFileSync(file, body);
223
+ const removed = pruneExports(dir, name);
224
+ trace(`export ${name} ${body.length}B -> ${file}${removed.length ? `(清理旧成片 ${removed.length} 个)` : ''}`);
225
+ return send(res, 200, JSON.stringify({
226
+ path: file,
227
+ dir,
228
+ bytes: body.length,
229
+ removed,
230
+ }), 'application/json; charset=utf-8');
231
+ }
232
+
233
+ // 样式库面板用的一次性目录快照:只给已上架的 193 种,含参考图地址。
234
+ if (url.startsWith(`${PREFIX}/styles`) && req.method === 'GET') {
235
+ const { series, styles } = catalog();
236
+ const body = JSON.stringify({
237
+ series: Object.entries(series || {}).map(([id, name]) => ({ id, name })),
238
+ styles: styles.map((style) => ({
239
+ id: style.id,
240
+ name: style.name,
241
+ en: style.en || '',
242
+ series: style.series,
243
+ seriesName: style.seriesName,
244
+ category: style.category,
245
+ description: style.desc,
246
+ fit: style.fit,
247
+ tags: style.tags || [],
248
+ stillUrl: `${PREFIX}/still/${style.id}`,
249
+ })),
250
+ });
251
+ res.writeHead(200, {
252
+ 'content-type': 'application/json; charset=utf-8',
253
+ 'content-length': Buffer.byteLength(body),
254
+ 'cache-control': 'no-store',
255
+ });
256
+ return res.end(body);
257
+ }
258
+
259
+ if (url.startsWith(`${PREFIX}/export-dir`) && req.method === 'GET') {
260
+ const query = new URL(url, 'http://localhost').searchParams;
261
+ const fallbackRoot = scoped.get('workingDirectory')?.defaultDirectory;
262
+ return send(res, 200, JSON.stringify({
263
+ dir: resolveExportDir(query.get('dir'), fallbackRoot),
264
+ }), 'application/json; charset=utf-8');
265
+ }
266
+
267
+ // The model-written score is served as script text; the client compiles it
268
+ // into a function and runs it against an OfflineAudioContext.
269
+ if (url.startsWith(`${PREFIX}/score/`)) {
270
+ const id = safeId(url.slice(`${PREFIX}/score/`.length));
271
+ const file = id ? join(OUTPUT_DIR, `${id}.score.js`) : '';
272
+ if (!file || !existsSync(file)) return send(res, 404, 'not found');
273
+ const body = readFileSync(file, 'utf8');
274
+ res.writeHead(200, {
275
+ 'content-type': 'text/javascript; charset=utf-8',
276
+ 'content-length': Buffer.byteLength(body),
277
+ 'cache-control': 'no-store',
278
+ });
279
+ return res.end(body);
280
+ }
281
+
282
+ if (url.startsWith(`${PREFIX}/still/`)) {
283
+ const id = safeId(url.slice(`${PREFIX}/still/`.length));
284
+ // Unpublished stills keep their file but are not served: a style the user
285
+ // has not cleared must not leak through a hand-typed URL either.
286
+ const file = id && isApproved({ id }) ? join(STILLS_DIR, `${id}.jpg`) : '';
287
+ if (!file || !existsSync(file)) return send(res, 404, 'not found');
288
+ const buf = readFileSync(file);
289
+ res.writeHead(200, {
290
+ 'content-type': 'image/jpeg',
291
+ 'content-length': buf.length,
292
+ 'cache-control': 'public, max-age=86400, immutable',
293
+ });
294
+ return res.end(buf);
295
+ }
296
+
297
+ if (url.startsWith(`${PREFIX}/animation/`)) {
298
+ const id = safeId(url.slice(`${PREFIX}/animation/`.length));
299
+ const file = id ? join(OUTPUT_DIR, `${id}.html`) : '';
300
+ // 旧稿会被清理(只留最新一版),所以历史卡片点开会落到这里:给一句话,
301
+ // 而不是让 iframe 里空着显示 not found。
302
+ if (!file || !existsSync(file)) {
303
+ const gone = [
304
+ '<!doctype html><meta charset="utf-8">',
305
+ '<body style="margin:0;display:flex;align-items:center;justify-content:center;',
306
+ 'height:100vh;background:#111;color:#888;',
307
+ 'font:14px/1.6 system-ui,sans-serif;text-align:center">',
308
+ '<div>这一版已经被清理<br><span style="font-size:12px;opacity:.6">',
309
+ '工作区只保留最新的成品,请看对话里最新那张卡片</span></div></body>',
310
+ ].join('');
311
+ res.writeHead(404, {
312
+ 'content-type': 'text/html; charset=utf-8',
313
+ 'content-length': Buffer.byteLength(gone),
314
+ 'cache-control': 'no-store',
315
+ });
316
+ return res.end(gone);
317
+ }
318
+ const html = readFileSync(file, 'utf8');
319
+ // 生成出来的动画常常把画布写死成 1280×720 或 1920×1080,塞进卡片那个
320
+ // 几百像素宽的预览框就会溢出、出滚动条、画面看不全。这里统一补一层
321
+ // 自适应样式:画布按原比例缩到框里,不再滚动。
322
+ // 只改显示尺寸,canvas 的像素缓冲区不动,导出仍然是原始分辨率。
323
+ const fitted = fitToFrame(html);
324
+ res.writeHead(200, {
325
+ 'content-type': 'text/html; charset=utf-8',
326
+ 'content-length': Buffer.byteLength(fitted),
327
+ 'cache-control': 'no-store',
328
+ });
329
+ return res.end(fitted);
330
+ }
331
+
332
+ return send(res, 404, 'not found');
333
+ } catch (error) {
334
+ trace(`error ${req.method} ${url} :: ${error?.message || error}`);
335
+ if (!res.headersSent) send(res, 500, error?.message || 'internal error');
336
+ else res.end();
337
+ }
338
+ };
339
+
340
+ scoped.effect(() => scoped.webServer.register({ kind: 'prefix', path: PREFIX, handler }),
341
+ 'code-animation-studio:routes');
342
+ });
343
+ }
344
+ }
package/locale/en.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "Creation Mode",
4
+ "description": "193 code-animation style prompts: pick a style, fill in your content, generate an HTML animation and export it as video."
5
+ }
6
+ }
package/locale/zh.json ADDED
@@ -0,0 +1,6 @@
1
+ {
2
+ "meta": {
3
+ "title": "创作模式",
4
+ "description": "193 种代码动画风格提示词:选风格、填内容、生成 HTML 动画并导出视频。"
5
+ }
6
+ }