@bamdra/bamdra-user-bind 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # bamdra-user-bind
 
-`bamdra-user-bind` is the identity and profile binding plugin for the Bamdra OpenClaw memory suite.
+`bamdra-user-bind` is the identity and profile binding plugin for the Bamdra OpenClaw suite.
 
 It resolves channel-facing sender identifiers into a stable user boundary, stores user profile data locally, supports Feishu-oriented identity resolution, and exposes admin-safe tooling for querying and editing profile records.
 
@@ -44,8 +44,10 @@ The runtime only queries the SQLite store. Export files exist for backup and man
 
 ## Relationship To Other Repositories
 
-- required by:
-  `bamdra-openclaw-memory`
+- standalone:
+  can run independently as a user identity plugin
+- auto companion:
+  `bamdra-openclaw-memory` can auto-provision it during npm-based install bootstrap
 - optional companion:
   `bamdra-memory-vector`
 

package/README.zh-CN.md

@@ -0,0 +1,56 @@
+# bamdra-user-bind
+
+`bamdra-user-bind` 是 Bamdra OpenClaw 套件中的身份与画像绑定插件，但它本身也可以独立运行。
+
+## 它做什么
+
+- 把 `channel + sender.id` 解析成稳定的 `userId`
+- 在本地 SQLite 中保存绑定关系和用户画像
+- 导出可读备份文件，方便排查和恢复
+- 把身份解析结果注入运行时上下文，供下游记忆插件使用
+- 普通 agent 无法读取其他用户的私有资料
+- 管理员工具支持自然语言查询、编辑、合并、巡检与重同步
+
+## 开源内容说明
+
+当前开源版的实际源码已经包含在这个仓库里。
+
+- 源码入口：
+  [src/index.ts](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/src/index.ts)
+- 插件清单：
+  [openclaw.plugin.json](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/openclaw.plugin.json)
+- 包元数据：
+  [package.json](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/package.json)
+
+文件数量目前比较少，是因为首个公开版本采用了紧凑单入口插件的形式，而不是多包拆分结构。
+
+## 当前存储模型
+
+- 运行时主存储：
+  `~/.openclaw/data/bamdra-user-bind/profiles.sqlite`
+- 导出目录：
+  `~/.openclaw/data/bamdra-user-bind/exports/`
+
+运行时只查询 SQLite 主库，导出文件用于备份和人工查看。
+
+## 安全边界
+
+- 普通 agent 只能读取当前用户
+- 跨用户访问由实现层直接拒绝，不依赖 prompt 约束
+- 管理员动作通过专用工具执行
+- 管理员查询、编辑、合并、同步与拒绝访问都会留下审计记录
+
+## 与其他仓库的关系
+
+- 独立运行：
+  本身就可以作为身份插件使用
+- 自动配套：
+  通过 npm 安装 `bamdra-openclaw-memory` 时，主插件可以在 bootstrap 过程中自动补齐它
+- 可选配套：
+  `bamdra-memory-vector`
+
+## 构建
+
+```bash
+pnpm run bundle
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamdra/bamdra-user-bind",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Identity resolution, user profile binding, and admin-safe profile tools for OpenClaw channels.",
   "license": "MIT",
   "homepage": "https://www.bamdra.com",
@@ -31,10 +31,6 @@
   "engines": {
     "node": ">=22"
   },
-  "scripts": {
-    "bundle": "node ../bamdra-openclaw-memory/scripts/run-local-bin.mjs tsup && node -e \"const fs=require('node:fs');const path='./dist/index.js';const text=fs.readFileSync(path,'utf8').replace(/require\\\\(\\\"sqlite\\\"\\\\)/g,'require(\\\"node:sqlite\\\")');fs.writeFileSync(path,text);\"",
-    "prepublishOnly": "pnpm run bundle"
-  },
   "openclaw": {
     "id": "bamdra-user-bind",
     "type": "tool",
@@ -55,5 +51,8 @@
   "dependencies": {},
   "devDependencies": {
     "@types/node": "^24.5.2"
+  },
+  "scripts": {
+    "bundle": "node ../bamdra-openclaw-memory/scripts/run-local-bin.mjs tsup && node -e \"const fs=require('node:fs');const path='./dist/index.js';const text=fs.readFileSync(path,'utf8').replace(/require\\\\(\\\"sqlite\\\"\\\\)/g,'require(\\\"node:sqlite\\\")');fs.writeFileSync(path,text);\""
   }
-}
+}