文档格式模板

本文件定义所有 Wiki 文档的标准格式，方便复制使用。

1. 摘要格式（wiki/summaries/）

文件命名：YYYY-MM-DD-{描述}.md（与原文保持一致）

---
source: {原始文件路径}
title: {原文标题}
compiled_date: {YYYY-MM-DD}
---

# {摘要标题}

## 三步编译结果

### 第一步：浓缩
**结论 1**：{核心结论}
  - {证据 1}
  - {证据 2}

**结论 2**：{核心结论}
  - {证据 1}

**结论 3**：{核心结论}
  - {证据 1}

### 第二步：质疑
针对结论 1：
1. {前提假设分析}
2. {边界条件 / 反例}

针对结论 2：
1. {前提假设分析}
2. {边界条件 / 反例}

### 第三步：对标
1. **跨域类似现象**：{...}
2. **知识可迁移场景**：{...}
3. **关联概念**：[{概念名}](../concepts/{文件名}.md)

2. 概念条目格式（wiki/concepts/）

文件命名规范：全部小写拼音 + 连字符，如 ti-li-qia-ji-zhi.md

---
concept: {概念名称}
sources: [{来源文件1}, {来源文件2}]
last_updated: {YYYY-MM-DD}
status: 草稿 / 已整理 / 已验证
---

# {概念名称}

## 定义
{一句话说清是什么}

## 关键数据点（附来源）
- {要点 1} - [{来源文件简称}]({路径})
- {要点 2} - [{来源文件简称}]({路径})

## 前提与局限性
{知识成立的条件，不适用的场景}

## 冲突标记（如有）
{如果不同文章观点矛盾，写在这里}

## 关联概念
- [{相关概念 1}]({文件名}.md)
- [{相关概念 2}]({文件名}.md)

3. 方法论页面格式（wiki/methods/）

文件命名：{方法名称拼音}.md

---
method: {方法名称}
sources: [{来源文件1}, ...]
last_updated: {YYYY-MM-DD}
status: 草稿 / 已整理 / 已验证
---

# {方法名称}

## 概述
{一句话说清这个方法解决什么问题}

## 使用场景
{在什么情况下应该使用这个方法}

## 实施步骤
1. {步骤一}
2. {步骤二}
3. {步骤三}

## 优缺点分析
### 优点
- {...}

### 缺点/局限性
- {...}

## 相关资料
- [{相关概念}](../concepts/{文件}.md)

4. 决策记录格式（wiki/decisions/）

文件命名：ADR-{序号}-{决策主题}.md

---
decision_id: ADR-{序号}
title: {决策标题}
date: {YYYY-MM-DD}
status: 提议 / 已接受 / 已否决 / 已替代
---

# {决策标题}

## 背景
{决策的背景和问题陈述}

## 决策内容
{具体做了什么决策}

## 决策理由
{为什么这么选}

## 被否决的替代方案
- {方案 A}：{否决理由}
- {方案 B}：{否决理由}

## 后果
### 正面影响
- {...}

### 负面影响
- {...}

### 需要后续跟进
- {...}

## 相关资料
- [{相关概念}](../concepts/{文件}.md)

5. 索引格式（wiki/indexes/）

index.md - 全局索引

# 知识库索引

> 最后更新：{YYYY-MM-DD}

## 概念索引
| 概念 | 文件 | 来源数 |
|------|------|--------|
| {概念名} | [文件](../concepts/{文件}.md) | {n} |

## 方法论索引
| 方法 | 文件 | 用途 |
|------|------|------|
| {方法名} | [文件](../methods/{文件}.md) | {用途} |

## 决策记录索引
| ID | 标题 | 日期 | 状态 |
|------|------|------|------|
| ADR-001 | [标题](../decisions/ADR-001-xxx.md) | YYYY-MM-DD | 已接受 |

## 摘要索引
按时间倒序排列，最新在前。

- [YYYY-MM-DD 标题](../summaries/YYYY-MM-DD-xxx.md)

log.md - 操作日志

# 操作日志

## 2026-05-09
- 导入：产品需求.txt → 01-需求讨论/2026-05-09-产品需求.md
- 编译：2026-05-09-产品需求.md
- 新增概念：第三方登录（待观察）
- 健康检查：无问题

## 2026-05-08
- ...

6. 导入文件头部标记

导入后的文件，在开头添加：

<!--
来源：{来源信息}
导入时间：{YYYY-MM-DD}
原始文件名：{原文件名}
-->

{原文内容，完全保留}

使用说明

1. 复制模板：从本文件复制需要的格式
2. 填充内容：替换 {占位符} 为实际内容
3. 删除可选项：如果没有冲突/局限性等，删除对应章节
4. 保持一致：所有 wiki 文档都应遵循这些格式