user guide worldbuilding - WangYajun369/ai-writing-platform GitHub Wiki

世界观资料库

世界观资料库是管理小说设定的核心工具,支持 6 种卡片类型。

卡片类型

类型 用途
👤 人物 角色设定、性格、背景故事
📍 地点 场景描述、地理位置
⏱️ 时间线 事件顺序、历史脉络
⚔️ 势力 组织、阵营、帮派
🎒 物品 道具、神器、装备
📋 其他 自由格式设定

创建卡片

  1. 在编辑器右侧打开世界观面板
  2. 点击「新建卡片」
  3. 选择卡片类型
  4. 填写标题和详细内容(富文本)
  5. 可选:添加标签
  6. 保存

管理卡片

搜索与过滤

  • 按类型过滤:顶部类型标签切换
  • 关键词搜索:搜索框实时过滤
  • 标签过滤:支持按标签筛选

编辑与删除

  • 点击卡片进入编辑
  • 支持富文本详情(TipTap 编辑器)
  • 删除操作不可恢复

独立窗口模式

世界观资料库支持独立悬浮窗口:

  • 点击面板顶部的「弹出窗口」按钮
  • 卡片编辑在独立窗口中进行(580×680,始终置顶)
  • 窗口始终置顶(always_on_top),方便跨窗口参考
  • 窗口关闭后数据自动同步到主窗口

数据关联

  • 世界观卡片绑定到具体作品(book_id 外键)
  • 每个作品拥有独立的世界观资料库
  • 删除作品时,关联的卡片级联删除

向量化与 AI 检索

每张卡片包含 vectorized 字段(表结构与备份载荷保留),但语义检索未接入对话:

  • 向量索引不会自动生成(设置页已移除 RAG 入口),该字段通常恒为未向量化
  • AI 对话的上下文由 Agent 引擎内置工具(全文搜索 / 章节读取)提供,不依赖向量检索
  • 若未来接入语义检索,可复用该字段标记向量化状态