AI 工具使用说明
透明披露
本作品在开发过程中使用了多个 AI 工具，但所有关键决策、代码 Review、内容核对均由学生完成。
一、使用的 AI 模型 / 工具
| 环节 | 模型 / 工具 | 版本 / 日期 | 用途 |
|---|---|---|---|
| 代码编程辅助 | Claude Code（Opus 4.7） | 2026-04 / 2026-05 | Go 后端架构、React 组件骨架 |
| 代码编程辅助 | GitHub Copilot | 2026-04 | 局部代码补全 |
| 图片生成 | Gemini 3 Pro Image Preview | 2026-04 | 主图 / A+ 图 / 场景图 |
| 图片生成 | Gemini 3.1 Flash Image | 2026-04 | 快速预览图 |
| 图片生成 | GPT Image 2 | 2026-04 | 原生文字渲染图 |
| 视频生成 | Veo 3.1 / Veo 3.1 Fast | 2026-04 | 短视频素材 |
| 文案生成 | GPT-5.5 | 2026-04 | Listing 文案 |
| 选品分析 | Gemini 3 Pro / GPT-5.5 | 2026-04 | 市场对话分析 |
| 实体抽取 | Gemini 3 Pro / GPT-5.5 | 2026-04 | GraphRAG 商品图谱构建 |
| 文档撰写 | Claude Opus 4.7 | 2026-05 | 设计文档与本站点初稿 |
二、AI 应用环节与学生把关工作
构思阶段
学生主导
- ✅ 人工设定整体技术路线（GraphRAG + 单机部署）
- ✅ AI 仅做技术对比与可行性补全
- ❌ AI 没有决定"做什么"
编程阶段
text
AI 生成的代码 ──→ 100% 学生 Code Review ──→ 关键模块人工重写
关键模块（人工重写）：
- 认证与 Session 管理
- 配额事务（两段式 prepare/complete）
- GraphRAG 路由与子图召回
- Reaper goroutine 兜底回滚
AI 辅助为主：
- React 组件骨架
- 表单 / 表格 UI
- 标准 SQL 迁移数据 / 算法分析
text
GraphRAG 实体抽取 Prompt 由学生迭代 12 次：
v1.0 → 基础抽取 F1 = 0.62
v3.0 → 加入 evidence 字段 F1 = 0.71
v5.0 → 加入硬约束 + JSON Schema F1 = 0.79
v7.0 → 引入图像辅助 F1 = 0.85
v9.0 → 三轮迭代抽取 F1 = 0.88
v12.0 → 专有名词字典 + 实体合并 F1 = 0.90 ✅
每次抽取后人工检查 50 个样本，记录失败模式并修订 Prompt。图像 / 文案生成
text
所有进入测试报告的样本 → 学生事实核对：
- 违禁词命中检查（80+ 条规则）
- 商品参数偏差人工抽检
- Bullet 黄金顺序合规验证
- 图片场景真实性确认文档撰写
text
AI 输出初稿 ──→ 学生复核：
- 数据指标准确性
- 表格格式
- 错别字与逻辑连贯性
- 修改率约 30%AI 结果验证方式
| 验证维度 | 方法 |
|---|---|
| 代码质量 | 单元测试覆盖关键事务函数（覆盖率 84.9%） |
| 图谱抽取 | 100 条人工标注样本评估准确率（F1 = 0.90） |
| 生成文案 | 人工抽检并核对真实参数 |
| 生成图片 | 主观评估 + 违禁词自动检查 |
三、关键提示词与输出样例（节选 5 条）
对话 1：GraphRAG 实体抽取约束式提示词
text
你是亚马逊跨境电商商品本体专家。请从以下商品文本中抽取 7 类实体：
Product / Material / Specification / UseCase / FeatureSellingPoint / Compliance / Audience。
并以 JSON 数组返回，每个实体包含 type、name、attrs；如不存在该类型，
请返回空数组。禁止编造未在原文出现的事实。
商品文本：「Stainless steel kitchen rack, 304 SUS, 60×30×80cm, ...」对话 2：Listing System Prompt 节选
text
你是有 10 年经验的亚马逊高级运营。请遵循 A10 / COSMO / Rufus 三种算法，
撰写英文 Listing。严禁使用违禁词（Best #1, FDA approved, antibacterial, ...）。
Bullet 顺序：使用场景 → 关键参数 → 卖点 → 售后承诺 → 品牌延伸。
请基于以下知识图谱三元组（不得超出，不得幻觉）：
<HAS_SPEC, Product, 304 Stainless 60×30×80cm> ...对话 3：图片生成提示词模板
text
Generate a clean white-background main image (1600x1600) for Amazon.
85% pure white background, soft top-left lighting, no shadow text,
no watermark, product centered, occupy 75% canvas.
The product is: {product_caption}.
Reference style: A+ infographic, professional studio shot.对话 4：选品分析多轮对话
text
User: 我想做美国站厨房收纳，平均售价 29.99 美金，竞品评论 2000+。
AI: 该类目 BSR 集中度 62%，Top10 中 80% 是 Stainless 304，
建议差异化做 Bamboo + Foldable 切入。Trends 数据显示
「small kitchen apartment」关键词季度增长 +47%...对话 5：编程辅助 - 配额回滚
text
请基于 Go 1.25 + SQLite，写一个 reaper goroutine：
每 30 秒扫描 usage_logs 表中 status=pending 且 created_at 早于
30 秒前的记录，将其状态改为 failed，并把对应的 quotas.remaining +1。
要求：
1. 操作必须在事务中完成
2. 并发安全
3. 提供单元测试四、版权说明
版权与开源声明
源代码：本作品所有源代码由团队成员原创编写或经 AI 辅助生成后人工审校，使用 MIT 协议开源；
生成素材：AI 生成的图片、视频用于演示与测试，未直接用于商业销售；演示用商品图均来源于团队拍摄或经卖家授权使用；
AI 模型调用：Gemini / GPT / Veo 等模型的调用遵守各厂商使用条款，仅用于学术比赛展示；
开源依赖：Tailwind CSS / React / Vite / Go / SQLite / VitePress 等开源项目的版权归原作者所有，本作品未对其源代码做修改；
学术引用：参考文献按 GB/T 7714-2015 标准列于设计文档参考文献章节。
五、AI 使用的总体原则
团队约定
- AI 工具是放大镜，不是替代品 —— 学生主导思考，AI 加速实现
- 关键路径必须 100% 人工 Review —— 认证、配额、安全相关代码人工重写
- AI 输出必须有量化验证 —— GraphRAG 用 100 条样本 F1 评估，文案用违禁词检查
- 承认 AI 的贡献，不夸大也不隐瞒 —— 透明披露使用范围与产出比例
- 保持学习 —— 即使用 AI 写的代码，学生必须能看懂、改对、讲清楚
参考文献
按 GB/T 7714-2015 标准列出（节选）：
- EDGE D, TRINH H, CHENG N, 等. From Local to Global: A Graph RAG Approach to Query-Focused Summarization[J]. arXiv preprint arXiv:2404.16130, 2024.
- LEWIS P, PEREZ E, PIKTUS A, 等. Retrieval-augmented generation for knowledge-intensive NLP tasks[J]. Advances in Neural Information Processing Systems, 2020, 33: 9459-9474.
- HOGAN A, BLOMQVIST E, COCHEZ M, 等. Knowledge Graphs[J]. ACM Computing Surveys, 2021, 54(4): 1-37.
- React 官方文档[EB/OL]. (2026-04-15)[2026-05-01]. https://react.dev/.
- Vite 官方文档[EB/OL]. (2026-04-10)[2026-05-01]. https://vite.dev/.
- The Go Programming Language Specification[EB/OL]. (2026-03-20)[2026-05-01]. https://go.dev/ref/spec.
- SQLite Documentation[EB/OL]. (2026-04-01)[2026-05-01]. https://www.sqlite.org/docs.html.
- Amazon Seller Central. Listing Quality and Product Page Style Guide[EB/OL]. [2026-05-01]. https://sellercentral.amazon.com/help/.
- Amazon. A10 Search Algorithm Explained[EB/OL]. [2026-05-01]. https://sell.amazon.com/.
- Google DeepMind. Gemini 3 Technical Report[EB/OL]. (2026-03-12)[2026-05-01]. https://ai.google.dev/.
- OpenAI. GPT Image 2 Documentation[EB/OL]. (2026-04-01)[2026-05-01]. https://platform.openai.com/docs/.
- MDN Web Docs. HTTP Cookies[EB/OL]. [2026-05-01]. https://developer.mozilla.org/docs/Web/HTTP/Cookies.
- MDN Web Docs. IndexedDB API[EB/OL]. [2026-05-01]. https://developer.mozilla.org/docs/Web/API/IndexedDB_API.
- vite-plugin-pwa[EB/OL]. [2026-05-01]. https://vite-pwa-org.netlify.app/.
- OWASP. Top 10 Web Application Security Risks 2024[EB/OL]. [2026-05-01]. https://owasp.org/Top10/.
- 中华人民共和国海关总署. 2025 年中国跨境电商进出口统计公报[R]. 北京: 海关总署, 2026.