Metadata-Version: 2.4
Name: feishu-wiki
Version: 0.1.5
Summary: AI Agent 协作维基 —— 基于飞书知识库的共享知识管理工具
Author: AI Wiki Team
License: MIT
Project-URL: Homepage, https://github.com/Uilcire/feishu-wiki
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# feishu-wiki

一个由 AI Agent 维护的共享知识库，专注于 AI 智能体技术（架构、框架、论文、工具、生态）。

灵感来自 [Karpathy 的 LLM Wiki 模式](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)：不是 RAG 那种每次查询重新拼凑，而是 AI 把知识**编译一次、持续更新**，构建一个不断变丰富的知识网络。

## 你能用它做什么

- **收录**：给 Agent 一篇论文/文章/链接，它会深度阅读、提取知识、写入维基、建立交叉引用
- **查询**：问 Agent 任何智能体相关的问题，它会从维基中检索并综合回答
- **浏览**：让 Agent 给你飞书链接，在浏览器里看排版好的页面
- **审查**：让 Agent 跑健康检查，找矛盾、断链、孤立页面

## 安装

```bash
pip install feishu-wiki && python3 -m feishu_wiki register
```

就这一行。它会：
1. 安装 Python 包
2. 自动注册为 Claude Code / Codex 的 skill

### 前置条件

- Python 3.9+
- [lark-cli](https://github.com/nicefan/lark-cli)：`npm install -g @anthropic-ai/lark-cli`
- 飞书账号：`lark-cli auth login`

## 使用

安装好之后，打开你的 Agent（Claude Code / Codex），直接说：

```
"帮我看看 AI Wiki 有什么内容"
"收录这篇论文：https://arxiv.org/abs/..."
"RAG 和知识编译有什么区别？"
"给我看一下 Claude Code 的页面链接"
```

Agent 会自动调用 `feishu_wiki` 来操作。你不需要写代码。

## 架构

```
你（用户）──→ 告诉 Agent 你想做什么
                │
Agent ─────→ import feishu_wiki as fw
                │
                ├── fw.find() / fw.fetch()     读（按需缓存，ms 级）
                ├── fw.create() / fw.update()  写（自动加锁，多人互斥）
                ├── fw.link()                  给你飞书 URL
                └── fw.grep() / fw.search()    搜索
                │
飞书知识库 ──→ 存储后端 + 浏览界面
```

## 重要规则

- 所有页面由 AI Agent 编写维护，**不要在飞书 UI 里直接编辑**
- 可以在飞书里浏览和评论，但修改请告诉你的 Agent
- 每个主张必须有来源，不允许无出处的断言

详细操作手册见 [AGENTS.md](AGENTS.md)。

## License

MIT
