alran 0.0.0-stage → 0.9.0

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 (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -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 +61 -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-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,334 @@
1
+ % =============================================================================
2
+ % Compact template for integration with an empty agent: Nanjing University of Science and Technology bachelor's thesis format
3
+ % Cover all structural components with minimal body text, focusing on format reuse
4
+ % Compile: tectonic main.tex or xelatex && bibtex && xelatex && xelatex
5
+ % =============================================================================
6
+ \documentclass[a4paper, 12pt, twoside]{ctexart}
7
+
8
+ % --- Page setup (A4; top 30mm, bottom 24mm, left/right 25mm; header footskip=20mm) ---
9
+ \usepackage[
10
+ a4paper,
11
+ top=30mm, bottom=24mm, left=25mm, right=25mm,
12
+ headheight=15pt, headsep=10mm, footskip=20mm
13
+ ]{geometry}
14
+
15
+ % --- Body: SimSun, Chinese small size 4, approximately 20pt fixed line spacing ---
16
+ \usepackage{setspace}
17
+ \AtBeginDocument{\zihao{-4}\songti\setlength{\baselineskip}{20pt}\setlength{\parindent}{2em}}
18
+
19
+ % --- Prevent Overfull \hbox by allowing paragraph word spacing to stretch ---
20
+ \emergencystretch=0.5em
21
+
22
+ % --- Font settings ---
23
+ % Chinese: SimSun for body text; synthetic bold SimSun for headings to meet the school's bold-SimSun requirement
24
+ % English and numbers: Times New Roman
25
+ \usepackage{fontspec}
26
+ \setmainfont{Times New Roman}
27
+ \setCJKmainfont[AutoFakeBold=2.5]{Songti SC}
28
+ \setCJKfamilyfont{song}[AutoFakeBold=2.5]{Songti SC}
29
+ \setCJKfamilyfont{hei}{Heiti SC}
30
+
31
+ % --- Mathematical formulas ---
32
+ \usepackage{amsmath, amssymb}
33
+
34
+ % --- Figures and tables ---
35
+ \usepackage{graphicx}
36
+ \graphicspath{{../图表/}}
37
+ \usepackage{float}
38
+ \usepackage{subcaption}
39
+ \DeclareCaptionFont{songwu}{\songti\zihao{5}}
40
+ \captionsetup{font=songwu, labelfont=songwu, labelsep=space}
41
+ \captionsetup[lstlisting]{font=songwu, labelfont=songwu, labelsep=space}
42
+ \usepackage{booktabs}
43
+ \usepackage{multirow}
44
+ \usepackage{longtable}
45
+ \usepackage{tabularx}
46
+ \usepackage{adjustbox}
47
+ \usepackage{afterpage}
48
+
49
+ % --- Number figures, tables, and equations by chapter (Figure X-X, Table X-X, Equation X-X) ---
50
+ \IfFileExists{chngcntr.sty}{\usepackage{chngcntr}}{}
51
+ \counterwithin{figure}{section}
52
+ \counterwithin{table}{section}
53
+ \counterwithin{equation}{section}
54
+ \def\thefigure{\thesection.\arabic{figure}}
55
+ \def\thetable{\thesection.\arabic{table}}
56
+ \def\theequation{\thesection.\arabic{equation}}
57
+
58
+ % --- Code blocks ---
59
+ \usepackage{listings}
60
+ \usepackage{listingsutf8}
61
+ \usepackage{xcolor}
62
+ \lstset{
63
+ basicstyle=\zihao{5}\ttfamily,
64
+ columns=fullflexible,
65
+ keepspaces=true,
66
+ literate={,}{{,}}1 {。}{{。}}1 {:}{{:}}1 {;}{{;}}1
67
+ {(}{{(}}1 {)}{{)}}1 {、}{{、}}1,
68
+ keywordstyle=\color{blue},
69
+ commentstyle=\color{gray},
70
+ stringstyle=\color{red!70!black},
71
+ numbers=left,
72
+ numberstyle=\tiny\color{gray},
73
+ frame=single,
74
+ breaklines=true,
75
+ tabsize=4,
76
+ }
77
+
78
+ % --- Cross-references and hyperlinks (load hyperref as late as possible) ---
79
+ \usepackage{hyperref}
80
+ \hypersetup{
81
+ colorlinks=true,
82
+ linkcolor=black,
83
+ citecolor=black,
84
+ urlcolor=black,
85
+ }
86
+
87
+ % --- References (GB/T 7714-2015 numeric style; sort&compress compacts citation numbers) ---
88
+ % Use natbib + gbt7714-numerical; for BibTeX, run xelatex twice, bibtex, then xelatex twice
89
+ \usepackage[numbers,sort&compress]{natbib}
90
+ \bibliographystyle{gbt7714-numerical}
91
+
92
+ % --- Headers and footers (different odd/even pages, page numbers on the outside) ---
93
+ % Even pages (CE): chapter title on the left, "Bachelor's Thesis" on the right
94
+ % Odd pages (CO): "Bachelor's Thesis" on the left, chapter title on the right
95
+ % Page numbers at LE (left even) and RO (right odd), i.e. the outer edges
96
+ \usepackage{fancyhdr}
97
+ \pagestyle{fancy}
98
+ \fancyhf{}
99
+ % Correct sectionmark definition; must precede its use
100
+ \makeatletter
101
+ \def\sectionmark#1{\markboth{\thesection\quad #1}{}}
102
+ \makeatother
103
+ \fancyhead[CO]{\songti\zihao{5} 学士学位论文\hfill <论文题目(简)>}
104
+ \fancyhead[CE]{\songti\zihao{5} \leftmark\hfill 学士学位论文}
105
+ \fancyfoot[LE,RO]{\songti\zihao{5}\thepage}
106
+ \fancypagestyle{plain}{%
107
+ \fancyhf{}%
108
+ \fancyhead[CO]{\songti\zihao{5} 学士学位论文\hfill <论文题目(简)>}%
109
+ \fancyhead[CE]{\songti\zihao{5} \leftmark\hfill 学士学位论文}%
110
+ \fancyfoot[LE,RO]{\songti\zihao{5}\thepage}%
111
+ }
112
+
113
+ % --- TOC depth: include three heading levels ---
114
+ % tocloft: \cftsecnumdepth=3 includes section/sub/subsub levels
115
+ \IfFileExists{tocloft.sty}{\usepackage[titles]{tocloft}}{}
116
+ \def\contentsname{目\quad 录}
117
+ \def\refname{参考文献}
118
+
119
+ % --- Chapter heading format (school requirements) ---
120
+ \ctexset{
121
+ section = {
122
+ format = \raggedright\songti\bfseries\zihao{-3},
123
+ beforeskip = 18pt,
124
+ afterskip = 18pt,
125
+ break = \clearpage,
126
+ },
127
+ subsection = {
128
+ format = \raggedright\songti\bfseries\zihao{4},
129
+ beforeskip = 12pt,
130
+ afterskip = 12pt,
131
+ },
132
+ subsubsection = {
133
+ format = \raggedright\songti\bfseries\zihao{-4},
134
+ beforeskip = 6pt,
135
+ afterskip = 6pt,
136
+ },
137
+ paragraph = {
138
+ format = \raggedright\songti\zihao{-4},
139
+ beforeskip = 6pt,
140
+ afterskip = 0pt,
141
+ },
142
+ }
143
+
144
+ % --- Custom commands ---
145
+ \newcommand{\frontmattertitle}[1]{%
146
+ \vspace*{18pt}\begin{center}{\songti\bfseries\zihao{3}#1}\end{center}\vspace{18pt}}
147
+ \newcommand{\centeredsectionstar}[1]{%
148
+ \clearpage\phantomsection\vspace*{18pt}\begin{center}{\songti\bfseries\zihao{3}#1}\end{center}\vspace{18pt}}
149
+
150
+ % =============================================================================
151
+ \begin{document}
152
+
153
+ % ========================== Abstract ==========================
154
+ \newpage
155
+ \pagestyle{plain}
156
+ \pagenumbering{roman}
157
+
158
+ \frontmattertitle{摘\quad 要}
159
+ \phantomsection
160
+ \addcontentsline{toc}{section}{摘要}
161
+
162
+ 本文针对XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
163
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
164
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
165
+
166
+ \vspace{1cm}
167
+ \noindent{\songti\bfseries\zihao{4} 关键词:}{\songti\zihao{-4} 关键词1;关键词2;关键词3}
168
+
169
+ % ========================== Abstract ==========================
170
+ \newpage
171
+ \markboth{Abstract}{}
172
+ \begin{center}{\bfseries\zihao{3} Abstract}\end{center}\vspace{18pt}
173
+ \phantomsection
174
+ \addcontentsline{toc}{section}{Abstract}
175
+
176
+ This thesis presents a systematic study of XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
177
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
178
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
179
+
180
+ \vspace{1cm}
181
+ \noindent{\bfseries\zihao{4} Keywords:}{\zihao{-4} keyword1; keyword2; keyword3}
182
+
183
+ % ========================== Table of contents ==========================
184
+ \newpage
185
+ \markboth{目\quad 录}{}
186
+ \begingroup
187
+ \def\contentsname{目\quad 录}
188
+ \tableofcontents
189
+ \endgroup
190
+ % For duplex printing, add a blank page if the front matter has an odd page count
191
+ \ifodd\value{page}\newpage\thispagestyle{empty}\mbox{}\fi
192
+
193
+ % ========================== Main text ==========================
194
+ \newpage
195
+ \pagestyle{fancy}
196
+ \pagenumbering{arabic}
197
+
198
+ % ========================================================================
199
+ % Chapter 1: Introduction
200
+ % ========================================================================
201
+ \section{绪论}
202
+
203
+ \subsection{研究背景与意义}
204
+
205
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
206
+ 如图\ref{fig:architecture}所示,XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
207
+
208
+ \begin{figure}[H]
209
+ \centering
210
+ \includegraphics[width=0.65\textwidth]{architecture.jpg}
211
+ \caption{系统架构图}
212
+ \label{fig:architecture}
213
+ \end{figure}
214
+
215
+ \subsection{国内外研究现状}
216
+
217
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
218
+ 文献\cite{author2024example}提出了XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
219
+
220
+ \subsubsection{Linux调度器研究}
221
+
222
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
223
+
224
+ % Use paragraph for level-four headings; school requirements generally omit subsubsubsection
225
+ \paragraph{相关技术基础}
226
+
227
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
228
+
229
+ \subsection{本文创新点}
230
+
231
+ 本文主要创新点如下:
232
+
233
+ \begin{enumerate}
234
+ \item 创新点一:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
235
+ \item 创新点二:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
236
+ \end{enumerate}
237
+
238
+ % ========================================================================
239
+ % Chapter 2: Technical Background
240
+ % ========================================================================
241
+ \section{相关技术基础}
242
+
243
+ 本章介绍XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
244
+
245
+ \subsection{Linux调度器原理}
246
+
247
+ CFS的核心思想是XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
248
+ 虚拟运行时间的计算如式\eqref{eq:vruntime}所示。
249
+
250
+ \begin{equation}
251
+ \Delta vruntime = \Delta t_{wall} \times \frac{NICE\_0\_LOAD}{weight(task)}
252
+ \label{eq:vruntime}
253
+ \end{equation}
254
+
255
+ 表\ref{tab:cfs-params}列出了CFS的核心可调参数及其语义。
256
+
257
+ \begin{table}[H]
258
+ \centering
259
+ \caption{CFS核心可调参数}
260
+ \label{tab:cfs-params}
261
+ \begin{tabular}{lll}
262
+ \toprule
263
+ \textbf{参数名称} & \textbf{基准值} & \textbf{语义} \\
264
+ \midrule
265
+ \texttt{sched\_latency\_ns} & 6\,ms & 调度周期目标 \\
266
+ \texttt{sched\_min\_granularity\_ns} & 0.75\,ms & 最小抢占粒度 \\
267
+ \bottomrule
268
+ \end{tabular}
269
+ \end{table}
270
+
271
+ % ========================================================================
272
+ % Chapter 3: System Design
273
+ % ========================================================================
274
+ \section{系统设计}
275
+
276
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
277
+
278
+ \subsection{总体架构}
279
+
280
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
281
+
282
+ \section{实验与分析}
283
+
284
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
285
+
286
+ % ========================================================================
287
+ % References
288
+ % ========================================================================
289
+ % Reference page numbers continue in Arabic numerals from the main text; do not switch back to Roman numerals
290
+ % For BibTeX, replace \begin{thebibliography}... with
291
+ % \bibliography{refs}, then run xelatex && bibtex && xelatex && xelatex
292
+ \newpage
293
+ \begin{thebibliography}{99}
294
+ \bibitem{author2024example} Author A, Author B. Title of the reference[J].
295
+ Journal Name, 2024, 1(1): 1-10. DOI: 10.0000/example.
296
+ \bibitem{linuxkernel} Linux Kernel Documentation[EB/OL].
297
+ \url{https://www.kernel.org/doc/html/latest/}.
298
+ \end{thebibliography}
299
+
300
+ % ========================== Appendix ==========================
301
+ \appendix
302
+ \centeredsectionstar{附\quad 录}
303
+ \markboth{附\quad 录}{}
304
+ \addcontentsline{toc}{section}{附录}
305
+
306
+ \subsection*{附录A:实验配置}
307
+
308
+ 表~\ref{tab:appendix-configs}列出了实验配置。
309
+
310
+ \begin{table}[H]
311
+ \centering
312
+ \caption{实验配置表}
313
+ \label{tab:appendix-configs}
314
+ \begin{tabular}{llr}
315
+ \toprule
316
+ \textbf{参数} & \textbf{符号} & \textbf{值} \\
317
+ \midrule
318
+ CPU核心数 & $N$ & 4 \\
319
+ 调度周期 & $T$ & 10\,ms \\
320
+ \bottomrule
321
+ \end{tabular}
322
+ \end{table}
323
+
324
+ \subsection*{附录B:核心代码}
325
+
326
+ \begin{lstlisting}[language=C, caption={示例代码}, label={lst:sample}]
327
+ #include <stdio.h>
328
+ int main() {
329
+ printf("Hello, World!\n");
330
+ return 0;
331
+ }
332
+ \end{lstlisting}
333
+
334
+ \end{document}
@@ -0,0 +1,130 @@
1
+ # LaTeX Technical Book Template
2
+
3
+ Use this template when the user wants a Chinese technical book / engineering monograph / source-code
4
+ reading book / algorithm or systems book in a polished LaTeX book format rather than a short HTML
5
+ report.
6
+
7
+ ## When to use
8
+
9
+ Trigger examples:
10
+
11
+ - “把这些 HTML/Markdown 章节做成一本技术书”
12
+ - “中文技术书 LaTeX 模板”
13
+ - “源码解析书 / 工程实践书 / 算法书排版”
14
+ - “B5/16 开,目录、页眉页脚、代码块、引文框、结构图”
15
+ - “O'Reilly 风格封面 / 动物封面 / 技术出版读物”
16
+
17
+ Do **not** use this for academic thesis formatting; use `templates/latex-academic-thesis/` and
18
+ `docs/latex-academic-thesis-guide.md` instead.
19
+
20
+ ## Files
21
+
22
+ - `source.tex` — compact generic scaffold with final technical-book style.
23
+ - `source.tex` includes a TikZ animal-style placeholder cover illustration. Replace that block with
24
+ an `\includegraphics` call only when the user supplies a real cover image.
25
+ - `README.template-source.md` — the source project README retained for context.
26
+
27
+ ## Style features
28
+
29
+ The scaffold includes:
30
+
31
+ - B5 / 16 开 page size: `176mm × 250mm`.
32
+ - O'Reilly-like framed cover with top/bottom red bars, optional animal illustration, publisher mark,
33
+ and old-cover fallback command `\maketechbooktitleClassic` that is not used by default.
34
+ - Clickable `hyperref` table of contents with black text and red number/page accents.
35
+ - Running header showing current section title + page number; footer with book title / publisher /
36
+ page number.
37
+ - Low-saturation code highlighting with `listings` and robust line breaking.
38
+ - Inline code/path support through `xurl` / `\path|...|` to prevent long API paths from overflowing.
39
+ - `insightbox`, `pullquotebox`, `diagramBox`, `warningbox`, theorem/definition/example boxes,
40
+ exercises.
41
+ - `\fancydropcap{首}{段剩余文字}` for chapter/section opening paragraphs.
42
+ - `tabularx` ragged columns (`Y`) for robust technical tables.
43
+
44
+ ## Copy-and-fill workflow
45
+
46
+ ```bash
47
+ mkdir -p /tmp/technical-book
48
+ cp templates/latex-technical-book/source.tex /tmp/technical-book/main.tex
49
+ mkdir -p /tmp/technical-book/figures /tmp/technical-book/chapters /tmp/technical-book/backmatter
50
+ ```
51
+
52
+ Then edit:
53
+
54
+ 1. Book metadata in `main.tex`:
55
+ - `\BookTitle`
56
+ - `\BookTitleDetail`
57
+ - `\BookAuthor`
58
+ - `\BookPublisher`
59
+ - `\BookYear`
60
+ 2. Replace the preface text.
61
+ 3. Replace `\input{chapters/chapter01}` etc. with the actual chapter files.
62
+ 4. Replace the TikZ placeholder in `source.tex` only if the user supplied a cover illustration.
63
+ 5. Keep `\tableofcontents`, `hyperref`, and `\phantomsection` entries intact so navigation remains
64
+ clickable.
65
+
66
+ ## HTML/Markdown → book conversion guidance
67
+
68
+ When source content is structured HTML pages:
69
+
70
+ - Inspect representative pages first: cover, TOC, first section, code-heavy page, table-heavy page,
71
+ diagram-heavy page.
72
+ - Preserve semantic blocks, not CSS literally:
73
+ - `p.dropcap` or leading `<span class="dropcap">` → `\fancydropcap{...}{...}` for Chinese prose
74
+ only; avoid ASCII/digit drop caps.
75
+ - `div.pullquote`, `blockquote`, `.pull-quote` → `pullquotebox`.
76
+ - `ul.timeline` / `.year` spans → `diagramBox + description`.
77
+ - `arch-diagram`, `dep-flow`, `flow-diagram`, `flow-chain`, `path-diagram`, `flow-row` → rebuild
78
+ as LaTeX/TikZ or a `diagramBox`; do not drop diagrams silently.
79
+ - `code` inline → `\path|...|` for ASCII paths/API names; plain escaped text for CJK-heavy inline
80
+ snippets.
81
+ - `pre code` → `lstlisting` with low-saturation highlighting.
82
+ - `table` → `tabularx` with `Y` columns, small font, reduced `\tabcolsep`.
83
+ - `ul`/`ol` feature lists → `enumitem` lists with red bullet/number accents.
84
+ - If the source references an image (`<img src="...">`) but the file is missing, report it. Do not
85
+ invent that image; use a simple placeholder only when the user approves or supplies the asset.
86
+
87
+ ## Compile
88
+
89
+ Preferred for this template: XeLaTeX via latexmk.
90
+
91
+ ```bash
92
+ PATH="/usr/local/texlive/2026/bin/universal-darwin:$PATH" \
93
+ latexmk -xelatex -interaction=nonstopmode main.tex
94
+ ```
95
+
96
+ Fallback manual chain:
97
+
98
+ ```bash
99
+ xelatex -interaction=nonstopmode main.tex
100
+ bibtex main || true
101
+ makeindex main || true
102
+ xelatex -interaction=nonstopmode main.tex
103
+ xelatex -interaction=nonstopmode main.tex
104
+ ```
105
+
106
+ ## Verification gates
107
+
108
+ Run these before delivery:
109
+
110
+ ```bash
111
+ pdfinfo main.pdf | grep -E 'Pages|Page size'
112
+ grep -i "fatal\|undefined control sequence\|LaTeX Error" main.log
113
+ pdftotext main.pdf - | head -80
114
+ ```
115
+
116
+ Expected:
117
+
118
+ - Page size is B5-like `176mm × 250mm` unless the user requested A4.
119
+ - No fatal LaTeX errors or undefined control sequences.
120
+ - Chinese text extracts correctly.
121
+ - TOC entries are clickable when opened in a PDF viewer.
122
+
123
+ ## Common warnings
124
+
125
+ - `Overfull/Underfull hbox` can occur in very long code paths or dense tables. Reduce by using
126
+ `\path`, smaller table font, `tabularx` `Y` columns, or manually splitting the cell.
127
+ - `lettrine` warnings mean a drop cap is too close to a page boundary. For final publishing, remove
128
+ `\fancydropcap` on that paragraph or insert a local page break.
129
+ - Font shape warnings for CJK italics/small caps are usually harmless; avoid relying on italic CJK
130
+ for semantic meaning.
@@ -0,0 +1,62 @@
1
+ # 中文技术出版读物 LaTeX 模板
2
+
3
+ 这是一个面向中文技术书出版的 LaTeX 模板,适合计算机科学教材、算法书、系统设计书、工程实践类专著。模板采用 B5
4
+ / 16 开近似尺寸 `176mm × 250mm`,比 A4 更接近正式中文技术书样张。
5
+
6
+ ## 编译
7
+
8
+ ```bash
9
+ latexmk -xelatex -interaction=nonstopmode main.tex
10
+ ```
11
+
12
+ 或手动:
13
+
14
+ ```bash
15
+ xelatex main.tex
16
+ bibtex main
17
+ makeindex main
18
+ xelatex main.tex
19
+ xelatex main.tex
20
+ ```
21
+
22
+ ## 文件结构
23
+
24
+ ```text
25
+ technical-book-latex-template/
26
+ ├── main.tex
27
+ ├── references.bib
28
+ ├── frontmatter/
29
+ │ ├── copyright.tex
30
+ │ └── preface.tex
31
+ ├── chapters/
32
+ │ ├── chapter01.tex
33
+ │ ├── chapter02.tex
34
+ │ └── chapter03.tex
35
+ ├── backmatter/
36
+ │ └── appendix.tex
37
+ └── figures/
38
+ ```
39
+
40
+ ## 主要特性
41
+
42
+ - B5 / 16 开中文技术书版式:`176mm × 250mm`。
43
+ - 双面排版,章节默认右页开始。
44
+ - 中文环境名:定义、定理、例、要点提示、常见误区、习题、本章延伸阅读。
45
+ - 支持算法伪代码、代码清单、表格、参考文献和索引。
46
+ - 使用 `hyperref` 生成可点击目录和引用。
47
+
48
+ ## 正式出版前建议
49
+
50
+ 正式交付出版社前,请确认:开本、版心、页边距、字体授权、ISBN、版权页、CIP 信息、图表分辨率和印刷出血规范。
51
+
52
+ ## 当前风格
53
+
54
+ 本模板已更新为与 `harness-book` 成书版一致的技术出版风格,但保留通用占位内容:
55
+
56
+ - O'Reilly / 技术动物封面风格,默认使用 TikZ 动物线稿占位;旧封面保留为
57
+ `\maketechbooktitleClassic`,默认不编译。
58
+ - 目录编号与页码采用红色强调,正文目录文字保持黑色。
59
+ - 正文包含首字下沉、引文框、提示框、图示框、低饱和代码高亮、自动换行的行内代码路径等样式。
60
+ - 页眉仅显示当前小节标题,页脚显示书名、出版标识与页码。
61
+
62
+ 正式成书时,建议替换 `main.tex` 中的书籍元数据、前言、章节文件与封面插图。