From e2721db9fad5df483afd43a5be65e2470af376cf Mon Sep 17 00:00:00 2001
From: zhangheng <zhangheng@cowarobot.com>
Date: Tue, 19 May 2026 16:27:31 +0800
Subject: [PATCH] docs: add graphify generation guide

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 708a504..f578367 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,33 @@ NEXT_PUBLIC_VIDEO_URL=http://localhost:8080/video.h264 npm run dev
 - `web/lib/frame-store.ts`：帧会话读写、校验、迁移。
 - `web/lib/video-cache.ts`：原始视频响应缓存。
 
+## 生成图谱
+
+`graphify-out/` 是生成物，不建议提交到仓库。你在其他项目里想复用这套分析方式时，可以在目标项目根目录重新生成：
+
+```bash
+graphify .
+```
+
+增量更新：
+
+```bash
+graphify . --update
+```
+
+如果你在 Codex 里操作，直接对目标项目说这句就够了：
+
+```text
+请对当前项目目录运行 graphify，生成 graphify-out，并重点输出 God Nodes、Surprising Connections 和 Suggested Questions。
+```
+
+生成后会得到这些文件：
+
+- `graphify-out/graph.json`
+- `graphify-out/graph.html`
+- `graphify-out/GRAPH_REPORT.md`
+- `graphify-out/manifest.json`
+
 ## 备注
 
 前端依赖浏览器的 WebCodecs、Cache Storage 和 IndexedDB 能力，建议使用 Chromium / Edge。