Metadata-Version: 2.4
Name: obsidian-dev-memory
Version: 1.0.0
Summary: 三层知识架构 MCP Server — 规范手册 + 知识网络 + 原始资料，越用越智能的开发知识库
Project-URL: Homepage, https://github.com/Frankly666/dev-memory
Project-URL: Repository, https://github.com/Frankly666/dev-memory
Project-URL: Issues, https://github.com/Frankly666/dev-memory/issues
Author: franklynxu
License-Expression: MIT
License-File: LICENSE
Keywords: ai,developer-tools,knowledge-base,mcp,obsidian,semantic-search
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: chromadb>=0.4.22
Requires-Dist: click>=8.1.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: python-frontmatter>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31.0
Requires-Dist: sentence-transformers>=2.2.2
Provides-Extra: dev
Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: requests-mock>=1.11.0; extra == 'dev'
Description-Content-Type: text/markdown

# Dev Memory — 本地开发知识复利 MCP Server

> 让 AI 记住你的每一次经验。解决问题后一句话存储，下次遇到类似问题时 AI 自动检索。越用越聪明，实现知识复利。

[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

## 一键接入（30 秒）

### 方式一：uvx 零安装（推荐）

不需要预装任何东西，直接在 AI IDE 配置中使用：

**Claude Code:**
```bash
claude mcp add dev-memory -- uvx dev-memory-mcp
```

**Cursor** — 编辑 `~/.cursor/mcp.json`：
```json
{
  "mcpServers": {
    "dev-memory": {
      "command": "uvx",
      "args": ["dev-memory-mcp"]
    }
  }
}
```

### 方式二：pipx 全局安装

```bash
pipx install dev-memory
```

然后配置 AI IDE：
```json
{
  "mcpServers": {
    "dev-memory": {
      "command": "dev-memory-mcp"
    }
  }
}
```

### 方式三：pip 安装

```bash
pip install dev-memory
```

### 方式四：一键脚本（自动检测 + 自动配置 IDE）

```bash
curl -fsSL https://raw.githubusercontent.com/Frankly666/dev-memory/main/install.sh | bash
```

脚本会自动检测环境、安装工具、配置 AI IDE。

### 方式五：从源码安装

```bash
git clone https://github.com/franklynxu/dev-memory.git
cd dev-memory
pip install -e .
```

---

## 支持的 AI IDE

| IDE | 配置方式 |
|-----|---------|
| **Claude Code** | `claude mcp add dev-memory -- uvx dev-memory-mcp` |
| **Cursor** | `~/.cursor/mcp.json` |
| **CodeBuddy** | MCP 设置面板 |
| **Windsurf** | MCP 设置面板 |
| 其他 MCP 客户端 | stdio 协议通用接入 |

> 详细配置步骤见 [MCP_SETUP.md](./MCP_SETUP.md)

---

## 提供的 MCP Tools

### v2 新增（推荐使用）

| 工具 | 功能 | 说明 |
|------|------|------|
| `ingest_knowledge` | 智能存储知识 | 搜索→判重→决策（新建/更新/合并）→维护关联 |
| `store_reference` | 存储原始资料 | 严格保留原文，AI 注解与原文分区 |
| `get_rules` | 获取工作规范 | 加载 RULES.md + taxonomy.yaml |
| `update_rules` | 更新工作规范 | 用户和 AI 共同维护规范 |
| `update_knowledge` | 更新知识条目 | 追加方案、调整成熟度/置信度 |
| `get_hub` | 获取主题聚合页 | 查看某主题下的知识导航 |
| `evolve_knowledge` | 触发知识演化 | 归纳 concept、更新 hub |

### 保留的 v1 Tools

| 工具 | 功能 | 说明 |
|------|------|------|
| `memorize` | 记忆开发经验 | 内部已升级为智能判重（兼容 v1） |
| `search_knowledge` | 语义搜索知识库 | 增强：返回关联上下文 |
| `list_tags` | 列出知识标签 | 标签分布和频次 |
| `get_profile` | 开发者画像 | 技术偏好分析 |
| `sync_vault` | 同步索引 | 增量/全量同步 |
| `get_stats` | 知识库统计 | 含原始资料和规范状态 |

---

## 使用示例

安装后，直接在 AI IDE 中自然语言对话：

```
你: 帮我记住刚才解决的 Docker DNS 问题
AI: ✅ 已记忆「Docker 容器 DNS 解析失败」，标签: docker, dns, 网络

你: 之前有遇到过 K8s Pod 重启的问题吗？
AI: 找到 3 条相关经验：
    1. K8s Pod CrashLoopBackOff 排查 (相关度: 0.89)
    2. 容器 OOMKilled 内存泄漏排查 (相关度: 0.76)
    ...

你: 分析一下我的开发风格
AI: 你主要关注后端基础设施，技术栈以 Go + Docker + K8s 为主...
```

---

## 前置要求

1. **Python 3.10+**
2. **Obsidian**（桌面端，用于存储知识）
3. **Obsidian Local REST API 插件**（可选，提供更好的搜索体验）

## 首次初始化

```bash
# 初始化知识库（指定你的 Obsidian Vault 路径）
dev-memory init --vault-path /path/to/your/obsidian/vault

# 可选：配置 Obsidian API 密钥
dev-memory init --vault-path /path/to/vault --api-key YOUR_API_KEY
```

配置文件保存在 `~/.dev-memory/config.yaml`，可随时编辑。

## CLI 命令

除 MCP 接口外，也可通过命令行直接使用：

```bash
dev-memory add --title "解决XX问题" --problem "描述" --solution "方案"
dev-memory search "React 闭包问题"
dev-memory sync          # 同步索引
dev-memory profile       # 开发者画像
dev-memory stats         # 统计信息
```

---

## 架构

```
AI IDE (Claude Code / Cursor / CodeBuddy)
    │ stdio (MCP 协议)
    ▼
┌──────────────────────────────────────┐
│ Dev Memory MCP Server v2             │
│ (13 个 MCP Tools)                    │
├──────────────────────────────────────┤
│ 第一层: 规范手册层                     │
│   RulebookManager                    │
│   RULES.md + taxonomy.yaml           │
├──────────────────────────────────────┤
│ 第二层: 知识网络层                     │
│   KnowledgeEngine                    │
│   搜索→判重→决策→关联→归纳            │
│   solutions/ + concepts/ + _hubs/    │
├──────────────────────────────────────┤
│ 第三层: 原始资料层                     │
│   ReferenceManager                   │
│   原文存储 + AI 注解 + 溯源链         │
│   references/                        │
├──────────────────────────────────────┤
│ 基础设施: Obsidian + ChromaDB         │
└──────────────────────────────────────┘
```

## 开发

```bash
git clone https://github.com/franklynxu/dev-memory.git
cd dev-memory
pip install -e ".[dev]"
pytest
```

## License

[MIT](./LICENSE)
