@yottameta/yotta-memory 0.2.0 → 0.2.2

package/README.md

@@ -1,13 +1,14 @@
-# yotta-memory
+# 元忆（yotta-memory）
 
-> 文件式跨智能体记忆协议与零依赖读写工具：让任何 AI 智能体活过会话。
+> 元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff / 回滚；FACT 共享、PREF / BOUND / COMMIT 私密隔离——谁该读、谁不该读，由机制而非 AI 自觉决定。
 
 ## 这是什么
 
 - **文件式记忆标准**：记忆 = Markdown + YAML frontmatter 文件，git 可版本化，任何智能体可读，数据主权在用户本地。
 - **零依赖**：无 daemon / 无数据库 / 无向量库，Node.js 自带即可运行。
 - **类型体系**：FACT（事实，公共共享）/ PREF（偏好）/ BOUND（边界）/ COMMIT（承诺）——后三者私密、per-agent 隔离。
-- **双级存储**：用户级 `~/.yottamemory/` + 项目级 `.yottamemory/`。
+- **双级存储**：用户级 ~/.yottamemory/ + 项目级 .yottamemory/。
+- **有权限边界**：FACT 进公共区共享；PREF / BOUND / COMMIT 进私密区、按 agent 隔离；读取按 scope/owner 分区，默认只返当前 agent 可读项。
 
 适用场景：跨会话续测、个人偏好与边界沉淀、多智能体协作、项目交接、收工归档。
 
@@ -19,18 +20,19 @@
 ```bash
 npx skills add YottaMeta/yotta-memory
 ```
-> 自动安装到已检测到的智能体（Claude Code / Codex / Cursor / OpenCode 等 78+ 智能体）。
+> 自动把技能文件装到已检测到的智能体（Claude Code / Codex / Cursor / OpenCode 等 78+ 智能体）。此方式只装「技能指令」（SKILL.md 等）；要使用 `yotta-memory` 读写命令，需另装 CLI：`npm install -g @yottameta/yotta-memory`（见方式二）。
 
 ### 方式二：npm 直接安装（CLI + 技能）
 ```bash
 # 国内加速（可选）：npm config set registry https://registry.npmmirror.com
 npm install -g @yottameta/yotta-memory
 yotta-memory init            # 初始化记忆库
-# 若要把技能文件装进某个智能体的 skills 目录：
-npx -y @yottameta/yotta-memory-install -g
-npx -y @yottameta/yotta-memory-install --agent codex
+yotta-memory-install -g                  # 装进所有已识别智能体（用户级）
+yotta-memory-install --agent codex       # 只装进指定智能体
 ```
 
+> 全局安装后 `yotta-memory`（读写下）与 `yotta-memory-install`（安装器）两个命令均已加入 PATH。若不想全局安装，可一行运行安装器：`npx -y --package @yottameta/yotta-memory yotta-memory-install -g`。
+
 ### 方式三：install.sh / 手动复制
 获取技能文件夹后（`npm pack` 解包或 `git clone`），进入技能文件夹：
 ```bash

package/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: yotta-memory
-description: "文件式跨智能体记忆协议与零依赖读写工具。让任何 AI 智能体活过会话：开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档"
-version: 0.2.0
+description: "元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/回滚：让任何 AI 智能体活过会话，开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档"
+version: 0.2.2
 license: MIT
 ---
 
-# yotta-memory — 文件式跨智能体记忆
+# yotta-memory（元忆）— 有权限边界的文件式智能体记忆
 
-> 一句话：定义记忆协议 + 提供零依赖读写 CLI，让任何 AI 智能体活过会话。
-> 版本：0.2.0 | 最后更新：2026-08-23
+> 一句话：元忆 —— 有权限边界的文件式智能体记忆（不注入、可 diff、能回滚；FACT 共享、PREF / BOUND / COMMIT 私密隔离）。
+> 版本：0.2.2 | 最后更新：2026-08-23
 
 ## 这是什么
 

package/bin/yotta-memory.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// yotta-memory: 文件式跨智能体记忆 CLI（零依赖）v0.2
+// yotta-memory（元忆）: 有权限边界的文件式智能体记忆 CLI（零依赖）
 // v0.2 增强：① index.json 索引+TF 打分 ② 质量分+盖棺分（access_count/last_accessed）③ 读取分区（scope/owner）
 'use strict';
 
@@ -7,7 +7,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const VERSION = '0.2.0';
+const VERSION = '0.2.2';
 const TYPES = ['FACT', 'PREF', 'BOUND', 'COMMIT'];
 const TYPE_DIRS = { FACT: 'facts', PREF: 'prefs', BOUND: 'bounds', COMMIT: 'commits' };
 const ARCHIVE_DIR = '.archive';
@@ -110,7 +110,7 @@ function ensureInit(root) {
   fs.mkdirSync(path.join(root, ARCHIVE_DIR), { recursive: true });
   const readme = path.join(root, 'README.md');
   if (!fs.existsSync(readme)) {
-    fs.writeFileSync(readme, '# yotta-memory 记忆库\n\n文件式跨智能体记忆协议存储目录。结构：facts/ prefs/ bounds/ commits/ .archive/。\n', 'utf8');
+    fs.writeFileSync(readme, '# yotta-memory（元忆）记忆库\n\n有权限边界的文件式智能体记忆存储目录。结构：facts/ prefs/ bounds/ commits/ .archive/。\n', 'utf8');
   }
 }
 function nextSeq(dir) {
@@ -501,7 +501,7 @@ function cmdImport(src) {
 
 function usage() {
   console.log([
-    'yotta-memory v' + VERSION + ' — 文件式跨智能体记忆（v0.2）',
+    'yotta-memory v' + VERSION + ' — 元忆：有权限边界的文件式智能体记忆',
     '',
     '用法:',
     '  yotta-memory init [--project]             初始化记忆库（默认用户级 ~/.yottamemory）',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yottameta/yotta-memory",
-  "version": "0.2.0",
-  "description": "文件式跨智能体记忆协议与零依赖读写工具：让任何 AI 智能体活过会话（FACT/PREF/BOUND/COMMIT 四分类，用户级+项目级双级存储）。",
+  "version": "0.2.2",
+  "description": "元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/回滚；FACT/PREF/BOUND/COMMIT 四分类（公共共享/私密隔离），用户级+项目级双级存储。",
   "license": "MIT",
   "keywords": [
     "agent-skills",