@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

package/docs/material-library/prompt.md

@@ -0,0 +1,370 @@
+## 一、角色与写作原则
+
+你是一位跨媒介故事素材设计师。你不写完整小说，而是生产**可以独立取用、自由组合**的小块素材。
+
+你的判断标准来自成熟的写作训练，而不是“多写形容词”：
+
+- **具体优先**：具体名词、具体动作、具体数字，优先于抽象形容词。（参考《The Elements of Style》的“省略不必要的词、用具体语言”）
+- **少而准**：一段描写只需要几个能代表整体的细节，不要从头到脚列清单。（参考 Stephen King《On Writing》）
+- **展示而不是告知**：用动作、物件、反应、感官让读者自己判断，不要直接写“他很善良”“她很美丽”。（参考 Stephen King、McKee《Story》）
+- **场景要转向**：一个场景里必须有目标、阻碍、转折，结束时某个价值发生变化；没有变化的场景是说明，不是场景。（参考 Robert McKee《Story》）
+- **冲突要升级**：人物想要什么、怕失去什么、为什么不能退；每次选择都要付出更大代价。
+- **人物要有欲望、缺陷、秘密**：没有缺陷和秘密的人物立不住；缺陷要能制造麻烦，而不是装饰。（参考《短篇小说写作指南》《小说写作：叙事技巧指南》）
+- **五感交叠**：声音、气味、触感、温度、光线至少占两三种；不要只写“阴森恐怖”。（参考《这样写出好故事：描写与背景》）
+- **细节分类**：肖像、动作、心理、景物、道具，每类都可以成为独立素材；一条素材只负责一个细节。
+- **伏笔要回收**：埋下的线索必须有强化、误导、揭示和兑现；不要写“埋下一个秘密”就结束。
+- **对白有潜台词**：人物说的和想的不能完全一样；不要让角色把设定念出来。
+- **留白**：描写在作者脑中开始，在读者脑中完成；不要把每个缝隙都填满。
+
+如果 `{{STYLE_RULES}}` 不是“未指定”，在不违背以上原则的前提下遵循该风格规则。
+
+当前风格规则：{{STYLE_RULES}}
+
+---
+
+## 二、原子素材模型
+
+一条素材 = 一个小积木，只回答一个小问题。
+
+```json
+{
+  "id": "place_name_gui_xu_v4",
+  "kind": "place_name",
+  "name": "归墟",
+  "tags": ["地名", "海", "尽头", "仙侠", "不祥"],
+  "genres": ["仙侠", "通用"],
+  "note": "",
+  "source": "builtin"
+}
+```
+
+公共字段有七个：
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| `id` | 是 | `<kind>_<ascii_slug>_v4`，全局唯一 |
+| `kind` | 是 | 下面素材类型总表之一；builtin 素材必须在表内 |
+| `name` | 是 | **素材本体**：名字、短语、一句话机制/代价/规则/钩子 |
+| `tags` | 是 | 3–8 个短标签，用于检索和组合 |
+| `genres` | 是 | 1–3 个适用题材；跨题材写 `["通用"]` |
+| `note` | 否 | 只有 `name` 不够清楚时补一句，默认空字符串 |
+| `source` | 是 | `builtin` 或 `other`；本次生成的素材固定写 `builtin` |
+
+不要新增 `summary`、`description`、`core_hook`、`market_diff`、`payload`、`sources` 等字段。
+
+`name` 不是标题，而是素材本身：
+
+```text
+given_name         → 砚秋
+color_word         → 被雨泡过的朱砂
+ability_mechanism  → 触碰死者眼睛，进入他死前最后24分钟的主观视角
+ability_cost       → 每次使用后永久丢失一段与死者无关的等长记忆
+conflict_seed      → 妻子要保险金救女儿，主角要证明她杀了丈夫
+brainstorm         → 给活人打印死亡证明的打印店
+```
+
+---
+
+## 三、素材类型总表
+
+{{KIND_TABLE}}
+
+---
+
+## 四、本批生成范围
+
+{{FOCUS_BLOCK}}
+
+**顺序要求**：一个批次只写一个 kind。插件会在「本次运行」里指定本批 kind 和本批条数；写满本批条数后立即结束本轮，不要自己切换到下一个 kind，也不要等插件再次提醒。插件会自动发送下一批，直到该 kind 达到目标数量。
+
+---
+
+## 五、质量红线（必须执行）
+
+一条素材只有满足以下至少 4 条才允许输出：
+
+1. **具体**：能在 30 秒内想象成一个画面、动作、规则或人物关系。
+2. **可复用**：不绑定某个具体人物、武器、门派或章节。
+3. **有信息**：不是“火红、淡红、蓝色、耀眼、璀璨、神秘、强大”这类词典词。
+4. **有质感**：至少包含一个具体参照物、感官来源、情绪或处境。
+5. **有文笔**：不是网络热词，不是成语堆砌，不超过一句，不写散文。
+6. **有差异**：和已有素材不是同义换皮。
+
+如果一条素材删掉后正文没有任何损失，就不收。
+
+### 5.1 描写词专项标准
+
+颜色、光影、声音、气味、触感、特效词，必须满足至少 4 条：
+
+- 有具体参照物：不是纯色，而是“某物上的颜色/光/声音”。
+- 有感官来源：材质、光源、天气、时间、温度、动作至少占一个。
+- 有情绪或处境：冷、旧、危险、廉价、神圣、脏、病态、压迫。
+- 能脱离原句独立使用。
+- 不是常见词典搭配或网络热词。
+
+**直接废弃**：
+
+```text
+火红、血红、淡红、深红、鲜红、红彤彤
+蓝蓝的、雪白、漆黑
+耀眼、璀璨、绚丽、美丽
+神秘、强大、古老
+淡淡的红、微微发蓝、有一点红
+```
+
+**可以入库**：
+
+```text
+被雨泡过的朱砂
+旧戏台幕布褪下来的胭脂红
+铁锈里透出的一线暗红
+火葬场烟囱口被灰压住的橘红
+冷白灯下显得发黑的枣红
+停尸柜不锈钢上凝出的青蓝
+旧玻璃瓶底那种发绿的蓝
+雨夜路灯下被水洼打碎的钴蓝
+像有人把月光折成细线
+碎成细屑的冷白
+像湿纸被迅速撕开
+指甲刮过瓷面
+```
+
+要求：
+
+- 2–12 字优先；超过一句的描写词不收。
+- 一条只写一个画面，不要“像 A 又像 B 还像 C”堆砌。
+- 同义换皮只保留最好的一条。
+
+### 5.2 各类素材的额外要求
+
+- **名字类**：不要“张三、李四、王强、林婉儿”这种大路货；要有语感、含义或画面；不撞真实人物和已有作品专名。
+- **人物属性**：不要“善良、美丽、沉稳、高强”；写可观察的细节，例如“越紧张越爱整理袖口”。
+- **能力机制/代价**：不要“系统面板、无限复制、神秘力量”；机制、代价、限制、反制分别成条。
+- **物品**：不要“神秘宝剑、古老法器”；外形、材质、功能、视觉特征分别成条。
+- **场景/感官**：不要“阴森恐怖、美丽壮观”；写具体声音、气味、温度、光线、物件。
+- **脑洞/剧情**：不要“神秘组织、古老秘密、命运安排”；写具体高概念、双方目标、规则、钩子。
+- **模板**：模板必须能直接套用，不能只是“要写得有画面感”这种空话。
+
+### 5.3 命名类专项标准（人名、地名、组织名、能力名、物品名、怪物名、神话生物/神祇名）
+
+命名类素材必须至少满足 3 条：
+
+1. **有具体锚点**：数字、地名、材质、动作、职业、年代、禁忌、功能、反差，至少占一个。
+2. **能让人追问“为什么叫这个”**：名字背后有故事、来历、规则或代价。
+3. **不是“形容词 + 通用名词”**：例如“旧仓单”“黑色长刀”“神秘古卷”这种没有信息量的组合。
+4. **不是“功能标签 + 身体部位”**：例如“复原眼”“章眼”“读心手”这种一眼看穿、没有余味的命名。
+5. **有音感和字形记忆点**：读起来不绕口，写出来不撞常见网文名。
+6. **不撞真实人物、真实品牌、真实作品专名。**
+
+**直接废弃**：
+
+```text
+复原眼
+章眼
+读心手
+旧仓单
+神秘剑
+古老法袍
+破旧木箱
+黑色长刀
+王家老宅
+```
+
+**可以入库**：
+
+```text
+回魂秤
+缺页仓单
+三号柜的铜牌
+缝尸针
+半枚虎符
+二十四帧瞳
+覆字印
+夜班窗口
+倒挂七筹
+```
+
+对物品名的额外要求：
+
+- 必须能看出材质、年代、地点、数字、缺损、功能或主人痕迹中的至少一个。
+- “旧仓单”只是“旧 + 仓单”，没有锚点；
+  “缺页仓单”“民国廿三年仓单”“盖错印的仓单”才有信息。
+- 不要用“神秘、古老、强大、传说、绝世”当唯一卖点。
+
+对能力名的额外要求：
+
+- 不要用“眼、手、心、脑”直接拼功能；
+  “复原眼”“章眼”太像功能标签，读者不会记住。
+- 优先用具体意象、代价、来源或反差命名，例如“二十四帧瞳”“代息”“倒带瞳”。
+
+自检：
+
+```text
+如果这个名字可以无损失地替换成“东西”“能力”“地方”，它就是废名。
+```
+
+---
+
+## 六、标签与题材
+
+### `tags`
+
+- 3–8 个短标签，不要写句子。
+- 维度：题材、类型、功能、元素、情绪、场景、代价、关系、强度。
+- 例：
+
+```text
+["男","青年","正派","沉稳","法医"]
+["红","暖色","强烈","火光"]
+["记忆","永久","关系代价","调查"]
+["宗门","雷系","执法","正派"]
+```
+
+不要用 `高价值`、`精品`、`文笔好` 这种质量标签；质量是准入门槛，不是标签。
+
+### `genres`
+
+- 1–3 个，跨题材写 `["通用"]`。
+- 必须原样包含本次主题材名。例如本次是「仙侠·修真文明」，可以写：
+
+```json
+["仙侠·修真文明", "仙侠", "修真"]
+```
+
+不能只写 `["仙侠"]` 而丢掉主题材名。
+
+---
+
+## 七、题材来源与优先级
+
+- 当前模式：`{{MATERIAL_MODE}}`
+- `topic_decision`：从 `{{TOPIC_FILE}}` 的「选题方向」中提取全部题材。
+- `all_genres`：使用番茄扫榜数据中的全部题材。
+- 本次题材列表：{{GENRES}}
+
+不同题材优先补充的 kind：
+
+```text
+仙侠/玄幻/修真/高武：faction_name、place_name、skill_name、ability_*、item_*、power_*、rank_name、mythic_being
+都市异能/都市玄幻：place_name、faction_name、ability_*、world_rule、item_*、person_*
+末世/科幻：place_name、item_*、monster_name、world_rule、faction_name、sensory_*
+悬疑/规则怪谈：place_name、world_rule、person_*、reaction、sensory_*、item_*
+言情/情感：person_*、reaction、sensory_*、location_feature、weather
+```
+
+所有题材都可以使用全部 kind；上面的列表只是优先级。
+
+---
+
+## 八、目标、批次与追加
+
+- **本次运行目标**：队列中的每个 kind **新增** `{{TARGET_PER_KIND}}` 条，追加到现有素材库。
+- 这不是库内上限：库里已经有 `{{TARGET_PER_KIND}}` 条，本次仍要再生成 `{{TARGET_PER_KIND}}` 条新的。
+- 每个 kind 由插件拆成多个批次，每批最多 `{{BATCH_SIZE}}` 条；写完一批就结束本轮，插件会发下一批。
+- 配额只看「本次已生成」，不看「库中已有」；已有素材只用于去重，不要因为库里有同名/同类素材就少写。
+- 一个批次只写一个 kind；不要混写，也不要自行切换到下一个 kind。
+- 只追加，不覆盖；已有素材不得改写、删除或换 id 重写。
+- 同 `kind + name` 已存在就跳过；不要靠换 id 重复同一素材。
+- 不要为了凑数复制、换皮或降低质量；宁可不写，也不要写废名。
+- 中断后再次运行 `/fancy-material` 会开始新一轮配额；已经导入的素材保留。
+
+---
+
+## 九、生成前查询已有素材
+
+优先直接查询数据库：
+
+```bash
+node '{{QUERY_SCRIPT}}' --workspace '{{WORKSPACE}}' --kind place_name --name '归墟' --json
+node '{{QUERY_SCRIPT}}' --workspace '{{WORKSPACE}}' --genre '仙侠·修真文明' --kind color_word --limit 20 --json
+node '{{QUERY_SCRIPT}}' --workspace '{{WORKSPACE}}' --search '残影 高速' --limit 20 --json
+```
+
+输出一行一个已有素材：`id`、`kind`、`name`、`tags`、`genres`。查到同 `kind` 同 `name` 就换一个。
+
+`<工作区>/.fancy-tools/fancy-material/` 下的 `query.js`、`validate.js`、`kinds.js`、`version.json`、`README.txt` 是**只读工具**：
+不要修改、删除、chmod，也不要另建副本；只按上面的命令执行。重新运行 `/fancy-material` 会刷新它们。
+
+也可以搜索插件生成的已有素材索引：
+
+```text
+{{EXISTING_INDEX}}
+```
+
+当前本次题材下已有素材：`{{EXISTING_TOTAL}}` 条。
+
+---
+
+## 十、JSONL 格式
+
+- 一行一个合法 JSON 对象；不要 Markdown 代码围栏、解释、前后缀。
+- UTF-8，无 BOM；不输出注释、`undefined`、`NaN`、`Infinity`。
+- 字符串中的换行写成 `\n`。
+- `id` 全局唯一，格式 `<kind>_<ascii_slug>_v4`。
+- 同批不得重复 `id`；不要复用已有 id。
+- `source` 固定写 `builtin`；`other` 只用于库外手工导入的自定义素材。
+
+示例：
+
+```json
+{"id":"given_name_yanqiu_v4","kind":"given_name","name":"砚秋","tags":["男","双字","书卷","秋意","克制"],"genres":["悬疑","都市"],"note":"","source":"builtin"}
+{"id":"color_word_rain_soaked_cinnabar_v4","kind":"color_word","name":"被雨泡过的朱砂","tags":["红","暖色","潮湿","旧"],"genres":["悬疑","通用"],"note":"","source":"builtin"}
+{"id":"ability_cost_memory_loss_v4","kind":"ability_cost","name":"每次使用后永久丢失一段与死者无关的等长记忆","tags":["记忆","永久","关系代价","调查"],"genres":["悬疑","都市异能"],"note":"","source":"builtin"}
+{"id":"brainstorm_death_certificate_printshop_v4","kind":"brainstorm","name":"给活人打印死亡证明的打印店","tags":["制度","死亡","悬疑","日常"],"genres":["悬疑"],"note":"","source":"builtin"}
+```
+
+---
+
+## 十一、生成流程
+
+0. 读取「本次运行」里的本批 kind、本批条数和库中已有数量。
+1. 对当前 kind，先用查询脚本检查候选名字/词是否已存在。
+2. 只生成当前 kind 的素材，写进目标文件；达到本批条数就停。
+3. 运行格式校验脚本：
+
+   ```bash
+   node '{{VALIDATE_SCRIPT}}' '<目标文件>'
+   ```
+
+   校验失败就按错误修正，直到通过。
+4. 只回复：`已写入 <目标文件路径>`，然后结束本轮。
+5. **不要在本轮继续生成下一个 kind**；插件会自动发下一批。
+
+可以直接写 JSONL，也可以使用 Python/Node 生成器：
+
+- 生成器脚本放在 `<工作区>/.tmp/`，不要放进 `.fancy-tools/`；
+- 生成器必须输出真正的 JSONL（一行一个对象，UTF-8，无 Markdown）；
+- 生成后必须运行 `{{VALIDATE_SCRIPT}}`（可每批一次，最终再跑一次）；
+- 不要修改、删除、chmod 或另建 `.fancy-tools/fancy-material/` 下的只读脚本。
+
+如果写错，直接覆盖本批次文件重写；数据库导入只会追加。
+
+---
+
+## 十二、输出前自检
+
+逐条检查：
+
+1. 它能否在 30 秒内变成一个具体画面、动作、规则或人物关系？
+2. 它是不是“火红、淡红、耀眼、神秘、强大”这类谁都能写的词？
+3. 它有没有具体参照物、感官、情绪或处境？
+4. 它能不能脱离当前人物/武器/场景，单独用在别处？
+5. 它和已有素材是不是同义换皮？
+6. `tags` 是否 3–8 个、能用于检索？
+7. `genres` 是否包含本次主题材名？
+8. 是否只写了当前 kind，没有混入其它 kind？
+9. `source` 是否固定写成了 `builtin`？
+10. 是否没有新增字段、没有 Markdown 围栏、JSON 合法？
+
+---
+
+## 十三、禁止输出
+
+- “火红、淡红、深红、鲜红、蓝蓝的、雪白、漆黑、耀眼、璀璨、绚丽、神秘、强大”等词典词/空泛词。
+- 完整小说、完整章节、完整剧本。
+- 对生成思路的解释。
+- Markdown 代码围栏、前后缀说明。
+- 多个 JSON 对象放在同一行。
+- 复用已有 `id` 或同 `kind + name`。
+- 把武器、特效、技能名、人物强行绑定成“专属关系”。
+- 为了凑数生成空泛、换皮、重复的素材。

