无版权素材故事库

工作流程

第一步：理解用户需求

用户可能以多种方式触发：

• 按分类浏览："给我看看中华文化的志怪故事"
• 按关键词搜索："有没有关于复仇的故事"
• 按冷门度筛选："推荐一些冷门但有趣的故事"
• 按人物/能力搜索："有什么会飞的角色"
• 混合条件："中国古代关于智斗的冷门故事"

第二步：本地 + 在线并行检索（每次必须同时执行）

⚠️ 强制要求：每当用户提出故事需求，必须同时执行本地检索和在线搜索，不得只运行其中一个。

2a. 本地索引检索（必须执行）

python scripts/story_search.py [参数]

常用参数：

• --keyword "关键词" — 全文搜索（匹配标题、摘要、人物、能力、标签），支持多词空格分隔 OR 逻辑
• --scene horror/romance/fantasy/mythology/adventure/tragedy/wisdom/history/revenge/dream/comedy/hero — 场景方向精准筛选（支持多选）
• --category "中华文化" — 一级分类
• --subcategory "志怪传奇" — 二级分类
• --popularity hidden_gem — 冷门度（classic/notable/hidden_gem）
• --tags 复仇 智斗 — 标签筛选
• --limit 10 — 返回数量
• --detail story_id — 查看单条详情
• --list-categories — 列出所有分类和数量
• --stats — 冷门度统计
• --output json — JSON格式输出

场景方向（--scene）速查：

分类体系：

中华文化（着重）
├── 上古神话     盘古、女娲、夸父、精卫、刑天…
├── 民间传说     白蛇传、牛郎织女、孟姜女、梁祝…
├── 历史故事     鸿门宴、卧薪尝胆、荆轲刺秦…
├── 寓言故事     庖丁解牛、守株待兔、愚公移山…
├── 志怪传奇     聂小倩、画皮、宋定伯捉鬼、韩凭夫妇…
└── 古典小说     哪吒闹海、大闹天宫、三顾茅庐…

西方文化
├── 希腊罗马神话  普罗米修斯、奥德修斯、西西弗斯…
├── 北欧神话     诸神黄昏、洛基的孩子们…
├── 凯尔特传说   亚瑟王与圆桌骑士…
├── 圣经故事     大卫与歌利亚…
├── 欧洲民间童话  侏儒怪…
└── 西方古典文学  （在线扩充为主）

东方其他文化
├── 印度神话与史诗  搅拌乳海…
├── 日本神话与传说  竹取物语…
├── 阿拉伯与波斯   辛巴达航海记…
└── 埃及神话       奥西里斯与伊西斯…

美洲与非洲
├── 美洲原住民传说  双子英雄与冥界之旅…
└── 非洲口传文学   蜘蛛神阿南西…

2b. 在线扩充检索（必须执行，与 2a 同步进行）

python scripts/online_fetch.py "关键词" [--sources wikipedia gushiwen wikisource gutenberg] [--limit 5]

在线来源（8个权威机构）：

中华文献

• ctext.org — 中国哲学书电子化计划（香港学术机构，搜神记/聊斋/山海经等数千部原文，官方API）✅ 默认启用
• 古诗文网 — 中华古典文献全文（HTML检索）
• 维基文库 — 多语言原文全文（维基媒体基金会）✅ 默认启用

西方 & 全球文献

• Project Gutenberg — 70,000+公共领域书籍（非营利，1971年，全球最早数字图书馆，官方REST API）✅ 默认启用
• Open Library — 数百万册书籍（Internet Archive互联网档案馆，官方REST API）✅ 默认启用
• 美国国会图书馆 LOC — 千万级馆藏（美国联邦政府国家图书馆，1800年创立，官方API）
• Europeana — 5000万件欧洲文化遗产（欧盟文化遗产联合机构，覆盖50+国家博物馆/图书馆，官方API）

通用百科

• 维基百科 — 中英文百科（维基媒体基金会，官方API）✅ 默认启用

> 默认启用5个最稳定的来源；使用 --all-sources 启用全部8个；使用 --list-sources 查看所有来源详情

关键词提取规则：将用户需求中的核心词传给在线搜索脚本，例如：

• 用户说"爱情故事" → python scripts/online_fetch.py "爱情 传说"
• 用户说"中式微恐" → python scripts/online_fetch.py "鬼怪 志怪 恐怖"
• 用户说"神话创世" → python scripts/online_fetch.py "神话 创世 上古"

第三步：合并结果呈现

将本地检索和在线搜索结果合并展示，格式如下：

📚 共找到 X 条素材（本地 N 条 + 在线 M 条）

── 本地精选（含完整摘要和人物标注）──
[本地检索结果，按原有概览表格格式]

── 在线扩充（更多选择，可点击查看原文）──
[在线搜索结果，标注来源和链接]

合并展示原则：

• 本地结果优先展示（有完整摘要和人物标注，质量更高）
• 在线结果作为补充，明确标注来源平台和链接
• 若在线搜索因网络失败，只展示本地结果并说明原因
• 告知用户总数，让用户感知到选择的丰富程度

第四步：输出格式

阶段一：概览表格

检索结果以概览表格呈现，每条故事包含：

1. 标题、分类、冷门度、来源
2. ≤300字故事摘要：说清来龙去脉、转折起伏（经典故事可精简至100~150字）
3. 主要人物列表（3~5人）：人物名（角色定位｜能力/法宝）
4. 参考链接

冷门度标记：⭐ 经典 / 📖 知名 / 🔥 冷门

阶段二：详情

用户选中某条后，输出完整详情：

• 故事全文（或更详尽的摘要）
• 完整人物表（人物/身份/能力法宝）
• 原文链接（节省token，用户自行查阅全文）

人物能力标注规则

• 神话/仙侠角色：标注法宝、法术、神通（如：哪吒｜三味真火、风火轮、混天绫、三头六臂）
• 历史人物：标注特长、技能（如：张良｜运筹帷幄）
• 普通人物：能力栏为空或标注性格特质
• 每个角色能力不超过5项，取最具代表性的

版权原则

只收录已进入公共领域的内容（古代作品为主），不纳入近现代文学，不收录有版权争议的内容。