lingfengQAQ 77cf5c3a63 feat: add author-friendly reporting foundations 2 هفته پیش
..
csv 1d7c952b47 chore: remove legacy reference batch scripts 1 ماه پیش
index a03f6d057b chore(cross-val): finish agent invocation and retained reference index cleanup 2 هفته پیش
outlining 26b2bfaa5e docs: 重写 webnovel-review 与 webnovel-plan 并补齐关键 references 2 ماه پیش
review 20925cb8e7 refactor: reviewer 只查事实、审查只跑一轮,AI 味收敛到润色阶段 2 هفته پیش
shared 0184aa14f6 docs: 统一共享 references 的服务场景与判断标准 2 ماه پیش
taxonomy d8c474452d feat(genres): add taxonomy resolver and migrate search 2 هفته پیش
README.md 95904c39ba 完善 reference 知识层与测试治理 1 ماه پیش
author_error_catalog.json 77cf5c3a63 feat: add author-friendly reporting foundations 2 هفته پیش
author_glossary.json 77cf5c3a63 feat: add author-friendly reporting foundations 2 هفته پیش
genre-profiles.md b80e5a549b feat: complete story system phase5 workflow 2 ماه پیش
reading-power-taxonomy.md 20925cb8e7 refactor: reviewer 只查事实、审查只跑一轮,AI 味收敛到润色阶段 2 هفته پیش
review-schema.md 0184aa14f6 docs: 统一共享 references 的服务场景与判断标准 2 ماه پیش

README.md

References

本目录存放 webnovel-writer 的所有参考资料,供 skills 和 scripts 在运行时读取。

目录结构

子目录/文件 职责 消费方式
csv/ 结构化知识条目(9 张表) reference_search.py BM25 检索
csv/README.md CSV schema 规范与录入规则 人工参考
csv/genre-canonical.md 题材权威枚举(canonical + platform_tag 映射) 人工参考 + 代码常量对照
genre-profiles.md 题材 profile(fallback,高频题材已迁入 Story Contracts) ContextManager 直接读取
reading-power-taxonomy.md 追读力分类学 skills 直接读取
review-schema.md 审查输出格式定义 webnovel-review 读取
index/ 元数据索引(loading-map、gap-register) 人工参考
outlining/ 大纲相关参考 webnovel-plan 读取
review/ 审查相关参考 webnovel-review 读取
shared/ 跨 skill 共享参考 多 skill 读取

md vs CSV 边界

  • md: 流程规范、方法论、审查 schema、硬约束、润色指导
  • CSV: 可条目化的写作知识、命名规则、场景技法、桥段模板

md 是写给大模型当行为闸门的,CSV 是写给搜索引擎当知识库的。

消费链路

init -> plan -> write -> review 的完整 reference 消费路径见 index/reference-loading-map.md

校验

cd webnovel-writer/scripts
python validate_csv.py
python validate_csv.py --format json