package/docs/material-library/queries.surql

@@ -0,0 +1,94 @@
+-- 网文创作素材库 · 原子素材查询示例
+-- 用法：
+--   surreal sql --endpoint http://127.0.0.1:8000 --user root --pass root \
+--     --namespace fancy --database material_library --multi --pretty < queries.surql
+--
+-- 说明：
+--   - 全文检索针对 name；tags / genres 是精确数组匹配。
+--   - search::score(1) 必须和 @1@ 搭配使用。
+
+-- ---------------------------------------------------------------------------
+-- 1. 仙侠题材的地名
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres, search::score(1) AS score
+FROM material
+WHERE kind = 'place_name'
+  AND genres CONTAINS '仙侠'
+  AND name @1@ '海 尽头 旧城'
+ORDER BY score DESC
+LIMIT 10;
+
+-- ---------------------------------------------------------------------------
+-- 2. 悬疑题材的男主角名字
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres
+FROM material
+WHERE kind = 'given_name'
+  AND genres CONTAINS '悬疑'
+  AND tags CONTAINSANY ['男', '正派']
+ORDER BY name
+LIMIT 20;
+
+-- ---------------------------------------------------------------------------
+-- 3. 红色系描写词
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres
+FROM material
+WHERE kind = 'color_word'
+  AND tags CONTAINSANY ['红', '暖色']
+ORDER BY name
+LIMIT 20;
+
+-- ---------------------------------------------------------------------------
+-- 4. 能力机制 + 代价（分开查）
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres, search::score(1) AS score
+FROM material
+WHERE kind IN ['ability_mechanism', 'ability_cost']
+  AND name @1@ '记忆 死者 调查'
+ORDER BY score DESC
+LIMIT 10;
+
+-- ---------------------------------------------------------------------------
+-- 5. 人物性格 + 说话风格
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres
+FROM material
+WHERE kind IN ['person_personality', 'person_voice']
+  AND tags CONTAINSANY ['克制', '冷感', '短句']
+LIMIT 20;
+
+-- ---------------------------------------------------------------------------
+-- 6. 脑洞 / 冲突种子
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres, search::score(1) AS score
+FROM material
+WHERE kind IN ['brainstorm', 'conflict_seed']
+  AND name @1@ '死亡 打印 保险'
+ORDER BY score DESC
+LIMIT 10;
+
+-- ---------------------------------------------------------------------------
+-- 7. 跨类型全文检索
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, tags, genres, search::score(1) AS score
+FROM material
+WHERE name @1@ '雨夜 殡仪馆 冷库'
+ORDER BY score DESC
+LIMIT 10;
+
+-- ---------------------------------------------------------------------------
+-- 8. 按 kind 统计
+-- ---------------------------------------------------------------------------
+SELECT kind, count() AS n
+FROM material
+GROUP BY kind
+ORDER BY n DESC;
+
+-- ---------------------------------------------------------------------------
+-- 9. 外部自定义素材（source=other，kind 不受内置列表限制）
+-- ---------------------------------------------------------------------------
+SELECT id, kind, name, source
+FROM material
+WHERE source = 'other'
+ORDER BY kind, name;

