🗄️ devbase

开发者工作空间的世界模型编译器

一套引擎，统一代码上下文、知识记忆与智能体推理。

---

📋 简介

devbase 将代码库、笔记与工作流编译为 AI 可推理的结构化情境 — 不是存储数据，是构建环境的心智模型。

你是谁	devbase 为你做什么
人类开发者	devbase tui — 终端仪表盘，一眼看清 N 个仓库的 Git 状态，按 s 批量安全同步
AI 智能体	69 个 MCP 工具：通过 devkit_skill_run 发现、执行、编排 Skill — 不再重复造轮子
项目维护者	devbase skill discover . — 一键将项目封装为 Skill，让 AI 用户能够发现和调用

---

🌟 核心亮点

亮点	说明
📊 TUI 仪表盘	ratatui 终端界面：跨仓库搜索、安全同步、Skill/Workflow 发现
🔌 69 个 MCP 工具	stdio 本地进程通信：仓库管理、代码分析、知识图谱、智能体记忆
🏠 本地优先	零数据离开本机 — SQLite + Tantivy + tree-sitter，无需云端
🔍 混合检索	BM25 全文 + 纯 SQL 向量搜索（cosine_similarity UDF），零 ML 运行时依赖

完整 69 个 Tool 矩阵 → docs/guides/mcp-integration.md

---

🔧 技术栈

组件	技术
终端 UI	ratatui
全文检索	Tantivy (BM25)
语义检索	SQLite BLOB + cosine_similarity UDF
代码解析	tree-sitter (Rust/Python/TS/Go)
关系存储	SQLite (WAL 模式, OpLog 审计)
协议	Model Context Protocol (stdio)

---

📁 项目结构

devbase/
├── src/
│   ├── main.rs          # CLI 入口：命令解析与分发
│   ├── tui/             # 终端仪表盘（ratatui）
│   │                    # 多仓库导航、跨仓库搜索、安全同步预览
│   ├── mcp/             # MCP Server（69 个工具，stdio 通信）
│   │                    # 人类与 AI 的统一接口层
│   ├── registry/        # 仓库注册表：Git 状态、健康检查、批量同步
│   ├── index/           # Tantivy 全文索引 + SQLite 向量索引
│   │                    # 混合检索核心，BM25 + cosine 向量评分
│   ├── vault/           # PARA 笔记系统：双向链接、BFS 图遍历
│   ├── skill/           # Skill 生命周期：发现 → 安装 → 执行 → 评分 → 发布
│   │                    # 自动封装项目为 AI 可调用的 Skill
│   ├── workflow/        # YAML 编排引擎：5 种 step 类型，拓扑调度 + 并行执行
│   └── session/         # 智能体会话生命周期 + 向量记忆持久化
├── docs/
│   ├── architecture/    # 架构文档总览
│   └── guides/          # 集成指南（Claude Code / 5ire / Kimi CLI）
├── scripts/
│   ├── install.ps1      # Windows 一键安装
│   ├── install.sh       # Linux/macOS 一键安装
│   └── devbase-claude.ps1 # Claude Code 一键启动器
└── README.md

核心设计

三层架构：

1. 交互层 — TUI 仪表盘 + MCP Server + Workflow 引擎（人类与 AI 的接口）
2. 编译层 — 感知（tree-sitter/Tantivy/Git）→ 知识（图谱/向量/关系）→ 策略（同步/工作流/健康守卫）
3. 可靠层 — SQLite WAL 并发安全 + 索引健康检测 + OpLog 全操作审计

可靠性红线：所有 Registry 写入必须留下不可变审计痕迹（OpLog）；Schema 迁移前自动生成快照。详见 docs/architecture/overview.md。

---

🚀 快速开始

# Windows 一行安装
irm https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.ps1 | iex

# 或下载预编译二进制（~8.7 MB）
# https://github.com/juice094/devbase/releases/tag/v0.20.1

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.sh | bash

# 基础工作流
devbase scan . --register   # 1. 扫描并注册工作区
devbase tui                # 2. 打开仪表盘
devbase mcp                # 3. 启动 MCP 服务端（供 AI 调用）

AI 助手配置 — 添加到 claude_desktop_config.json 或 ~/.kimi/mcp.json：

{ "mcpServers": { "devbase": { "command": "devbase", "args": ["mcp"] } } }

---

🤝 参与贡献

详见 CONTRIBUTING.md — 添加 MCP 工具、Skill Schema、构建模式说明。快速验证：

cargo build --release
cargo test --all-targets
cargo clippy --all-targets -D warnings

---

📄 许可证

双许可证：AGPL-3.0+ 开源 / 商业授权 闭源使用。联系：juice094@protonmail.com。

---

⭐ Star · 🐛 Issues · 🤝 Contribute