Nsfc Code

输入（缺啥就问啥）

优先获取以下信息：

• 标书正文路径：一个目录（如 projects/NSFC_Young/）或主 .tex 文件路径
• （可选）用户偏好：希望主代码更偏“理论/方法/工程/交叉/转化”哪一侧
• （可选）输出位置/文件名约定（如需写到指定目录）

执行流程（推荐）

1) 确定时间戳与工作区

每次运行开始时，确定分钟级时间戳 {ts}（格式 YYYYMMDDHHmm），并创建本次专属工作区：

TS=$(date +%Y%m%d%H%M)
mkdir -p ".nsfc-code/v${TS}"

后续所有中间文件均写入 .nsfc-code/v{ts}/，最终交付文件写入工作目录根层。

2) 读取正文（只读）

• 递归读取输入路径下的正文文件（常见：.tex/.md/.txt；必要时包含 extraTex/）。
• 忽略编译产物与缓存目录（如 .latex-cache/、build/ 等）。

3) 候选代码粗排（确定性脚本）

运行脚本将正文内容与每个代码的 recommend 描述做启发式相似度打分，结果写入工作区：

python3 skills/nsfc-code/scripts/nsfc_code_rank.py \
  --input projects/NSFC_Young \
  --top-k 50 \
  --output-dir ".nsfc-code/v${TS}"

说明：

• 该粗排只用于”缩小候选范围”，最终 5 条推荐仍由你结合全文语义判断。
• 当使用 --output-dir 时，默认生成：
  • nsfc_code_rank.md（--format table）
  • nsfc_code_rank.json（--format json）
• 如用户只给了一段文本/单个文件，也可把 --input 换成具体路径。
• 如果用户明确知道学部/门类前缀（例如只可能是 A 类），建议加过滤降低噪声：

python3 skills/nsfc-code/scripts/nsfc_code_rank.py \
  --input projects/NSFC_Young \
  --top-k 50 \
  --prefix A \
  --output-dir ".nsfc-code/v${TS}"

4) 生成 5 组推荐（AI 语义判断）

从候选列表中选择 5 组推荐（每组 2 个代码）：

• 申请代码1（主）：最贴合核心研究问题与主要技术路线
• 申请代码2（次）：与主代码强相关的补充方向（常见策略：同一大类下相邻子方向；或同一研究对象但方法侧不同）

当存在不确定性时：

• 不要瞎猜；在理由中明确”为何不确定”，并说明”需要用户确认的关键信息”。

5) 写入交付文件（工作目录根层）

先用确定性脚本在工作区生成报告骨架，再由你填充内容，最后复制到根层：

python3 skills/nsfc-code/scripts/nsfc_code_new_report.py \
  --output-dir ".nsfc-code/v${TS}" \
  --ts "${TS}"
# 填充内容后，将最终报告复制到工作目录根层
cp ".nsfc-code/v${TS}/NSFC-CODE-v${TS}.md" ./

输出格式（写入文件）

文件建议结构如下（可按需要微调，但必须包含 5 条推荐与理由）：

# NSFC 申请代码推荐

- 生成时间：YYYY-MM-DD HH:mm
- 输入来源：xxx（标书路径/文件列表）
- 参考库：skills/nsfc-code/references/nsfc_code_recommend.toml

## 标书内容要点（只读提炼）

- 研究对象：
- 核心科学问题：
- 主要方法/技术路线：
- 关键应用场景/系统：
- 关键词（10-20 个）：

## 5 组代码推荐（主/次）

### 推荐 1
- 申请代码1（主）：A....
- 申请代码2（次）：A....
- 理由：

...（共 5 条）

## 候选代码粗排 Top-N（可选附录）

| rank | code | score | recommend 摘要 |
|---:|---|---:|---|
| 1 | A.... | 0.123 | ... |

参考库

• 代码推荐覆盖库：skills/nsfc-code/references/nsfc_code_recommend.toml