@1memory/cli 0.2.20 → 0.2.41

package/README.md

@@ -1,13 +1,64 @@
 # @1memory/cli
 
-1memory CLI 的官方 npm 入口，使用已发布的 0.2.20 平台二进制。
+1memory 记忆 CLI（Rust 二进制分发）——跨设备跨软件统一 AI 记忆系统，端到端加密，服务器只见密文。
 
-```sh
-npm install -g @1memory/cli
+## 安装
+
+```bash
+npm i -g @1memory/cli
+1memory doctor        # 首次自动安装 BGE 模型
 1memory --help
-1memory --version
 ```
 
-启动脚本取自 https://github.com/one-memory/1memory 的 `npm/bin/cli.js`，提交 `39120eda1b28c587d10731ca70007911a9bafff9`。
+安装即得 `1memory` 命令：npm/pnpm 按平台自动装对应二进制子包。也可用 `pnpm add -g @1memory/cli`。BGE 模型由 `1memory doctor` 自动安装（国内可先设 `ONEMEMORY_MIRROR=https://hf-mirror.com`）。
+
+纯离线：`1memory keygen --pass <密码>`。要连服务器并自动同步：必须 CLI 登录——
+
+```bash
+1memory register --addr <url> --user U --pass P --super <超级密码>
+1memory login --addr <url> --user U --pass P --super <超级密码> [--secret-key A3-…]
+1memory sync
+```
+
+`ONEMEMORY_MODEL_DIR` 自定义模型目录后，后续 remember 必须设为同一路径。
+
+## 客户端引入
+
+1memory 桌面客户端安装/首次启动时，经本包装 CLI 到用户电脑：
+
+```bash
+npx @1memory/cli --version
+```
+
+客户端「账号与同步」页可检测并一键安装。
+
+## 命令面（纯记忆核心）
+
+register / login / keygen / remember / recall / list / show / forget / attach / promote / demote / tree / retitle / import / defrag / reembed / sync / status / inject
+
+CLI **可以登录**：`1memory register` / `1memory login` 写 `session.json`（addr/token），之后 `sync` 和写后自动同步才能连服务器。纯离线用 `keygen`。注入：`1memory inject --id codex|pi|…`。
+
+## 语义检索模型（BGE）
+
+CLI 语义检索用 bge-base-zh-v1.5（约 407MB ONNX，本地推理零网络）。必要文件只有 `tokenizer.json` 与 `onnx/model.onnx`。查找序：
+1. `ONEMEMORY_MODEL_DIR`（一旦设置即独占，缺失不回退）
+2. CLI 同目录 `models/bge-base-zh-v1.5/`（桌面随包）
+3. 跨平台用户数据目录（Linux `~/.local/share/yishi/…`，Windows `%LOCALAPPDATA%\yishi\…`）
+4. 旧目录 `~/.local/share/yishi/models/bge-base-zh-v1.5/`
+5. `/usr/lib/1memory/models/bge-base-zh-v1.5/`（deb 随包位）
+
+来源：Hugging Face `Xenova/bge-base-zh-v1.5`（revision `71e50dc531959f9e04ebf190ea25b00261a0a186`）。模型安装由 doctor 兜底：缺模型时跑 `1memory doctor` 自动下载安装；不会在 remember 时自动下载。
+
+```bash
+1memory doctor
+# 国内镜像（只替换下载 host）：先设环境变量
+#   ONEMEMORY_MIRROR=https://hf-mirror.com
+# 自定义目录后，remember/recall/doctor 必须：
+#   ONEMEMORY_MODEL_DIR=<同一目录>
+```
+
+无模型时 remember/recall 失败并提示跑 `1memory doctor`，不落记忆、不降级为空向量。
+
+## 仓库
 
-支持 macOS ARM64、Linux x64/ARM64、Windows x64。语义检索模型由 `doctor` 单独安装。
+https://github.com/one-memory/1memory

package/bin/cli.js

@@ -4,20 +4,25 @@
 const { spawnSync } = require('child_process');
 
 const PKGS = {
-  'linux-x64': '@fslong520/1memory-cli-linux-x64',
-  'linux-arm64': '@fslong520/1memory-cli-linux-arm64',
-  'darwin-x64': '@fslong520/1memory-cli-darwin-x64',
-  'darwin-arm64': '@fslong520/1memory-cli-darwin-arm64',
-  'win32-x64': '@fslong520/1memory-cli-win32-x64',
-  'win32-arm64': '@fslong520/1memory-cli-win32-arm64',
-  'linux-arm': '@fslong520/1memory-cli-linux-arm',
-  'linux-loong64': '@fslong520/1memory-cli-linux-loong64',
+  'linux-x64': '@1memory/cli-linux-x64',
+  'linux-arm64': '@1memory/cli-linux-arm64',
+  'darwin-arm64': '@1memory/cli-darwin-arm64',
+  'win32-x64': '@1memory/cli-win32-x64',
+  'win32-arm64': '@1memory/cli-win32-arm64',
 };
 
 const key = `${process.platform}-${process.arch}`;
 const pkg = PKGS[key];
 if (!pkg) {
-  console.error(`1memory: 暂不支持平台 ${key}（支持：${Object.keys(PKGS).join(' ')}）`);
+  if (key === 'darwin-x64') {
+    console.error(
+      '1memory: 不再支持 Intel 芯片的 Mac。\n' +
+      '  请使用 Apple 芯片（arm64）的 Mac，或 Linux / Windows。\n' +
+      '  详见 https://github.com/one-memory/1memory#平台支持'
+    );
+  } else {
+    console.error(`1memory: 暂不支持平台 ${key}（支持：${Object.keys(PKGS).join(' ')}）`);
+  }
   process.exit(1);
 }
 

package/package.json

@@ -1,26 +1,27 @@
 {
   "name": "@1memory/cli",
-  "version": "0.2.20",
-  "description": "1memory CLI — 跨设备跨软件统一 AI 记忆系统",
+  "version": "0.2.41",
+  "description": "1memory 记忆 CLI — 跨设备跨软件统一 AI 记忆系统（纯记忆核心，二进制分发）",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/one-memory/1memory.git"
   },
   "bin": {
-    "1memory": "bin/cli.js"
+    "1memory": "./bin/cli.js"
   },
   "files": [
-    "bin/cli.js",
+    "bin",
     "README.md"
   ],
   "engines": {
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@fslong520/1memory-cli-linux-x64": "0.2.20",
-    "@fslong520/1memory-cli-win32-x64": "0.2.20",
-    "@fslong520/1memory-cli-linux-arm64": "0.2.20",
-    "@fslong520/1memory-cli-darwin-arm64": "0.2.20"
+    "@1memory/cli-linux-x64": "0.2.41",
+    "@1memory/cli-linux-arm64": "0.2.41",
+    "@1memory/cli-darwin-arm64": "0.2.41",
+    "@1memory/cli-win32-x64": "0.2.41",
+    "@1memory/cli-win32-arm64": "0.2.41"
   }
 }