From 60308f3bf7495e384b694a68a659c5c544f688c3 Mon Sep 17 00:00:00 2001 From: OpenWiki Bot Date: Mon, 27 Jul 2026 11:26:10 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20add=20OpenWiki=E9=80=9F=E6=9F=A5?= =?UTF-8?q?=E6=89=8B=E5=86=8C=20(2026-07-27=20single-shot=20reference,=20n?= =?UTF-8?q?o=20re-explain=20needed)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sources/OpenWiki速查手册.md | 208 ++++++++++++++++++++++++++++++++++++ 1 file changed, 208 insertions(+) create mode 100755 sources/OpenWiki速查手册.md diff --git a/sources/OpenWiki速查手册.md b/sources/OpenWiki速查手册.md new file mode 100755 index 0000000..728845e --- /dev/null +++ b/sources/OpenWiki速查手册.md @@ -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 段, 你现在该做什么?" + +—— **零重聊**.