@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/pdf/templates/latex-academic-thesis/README.md

@@ -0,0 +1,146 @@
+# LaTeX Academic Thesis Template
+
+Compact scaffold for Chinese undergraduate / graduate theses (本科毕业论文,
+硕士论文). All structural components are present with minimal content so the
+agent can substitute real content without re-engineering the formatting.
+
+## When to use this template
+
+User asks to:
+- Typeset a university thesis from an existing `.tex` file
+- Apply a school template to thesis content
+- Merge a cover PDF with a body PDF
+- Fix page geometry, header/footer, bibliography style, or figure numbering
+  in an existing thesis
+
+## Structural invariants
+
+| Component | `main.tex` location | Notes |
+|---|---|---|
+| Page geometry | Preamble (`geometry`) | A4, school-specific margins |
+| Chinese fonts | Preamble (`fontspec`) | Songti SC + Times New Roman |
+| Title hierarchy | `\ctexset{...}` in preamble | section / subsection / subsubsection |
+| Header/footer | Preamble (`fancyhdr`) | Odd/even different; page number outside |
+| Front matter | `\begin{document}` → body | roman page numbers |
+| `\section{...}` | Body | `break = \clearpage` on section |
+| Figures | `\begin{figure}[H]` | `caption{...}\label{fig:...}` |
+| Tables | `\begin{table}[H]` | `booktabs` three-line table |
+| Formulas | `equation` or `align` env | `\label{eq:...}` |
+| Bibliography | `\thebibliography` or BibTeX | GB/T 7714-2015 numeric |
+| Appendix | `\appendix` + `\section*` | Continues figure/table numbering |
+| Cover merge | External PDF + `qpdf` | Separate step, not in tex |
+
+## How to fill in
+
+1. **Cover page**: replace `<学校>`, `<论文题目>`, `<学生姓名>`, `<学号>`,
+   `<指导教师>`, `<专业>`, `<完成日期>`.
+2. **Abstract**: replace the Chinese abstract paragraph and keywords.
+3. **Abstract (English)**: replace the English abstract paragraph and keywords.
+4. **Body sections**: keep all `\section`, `\subsection`, `\subsubsection`
+   commands; replace body text.
+5. **Figures**: place image files in `../图表/` or `../figures/`; update
+   `\includegraphics[width=...]{filename}`.
+6. **Tables**: replace tabular content inside `booktabs` environments.
+7. **References**: add `\bibitem{...}` entries or populate `.bib` file.
+8. **Appendix**: replace with actual appendix content; remove if not needed.
+
+## Compile
+
+```bash
+# tectonic — preferred (auto-installs packages)
+cd /path/to/thesis-dir
+tectonic main.tex --outdir .
+
+# xelatex + bibtex — fallback
+xelatex main.tex && bibtex main && xelatex main.tex && xelatex main.tex
+```
+
+## Merge cover PDF (if cover is external)
+
+```bash
+# 封面 PDF（封面1页在前） + 正文 PDF（全部页面在后）
+qpdf --empty --pages cover_page.pdf 1-z body.pdf 1-z -- final_output.pdf
+pdfinfo final_output.pdf | grep Pages
+```
+
+## Common patterns from this template
+
+### Heading with correct spacing (南理工 spec)
+
+```latex
+\ctexset{
+  section = { format = \raggedright\songti\bfseries\zihao{-3},
+               beforeskip = 18pt, afterskip = 18pt,
+               break = \clearpage },
+  subsection = { format = \raggedright\songti\bfseries\zihao{4},
+                 beforeskip = 12pt, afterskip = 12pt },
+  subsubsection = { format = \raggedright\songti\bfseries\zihao{-4},
+                    beforeskip = 6pt, afterskip = 6pt },
+}
+```
+
+### Three-line table (booktabs)
+
+```latex
+\begin{table}[H]
+  \centering
+  \caption{表格标题}
+  \label{tab:example}
+  \begin{tabular}{lll}
+    \toprule
+    \textbf{列1} & \textbf{列2} & \textbf{列3} \\
+    \midrule
+    数据1 & 数据2 & 数据3 \\
+    \bottomrule
+  \end{tabular}
+\end{table}
+```
+
+### Figure with Chinese caption
+
+```latex
+\usepackage{subcaption}
+\DeclareCaptionFont{songwu}{\songti\zihao{5}}
+\captionsetup{font=songwu, labelfont=songwu, labelsep=space}
+
+\begin{figure}[H]
+  \centering
+  \includegraphics[width=0.65\textwidth]{fig1.jpg}
+  \caption{图注说明}
+  \label{fig:example}
+\end{figure}
+```
+
+### Equation with section numbering
+
+```latex
+\counterwithin{equation}{section}
+\refstepcounter{section}
+\section{绪论}
+% ...
+\begin{equation}
+    t_{latency} = t_{switch} - t_{wakeup}
+    \label{eq:sched-latency}
+\end{equation}
+% Reference: 式\eqref{eq:sched-latency}
+```
+
+### GB/T 7714-2015 bibliography
+
+```latex
+\usepackage[numbers,sort&compress]{natbib}
+\bibliographystyle{gbt7714-numerical}
+% or use thebibliography:
+\begin{thebibliography}{99}
+  \bibitem{key1} Author A, Author B. Title[J]. Journal, 2024, 1(1): 1-10.
+\end{thebibliography}
+```
+
+## What not to change
+
+- `\usepackage{geometry}` settings — they encode the school page spec.
+- `\ctexset{...}` title formatting — it encodes the school heading spec.
+- `fancyhdr` header/footer definition — it encodes odd/even page logic.
+- `\counterwithin{figure}{section}` and related commands — they encode
+  per-chapter figure/table/equation numbering.
+- `\AtBeginDocument{\zihao{-4}...}` — body font size is school-specified.

