设定系统规范(BSD Vault · AI 协作权威文档)
本文件是 vault 内设定创作与维护的强制性规范,AI 与人工都必须遵守。 任何新建 / 移动 / 重命名 / 修订设定文件前,先读本文件 §8 检查清单。 关联入口:根
项目导航.md§1(创作红线)+ §6(结构层浓缩版)。本文是权威全文;若临时指令与本文冲突,须先修订本文或直接问用户。
0. 为什么要有这份规范
设定库已重构为 8 子目录 + 3 枢纽,并接入 Obsidian 结构层(frontmatter + wikilink + 图谱/反链 + Dataview/Bases)。这些约定一旦被后续 AI 破坏,会导致:
- 新文件平铺到
设定/根 → 文件夹体系崩坏、Graph 不成簇; - wikilink 格式错 → 图谱断裂、反链失效、Quartz 网页内链失效;
- 漏 frontmatter → Dataview/Bases 控制台聚合不到、标签过滤失效;
- 把未确认事实写进正典 / 误删旧设定正文 → 设定漂移、红线越界。
本文把所有”必须做 / 禁止做”收敛成一份,确保跨会话一致。
1. 文件夹结构(主题轴分桶)
设定/
├── 世界观.md · 伏笔.md · 设定导航.md · 设定系统规范.md ← 根:2 枢纽 + 2 指南
├── 世界本底/ 感官时代简史 · 五代人 · 时间线 · 世界逻辑
├── 社会制度/ 制度设定(索引) · 经济与服役 · 身份状态 · 势力 · 组织架构 · 政府部门 · 政府关系 · 失业潮
├── 社会日常/ 创作者阶层 · 公司_2057 · 宇宙探索_2057 · 性产业_2057 · 工作设定 · 教育 · 人类情绪光谱
├── 科技/ 技术设定(索引) · 设备体系 · 感知原理 · AI设定 · 感官训练室 · 技术谱系/(README+6)
├── 空间地点/ 铜城 · 建筑 · 地点定锚 · 场景锚点 · 物理档案
├── 秘密与真相/ 秘密层级与屏蔽系统 · 信息分层 · 视界镜_最后的屏幕 · 最后一块屏幕_隐喻 · 虚拟世界秘密
├── 人物/ 角色卡(*.md) + 人物关系.md(交集矩阵)
└── 元追踪/ 发布日历 · 术语统一表 · 发布平台与身份 · 闭环设计原则
放置规则
- 新设定文件按主题落入对应子目录;绝不把新建文件平铺到
设定/根(根只留 世界观 / 伏笔 / 2 指南)。 - 元追踪类(术语统一表 / 发布日历 / 发布平台与身份 / 闭环设计原则 / 人物关系 / 各 README / 控制台 / 本规范)标
层级: meta非canon。 - 人物卡放
人物/;跨角色交集追踪放人物/人物关系.md。 - 索引文件(制度设定 / 技术设定)保留为索引 +【修订附录·原全文】,不删原内容。
2. 文件命名规范
- 中文、简洁、名词性;人物卡 = 角色名.md(如
拉里.md);专题 = 主题词.md(如经济与服役.md)。 - 不用空格、全角标点(,。:;等)、版本号后缀(
-v2、_new、_旧)。 - 人物卡命名历史:首位卡
人物/拉里.md(原名沈劲阳_拉里.md已删)。角色姓沈,但叙事非必要不提;用户真名「沈劲阳」禁止写入任何设定文件。 - 文件改名 / 移动后,必须全库重写所有引用该文件的 wikilink 路径前缀(显示文字不变)。
3. Frontmatter schema(每个 设定/ 文件头部必须有)
---
类型: 设定 # 总纲 / 设定 / 人物 / 势力 / 伏笔 / 时间线 / 地点 / 信息 / 关系追踪 / 指南 / 技术谱系 …
层级: canon # canon | meta非canon(元追踪表=非正典)
状态: 稳定 # 稳定 | 待确认 | 冲突(冲突=含 ❌/⚠️)
涉及: [拉里] # 仅人物卡有,标注该角色名
tags: [canon, 设定] # 标签数组,供图谱着色与搜索过滤
publish: # 发布开关:填 true = 公开(进 Wiki 导航/搜索/图谱 + 进公开 RAG);留空/不写 = 内部(不进站点、不进 RAG)。详见 §7
---- 新建设定 / 人物文件:复制上方模板填字段。
状态随内容更新:含 ❌/⚠️ → 冲突;含【待确认】/ 待统一 → 待确认。- 发布模型(三个独立概念,详见 §7):
状态=内容成熟度;publish=是否授权公开;unlisted=公开后是否隐藏入口。新笔记默认不写publish→ 内部内容,永不自动公开;要公开必须显式填publish: true(且应同时满足状态: 稳定)。 - 人物卡带
涉及: [名字]+#名字标签(如#李砚)。 基础世界观设定.md按红线”只读不改动”,不在此结构层内(无 frontmatter、不接 wikilink)。
【修订 · 2026-07-11 · 核心字段扩展】统一核心字段(
对象/阶段/unlisted/创建日期/更新日期/关联/ 必备id)与阶段9 态枚举、各对象扩展字段(含依赖设定/影响内容/替代),见系统/数据结构/统一状态机规范.md(本文 §8 之下的字段权威)。既有 68 篇设定不强制补字段(依该文 §十一 分批迁移);新增 / 修订设定时,建议补齐对象: 设定与阶段,Bases「设定工作台」视图按设定/路径过滤,新旧都出现。
4. Wikilink 约定(最关键,防图谱 / 反链 / 发布断裂)
- 交叉引用一律写
[[相对路径|裸标题]],如[[设定/科技/技术设定|技术设定]]、[[设定/人物/拉里|拉里]]。 - 显示文字用裸标题(不带
.md)——路径部分负责跳转/反链,显示部分只需人类可读。Obsidian 文件列表、图谱本就不显示扩展名,wikilink 别名保持一致。 - 相对路径从 vault 根算(含
设定/前缀)。 - 禁止:
- 裸反引号引用
技术设定.md(除非是占位 / 示例,如chXX_标题.md,保持原样不臆造链接); - 畸形
[[[X|Y]]](Z); - 绝对路径(
/Users/...); - 只写
[[技术设定]]丢弃文件名。
- 裸反引号引用
- 移动 / 重命名文件后,用脚本把全库
设定/OLD前缀改为设定/子目录/OLD(正则(?=[\|\]])防误伤已含子路径),显示文字不变。
5. 修订与版本规范(红线)
- 【新增 YYYY-MM-DD】:新设定在对应文件末尾追加,标注日期。
- 【修订 YYYY-MM-DD】不删原文:推翻旧设定用【修订】标注新版本并注明原因;原内容保留为【修订附录·原全文】(如 制度设定.md / 技术设定.md 索引)。
- 【待确认】:未经用户”采纳”的设想,放【待确认】区或【建议区】,不写入正文当正典。
- 推测性交集(如早期 林溪 / 苏然 / 米希 与主线关系)标
非正典/⚪ 未设定,不定死。 - Callout 约定(新写块时用):
> [!warning] 待确认/> [!info] 修订/> [!question] 建议区。既有【待确认】#N 多为行内引用与标题,不批量转 callout。
6. 创作红线(最核心,防越界)
详见
项目导航.md§1 与本文件 §0。AI 任何”补世界观 / 解释合理性”任务,只允许: ① 从已有设定推导因果(标引用章节); ② 个人脑补进单独、明确标注【待你确认】的建议区,不写入正文当正典。 任何具体新事实(历史事件 / 机制名 / 数据 / 买家)须等用户说”采纳”才正式写入世界观.md及各专题。
7. 与发布(Quartz)的衔接
- 站点名「最后一块屏幕」;发布工具 Quartz(Obsidian vault 直出网页百科);内容源 =
设定/。 - frontmatter 与 wikilink 是 Quartz 原生消费的格式——本规范即发布一致性保障。破坏链接格式 = 网页内链失效。
- 元追踪类(
层级: meta非canon)默认不进入读者 Wiki 正文(除非显式发布)。
7.1 显式发布模型(publish / unlisted / 状态 三概念独立)
Wiki(Quartz explicit-publish 插件)与公开 RAG(Worker last-screen-rag)共用同一发布判断:
publish === true 且 unlisted !== true → 进入 Wiki 导航/搜索/图谱 + 进入公开 RAG
publish === true 且 unlisted === true → 页面可访问(直链),但不进导航/搜索/图谱,也不进公开 RAG
publish 不存在/非true → 内部内容:不进站点、不进 RAG(新笔记默认如此)
三个字段各管一件事,互不替代:
| 字段 | 只负责 |
|---|---|
状态 | 内容是否成熟(稳定 / 待确认 / 冲突) |
publish | 是否授权公开(true = 公开;留空 = 内部) |
unlisted | 已公开后是否隐藏入口(仅控制”易被发现”) |
规则:
- 新笔记默认不写
publish→ 天然私密,绝不会自动公开。 - 要公开:显式填
publish: true(这是唯一授权动作)。 publish: true+unlisted: true= 隐藏但可直链。publish: true应同时满足状态: 稳定;若publish: true但状态非稳定,构建前校验脚本(site/scripts/validate-publish.mjs)仅警告不阻断,建议尽快把状态转正。draft: true已废弃(启用显式发布后,没写publish本就不构建),保留仅为兼容旧条目;新模板不再使用。- 公开 RAG 只索引
publish: true且非unlisted的条目——不再依赖状态推断公开权限,杜绝”手册说只索引稳定、脚本却只判 unlisted”的偏差。
迁移说明(2026-07-11):首批 68 篇现有设定 +
index.md已全量补publish: true(保留各自unlisted),故站点外观 100% 不变;此后新笔记默认私密,发布只发生在一个明确动作上。
8. AI 工作流检查清单(每次动手前过一遍)
新建文件
- 想清落在哪个子目录(不落
设定/根) - 文件名合规(中文名词、无空格 / 全角 / 版本号)
- 加 frontmatter(复制 §3 模板,填 类型 / 层级 / 状态 / 涉及 / tags)
- 交叉引用用
[[相对路径|裸标题]],显示文字不带.md - 若是新硬设定类别,在
世界观.md§2 索引补一条 - 若是人物卡,更新
人物/人物关系.md矩阵
移动 / 重命名文件
- 物理移动后,全库重写引用该文件的 wikilink 路径前缀(显示文字不变)
- 校验:grep 无悬空旧路径
[[设定/OLD| - 若被
世界观.md§2 /项目导航.md§2 /设定导航.md索引引用,同步更新索引路径
修订设定
- 追加标
【新增 YYYY-MM-DD】;推翻用【修订】保留原文(不删) - 未确认事实进【待确认】/【建议区】,不写正文当 canon
- 更新相关文件 frontmatter
状态 - 若产生 / 关联伏笔,更新
伏笔.md
红线自检(任何输出前)
- 有无把未确认事实写进回答 / 正文当正典?→ 必须进【待确认】
- 有无把用户真名「沈劲阳」写入任何文件?→ 禁止
- 有无删除旧设定正文(非用【修订】)?→ 禁止
9. 与 AI 协作编排层的关系
本文 §8 是文件级操作清单(新建 / 移动 / 修订 / 红线自检)。 更高一层的 AI 角色 / 状态机 / 自动化边界总协议 见
系统/工作流说明/AI工作流.md:它规定 AI 以四个权限不同的岗位行动(资料管理员 / 世界设计顾问 / 内容创作者 / 编辑与发布员),以及一次内容从灵感到发布的 13 态闭环与两道人类门禁。 关系:本文 §8 是AI工作流.md之下的”动手前检查”子集;执行任何设定操作时,先过本文 §8,再遵守该文的岗位权限边界。冲突以本文 §6 红线为准。