alran 0.0.0-stage → 1.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 (505) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +75 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +284 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +64 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-GW7N3MYC.js +2 -0
  363. package/chunks/anthropic-63VE6MAE.js +2 -0
  364. package/chunks/application-WPPTE6LU.js +2 -0
  365. package/chunks/auth-command-36RMNQZW.js +2 -0
  366. package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
  367. package/chunks/chunk-2AYWJZ72.js +2 -0
  368. package/chunks/chunk-2K5H5GA7.js +2 -0
  369. package/chunks/chunk-2TF6JAQM.js +2 -0
  370. package/chunks/chunk-3AODGLMF.js +2 -0
  371. package/chunks/chunk-3GGKARES.js +2 -0
  372. package/chunks/chunk-4CN3IJFH.js +2 -0
  373. package/chunks/chunk-4XP5XUIZ.js +2 -0
  374. package/chunks/chunk-5DQTVSQV.js +131 -0
  375. package/chunks/chunk-5RIMHTEU.js +207 -0
  376. package/chunks/chunk-5Y76VFHY.js +2 -0
  377. package/chunks/chunk-6DOVXX7W.js +2 -0
  378. package/chunks/chunk-6P4UKHGR.js +2 -0
  379. package/chunks/chunk-6PFI65C6.js +5 -0
  380. package/chunks/chunk-6UXSIWCB.js +2 -0
  381. package/chunks/chunk-7XYOYZX2.js +2 -0
  382. package/chunks/chunk-AGUSPIUP.js +2 -0
  383. package/chunks/chunk-BQ3CF3KE.js +2 -0
  384. package/chunks/chunk-C6LAAFG2.js +30 -0
  385. package/chunks/chunk-CUG7F2FN.js +2 -0
  386. package/chunks/chunk-D66ZSHXR.js +2 -0
  387. package/chunks/chunk-D7MGU75P.js +2 -0
  388. package/chunks/chunk-DFMYLGVU.js +249 -0
  389. package/chunks/chunk-EJN3SE5B.js +16 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-G5MOGPZ3.js +6711 -0
  392. package/chunks/chunk-GP52JZMY.js +2 -0
  393. package/chunks/chunk-HNWBFJNO.js +2 -0
  394. package/chunks/chunk-IC6A323Q.js +2 -0
  395. package/chunks/chunk-IN2Z5SSJ.js +164 -0
  396. package/chunks/chunk-JSTSFMGK.js +70 -0
  397. package/chunks/chunk-K5DTFR6D.js +29 -0
  398. package/chunks/chunk-LCC45PCZ.js +29 -0
  399. package/chunks/chunk-LU4RPLJ3.js +2 -0
  400. package/chunks/chunk-LZJYNT32.js +2 -0
  401. package/chunks/chunk-MACBL5HF.js +2 -0
  402. package/chunks/chunk-MPQ6G7LH.js +1085 -0
  403. package/chunks/chunk-MUXNNOSQ.js +3 -0
  404. package/chunks/chunk-N5NTXCJI.js +2 -0
  405. package/chunks/chunk-N6W7ZL26.js +2 -0
  406. package/chunks/chunk-NBONSNQZ.js +38 -0
  407. package/chunks/chunk-NMKRNU5O.js +2 -0
  408. package/chunks/chunk-NVPGGFT3.js +2 -0
  409. package/chunks/chunk-NZXJAHTO.js +9 -0
  410. package/chunks/chunk-OTDNOWXG.js +16 -0
  411. package/chunks/chunk-PCL2CVVE.js +2 -0
  412. package/chunks/chunk-PXH4SBCS.js +3 -0
  413. package/chunks/chunk-QKBN5CGI.js +2 -0
  414. package/chunks/chunk-QPGTKSIQ.js +2 -0
  415. package/chunks/chunk-R44C5DM6.js +2 -0
  416. package/chunks/chunk-RLJVY75P.js +28 -0
  417. package/chunks/chunk-RLND4AYL.js +4 -0
  418. package/chunks/chunk-SIOLUFGG.js +2 -0
  419. package/chunks/chunk-TJC4LPRQ.js +2 -0
  420. package/chunks/chunk-U3RMPDXU.js +2 -0
  421. package/chunks/chunk-U4PFHJ7Z.js +27 -0
  422. package/chunks/chunk-UJCAE7SG.js +3 -0
  423. package/chunks/chunk-V2SB4U4D.js +2 -0
  424. package/chunks/chunk-VGKKKM2W.js +6 -0
  425. package/chunks/chunk-VLXX22YO.js +2 -0
  426. package/chunks/chunk-VUISZDXX.js +24 -0
  427. package/chunks/chunk-W5ZOLW7T.js +2 -0
  428. package/chunks/chunk-WHD2XVT2.js +2 -0
  429. package/chunks/chunk-XLVABFJC.js +9 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-XSEU4WQD.js +7 -0
  432. package/chunks/chunk-XVGPB7TW.js +21 -0
  433. package/chunks/chunk-Z5HOCNTZ.js +2 -0
  434. package/chunks/chunk-ZDI22NOK.js +7 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  437. package/chunks/data-dir-OEPRRIOO.js +2 -0
  438. package/chunks/dist-VKYZJYR6.js +11 -0
  439. package/chunks/dist-WGTMUM3E.js +5 -0
  440. package/chunks/emscripten-module-3WGSFZYF.js +2 -0
  441. package/chunks/emscripten-module-74WUXTHL.js +2 -0
  442. package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
  443. package/chunks/emscripten-module-NEAT5LGD.js +2 -0
  444. package/chunks/ffi-EFLUAAVX.js +2 -0
  445. package/chunks/ffi-JIGPPPF7.js +2 -0
  446. package/chunks/ffi-QKKA5HYI.js +2 -0
  447. package/chunks/ffi-RLX77WFG.js +2 -0
  448. package/chunks/google-RCR46TTQ.js +2 -0
  449. package/chunks/google-vertex-Y26T7YYR.js +2 -0
  450. package/chunks/install-source-63OVVBMK.js +2 -0
  451. package/chunks/launcher-2UG3JPYF.js +63 -0
  452. package/chunks/lifecycle-5IPJRP2V.js +2 -0
  453. package/chunks/main-7SGOQBHZ.js +13 -0
  454. package/chunks/mistral-NEBDKUEI.js +3 -0
  455. package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
  456. package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
  457. package/chunks/multipart-parser-JVSLI2CL.js +2 -0
  458. package/chunks/network-proxy-AJO7ZW3O.js +2 -0
  459. package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
  460. package/chunks/openai-completions-C4PHW6MD.js +2 -0
  461. package/chunks/openai-responses-5NVFOW4Y.js +2 -0
  462. package/chunks/openrouter-BKUGQT7Z.js +2 -0
  463. package/chunks/otel-DRJM2PIX.js +2 -0
  464. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  465. package/chunks/pdfjs-2UOWBGC2.js +107 -0
  466. package/chunks/photon_rs-MVWYTYTO.js +3 -0
  467. package/chunks/plugin-command-CIDTOPNB.js +2 -0
  468. package/chunks/provider-command-UZ7KQFAC.js +2 -0
  469. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  470. package/chunks/run-acp-command-AKDLHKMR.js +59 -0
  471. package/chunks/run-exec-command-UXTPS7LC.js +15 -0
  472. package/chunks/skills-command-57TF53NO.js +2 -0
  473. package/chunks/src-5PSNGHHD.js +2 -0
  474. package/chunks/src-YZ26EVSY.js +2 -0
  475. package/chunks/telemetry-3NXMCOVD.js +2 -0
  476. package/chunks/telemetry-command-CMDERYNN.js +5 -0
  477. package/chunks/tools-CRJR35HS.js +2 -0
  478. package/chunks/undici-O4OQVZ6I.js +2 -0
  479. package/chunks/update-ACFAGV6F.js +14 -0
  480. package/chunks/update-hint-ED7O67WU.js +3 -0
  481. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  482. package/cli.js +4 -0
  483. package/configs/data-minimal.yaml +50 -0
  484. package/embedded/alran-tools/cli.mjs +4957 -0
  485. package/embedded/alran-tools/manifest.json +25 -0
  486. package/emscripten-module.wasm +0 -0
  487. package/image-preview-worker.js +2 -0
  488. package/internal-bin/alran-tools +9 -0
  489. package/internal-bin/alran-tools.cmd +8 -0
  490. package/matrix-mcp-stdio.js +4 -0
  491. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  492. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  493. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  494. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  495. package/package.json +38 -4
  496. package/photon_rs_bg.wasm +0 -0
  497. package/quickjs-worker.js +152 -0
  498. package/vendor/java-proxy-agent/build.ts +97 -0
  499. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  500. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  501. package/vendor/seccomp/build.ts +74 -0
  502. package/vendor/seccomp/x64/apply-seccomp +0 -0
  503. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  504. package/vendor/srt-win/build.ts +40 -0
  505. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,439 @@
