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,233 @@
1
+ # Guide: LaTeX Academic Thesis → PDF
2
+
3
+ Use this route when the user asks to generate, compile, or typeset an academic
4
+ thesis / dissertation / 毕业论文 / 学士论文 / 硕士论文 / 博士论文 using LaTeX,
5
+ especially with a university-provided template or Chinese national standard
6
+ format (GB/T 7714 bibliography, GB/T 7714 title rules, etc.).
7
+
8
+ This route does **not** write the thesis content for you — it provides the
9
+ toolchain, template scaffold, compilation workflow, and verification gates so
10
+ that a pre-authored `.tex` file (or a user's content) produces a correctly
11
+ formatted PDF.
12
+
13
+ ---
14
+
15
+ ## Trigger signatures
16
+
17
+ Match any of these; read the guide before doing anything:
18
+
19
+ - "用 LaTeX 生成/排版学术论文"
20
+ - "毕业论文 LaTeX 模板"
21
+ - "学士论文 PDF 封面合并"
22
+ - "LaTeX 编译 生成 PDF"
23
+ - "参考文献 GB/T 7714 编号"
24
+ - "页眉页脚 奇偶页 不同"
25
+ - "目录含一二三级标题"
26
+ - "三线表 格式"
27
+ - "学校论文格式 A4"
28
+ - "qpdf 合并封面 PDF"
29
+
30
+ ---
31
+
32
+ ## What this route does
33
+
34
+ 1. **Scaffold** a Chinese academic thesis `main.tex` covering all required
35
+ structural components (cover, abstract, TOC, body, bibliography, appendix).
36
+ 2. **Compile** with `tectonic` (preferred, auto-fetches packages) or `xelatex
37
+ + bibtex` (fallback).
38
+ 3. **Verify** page size, page numbering breaks, header/footer, undefined
39
+ references/citations.
40
+ 4. **Merge** a separate cover PDF with the body PDF via `qpdf` when the cover
41
+ is provided as an external file.
42
+
43
+ ---
44
+
45
+ ## What this route does NOT do
46
+
47
+ - Do **not** write the thesis body content from scratch. Extract structure and
48
+ formatting rules from the user's content; do not invent or alter text.
49
+ - Do **not** route DOCX/Word tasks here — use `docx`.
50
+ - Do **not** use HTML→PDF for an academic thesis that requires LaTeX typesetting.
51
+ - Do **not** ignore `undefined reference`, `undefined citation`, or `fatal`
52
+ warnings in `main.log` — they indicate broken cross-references or bibliography.
53
+ - Do **not** re-number references on every re-citation — use the bibliography
54
+ style's built-in compression (`sort&compress` with `natbib`).
55
+
56
+ ---
57
+
58
+ ## Input collection checklist
59
+
60
+ Before writing any LaTeX or running any compile, collect:
61
+
62
+ | Item | How to get it | Why it matters |
63
+ |---|---|---|
64
+ | University / degree level | Ask user | Determines title formatting, page geometry |
65
+ | Page geometry | A4; top/bottom/left/right mm values | Passed to `geometry` package |
66
+ | Font requirements | e.g. "小四宋体 20pt", "Times New Roman" | Sets `\zihao{}`, `\setCJKmainfont` |
67
+ | Heading hierarchy | e.g. 一级小三加粗, 二级四号, 三级小四 | Sets `\ctexset{section/...}` |
68
+ | Bibliography style | GB/T 7714-2015 numeric; author-date | Sets `\bibliographystyle{gbt7714-numerical}` |
69
+ | Page numbering breaks | Roman (摘要/目录) → Arabic (正文) | Sets `\pagenumbering{roman/arabic}` |
70
+ | Figure/table caption style | e.g. 五号宋体, labelsep=space | Sets `\captionsetup` |
71
+ | Cover page | External PDF or LaTeX built-in? | Determines qpdf merge step |
72
+ | Whether `thebibliography` or BibTeX | Ask user or check source | Changes compile chain |
73
+ | External figure/table dirs | `graphicspath{{../charts/}{../photos/}}` | Resolves `\includegraphics` |
74
+ | Clickable TOC/index | All major sections, appendix, references | `hyperref` + `\tableofcontents` and live destinations |
75
+
76
+ ---
77
+
78
+ ## Implementation flow
79
+
80
+ ### Step 1 — Write the compact template
81
+
82
+ Use the scaffold in `templates/latex-academic-thesis/source.tex` as the starting
83
+ point. Fill in the structural placeholders (title, author, supervisor, date,
84
+ school name). Keep all formatting commands — only replace content.
85
+
86
+ Key formatting blocks in the scaffold:
87
+
88
+ ```latex
89
+ % Page geometry (南理工学士论文 spec)
90
+ \usepackage[a4paper, top=30mm, bottom=24mm, left=25mm, right=25mm,
91
+ headheight=15pt, headsep=10mm, footskip=20mm]{geometry}
92
+
93
+ % Chinese font: Songti SC + Times New Roman
94
+ \usepackage{fontspec}
95
+ \setmainfont{Times New Roman}
96
+ \setCJKmainfont[AutoFakeBold=2.5]{Songti SC}
97
+
98
+ % Title formatting (南理工 spec)
99
+ \ctexset{
100
+ section = { format = \raggedright\songti\bfseries\zihao{-3},
101
+ beforeskip = 18pt, afterskip = 18pt, break = \clearpage },
102
+ subsection = { format = \raggedright\songti\bfseries\zihao{4},
103
+ beforeskip = 12pt, afterskip = 12pt },
104
+ subsubsection = { format = \raggedright\songti\bfseries\zihao{-4},
105
+ beforeskip = 6pt, afterskip = 6pt },
106
+ }
107
+
108
+ % Fancy header/footer (different odd/even pages)
109
+ \usepackage{fancyhdr}
110
+ \pagestyle{fancy}
111
+ \fancyhf{}
112
+ \fancyhead[CO]{...}\fancyhead[CE]{...}
113
+ \fancyfoot[LE,RO]{\thepage}
114
+ ```
115
+
116
+ Clickable navigation is mandatory: keep `hyperref` enabled, keep
117
+ `\tableofcontents`, and use `\phantomsection` before every manual
118
+ `\addcontentsline` entry such as abstract, appendix, or references. Do not
119
+ replace the generated TOC with plain text page numbers.
120
+
121
+ ### Step 2 — Compile
122
+
123
+ **Preferred — tectonic (no manual package install):**
124
+ ```bash
125
+ cd /path/to/thesis-dir
126
+ tectonic main.tex --outdir . 2>&1
127
+ ```
128
+
129
+ **Fallback — xelatex + bibtex:**
130
+ ```bash
131
+ cd /path/to/thesis-dir
132
+ xelatex main.tex && bibtex main && xelatex main.tex && xelatex main.tex
133
+ ```
134
+
135
+ > Always run xelatex **twice after bibtex** to resolve cross-references and
136
+ > thebibliography page numbers. Three total runs is the safe minimum.
137
+
138
+ ### Step 3 — Verify
139
+
140
+ ```bash
141
+ # 1. Page size must be A4
142
+ pdfinfo main.pdf | grep "Page size"
143
+ # Expected: A4 = 595 x 842 pts (or 210 x 297 mm)
144
+
145
+ # 2. For xelatex: check log for fatal / undefined errors
146
+ grep -i "fatal\|undefined" main.log
147
+ # Must be empty (warnings are OK; tectonic does not emit main.log)
148
+
149
+ # 3. For xelatex: check for undefined references
150
+ grep "undefined reference" main.log
151
+ # Must be empty
152
+
153
+ # 4. For xelatex: check for undefined citations
154
+ grep "undefined" main.log | grep citation
155
+ # Must be empty
156
+
157
+ # 5. Page count spot-check
158
+ pdfinfo main.pdf | grep Pages
159
+ # Confirm reasonable page count
160
+
161
+ # 6. Text extraction spot-check
162
+ pdftotext main.pdf - | head -50
163
+ # Verify Chinese characters render (not CID-glyphs)
164
+
165
+ # 7. Navigation spot-check
166
+ # Open main.pdf and click several TOC entries; they must jump to the intended
167
+ # section pages. If the PDF was merged with an external cover, repeat this check
168
+ # on the final merged PDF because page offsets may change.
169
+ ```
170
+
171
+ ### Step 4 — Merge cover PDF (if external)
172
+
173
+ ```bash
174
+ # 封面 PDF(1页)在前,正文 PDF(1-z)在后
175
+ # 正确顺序:封面 → 正文
176
+ qpdf --empty --pages cover.pdf 1-z body.pdf 1-z -- final.pdf
177
+
178
+ # 验证合并结果
179
+ pdfinfo final.pdf | grep Pages
180
+ pdftotext final.pdf - | head -20
181
+ # Also open final.pdf and spot-click TOC entries; ensure cover merge did not
182
+ # break internal TOC destinations or page offsets.
183
+ ```
184
+
185
+ ---
186
+
187
+ ## Recommended toolchain
188
+
189
+ | Tool | Purpose | Install |
190
+ |---|---|---|
191
+ | `tectonic` | LaTeX compiler, auto-fetches packages | `brew install tectonic` |
192
+ | `xelatex` + `bibtex` | Fallback compile chain | `brew install basictex` |
193
+ | `qpdf` | PDF merge / split | `brew install qpdf` |
194
+ | `pdfinfo` | Verify page size and page count | `brew install poppler` |
195
+ | `pdftotext` | Extract text to verify rendering | `brew install poppler` |
196
+ | `grep` | Check `main.log` for undefined/fatal | system |
197
+
198
+ ---
199
+
200
+ ## Common pitfalls
201
+
202
+ 1. **Missing `\clearpage` before `\section`** — without `break = \clearpage`,
203
+ long sections can cause page geometry violations.
204
+ 2. **Roman → Arabic page numbering gap** — `\newpage\clearpage\pagestyle{plain}`
205
+ before `\pagenumbering{arabic}` prevents orphaned headers.
206
+ 3. **Caption font size ignored** — `\captionsetup{font=...}` must come **after**
207
+ `\usepackage{fontspec}` to avoid interference.
208
+ 4. **`AutoFakeBold` too heavy or too light** — values between 1.5–3.0 are
209
+ typical; 2.5 is a good default for "bold" Songti that matches Word output.
210
+ 5. **`sort&compress` not working** — must use `natbib` with `numbers` option,
211
+ not the default `authoryear`.
212
+ 6. **qpdf merge creates blank pages** — ensure cover PDF page count is
213
+ accounted for; use `qpdf --empty --pages` syntax precisely.
214
+ 7. **Latin Modern / CM fonts for CJK** — always set `\setCJKmainfont`; never
215
+ rely on the LaTeX default font for Chinese characters.
216
+ 8. **Multiple `hyperref` warnings** — load `hyperref` last (or nearly last) to
217
+ avoid option conflicts with `caption`, `subcaption`, `booktabs`.
218
+ 9. **Overfull `\hbox`** — add `\emergencystretch=0.5em` in the preamble.
219
+ 10. **`\ref` vs `\pageref`** — use `\ref` for section/figure numbers; do not
220
+ mix them in a single document without checking context.
221
+ 11. **Plain-text TOC** — never hand-type a static table of contents; use
222
+ `\tableofcontents` with `hyperref` so entries remain clickable. For manual
223
+ front-matter entries, add `\phantomsection` immediately before
224
+ `\addcontentsline` or links jump to the previous page.
225
+
226
+ ---
227
+
228
+ ## Reference
229
+
230
+ | File | Purpose |
231
+ |---|---|
232
+ | [`templates/latex-academic-thesis/source.tex`](templates/latex-academic-thesis/source.tex) | Compact scaffold — all structural components, minimal content |
233
+ | [`templates/latex-academic-thesis/README.md`](templates/latex-academic-thesis/README.md) | Template usage — fill-in-the-blanks recipe |
@@ -0,0 +1,112 @@
1
+ # Guide: LaTeX Technical Book → PDF
2
+
3
+ Use this route for polished Chinese technical books, engineering monographs, source-code reading
4
+ books, algorithm books, systems design books, or long-form book-like content that should be typeset
5
+ with LaTeX rather than HTML.
6
+
7
+ This is distinct from the academic-thesis route. Do not apply university thesis formatting rules
8
+ here unless the user explicitly asks for an academic thesis.
9
+
10
+ ---
11
+
12
+ ## Trigger signatures
13
+
14
+ - “中文技术书 LaTeX 模板”
15
+ - “把这些 HTML 页面整理成一本书”
16
+ - “源码解析书 / 工程实践书 / 多 Agent 平台书稿”
17
+ - “B5 / 16 开技术出版读物”
18
+ - “O'Reilly 风格封面 / 动物封面 / 技术书封面”
19
+ - “代码块、目录、页眉页脚、引文框、结构图都要像书”
20
+
21
+ ---
22
+
23
+ ## Starting point
24
+
25
+ Start from:
26
+
27
+ ```text
28
+ templates/latex-technical-book/source.tex
29
+ ```
30
+
31
+ The template uses a TikZ animal-style placeholder by default, so no binary cover illustration is
32
+ required. If the user provides a real cover image, copy it into `figures/` and replace the
33
+ placeholder block in `source.tex` with an `\includegraphics` call. If the source HTML references an
34
+ image that is absent, tell the user instead of pretending the image exists.
35
+
36
+ ---
37
+
38
+ ## Required workflow
39
+
40
+ 1. **Inspect source structure first**
41
+ - Read cover, TOC, a normal prose page, a code-heavy page, a table-heavy page, and a
42
+ diagram-heavy page.
43
+ - Identify semantic classes: `dropcap`, `pullquote`, `timeline`, `arch-diagram`, `dep-flow`,
44
+ `flow-diagram`, `code`, `table`, etc.
45
+
46
+ 2. **Generate semantic LaTeX, not literal CSS**
47
+ - Preserve headings/sections through `\chapter`, `\section`, `\subsection`.
48
+ - Preserve diagrams by rebuilding them with TikZ or `diagramBox`; do not drop structural
49
+ diagrams.
50
+ - Preserve callouts as `pullquotebox`/`insightbox`/`warningbox`.
51
+ - Preserve inline code as breakable `\path|...|` when ASCII-heavy.
52
+
53
+ 3. **Keep navigation clickable**
54
+ - `hyperref` is mandatory.
55
+ - Keep `\tableofcontents`.
56
+ - Use `\phantomsection` before manual TOC entries.
57
+
58
+ 4. **Compile with XeLaTeX**
59
+ - Use `latexmk -xelatex -interaction=nonstopmode main.tex`.
60
+ - Run enough passes to resolve TOC and links.
61
+
62
+ 5. **Verify before delivery**
63
+ - No fatal LaTeX errors / undefined control sequences.
64
+ - Page size and page count are reasonable.
65
+ - Open and visually inspect cover, TOC, one prose page, one code page, one table/diagram page.
66
+
67
+ ---
68
+
69
+ ## Mapping rules for HTML sources
70
+
71
+ Use semantic mappings rather than literal CSS copying:
72
+
73
+ - `p.dropcap`, `span.dropcap` → `\fancydropcap{首}{剩余文字}` for Chinese prose only; skip
74
+ ASCII/digit starts.
75
+ - `div.pullquote`, `.pull-quote`, `blockquote` → `pullquotebox`.
76
+ - `ul.timeline` with `.year` → `diagramBox` plus `description`.
77
+ - `.arch-diagram`, `.dep-flow` → TikZ diagram inside `diagramBox`.
78
+ - `.flow-diagram`, `.flow-chain`, `.path-diagram`, `.flow-row` → TikZ or structured `diagramBox`;
79
+ preserve all nodes/arrows.
80
+ - Inline `<code>` → `\path+...+` (or another delimiter) when ASCII/path/API-like; escaped normal
81
+ text when CJK-heavy.
82
+ - `<pre><code>` → `lstlisting` with low-saturation highlighting.
83
+ - `<table>` → `tabularx` with ragged `Y` columns; reduce `\tabcolsep`; use `\scriptsize` for many
84
+ columns.
85
+ - `<ul>` / `<ol>` → `enumitem` lists with restrained red marker/number accents.
86
+
87
+ ---
88
+
89
+ ## Design contract
90
+
91
+ - Cover can use the O'Reilly-like framed style from `source.tex`.
92
+ - If using an animal cover, align paper/background tone with the image's edge color to avoid visible
93
+ mismatched rectangles.
94
+ - Avoid overusing accent color. In the template, red is used for rules, TOC numbers, quote bars, and
95
+ small markers — not for body prose.
96
+ - Keep code highlighting muted, not neon.
97
+ - Page header should be short: current section title + page number, not chapter title and section
98
+ title concatenated.
99
+
100
+ ---
101
+
102
+ ## Common pitfalls
103
+
104
+ 1. **Forgetting special HTML blocks** — plain text conversion loses the book feel. Always scan
105
+ classes and map key style semantics.
106
+ 2. **Missing cover assets** — if HTML references a cover image but the file is not present, ask for
107
+ it or use the TikZ placeholder explicitly.
108
+ 3. **Drop caps everywhere** — use on opening prose paragraphs; skip ASCII/digit starts and remove
109
+ when `lettrine` warns near page boundaries.
110
+ 4. **Long code paths overflow** — prefer `\path`, `xurl`, `tabularx`, and manual line breaks for
111
+ extreme cells.
112
+ 5. **Static TOC** — never hand-type TOC. Use LaTeX-generated clickable TOC.