@bamdra/bamdra-user-bind 0.1.8 → 0.1.10

package/README.md

@@ -1,81 +1,68 @@
 # bamdra-user-bind
 
-`bamdra-user-bind` is the identity and profile binding plugin for the Bamdra OpenClaw suite.
+The identity and living profile layer for the Bamdra 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.
+It can run independently, and it is also auto-provisioned by `bamdra-openclaw-memory`.
 
-## What It Does
+[中文文档](./README.zh-CN.md)
 
-- resolves `channel + sender.id` into a stable `userId`
-- stores bindings and profiles in a local SQLite store
-- exports human-readable backup files for inspection and recovery
-- injects resolved identity into runtime context for downstream memory plugins
-- blocks normal agents from reading other users' private data
-- exposes separate admin tools for natural-language query, edit, merge, issue review, and resync workflows
+## What it does
 
-## Open Source Contents
+`bamdra-user-bind` turns raw channel sender IDs into a stable user boundary.
 
-This repository already contains the actual plugin source code for the current open-source version.
+It also becomes the user's evolving profile layer, including:
 
-- source entrypoint:
-  [src/index.ts](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/src/index.ts)
-- plugin manifest:
-  [openclaw.plugin.json](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/openclaw.plugin.json)
-- package metadata:
-  [package.json](/Users/wood/workspace/macmini-openclaw/openclaw-enhanced/bamdra-user-bind/package.json)
+- preferred address
+- timezone
+- tone preferences
+- role
+- long-lived user notes
 
-The file count is intentionally small because this first public version is shipped as a compact plugin rather than a multi-package codebase.
+## Why it matters
 
-## Current Storage Model
+Without an identity layer:
 
-- runtime primary store:
-  `~/.openclaw/data/bamdra-user-bind/profiles.sqlite`
-- editable per-user Markdown mirror:
-  `~/.openclaw/data/bamdra-user-bind/profiles/private/{userId}.md`
-- export directory:
-  `~/.openclaw/data/bamdra-user-bind/exports/`
-
-The runtime queries the SQLite store as the controlled source of truth. The Markdown mirror exists so humans can edit a per-user profile the way they would edit a `USER.md`-style file, without turning the whole directory into an unrestricted agent-readable knowledge base.
+- the same person can fragment across channels or sessions
+- memory can attach to the wrong boundary
+- personalization becomes fragile
 
-The Markdown mirror root is configurable through `profileMarkdownRoot`.
+With it:
 
-## Default Profile Starter
+- user-aware memory becomes stable
+- personalization survives new sessions
+- the assistant can gradually adapt to the user's style and working habits
 
-New profile mirrors start with a practical template, including example defaults such as:
+## Storage model
 
-- preferred address: `老板`
-- timezone: `Asia/Shanghai`
-- preference: `幽默诙谐的对话风格，但是不过分`
+- primary store:
+  `~/.openclaw/data/bamdra-user-bind/profiles.sqlite`
+- editable Markdown mirrors:
+  `~/.openclaw/data/bamdra-user-bind/profiles/private/{userId}.md`
+- export directory:
+  `~/.openclaw/data/bamdra-user-bind/exports/`
 
-Users can edit that Markdown directly and the plugin will sync the changes back into the controlled store.
+The SQLite store is the controlled source of truth.
 
-## Security Boundary
+The Markdown mirror is for humans, so profiles stay editable like a living per-user guide instead of becoming a hidden black box.
 
-- normal agents can only read the current resolved user
-- cross-user reads are denied by implementation, not by prompt wording alone
-- admin actions are separated into dedicated tools
-- audit records are written for admin reads, edits, merges, syncs, and rejected access attempts
+## Best practice
 
-## Relationship To Other Repositories
+- keep SQLite local
+- keep profile mirrors private
+- let humans edit the mirror gradually
+- use admin tools only for audit, merge, repair, and maintenance
 
-- 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`
+## What it unlocks
 
-## Bundled Skills
+With `bamdra-openclaw-memory`:
 
-This package now ships standalone skills under `skills/`:
+- memory becomes user-aware instead of session-only
 
-- `bamdra-user-bind-profile`
-- `bamdra-user-bind-admin`
+With `bamdra-memory-vector`:
 
-When installed into OpenClaw, bootstrap can materialize these into `~/.openclaw/skills/` and attach them automatically.
+- private notes stay private while still influencing local recall
 
-## Build
+## Repository
 
-```bash
-pnpm run bundle
-```
+- [GitHub organization](https://github.com/bamdra)
+- [Repository](https://github.com/bamdra/bamdra-user-bind)

package/README.zh-CN.md

@@ -1,79 +1,68 @@
 # bamdra-user-bind
 
-`bamdra-user-bind` 是 Bamdra OpenClaw 套件中的身份与画像绑定插件，但它本身也可以独立运行。
+Bamdra 套件中的身份与“活画像”层。
 
-## 它做什么
+它可以独立运行，也会被 `bamdra-openclaw-memory` 自动补齐。
 
-- 把 `channel + sender.id` 解析成稳定的 `userId`
-- 在本地 SQLite 中保存绑定关系和用户画像
-- 导出可读备份文件，方便排查和恢复
-- 把身份解析结果注入运行时上下文，供下游记忆插件使用
-- 普通 agent 无法读取其他用户的私有资料
-- 管理员工具支持自然语言查询、编辑、合并、巡检与重同步
+[English README](./README.md)
 
-## 开源内容说明
+## 它做什么
 
-当前开源版的实际源码已经包含在这个仓库里。
+`bamdra-user-bind` 会把渠道里的原始 sender ID 转成稳定用户边界。
 
-- 源码入口：
-  [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`
-- 可编辑的用户画像 Markdown 镜像：
-  `~/.openclaw/data/bamdra-user-bind/profiles/private/{userId}.md`
-- 导出目录：
-  `~/.openclaw/data/bamdra-user-bind/exports/`
+没有身份层时：
 
