openwiki-wiki/README-ACTIVATION.md

---
type: "Reference"
title: "OpenWiki 现状 + 操作手册 (2026-07-27)"
description: "Activation status + operations manual for Robin's local OpenWiki knowledge base as of 2026-07-27. Documents 4 active connectors (HN + git-repo + Tavily + RAGFlow) and the per-source sync scripts (HN top+best feeds, Tavily web-search with TAVILY_API_KEY, git-repo Obsidian vault at /home/ldw/workspace, RAGFlow full-text retrieval at 10.10.10.254:9980). Captures the on-disk Gitea commit + push pattern."
tags: [openwiki, operations, manual, activation, 2026-07-27]
---

# OpenWiki 现状 + 操作手册 (2026-07-27)

> **这个 wiki 现在按预期运转中。** 4 个 connector 全部激活；2 个 connector (HN + web-search) 已经在 2026-07-27 早上拉过数据并 commit + push 到 Gitea。

## 一、TL;DR — 已经激活的 3 个 connector

| ID | Connector | 状态 | 拉到的业务相关数据 |
|---|---|---|---|
| `hackernews-1` | Hacker News | ✅ active | 14+ hits on `class-organoid-3d-bioprinting` cluster (Nature liver-spheroid + organ-on-chip via cross-source) |
| `web-search-1` | Tavily Web Search | ✅ active | Nature liver-spheroid Acetaminophen dose-response (ClinoReactor-style competition: MO:BOT), 3Brain-style EEG validation, Cellink BI0X ecosystem news |
| `obsidian-robin-1` | git-repo (Obsidian vault) | ✅ active | Vault HEAD = `62877d1f` (2026-07-22), includes 6 new commits covering CellShot-TriArm demo v1/v2 + CelVivo ClinoReactor 销售弹药 精读 |

`commitments.md` 和 `open-questions.md` 是 wiki 默认模板；目前空着（"No active ... yet"），等 Robin 真实工作里的承诺 / 盲区被识别后再写。

## 二、3 个 connector **为什么没开**(按你的工作按优先级排)

| 优先级 | connector | 是否现在加 | 怎么加 |
|---|---|---|---|
| 高 | **Gmail** | **建议加** (你处理客户邮件 + 9X Bio 中间商通信) | `openwiki auth google` 跑 OAuth flow (会弹出 Google 登录页) |
| 低 | X / Twitter | 可加可不加 (现在没有规律跟踪的账号) | `openwiki auth x` |
| 不加 | Slack | 你没 Slack 工作空间,跳过 |
| 不加 | Notion | 你不用 Notion,跳过 |

**最推荐加 Gmail**——理由: 你每天的客户邮件 → AI 邮件 → RFP → demo 反馈, 都在 Gmail 里,加完 connector 后 wiki 自动:
- 提"CelVivo 客户问 X 功能" 出现在 commitments.md
- 把"9X Bio 转了一封 RFP" 作为 fresh signal 写到 themes

加 Gmail = 1 个 OAuth 流程,大概 5 分钟。我可以现在帮你跑(你说"加上",我就 `openwiki auth google`)。

## 三、Daily 操作 (你**什么都不用做**, 但要明白)

两套 cron 在 02:00-02:30 之间各跑一次:

```
0  2 * * * /home/ldw/.local/bin/openwiki-update.sh         # HN + Tavily + git-repo + agent update
30 2 * * * /home/ldw/.local/bin/openwiki-update-sources.sh # 4 个子系统 (RAGFlow/NocoDB/SeaFile/Wiki.js) 计数刷新
```

**02:00 update.sh 顺序**:
1. `ingest hackernews` → 拉 Robin-curated life-sciences + AI workflow queries
2. `ingest web-search` → 拉 10 个 Tavily queries 关于 4 vendor + organ-on-chip + 工作栈
3. `ingest git-repo` → 拉 Obsidian vault manifest
4. `personal --update --print` → M3 agent 读 raw data + INSTRUCTIONS.md + 当前 wiki → 决定哪些 page 要改
5. `git commit + push` → 推到 Gitea public: `http://10.10.10.254:3080/Robin/openwiki-wiki`

**02:30 update-sources.sh 顺序**:
1. `NocoDB` → 13 个文献库 × record count → 写 `sources/nocodb.md`
2. `SeaFile` → 6 个 Repo × size + file count → 写 `sources/seafile.md`
3. `Wiki.js` → GraphQL `pages.list(limit:100)` + zh/literature HTML probe → 写 `sources/wikijs.md`
4. `RAGFlow` → /api/v1/datasets 健康检查 → 写 `sources/ragflow.md`
5. `git commit + push` → 推到 Gitea

**现在打开 Gitea (`http://10.10.10.254:3080/Robin/openwiki-wiki`) 你能看到**:
- `themes.md` — 4 行 (Robin 工作主题)
- `sources/hackernews.md` — HN evidence index
- `sources/web-search.md` — Tavily evidence index (Nature liver-spheroid 已落)
- `sources/git-repo.md` — Obsidian vault manifest
- `sources/nocodb.md` — 13 个库计数 (共 6604 records)
- `sources/seafile.md` — 6 个 Repo (77 GB total)
- `sources/wikijs.md` — 47 pages (zh) + 分布
- `sources/ragflow.md` — RAGFlow 可用性状态
- `sources/literature.md` — 精读笔记索引

## 四、你**手工**要做的 (什么时候 + 怎么)