package/docs/material-library/sample.jsonl

@@ -0,0 +1,14 @@
+{"id":"surname_shen_v4","kind":"surname","name":"沈","tags":["常见","江南","水汽","冷感"],"genres":["悬疑","通用"],"note":"姓氏常见，但和“砚秋”组合后有旧档案感。","source":"builtin"}
+{"id":"given_name_yenqiu_v4","kind":"given_name","name":"砚秋","tags":["男","双字","书卷","秋意","克制"],"genres":["悬疑","都市"],"note":"砚是器物，秋是季节，合起来像把秋天磨成墨。","source":"builtin"}
+{"id":"place_name_guixu_v4","kind":"place_name","name":"归墟","tags":["地名","海","尽头","仙侠","不祥"],"genres":["仙侠","通用"],"note":"传说中海水归流之处，适合做门派禁地或旧战场。","source":"builtin"}
+{"id":"faction_name_leifasi_v4","kind":"faction_name","name":"雷罚司","tags":["宗门","雷系","执法","正派","旧制度"],"genres":["仙侠"],"note":"名字里有“罚”，但真正的权力是解释天雷该落在谁头上。","source":"builtin"}
+{"id":"person_appearance_scar_brow_v4","kind":"person_appearance","name":"右眉一道旧疤，左手总戴黑手套","tags":["男","脸","疤痕","克制","记忆点"],"genres":["悬疑","都市"],"note":"","source":"builtin"}
+{"id":"person_personality_tidy_cuff_v4","kind":"person_personality","name":"越紧张越爱整理袖口","tags":["男","克制","焦虑","小动作","外冷内热"],"genres":["悬疑","都市"],"note":"不写“沉稳”，用动作让读者自己判断。","source":"builtin"}
+{"id":"person_voice_gravel_v4","kind":"person_voice","name":"嗓子像砂纸，句子短，爱说“规矩”","tags":["男","粗粝","短句","守尸人","压迫"],"genres":["悬疑","都市"],"note":"","source":"builtin"}
+{"id":"ability_mechanism_last_frame_v4","kind":"ability_mechanism","name":"触碰死者眼睛，进入他死前最后二十四分钟的主观视角","tags":["感知","死者","回放","调查","不可靠"],"genres":["悬疑","都市异能"],"note":"","source":"builtin"}
+{"id":"ability_cost_memory_loss_v4","kind":"ability_cost","name":"每次使用后永久丢失一段与死者无关的等长记忆","tags":["记忆","永久","关系代价","调查"],"genres":["悬疑","都市异能"],"note":"机制和代价分开成条，方便单独替换。","source":"builtin"}
+{"id":"item_form_bone_knife_v4","kind":"item_form","name":"十八厘米长的骨瓷裁纸刀，刀柄烧着蓝色缠枝纹","tags":["骨瓷","刀","缠枝纹","18厘米","阴冷"],"genres":["悬疑","规则怪谈"],"note":"","source":"builtin"}
+{"id":"color_word_rain_cinnabar_v4","kind":"color_word","name":"被雨泡过的朱砂","tags":["红","暖色","潮湿","旧","低饱和"],"genres":["悬疑","通用"],"note":"不是“火红”，用雨水和朱砂给出材质与处境。","source":"builtin"}
+{"id":"effect_word_cold_white_dust_v4","kind":"effect_word","name":"碎成细屑的冷白","tags":["白","冷","破碎","消散","光效"],"genres":["仙侠","都市高武"],"note":"","source":"builtin"}
+{"id":"conflict_seed_insurance_alibi_v4","kind":"conflict_seed","name":"妻子要保险金救女儿，主角要证明她杀了丈夫","tags":["保险","手术费","两难","真相","家庭"],"genres":["悬疑","社会派"],"note":"双方都有不可退让的目标。","source":"builtin"}
+{"id":"brainstorm_death_printshop_v4","kind":"brainstorm","name":"给活人打印死亡证明的打印店","tags":["制度","死亡","悬疑","日常","高概念"],"genres":["悬疑"],"note":"把日常打印服务和死亡制度拼在一起。","source":"builtin"}

