1
确认环境
Python 3.10 或更高版本。git 已安装。
不需要 LaTeX。demo 模式用 --skip-compile 跳过编译。
01 / steps
按顺序走七步
每步都有明确输入和可验证的输出。卡住时先看 Step 6 的常见失败。
2
克隆仓库
$ git clone https://github.com/quzhiii/thesis-skills.git $ cd thesis-skills
3
运行 demo 检查
$ python run_check_once.py \
--project-root examples/minimal-latex-project \
--ruleset university-generic \
--skip-compile
--project-root：指定项目目录，这里用仓库自带的最小示例。
--ruleset：选择规则包，university-generic 是通用大学论文规则。
--skip-compile：跳过 LaTeX 编译。如果你本地有 LaTeX，可以去掉这个参数。
4
预期输出
基础检查命令跑完后，会在 examples/minimal-latex-project/reports/ 目录下生成一组 JSON / Markdown / CSV 文件：
examples/minimal-latex-project/reports/ ├── run-summary.json # 所有检查的汇总索引 ├── check_bib_quality-report.json # Bib 字段与重复项预检 ├── check_references-report.json # 兼容引用检查报告 ├── citation-integrity-report.json # Citation Integrity 机器可读状态 ├── citation-integrity-report.md # Citation Integrity 人工可读摘要 ├── citation-issues.csv # 可导入表格的风险列表 ├── check_language-report.json # 中文语言风格检查 ├── check_language_deep-report.json # 深度语言筛查 ├── check_format-report.json # 格式规范检查 ├── check_content-report.json # 内容结构检查 └── readiness-report.json # 总 verdict：PASS / WARN / BLOCK
如果要生成 v3.3 引用证据链，继续运行 python run_evidence_pipeline.py --project-root examples/minimal-latex-project --ruleset university-generic。它会额外产出 final-reference-set-report.json、external-verification-report.json、missing-doi-candidates.json、url-verification-report.json、hallucination-risk-report.json、high-risk-references.csv 和 claim-citation-triage-report.json 等 artifacts。生成 HTML 阅读面时，还可以得到 claim-citation-triage.html；它展示 P0 / P1 / P2 / P3 复核分组，并在 readiness / references / claim-citation / final-audit 之间提供报告链接。
5
先看这四个文件
先看 readiness-report.json：总 verdict 是什么。PASS 表示通过，WARN 有警告但不阻塞，BLOCK 需要处理后才能继续。
再看 citation-integrity-report.md：这是最适合人工先读的引用风险摘要，能直接看到 BLOCK / WARN 项和下一步动作。
再看 check_language-report.json：中文语言风格检查结果，比如口语化表达、标点混用、重复用词。
最后看 run-summary.json：所有检查的汇总索引，方便你快速定位哪一项需要细看。
6
常见失败和对策
Python 版本过低
升级到 3.10 或更高版本。项目用了 Python 3.10 的语法特性，低版本会直接报错。
找不到项目目录
确认你在 thesis-skills 根目录下运行命令，或者给 --project-root 传绝对路径。
缺少依赖
项目用纯 Python stdlib，一般不需要额外安装。如果报错 ModuleNotFoundError，检查是否在正确的虚拟环境里。
输出目录为空
检查命令参数拼写，特别是 --project-root 和 --ruleset 的值。规则包名称要和 90-rules/packs/ 下的目录名一致。
7