docs: 重写 README、新增项目报告与开发工具配置
CI / lint + test + build (push) Canceled after 0s

- README 现代化重写:徽章区、特性一览、统一 GitHub 提示块格式、修正版本号与 AI 默认值
- 新增 docs/PROJECT_REPORT.md 学术项目报告(含许可证合规分析与死链修复记录)
- 收录 23 份 ADR 架构决策记录与 CONTEXT.md 领域术语表
- 新增开发配置:.editorconfig / .shellcheckrc / .markdownlint-cli2.jsonc
- .gitignore 补充 mo_map/、检查报告、编辑器临时文件
- 新增 config.example.json 配置模板(不含真实密钥)
This commit is contained in:
Shuery committed 2026-08-14 22:41:40 +08:00
1 parent 0df07ad0ae
commit c1ed1795c2
31 files changed
+1816 -234

No files matched your search

@@ -0,0 +1,7 @@
# 目录名兜底重搜:父目录名作为搜索 query 重试
识别搜索失败(zh → en 均无结果)时,文件名常是压制组风格(`[Group] - 01`),而**父目录名是完整剧名**(`[VCB-Studio] Re Zero kara Hajimeru Isekai Seikatsu` 目录)。此前只有 AI 能看到目录链(`match_entries` 的 directory 字段),规则路径白白失败一轮。决定:`tv_search_by_dir` / `movie_search_by_dir`——主搜索失败后,取父目录名(`clean_name` + `strip_season_suffix` 清洗)作 query 重搜(zh → en),命中即用(TV 复用 `pick_tv_show_id` 结构评分,电影取 results[0])。
**边界语义**:① **源根直属散放不兜底**(`dir == SOURCE_DIR`)——共享目录误判风险,与正片计数约束一致;② 目录名与 query 相同/为空时跳过(无新信息);③ 插在 MAL 兜底**之前**(本地目录信息零外部依赖,优先于外部 API);④ 目录名含季号("Re Zero 2nd Season")先剥季后缀;⑤ 兜底仍失败 → 原路径(MAL → AI)。
**Considered Options**: 只交给 AI 处理(原状)——每次失败消耗 AI 额度且延迟一轮;目录名直接当最终标题(跳过 TMDB 验证)——目录名可能是分类目录(特典/合集),必须经搜索验证;无条件用目录名——源根散放场景误判。