OpenCortex

Open Knowledge for Your Cortex - 开放的团队大脑

AI-native 团队知识中枢 - 自动从 Linear、GitHub、飞书中捕获、结构化和维护团队知识

---

📖 项目简介

OpenCortex 是一个面向 10-50 人小型技术团队的知识管理系统，核心价值是 "AI 写，人审核"：

• ✅ 自动收集：从 Linear、GitHub 自动拉取数据
• ✅ AI 提取：使用 LLM 提取决策、技术方案、调研发现
• ✅ 零配置：接入数据源后自动工作，无需手动建知识库
• ✅ 即时查询：支持自然语言搜索

---

🚀 快速开始

1. 环境准备

# 克隆项目
git clone https://github.com/your-username/opencortex.git
cd opencortex

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

2. 配置环境变量

# 复制示例配置
cp .env.example .env

# 编辑 .env 文件，填入你的 API Keys
# LINEAR_API_KEY=your_key_here
# GITHUB_TOKEN=your_token_here
# OPENAI_API_KEY=your_key_here

3. 初始化数据库

python scripts/init_db.py

4. 运行测试

python scripts/linear_connector.py
python scripts/github_connector.py
python scripts/llm_extractor.py

---

📚 文档

• 01-快速入门 - 项目简介和核心概念
• 02-技术架构 - 系统架构和技术选型
• 03-Linear接入方案 - Linear API 接入指南
• 04-GitHub接入方案 - GitHub API 接入指南
• 05-LLM提取方案 - 知识提取 Prompt 设计
• 06-数据库设计 - 数据库结构说明
• 07-实施计划 - 详细开发计划

---

🏗️ 项目结构

OpenCortex/
├── docs/                   # 技术文档
│   ├── README.md          # 文档导航
│   ├── 01-快速入门.md
│   ├── 02-技术架构.md
│   ├── 03-Linear接入方案.md
│   ├── 04-GitHub接入方案.md
│   ├── 05-LLM提取方案.md
│   ├── 06-数据库设计.md
│   └── 07-实施计划.md
├── scripts/               # 脚本文件
│   ├── init_db.py        # 初始化数据库
│   ├── linear_connector.py
│   ├── github_connector.py
│   ├── llm_extractor.py
│   └── database.py
├── data/                  # 数据文件（不提交到 Git）
├── tests/                 # 测试文件
├── MEMORY.md             # 项目记忆
├── CONSTITUTION.md       # 项目宪法
├── key.md                # 敏感信息（不提交到 Git）
├── requirements.txt      # Python 依赖
└── README.md             # 本文件

---

🎯 开发阶段

阶段	目标	状态
Phase 0	静默收集	✅ 已完成
Phase 1	查询界面	⏳ 待开始
Phase 2	主动推送	⏳ 待开始
Phase 3	产品化	⏳ 待开始

---

🤝 贡献指南

1. 开始开发前，阅读 MEMORY.md 了解项目历史
2. 阅读 CONSTITUTION.md 了解开发规范
3. 完成开发后，更新 MEMORY.md 记录变更
4. 提交 PR 前确保通过测试

---

📞 联系方式

项目负责人: 晓力
问题反馈: [待补充]

---

📄 许可证

[待定]

---

最后更新: 2026-03-10
版本: v0.2.0