# Wiki 每日更新协议

> 本文件由 cron agent 执行，不要修改结构。

## 执行步骤

### Step 1：读取新增原始材料

检查 `~/Projects/project-wiki/raw/` 下的新文件：
- `raw/articles/` — 文章（URL 或手动粘贴文本）
- `raw/notes/` — 随手记录
- `raw/pdfs/` — PDF 文档

对每个未处理文件：
1. 阅读内容
2. 判断属于哪个项目/主题
3. 在 `wiki/sources/` 创建摘要页
4. 更新相关实体页，添加新知识点
5. 在文件名前加 `_processed_` 标记（如 `_processed_article.txt`）

### Step 2：读取最近 memory 日志

读取 `~/.openclaw/workspace/memory/` 最近 2 天的日志文件（YYYY-MM-DD.md）。

提取以下类型的信息：
- 新项目决策（技术选型、方向变化）
- 新工具 / 模型 / 参数确认
- 已解决的问题
- 新的基础设施变化

更新对应的 wiki 实体页 / 主题页。

### Step 3：LightRAG 同步检查

查询 LightRAG（`lightrag-query__lightrag_query`）：
- 查询："最近有什么新的项目决策或技术更新？"
- 如有新内容，补充到对应 wiki 页面

### Step 4：rebuild + deploy

```bash
# 本地同步到 gpu-local
rsync -avz ~/Projects/project-wiki/ jixian@gpu-local:/proj/share/www/project-wiki-src/

# gpu-local 重新 build
ssh jixian@gpu-local 'docker run --rm \
  -v /proj/share/www/project-wiki-src:/src \
  -v /proj/share/www/project-wiki:/site \
  squidfunk/mkdocs-material \
  build --config-file /src/mkdocs.yml 2>&1 | tail -3'
```

### Step 5：更新 log.md

在 `~/Projects/project-wiki/log.md` 追加今日操作记录：
- 处理了哪些新文件
- 更新了哪些 wiki 页
- 发现了哪些新知识点

### Step 6：汇报

完成后向 Jixian 发消息（Telegram）：
```
📚 Wiki 已更新
• 处理了 X 个新素材
• 更新了 X 个页面
• 新增了 X 个知识点
→ https://wiki.dev.suchka.me
```

如果没有任何新内容，无需发消息（静默完成）。

## 注意事项

- 不要删除已有 wiki 页面，只追加 / 修改
- 敏感信息（密码、API key）不要写入 wiki
- 每次 rebuild 前先 rsync，确保最新内容传到 gpu-local
- 如果 raw/ 目录为空且 memory 无新内容，跳过 build 节省资源