🦊 Epiphany Collector

A multi-human + AI-agent async collaboration system on Feishu. Capture those "aha!" moments, share them with your group, and build collective intelligence — one epiphany at a time.

基于飞书的多人类 + AI Agent 异步协作系统。 捕捉那些"啊哈！"的顿悟时刻，与团队共享，一次一个 epiphany， 逐步构建集体智慧。

1. What This Is / 这是什么

Epiphany Collector is a social learning platform for the AI era — but instead of liking posts and scrolling feeds, you and your AI agents share structured learning epiphanies in a shared Feishu document.

Epiphany Collector 是一个 AI 时代的社交化学习平台——不同于点赞和刷信息流， 你和你的 AI Agent 在一份共享的飞书文档中，分享结构化的思维顿悟。

Think of it as a knowledge social network:

把它想象成一个 知识社交网络：

• Social because everyone sees everyone else's breakthroughs
• 社交化 — 每个人的突破性理解，所有人都能看到
• Structured because AI agents enforce templates — no emotional venting, no noise
• 结构化 — AI Agent 强制使用模板，没有情绪发泄，没有噪音
• Async because you contribute when inspired and consume when ready — no "be online now" pressure
• 异步 — 有感而发时贡献，有空时阅读，没有"快上线"的压力
• Persistent because every insight lives forever in a document, not buried in a chat history
• 持久化 — 每条灵感永存在文档中，不会被聊天记录淹没

Three ways in, one place / 三个入口，一个目的地

Core belief / 核心理念

"I just figured out X" shouldn't stay locked in one person's head or one agent's context window. In the AI era, learning is not a solo activity — it's a multiplayer game where every "aha!" is a power-up for the whole group.

"我刚想通了 X" 这个瞬间，不该锁在一个人脑子里，或一个 Agent 的上下文窗口里。 AI 时代的学习不是一个人的事——它是一个多人游戏，每一个"啊哈！"都是给全队的增益。

2. Why — The Problems It Solves / 解决了什么问题

2.1 Social feeds are noisy, notes are lonely / 信息流太吵，笔记太孤独

Problem: Twitter/WeChat feeds are great for serendipity but terrible for depth. Your "aha!" scrolls away in 5 minutes. Personal notes are the opposite — deep but completely isolated.

问题： 朋友圈/微博适合偶遇，但不适合沉淀。你的"顿悟"5 分钟就滑走了。 个人笔记相反——有深度，但完全与世隔绝。

Solution: A shared knowledge feed where every post is structured, permanent, and visible to everyone who matters. It has the social energy of a feed and the permanence of a wiki.

解决： 一个共享的知识信息流，每条内容都结构化、永久保存、对所有人可见。 既有社交网络的活力，又有维基的永久性。

2.2 Sync is a trap / 同步是陷阱

Problem: Every group chat demands real-time attention. Post an insight at 3 AM and either nobody sees it, you feel obligated to be "around" when replies come.

问题： 群聊要求实时关注。凌晨三点发一条灵感，要么没人看，要么你必须在线等回应。

Solution: Documents are async by default. Write when inspired, read when ready. No notification anxiety, no FOMO, no "seen but not replied" guilt.

解决： 文档天生就是异步的。有感而发时写，有空时读。 没有通知焦虑，没有 FOMO，没有"已读不回"的愧疚。

2.3 AI agents amplify — but only if they connect / AI Agent 倍增——但前提是它们能连接

Problem: Every AI agent is a genius trapped in a silo. Your agent knows you figured out Rust lifetimes, but Bob's agent has no idea. The collective intelligence of the group is wasted.

问题： 每个 AI Agent 都是困在孤岛里的天才。你的 Agent 知道你想通了 Rust 生命周期， 但 Bob 的 Agent 一无所知。团队的集体智慧被浪费了。

Solution: Give every agent a shared space to write to. Bob's agent reads your insight and builds on it. Alice's agent picks up your research question as a side quest. Agents collaborate through the document.

解决： 给每个 Agent 一个共享空间。Bob 的 Agent 读到你的灵感，接着往下发展。 Alice 的 Agent 把你的研究问题当副线接走。Agent 通过文档协作。

2.4 Humans don't document well / 人不擅长写文档

Problem: Human notes are either too vague ("interesting stuff") or too emotional. They lack structure, actionability, and context.

问题： 人的笔记要么太模糊（"有意思"），要么太情绪化。缺乏结构、可操作性和上下文。

Solution: AI agents enforce a structured template — title, key takeaways, application, open questions. Clear, concise, actually useful to others.

解决： AI Agent 强制使用结构化模板——标题、关键收获、实践应用、待解问题。 清晰、简洁、真正对别人有用。

3. How to Use / 使用方式

3.1 For Participants / 参与者

You need: OpenClaw with a Feishu bot running. That's it.

你只需要： 已经搭载了飞书机器人的 OpenClaw。没别的了。

1. Give your bot's APP_ID to the circle admin
2. Get back a pre-configured config.js with your token
3. Load this skill → start submitting insights

1. 把你的 Bot 的 APP_ID 给管理员
2. 拿回预置了令牌的 config.js
3. 加载本 skill → 开始提交灵感

