obs-code

没有 obs-code vs 有 obs-code

核心能力矩阵

工作流对比

┌─────────────────────────────────────────────────────────────────┐
│ 传统 AI 改代码流程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 需求 ──→ 读全仓库 ──→ 上下文爆 ──→ 瞎猜 ──→ 改漏 ──→ 💥 │
│ │
│ 耗时:30min+ │ 正确率:40-60% │ 遗漏率:高 │
│ │
└─────────────────────────────────────────────────────────────────┘
 ⬇️ obs-code ⬇️
┌─────────────────────────────────────────────────────────────────┐
│ obs-code 增强流程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 需求 ──→ obs_plan ──→ 精准文件清单 ──→ AI 只读相关文件 ──→ ✅ │
│ │ │
│ ├─→ obs_impact ──→ 调用链 ──→ 知道牵连 ──→ ✅ │
│ │ │
│ └─→ obs_feature_map ──→ 阅读链路 ──→ 不遗漏 ──→ ✅ │
│ │
│ 耗时:2min │ 正确率:85-95% │ 遗漏率:极低 │
│ │
└─────────────────────────────────────────────────────────────────┘

性能基准

LLM Wiki — 30 秒看懂任何项目

.obs-code/wiki/
├── AGENTS.md ─→ AI 工具读这个:什么时候用哪个工具
├── project.md ─→ 项目概览:语言、规模、关键文件
├── architecture.md ─→ 架构:分层、模式、入口点
├── connections.md ─→ 连接:Hub / Bridge / 主调用链
└── manifest.json ─→ 元数据:索引时间、统计

## Hubs(高扇入 — 改这里影响最大)
 exec ← 被 30 处调用(SQL 执行核心)
 parse ← 被 20 处调用(解析核心)
 searchByName ← 被 11 处调用
## Bridges(跨层调用 — 集成测试重点)
 feature-map → store 88 calls
 graph-sync → store 12 calls
## Main Paths(主调用链 — 理解核心逻辑)
 buildFeatureMap → readCandidates → getById → rowToNode

索引可信度证据

{
 "filesScanned": 149,
 "bytesScanned": 1064907,
 "skippedDirectories": [
 { "path": "node_modules", "reason": "default_exclude" },
 { "path": "datasets/feature-map-benchmark/real-projects", "reason": "default_exclude" }
 ]
}

核心架构

┌─────────────────────────────────────────────────────────────────┐
│ AI 工具层 │
│ Claude Code · Cursor · Codex · OpenCode │
│ ↕ MCP 协议 (stdio/SSE) │
├─────────────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│ │obs_find │ │obs_impact│ │obs_plan │ │obs_feature_map │ │
│ │符号搜索 │ │影响分析 │ │需求→计划 │ │功能→阅读链路 │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────────┬─────────┘ │
│ └─────────────┴───────────┴─────────────────┘ │
│ │ 多策略搜索链 │
│ 精确 → 模糊 → FTS5全文 → 中文同义词 → 多维组合 │
├─────────────────────────────────┬───────────────────────────────┤
│ 图谱引擎 │ │
│ ┌────────────┐ ┌────────────┐ │ ┌──────────────┐ │
│ │ 节点查询 │ │ 边遍历 │ │ │ 影响传播引擎 │ │
│ │ getById │ │ getBySource│ │ │ BFS+规则驱动 │ │
│ │ searchBy │ │ getByTarget│ │ │ AI 剪枝 │ │
│ └────────────┘ └────────────┘ │ └──────────────┘ │
├─────────────────────────────────┼───────────────────────────────┤
│ SQLite (WAL + FTS5) │ │
│ nodes · edges · nodes_fts · file_hashes │
├─────────────────────────────────────────────────────────────────┤
│ 解析层 │
│ Tree-sitter (Go/Rust/Java/C++) · 增强正则 (TS/JS/Python) │
│ 文件监听 (chokidar) · 增量重解析 │
├─────────────────────────────────────────────────────────────────┤
│ 代码仓库 — 14 种语言 │
│ TS · JS · Python · Go · Rust · Java · Swift · Kotlin │
│ PHP · Ruby · C# · Dart · C/C++ · Lua │
└─────────────────────────────────────────────────────────────────┘

竞品对比

安装

curl -fsSL https://raw.githubusercontent.com/xiaoletian64/obs-code/main/install.sh | bash

obs install --tool claude # Claude Code
obs install --tool codex # OpenAI Codex
obs install --tool cursor # Cursor
obs install --tool opencode # OpenCode
obs install --tool micode # MiMo Code
obs install --tool all # 全部

3 步上手

# 1. 索引
obs index /你的项目路径
# 2. 启动 MCP 服务
obs serve --mcp
# 3. 在 AI 工具里直接说
请用obs分析 用户登录流程

工具矩阵

Web 可视化

obs web /你的项目路径
# http://localhost:3456

支持的语言