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.
- package/ALRAN_TOOLS_NOTICES.md +75 -0
- package/LICENSE +27 -0
- package/LICENSE-STATUS.md +21 -0
- package/NOTICE +6 -0
- package/README.md +284 -2
- package/THIRD_PARTY_NOTICES.md +113 -0
- package/alran-tools.js +3 -0
- package/assets/agents/_default/prompt-auto_classifier.md +185 -0
- package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
- package/assets/agents/_default/prompt-base-all.md +133 -0
- package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
- package/assets/agents/_default/prompt-base-windows.md +5 -0
- package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
- package/assets/agents/_default/prompt-base-worker.md +10 -0
- package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
- package/assets/agents/_default/prompt-compact.md +76 -0
- package/assets/agents/_default/prompt-compact_continue.md +9 -0
- package/assets/agents/_default/prompt-git.md +8 -0
- package/assets/agents/_default/prompt-goal.md +13 -0
- package/assets/agents/_default/prompt-session-branch.md +3 -0
- package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
- package/assets/agents/_default/prompt-session-root.md +3 -0
- package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
- package/assets/agents/_default/prompt-title.md +11 -0
- package/assets/agents/_default/prompt-tool_agent.md +22 -0
- package/assets/agents/_migration/README.md +20 -0
- package/assets/agents/_migration/coder/PERSONA.md +11 -0
- package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
- package/assets/agents/_migration/general/PERSONA.md +11 -0
- package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
- package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
- package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
- package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
- package/assets/agents/_v2/explore.md.hbs +38 -0
- package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
- package/assets/agents/_v2/verifier.md.hbs +32 -0
- package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
- package/assets/agents/_v2/worker.md.hbs +27 -0
- package/assets/agents/alran/PERSONA.md +7 -0
- package/assets/agents/alran/features/cron.md.hbs +0 -0
- package/assets/agents/alran/features/delegation.md.hbs +56 -0
- package/assets/agents/alran/features/memory.md.hbs +61 -0
- package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
- package/assets/agents/alran/features/task-management.md.hbs +11 -0
- package/assets/agents/alran/features/web-search.md.hbs +11 -0
- package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
- package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
- package/assets/agents/alran/prompt-session-root.md +4 -0
- package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
- package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
- package/assets/agents/alran/skills/alran-code-product/references/account-models.md +64 -0
- package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
- package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
- package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
- package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
- package/assets/agents/alran/system-prompt.md.hbs +97 -0
- package/assets/agents/builtin-agents.json +1 -0
- package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
- package/assets/agents/desktop-task/checkpoint/system.md +19 -0
- package/assets/agents/desktop-task/output-revision/system.md +1 -0
- package/assets/agents/desktop-task/retry/continuation.md +4 -0
- package/assets/agents/desktop-task/session-title/system.md +41 -0
- package/assets/agents/explore/PERSONA.md +8 -0
- package/assets/agents/explore/agent.md +14 -0
- package/assets/agents/explore/system-prompt.md.hbs +35 -0
- package/assets/agents/greeting.md +61 -0
- package/assets/agents/managed-prompts.json +47 -0
- package/assets/agents/prompt-exemptions.json +36 -0
- package/assets/agents/verifier/PERSONA.md +8 -0
- package/assets/agents/verifier/agent.md +17 -0
- package/assets/agents/verifier/system-prompt.md.hbs +28 -0
- package/assets/agents/worker/PERSONA.md +8 -0
- package/assets/agents/worker/agent.md +18 -0
- package/assets/agents/worker/system-prompt.md.hbs +22 -0
- package/assets/agents/workflow/code-review/review-candidates.md +120 -0
- package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
- package/assets/agents/workflow/goal/budget-limit.md +16 -0
- package/assets/agents/workflow/goal/continuation.md +62 -0
- package/assets/agents/workflow/goal/objective-updated.md +16 -0
- package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
- package/assets/agents/workflow/goal/recovery.md +11 -0
- package/assets/agents/workflow/goal/terminal-audit.md +10 -0
- package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
- package/assets/agents/workflow/prompt-hook/system.md +0 -0
- package/assets/models-dev-catalog.json.gz +0 -0
- package/assets/prompts/code-review/review-candidates.md +120 -0
- package/assets/prompts/code-review/reviewer-system.md +75 -0
- package/assets/skills/alran-tools-master/SKILL.md +127 -0
- package/assets/skills/code-review/SKILL.md +51 -0
- package/assets/skills/cu-desktop/SKILL.md +255 -0
- package/assets/skills/deep-research/SKILL.md +30 -0
- package/assets/skills/deploy-website/SKILL.md +52 -0
- package/assets/skills/docx/LICENSE +21 -0
- package/assets/skills/docx/SKILL.md +259 -0
- package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
- package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
- package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
- package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
- package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
- package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
- package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
- package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
- package/assets/skills/docx/docs/acceptance.md +139 -0
- package/assets/skills/docx/docs/anti-patterns.md +14 -0
- package/assets/skills/docx/docs/backends.md +116 -0
- package/assets/skills/docx/docs/evidence.md +73 -0
- package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
- package/assets/skills/docx/docs/index.md +50 -0
- package/assets/skills/docx/docs/rendered-delivery.md +125 -0
- package/assets/skills/docx/docs/router.md +122 -0
- package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
- package/assets/skills/docx/docs/task-apply-template.md +141 -0
- package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
- package/assets/skills/docx/docs/task-create.md +124 -0
- package/assets/skills/docx/docs/task-edit-fill.md +69 -0
- package/assets/skills/docx/docs/task-read-content.md +148 -0
- package/assets/skills/docx/docs/task-read-rendered.md +78 -0
- package/assets/skills/docx/docs/task-read-structure.md +93 -0
- package/assets/skills/docx/docs/task-repair-layout.md +70 -0
- package/assets/skills/docx/docs/template-dsl.md +32 -0
- package/assets/skills/docx/docs/track-changes.md +15 -0
- package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
- package/assets/skills/docx/references/cjk_typography.md +357 -0
- package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
- package/assets/skills/docx/references/comments_guide.md +191 -0
- package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
- package/assets/skills/docx/references/design_principles.md +819 -0
- package/assets/skills/docx/references/openxml_element_order.md +308 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/assets/skills/docx/references/openxml_namespaces.md +82 -0
- package/assets/skills/docx/references/openxml_units.md +72 -0
- package/assets/skills/docx/references/sample-patch-plans.json +22 -0
- package/assets/skills/docx/references/sample-task-intents.json +5 -0
- package/assets/skills/docx/references/sample-template-manifests.json +21 -0
- package/assets/skills/docx/references/scenario_a_create.md +284 -0
- package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
- package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
- package/assets/skills/docx/references/track_changes_guide.md +200 -0
- package/assets/skills/docx/references/troubleshooting.md +506 -0
- package/assets/skills/docx/references/typography_guide.md +294 -0
- package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
- package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
- package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
- package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
- package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
- package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
- package/assets/skills/docx/scripts/docx_preview.sh +37 -0
- package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
- package/assets/skills/docx/scripts/env_check.ps1 +327 -0
- package/assets/skills/docx/scripts/env_check.sh +340 -0
- package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
- package/assets/skills/docx/scripts/pack_docx.py +31 -0
- package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
- package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
- package/assets/skills/docx/scripts/rendered_report.py +609 -0
- package/assets/skills/docx/scripts/setup.ps1 +542 -0
- package/assets/skills/docx/scripts/setup.sh +537 -0
- package/assets/skills/docx/scripts/unpack_docx.py +29 -0
- package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
- package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
- package/assets/skills/edit-deployed-website/SKILL.md +27 -0
- package/assets/skills/init/SKILL.md +135 -0
- package/assets/skills/llm-call/SKILL.md +48 -0
- package/assets/skills/llm-call/scripts/llm_call.py +458 -0
- package/assets/skills/pdf/SKILL.md +280 -0
- package/assets/skills/pdf/docs/advanced-reference.md +711 -0
- package/assets/skills/pdf/docs/create-guide.md +437 -0
- package/assets/skills/pdf/docs/design-guide.md +204 -0
- package/assets/skills/pdf/docs/forms-guide.md +462 -0
- package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
- package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
- package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
- package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
- package/assets/skills/pdf/docs/read-guide.md +358 -0
- package/assets/skills/pdf/docs/reformat-guide.md +238 -0
- package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
- package/assets/skills/pdf/docs/troubleshooting.md +86 -0
- package/assets/skills/pdf/docs/vision-guide.md +188 -0
- package/assets/skills/pdf/scripts/__init__.py +0 -0
- package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
- package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
- package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
- package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
- package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
- package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
- package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
- package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
- package/assets/skills/pdf/scripts/make.sh +388 -0
- package/assets/skills/pdf/scripts/merge.py +112 -0
- package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
- package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
- package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
- package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
- package/assets/skills/pdf/scripts/render/__init__.py +0 -0
- package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
- package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
- package/assets/skills/pdf/scripts/render_html.cjs +205 -0
- package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
- package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
- package/assets/skills/pdf/templates/INDEX.md +90 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
- package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
- package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
- package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
- package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
- package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
- package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
- package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
- package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
- package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
- package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
- package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
- package/assets/skills/pptx/SKILL.md +283 -0
- package/assets/skills/pptx/references/design-system.md +424 -0
- package/assets/skills/pptx/references/editing.md +162 -0
- package/assets/skills/pptx/references/element-map.md +229 -0
- package/assets/skills/pptx/references/pitfalls.md +205 -0
- package/assets/skills/pptx/references/pptxgenjs.md +420 -0
- package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
- package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
- package/assets/skills/pptx/references/slide-types.md +413 -0
- package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
- package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
- package/assets/skills/pptx/scripts/extract_comments.py +468 -0
- package/assets/skills/pptx/scripts/extract_images.py +226 -0
- package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
- package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
- package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
- package/assets/skills/resume-codex/SKILL.md +53 -0
- package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
- package/assets/skills/skill-creator/SKILL.md +188 -0
- package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
- package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
- package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
- package/assets/skills/skill-creator/references/description-rubric.md +83 -0
- package/assets/skills/skill-creator/references/skill-template.md +101 -0
- package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
- package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
- package/assets/skills/skill-refiner/SKILL.md +137 -0
- package/assets/skills/visual-page/SKILL.md +194 -0
- package/assets/skills/x-link-reader/SKILL.md +108 -0
- package/assets/skills/xlsx/SKILL.md +498 -0
- package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
- package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
- package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
- package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
- package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
- package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
- package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
- package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
- package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/assets/skills/xlsx/scripts/office/pack.py +159 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
- package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
- package/assets/skills/xlsx/scripts/office/validate.py +117 -0
- package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
- package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
- package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
- package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
- package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
- package/assets/skills/xlsx/scripts/recalc.py +450 -0
- package/chunks/account-commands-GW7N3MYC.js +2 -0
- package/chunks/anthropic-63VE6MAE.js +2 -0
- package/chunks/application-WPPTE6LU.js +2 -0
- package/chunks/auth-command-36RMNQZW.js +2 -0
- package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
- package/chunks/chunk-2AYWJZ72.js +2 -0
- package/chunks/chunk-2K5H5GA7.js +2 -0
- package/chunks/chunk-2TF6JAQM.js +2 -0
- package/chunks/chunk-3AODGLMF.js +2 -0
- package/chunks/chunk-3GGKARES.js +2 -0
- package/chunks/chunk-4CN3IJFH.js +2 -0
- package/chunks/chunk-4XP5XUIZ.js +2 -0
- package/chunks/chunk-5DQTVSQV.js +131 -0
- package/chunks/chunk-5RIMHTEU.js +207 -0
- package/chunks/chunk-5Y76VFHY.js +2 -0
- package/chunks/chunk-6DOVXX7W.js +2 -0
- package/chunks/chunk-6P4UKHGR.js +2 -0
- package/chunks/chunk-6PFI65C6.js +5 -0
- package/chunks/chunk-6UXSIWCB.js +2 -0
- package/chunks/chunk-7XYOYZX2.js +2 -0
- package/chunks/chunk-AGUSPIUP.js +2 -0
- package/chunks/chunk-BQ3CF3KE.js +2 -0
- package/chunks/chunk-C6LAAFG2.js +30 -0
- package/chunks/chunk-CUG7F2FN.js +2 -0
- package/chunks/chunk-D66ZSHXR.js +2 -0
- package/chunks/chunk-D7MGU75P.js +2 -0
- package/chunks/chunk-DFMYLGVU.js +249 -0
- package/chunks/chunk-EJN3SE5B.js +16 -0
- package/chunks/chunk-F46IELF5.js +2 -0
- package/chunks/chunk-G5MOGPZ3.js +6711 -0
- package/chunks/chunk-GP52JZMY.js +2 -0
- package/chunks/chunk-HNWBFJNO.js +2 -0
- package/chunks/chunk-IC6A323Q.js +2 -0
- package/chunks/chunk-IN2Z5SSJ.js +164 -0
- package/chunks/chunk-JSTSFMGK.js +70 -0
- package/chunks/chunk-K5DTFR6D.js +29 -0
- package/chunks/chunk-LCC45PCZ.js +29 -0
- package/chunks/chunk-LU4RPLJ3.js +2 -0
- package/chunks/chunk-LZJYNT32.js +2 -0
- package/chunks/chunk-MACBL5HF.js +2 -0
- package/chunks/chunk-MPQ6G7LH.js +1085 -0
- package/chunks/chunk-MUXNNOSQ.js +3 -0
- package/chunks/chunk-N5NTXCJI.js +2 -0
- package/chunks/chunk-N6W7ZL26.js +2 -0
- package/chunks/chunk-NBONSNQZ.js +38 -0
- package/chunks/chunk-NMKRNU5O.js +2 -0
- package/chunks/chunk-NVPGGFT3.js +2 -0
- package/chunks/chunk-NZXJAHTO.js +9 -0
- package/chunks/chunk-OTDNOWXG.js +16 -0
- package/chunks/chunk-PCL2CVVE.js +2 -0
- package/chunks/chunk-PXH4SBCS.js +3 -0
- package/chunks/chunk-QKBN5CGI.js +2 -0
- package/chunks/chunk-QPGTKSIQ.js +2 -0
- package/chunks/chunk-R44C5DM6.js +2 -0
- package/chunks/chunk-RLJVY75P.js +28 -0
- package/chunks/chunk-RLND4AYL.js +4 -0
- package/chunks/chunk-SIOLUFGG.js +2 -0
- package/chunks/chunk-TJC4LPRQ.js +2 -0
- package/chunks/chunk-U3RMPDXU.js +2 -0
- package/chunks/chunk-U4PFHJ7Z.js +27 -0
- package/chunks/chunk-UJCAE7SG.js +3 -0
- package/chunks/chunk-V2SB4U4D.js +2 -0
- package/chunks/chunk-VGKKKM2W.js +6 -0
- package/chunks/chunk-VLXX22YO.js +2 -0
- package/chunks/chunk-VUISZDXX.js +24 -0
- package/chunks/chunk-W5ZOLW7T.js +2 -0
- package/chunks/chunk-WHD2XVT2.js +2 -0
- package/chunks/chunk-XLVABFJC.js +9 -0
- package/chunks/chunk-XQK7JM66.js +2 -0
- package/chunks/chunk-XSEU4WQD.js +7 -0
- package/chunks/chunk-XVGPB7TW.js +21 -0
- package/chunks/chunk-Z5HOCNTZ.js +2 -0
- package/chunks/chunk-ZDI22NOK.js +7 -0
- package/chunks/chunk-ZQKVUPKA.js +2 -0
- package/chunks/clipboard-image-PQPC4EHR.js +2 -0
- package/chunks/data-dir-OEPRRIOO.js +2 -0
- package/chunks/dist-VKYZJYR6.js +11 -0
- package/chunks/dist-WGTMUM3E.js +5 -0
- package/chunks/emscripten-module-3WGSFZYF.js +2 -0
- package/chunks/emscripten-module-74WUXTHL.js +2 -0
- package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
- package/chunks/emscripten-module-NEAT5LGD.js +2 -0
- package/chunks/ffi-EFLUAAVX.js +2 -0
- package/chunks/ffi-JIGPPPF7.js +2 -0
- package/chunks/ffi-QKKA5HYI.js +2 -0
- package/chunks/ffi-RLX77WFG.js +2 -0
- package/chunks/google-RCR46TTQ.js +2 -0
- package/chunks/google-vertex-Y26T7YYR.js +2 -0
- package/chunks/install-source-63OVVBMK.js +2 -0
- package/chunks/launcher-2UG3JPYF.js +63 -0
- package/chunks/lifecycle-5IPJRP2V.js +2 -0
- package/chunks/main-7SGOQBHZ.js +13 -0
- package/chunks/mistral-NEBDKUEI.js +3 -0
- package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
- package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
- package/chunks/multipart-parser-JVSLI2CL.js +2 -0
- package/chunks/network-proxy-AJO7ZW3O.js +2 -0
- package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
- package/chunks/openai-completions-C4PHW6MD.js +2 -0
- package/chunks/openai-responses-5NVFOW4Y.js +2 -0
- package/chunks/openrouter-BKUGQT7Z.js +2 -0
- package/chunks/otel-DRJM2PIX.js +2 -0
- package/chunks/package-contract-GVXTMJ3N.js +2 -0
- package/chunks/pdfjs-2UOWBGC2.js +107 -0
- package/chunks/photon_rs-MVWYTYTO.js +3 -0
- package/chunks/plugin-command-CIDTOPNB.js +2 -0
- package/chunks/provider-command-UZ7KQFAC.js +2 -0
- package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
- package/chunks/run-acp-command-AKDLHKMR.js +59 -0
- package/chunks/run-exec-command-UXTPS7LC.js +15 -0
- package/chunks/skills-command-57TF53NO.js +2 -0
- package/chunks/src-5PSNGHHD.js +2 -0
- package/chunks/src-YZ26EVSY.js +2 -0
- package/chunks/telemetry-3NXMCOVD.js +2 -0
- package/chunks/telemetry-command-CMDERYNN.js +5 -0
- package/chunks/tools-CRJR35HS.js +2 -0
- package/chunks/undici-O4OQVZ6I.js +2 -0
- package/chunks/update-ACFAGV6F.js +14 -0
- package/chunks/update-hint-ED7O67WU.js +3 -0
- package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
- package/cli.js +4 -0
- package/configs/data-minimal.yaml +50 -0
- package/embedded/alran-tools/cli.mjs +4957 -0
- package/embedded/alran-tools/manifest.json +25 -0
- package/emscripten-module.wasm +0 -0
- package/image-preview-worker.js +2 -0
- package/internal-bin/alran-tools +9 -0
- package/internal-bin/alran-tools.cmd +8 -0
- package/matrix-mcp-stdio.js +4 -0
- package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
- package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
- package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
- package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
- package/package.json +38 -4
- package/photon_rs_bg.wasm +0 -0
- package/quickjs-worker.js +152 -0
- package/vendor/java-proxy-agent/build.ts +97 -0
- package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
- package/vendor/seccomp/arm64/apply-seccomp +0 -0
- package/vendor/seccomp/build.ts +74 -0
- package/vendor/seccomp/x64/apply-seccomp +0 -0
- package/vendor/srt-win/arm64/srt-win.exe +0 -0
- package/vendor/srt-win/build.ts +40 -0
- 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.
|