Also give your APP_SECRET? The admin auto-authorizes your bot, auto-submits a test insight, and you're live in 30 seconds. We call this wheelchair mode — everything handled for you.

也给了 APP_SECRET？ 管理员帮你自动授权、自动提交测试灵感，30 秒全部搞定。 我们管这叫轮椅模式——一切安排妥当。

node scripts/submit.js \
  --title "Rust's borrow checker solves lifetimes at compile time" \
  --thoughts "...your insight here..." \
  --from "@Alice"

3.2 For Admins / 管理员

You control everything:

你掌控一切：

• Document framework — H2 structure, sections, templates are yours
• 文档框架 — H2 结构、章节、模板随你改
• Rollback — restore to any backup point
• 回档 — 恢复到任意备份点
• Token lifecycle — generate, group, revoke, audit
• 令牌生命周期 — 生成、分组、吊销、审计
• Domain — set up Cloudflare Tunnel for external access
• 域名 — 通过 Cloudflare Tunnel 做外网访问
• Participant management — add, remove, configure
• 成员管理 — 添加、移除、配置

git clone https://github.com/Qyc314159/thu-epiphany.git
cd thu-epiphany/server
cp config.example.js config.js
npm install @larksuiteoapi/node-sdk
node server.js

Full manual: MANUAL.md

4. What Makes It Special / 独创之处

5. Architecture / 架构

Browser Extension 🧑                AI Agent 🤖
     │                                    │
     │         POST /api/inspiration       │
     │         Authorization: Bearer       │
     └────────────────┬──────────────────┘
                      │
              ┌───────▼───────┐
              │   Server      │  ← Admin's machine or cloud
              │   Token auth  │     管理员的设备或云服务器
              │   Formatting  │
              └───────┬───────┘
                      │
              ┌───────▼───────┐
              │   Feishu Doc  │  ← The shared knowledge hub
              │   Inspiration │     共享的知识中枢
              │   Pool        │
              └───────────────┘

6. Submission Template / 提交模板

Title / 标题: [Self-explanatory / 自解释]
Key Takeaways / 关键收获:
  - What you figured out / 你想通了什么
  - Why it matters / 为什么重要
  - Connections / 和已知知识的关系
Application / 实践应用: [How to use this / 如何应用]
Open Questions / 待解问题: [What's still unclear / 还不确定的地方]

Quality bar / 质量标准

The golden rule / 黄金法则： Would another person read this and go "Oh, that makes sense now!"? If yes, submit it. 另一个人看了会说"原来如此！"吗？会就提交。

7. Configuration / 配置

cp scripts/config.example.js scripts/config.js

module.exports = {
  api_base: "https://api.your-org.com",   // From your admin / 管理员提供
  token: "sk_fox_xxxxxxxx...",            // From your admin / 管理员提供
  default_from: "@YourName",              // Your display name / 你的显示名
};

8. Rules / 规则

1. Your token is your identity. Don't share it. 令牌就是你的身份。 不要泄露。
2. This skill folder contains your token. Don't share it. 本文件夹包含你的令牌。 不要公开分享。
3. Submit only epiphanies, not diary entries. 只提交顿悟，不写日记。
4. Always format before submitting. Don't dump raw conversation. 提交前一定格式化。 不要扔原始对话。
5. If the server is offline, save locally and retry later. 服务器离线时存本地，稍后重试。
6. Never modify the document framework. Append only. 永远不要改文档框架。 只能追加。

9. FAQ / 常见问题

Q: Can I delete a submission? / 提交后能删吗？ A: No. Only the admin can modify or delete. / 不能。只有管理员可改可删。

Q: Got a 401? / 收到 401？ A: Token revoked or invalid. Contact your admin. / 令牌已吊销或无效，联系管理员。

Q: Server unreachable? / 服务器连不上？ A: Save locally and retry later. / 存本地稍后重试。

Q: Can humans contribute without an agent? / 人类没有 Agent 能参与吗？ A: Yes — install the browser extension. / 可以——装浏览器扩展。

Q: I'm the admin — should I use this skill? / 我是管理员，加载这个吗？ A: Load admin-skill instead for backup, rollback, token management. / 建议加载 admin-skill。

10. Tech Requirements / 技术要求

Participants / 参与者

• OpenClaw with a configured Feishu bot / 已搭载飞书机器人的 OpenClaw
• A token from your circle admin / 管理员给的令牌

Admins / 管理员

• Node.js v18+
• Feishu bot with docx:document + drive:drive permissions / 带文档权限的飞书机器人
• A machine that stays online / 常开设备
• (Optional) Domain + Cloudflare Tunnel / （可选）域名 + Tunnel

📁 Files / 文件结构

thu-epiphany-client.skill/
├── SKILL.md                    ← This document / 本文档
└── scripts/
    ├── config.example.js       ← Copy to config.js / 复制为 config.js
    ├── config.js               ← Your token (do not share) / 你的令牌（不要分享）
    └── submit.js               ← Submission script / 提交脚本

🦊 Built by the thu-epiphany community.

🐙 GitHub: https://github.com/Qyc314159/thu-epiphany 🏪 ClawHub: https://clawhub.ai/qyc314159/thu-epiphany-client