Wiki 结构规则

Frontmatter 字段

每个页面顶部必须包含 YAML frontmatter:

---
title: 摇摆桥墩
type: concept        # concept | method | workflow | failure-mode | standard-clause | derivation | map | entity | source-summary | query | synthesis | comparison | index | schema
status: seed         # seed | draft | verified
tags: [摇摆隔震, 自复位]
sources:             # 来源列表,格式:作者 (年份), "标题", 期刊/学位论文
  - 'xxx (2024), "xxx", Engineering Structures'
updated: 2026-07-06
verified:            # 仅推导页必填:空 | gemini复推 | matlab数值验证 | 人工审核
---

页面类型

  • concept:概念页,回答“这是什么”,沉淀定义、背景、关键结论、争议和互链。
  • method:方法页,回答“这个方法怎么做、适合什么问题”,沉淀步骤、输入输出、适用范围和验证方式。
  • workflow:工作流页,回答“实际操作怎么走”,沉淀触发条件、步骤、命令、产物和检查清单。
  • failure-mode:失效模式页,回答“哪里容易错、怎么识别、怎么排查”,沉淀症状、原因、建议和反例。
  • standard-clause:规范条文或规范流程页,回答“规范要求怎么查、怎么引用”,必须保留精确来源位置。
  • derivation:推导页,一页一个推导,记录问题假设、逐步推导、结论公式、验证记录和适用范围。
  • map:路线图或概念地图页,用于组织一批互链页面和后续任务。
  • entity:人物、组织、软件、项目或产品页。
  • source-summary:单一资料摘要页,保留文献、规范、教材、报告等来源的可追溯摘要。
  • query:高价值问答或研究请求沉淀页,记录问题、检索路径、回答和可复用结论。
  • synthesis:跨资料综合页,面向一个问题整合多篇文献、规范或经验。
  • comparison:并列对比页,比较方法、模型、软件、规范条文或方案差异。
  • index:目录页。
  • schema:结构规则页。
  • topic:早期兼容类型,后续新页优先使用 conceptmethod 等细分类型。

命名与互链

  • 主题页文件名使用中文主题名,例如 摇摆桥墩.md
  • 互链一律使用 [[主题名]]
  • 一页一个概念,宁可多页互链,不写巨型页。
  • 公式使用 LaTeX;行间公式 $$...$$ 前后各留一个空行。

混合 Nashu 目录

knowledge/wiki/ 是当前 Quartz 内容根目录,同时承担 Nashu LLM wiki 的外层项目目录职责:

  • index.md:Quartz 首页,只放快速入口。
  • purpose.md:目标、关键问题、研究范围和边界。
  • schema.md:Wiki 结构规则、页面类型和验收标准。
  • raw/sources/:上传资料登记层。原始论文、规范、教材仍以 papers/standards/textbooks/md/ 等主库目录为准,不在这里重复复制。
  • raw/assets/:wiki 本地图片和附件登记层。
  • wiki/index.md:知识目录。
  • wiki/log.md:操作历史。
  • wiki/overview.md:全局概要。
  • wiki/entities/:人物、组织、软件、项目或产品。
  • wiki/concepts/:理论、方法、技术和高频专业问题入口。
  • wiki/sources/:资料摘要。
  • wiki/queries/:保存的高价值聊天回答和研究请求。
  • wiki/synthesis/:跨资料综合分析。
  • wiki/comparisons/:并列对比。

课题组特化层保留在 wiki/ 内:

  • wiki/workflows/:操作流程。
  • wiki/failures/:失效模式与常见坑。
  • wiki/standards/:规范查询流程和高频条文入口。
  • wiki/derivations/:公式推导与验证。
  • wiki/plans/:批次路线图、agent 分工和待办。

来源原则

  • sources 只登记可追溯来源,不编造论文、作者或 DOI。
  • wiki 内容与原文冲突时,以原文为准并修正 wiki 页。
  • status: seed 表示只完成来源登记与概念骨架,不能作为最终综合结论引用。

状态升级规则

  • seed:完成来源登记、页面边界、互链和待细读问题。
  • draft:至少细读相关来源并写出综合结论,结论后标注来源编号。
  • verified:推导经工具或人工复核;规范页经条文位置复核;建模页经实际脚本、资源条目或可复现实验支撑。