# 写文章只写内容，其它的交给系统和 AI

> source: 想法/草稿/写文章只写内容.md

## 问题

现在新建一篇文章要先填文件夹名、标题、主题、摘要，才能开始写。写之前先回答「这篇叫什么、属于哪里、一句话讲什么」，正是最不想在动笔前做的事。

## 原则：作者只拥有正文，其它都是推出来的

文章里除了正文，每个字段都分成两类：

| 字段 | 从哪来 | 要不要 AI |
|---|---|---|
| id | 新建时固定（`documentId`），网站地址是 `/doc/<id>` | 不要 |
| 文件夹名 slug | 先用日期占位 `2026-11-05-a3f`；读者看不到它（地址用 id），AI 想好名字后 `mv` 改名，id 不变 | 起名要 |
| date | 第一次保存那天 | 不要 |
| title | 正文第一个 `# 标题`；没写就由 AI 起 | 有时要 |
| topic | 在已有主题里挑一个（`articles` 能列出全部） | 要 |
| deck 摘要 | 一句话概括 | 要 |
| tags | 从内容里挑 | 要 |
| cover | 正文里第一张图 | 不要 |

规则只有一条：**AI 只填空着的字段，作者写过的永远不覆盖**。想让 AI 重写某个字段，就把它清空。这样不需要额外记录「哪些是 AI 填的」。

## 流程

1. 点「写」：不弹对话框，直接是一张空白页，光标就在正文里。
2. 第一次保存时执行操作 `write <text>`：生成 `文章/<日期占位>/index.md`，写好 id 和 date，一次提交。
3. 保存以后在后台跑 `ai fill <path>`：补上 title、topic、deck、tags，再建议一个 slug。终端里出现一行 `$ ai fill 文章/2026-11-05-a3f/index.md ✓ 补了 title topic=算法 deck`，提交说明是 `ai: fill …`。
4. 右栏的卡片照样能改。改过的字段就是作者的，以后 AI 不再动它。
5. 公开时字段还缺，先自动跑一次 `ai fill`，再走原来的红线检查。

编辑器里不显示 front matter，只有正文；元数据都在右栏的卡片里。

## 做出来的（2026-11-05，还没有 AI）

- studio 书架上的「写」：不弹对话框，直接是空白页，光标在正文里。保存前右栏只有预览和一句说明。
- 第一次保存跑操作 `write <正文>`：建 `文章/<日期>-<三位十六进制>/index.md`，front matter 只填 id 和 date，正文原样保留。提交说明是 `studio: write ‹N 字›`，agent 用 `npm run op -- write -` 从标准输入给正文。
- 标题不进 front matter：构建和文章列表都取正文第一个 `# `；卡片里写了 title 才以它为准。卡片的标题框把推出来的标题显示成灰字。
- 打开任何一篇文章，编辑器里都只有正文；front matter 由右栏卡片改，保存时拼回去。所以编辑器行号、预览里块的位置和构建报错的「正文第 N 行」是同一个数。
- 没保存的空白页也会留草稿，下次点「写」时可以恢复。
- 旧的「新文章」对话框删了；`article new` 操作还留给 agent。

还没做：`ai fill`（补主题、摘要、建议文件夹名）。现在文件夹名是日期占位，要改就在卡片下面点「改文件夹名」。

## 正文的 AI 辅助

AI 就是另一个调用操作表的人（via = `ai`）：每一次改动都在终端里看得见，每一次都是一个提交，能撤回。网站上不标记谁写的，git log 里有记录。

分三层，从轻到重：

- **改一段**：选中一段，选「改写 / 续写 / 展开 / 压缩 / 检查」，或者用 Vim 式的 `ga` + 动作（比如 `gap` 是「问 AI 这一段」）。结果以对比的形式出现在原地，接受了才进正文。这一层只是读取（`ai suggest <path> <范围> <要求>`），不提交；接受以后走普通的 `save`。
- **审一篇**：右栏多一栏「批注」，`ai review <path>` 给出结构问题、讲不清的地方、缺的证明或例子，每条带上对应的段落，点一下就跳过去。这一层不改正文。
- **写一篇**：从一个想法或一段口述起草，`ai draft <想法路径>` 生成一篇未公开的文章交给作者改。这也正是 AGENTS.md 里说的「AI 是作者能力的一部分」。

## 实现上要定的

- 在哪调用模型：studio 跑在树莓派上，服务端直接调 Claude API（Pi 上要放 API key，按调用付费）。补字段用便宜快速的模型，审稿和起草用强一些的。动手前先加载 claude-api skill，确认模型名和调用方式。
- `ai fill` 什么时候跑：推荐保存后停顿几秒再跑，每篇文章同一时间只跑一次；不想自动跑就只在公开前跑。
- slug 由 AI 建议以后，是直接 `mv` 还是先问一声：推荐公开前自动改名，公开后不再动。

## 还没想通的

- 正文全是中文时，slug 用拼音、英文意译，还是一直保留日期占位？
- 「检查」能不能接上题库的数值核对，让数学文章里的每一步都能被验证？
- 口述（语音转文字）要不要作为第三种「只写内容」的入口？
