refactor(ffi): 降级 FFI 为可选兼容层并整理文档

将 bat-ffi 明确收敛为无状态 C ABI 兼容层，默认集成路径改为 bat --json 进程边界或未来稳定 SDK。

同步 README、当前状态、项目计划、架构文档、开发指南和缺口清单，移除 FFI 作为主集成边界的表述。

新增 AGENTS.md 和 CONTRIBUTING.md，压缩 CLAUDE.md 为兼容入口，并归档阶段性报告、同步 .gitignore 规则。

DOCS_INDEX.md

@@ -1,6 +1,6 @@
 # BlueArchiveToolkit 文档索引
 
-- **更新时间**：2026-07-14
+- **更新时间**：2026-07-15
 - **说明**：本索引用于快速定位当前权威文档和历史资料。
 
 ---
@@ -15,7 +15,9 @@
 - `docs/guides/official-full-pull-smoke.md`：真实官方全量拉取 smoke runbook 和可重复命令。
 - `docs/architecture/official-resource-backend.md`：官方资源后端职责、工作原理和审核说明。
 - `CHANGELOG.md`：版本变更记录。
-- `CLAUDE.md`：长期开发约束和项目要求。
+- `AGENTS.md`：AI agent 和自动化开发助手长期规则。
+- `CONTRIBUTING.md`：贡献者协作、提交和验证要求。
+- `CLAUDE.md`：Claude Code 等旧工具的兼容入口。
 
 ---
 
@@ -28,8 +30,6 @@
 - `deployments/systemd/`：官方资源同步生产 systemd unit 和环境文件示例。
 - `docs/guides/official-resource-test-pull.md`：官方资源拉取与自动更新用户指南。
 - `docs/guides/official-full-pull-smoke.md`：真实官方全量拉取 smoke runbook 和可重复命令。
-- `docs/reports/current-stage-prepush.md`：当前阶段说明与推送前核查记录。
-- `docs/reports/current-status-handoff.md`：给下一次对话使用的当前进度交接说明。
 - `docs/guides/baseline.md`：稳定工程基线指南。
 - `docs/architecture/adr/0001-engine-and-application-boundaries.md`：Rust/Go 边界决策。
 - `docs/architecture/adr/0002-cas-v1-design-boundary.md`：CAS V1 边界决策。
@@ -60,6 +60,7 @@
 历史报告已按来源和主题归档，供追溯使用，不再代表当前状态。
 
 - `docs/reports/historical/root/`：原根目录阶段报告。
+- `docs/reports/historical/current-stage/`：已被 `CURRENT_STATUS.md` 和当前指南取代的阶段交接、推送前核查报告。
 - `docs/reports/historical/week2/`：Week 2 相关报告。
 - `docs/reports/historical/week3/`：Week 3 相关报告。注意：这些报告中存在“完成”和“回滚”的冲突描述。
 - `docs/reports/historical/build-logs/`：历史构建、测试、Clippy 输出。
@@ -81,6 +82,8 @@
 7. `docs/guides/baseline.md`
 8. `docs/architecture/README.md`
 9. `docs/guides/development.md`
+10. `CONTRIBUTING.md`
+11. `AGENTS.md`
 
 ---
 
@@ -98,7 +101,7 @@
 - 真实官方网络全量拉取 smoke 已固化为 `scripts/official-full-pull-smoke.sh` 和 `make official-smoke`，默认写入 `/tmp` 隔离目录并输出本地运行报告。
 - `bat` 运行时 progress log 已覆盖总体下载进度、单文件下载进度和校验结果摘要。
 - Addressables 当前真实形态 fixture/golden 覆盖。
-- SQLite Resource Repository 和粗粒度 FFI JSON 接口。
+- SQLite Resource Repository 和可选无状态 `bat-ffi` JSON 兼容接口。
 
 优先待办：