@pcircle/memesh 2.10.1 → 3.0.0

package/README.zh-CN.md

@@ -1,212 +0,0 @@
-<div align="center">
-
-<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
-
-# MeMesh Plugin
-
-### 你的 AI 编程会话值得拥有记忆。
-
-MeMesh Plugin 为 Claude Code 提供持久的、可搜索的记忆 — 让每次会话都能承接上次的成果。
-
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
-[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-[快速开始](#快速开始) · [运作原理](#运作原理) · [命令](#命令) · [文档](docs/USER_GUIDE.md)
-
-[English](README.md) · [繁體中文](README.zh-TW.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
-
-</div>
-
-> **注意**：本项目原名「Claude Code Buddy」，为避免潜在的商标问题已更名为 MeMesh Plugin。
-
----
-
-## 问题所在
-
-你正在用 Claude Code 深入开发一个项目。三个会话之前你做了重要决策 — 选了哪个认证库、为什么选择那个数据库架构、该遵循什么模式。但 Claude 不记得了。你不断重复自己说过的话。你失去了上下文。你浪费了时间。
-
-**MeMesh 解决了这个问题。** 它为 Claude 提供一个持久的、可搜索的记忆，随着你的项目一起成长。
-
----
-
-## 运作原理
-
-<table>
-<tr>
-<td width="50%">
-
-### 没有 MeMesh 之前
-```
-Session 1: "用 JWT 做认证"
-Session 2: "我们当时为什么选 JWT 来着？"
-Session 3: "等等，我们用的是什么认证库？"
-```
-你不断重复决策。Claude 忘记上下文。进度停滞。
-
-</td>
-<td width="50%">
-
-### 有了 MeMesh 之后
-```
-Session 1: "用 JWT 做认证" → 已保存
-Session 2: buddy-remember "auth" → 即时回忆
-Session 3: 启动时自动加载上下文
-```
-每次会话都能从上次中断的地方继续。
-
-</td>
-</tr>
-</table>
-
----
-
-## 你能获得什么
-
-**可搜索的项目记忆** — 问"我们之前怎么决定 auth 的？"就能得到即时的、语义匹配的答案。不是关键字搜索 — 是*语义*搜索，由本地 ONNX 嵌入驱动。
-
-**智能任务分析** — `buddy-do "添加用户认证"` 不只是执行。它会从过去的会话中提取相关上下文，检查你已建立的模式，并在写任何一行代码之前制定完整的计划。
-
-**主动回忆** — MeMesh 在你开始会话、遇到测试失败或出现错误时，自动浮现相关记忆。无需手动搜索。
-
-**工作流自动化** — 启动时展示会话回顾。文件变更追踪。提交前的代码审查提醒。所有这些都在后台静默运行。
-
-**错误学习** — 记录错误和修复方式，构建知识库。同样的错误不会再犯第二次。
-
----
-
-## 快速开始
-
-**前提条件**：[Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-重启 Claude Code。搞定。
-
-**验证** — 在 Claude Code 中输入：
-
-```
-buddy-help
-```
-
-你应该能看到可用命令列表。
-
-<details>
-<summary><strong>从源码安装</strong>（贡献者）</summary>
-
-```bash
-git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
-cd claude-code-buddy
-npm install && npm run build
-```
-
-</details>
-
----
-
-## 命令
-
-| 命令 | 功能 |
-|---------|-------------|
-| `buddy-do "任务"` | 带着完整记忆上下文执行任务 |
-| `buddy-remember "主题"` | 搜索过去的决策和上下文 |
-| `buddy-help` | 显示可用命令 |
-
-**实际示例：**
-
-```bash
-# 快速了解一个陌生的代码库
-buddy-do "explain this codebase"
-
-# 带着过去工作的上下文构建功能
-buddy-do "add user authentication"
-
-# 回忆当初为什么做了那些决策
-buddy-remember "API design decisions"
-buddy-remember "why we chose PostgreSQL"
-```
-
-所有数据都保存在你的本机上，自动保留 90 天。
-
----
-
-## 这和 CLAUDE.md 有什么不同？
-
-| | CLAUDE.md | MeMesh |
-|---|-----------|--------|
-| **用途** | 给 Claude 的静态指令 | 随项目成长的活记忆 |
-| **搜索** | 手动文本搜索 | 基于语义的意义搜索 |
-| **更新** | 你手动编辑 | 工作时自动捕获决策 |
-| **回忆** | 始终加载（可能变得很长） | 按需浮现相关上下文 |
-| **范围** | 通用偏好设置 | 项目专属的知识图谱 |
-
-**它们协同工作。** CLAUDE.md 告诉 Claude *怎么*工作。MeMesh 记住你*做了*什么。
-
----
-
-## 平台支持
-
-| 平台 | 状态 |
-|----------|--------|
-| macOS | ✅ |
-| Linux | ✅ |
-| Windows | ✅（建议使用 WSL2） |
-
-**兼容：** Claude Code CLI · VS Code 扩展 · Cursor（通过 MCP） · 任何兼容 MCP 的编辑器
-
----
-
-## 架构
-
-MeMesh 作为 Claude Code 插件在本地运行，内含 MCP 组件：
-
-- **知识图谱** — 基于 SQLite 的实体存储，支持 FTS5 全文搜索
-- **向量嵌入** — ONNX 运行时实现语义相似度（100% 本地运行）
-- **内容去重** — SHA-256 哈希跳过冗余的嵌入计算
-- **批量处理** — 高效的批量操作，适用于大型知识库
-- **Hook 系统** — 在会话开始、测试失败和错误发生时主动回忆
-
-一切都在本地运行。无需云服务。无需 API 调用。你的数据永远不会离开你的机器。
-
----
-
-## 文档
-
-| 文档 | 说明 |
-|-----|-------------|
-| [快速开始](docs/GETTING_STARTED.md) | 分步设置指南 |
-| [使用指南](docs/USER_GUIDE.md) | 完整使用指南与示例 |
-| [命令参考](docs/COMMANDS.md) | 完整命令参考 |
-| [架构说明](docs/ARCHITECTURE.md) | 技术深度解析 |
-| [贡献指南](CONTRIBUTING.md) | 贡献指南 |
-| [开发指南](docs/DEVELOPMENT.md) | 贡献者开发设置 |
-
----
-
-## 贡献
-
-欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 开始。
-
----
-
-## 许可证
-
-MIT — 详见 [LICENSE](LICENSE)
-
----
-
-<div align="center">
-
-**用 Claude Code 构建，为 Claude Code 而生。**
-
-[报告 Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [功能请求](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [获取帮助](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
-
-</div>

package/README.zh-TW.md

@@ -1,286 +0,0 @@
-<div align="center">
-
-<img src="docs/images/memesh-logo.svg" alt="MeMesh" width="80" />
-
-# MeMesh Plugin
-
-### 你的 AI 程式開發應該有記憶。
-
-MeMesh Plugin 賦予 Claude Code 持久、可搜尋的記憶 — 讓每次對話都能延續上一次的成果。
-
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
-[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-[開始使用](#開始使用) · [運作原理](#運作原理) · [指令](#指令) · [文件](docs/USER_GUIDE.md)
-
-[English](README.md) · **繁體中文** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
-
-</div>
-
-> **備註**：本專案原名「Claude Code Buddy」，為避免潛在的商標問題已更名為 MeMesh Plugin。
-
----
-
-## 問題所在
-
-你正在用 Claude Code 深入開發一個專案。三個 session 前你做了重要決策 — 用哪個 auth 函式庫、為什麼選了那個資料庫 schema、該遵循什麼模式。但 Claude 不記得了。你只能重複說明、失去脈絡、浪費時間。
-
-**MeMesh 解決了這個問題。** 它賦予 Claude 持久、可搜尋的記憶，隨著你的專案一起成長。
-
----
-
-## 運作原理
-
-<table>
-<tr>
-<td width="50%">
-
-### 沒有 MeMesh
-```
-Session 1: "用 JWT 做 auth"
-Session 2: "我們當初為什麼選 JWT？"
-Session 3: "等等，我們用的是哪個 auth 函式庫？"
-```
-你不斷重複決策。Claude 忘了脈絡。進度停滯。
-
-</td>
-<td width="50%">
-
-### 有了 MeMesh
-```
-Session 1: "用 JWT 做 auth" → 已儲存
-Session 2: buddy-remember "auth" → 即時回憶
-Session 3: 啟動時自動載入脈絡
-```
-每次 session 都能接續上次的進度。
-
-</td>
-</tr>
-</table>
-
----
-
-## 你能獲得什麼
-
-**可搜尋的專案記憶** — 問「我們之前怎麼決定 auth 的？」就能即時得到語意匹配的答案。不是關鍵字搜尋 — 而是*語意*搜尋，由本地 ONNX embeddings 驅動。
-
-**智慧任務分析** — `buddy-do "加上使用者認證"` 不只是執行。它會從過去的 session 中提取相關脈絡、檢查你已建立的模式，在寫下任何一行程式碼之前先建構完整的計畫。
-
-**主動回憶** — MeMesh 在你開始 session、遇到測試失敗或碰到錯誤時，自動浮現相關記憶。不需要手動搜尋。
-
-**工作流自動化** — 啟動時顯示 session 回顧、追蹤檔案變更、commit 前提醒 code review。全部在背景靜靜運行。
-
-**錯誤學習** — 記錄錯誤和修復方式來建立知識庫。同樣的錯誤不會再犯第二次。
-
----
-
-## 開始使用
-
-**前置需求**：[Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-重啟 Claude Code，完成。
-
-**驗證** — 在 Claude Code 中輸入：
-
-```
-buddy-help
-```
-
-你應該會看到可用指令的列表。
-
-<details>
-<summary><strong>從原始碼安裝</strong>（貢獻者）</summary>
-
-```bash
-git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
-cd claude-code-buddy
-npm install && npm run build
-```
-
-</details>
-
----
-
-## 指令
-
-| 指令 | 功能說明 |
-|------|----------|
-| `buddy-do "任務"` | 帶著完整記憶脈絡執行任務 |
-| `buddy-remember "主題"` | 搜尋過去的決策和脈絡 |
-| `buddy-help` | 顯示可用指令 |
-
-**實際範例：**
-
-```bash
-# 快速了解一個不熟悉的 codebase
-buddy-do "explain this codebase"
-
-# 帶著過去工作的脈絡來開發功能
-buddy-do "add user authentication"
-
-# 回顧決策的原因
-buddy-remember "API design decisions"
-buddy-remember "why we chose PostgreSQL"
-```
-
-所有資料都存在你的電腦上，統一採用 90 天自動保留機制。
-
----
-
-## 這跟 CLAUDE.md 有什麼不同？
-
-| | CLAUDE.md | MeMesh |
-|---|-----------|--------|
-| **用途** | 給 Claude 的靜態指令 | 隨專案成長的活記憶 |
-| **搜尋** | 手動文字搜尋 | 依語意搜尋 |
-| **更新** | 你手動編輯 | 工作時自動捕捉決策 |
-| **回憶** | 永遠載入（可能變很長） | 按需浮現相關脈絡 |
-| **範圍** | 一般偏好設定 | 專案專屬的知識圖譜 |
-
-**它們可以搭配使用。** CLAUDE.md 告訴 Claude *如何*工作。MeMesh 記住你*建了什麼*。
-
----
-
-## 平台支援
-
-| 平台 | 狀態 |
-|------|------|
-| macOS | ✅ |
-| Linux | ✅ |
-| Windows | ✅ (建議 WSL2) |
-
-**可搭配使用：** Claude Code CLI · VS Code Extension · Cursor (透過 MCP) · 任何相容 MCP 的編輯器
-
----
-
-## 視覺化瀏覽器（Streamlit UI）
-
-MeMesh 內建互動式 Web UI，讓你直觀地探索知識圖譜。
-
-**Dashboard** — 知識庫總覽，包含實體統計、類型分佈、標籤趨勢與成長曲線。
-
-<div align="center">
-<img src="docs/images/streamlit-dashboard.png" alt="MeMesh Dashboard" width="800" />
-</div>
-
-**KG Explorer** — 互動式圖譜視覺化，支援按顏色區分實體類型、關係連線、FTS5 全文搜尋，以及按類型、標籤和日期範圍篩選。
-
-<div align="center">
-<img src="docs/images/streamlit-kg-explorer.png" alt="MeMesh KG Explorer" width="800" />
-</div>
-
-**快速啟動：**
-
-```bash
-cd streamlit
-pip install -r requirements.txt
-streamlit run app.py
-```
-
----
-
-## 架構
-
-```mermaid
-graph TB
-    CC[Claude Code CLI] <-->|MCP Protocol| MCP[MCP Server]
-
-    MCP --> TH[Tool Handlers]
-    TH --> MT[Memory Tools]
-    TH --> ST[System Tools]
-    TH --> HT[Hook Tools]
-
-    MT --> UMS[Unified Memory Store]
-    MT --> KG[Knowledge Graph]
-
-    UMS --> SE[Search Engine]
-    KG --> FTS[FTS5 全文搜尋]
-    KG --> VS[向量搜尋]
-
-    VS --> EMB[ONNX 嵌入模型]
-    VS --> SVA[sqlite-vec Adapter]
-
-    KG --> DB[(SQLite DB)]
-    UMS --> DB
-
-    DB -.->|唯讀| ST_UI[Streamlit 視覺化瀏覽器]
-
-    style CC fill:#4F46E5,color:#fff
-    style MCP fill:#7C3AED,color:#fff
-    style DB fill:#0891B2,color:#fff
-    style ST_UI fill:#06B6D4,color:#fff
-    style EMB fill:#10B981,color:#fff
-```
-
-**記憶如何在系統中流動：**
-
-```mermaid
-sequenceDiagram
-    participant U as 你（在 Claude Code 中）
-    participant M as MeMesh Plugin
-    participant KG as 知識圖譜
-    participant E as 嵌入模型（ONNX）
-
-    U->>M: 「使用 JWT 做認證」
-    M->>KG: 建立實體（decision）
-    KG->>E: 產生嵌入向量（本地）
-    E-->>KG: 384 維向量
-    KG-->>M: 已儲存 + 自動推斷關係
-
-    Note over U,E: 下一個 session...
-
-    U->>M: buddy-remember "auth"
-    M->>KG: 混合搜尋（FTS5 + 語意）
-    KG->>E: 編碼查詢
-    E-->>KG: 查詢向量
-    KG-->>M: 排序後的結果
-    M-->>U: 「你決定用 JWT 做認證，因為...」
-```
-
-一切在本地運行。沒有雲端。沒有 API 呼叫。你的資料永遠不會離開你的電腦。
-
----
-
-## 文件
-
-| 文件 | 說明 |
-|------|------|
-| [快速開始](docs/GETTING_STARTED.md) | 一步步的安裝指南 |
-| [使用指南](docs/USER_GUIDE.md) | 完整使用指南與範例 |
-| [指令參考](docs/COMMANDS.md) | 完整的指令參考 |
-| [架構說明](docs/ARCHITECTURE.md) | 技術深入解析 |
-| [貢獻指南](CONTRIBUTING.md) | 貢獻者指南 |
-| [開發指南](docs/DEVELOPMENT.md) | 給貢獻者的開發設定 |
-
----
-
-## 貢獻
-
-歡迎貢獻！請參閱 [CONTRIBUTING.md](CONTRIBUTING.md) 開始。
-
----
-
-## 授權
-
-MIT — 詳見 [LICENSE](LICENSE)
-
----
-
-<div align="center">
-
-**用 Claude Code 打造，為 Claude Code 而生。**
-
-[回報 Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [功能請求](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [取得協助](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
-
-</div>

package/dist/cli/config.d.ts

@@ -1,36 +0,0 @@
-interface MCPServerConfig {
-    command: string;
-    args: string[];
-    env?: Record<string, string>;
-}
-interface ClaudeCodeConfig {
-    mcpServers?: {
-        [key: string]: MCPServerConfig;
-    };
-    [key: string]: any;
-}
-interface ValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    config?: ClaudeCodeConfig;
-}
-export declare class ConfigManager {
-    static getConfigPath(): string;
-    static getConfigPathDescription(): string;
-    static readConfig(): Promise<ClaudeCodeConfig | null>;
-    static writeConfig(config: ClaudeCodeConfig): Promise<boolean>;
-    static validateConfig(): Promise<ValidationResult>;
-    static generateDefaultConfig(): ClaudeCodeConfig;
-    private static findMemeshPath;
-    static highlightJSON(obj: any): string;
-    static openInEditor(): Promise<boolean>;
-    private static getDefaultEditor;
-    static backupConfig(): Promise<string | null>;
-}
-export declare function showConfig(): Promise<void>;
-export declare function validateConfig(): Promise<void>;
-export declare function editConfig(): Promise<void>;
-export declare function resetConfig(): Promise<void>;
-export {};
-//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AA0BA,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAKD,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE;QACX,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;KAChC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAKD,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAKD,qBAAa,aAAa;IAIxB,MAAM,CAAC,aAAa,IAAI,MAAM;IAsB9B,MAAM,CAAC,wBAAwB,IAAI,MAAM;WAe5B,UAAU,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;WAmB9C,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;WAoBvD,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAuExD,MAAM,CAAC,qBAAqB,IAAI,gBAAgB;IAkBhD,OAAO,CAAC,MAAM,CAAC,cAAc;IAuB7B,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;WAmCzB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAkC7C,OAAO,CAAC,MAAM,CAAC,gBAAgB;WAelB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkBpD;AAKD,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiEhD;AAKD,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAwFpD;AAKD,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEhD;AAKD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA4EjD"}