kimi-code-memory-mcp-server 0.1.1 → 0.2.0

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "kimi-code-memory-mcp-server",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Local stdio MCP server providing cross-session memory for Kimi Code CLI",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",
   "type": "module",
   "bin": {
     "kimi-code-memory-mcp-server": "dist/server.js",
-    "kimi-memory-setup": "dist/setup-cli.js"
+    "kimi-memory-setup": "dist/setup-cli.js",
+    "kimi-memory-vis": "dist/vis-cli.js"
   },
   "files": [
     "dist/",
@@ -17,16 +18,18 @@
     "assets/",
     "AGENTS.md",
     "README.md",
-    "README.zh-CN.md",
+    "README.en.md",
     "LICENSE",
     "CHANGELOG.md"
   ],
   "scripts": {
     "sync-version": "node scripts/sync-version.mjs",
-    "build": "npm run sync-version && tsc",
+    "copy-vis-static": "node scripts/copy-vis-static.mjs",
+    "build": "npm run sync-version && tsc && npm run copy-vis-static",
     "dev": "tsx src/server.ts",
     "start": "node dist/server.js",
-    "test": "tsx tests/test.ts",
+    "test": "tsx tests/test.ts && tsx tests/vis.test.ts",
+    "test:unit": "tsx tests/unit/run-all.ts",
     "lint": "eslint src tests",
     "lint:fix": "eslint src tests --fix",
     "format": "prettier --write src tests",
@@ -53,9 +56,12 @@
   },
   "homepage": "https://github.com/Zehee/kimi-code-memory-mcp-server#readme",
   "dependencies": {
+    "@hono/node-server": "^2.0.6",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@types/better-sqlite3": "^7.6.13",
-    "better-sqlite3": "^12.11.1"
+    "better-sqlite3": "^12.11.1",
+    "hono": "^4.12.27",
+    "open": "^11.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",

package/README.zh-CN.md

@@ -1,292 +0,0 @@
-# Kimi Code Memory MCP Server
-
-[English](./README.md)
-
-[![CI](https://github.com/Zehee/kimi-code-memory-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/Zehee/kimi-code-memory-mcp-server/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
-
-一个为 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code) 提供跨会话记忆的本地 stdio MCP 服务器。
-
-> **注意：** 本包已发布到 npm，包名为 `kimi-code-memory-mcp-server`。你可以直接安装，也可以从源码运行。
-
-面向用户的记忆以普通 Markdown 文件存储在磁盘上。精炼轮次摘要使用本地 SQLite 缓存，但无需向量数据库、图数据库或外部云服务。
-
-## 特性
-
-- **Markdown 优先的记忆** —— 人类可读、适合 git、兼容 LLM。
-- **结构化长期记忆** —— `memory/decisions/`、`memory/knowledge/`、`memory/rules/`、`memory/reference/`。
-- **工作区精要** —— 从 `memory/` 提炼生成的浓缩摘要（≤15 KB）。
-- **跨会话上下文恢复** —— 直接解析 Kimi Code CLI 的 `wire.jsonl`。
-- **主题追溯** —— 将对话轮次和记忆关联到主题，并追踪其演化。
-- **精炼轮次摘要** —— 可在多个主题间共享的轮次级原子摘要。
-- **可重建索引** —— `index.json` 只是缓存，`.md` 文件才是真相来源。
-
-## 为什么用 Markdown？
-
-大多数 Agent 记忆系统默认使用向量数据库。这在模糊检索场景有效，但也让记忆变得不透明、难以审计、难以版本控制。
-
-本项目从相反的假设出发：
-
-> 记忆在存储之前应该经过**判断、结构化，并由用户拥有**。
-
-Markdown + YAML frontmatter 带来：
-
-- 完全可读、可编辑
-- 原生支持 git diff
-- 无需外部数据库或云服务
-- 兼容任何能读取文本的 LLM
-
-设计 rationale 见 [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md)。
-
-## 安装
-
-需要 Node.js ≥ 18。
-
-### 从 npm 安装（推荐）
-
-```bash
-npm install -g kimi-code-memory-mcp-server
-```
-
-### 从源码安装
-
-```bash
-git clone https://github.com/Zehee/kimi-code-memory-mcp-server.git
-cd kimi-code-memory-mcp-server
-npm install
-npm run build
-```
-
-## 快速配置（推荐）
-
-从 npm 安装后，运行 setup 命令自动配置 Kimi Code CLI：
-
-```bash
-npx kimi-memory-setup
-```
-
-它会完成：
-
-1. 检测 `~/.kimi-code` 目录。
-2. 在 `~/.kimi-code/AGENTS.md` 顶部注入记忆协议规则。
-3. 将 `memory-manage` Skill 安装到 `~/.kimi-code/skills/memory-manage`。
-4. 在 `~/.kimi-code/mcp.json` 中添加 `kimi-memory` MCP 服务器配置。
-
-预览变更而不写入文件：
-
-```bash
-npx kimi-memory-setup --dry-run
-```
-
-后续如需移除注入的配置：
-
-```bash
-npx kimi-memory-setup --undo
-```
-
-## 配置 Kimi Code CLI（手动）
-
-如果你希望手动配置，编辑 `~/.kimi-code/mcp.json` 并添加服务器。
-
-如果你用 `npm install -g` 安装，使用全局 `node_modules` 中 `dist/server.js` 的绝对路径：
-
-```json
-{
-  "mcpServers": {
-    "kimi-memory": {
-      "command": "node",
-      "args": ["/absolute/path/to/global/node_modules/kimi-code-memory-mcp-server/dist/server.js"],
-      "enabled": true
-    }
-  }
-}
-```
-
-或者直接通过 `npx` 运行（无需安装）：
-
-```json
-{
-  "mcpServers": {
-    "kimi-memory": {
-      "command": "npx",
-      "args": ["-y", "kimi-code-memory-mcp-server"],
-      "enabled": true
-    }
-  }
-}
-```
-
-如果你从源码构建，指向本地 `dist/server.js`：
-
-```json
-{
-  "mcpServers": {
-    "kimi-memory": {
-      "command": "node",
-      "args": ["/absolute/path/to/kimi-code-memory-mcp-server/dist/server.js"],
-      "enabled": true
-    }
-  }
-}
-```
-
-服务器名称 **`kimi-memory`** 很重要，因为本仓库自带的 `AGENTS.md` 规则以 `mcp__kimi-memory__*` 形式调用工具（例如 `mcp__kimi-memory__bootstrap_workspace`）。
-
-重启 Kimi Code CLI 以加载该服务器。
-
-## 可选：安装用户级 AGENTS.md 启动钩子
-
-如需每次会话启动时自动恢复记忆并应用行为规范，将本仓库自带的 `AGENTS.md` 复制到 Kimi Code 用户目录：
-
-```bash
-cp AGENTS.md ~/.kimi-code/AGENTS.md
-```
-
-这会安装一个启动钩子，让 Kimi Code CLI 在每次会话开始时调用 `bootstrap_workspace`，并遵循记忆分类和决策守卫规则。由于 `AGENTS.md` 会注入到**每个**会话中，它是放置记忆相关行为协议的正确位置。
-
-> **注意：** `AGENTS.md` 规则会注入到每个会话中，请只保留与记忆相关的约定，不要包含属于其他 MCP server 的工具偏好。
->
-> **前提条件：** 必须在 `~/.kimi-code/mcp.json` 中将 MCP 服务器注册为 `kimi-memory`，否则 `AGENTS.md` 中的 `mcp__kimi-memory__*` 调用会失败。
-
-## 可选：安装记忆 Skill
-
-本仓库还包含一个轻量 Skill（`skills/memory-manage/SKILL.md`），用于在用户表达记忆相关意图时提醒 Kimi Code CLI 调用记忆工具。
-
-```bash
-cp -r skills/memory-manage ~/.kimi-code/skills/memory-manage
-```
-
-该 Skill 本身**不强制**行为，它只是一个调度器。真正的协议（何时 remember、决策守卫等）应配置在 `AGENTS.md` 中。
-
-## 快速开始
-
-服务器加载后，Agent 可以自然地调用记忆工具（工具名带有你在 MCP 配置中注册的 server 名称前缀，例如 `mcp__kimi-memory__*`）：
-
-```text
-用户：我们用 SQLite 作为缓存层。
-Agent：[调用 mcp__kimi-memory__remember] key=use-sqlite-cache, folder=memory/decisions
-
-用户：为什么选 SQLite？
-Agent：[调用 mcp__kimi-memory__search] query=SQLite cache decision
-       [调用 mcp__kimi-memory__recall] key=use-sqlite-cache, folder=memory/decisions
-       → "我们选择 SQLite 而不是 Redis，因为……"
-
-用户：缓存设计是怎么演化的？
-Agent：[调用 mcp__kimi-memory__tag_theme] theme=cache-design
-       [调用 mcp__kimi-memory__trace_theme] theme=cache-design
-       → 展示跨会话的相关轮次和决策
-```
-
-## 存储布局
-
-服务器将数据存储在 `~/.kimi-code-memory/<workspace-id>/` 下：
-
-```text
-~/.kimi-code-memory/workspace-a1b2c3d4/
-├── index.json              # v3-kv 元数据缓存（可重建）
-├── memory/
-│   ├── decisions/          # 架构与产品决策
-│   ├── knowledge/          # 项目相关知识
-│   ├── rules/              # 约定与红线
-│   └── reference/          # 外部参考
-├── essence/
-│   └── essence.md          # 工作区精要（≤15 KB）
-├── notes/                  # 临时速记
-├── themes/
-│   └── my-theme.json       # theme -> turn/memory 引用
-└── refined/
-    └── refined.sqlite      # 轮次级摘要
-```
-
-可通过 `MEMORY_STORE_ROOT` 环境变量覆盖存储根目录。
-
-### 环境变量
-
-| 变量 | 用途 |
-|------|------|
-| `MEMORY_STORE_ROOT` | 覆盖默认存储根目录 `~/.kimi-code-memory`。 |
-| `MEMORY_SESSIONS_ROOT` | 覆盖默认的 `~/.kimi-code/sessions` 路径，用于发现 `wire.jsonl` 文件。 |
-| `KIMI_CODE_HOME` | `MEMORY_SESSIONS_ROOT` 的替代方案；会话从 `<KIMI_CODE_HOME>/sessions` 读取。 |
-
-## 工具列表
-
-| 工具 | 用途 |
-|------|------|
-| `remember` | 写入一条 Markdown 记忆 |
-| `recall` | 按 key 读取记忆 |
-| `recall_recent` | 列出最近更新的记忆 |
-| `search` | 在记忆中关键词搜索 |
-| `list` | 列出记忆 |
-| `list_tags` | 列出所有标签 |
-| `delete` | 删除记忆 |
-| `move` | 移动或重命名记忆 |
-| `organize_memories` | 将 `memory/` 提炼为 `essence/essence.md` |
-| `sync_workspace_index` | 从磁盘重建 `index.json` |
-| `bootstrap_workspace` | 加载上下文、精要和记忆树 |
-| `load_workspace_context` | 加载最近对话上下文 |
-| `load_more_context` | 加载更早的对话轮次 |
-| `search_context` | 跨所有会话 wire 搜索 |
-| `load_turn_context` | 加载指定轮次详情 |
-| `tag_theme` | 将轮次或记忆关联到主题 |
-| `trace_theme` | 追溯主题演化 |
-| `list_themes` | 列出主题 |
-| `refine_session_turns` | 生成精炼轮次摘要 |
-
-## 开发
-
-```bash
-git clone https://github.com/Zehee/kimi-code-memory-mcp-server.git
-cd kimi-code-memory-mcp-server
-npm install
-npm run build
-npm test
-npm run lint
-```
-
-贡献指南见 [`docs/CONTRIBUTING.md`](./docs/CONTRIBUTING.zh-CN.md)。
-
-## 项目结构
-
-```text
-src/
-├── server.ts              # MCP 服务器入口
-├── config.ts              # 默认值与路径
-├── theme-manager.ts       # 主题存储
-├── refined-manager.ts     # 精炼轮次存储
-├── dao/
-│   ├── index.ts           # index.json DAO（v3-kv）
-│   └── memory-store.ts    # Markdown 文件操作
-├── context/
-│   └── wire-context.ts    # wire.jsonl 解析
-├── tools/
-│   ├── index.ts           # 工具 schema 与分发
-│   ├── memory-tools.ts    # 记忆增删改查
-│   ├── context-tools.ts   # 上下文恢复
-│   ├── theme-tools.ts     # 主题追溯
-│   └── system-tools.ts    # 整理/同步/引导
-└── utils/
-    ├── frontmatter.ts
-    ├── paths.ts
-    └── validation.ts
-```
-
-## 路线图
-
-- [x] 模块化源码结构
-- [x] ESLint + Prettier
-- [x] 基础集成测试
-- [x] 上下文/主题工具核心测试覆盖
-- [ ] 可选本地 embedding 搜索
-- [ ] 可选 LLM 精炼轮次
-- [ ] 可插拔 wire 格式适配器
-- [ ] 内存使用 benchmark
-
-## 相关文档
-
-- [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md) —— 系统设计与数据流
-- [`docs/search-logic.zh-CN.md`](./docs/search-logic.zh-CN.md) —— `search` 与 `search_context` 的实现逻辑
-- [`docs/CONTRIBUTING.zh-CN.md`](./docs/CONTRIBUTING.zh-CN.md) —— 如何贡献
-
-## 许可证
-
-MIT