@yottameta/yotta-memory 0.2.1 → 0.2.3

package/README.md

@@ -20,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
@@ -47,7 +48,7 @@ bash install.sh --dir /path/to/skills
 |---|---|
 | `yotta-memory init [--project]` | 初始化记忆库（默认用户级 `~/.yottamemory/`）|
 | `yotta-memory remember <type> <subject> <statement> [--owner <id>]` | 写入记忆（同 subject+statement 自动更新；--owner 标注归属）|
-| `yotta-memory recall [关键词] [--type T] [--limit N] [--agent <id>] [--owner <id>] [--all]` | 检索记忆（索引+TF 打分，读取分区过滤；项目级优先）|
+| `yotta-memory recall [关键词] [--type T] [--limit N] [--agent <id>] [--owner <id>] [--all] [--unsafe]` | 检索记忆（索引+TF 打分，读取分区过滤；越界读其它智能体私密默认拒绝，需 grant / identity=user / `--unsafe`；项目级优先）|
 | `yotta-memory forget <文件>` | 删除一条记忆（按类型目录路径或文件名）|
 | `yotta-memory archive [--days 180] [--threshold 0.4]` | 归档旧记忆（盖棺分+年龄，immutable 除外）|
 | `yotta-memory reindex` | 重建索引（手动改 .md 后校正）|

package/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: yotta-memory
 description: "元忆 —— 有权限边界的文件式智能体记忆。文件式、零依赖、可 diff/回滚：让任何 AI 智能体活过会话，开工 recall 恢复上下文、重要信息 remember 落盘、收工归档。类型体系 FACT（公共共享）/ PREF / BOUND / COMMIT（私密隔离）。触发：记住、别忘了、记一笔、记忆、remember、recall、跨会话、上次说到、续测、交接、归档"
-version: 0.2.1
+version: 0.2.3
 license: MIT
 ---
 
 # yotta-memory（元忆）— 有权限边界的文件式智能体记忆
 
 > 一句话：元忆 —— 有权限边界的文件式智能体记忆（不注入、可 diff、能回滚；FACT 共享、PREF / BOUND / COMMIT 私密隔离）。
-> 版本：0.2.1 | 最后更新：2026-08-23
+> 版本：0.2.3 | 最后更新：2026-08-23
 
 ## 这是什么
 
@@ -37,7 +37,7 @@ license: MIT
 |---|---|
 | `yotta-memory init [--project]` | 初始化记忆库（默认用户级）|
 | `yotta-memory remember <type> <subject> <statement> [--owner <id>]` | 写入（同 subject+statement 自动更新；--owner 标注归属，默认取 agent id）|
-| `yotta-memory recall [关键词] [--type T] [--limit N] [--agent <id>] [--owner <id>] [--all]` | 检索（索引+TF 打分，读取分区过滤；项目级优先）|
+| `yotta-memory recall [关键词] [--type T] [--limit N] [--agent <id>] [--owner <id>] [--all] [--unsafe]` | 检索（索引+TF 打分，读取分区过滤；越界读其它智能体私密默认拒绝，需 grant / identity=user / `--unsafe`；项目级优先）|
 | `yotta-memory forget <文件>` | 删除（按类型目录路径或文件名）|
 | `yotta-memory archive [--days 180] [--threshold 0.4]` | 归档旧记忆（盖棺分+年龄，immutable 除外）|
 | `yotta-memory reindex` | 重建索引（手动改 .md 后校正）|