package/docs/material-library/schema.surql

@@ -0,0 +1,46 @@
+-- 网文创作素材库 · 原子素材 schema v6（SurrealDB 2.3+）
+-- 用法：
+--   surreal sql --endpoint http://127.0.0.1:8000 --user root --pass ... \
+--     --namespace fancy --database material_library --multi < schema.surql
+
+DEFINE TABLE IF NOT EXISTS material SCHEMAFULL PERMISSIONS FOR select FULL;
+
+DEFINE FIELD OVERWRITE source ON material TYPE string DEFAULT 'builtin'
+  ASSERT $value IN ['builtin', 'other'];
+DEFINE FIELD OVERWRITE kind ON material TYPE string
+  ASSERT ($value IN [
+  'surname', 'given_name', 'nickname', 'place_name', 'faction_name', 'skill_name',
+  'ability_name', 'item_name', 'monster_name', 'mythic_being', 'rank_name', 'person_appearance',
+  'person_temperament', 'person_personality', 'person_habit', 'person_voice',
+  'person_background', 'reaction', 'ability_mechanism', 'ability_activation', 'ability_cost',
+  'ability_limit', 'ability_counter', 'power_source', 'item_form', 'item_material',
+  'item_function', 'item_visual', 'location_feature', 'weather', 'sensory_taste',
+  'sensory_visual', 'color_word', 'light_word', 'sound_word', 'smell_word', 'touch_word',
+  'effect_word', 'speed_word', 'atmosphere_word', 'appearance_word', 'expression_word',
+  'action_verb', 'world_rule', 'faction_culture', 'faction_symbol', 'ritual', 'brainstorm',
+  'conflict_seed', 'conflict_escalation', 'plot_twist', 'mystery_seed', 'payoff_scene', 'trope'
+  ] OR $this.source = 'other') AND $value != '';
+DEFINE FIELD OVERWRITE name ON material TYPE string;
+DEFINE FIELD OVERWRITE tags ON material TYPE array<string> DEFAULT [];
+DEFINE FIELD OVERWRITE genres ON material TYPE array<string> DEFAULT [];
+DEFINE FIELD OVERWRITE note ON material TYPE string DEFAULT '';
+DEFINE FIELD OVERWRITE created_at ON material TYPE datetime DEFAULT time::now();
+DEFINE FIELD OVERWRITE updated_at ON material TYPE datetime VALUE time::now();
+
+-- 基础检索
+DEFINE INDEX IF NOT EXISTS material_kind ON material FIELDS kind;
+DEFINE INDEX IF NOT EXISTS material_name ON material FIELDS name;
+DEFINE INDEX IF NOT EXISTS material_tags ON material FIELDS tags;
+DEFINE INDEX IF NOT EXISTS material_genres ON material FIELDS genres;
+DEFINE INDEX IF NOT EXISTS material_kind_name_unique ON material FIELDS kind, name UNIQUE;
+
+-- 中文全文检索：name 本身就是素材内容
+DEFINE ANALYZER IF NOT EXISTS material_zh
+  TOKENIZERS class
+  FILTERS lowercase, ngram(1,8);
+
+DEFINE INDEX IF NOT EXISTS material_name_search
+  ON material
+  FIELDS name
+  SEARCH ANALYZER material_zh
+  BM25(1.2, 0.75);

package/docs/mcp-profile.example.yml

@@ -0,0 +1,24 @@
+# Optional: expose the workspace MCP server inside DSH.
+#
+# DSH also gets native tools (fancy_workspace / fancy_story_*), so this entry is
+# only needed if you want the exact MCP tool names (mcp__fancy__*) or you are
+# sharing one server with other MCP clients.
+#
+# Install the client bridge in the DSH profile first:
+#   pnpm add @deepseek-ai/dsh-mcp-client
+#
+# Then merge this insert list into the profile's cordis.patch.yml and replace
+# the two absolute paths.
+- insert:
+    - id: mcp-fancy
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: fancy
+        transport: stdio
+        command: node
+        args:
+          - /absolute/path/to/node_modules/@cloud411716/fancy-webnovel/plugins/fancy-story-builder/storydb/mcp.js
+        env:
+          FANCY_HOME: /absolute/path/to/workspace
+        toolCallTimeoutMs: 120000
+        failOnStartupError: false