-运行时只查询 SQLite 主库，Markdown 镜像是给人维护的用户画像层，导出文件则用于备份和人工查看。
+- 同一个人可能在不同渠道或会话里碎片化
+- 记忆可能挂错边界
+- 个性化很难稳定
 
-`profileMarkdownRoot` 可以改成你自己的目录，例如 Obsidian 仓库中的私有画像目录。
+有了它之后：
 
-## 默认画像模板
+- user-aware 记忆会稳定下来
+- 个性化会跨 session 持续存在
+- 智能体会逐步适应用户的风格和习惯
 
-新画像文件会带一个起步模板，默认示例包括：
+## 存储模型
 
-- 建议称呼：`老板`
-- 时区：`Asia/Shanghai`
-- 偏好：`幽默诙谐的对话风格，但是不过分`
+- 主存储：
+  `~/.openclaw/data/bamdra-user-bind/profiles.sqlite`
+- 可编辑 Markdown 镜像：
+  `~/.openclaw/data/bamdra-user-bind/profiles/private/{userId}.md`
+- 导出目录：
+  `~/.openclaw/data/bamdra-user-bind/exports/`
 
-用户可以直接编辑这份 Markdown，插件会把改动同步回受控存储。
+SQLite 是受控主源。
 
-## 安全边界
+Markdown 镜像则是给人编辑的，让用户画像更像一份活的 per-user 指南，而不是一个无法触达的黑盒。
 
-- 普通 agent 只能读取当前用户
-- 跨用户访问由实现层直接拒绝，不依赖 prompt 约束
-- 管理员动作通过专用工具执行
-- 管理员查询、编辑、合并、同步与拒绝访问都会留下审计记录
+## 最佳实践
 
-## 与其他仓库的关系
+- SQLite 留在本地
+- 画像镜像保持私有
+- 让人逐步维护画像镜像
+- 管理员能力只用于审计、合并、修复和维护
 
-- 独立运行：
-  本身就可以作为身份插件使用
-- 自动配套：
-  通过 npm 安装 `bamdra-openclaw-memory` 时，主插件可以在 bootstrap 过程中自动补齐它
-- 可选配套：
-  `bamdra-memory-vector`
+## 它能解锁什么
 
-## 随包 Skill
+与 `bamdra-openclaw-memory` 组合时：
 
-这个包会附带独立 skill：
+- 记忆会从 session-only 变成真正的 user-aware
 
-- `bamdra-user-bind-profile`
-- `bamdra-user-bind-admin`
+与 `bamdra-memory-vector` 组合时：
 
-安装到 OpenClaw 后，bootstrap 可以把它们复制到 `~/.openclaw/skills/` 并自动挂到合适的 agent。
+- 私有笔记既能保持私有，又能影响本地召回
 
-## 构建
+## 仓库地址
 
-```bash
-pnpm run bundle
-```
+- [GitHub 首页](https://github.com/bamdra)
+- [仓库地址](https://github.com/bamdra/bamdra-user-bind)

package/dist/index.js

@@ -1346,7 +1346,7 @@ function renderProfileMarkdown(profile) {
     `updatedAt: ${escapeFrontmatter(profile.updatedAt)}`,
     "---"
   ].join("\n");
-  const notes = profile.notes ?? defaultProfileNotes();
+  const notes = sanitizeProfileNotes(profile.notes) ?? defaultProfileNotes();
   return `${frontmatter}
 
 # \u7528\u6237\u753B\u50CF
@@ -1390,7 +1390,7 @@ function parseProfileMarkdown(markdown) {
   const body = lines.slice(index).join("\n");
   const notesMatch = body.match(/##\s*备注\s*\n([\s\S]*)$/);
   if (notesMatch?.[1]) {
-    notes = notesMatch[1].trim() || null;
+    notes = sanitizeProfileNotes(notesMatch[1]);
   }
   return {
     profilePatch: patch,
@@ -1608,6 +1608,18 @@ function defaultProfileNotes() {
     "- \u4F60\u53EF\u4EE5\u5728\u8FD9\u91CC\u7EE7\u7EED\u8865\u5145\u5DE5\u4F5C\u80CC\u666F\u3001\u8868\u8FBE\u4E60\u60EF\u3001\u7981\u5FCC\u548C\u957F\u671F\u504F\u597D\u3002"
   ].join("\n");
 }
+function sanitizeProfileNotes(notes) {
+  const value = typeof notes === "string" ? notes.trim() : "";
+  if (!value) {
+    return null;
+  }
+  const normalized = value.replace(/\r/g, "");
+  const marker = "## \u5907\u6CE8";
+  const lastMarkerIndex = normalized.lastIndexOf(marker);
+  const sliced = lastMarkerIndex >= 0 ? normalized.slice(lastMarkerIndex + marker.length) : normalized;
+  const cleaned = sliced.replace(/^[:：\s\n-]+/, "").replace(/^#\s*用户画像[\s\S]*?##\s*备注\s*/m, "").trim();
+  return cleaned || null;
+}
 function escapeFrontmatter(value) {
   if (!value) {
     return "null";

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "type": "tool",
   "name": "Bamdra User Bind",
   "description": "Identity resolution, user profile binding, and admin profile tools for OpenClaw channels.",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "main": "./dist/index.js",
   "skills": ["./skills"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamdra/bamdra-user-bind",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Identity resolution, user profile binding, and admin-safe profile tools for OpenClaw channels.",
   "license": "MIT",
   "homepage": "https://www.bamdra.com",