# Discussion Notes 参考

## Frontmatter

```yaml
---
title: {{主题名}}
date: "{{YYYY-MM-DD}}THH:MM:00+08:00"
---
```

新建时写 `date`；大改时追加文内「更新」节即可。

---

## 笔记结构模板

### 选型 / 决策类

```markdown
# 标题

> 一句话说明文档用途。讨论过程中持续更新。

## 背景
## 结论
## （各专题章节）
## 落地清单
## 待验证
## 待深入
## 更新（可选）
```

### 概念 / 原理类

```markdown
# 标题

> 与 xxx 选型文档无关（若适用）。

## 核心结论
## 定位（是什么 / 不是什么）
## 工作原理
## 与相关概念对比
## 示例
## 常见误解
## 待验证
```

---

## 示例：选型笔记（节选）

```markdown
---
title: Podman vs Docker
date: "2026-07-02T22:50:00+08:00"
---

# Podman vs Docker

> 公司内部基础设施容器运行时选型笔记。讨论过程中持续更新。

## 背景

- 默认系统：Debian
- 部署：一服务一 VM，VM 内跑容器

## 结论

推荐 Podman；compose 用 `podman compose`。概念见 [quadlet](quadlet.md)。

## 待验证

- [ ] Debian VM 上 rootless + compose 冒烟测试
```

---

## 示例：概念笔记（节选）

```markdown
---
title: Quadlet
date: "2026-07-02T23:30:00+08:00"
---

# Quadlet

> Podman 与 systemd 的集成机制。

## 核心结论

- Quadlet 不是容器引擎，依赖 Podman
- `.container` 经 systemd generator 编译为 `.service`

## 常见误解

| 误解 | 事实 |
|------|------|
| 不装 Podman 也能跑 | ❌ ExecStart 即 podman run |
```

---

## 调用方式

```
@discussion-notes 讨论 xxx，记到 000inbox/xxx.md
```

---

## 工作流示意

```
用户提问
    │
    ▼
Agent 回复（中文）
    │
    ▼
更新 000inbox/<topic>.md
    │
    ├─ 延续话题 → 改已有文件
    └─ 新子话题 → 新建 md + 主文档加链接
```