| 触发 | 操作 |
|---|---|
| 你看到 wiki 跑出噪音主题 (跟工作无关的) | 编辑 `~/.openwiki/wiki/themes.md` 删行 + `--print` manual commit (10 min) |
| 想加 Gmail 等新 connector | 跟我说 "加 Gmail connector", 我跑 `openwiki auth google` |
| 想换 wiki template (ex: from Personal → AI Research Radar) | 跟我说 "换 AI Research Radar 模板" |
| 改业务方向 (ex: 加新 vendor) | 编辑 `~/.openwiki/INSTRUCTIONS.md` 把新 vendor 加进 "Vendor-anchored signal" 段 |
| 某天 wiki 跑出来空 (raw 没东西) | 看 `~/.openwiki/logs/cron-2026MMDD.log`,FATL 段通常写节点路径 |

## 五、你**绝对别动**的部分

- **`~/.openwiki/wiki/INSTRUCTIONS.md`** (在仓库里): OpenWiki 自己不会生成这个,但 wiki 会作为事实"读"它。如果它变长或变短,需要重新理解 Robin 的 scope
- **`~/.openwiki/wiki/_plan.md`**: 这个文件**已经在 .gitignore**了,会作为 agent scratch file 由 wiki engine 自己管理,你别管
- **`.last-update.json`**: OpenWiki 自动维护 lastRunAt 状态文件

## 六、跨工具 cheat sheet (你有问题该看哪个 wiki / KB / 库)

| 你想做的事 | 打开 |
|---|---|
| 找 CelVivo / 3Brain / Cellink / Femtobiomed 内部资料 (产品 PDF / sales 文档) | SeaFile + Wiki.js (类器官 topic page) |
| 看出版商学术论文 + CelVivo ClinoReactor 数据 | RAGFlow KB (海亚/Genmab/Takeda 任一 vendor KB) |
| 看 TESS 公开学术文献 (无 vendor 角度, 全行业) | OpenWiki `sources/literature.md` |
| 看社区生命科学新闻 / Nature 论文 / CelVivo press | OpenWiki `sources/web-search.md` + `sources/hackernews.md` |
| 看你最近的 demo 计划 / 客户会议记录 / 销售弹药 | Obsidian vault (`/mnt/c/Users/20864/.openclaw/workspace/`) + OpenWiki `sources/git-repo.md` |
| 看主题层面 Robin 关注的趋势 (12→4 行 topics) | OpenWiki `themes.md` |
| 看每个子系统当前规模 (KB count / Repo size / page count) | OpenWiki `sources/{nocodb,seafile,wikijs,ragflow}.md` |

## 六点五、跨工具"真实联系"现在的状态 (2026-07-27)

| 系统 | 跟 OpenWiki 的接法 | 接法性质 | 频率 |
|---|---|---|---|
| **Obsidian vault** | OpenWiki 内置 git-repo connector | **自动** | 每晚 02:00 |
| **Hacker News** | OpenWiki 内置 hackernews connector | **自动** | 每晚 02:00 |
| **Tavily web search** | OpenWiki 内置 web-search connector | **自动** | 每晚 02:00 |
| **Gmail** | OpenWiki `auth google` 还没接 | **不接** (你说"加"我加) | — |
| **NocoDB** | `~/.local/bin/openwiki-update-sources.sh` (自写脚本, 走 xc-token / v2 API) | **自动** | 每晚 02:30 |
| **SeaFile** | `update-sources.sh` (自写脚本, 走 /api2/) | **自动** | 每晚 02:30 |
| **Wiki.js** | `update-sources.sh` (自写脚本, 走 GraphQL) | **自动** | 每晚 02:30 |
| **RAGFlow KB** | `update-sources.sh` 跑健康检查 (counts 因为 retrieval 服务挂所以不刷) | **自动 (受限)** | 每晚 02:30 |

**架构定位**: OpenWiki 不是"中心化 orchestrator"，它是**"5 个数据源 + 4 个子系统计数"的联邦索引**：
- 事件流 (HN / Tavily / Gmail / git-repo) → OpenWiki 自带 connector 直接 ingest
- 状态快照 (NocoDB / SeaFile / Wiki.js / RAGFlow) → 自写 update-sources.sh 拉计数 + 直接 commit

## 七、v.s. 此前 (7/26) — 今天改了什么

| 改动 | 之前 | 现在 |
|---|---|---|
| wiki 状态 | 7/17-7/24 跨 8 天 0 commit (cron PATH 错) | 7/27 4 commits, web-search + theme 重建 |
| connector 数 | 2 (HN + git-repo) | **3 (+ Tavily web-search)** |
| onboarding | 半完成, 只填了 source instances | **完整**: completedAt + modeId + templateId + ingestionSchedule |
| 主题噪音 | 12 行, 8 行跟 Robin 工作无关 | **4 行, 全部贴合 Robin** |
| INSTRUCTIONS.md | 无 | **7613 bytes, 限定 CelVivo/3Brain/Cellink/Femtobiomed 业务** |
| cron PATH | cron 找不到 node, 8 天 0 产物 | **PATH fix + TAVILY key auto-load, 自检 log** |
| personal --update | TTY 长时间不退出 | **--print 模式一次性退出 (cron/cron-friendly)** |

## 八、Robin 你的下一步 (3 个选项, 1-2 个就行)

**选项 A: 加上 Gmail connector (5 min)**
最推荐. 理由: 客户邮件 + 9X Bio 中间商通信能即时变 wiki signal.

**选项 B: 看一次今天的真实产出 (5 min)**
打开 `http://10.10.10.254:3080/Robin/openwiki-wiki` 看 themes.md / sources/web-search.md / sources/hackernews.md 最新版本.

**选项 C: 写 wiki 工作总结贡献 (10 min)**
把 wiki 拉到本地, 删除噪音行, 提"哪类主题 Robin 期望", submit PR (开源精神).

我建议 **A → B 顺序**, 5 + 5 = 10 min, 但你决定.