1
+ % =============================================================================
2
+ % LaTeX template for Chinese technical publications
3
+ % =============================================================================
4
+
5
+ \documentclass[10pt,openany,oneside]{book}
6
+
7
+ \usepackage[
8
+ paperwidth=176mm,
9
+ paperheight=250mm,
10
+ left=21mm,
11
+ right=21mm,
12
+ top=20mm,
13
+ bottom=24mm,
14
+ headheight=13pt,
15
+ headsep=6mm,
16
+ footskip=10mm
17
+ ]{geometry}
18
+
19
+ \usepackage{fontspec}
20
+ \usepackage[UTF8,scheme=plain]{ctex}
21
+ \IfFontExistsTF{TeX Gyre Pagella}{\setmainfont{TeX Gyre Pagella}}{\setmainfont{Palatino}}
22
+ \IfFontExistsTF{TeX Gyre Heros}{\setsansfont{TeX Gyre Heros}}{\setsansfont{Helvetica}}
23
+ \IfFontExistsTF{JetBrains Mono}{\setmonofont{JetBrains Mono}[Scale=MatchLowercase]}{\setmonofont{Menlo}[Scale=MatchLowercase]}
24
+ \IfFontExistsTF{Source Han Serif SC}{\setCJKmainfont{Source Han Serif SC}}{\setCJKmainfont{Songti SC}}
25
+ \IfFontExistsTF{Source Han Sans SC}{\setCJKsansfont{Source Han Sans SC}}{\setCJKsansfont{Heiti SC}}
26
+ \IfFontExistsTF{Sarasa Mono SC}{\setCJKmonofont{Sarasa Mono SC}}{}
27
+
28
+ \usepackage{microtype}
29
+ \usepackage{setspace}
30
+ \setstretch{1.10}
31
+ \setlength{\parindent}{2em}
32
+ \setlength{\parskip}{0pt plus 1pt}
33
+ \emergencystretch=3em
34
+ \tolerance=1800
35
+ \hbadness=6000
36
+
37
+ \usepackage{xcolor}
38
+ \definecolor{BookBlue}{HTML}{1F4E79}
39
+ \definecolor{BookNavy}{HTML}{15324A}
40
+ \definecolor{BookGold}{HTML}{C59B4B}
41
+ \definecolor{CoverRed}{HTML}{BE1E2D}
42
+ \definecolor{CoverBlack}{HTML}{333333}
43
+ \definecolor{BookRed}{HTML}{8B1E1E}
44
+ \definecolor{BookGreen}{HTML}{2D6A4F}
45
+ \definecolor{BookGray}{HTML}{4A5568}
46
+ \definecolor{LightBlue}{HTML}{EEF5FB}
47
+ \definecolor{LightGray}{HTML}{F6F7F9}
48
+ \definecolor{CodeBg}{HTML}{F7F7F3}
49
+ \definecolor{CodeRule}{HTML}{D8DEE9}
50
+ \definecolor{CodeKeyword}{HTML}{4B6584}
51
+ \definecolor{CodeComment}{HTML}{6B7C6A}
52
+ \definecolor{CodeString}{HTML}{8A5A44}
53
+ \definecolor{CodeNumber}{HTML}{6C6F7D}
54
+ \definecolor{TocBlack}{HTML}{111111}
55
+ \definecolor{CoverPaper}{HTML}{FEFEFE}
56
+ \definecolor{AccentSoft}{HTML}{FAF5F0}
57
+ \definecolor{AccentLine}{HTML}{8A1E1E}
58
+ \definecolor{DiagramBox}{HTML}{F7F3EF}
59
+ \definecolor{DiagramBlue}{HTML}{E8EEF5}
60
+
61
+ \usepackage{amsmath,amssymb,mathtools,bm}
62
+ \usepackage{amsthm}
63
+ \renewcommand{\proofname}{证明}
64
+ \usepackage{graphicx}
65
+ \graphicspath{{figures/}}
66
+ \usepackage{tikz}
67
+ \usetikzlibrary{arrows.meta,positioning,shapes.geometric,calc}
68
+ \usepackage{lettrine}
69
+ \usepackage{enumitem}
70
+ \usepackage{booktabs,multirow,tabularx,longtable,array,ragged2e}
71
+ \newcolumntype{Y}{>{\RaggedRight\arraybackslash\hspace{0pt}}X}
72
+ \usepackage{caption,subcaption}
73
+ \captionsetup{font=small,labelfont=bf,labelsep=period}
74
+ \usepackage{xurl}
75
+ \Urlmuskip=0mu plus 2mu
76
+ \usepackage{algorithm}
77
+ \usepackage[noend]{algpseudocode}
78
+ \floatname{algorithm}{算法 / Algorithm}
79
+ \renewcommand{\contentsname}{目\quad 录}
80
+ \renewcommand{\bibname}{参考文献 / Bibliography}
81
+ \renewcommand{\indexname}{索\quad 引 / Index}
82
+ \renewcommand{\figurename}{图}
83
+ \renewcommand{\tablename}{表}
84
+
85
+ \usepackage{listings}
86
+ \lstdefinestyle{bookcode}{
87
+ basicstyle=\scriptsize\ttfamily,
88
+ backgroundcolor=\color{CodeBg},
89
+ frame=lines,
90
+ framerule=0.45pt,
91
+ rulecolor=\color{CodeRule},
92
+ numbers=left,
93
+ numberstyle=\tiny\sffamily\color{BookGray},
94
+ keywordstyle=\color{CodeKeyword}\bfseries,
95
+ commentstyle=\color{CodeComment}\itshape,
96
+ stringstyle=\color{CodeString},
97
+ identifierstyle=\color{CoverBlack},
98
+ breaklines=true,
99
+ breakatwhitespace=false,
100
+ postbreak=\mbox{\textcolor{BookGray}{$\hookrightarrow$}\space},
101
+ columns=fullflexible,
102
+ keepspaces=true,
103
+ showstringspaces=false,
104
+ tabsize=2,
105
+ xleftmargin=2.6em,
106
+ xrightmargin=0.6em,
107
+ framexleftmargin=2.2em,
108
+ framexrightmargin=0.4em,
109
+ framesep=4pt,
110
+ aboveskip=0.75em,
111
+ belowskip=0.75em,
112
+ captionpos=b,
113
+ numbersep=0.8em,
114
+ alsoletter={@:-},
115
+ morekeywords={async,await,import,export,from,const,let,var,function,return,class,interface,type,extends,implements,public,private,protected,readonly,if,else,for,while,switch,case,break,continue,try,catch,finally,throw,new,this,null,undefined,true,false}
116
+ }
117
+ \lstset{style=bookcode}
118
+ \renewcommand{\lstlistingname}{代码清单 / Listing}
119
+
120
+ \usepackage[explicit]{titlesec}
121
+ \usepackage{titletoc}
122
+ \titleformat{\chapter}[display]
123
+ {\normalfont\large\bfseries\color{BookBlue}}
124
+ {\filleft\normalsize 第\thechapter 章}
125
+ {1.2ex}
126
+ {\titlerule[1.2pt]\vspace{1.4ex}\filright #1}
127
+ [\vspace{1.1ex}\titlerule]
128
+ \titlespacing*{\chapter}{0pt}{0pt}{22pt}
129
+ \titleformat{\section}
130
+ {\normalfont\small\bfseries\color{BookBlue}}
131
+ {\thesection}{0.8em}{#1}
132
+ \titleformat{\subsection}
133
+ {\normalfont\small\bfseries\color{BookGray}}
134
+ {\thesubsection}{0.8em}{#1}
135
+ \titleformat{\subsubsection}
136
+ {\normalfont\small\bfseries\color{BookGray}}
137
+ {\thesubsubsection}{0.8em}{#1}
138
+ \setcounter{secnumdepth}{3}
139
+ \setcounter{tocdepth}{2}
140
+ \titlecontents{chapter}
141
+ [0pt]
142
+ {\addvspace{0.65em}\small\bfseries\color{TocBlack}}
143
+ {\textcolor{BookRed}{\contentslabel{2.2em}}}
144
+ {}
145
+ {\titlerule*[0.55em]{.}\textcolor{BookRed}{\contentspage}}
146
+ \titlecontents{section}
147
+ [2.2em]
148
+ {\small\color{TocBlack}}
149
+ {\textcolor{BookRed}{\contentslabel{2.8em}}}
150
+ {}
151
+ {\titlerule*[0.55em]{.}\textcolor{BookRed}{\contentspage}}
152
+ \titlecontents{subsection}
153
+ [5.0em]
154
+ {\footnotesize\color{TocBlack!85}}
155
+ {\textcolor{BookRed!80!black}{\contentslabel{3.2em}}}
156
+ {}
157
+ {\titlerule*[0.55em]{.}\textcolor{BookRed!80!black}{\contentspage}}
158
+
159
+ \usepackage{fancyhdr}
160
+ \pagestyle{fancy}
161
+ \fancyhf{}
162
+ \renewcommand{\chaptermark}[1]{\markboth{#1}{}}
163
+ \renewcommand{\sectionmark}[1]{\markright{#1}}
164
+ \fancyhead[L]{\footnotesize\sffamily\color{BookGray}\nouppercase{\rightmark}}
165
+ \fancyhead[R]{\footnotesize\sffamily\color{BookGray}\thepage}
166
+ \fancyfoot[L]{\scriptsize\sffamily\color{BookGray}\BookTitle}
167
+ \fancyfoot[C]{\scriptsize\sffamily\color{BookGray!75}\BookPublisher}
168
+ \fancyfoot[R]{\scriptsize\sffamily\color{BookGray}\thepage}
169
+ \fancypagestyle{plain}{
170
+ \fancyhf{}
171
+ \fancyfoot[L]{\scriptsize\sffamily\color{BookGray}\BookTitle}
172
+ \fancyfoot[C]{\scriptsize\sffamily\color{BookGray!75}\BookPublisher}
173
+ \fancyfoot[R]{\scriptsize\sffamily\color{BookGray}\thepage}
174
+ \renewcommand{\headrulewidth}{0pt}
175
+ \renewcommand{\footrulewidth}{0.35pt}
176
+ }
177
+ \renewcommand{\headrulewidth}{0.35pt}
178
+ \renewcommand{\footrulewidth}{0.35pt}
179
+
180
+ \usepackage[most]{tcolorbox}
181
+ \tcbuselibrary{breakable,skins,theorems,listings}
182
+ \newtcolorbox{insightbox}[1][]{
183
+ enhanced,breakable,colback=white,colframe=BookRed,
184
+ title={要点 / Insight},fonttitle=\bfseries,coltitle=white,
185
+ colbacktitle=BookRed,#1
186
+ }
187
+ \newtcolorbox{pullquotebox}{
188
+ enhanced,breakable,colback=AccentSoft,colframe=AccentLine,
189
+ borderline west={2.2pt}{0pt}{AccentLine},boxrule=0pt,
190
+ left=4mm,right=4mm,top=2.6mm,bottom=2.6mm,
191
+ fontupper=\itshape\small
192
+ }
193
+ \newtcolorbox{diagramBox}[1][]{
194
+ enhanced,breakable,colback=DiagramBox,colframe=CodeRule,
195
+ boxrule=0.45pt,arc=1.5pt,left=4mm,right=4mm,top=3mm,bottom=3mm,#1
196
+ }
197
+ \newcommand{\fancydropcap}[2]{\lettrine[lines=2,lhang=0.08,nindent=0.18em,findent=0.12em]{\textcolor{BookRed}{#1}}{#2}}
198
+
199
+ \newtcbtheorem[number within=chapter]{definition}{定义 / Definition}{
200
+ enhanced,breakable,colback=LightBlue,colframe=BookBlue,
201
+ coltitle=white,fonttitle=\bfseries,
202
+ attach boxed title to top left={xshift=2mm,yshift=-2mm},
203
+ boxed title style={colback=BookBlue,sharp corners},
204
+ separator sign={.}
205
+ }{def}
206
+
207
+ \newtcbtheorem[number within=chapter]{theorem}{定理 / Theorem}{
208
+ enhanced,breakable,colback=white,colframe=BookBlue,
209
+ coltitle=white,fonttitle=\bfseries,
210
+ attach boxed title to top left={xshift=2mm,yshift=-2mm},
211
+ boxed title style={colback=BookBlue,sharp corners},
212
+ separator sign={.}
213
+ }{thm}
214
+
215
+ \newtcbtheorem[number within=chapter]{example}{例 / Example}{
216
+ enhanced,breakable,colback=LightGray,colframe=BookGray,
217
+ coltitle=white,fonttitle=\bfseries,
218
+ attach boxed title to top left={xshift=2mm,yshift=-2mm},
219
+ boxed title style={colback=BookGray,sharp corners},
220
+ separator sign={.}
221
+ }{ex}
222
+
223
+ \newtcolorbox{warningbox}[1][]{
224
+ enhanced,breakable,colback=BookRed!3,colframe=BookRed,
225
+ title={常见误区 / Common Pitfall},fonttitle=\bfseries,coltitle=white,
226
+ colbacktitle=BookRed,#1
227
+ }
228
+
229
+ \newcounter{exercise}[chapter]
230
+ \renewcommand{\theexercise}{\thechapter.\arabic{exercise}}
231
+ \newenvironment{exercise}[1][]{%
232
+ \refstepcounter{exercise}\par\medskip
233
+ \noindent\textbf{习题 / Exercise~\theexercise\quad #1}\itshape\quad
234
+ }{\par\medskip}
235
+
236
+ \newenvironment{chapterbibliography}{%
237
+ \section*{本章延伸阅读 / Further Reading}\addcontentsline{toc}{section}{本章延伸阅读 / Further Reading}
238
+ \small
239
+ }{\normalsize}
240
+
241
+ \usepackage[numbers,sort&compress]{natbib}
242
+ \bibliographystyle{plainnat}
243
+ \usepackage{makeidx}
244
+ \makeindex
245
+ \usepackage{hyperref}
246
+ \hypersetup{
247
+ unicode=true,
248
+ colorlinks=true,
249
+ linkcolor=TocBlack,
250
+ citecolor=TocBlack,
251
+ urlcolor=BookGray,
252
+ pdftitle={技术系统},
253
+ pdfauthor={作者姓名},
254
+ pdfsubject={中文技术出版读物模板}
255
+ }
256
+ \usepackage[nameinlink,noabbrev]{cleveref}
257
+
258
+ \newcommand{\BookTitle}{技术系统}
259
+ \newcommand{\BookTitleDetail}{算法、设计与工程实践}
260
+ \newcommand{\BookTitleEN}{}
261
+ \newcommand{\BookTitleDetailEN}{}
262
+ \newcommand{\BookSubtitle}{}
263
+ \newcommand{\BookSubtitleEN}{}
264
+ \newcommand{\BookAuthor}{作者姓名}
265
+ \newcommand{\BookEdition}{第 1 版}
266
+ \newcommand{\BookPublisher}{某某出版社}
267
+ \newcommand{\BookYear}{2026}
268
+
269
+
270
+ % Legacy cover retained for reference; not used by the document.
271
+ \newcommand{\maketechbooktitleClassic}{%
272
+ \begin{titlepage}
273
+ \thispagestyle{empty}
274
+ \begingroup
275
+ \newgeometry{left=0mm,right=0mm,top=0mm,bottom=0mm}%
276
+ \begin{tikzpicture}[remember picture,overlay]
277
+ \fill[CoverPaper] (current page.south west) rectangle (current page.north east);
278
+ \IfFileExists{figures/cover-background.png}{%
279
+ \node[inner sep=0pt,opacity=0.22] at (current page.center)
280
+ {\includegraphics[width=176mm,height=250mm]{figures/cover-background.png}};
281
+ }{}
282
+ \fill[CoverRed] (current page.north west) rectangle ([yshift=-6mm]current page.north east);
283
+ \fill[CoverRed] (current page.south west) rectangle ([yshift=6mm]current page.south east);
284
+ \fill[CoverRed!4] ([xshift=12mm,yshift=-12mm]current page.north west) rectangle
285
+ ([xshift=38mm,yshift=12mm]current page.south west);
286
+ \draw[CoverBlack,line width=0.55pt]
287
+ ([xshift=12mm,yshift=-12mm]current page.north west) rectangle
288
+ ([xshift=-12mm,yshift=12mm]current page.south east);
289
+ \draw[CoverRed,line width=1.2pt]
290
+ ([xshift=20mm,yshift=-18mm]current page.north west) --
291
+ ([xshift=20mm,yshift=18mm]current page.south west);
292
+ \draw[CoverBlack,line width=0.35pt]
293
+ ([xshift=23mm,yshift=-18mm]current page.north west) --
294
+ ([xshift=23mm,yshift=18mm]current page.south west);
295
+ \IfFileExists{figures/alran-logo.png}{%
296
+ \node[anchor=north east,inner sep=0pt]
297
+ at ([xshift=-20mm,yshift=-24mm]current page.north east)
298
+ {\includegraphics[width=36mm]{figures/alran-logo.png}};
299
+ }{}
300
+ \node[anchor=north west,align=left,text=BookGray,font=\sffamily\bfseries\scriptsize]
301
+ at ([xshift=31mm,yshift=-24mm]current page.north west)
302
+ {HARNESS ENGINEERING SERIES};
303
+ \node[anchor=north west,align=left,text=black,text width=118mm,font=\rmfamily\bfseries\fontsize{34pt}{39pt}\selectfont]
304
+ at ([xshift=31mm,yshift=-58mm]current page.north west)
305
+ {\BookTitle};
306
+ \node[anchor=north west,align=left,text=CoverBlack,text width=118mm,font=\rmfamily\fontsize{18pt}{25pt}\selectfont]
307
+ at ([xshift=31mm,yshift=-93mm]current page.north west)
308
+ {\BookTitleDetail};
309
+ \draw[CoverRed,line width=1pt]
310
+ ([xshift=31mm,yshift=-150mm]current page.north west) --
311
+ ([xshift=139mm,yshift=-150mm]current page.north west);
312
+ \draw[CoverBlack,line width=0.35pt]
313
+ ([xshift=31mm,yshift=43mm]current page.south west) --
314
+ ([xshift=-16mm,yshift=43mm]current page.south east);
315
+ \draw[CoverRed,line width=0.8pt]
316
+ ([xshift=31mm,yshift=40mm]current page.south west) --
317
+ ([xshift=-16mm,yshift=40mm]current page.south east);
318
+ \node[anchor=south,align=center,text=CoverBlack,font=\sffamily\small]
319
+ at ([yshift=26mm]current page.south)
320
+ {\BookAuthor};
321
+ \node[anchor=south,align=center,text=BookGray,font=\sffamily\scriptsize]
322
+ at ([yshift=18mm]current page.south)
323
+ {\BookYear};
324
+ \end{tikzpicture}%
325
+ \null\clearpage
326
+ \restoregeometry
327
+ \endgroup
328
+ \end{titlepage}
329
+ }
330
+
331
+ \newcommand{\drawpangolincover}{%
332
+ \begin{scope}[x=1mm,y=1mm,shift={(88mm,-151mm)},scale=0.9]
333
+ \draw[CoverBlack!68,line width=0.55pt]
334
+ (-36,5) .. controls (-26,25) and (5,31) .. (26,16)
335
+ .. controls (43,4) and (46,-18) .. (27,-26)
336
+ .. controls (4,-36) and (-25,-25) .. (-33,-9)
337
+ .. controls (-38,1) and (-38,1) .. (-36,5);
338
+ \draw[CoverBlack!54,line width=0.45pt]
339
+ (-22,17) .. controls (-11,23) and (4,23) .. (18,14);
340
+ \foreach \x/\y/\r in {-24/9/9,-10/14/10,5/13/10,18/6/9,27/-7/8,15/-18/9,-3/-22/9,-19/-15/8}{%
341
+ \draw[CoverBlack!32,line width=0.35pt] (\x,\y) ellipse (\r mm and 4.2mm);
342
+ }
343
+ \draw[CoverBlack!62,line width=0.5pt]
344
+ (23,13) .. controls (39,22) and (54,14) .. (61,1);
345
+ \fill[CoverBlack!62] (57,3) circle (0.8mm);
346
+ \draw[CoverBlack!55,line width=0.45pt]
347
+ (-32,-8) .. controls (-53,-13) and (-56,-34) .. (-39,-42)
348
+ .. controls (-27,-48) and (-11,-43) .. (-5,-31);
349
+ \draw[CoverBlack!48,line width=0.45pt] (-8,-27) -- (-12,-39);
350
+ \draw[CoverBlack!48,line width=0.45pt] (12,-27) -- (9,-39);
351
+ \draw[CoverBlack!48,line width=0.45pt] (30,-20) -- (35,-32);
352
+ \end{scope}%
353
+ }
354
+
355
+ \newcommand{\maketechbooktitle}{%
356
+ \begin{titlepage}
357
+ \thispagestyle{empty}
358
+ \begingroup
359
+ \newgeometry{left=0mm,right=0mm,top=0mm,bottom=0mm}%
360
+ \begin{tikzpicture}[remember picture,overlay]
361
+ \fill[CoverPaper] (current page.south west) rectangle (current page.north east);
362
+ \fill[CoverRed] (current page.north west) rectangle ([yshift=-7mm]current page.north east);
363
+ \fill[CoverRed] (current page.south west) rectangle ([yshift=7mm]current page.south east);
364
+ \draw[CoverBlack,line width=0.6pt]
365
+ ([xshift=12mm,yshift=-12mm]current page.north west) rectangle
366
+ ([xshift=-12mm,yshift=12mm]current page.south east);
367
+ \draw[CoverRed,line width=0.8pt]
368
+ ([xshift=14mm,yshift=-15mm]current page.north west) --
369
+ ([xshift=-14mm,yshift=-15mm]current page.north east);
370
+ \draw[CoverBlack,line width=0.4pt]
371
+ ([xshift=14mm,yshift=-17mm]current page.north west) --
372
+ ([xshift=-14mm,yshift=-17mm]current page.north east);
373
+ \node[anchor=north west,align=left,text=BookGray,font=\sffamily\scriptsize]
374
+ at ([xshift=16mm,yshift=-20mm]current page.north west)
375
+ {HARNESS ENGINEERING SERIES};
376
+ \node[anchor=north east,align=right,text=BookGray,font=\sffamily\bfseries\scriptsize]
377
+ at ([xshift=-16mm,yshift=-20mm]current page.north east)
378
+ {\MakeUppercase{\BookPublisher}};
379
+ \node[anchor=north west,align=left,text=black,text width=142mm,font=\rmfamily\fontsize{42pt}{48pt}\selectfont]
380
+ at ([xshift=16mm,yshift=-42mm]current page.north west)
381
+ {\BookTitle};
382
+ \node[anchor=north west,align=left,text=CoverBlack,text width=142mm,font=\rmfamily\fontsize{19pt}{27pt}\selectfont]
383
+ at ([xshift=16mm,yshift=-76mm]current page.north west)
384
+ {\BookTitleDetail};
385
+ \drawpangolincover
386
+ \draw[CoverBlack,line width=0.4pt]
387
+ ([xshift=14mm,yshift=44mm]current page.south west) --
388
+ ([xshift=-14mm,yshift=44mm]current page.south east);
389
+ \draw[CoverRed,line width=0.8pt]
390
+ ([xshift=14mm,yshift=42mm]current page.south west) --
391
+ ([xshift=-14mm,yshift=42mm]current page.south east);
392
+ \node[anchor=south west,align=left,text=CoverBlack,font=\sffamily\small]
393
+ at ([xshift=16mm,yshift=29mm]current page.south west)
394
+ {\BookAuthor};
395
+ \node[anchor=south west,align=left,text=BookGray,font=\sffamily\scriptsize]
396
+ at ([xshift=16mm,yshift=21mm]current page.south west)
397
+ {Cover illustration placeholder};
398
+ \node[anchor=south east,align=right,text=BookGray,font=\sffamily\scriptsize]
399
+ at ([xshift=-16mm,yshift=16mm]current page.south east)
400
+ {\MakeUppercase{\BookPublisher}\\\BookYear};
401
+ \end{tikzpicture}%
402
+ \null\clearpage
403
+ \restoregeometry
404
+ \endgroup
405
+ \end{titlepage}
406
+ }
407
+
408
+
409
+
410
+ \begin{document}
411
+ \frontmatter
412
+ \maketechbooktitle
413
+
414
+ \chapter*{前言}
415
+ \addcontentsline{toc}{chapter}{前言}
416
+
417
+ 这里写入本书前言。建议说明本书的写作动机、适合读者、阅读路径,以及章节组织方式。前言不必解释模板本身,而应面向真实读者介绍这本书为什么值得阅读。
418
+
419
+ \phantomsection
420
+ \pdfbookmark[0]{目录}{toc}
421
+ \tableofcontents
422
+ \clearpage
423
+
424
+ \mainmatter
425
+ \input{chapters/chapter01}
426
+ \input{chapters/chapter02}
427
+ \input{chapters/chapter03}
428
+
429
+ \appendix
430
+ \input{backmatter/appendix}
431
+
432
+ \backmatter
433
+ \phantomsection
434
+ \addcontentsline{toc}{chapter}{参考文献 / Bibliography}
435
+ \bibliography{references}
436
+ \phantomsection
437
+ \addcontentsline{toc}{chapter}{索引 / Index}
438
+ \printindex
439
+ \end{document}
@@ -0,0 +1,148 @@
1
+ # multi-article-aggregator
2
+
3
+ > Distilled from reference examples m16 (source blog 11 posts -> 70-page
4
+ > PDF). **Cowork multi-pass pipeline**: fetch -> clean DOM -> per-article
5
+ > render -> 2-pass TOC -> merge. This route is fundamentally a pipeline,
6
+ > not a single HTML file.
7
+
8
+ ## 1. When to use
9
+
10
+ - **EN keywords**: aggregate articles, blog digest, multi-post
11
+ compilation, monthly digest, TOC + multi-doc, news roundup,
12
+ blog -> PDF
13
+ - **CN keywords**: 文章合集、blog 聚合、多篇汇总、月度回顾、资讯整理、博客打包
14
+ - **Sample user asks**:
15
+ - "Compile these source blog posts from January 2026 into a PDF;
16
+ needs a TOC that jumps to each post; one post per page."
17
+ - "Aggregate 11 Medium articles into a single PDF with clickable TOC
18
+ and category grouping."
19
+
20
+ ## 2. Pipeline
21
+
22
+ **Cowork multi-pass pipeline** (not a single HTML, no single skeleton).
23
+
24
+ | Stage | Tool | Purpose |
25
+ |---|---|---|
26
+ | 1. Fetch | Playwright | Pull each source page (`networkidle` + 1.5 s settle for lazy loads). |
27
+ | 2. Per-article DOM cleanup | Playwright `page.evaluate` | Inject hide CSS to strip nav / footer / cookie / related-posts / share / sticky elements. |
28
+ | 3. Per-article render | Playwright `page.pdf()` | One PDF per article (do NOT merge HTML). |
29
+ | 4. Collect metadata | pdfinfo | Page count per article -> page-offset map for the TOC. |
30
+ | 5. **TOC pass 1** | reportlab canvas | Render the TOC with mock page numbers; measure its own page count. |
31
+ | 6. **Merge pass 1** | pypdf | Concatenate `[TOC + article 1..N]`; recompute the true start page of each article. |
32
+ | 7. **TOC pass 2** | reportlab canvas | Re-render the TOC with the real page numbers. |
33
+ | 8. **Merge pass 2** | pypdf | Final PDF + outline bookmarks + `/Link` annotations. |
34
+ | 9. (Optional) trim trailing blanks | pypdf | Detect per-article trailing pages that are >= 90% blank; drop them and re-balance offsets. |
35
+
36
+ Why cowork instead of merging HTML in one shot: 11 articles use
37
+ different Webflow templates with conflicting CSS cascades. Rendering
38
+ each article in isolation preserves its font hierarchy without
39
+ cross-contamination.
40
+
41
+ ## 3. Document shape
42
+
43
+ - **Pages**: ~70 (5-8 per article x 11 + 1-2 TOC).
44
+ - **Structure**: cover (optional) -> TOC (dot leaders + page numbers +
45
+ category grouping) -> 11 articles (each with `page-break-before`) ->
46
+ colophon (optional).
47
+ - **Page size**: A4 portrait.
48
+ - **Per-article structure**: H1 title -> metadata (date / author /
49
+ category / reading time) -> body (text + code + images) -> no nav /
50
+ related / share.
51
+
52
+ ## 4. Visual params
53
+
54
+ - **Palette**: neutral / inherit from source (the source uses dark + serif).
55
+ - **Typography**: pull source `@font-face` woff2 -> convert to TTF ->
56
+ inline as `data:` URIs; `font-family` cascade with fallbacks;
57
+ **critical: `await document.fonts.ready` before rendering.**
58
+ - **Code blocks**: `font-family: Menlo, Consolas, monospace`;
59
+ `background: #f5f5f5`; `padding: 12px`; `whitespace: pre-wrap`.
60
+ - **TOC**: category-grouped (bold underlined subhead -> numbered item ->
61
+ dot leaders -> right-aligned date -> right-aligned page number;
62
+ multi-line titles wrap automatically).
63
+ - **Per-article H1**: 28pt; H2 20pt; H3 16pt.
64
+ - **Images**: `max-width: 100%; height: auto`. Wait for `img.complete`
65
+ before rendering.
66
+
67
+ ## 5. Skeleton
68
+
69
+ See [`pipeline.md`](pipeline.md) (cowork pipeline pseudocode + per-article
70
+ HTML stub + TOC rendering spec).
71
+
72
+ **Quick start**:
73
+
74
+ ```bash
75
+ # This route has no "copy a single skeleton" path — you must walk the pipeline.
76
+ # 1. Prepare posts_list.json: [{url, title, date, author, category, slug}, ...]
77
+ # 2. Run fetch + clean DOM + per-article render (python + playwright).
78
+ # 3. Render TOC with reportlab, merge with pypdf.
79
+ # Full details in pipeline.md.
80
+ ```
81
+
82
+ ## 6. Pitfalls (from m16 production)
83
+
84
+ - **Web-font load race**: without `await document.fonts.ready` Chromium
85
+ substitutes system fonts (Times / Helvetica) and breaks the visual.
86
+ **Always await custom fonts.**
87
+ - **Lazy-loaded images dropped**: when Playwright prints, late-loading
88
+ images get clipped. **Scroll to the bottom** before rendering, then
89
+ `wait_for_timeout(1500-2000)` so all images settle.
90
+ - **CSS cascade pollution**: Webflow uses `.is-cc` / `[class*='icon']`
91
+ in deeply nested layouts; broad selectors like `[class*='form_']`
92
+ accidentally hit `.hero_blog_post_details_form` and collapse the
93
+ metadata block. **Use an explicit KEEP whitelist** + force
94
+ `display: flex` for the wanted nodes.
95
+ - **Per-article trailing blanks**: a single article often produces 1-2
96
+ trailing blank pages (CSS height 100vh / placeholders). **Strip them
97
+ before merging**, or the total page count balloons and TOC numbers
98
+ drift.
99
+ - **Metadata icons run wild**: Webflow icons without size constraints
100
+ occupy 60% of the page width. Inject early CSS:
101
+ `svg, [class*='icon'] { max-width: 64px; max-height: 64px; }`.
102
+ - **TOC pagination**: 11 entries can overflow one page. reportlab
103
+ canvas does not paginate automatically — measure cumulative height,
104
+ call `c.showPage()` once you exceed `SAFE_PAGE_H`.
105
+ - **PDF outline 0-based vs 1-based**: outline page numbers are 0-based
106
+ (page 0 = TOC), but the displayed numbers are 1-based. Off-by-one
107
+ errors send bookmarks to the wrong page. **Verify the `/Dest` indirect
108
+ reference with both `pdfinfo` and pypdf outline.**
109
+ - **Order / grouping**: defaults to chronological; users may want
110
+ reverse or custom grouping. **Parameterise**:
111
+ `--order=chrono|reverse`, `--group-by=category|date`.
112
+
113
+ ## 7. Generalization
114
+
115
+ **Required**:
116
+ - `COMPILATION_TITLE`
117
+ - `SOURCE_WEBFONT_FAMILY` (auto-discover from source `@font-face`, or
118
+ `getComputedStyle(body).fontFamily`).
119
+ - `posts_list.json` (`[{url, title, date, author, slug, category}]`).
120
+ - `N_ARTICLES` (5-50 typical).
121
+
122
+ **Optional**:
123
+ - Per-article excerpt (TOC sub-line).
124
+ - Category / tag badges.
125
+ - Author avatars (if the source provides them).
126
+ - Custom cover.
127
+
128
+ **Structural invariants**:
129
+ - TOC + dot leaders + page numbers (never inline).
130
+ - `page-break-before: always` per article.
131
+ - `img { max-width: 100%; height: auto; }` to prevent overflow.
132
+ - Code blocks in monospace + light-gray background.
133
+ - No nav / footer / related elements.
134
+
135
+ **Swappable**:
136
+ - Source site (blog -> medium.com / Substack / dev.to / WordPress
137
+ / any stable HTML).
138
+ - Article count (5-50; tune the TOC paging threshold).
139
+ - Language (EN / CN / mixed; reportlab + pypdf are encoding-agnostic).
140
+ - Margins (default 16 mm; pass via the `page.pdf()` margin dict).
141
+
142
+ **Diversify every run.** The aggregator should inherit the **source
143
+ site's webfont** (auto-detect via `getComputedStyle`) — do not default
144
+ to a stock sans-serif. Re-pick the cover treatment, accent color, and
145
+ TOC layout based on the source site's identity (Substack newsletter
146
+ warmth vs dev.to monospace vs corporate blog formality). Two digests
147
+ from two different blogs should read as separate publications, not
148
+ both wearing the m18 default.