package/server/assets/skills/pdf/templates/latex-academic-thesis/source.tex

@@ -0,0 +1,334 @@
+% =============================================================================
+% Compact template for integration with an empty agent: Nanjing University of Science and Technology bachelor's thesis format
+% Cover all structural components with minimal body text, focusing on format reuse
+% Compile: tectonic main.tex or xelatex && bibtex && xelatex && xelatex
+% =============================================================================
+\documentclass[a4paper, 12pt, twoside]{ctexart}
+
+% --- Page setup (A4; top 30mm, bottom 24mm, left/right 25mm; header footskip=20mm) ---
+\usepackage[
+  a4paper,
+  top=30mm, bottom=24mm, left=25mm, right=25mm,
+  headheight=15pt, headsep=10mm, footskip=20mm
+]{geometry}
+
+% --- Body: SimSun, Chinese small size 4, approximately 20pt fixed line spacing ---
+\usepackage{setspace}
+\AtBeginDocument{\zihao{-4}\songti\setlength{\baselineskip}{20pt}\setlength{\parindent}{2em}}
+
+% --- Prevent Overfull \hbox by allowing paragraph word spacing to stretch ---
+\emergencystretch=0.5em
+
+% --- Font settings ---
+% Chinese: SimSun for body text; synthetic bold SimSun for headings to meet the school's bold-SimSun requirement
+% English and numbers: Times New Roman
+\usepackage{fontspec}
+\setmainfont{Times New Roman}
+\setCJKmainfont[AutoFakeBold=2.5]{Songti SC}
+\setCJKfamilyfont{song}[AutoFakeBold=2.5]{Songti SC}
+\setCJKfamilyfont{hei}{Heiti SC}
+
+% --- Mathematical formulas ---
+\usepackage{amsmath, amssymb}
+
+% --- Figures and tables ---
+\usepackage{graphicx}
+\graphicspath{{../图表/}}
+\usepackage{float}
+\usepackage{subcaption}
+\DeclareCaptionFont{songwu}{\songti\zihao{5}}
+\captionsetup{font=songwu, labelfont=songwu, labelsep=space}
+\captionsetup[lstlisting]{font=songwu, labelfont=songwu, labelsep=space}
+\usepackage{booktabs}
+\usepackage{multirow}
+\usepackage{longtable}
+\usepackage{tabularx}
+\usepackage{adjustbox}
+\usepackage{afterpage}
+
+% --- Number figures, tables, and equations by chapter (Figure X-X, Table X-X, Equation X-X) ---
+\IfFileExists{chngcntr.sty}{\usepackage{chngcntr}}{}
+\counterwithin{figure}{section}
+\counterwithin{table}{section}
+\counterwithin{equation}{section}
+\def\thefigure{\thesection.\arabic{figure}}
+\def\thetable{\thesection.\arabic{table}}
+\def\theequation{\thesection.\arabic{equation}}
+
+% --- Code blocks ---
+\usepackage{listings}
+\usepackage{listingsutf8}
+\usepackage{xcolor}
+\lstset{
+    basicstyle=\zihao{5}\ttfamily,
+    columns=fullflexible,
+    keepspaces=true,
+    literate={，}{{，}}1 {。}{{。}}1 {：}{{：}}1 {；}{{；}}1
+            {（}{{（}}1 {）}{{）}}1 {、}{{、}}1,
+    keywordstyle=\color{blue},
+    commentstyle=\color{gray},
+    stringstyle=\color{red!70!black},
+    numbers=left,
+    numberstyle=\tiny\color{gray},
+    frame=single,
+    breaklines=true,
+    tabsize=4,
+}
+
+% --- Cross-references and hyperlinks (load hyperref as late as possible) ---
+\usepackage{hyperref}
+\hypersetup{
+    colorlinks=true,
+    linkcolor=black,
+    citecolor=black,
+    urlcolor=black,
+}
+
+% --- References (GB/T 7714-2015 numeric style; sort&compress compacts citation numbers) ---
+% Use natbib + gbt7714-numerical; for BibTeX, run xelatex twice, bibtex, then xelatex twice
+\usepackage[numbers,sort&compress]{natbib}
+\bibliographystyle{gbt7714-numerical}
+
+% --- Headers and footers (different odd/even pages, page numbers on the outside) ---
+% Even pages (CE): chapter title on the left, "Bachelor's Thesis" on the right
+% Odd pages (CO): "Bachelor's Thesis" on the left, chapter title on the right
+% Page numbers at LE (left even) and RO (right odd), i.e. the outer edges
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}
+% Correct sectionmark definition; must precede its use
+\makeatletter
+\def\sectionmark#1{\markboth{\thesection\quad #1}{}}
+\makeatother
+\fancyhead[CO]{\songti\zihao{5} 学士学位论文\hfill <论文题目(简)>}
+\fancyhead[CE]{\songti\zihao{5} \leftmark\hfill 学士学位论文}
+\fancyfoot[LE,RO]{\songti\zihao{5}\thepage}
+\fancypagestyle{plain}{%
+  \fancyhf{}%
+  \fancyhead[CO]{\songti\zihao{5} 学士学位论文\hfill <论文题目(简)>}%
+  \fancyhead[CE]{\songti\zihao{5} \leftmark\hfill 学士学位论文}%
+  \fancyfoot[LE,RO]{\songti\zihao{5}\thepage}%
+}
+
+% --- TOC depth: include three heading levels ---
+% tocloft: \cftsecnumdepth=3 includes section/sub/subsub levels
+\IfFileExists{tocloft.sty}{\usepackage[titles]{tocloft}}{}
+\def\contentsname{目\quad 录}
+\def\refname{参考文献}
+
+% --- Chapter heading format (school requirements) ---
+\ctexset{
+    section = {
+        format = \raggedright\songti\bfseries\zihao{-3},
+        beforeskip = 18pt,
+        afterskip = 18pt,
+        break = \clearpage,
+    },
+    subsection = {
+        format = \raggedright\songti\bfseries\zihao{4},
+        beforeskip = 12pt,
+        afterskip = 12pt,
+    },
+    subsubsection = {
+        format = \raggedright\songti\bfseries\zihao{-4},
+        beforeskip = 6pt,
+        afterskip = 6pt,
+    },
+    paragraph = {
+        format = \raggedright\songti\zihao{-4},
+        beforeskip = 6pt,
+        afterskip = 0pt,
+    },
+}
+
+% --- Custom commands ---
+\newcommand{\frontmattertitle}[1]{%
+  \vspace*{18pt}\begin{center}{\songti\bfseries\zihao{3}#1}\end{center}\vspace{18pt}}
+\newcommand{\centeredsectionstar}[1]{%
+  \clearpage\phantomsection\vspace*{18pt}\begin{center}{\songti\bfseries\zihao{3}#1}\end{center}\vspace{18pt}}
+
+% =============================================================================
+\begin{document}
+
+% ========================== Abstract ==========================
+\newpage
+\pagestyle{plain}
+\pagenumbering{roman}
+
+\frontmattertitle{摘\quad 要}
+\phantomsection
+\addcontentsline{toc}{section}{摘要}
+
+本文针对XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\vspace{1cm}
+\noindent{\songti\bfseries\zihao{4} 关键词：}{\songti\zihao{-4} 关键词1；关键词2；关键词3}
+
+% ========================== Abstract ==========================
+\newpage
+\markboth{Abstract}{}
+\begin{center}{\bfseries\zihao{3} Abstract}\end{center}\vspace{18pt}
+\phantomsection
+\addcontentsline{toc}{section}{Abstract}
+
+This thesis presents a systematic study of XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
+
+\vspace{1cm}
+\noindent{\bfseries\zihao{4} Keywords:}{\zihao{-4} keyword1; keyword2; keyword3}
+
+% ========================== Table of contents ==========================
+\newpage
+\markboth{目\quad 录}{}
+\begingroup
+\def\contentsname{目\quad 录}
+\tableofcontents
+\endgroup
+% For duplex printing, add a blank page if the front matter has an odd page count
+\ifodd\value{page}\newpage\thispagestyle{empty}\mbox{}\fi
+
+% ========================== Main text ==========================
+\newpage
+\pagestyle{fancy}
+\pagenumbering{arabic}
+
+% ========================================================================
+%   Chapter 1: Introduction
+% ========================================================================
+\section{绪论}
+
+\subsection{研究背景与意义}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+如图\ref{fig:architecture}所示，XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\begin{figure}[H]
+    \centering
+    \includegraphics[width=0.65\textwidth]{architecture.jpg}
+    \caption{系统架构图}
+    \label{fig:architecture}
+\end{figure}
+
+\subsection{国内外研究现状}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+文献\cite{author2024example}提出了XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\subsubsection{Linux调度器研究}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+% Use paragraph for level-four headings; school requirements generally omit subsubsubsection
+\paragraph{相关技术基础}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\subsection{本文创新点}
+
+本文主要创新点如下：
+
+\begin{enumerate}
+    \item 创新点一：XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+    \item 创新点二：XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+\end{enumerate}
+
+% ========================================================================
+%   Chapter 2: Technical Background
+% ========================================================================
+\section{相关技术基础}
+
+本章介绍XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\subsection{Linux调度器原理}
+
+CFS的核心思想是XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+虚拟运行时间的计算如式\eqref{eq:vruntime}所示。
+
+\begin{equation}
+    \Delta vruntime = \Delta t_{wall} \times \frac{NICE\_0\_LOAD}{weight(task)}
+    \label{eq:vruntime}
+\end{equation}
+
+表\ref{tab:cfs-params}列出了CFS的核心可调参数及其语义。
+
+\begin{table}[H]
+    \centering
+    \caption{CFS核心可调参数}
+    \label{tab:cfs-params}
+    \begin{tabular}{lll}
+        \toprule
+        \textbf{参数名称} & \textbf{基准值} & \textbf{语义} \\
+        \midrule
+        \texttt{sched\_latency\_ns} & 6\,ms & 调度周期目标 \\
+        \texttt{sched\_min\_granularity\_ns} & 0.75\,ms & 最小抢占粒度 \\
+        \bottomrule
+    \end{tabular}
+\end{table}
+
+% ========================================================================
+%   Chapter 3: System Design
+% ========================================================================
+\section{系统设计}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\subsection{总体架构}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+\section{实验与分析}
+
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX。
+
+% ========================================================================
+%   References
+% ========================================================================
+% Reference page numbers continue in Arabic numerals from the main text; do not switch back to Roman numerals
+% For BibTeX, replace \begin{thebibliography}... with
+%   \bibliography{refs}, then run xelatex && bibtex && xelatex && xelatex
+\newpage
+\begin{thebibliography}{99}
+  \bibitem{author2024example} Author A, Author B. Title of the reference[J].
+    Journal Name, 2024, 1(1): 1-10. DOI: 10.0000/example.
+  \bibitem{linuxkernel} Linux Kernel Documentation[EB/OL].
+    \url{https://www.kernel.org/doc/html/latest/}.
+\end{thebibliography}
+
+% ========================== Appendix ==========================
+\appendix
+\centeredsectionstar{附\quad 录}
+\markboth{附\quad 录}{}
+\addcontentsline{toc}{section}{附录}
+
+\subsection*{附录A：实验配置}
+
+表~\ref{tab:appendix-configs}列出了实验配置。
+
+\begin{table}[H]
+    \centering
+    \caption{实验配置表}
+    \label{tab:appendix-configs}
+    \begin{tabular}{llr}
+        \toprule
+        \textbf{参数} & \textbf{符号} & \textbf{值} \\
+        \midrule
+        CPU核心数 & $N$ & 4 \\
+        调度周期 & $T$ & 10\,ms \\
+        \bottomrule
+    \end{tabular}
+\end{table}
+
+\subsection*{附录B：核心代码}
+
+\begin{lstlisting}[language=C, caption={示例代码}, label={lst:sample}]
+#include <stdio.h>
+int main() {
+    printf("Hello, World!\n");
+    return 0;
+}
+\end{lstlisting}
+
+\end{document}

package/server/assets/skills/pdf/templates/latex-technical-book/README.md

@@ -0,0 +1,130 @@
+# LaTeX Technical Book Template
+
+Use this template when the user wants a Chinese technical book / engineering monograph / source-code
+reading book / algorithm or systems book in a polished LaTeX book format rather than a short HTML
+report.
+
+## When to use
+
+Trigger examples:
+
+- “把这些 HTML/Markdown 章节做成一本技术书”
+- “中文技术书 LaTeX 模板”
+- “源码解析书 / 工程实践书 / 算法书排版”
+- “B5/16 开，目录、页眉页脚、代码块、引文框、结构图”
+- “O'Reilly 风格封面 / 动物封面 / 技术出版读物”
+
+Do **not** use this for academic thesis formatting; use `templates/latex-academic-thesis/` and
+`docs/latex-academic-thesis-guide.md` instead.
+
+## Files
+
+- `source.tex` — compact generic scaffold with final technical-book style.
+- `source.tex` includes a TikZ animal-style placeholder cover illustration. Replace that block with
+  an `\includegraphics` call only when the user supplies a real cover image.
+- `README.template-source.md` — the source project README retained for context.
+
+## Style features
+
+The scaffold includes:
+
+- B5 / 16 开 page size: `176mm × 250mm`.
+- O'Reilly-like framed cover with top/bottom red bars, optional animal illustration, publisher mark,
+  and old-cover fallback command `\maketechbooktitleClassic` that is not used by default.
+- Clickable `hyperref` table of contents with black text and red number/page accents.
+- Running header showing current section title + page number; footer with book title / publisher /
+  page number.
+- Low-saturation code highlighting with `listings` and robust line breaking.
+- Inline code/path support through `xurl` / `\path|...|` to prevent long API paths from overflowing.
+- `insightbox`, `pullquotebox`, `diagramBox`, `warningbox`, theorem/definition/example boxes,
+  exercises.
+- `\fancydropcap{首}{段剩余文字}` for chapter/section opening paragraphs.
+- `tabularx` ragged columns (`Y`) for robust technical tables.
+
+## Copy-and-fill workflow
+
+```bash
+mkdir -p /tmp/technical-book
+cp templates/latex-technical-book/source.tex /tmp/technical-book/main.tex
+mkdir -p /tmp/technical-book/figures /tmp/technical-book/chapters /tmp/technical-book/backmatter
+```
+
+Then edit:
+
+1. Book metadata in `main.tex`:
+   - `\BookTitle`
+   - `\BookTitleDetail`
+   - `\BookAuthor`
+   - `\BookPublisher`
+   - `\BookYear`
+2. Replace the preface text.
+3. Replace `\input{chapters/chapter01}` etc. with the actual chapter files.
+4. Replace the TikZ placeholder in `source.tex` only if the user supplied a cover illustration.
+5. Keep `\tableofcontents`, `hyperref`, and `\phantomsection` entries intact so navigation remains
+   clickable.
+
+## HTML/Markdown → book conversion guidance
+
+When source content is structured HTML pages:
+
+- Inspect representative pages first: cover, TOC, first section, code-heavy page, table-heavy page,
+  diagram-heavy page.
+- Preserve semantic blocks, not CSS literally:
+  - `p.dropcap` or leading `<span class="dropcap">` → `\fancydropcap{...}{...}` for Chinese prose
+    only; avoid ASCII/digit drop caps.
+  - `div.pullquote`, `blockquote`, `.pull-quote` → `pullquotebox`.
+  - `ul.timeline` / `.year` spans → `diagramBox + description`.
+  - `arch-diagram`, `dep-flow`, `flow-diagram`, `flow-chain`, `path-diagram`, `flow-row` → rebuild
+    as LaTeX/TikZ or a `diagramBox`; do not drop diagrams silently.
+  - `code` inline → `\path|...|` for ASCII paths/API names; plain escaped text for CJK-heavy inline
+    snippets.
+  - `pre code` → `lstlisting` with low-saturation highlighting.
+  - `table` → `tabularx` with `Y` columns, small font, reduced `\tabcolsep`.
+  - `ul`/`ol` feature lists → `enumitem` lists with red bullet/number accents.
+- If the source references an image (`<img src="...">`) but the file is missing, report it. Do not
+  invent that image; use a simple placeholder only when the user approves or supplies the asset.
+
+## Compile
+
+Preferred for this template: XeLaTeX via latexmk.
+
+```bash
+PATH="/usr/local/texlive/2026/bin/universal-darwin:$PATH" \
+  latexmk -xelatex -interaction=nonstopmode main.tex
+```
+
+Fallback manual chain:
+
+```bash
+xelatex -interaction=nonstopmode main.tex
+bibtex main || true
+makeindex main || true
+xelatex -interaction=nonstopmode main.tex
+xelatex -interaction=nonstopmode main.tex
+```
+
+## Verification gates
+
+Run these before delivery:
+
+```bash
+pdfinfo main.pdf | grep -E 'Pages|Page size'
+grep -i "fatal\|undefined control sequence\|LaTeX Error" main.log
+pdftotext main.pdf - | head -80
+```
+
+Expected:
+
+- Page size is B5-like `176mm × 250mm` unless the user requested A4.
+- No fatal LaTeX errors or undefined control sequences.
+- Chinese text extracts correctly.
+- TOC entries are clickable when opened in a PDF viewer.
+
+## Common warnings
+
+- `Overfull/Underfull hbox` can occur in very long code paths or dense tables. Reduce by using
+  `\path`, smaller table font, `tabularx` `Y` columns, or manually splitting the cell.
+- `lettrine` warnings mean a drop cap is too close to a page boundary. For final publishing, remove
+  `\fancydropcap` on that paragraph or insert a local page break.
+- Font shape warnings for CJK italics/small caps are usually harmless; avoid relying on italic CJK
+  for semantic meaning.

package/server/assets/skills/pdf/templates/latex-technical-book/README.template-source.md

@@ -0,0 +1,62 @@
+# 中文技术出版读物 LaTeX 模板
+
+这是一个面向中文技术书出版的 LaTeX 模板，适合计算机科学教材、算法书、系统设计书、工程实践类专著。模板采用 B5
+/ 16 开近似尺寸 `176mm × 250mm`，比 A4 更接近正式中文技术书样张。
+
+## 编译
+
+```bash
+latexmk -xelatex -interaction=nonstopmode main.tex
+```
+
+或手动：
+
+```bash
+xelatex main.tex
+bibtex main
+makeindex main
+xelatex main.tex
+xelatex main.tex
+```
+
+## 文件结构
+
+```text
+technical-book-latex-template/
+├── main.tex
+├── references.bib
+├── frontmatter/
+│   ├── copyright.tex
+│   └── preface.tex
+├── chapters/
+│   ├── chapter01.tex
+│   ├── chapter02.tex
+│   └── chapter03.tex
+├── backmatter/
+│   └── appendix.tex
+└── figures/
+```
+
+## 主要特性
+
+- B5 / 16 开中文技术书版式：`176mm × 250mm`。
+- 双面排版，章节默认右页开始。
+- 中文环境名：定义、定理、例、要点提示、常见误区、习题、本章延伸阅读。
+- 支持算法伪代码、代码清单、表格、参考文献和索引。
+- 使用 `hyperref` 生成可点击目录和引用。
+
+## 正式出版前建议
+
+正式交付出版社前，请确认：开本、版心、页边距、字体授权、ISBN、版权页、CIP 信息、图表分辨率和印刷出血规范。
+
+## 当前风格
+
+本模板已更新为与 `harness-book` 成书版一致的技术出版风格，但保留通用占位内容：
+
+- O'Reilly / 技术动物封面风格，默认使用 TikZ 动物线稿占位；旧封面保留为
+  `\maketechbooktitleClassic`，默认不编译。
+- 目录编号与页码采用红色强调，正文目录文字保持黑色。
+- 正文包含首字下沉、引文框、提示框、图示框、低饱和代码高亮、自动换行的行内代码路径等样式。
+- 页眉仅显示当前小节标题，页脚显示书名、出版标识与页码。
+
+正式成书时，建议替换 `main.tex` 中的书籍元数据、前言、章节文件与封面插图。