AI_USAGE.md

# AI 工具使用声明（AI-Generated Content Annotation）

> 课程要求：所有 AI 生成内容须明确标注（*All AI-generated contents should be annotated.*）
> 本文件对本交付物中各产物的 AI 参与程度进行如实标注，供助教审阅。

**最后更新 / Last updated**：2026-06-19

---

## 1. 总体声明

本项目（CS3319 Project 2，学术论文阅读推荐 / 作者-论文异构图链接预测）在**研究构思、实验设计、代码实现、结果分析**上以**作者本人为主导**；在**文字撰写、文档组织、图表生成脚本、代码重构与调试**等环节**使用了 AI 辅助工具**。所有 AI 辅助生成的内容均经作者人工审阅与核验后纳入。

**关键区分（请特别注意）**：

- **实验结果（数值、提交分数、F1、AUC、特征维度等）全部来自作者真实运行的实验**，由脚本从真实数据/模型计算得出，**不是 AI 生成或捏造**。
- AI 工具**不参与**模型的训练执行、分数计算与榜单提交；它只用于辅助撰写描述这些结果的文字、生成绘图脚本、组织文档与重构代码。
- 本仓库 `code/run_inference.ipynb` 已在本地 CPU 实跑验证：复现的提交与内置最终提交**逐位一致（2,047,262/2,047,262）**，验证集 F1 = 0.966874、公开榜单 F1 = 0.96626——这些是真实可复现的结果。

---

## 2. 使用的 AI 工具

| 工具 | 用途 |
|---|---|
| **Claude Code（Anthropic，模型 glm-5.2）** | 代码重构与调试、文档/报告撰写、图表生成脚本、本文档、`code/run_inference.ipynb`、`docs/diagrams/`、`docs_first_principles/`、`.understand-anything/` 知识图谱的辅助生成 |

> 如在其它环节还使用过其它 AI 工具（如 ChatGPT、GitHub Copilot、DeepSeek 等），请作者在本表补充。

---

## 3. 逐产物标注

| 产物 | 路径 | AI 参与程度 | 人工核验 |
|---|---|---|---|
| 实验脚本（训练/评估/提交生成） | `code/*.py` | **人工为主**，AI 辅助调试与局部重构 | ✅ 作者编写并真实运行；关键数值经实验复现 |
| 最终推理复现 notebook | `code/run_inference.ipynb` | **AI 生成** | ✅ 已本地实跑，提交逐位一致；结果真实 |
| 论文（中文，ACM 双栏） | `ACM_Conference_Proceedings_Primary_Article_Template/cs3319_final_paper_cn.tex` / `.pdf` | **AI 辅助撰写**，作者定稿与校核 | ✅ 引用的实验数值来自真实结果；作者审定内容 |
| 参考文献 | `…/cs3319_references.bib` | 人工整理（作者应核实每条引用的准确性） | ⚠️ 请作者最终确认引用无误 |
| 课程报告 / 探索总结 | `reports/*.md` | **AI 辅助撰写** | ✅ 数值真实；文字经作者审阅 |
| 第一性原理文档包（15 篇） | `docs_first_principles/*.md` | **AI 生成** | ✅ 人工核验数值与代码引用；`_fact_sheet.md` 为数值真相源 |
| 论文图表 | `figures_paper/`、`figures_v2/`、`reports/figures/` | **绘图脚本 AI 辅助**，数据来自真实实验产物 | ✅ 图中数据真实；脚本可重跑 |
| 流程图/架构图 | `docs/diagrams/` | **AI 生成**（源文件 + 渲染） | ✅ 内容与代码/报告核对一致 |
| 知识图谱（代码结构可视化） | `.understand-anything/` | **AI 生成** | ✅ 自动从代码提取，仅供浏览 |
| README / 状态文档 | `README.md`、`SUBMISSION_README.md`、`WORKSPACE_STATUS.md`、`CLAUDE*.md` | **AI 辅助撰写** | ✅ 命令与路径经实跑核对 |
| 本声明 | `AI_USAGE.md` | **AI 起草**，作者审定 | ⚠️ 请作者按实际情况增删后签字 |

> 说明：“AI 生成”指内容由 AI 产出并经人工核验；“AI 辅助”指人工主笔、AI 提供局部草稿/润色/重构；“人工为主”指作者亲自编写。

---

## 4. 结果真实性承诺

作者承诺：本交付物中出现的全部实验指标（公开榜单 F1 = **0.96626**、验证集 F1 = **0.966874**、AUC = **0.994918**、259 维特征构成等）均来自作者在提供数据集上**真实训练与推理**所得，可通过 `code/run_inference.ipynb` 在 CPU 上**秒级复现**（加载缓存推理输出 → 应用 rank-cutoff 决策 → 与内置提交逐位一致）。AI 工具未被用于生成或伪造任何实验数值。

---

## 5. 作者确认

- [ ] 作者已逐项核对上表，并按实际情况修改了 AI 参与程度的描述。
- [ ] 作者确认所有实验结果真实可复现。
- [ ] 作者确认已遵守课程规则（不使用预训练模型与外部数据集，参见 `data_and_docs/project_description.md`）。

**作者签名 / Signature**：________________________   **日期 / Date**：____________