docs: add OpenWiki速查手册 (2026-07-27 single-shot reference, no re-explain needed)

2026-07-27 11:26:10 +08:00
parent 652e517337
commit 60308f3bf7
1 changed files with 208 additions and 0 deletions
@@ -0,0 +1,208 @@
+# OpenWiki 速查手册 (Robin 一次聊清, 直接拿来用)
+
+> **目的**: 这份文档是 2026-07-27 一天 6 次对话的**完整沉淀**. 之后你跟任何 agent / 同事 / 客户 / 老板 提 OpenWiki, 直接把这份文档发过去, **不需要**重新讲一遍.
+>
+> **本文件不属于 OpenWiki wiki** (那是给 MiniMax code / Hermes cross-agent 用的), 这份是**给你 Robin 一个人**的速查手册, 跟 Robin 笔记本里其他笔记一样.
+
+---
+
+## 1. OpenWiki 是什么? (一句话)
+
+**OpenWiki = 把你 Robin 用的 7 个工具 (HN + Tavily + git-repo + NocoDB + SeaFile + Wiki.js + RAGFlow) 的真实状态, 自动汇总到 1 个 Gitea 公开 wiki, 你手机/台式机/任何浏览器都能 30 秒看全局**.
+
+不是: Notion 替代 / Obsidian 替代 / ChatGPT memory / 文档生成器. 是给 AI agent 看的本地 markdown 索引, 你手机/桌面浏览器能直接读.
+
+---
+
+## 2. 现在能用 (2026-07-27 真激活后状态)
+
+| 部件 | 状态 | 频率 |
+|---|---|---|
+| Gitea wiki 公网 | ✅ http://10.10.10.254:3080/Robin/openwiki-wiki | 实时 |
+| Cron 1 (02:00) `update.sh` | ✅ HN + Tavily + git-repo + M3 agent | 每晚 |
+| Cron 2 (02:30) `update-sources.sh` | ✅ NocoDB / SeaFile / Wiki.js / RAGFlow (5 文件) | 每晚 |
+| Cron 3 (*/30) `update-feishu-mail.sh` | ⏸️ 已布, 缺 IMAP 授权码 | 等飞书 IMAP |
+| 18 RAGFlow KB / 32,709 docs | ✅ 已拉 401 sample 进 wiki | 02:30 |
+| 桌面 embedding 服务 (bge-m3 + nomic-embed) | ❌ 7/17 起宕 | 你 IT 决定何时起 |
+| 废弃库 15922 docs (RAGFlow) | 🚫 **你明确不要清, 永久不动** | 永久 |
+| 飞书邮箱 IMAP | ⏸️ 飞书 IMAP/SMTP 需 IT 启用, 你拿到 16 位授权码我立刻接 | 等 |
+
+---
+
+## 3. 你 Robin 怎么用 OpenWiki (3 步, 30 秒)
+
+1. **打开浏览器** (你笔记本/手机) → `http://10.10.10.254:3080/Robin/openwiki-wiki`
+2. **看 9 个文件** (按这个顺序最有信息密度):
+   - `themes.md` (4 行 Robin 工作相关主题) — 30 秒看 "我关注啥"
+   - `sources/web-search.md` (Tavily 拉的 Nature/业界新闻) — 30 秒看 "昨晚行业信号"
+   - `sources/hackernews.md` (HN 跟你业务相关) — 30 秒看 "Hacker News 提了啥"
+   - `sources/git-repo.md` (Obsidian vault 状态) — 30 秒看 "我 Obsidian 最近变了啥"
+   - `sources/nocodb.md` (13 文献库 + 6604 records) — 30 秒看 "我 NocoDB 长啥样"
+   - `sources/seafile.md` (6 Repo / 77 GB) — 30 秒看 "我 SeaFile 长啥样"
+   - `sources/wikijs.md` (≥1633 pages) — 30 秒看 "我 Wiki.js 长啥样"
+   - `sources/ragflow.md` (18 KB / 32,709 docs) — 30 秒看 "我 RAGFlow 长啥样"
+   - `sources/ragflow-documents.md` (401 doc samples) — 2-3 分钟看 "我 RAGFlow 每 KB 实际有啥"
+   - `sources/feishu-mail.md` (空白) — 等你 IT 给 IMAP 授权码才激活
+3. **判断 + 决策** — 你**自己**用 wiki 数据**做产品经理决策**. 例子:
+   - 客户问 "Cellink 库有多少肝类器官 paper" → 你看 `sources/ragflow-documents.md` 2 分钟
+   - 老板问 "本周 OpenWiki 干了啥" → 你看 git log + themes.md 5 分钟
+   - 同事问 "9X Bio 跟我谈过啥" → 你看 `commitments.md` 30 秒
+
+---
+
+## 4. 你 Robin 跟任何 agent / 人聊 OpenWiki 时, 你能用这 5 句话讲清楚
+
+> "OpenWiki = LangChain 7/10 开源的'personal brain' 框架. 它有个 CLI 跑 cron, 自动把 Gmail/HN/Tavily/git-repo/Notion 6 种 connector 跟 NocoDB/SeaFile/Wiki.js/RAGFlow 4 种内部子系统的状态, 汇总成 1 个本地 markdown wiki, 推 Gitea. 我自己写的 cron 脚本补 RAGFlow 4 子系统的真实计数 + 401 个 doc sample. **目前覆盖 18 个 RAGFlow KB / 32,709 docs / 116,254 chunks**. 飞书邮箱还没接, 因为企业邮箱 IMAP 需 IT 启用. 桌面 embedding 服务挂了, KB vector retrieval 不可用, 但 metadata 还可查."
+
+---
+
+## 5. 你 Robin 真正"动手" 操作 (用你终端 + 1-2 行命令)
+
+### 5.1 看 wiki 公网是否活
+```bash
+curl -I http://10.10.10.254:3080/Robin/openwiki-wiki
+```
+
+### 5.2 看 cron 是否今晚跑
+```bash
+tail -20 ~/.openwiki/logs/cron-$(date +%Y%m%d).log
+tail -20 ~/.openwiki/logs/sources-sync-$(date +%Y%m%d).log
+ls -la ~/.openwiki/logs/
+```
+
+### 5.3 看 wiki 上次 commit
+```bash
+cd /home/ldw/.openwiki/wiki
+git log --oneline -10
+git status
+```
+
+### 5.4 手动 trigger cron 1 (02:00 那条) 跑一次 (不进 agent loop, 5 min)
+```bash
+bash /home/ldw/.local/bin/openwiki-update.sh
+```
+
+### 5.5 手动 trigger cron 2 (02:30 那条) 跑一次 (4 subsystem, 1 min)
+```bash
+bash /home/ldw/.local/bin/openwiki-update-sources.sh
+```
+
+### 5.6 手动 trigger cron 3 (30 分钟那条) — 等你 IT 给 IMAP 授权码后才生效
+```bash
+bash /home/ldw/.local/bin/openwiki-update-feishu-mail.sh
+```
+
+### 5.7 看 crontab
+```bash
+crontab -l
+```
+
+### 5.8 看 RAGFlow 18 KB / 32,709 docs 真实数据
+```bash
+# 看 wiki sources/ragflow.md
+head -30 /home/ldw/.openwiki/wiki/sources/ragflow.md
+
+# 看 wiki sources/ragflow-documents.md (401 doc samples)
+head -50 /home/ldw/.openwiki/wiki/sources/ragflow-documents.md
+
+# 直接查 RAGFlow
+TOKEN="ragflow-FiKwwHC1Lzw65IA83Funb3a3VF8-D8AC9nw7zYtBbFU"
+curl -s -H "Authorization: Bearer $TOKEN" \
+  "http://10.10.10.254:9980/api/v1/datasets?page=1&page_size=20" | python3 -c "
+import json, sys
+d = json.load(sys.stdin, strict=False)
+for x in d['data']:
+    print(f\"{x['name']:30s} {x['id']:35s} docs={x['document_count']:>5d} chunks={x['chunk_count']:>6d}\")
+"
+```
+
+### 5.9 你不记得某个命令时
+```bash
+# 看 cron 脚本本身 (self-documenting)
+cat /home/ldw/.local/bin/openwiki-update.sh | head -30
+cat /home/ldw/.local/bin/openwiki-update-sources.sh | head -30
+```
+
+---
+
+## 6. 你 Robin **不要** 做的 5 件事 (跟 OpenWiki 相关的禁区)
+
+1. ❌ **不**清废弃库 15922 docs (你 7-27 明确说不要清, 永久不动)
+2. ❌ **不**跑 `curl -X DELETE /api/v1/datasets/...` 类代码 (即使 KB "看着该清")
+3. ❌ **不**让 agent 改 `~/.openwiki_env.sh` 里的 RAGFlow/SeaFile/TAVILY/飞书 IMAP token (这些是 secret, 改了就连不上)
+4. ❌ **不**"重置" wiki (wiki 累积 7-16 至今的 git 历史, 重置就全丢)
+5. ❌ **不**用 Gmail 路径去接飞书邮箱 (你客户邮箱是飞书不是 Gmail, 路径完全不同)
+
+---
+
+## 7. 你 Robin **7-27** 一次性解决的真事 (回顾)
+
+| 问题 | 我做的 | 状态 |
+|---|---|---|
+| 7 天 0 产物 (cron PATH 错) | 修 PATH + 加 TAVILY key auto-load | ✅ 真跑通 |
+| Wiki.js 47 vs 1000+ | 5-orderBy union + max ID 1633 | ✅ 真相写 wiki |
+| RAGFlow 14 KB vs 真 18 KB / 32,709 docs | 直接 token + list_datasets API | ✅ 401 doc sample 入 wiki |
+| 飞书邮箱整合 | 准备 IMAP polling 脚本 (12 min 实现) | ⏸️ 等 IT 授权码 |
+| 4 子系统自动同步 (NocoDB/SeaFile/Wiki.js/RAGFlow) | update-sources.sh + crontab 02:30 | ✅ 全跑 |
+| 桌面 webUI 笔记本能进 | portproxy + 防火墙 + 任务计划 (7-16) | ✅ 跑通 |
+| 跨 agent 共享 wiki | Gitea public repo `http://10.10.10.254:3080/Robin/openwiki-wiki` | ✅ |
+| 飞书邮箱 **不是 Gmail** | memory 永久记录 | ✅ 未来不会推错 |
+| 废弃库 15922 docs 不动 | memory 永久记录 | ✅ 永久铁律 |
+
+---
+
+## 8. 你 Robin **未来** 可以让 OpenWiki 升级的 4 个方向 (按价值)
+
+| 优先级 | 方向 | 价值 | 你要做的 |
+|---|---|---|---|
+| 1 | 飞书邮箱 IMAP 集成 | ⭐⭐⭐⭐⭐ 客户邮件→wiki 自动 | IT 给授权码 |
+| 2 | 桌面 embedding 服务起来 (bge-m3 + nomic-embed) | ⭐⭐⭐⭐ RAGFlow KB vector retrieval 恢复 | 启动 7997/8090/11434 服务 |
+| 3 | 方式 4 MCP real query (OpenWiki agent 实时问 RAGFlow) | ⭐⭐⭐⭐ 跨 KB cross-query | 桌面服务起来后我做 |
+| 4 | 跟 NocoDB table 自动 sync (13 文献库 → wiki) | ⭐⭐⭐ 元数据可查 | 我现在能做, 但需你拍板 |
+
+---
+
+## 9. 你 Robin 跟其他 agent 交接时, 这份文档**怎么用**
+
+### A. 你换 / 升级 agent (你切到 MiniMax code 桌面)
+发这条:
+> "看 `/mnt/c/Users/20864/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md` (或 D 盘这个路径). 这是我 OpenWiki 全套配置 + 7-27 实测状态. 你读完就能用."
+
+### B. 同事 / 老板问 "OpenWiki 是什么"
+直接发这份手册. 30 秒读完, 同事能 catch up.
+
+### C. 你自己 1 个月后忘了
+打开 `~/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md` (或你 vault 同名文件) — 30 秒全回忆.
+
+### D. 你 6 个月后想升级 (飞书邮箱接好 / 桌面服务起)
+看第 8 段, 4 个升级方向已经按价值排序. 你告诉 agent "做 1" / "做 2" 即可.
+
+---
+
+## 10. 你 Robin **这份文档本身**怎么"记录"
+
+| 放哪 | 路径 | 用途 |
+|---|---|---|
+| Obsidian vault (主版) | `/mnt/c/Users/20864/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md` | 跟 Obsidian 同步, git 推 Gitea, 跨设备 |
+| OpenWiki wiki sources (副本, 公开) | 后续如果想让 MiniMax code / Hermes 看到, 拷一份 `~/.openwiki/wiki/sources/OpenWiki速查手册.md` | 让 agent 也能读 |
+| Gitea wiki (直接看) | `http://10.10.10.254:3080/Robin/openwiki-wiki` (commit + push 后) | 任何浏览器访问 |
+
+---
+
+## 11. 你 Robin 7-27 的"vibe" (跟 agent 聊天的 4 个习惯, 跟 OpenWiki 一起沉淀)
+
+- 你**对** "47" 数字**不**信 — 你**要**实测. → OpenWiki 探针用 GraphQL union, 不盲信
+- 你**不喜欢** "agent 凭印象" — 你**要**带证据 + URL. → OpenWiki docs 真实下载, 不虚拟
+- 你**明确** "废弃库不要清" — 你**不会**给"我帮你写个清理脚本" 留口. → memory 铁律, 永久
+- 你**对** "OpenWiki 怎么联 RAGFlow" 等战略问题**想**清楚再选 — 你**不要**"4 个选项让你选". → 给唯一推荐 + 理由, 你拍板
+
+**下次**你 Robin 跟任何 agent (包括我) 说"OpenWiki" 时 — 你**直接**说"看速查手册第 X 段" — 30 秒内任何 agent 都能 catch up.
+
+---
+
+**Robin 2026-07-27**: 这份文档是 1 个小时 6 个转折的**全部沉淀**. 之后你 / 任何 agent / 任何同事, 拿这份文档, **直接用, 不用每次聊**.
+
+下次我 (或别的 agent) 跟你重提 OpenWiki 时, 你**第一句**说:
+> "看 `~/.openclaw/workspace/OpenWiki速查手册_2026-07-27.md` 速查手册第 X 段, 你现在该做什么?"
+
+—— **零重聊**.