Wiki 架构规则
研究主题
古典政治哲学。
书写与维护约定
- 除
raw/外,本仓库的页面正文、目录说明、日志、比较表与工作提示一律使用简体中文。 raw/内原始材料保持原始语言、原始命名与原始表达,不做覆盖式改写。raw/下按材料类型分层存放;涉及整本书时,优先进入raw/books/。- 分析、比较、总结只进入 wiki 层,不写入
raw/。 - 页面文件名优先使用简体中文,与页面标题保持一致;如需分隔,可使用
-,避免空格。 - 每个 wiki 页面都必须包含 YAML frontmatter。
- 页面正文使用
[[wikilinks]]建立内部链接,每页至少保留 2 个出链。 - 真实内部链接必须直接写成
[[页面名]],不得写成`[[页面名]]`。反引号只用于展示语法示例,不用于实际可点击链接。 - 页面更新时同步修改
updated日期。 - 新页面必须写入
index.md。 - 每次
ingest、update、query、lint都要追加写入_meta/log.md。 - frontmatter 的键名保留英文:
title、created、updated、type、tags、sources。
根目录与 _meta/ 分工
- 根目录只放全仓库级、长期稳定、访问频率高的核心治理文件。
_meta/只放方法补充、专项协作协议、运行面板与其他元文档,不放实体页、概念页、比较页或原始材料。- 若某文件需要在几乎每次进入仓库时被读取,且其作用面向全仓库,应优先考虑放在根目录。
- 若某文件主要用于解释某种工作模式、承接某类专项流程、或作为运行中的辅助控制台,应优先放入
_meta/。
根目录当前固定承担以下职能:
CLAUDE.md:恢复入口、工作原则、必读顺序与更新义务。index.md:全仓库页面索引。
_meta/ 当前固定承担以下职能:
_meta/SCHEMA.md:结构规则、建页门槛、字段要求与页面边界。_meta/log.md:全仓库历史轨迹与修订留痕。_meta/项目总进度.md:全项目唯一主进度表,负责当前节点、下一步与阻塞项。_meta/渐进式读书协作模式.md:阅读工作流、写作模板、Git 协作、写入检查与结构反思。_meta/概念追踪.md:候选概念登记与升格追踪。
放置判断规则:
- 如果文件回答的是“这个仓库长期如何运作”,放根目录。
- 如果文件回答的是“当前项目推进到哪里”,放
_meta/。 - 如果文件回答的是“某一类工作如何进行”,通常放
_meta/。 - 如果文件已经成为研究对象本身,而不是治理工具,则进入
entities/、concepts/、comparisons/或queries/。
Frontmatter 模板
---
title: 页面标题
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [标签分类中的中文标签]
sources: [raw/articles/source-name.md]
---标签
- 标签使用简体中文,优先复用已有标签,避免近义漂移。
- 新增页面前
grep "^tags:" concepts/*.md查看现有标签池,自然参照。
页面门槛
- 当某一人物、概念或问题在 2 份以上材料中持续出现,或在单一材料中处于核心位置时,创建独立页面。
- 当新材料只是补充既有对象时,优先更新现有页面,不重复建页。
- 对一闪而过的名称、脚注性提及或与研究主题弱相关的内容,不单独建页。
- 建页决策前须先查
_meta/概念追踪.md:未达建页门槛的新概念先录入追踪表;已在追踪表中且本次触发升格条件的概念,直接建页并更新表中状态。 - 页面超过约 200 行时,拆分为子问题页面,并通过
[[wikilinks]]回连。 - 被完全替代的页面移入
_archive/,并在index.md与相关页面中标明归档状态。 queries/只用于沉淀已经形成稳定结论、可复用、值得反复回看的问答;临时对话、随手澄清与尚未稳定的问题,不单独建 query 页。
待补材料与进度边界
- 页面中的
待补材料只记录研究线索、候选材料、待核术语、待展开比较轴等分析性接口。 - 页面中的
待补材料不承担项目级待办职能,不写“当前在做什么”“下一步做什么”“卡在什么地方”。 - 具体的当前节点、下一步、阻塞项与事项优先级,统一写入
_meta/项目总进度.md。 - 当某条
待补材料已经升格为明确推进事项时,应从页面提示转入主进度表管理。 _meta/项目总进度.md是全项目唯一主进度表。页面中的待补材料与阶段性说明只是分析性补充;如与主进度表冲突,以主进度表为准。- 新事项进入仓库后,先入主进度表,再展开深度工作。
- 每个事项都必须写明一个清晰的
下一步,避免空泛状态。
Git 协作
Git 协作流程(分支分工、commit/merge 规则、汇报接口)详见 _meta/渐进式读书协作模式.md。
研究接口
为适应社会科学与政治哲学研究,本仓库页面优先保留下列接口:
经验事实:文本出处、历史语境、作者与制度背景。理想类型:该对象或概念在分析上被建构成什么类型。现实偏离/混合:经验世界如何偏离理论模型,或不同类型如何混合。机制解释:对象之间如何发生作用、转化与约束。
命名歧义消除
同名文本来自不同作者时,以”书名(作者)”格式区分,例如 法律篇(西塞罗).md vs 法律篇.md(柏拉图)。歧义消除括号与书名之间无空格,与 Obsidian wikilink 格式一致。
文本实体页与比较页写作结构
写作模板、逐卷分析的粒度标准与风格要求详见 _meta/渐进式读书协作模式.md。
比较页写作结构
比较页(comparisons/)用于固定两个以上对象的系统对照,核心理念是以轴驱动比较,而非按对象分述。
页面定位 → 基本坐标(对象×维度矩阵) → 轴一/轴二/轴三... → 综合判断 → 开放张力写作要求:
- 每个比较轴包含:理想类型对照表 → 机制解释(ASCII 流程) → 比较判断(一句话判断差异的实质)
基本坐标用一张表锁定比较对象在核心维度上的差异,让读者快速建立坐标系综合判断不是把各轴判断加总,而是指出最具解释力的那个差异——那个能解释其他差异的根本分歧开放张力列出本次比较无法闭合的问题,供后续研究回访
更新规则
当不同材料出现冲突时:
- 先记录两种说法的时间、出处与语境。
- 不直接覆盖旧说法,而是在页面中显式标注争议。
- 将冲突纳入后续
lint或人工复核。