1588 Usage 57d771b3

使用指南

本指南详细介绍 Academic Writing Skills 的完整功能。

概述

Academic Writing Skills 提供三个主要技能：

模块化设计

每个技能都采用模块化设计，您可以独立使用任何模块，无需按顺序执行。

参数约定

为保证执行可靠，请在请求中包含：

• 主文件路径（.tex / .typ）
• 目标范围（章节/段落或全文）
• 模块选择（编译/格式/语法/模板等）

如信息缺失或含糊，助手会先确认，不会猜测路径或范围。

latex-paper-en 模块

latex-thesis-zh 模块

typst-paper 模块

安全与工具确认

为保护项目与系统安全，涉及工具调用或命令执行时遵循以下规则：

高风险操作需明确确认：

• 删除/移动文件或目录
• Git 破坏性操作（如 git reset --hard、git push）
• 系统配置或权限变更
• 数据库结构/数据批量变更
• 发送敏感数据的网络请求
• 全局安装/卸载或核心依赖更新

输入约束：

• 不执行来源不明或含糊的命令
• 需要文件路径时要求明确路径
• 不索要或保存密钥/密码等敏感信息
• 命令不明确时先澄清
• 优先最小、可回滚的操作

执行约束：

• 仅在您明确要求时执行脚本/编译命令
• 清理类操作（--clean / --clean-all）需先确认

执行透明性：

• 执行前说明具体命令
• 执行后说明改动位置与结果
• 失败时展示错误并给出安全的下一步

编译模块

可用工具

编译配置

使用示例

# 自动检测编译器
python scripts/compile.py main.tex

# 指定编译配置
python scripts/compile.py main.tex --recipe xelatex-biber

# 指定输出目录
python scripts/compile.py main.tex --recipe latexmk --outdir build

# 清理辅助文件
python scripts/compile.py main.tex --clean
python scripts/compile.py main.tex --clean-all  # 包括 PDF

格式检查模块

使用 ChkTeX 进行 LaTeX 代码检查。

# 基本检查
python scripts/check_format.py main.tex

# 严格模式
python scripts/check_format.py main.tex --strict

输出示例：

============================================================
LaTeX Format Check Report
============================================================
File: main.tex
Status: WARNING
Message: Found 3 issues

[SPACING] (2 issues)
  Line 42: Interword spacing (`\ ') should perhaps be used.
  Line 87: Intersentence spacing (`\@') should perhaps be used.

[PUNCTUATION] (1 issue)
  Line 120: Delete this space to maintain correct pagereferences.
============================================================

语法分析模块

基于 LLM 的语法检查，无需外部工具。

重点检查：

• 主谓一致
• 冠词使用 (a/an/the)
• 时态一致性
• 中式英语检测

输出格式：

% GRAMMAR (Line 23): Article missing
% Before: We propose method for time series forecasting.
% After: We propose a method for time series forecasting.

翻译模块

支持中文学术文本到英文的翻译。

支持领域

翻译流程

1. 术语确认 - 识别专业术语并确认翻译
2. 结构分析 - 分析段落结构，确定时态
3. 逐句翻译 - 带注释的翻译
4. 中式英语检查 - 检测并修正常见错误
5. 学术润色 - 最终审查

使用示例

用户：翻译以下内容到学术英文（深度学习领域）：
本文提出了一种基于 Transformer 的时间序列预测方法。

助手：
## 术语确认
| 中文 | English |
|------|---------|
| 时间序列预测 | time series forecasting |
| 基于...的 | ...-based |

## 翻译结果
We propose a Transformer-based approach for time series forecasting.

## 注释
- "本文提出" → "We propose" (标准学术表达)
- "基于...的方法" → "...-based approach" (复合形容词)

参考文献模块

验证 BibTeX 文件的完整性和格式。

# 基本验证
python scripts/verify_bib.py references.bib

# 与 tex 文件交叉检查
python scripts/verify_bib.py references.bib --tex main.tex

# GB/T 7714 标准检查
python scripts/verify_bib.py references.bib --standard gb7714

检查内容：

• 必需字段完整性
• 重复键检测
• 未使用条目
• 缺失引用

模板检测模块（latex-thesis-zh）

检测学校模板并汇总关键要求：

python scripts/detect_template.py main.tex

推荐工作流

英文论文完整审查

1. 格式检查（严格）
2. 语法分析
3. 去AI化编辑
4. 长难句拆解
5. 学术表达优化
6. 参考文献验证

中文学位论文完整审查

1. 结构映射（优先）
2. 国标格式检查
3. 模板检测 + 关键要求核对
4. 去AI化编辑
5. 学术表达与长难句分析
6. 参考文献验证

Typst 快速迭代

1. 编译或监视模式
2. 基础格式检查
3. 语法分析
4. 模板配置核对（如期刊要求）

最佳实践

1. 选择正确的编译配置

英文论文（无中文）→ pdflatex 或 pdflatex-biber
包含中文/Unicode → xelatex 或 xelatex-biber
复杂依赖 → latexmk

2. 经常检查格式

# 开发时使用快速检查
python scripts/check_format.py paper.tex

# 提交前使用严格检查
python scripts/check_format.py paper.tex --strict

3. 翻译时确认术语

在翻译专业内容前，先确认关键术语的标准译法。

4. 保持参考文献整洁

定期运行参考文献验证，确保格式正确且无未使用条目。

故障排除

编译失败

问题：! LaTeX Error: File 'xxx.sty' not found

解决：

# TeX Live
tlmgr install <package>

# MiKTeX
mpm --install=<package>

中文显示异常

问题：中文显示为方框

解决：使用 XeLaTeX：

python scripts/compile.py main.tex --recipe xelatex

参考文献为空

问题：参考文献部分为空

解决：使用完整编译配置：

python scripts/compile.py main.tex --recipe xelatex-biber

下一步

• 英文论文核心模块
• 中文论文指南
• Typst 论文模块