memory-forge 0.1.8 → 0.1.9

package/TECHNICAL.md

@@ -0,0 +1,526 @@
+# MemoryForge 技术文档
+
+> 版本 0.1.8 | 8 MCP 工具 + 5 自动引擎 | Free 本地 + Pro Shelby 云
+
+## 目录
+
+1. [系统架构](#系统架构)
+2. [数据模型](#数据模型)
+3. [MCP 工具 API 参考](#mcp-工具-api-参考)
+4. [自动引擎](#自动引擎)
+5. [Hook 系统](#hook-系统)
+6. [存储层](#存储层)
+7. [嵌入引擎](#嵌入引擎)
+8. [安全模型](#安全模型)
+9. [Pro 层 (Shelby 云)](#pro-层-shelby-云)
+10. [错误处理与降级](#错误处理与降级)
+
+---
+
+## 系统架构
+
+```
+┌─────────────────────────────────────┐
+│  AI Agent (Claude Code / Cursor)    │  MCP stdio 协议
+├─────────────────────────────────────┤
+│  CLI 路由 (index.ts)                │
+│  setup / pro / hook / MCP Server    │
+├─────────────────────────────────────┤
+│  8 MCP Tools                        │
+│  store / search / recall / list     │
+│  forget / context / export / share  │
+├──────────────┬──────────────────────┤
+│  Free 层     │  Pro 层               │
+│  memoryStore │  ShelbyNodeClient     │
+│  local .md   │  upload/download/list │
+├──────────────┴──────────────────────┤
+│  5 Auto Engines                     │
+│  name → merge → priority → decay    │
+│  → contextSummary                   │
+├─────────────────────────────────────┤
+│  Embedding Engine                   │
+│  Transformers.js / MiniLM-L6-v2     │
+│  384-dim vectors, cosine similarity │
+│  fallback: keyword matching         │
+└─────────────────────────────────────┘
+```
+
+### 源文件结构
+
+```
+agentvault/src/
+├── index.ts           # 入口: CLI 路由 + MCP Server
+├── store.ts           # MemoryStore: 内存索引 + 搜索
+├── embedding.ts       # Transformers.js 延迟加载引擎
+├── setup.ts           # 一键安装流程
+├── pro.ts             # Pro 激活 + 同步
+├── auto/index.ts      # 5 自动引擎
+├── storage/
+│   ├── local.ts       # Markdown 文件读写
+│   └── shelby.ts      # Shelby 云 API 封装
+├── hooks/install.ts   # Claude Code hooks 配置
+└── migrate/import.ts  # 规则导入 + 去重
+```
+
+---
+
+## 数据模型
+
+### Memory 接口
+
+```typescript
+interface Memory {
+  id: string;              // UUID v4
+  name: string;            // 人类可读名称 (autoName 生成, 最长40字符)
+  content: string;         // 原始内容
+  category: string;        // 分类: user-preference | project-context | decision-log | code-pattern
+  tags: string[];          // 标签列表
+  priority: number;        // 1-10, autoPriority 动态调整
+  vector: number[];        // 384-dim 嵌入向量
+  created_at: string;      // ISO-8601 创建时间
+  access_count: number;    // 访问次数 (touch)
+  last_accessed: string | null;  // 最后访问时间
+}
+```
+
+### 本地存储格式
+
+文件路径: `~/.memory-forge/memories/{id}.md`
+
+```markdown
+# Memory Name
+> category: user-preference
+> tags: coding-style, javascript
+> priority: 8
+> created: 2026-06-26T10:00:00.000Z
+> access_count: 5
+> last_accessed: 2026-06-26T12:00:00.000Z
+
+User prefers camelCase naming, single quotes, and 2-space indent.
+```
+
+### MemoryStore 索引
+
+- `Map<string, Memory>` 主存储
+- `Map<string, Float32Array>` 向量缓存
+- LRU 淘汰: 5000 条上限, 超出淘汰最低访问量×优先级
+- 去重: Jaccard 相似度 > 0.8 自动合并
+
+---
+
+## MCP 工具 API 参考
+
+所有工具通过 MCP stdio 协议调用。Agent 自动获得，无需手动调用。
+
+### memory_store
+
+存储一条记忆。自动向量化、命名、去重合并。
+
+```typescript
+// Input
+{
+  content: string;        // required, min 1 char
+  category?: string;      // "general" | "user-preference" | "project-context" | "decision-log" | "code-pattern"
+  tags?: string[];        // default: []
+  priority?: number;      // 1-10, default: 5
+}
+
+// Output (success)
+{
+  success: true;
+  merged?: boolean;       // true if merged with existing memory (>80% overlap)
+  memory_id: string;
+  name: string;
+  preview: string;        // first 200 chars
+}
+```
+
+**内部流程:**
+1. `embed(content)` → 384-dim vector (失败则 vector=[])
+2. `autoName(content)` → 从内容提取名称
+3. `autoMerge(store, memory)` → 检查已有记忆, >0.8 Jaccard 则合并
+4. `saveMemory(memory)` → 写本地 Markdown
+5. `store.add(memory)` → 更新 LRU 缓存
+6. Pro: `uploadMemory(memory)` → Shelby 云 (async, fire-and-forget)
+
+### memory_search
+
+语义检索记忆。向量优先, 失败自动降级关键词。
+
+```typescript
+// Input
+{
+  query: string;           // required, 自然语言
+  limit?: number;          // 1-20, default: 5
+  min_similarity?: number; // 0-1, default: 0.6
+  category?: string;       // filter by category
+  tags?: string[];         // filter by tags (OR match)
+}
+
+// Output
+{
+  query: string;
+  count: number;
+  results: [{
+    memory_id: string;
+    name: string;
+    similarity: number;    // cosine similarity (0 if keyword fallback)
+    content: string;
+    _method: "vector" | "keyword";
+  }];
+  hint: string | null;     // "No relevant memories found." if empty
+}
+```
+
+**评分公式 (向量模式):**
+```
+score = cosineSimilarity(queryVec, memoryVec)
+      × (priority / 5)
+      × (1 + min(access_count, 10) × 0.05)
+```
+
+**评分公式 (关键词模式):**
+```
+score = (contentHits × 2 + nameHits × 3) + priority
+```
+
+### memory_recall
+
+按 ID 精确获取一条记忆。
+
+```typescript
+// Input
+{ memory_id: string }
+
+// Output (success)
+{
+  memory_id, name, content, category, tags,
+  priority, created_at, access_count
+}
+
+// Output (not found)
+{ error: "Not found", memory_id }
+```
+
+### memory_list
+
+列出记忆目录，支持分页和过滤。
+
+```typescript
+// Input
+{
+  category?: string;    // filter
+  tags?: string[];      // filter (OR match)
+  limit?: number;       // 1-100, default: 20
+  offset?: number;      // default: 0
+}
+
+// Output
+{
+  total: number;        // 总记忆数
+  count: number;        // 当前页数量
+  memories: [{
+    memory_id, name, category,
+    tags, priority,
+    preview: string;    // first 100 chars
+  }];
+}
+```
+
+### memory_forget
+
+删除一条记忆（本地文件 + 内存缓存）。
+
+```typescript
+// Input
+{ memory_id: string }
+
+// Output
+{
+  success: boolean;
+  memory_id: string;
+  action: "deleted" | "not_found";
+}
+```
+
+### memory_context
+
+加载当前会话上下文，返回最近访问的高优先级记忆摘要。
+
+```typescript
+// Input
+{ limit?: number;  // 1-20, default: 5 }
+
+// Output
+{
+  context_loaded: true;
+  memory_count: number;
+  context: string;  // 格式: "- [name] preview..."
+}
+```
+
+**排序:** `access_count` DESC, 同分则 `priority` DESC。
+
+### memory_export
+
+导出记忆为 JSON 或 Markdown。
+
+```typescript
+// Input
+{
+  memory_ids?: string[];  // 不指定则导出全部
+  format?: "json" | "markdown";  // default: "json"
+}
+
+// Output (JSON)
+{
+  exported_at: string;
+  version: "memory-forge-1.0";
+  count: number;
+  memories: [{ id, name, content, category, tags, priority, created_at }];
+}
+
+// Output (Markdown)
+# Memory Name
+> category: x | tags: a, b | priority: 7
+...
+---
+```
+
+### memory_share
+
+打包单条记忆供队友导入。
+
+```typescript
+// Input
+{
+  memory_id: string;
+  recipient?: string;
+  note?: string;
+}
+
+// Output
+{
+  type: "memory-forge-share";
+  version: "1.0";
+  shared_at: string;
+  recipient: string | null;
+  note: string | null;
+  memory: { name, content, category, tags };
+  import_instruction: "Use memory_store with this content to import.";
+}
+```
+
+---
+
+## 自动引擎
+
+所有引擎位于 `src/auto/index.ts`。
+
+### autoName
+
+从内容提取人类可读名称。
+
+```
+算法:
+1. 移除代码块 (```...```)
+2. 取前 40 字符
+3. 换行替换为空格
+4. 空内容 → "memory"
+```
+
+### autoMerge
+
+检测并合并重复记忆。
+
+```
+算法:
+1. Jaccard 相似度: |setA ∩ setB| / min(|setA|, |setB|)
+2. 单词长度 ≥ 3
+3. 阈值: > 0.8 → 合并
+4. 合并后重新计算向量
+```
+
+### autoPriority
+
+基于 Ebbinghaus 遗忘曲线计算优先级 (1-10)。
+
+```
+公式:
+freqWeight   = min(access_count, 50) / 50
+recencyWeight = 1 - (daysSinceLastAccess / 90)  // clamp 0-1
+ageWeight    = 1 - min(ageDays, 365) / 365
+
+priority = 1 + 9 × (freqWeight × 0.4 + recencyWeight × 0.4 + ageWeight × 0.2)
+```
+
+### autoDecay
+
+Ebbinghaus 遗忘曲线判定记忆是否归档。
+
+```
+| 天数 | 衰减值 | 含义 |
+|------|--------|------|
+| ≤1   | 1.0    | 活跃 |
+| ≤7   | 0.8    | 近期 |
+| ≤30  | 0.5    | 衰减中 |
+| ≤90  | 0.2    | 弱记忆 |
+| >90  | 0      | 归档 (删除) |
+```
+
+### generateContextSummary
+
+生成 Agent 上下文摘要。
+
+```
+算法:
+1. 取全部记忆, 按 access_count DESC, priority DESC 排序
+2. 截取 top-N
+3. 每条截断 150 字符
+4. 格式: "- [name] content..."
+```
+
+---
+
+## Hook 系统
+
+配置位置: `~/.claude/settings.json`
+
+```json
+{
+  "hooks": {
+    "SessionStart": [{
+      "hooks": [{"type": "command", "command": "memory-forge hook session-start"}]
+    }],
+    "Stop": [{
+      "hooks": [{"type": "command", "command": "memory-forge hook stop"}]
+    }],
+    "PreCompact": [{
+      "hooks": [{"type": "command", "command": "memory-forge hook pre-compact"}]
+    }]
+  }
+}
+```
+
+### 生命周期
+
+```
+SessionStart  → 加载 top-5 记忆 → 注入 Agent 上下文 (stdout)
+   ↓
+Agent 工作    → 调 memory_store / memory_search / ...
+   ↓
+PreCompact    → 加载 top-8 记忆 + 注入存储指令 → Agent 自动保存
+   ↓
+Stop          → autoPriority 重算 + autoDecay 检查 + 归档过期记忆
+   ↓
+(下次) SessionStart → 记忆已保留 ✅
+```
+
+### 关键设计决策
+
+**为什么 PreCompact 而非 Stop 做 auto-capture？**
+Stop hook 只在正常退出时触发。`kill` / 关终端窗口 / 崩溃 → Stop 不跑。PreCompact 在上下文快满时一定触发，此时进程还活着，Agent 能执行存储指令。
+
+---
+
+## 存储层
+
+### Free 层 (本地 Markdown)
+
+- 路径: `~/.memory-forge/memories/{id}.md`
+- 格式: 类 YAML frontmatter + Markdown body
+- 编码: UTF-8
+- 权限: 用户文件系统控制
+- 网络: 零
+
+### Pro 层 (Shelby 云)
+
+- SDK: `@shelby-protocol/sdk` ^0.3.1 (optionalDep)
+- 网络: Shelbynet 测试网
+- 认证: API Key + Ed25519 链上账户
+- Blob 格式: `memories/{id}.json` (JSON)
+- 过期: 365 天
+- 数据流: 双向同步 (session 启动时 ↓↑, memory_store 时 ↑)
+
+**Pro 数据流:**
+```
+SessionStart:
+  syncAll():
+    ↓ listBlobs() → 获取远程记忆列表
+    ↓ downloadMemory() → 下载本地不存在的 (30s timeout)
+    ↑ uploadMemory() → 上传本地有而远程无的
+    → 双向同步完成
+
+memory_store:
+  saveMemory() → 本地
+  uploadMemory() → Shelby (fire-and-forget, 失败不阻塞)
+```
+
+---
+
+## 嵌入引擎
+
+### 技术栈
+
+- 库: `@huggingface/transformers` ^3.0.0
+- 模型: Xenova/all-MiniLM-L6-v2
+- 大小: ~23MB (首次下载, 后续缓存)
+- 维度: 384
+- 池化: mean pooling + L2 normalize
+
+### 降级策略
+
+```
+加载模型
+  → 成功: cos similarity search
+  → 失败: keyword matching (Jaccard)
+     + 5 分钟自动重试
+     + sleep(300s) 防止请求风暴
+```
+
+### 性能
+
+- 首次加载: 3-10s (取决于网络, 23MB 下载)
+- 后续推理: < 100ms
+- 降级关键词: < 10ms
+- 模型缓存: Transformers.js 内置缓存
+
+---
+
+## 安全模型
+
+### Free 层
+
+- 全部数据在 `~/.memory-forge/` 目录
+- 零持续网络请求
+- 唯一网络: 首次模型下载 (HuggingFace CDN, 23MB)
+- 模型下载失败 → 关键词降级, 零功能损失
+
+### Pro 层
+
+- API Key: 环境变量 `SHELBY_API_KEY` 注入, 不落盘
+- 私钥: `~/.memory-forge/pro.json`, Ed25519 格式
+- 传输: HTTPS (Shelbynet API)
+- 链上: 每条记忆 → Aptos blob upload transaction
+- 删除: tombstone blob (标记删除, 链上不可篡改)
+
+### 记忆权限
+
+- 文件系统权限 = 记忆权限 (Free)
+- 链上账户签名 = 记忆权限 (Pro)
+- 无内置认证/授权层 (Agent 已通过 Claude Code 认证)
+
+---
+
+## 错误处理与降级
+
+| 场景 | 行为 | 影响 |
+|------|------|------|
+| 嵌入模型下载失败 | 关键词搜索, 5min 重试 | 搜索精度下降, 功能可用 |
+| 嵌入模型推理失败 | 返回 null, 关键词降级 | 单次查询降级 |
+| Shelby 上传失败 | console.error, 不阻塞 | Pro 同步不同步, 本地完好 |
+| Shelby 下载超时 | 30s timeout, 返回 null | 该条不同步, 其他正常 |
+| Shelby 链上 gas 不足 | 上传失败 + 错误消息 | Pro 不可用, Free 完好 |
+| parseMemoryFile 损坏 | 跳过该文件, 返回 null | 损坏文件被忽略 |
+| 磁盘写失败 | 静默失败 | 记忆丢失 (极罕见) |
+| LRU 满 5000 | 淘汰最低 access_count × priority | 旧记忆清出内存, 磁盘保留 |

package/TUTORIAL.md

@@ -0,0 +1,353 @@
+# MemoryForge 使用教程
+
+> 一条命令。零配置。AI Agent 从此拥有持久记忆。
+
+## 目录
+
+1. [快速开始](#快速开始)
+2. [工作原理](#工作原理)
+3. [日常使用](#日常使用)
+4. [Pro 版 (云同步)](#pro-版-云同步)
+5. [管理记忆](#管理记忆)
+6. [最佳实践](#最佳实践)
+7. [排错指南](#排错指南)
+8. [卸载](#卸载)
+
+---
+
+## 快速开始
+
+### 安装
+
+```bash
+npx memory-forge setup
+```
+
+一步完成:
+- 安装 Claude Code hooks (SessionStart / Stop / PreCompact)
+- 自动导入已有规则 (CLAUDE.md / .cursor/rules / .gitconfig)
+- 预加载嵌入模型 (23MB, 首次, 后续离线)
+- 全局安装 `memory-forge` 命令
+
+**支持平台:** Claude Code (全平台), Cursor (通过 MCP), Windsurf, VS Code。
+
+### 验证安装
+
+重启 Claude Code，你会看到:
+
+```
+- [Git User Info] Git user email: xxx
+- [Claude Code Rules] For independent parallel tasks...
+```
+
+这表示 SessionStart hook 已生效，Agent 加载了你的记忆。
+
+---
+
+## 工作原理
+
+### 自动化记忆生命周期
+
+```
+你打开 Claude Code
+  → Agent 自动加载你的偏好和项目上下文
+  
+你工作...
+  → Agent 自动记住你的编码风格、技术决策、项目偏好
+  
+上下文快满时 (PreCompact)
+  → Agent 自动保存关键信息到记忆库
+  → 即使你强制关终端，记忆也不会丢失
+
+你关闭 Claude Code (Stop)
+  → 自动更新记忆优先级 (常用记忆提高权重)
+  → 自动归档 90 天未用的旧记忆
+
+下次打开
+  → Agent 又什么都记得 ✅
+```
+
+### 你什么都不用做
+
+Agent 自动:
+- **存储**: 你提到偏好、决策、教训 → Agent 调 `memory_store`
+- **搜索**: 需要回忆之前的事 → Agent 调 `memory_search`
+- **维护**: 优先级调整、过期清理 → 自动
+
+---
+
+## 日常使用
+
+### 基本交互
+
+```
+你: "我偏好 camelCase 命名，单引号，2 空格缩进"
+
+Agent 自动调 memory_store → 记忆保存 ✅
+下次写代码，Agent 自动遵循你的偏好。
+
+---
+
+你: "之前那个 token 刷新 bug 怎么修的？"
+
+Agent 调 memory_search → 找到相关记忆
+"6 月 15 日，你在 auth.ts 修了 token 过期判断从 < 改为 <="
+
+---
+
+你: "帮我重构认证模块"
+
+Agent 调 memory_context → 加载上下文
+"好的。根据之前的记录，项目用 React 19 + JWT + refresh token 模式。从 auth.ts 开始？"
+```
+
+### 主动使用
+
+你也可以明确让 Agent 操作记忆:
+
+```
+"存储一条记忆: 生产数据库用 PostgreSQL 16，连接串在 .env.production"
+"搜索关于部署流程的记忆"
+"列出我所有的记忆"
+"导出全部记忆为 Markdown"
+"删除 ID 为 xxx 的旧记忆"
+```
+
+---
+
+## Pro 版 (云同步)
+
+### 什么情况需要 Pro
+
+- 你有多台电脑，想在设备间共享记忆
+- 你担心硬盘故障丢失记忆
+- 你想和队友共享项目记忆
+
+### 开通 Pro
+
+```bash
+# 1. 获取 API Key
+# 访问 https://docs.shelby.xyz/sdks/typescript/acquire-api-keys
+
+# 2. 激活 Pro
+SHELBY_API_KEY="your-api-key" memory-forge pro
+
+# 3. 第一次需要充值 APT + ShelbyUSD (测试网水龙头)
+# 地址会打印在屏幕上，去 faucet 领取:
+#   APT:       https://docs.shelby.xyz/apis/faucet/aptos
+#   ShelbyUSD: https://docs.shelby.xyz/apis/faucet/shelbyusd
+
+# 4. 领取后重新运行同步
+SHELBY_API_KEY="your-api-key" memory-forge pro
+```
+
+### 多设备同步
+
+```
+设备 A: 激活 Pro → 工作 → 记忆自动上传
+设备 B: 设置 SHELBY_API_KEY 环境变量 → 安装 → 记忆自动下载
+  → Agent 在设备 B 上也能记住一切 ✅
+```
+
+### 环境变量
+
+建议写入 shell 配置文件:
+
+```bash
+# ~/.bashrc 或 ~/.zshrc
+export SHELBY_API_KEY="your-api-key"
+```
+
+这样每次 Agent 启动自动启用 Pro 同步，无需手动运行命令。
+
+---
+
+## 管理记忆
+
+### 查看记忆
+
+```bash
+# 查看记忆文件
+ls ~/.memory-forge/memories/
+
+# 读某条记忆
+cat ~/.memory-forge/memories/{id}.md
+```
+
+记忆文件是人类可读的 Markdown，可以直接编辑。
+
+### 导出
+
+```
+# Agent 方式
+"导出全部记忆为 JSON"
+"导出关于认证的记忆为 Markdown"
+
+# 命令行方式
+# JSON 导出在 Agent 调用 memory_export 后获取
+```
+
+### 备份
+
+```bash
+# 本地备份 (Free 层)
+cp -r ~/.memory-forge/memories/ ~/backup/
+
+# Pro 层自动备份到 Shelby 云
+```
+
+### 清理
+
+```bash
+# 删除全部本地记忆
+rm -rf ~/.memory-forge/memories/*.md
+
+# 删除单条
+rm ~/.memory-forge/memories/{id}.md
+
+# Pro 账户重置
+rm ~/.memory-forge/pro.json
+```
+
+---
+
+## 最佳实践
+
+### 什么值得记
+
+| 值得记 | 不值得记 |
+|--------|---------|
+| 编码风格偏好 | 单次 debug 过程 |
+| 项目架构决策 | 临时实验代码 |
+| 团队约定 | 过时的配置 |
+| 常用命令和流程 | 纯事实性知识 |
+| 踩过的坑和解决方案 | 一次性任务 |
+
+### 记忆质量
+
+```
+✅ 好: "项目用 PostgreSQL 16 + Prisma ORM，连接池上限 20"
+❌ 差: "数据库是 pg"
+
+✅ 好: "用户偏好 camelCase，单引号，2 空格，React 19 + TypeScript strict"
+❌ 差: "用 camelCase"
+
+✅ 好: "6/26 决定用 Redis 缓存 token，因为 DB 查询太慢 (>500ms)"
+❌ 差: "用了 Redis"
+```
+
+### 定期维护
+
+每月做一次记忆清理:
+
+```
+"查看我所有记忆，标记哪些过时了或不再需要"
+"删除 3 个月前关于旧项目的记忆"
+```
+
+---
+
+## 排错指南
+
+### Hook 不生效
+
+**症状:** 打开 Claude Code 看不到记忆加载。
+
+**解决:**
+```bash
+# 1. 检查 hook 配置
+memory-forge hook session-start
+
+# 2. 重新安装 hooks
+memory-forge setup
+
+# 3. 确认 settings.json
+cat ~/.claude/settings.json | grep memory-forge
+
+# 4. 重启 Claude Code
+```
+
+### Stop hook 报错
+
+**症状:** 关闭时显示 "Stop hook error"。
+
+```bash
+# 确认全局安装
+npm ls -g memory-forge
+
+# 如果不是最新版
+npm i -g memory-forge@latest
+
+# 检查 hook 命令格式
+# settings.json 中应该是 "memory-forge hook stop"，不是 "npx memory-forge hook stop"
+```
+
+### 记忆搜索不准确
+
+**症状:** memory_search 返回无关结果。
+
+```bash
+# 检查嵌入模型是否下载成功
+# 如果看到 "[MemoryForge] Falling back to keyword matching"
+# → 模型下载失败，使用关键词模式
+
+# 解决: 等待 5 分钟自动重试，或手动触发重试
+# 模型大小 23MB，确保网络正常
+```
+
+### Pro 同步失败
+
+**症状:** "Shelby upload failed: INSUFFICIENT_BALANCE_FOR_TRANSACTION_FEE"
+
+```bash
+# 检查账户余额
+# 去 faucet 领取 APT + ShelbyUSD
+# 然后重新运行 pro 命令
+
+SHELBY_API_KEY="your-key" memory-forge pro
+```
+
+### 重复记忆
+
+**症状:** memory_list 显示重复的相似记忆。
+
+```bash
+# 0.1.6+ 已根因修复。如果仍有:
+# 1. 升级到最新版
+npm i -g memory-forge@latest
+memory-forge setup
+
+# 2. 手动清理
+# 删除 ~/.memory-forge/memories/ 中的重复 .md 文件
+```
+
+### 完全重置
+
+```bash
+# 1. 删记忆
+rm -rf ~/.memory-forge/memories/*.md
+
+# 2. 删 Pro 账户 (可选)
+rm -f ~/.memory-forge/pro.json
+
+# 3. 清除 hooks
+# 编辑 ~/.claude/settings.json, 删除含 "memory-forge" 的条目
+
+# 4. 重装
+memory-forge setup
+```
+
+---
+
+## 卸载
+
+```bash
+# 删除所有本地数据
+rm -rf ~/.memory-forge/
+
+# 编辑 ~/.claude/settings.json
+# 删除 hooks 中包含 "memory-forge" 的所有条目
+
+# 卸载全局命令
+npm uninstall -g memory-forge
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-forge",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Forge persistent memories for your AI agent. 8 MCP tools + 5 auto-engines. Powered by Shelby decentralized cloud.",
   "type": "module",
   "license": "MIT",
@@ -33,6 +33,8 @@
   "files": [
     "dist/",
     "README.md",
+    "TECHNICAL.md",
+    "TUTORIAL.md",
     "LICENSE"
   ],
   "scripts": {