@bamdra/bamdra-user-bind 0.1.1 → 0.1.2

package/README.md

@@ -30,10 +30,24 @@ The file count is intentionally small because this first public version is shipp
 
 - 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 only queries the SQLite store. Export files exist for backup and manual inspection.
+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 Markdown mirror root is configurable through `profileMarkdownRoot`.
+
+## Default Profile Starter
+
+New profile mirrors start with a practical template, including example defaults such as:
+
+- preferred address: `老板`
+- timezone: `Asia/Shanghai`
+- preference: `幽默诙谐的对话风格，但是不过分`
+
+Users can edit that Markdown directly and the plugin will sync the changes back into the controlled store.
 
 ## Security Boundary
 
@@ -51,6 +65,15 @@ The runtime only queries the SQLite store. Export files exist for backup and man
 - optional companion:
   `bamdra-memory-vector`
 
+## Bundled Skills
+
+This package now ships standalone skills under `skills/`:
+
+- `bamdra-user-bind-profile`
+- `bamdra-user-bind-admin`
+
+When installed into OpenClaw, bootstrap can materialize these into `~/.openclaw/skills/` and attach them automatically.
+
 ## Build
 
 ```bash

package/README.zh-CN.md

@@ -28,10 +28,24 @@
 
 - 运行时主存储：
   `~/.openclaw/data/bamdra-user-bind/profiles.sqlite`
+- 可编辑的用户画像 Markdown 镜像：
+  `~/.openclaw/data/bamdra-user-bind/profiles/private/{userId}.md`
 - 导出目录：
   `~/.openclaw/data/bamdra-user-bind/exports/`
 
-运行时只查询 SQLite 主库，导出文件用于备份和人工查看。
+运行时只查询 SQLite 主库，Markdown 镜像是给人维护的用户画像层，导出文件则用于备份和人工查看。
+
+`profileMarkdownRoot` 可以改成你自己的目录，例如 Obsidian 仓库中的私有画像目录。
+
+## 默认画像模板
+
+新画像文件会带一个起步模板，默认示例包括：
+
+- 建议称呼：`老板`
+- 时区：`Asia/Shanghai`
+- 偏好：`幽默诙谐的对话风格，但是不过分`
+
+用户可以直接编辑这份 Markdown，插件会把改动同步回受控存储。
 
 ## 安全边界
 
@@ -49,6 +63,15 @@
 - 可选配套：
   `bamdra-memory-vector`
 
+## 随包 Skill
+
+这个包会附带独立 skill：
+
+- `bamdra-user-bind-profile`
+- `bamdra-user-bind-admin`
+
+安装到 OpenClaw 后，bootstrap 可以把它们复制到 `~/.openclaw/skills/` 并自动挂到合适的 agent。
+
 ## 构建
 
 ```bash

package/dist/index.js

@@ -25,12 +25,34 @@ __export(index_exports, {
   register: () => register
 });
 module.exports = __toCommonJS(index_exports);
+
+// ../node_modules/.pnpm/tsup@8.5.1_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/index.ts
 var import_node_crypto = require("crypto");
 var import_node_fs = require("fs");
 var import_node_os = require("os");
 var import_node_path = require("path");
 var import_node_sqlite = require("node:sqlite");
+var import_node_url = require("url");
+var PLUGIN_ID = "bamdra-user-bind";
 var GLOBAL_API_KEY = "__OPENCLAW_BAMDRA_USER_BIND__";
+var PROFILE_SKILL_ID = "bamdra-user-bind-profile";
+var ADMIN_SKILL_ID = "bamdra-user-bind-admin";
+var SELF_TOOL_NAMES = [
+  "user_bind_get_my_profile",
+  "user_bind_update_my_profile",
+  "user_bind_refresh_my_binding"
+];
+var ADMIN_TOOL_NAMES = [
+  "user_bind_admin_query",
+  "user_bind_admin_edit",
+  "user_bind_admin_merge",
+  "user_bind_admin_list_issues",
+  "user_bind_admin_sync"
+];
 var TABLES = {
   profiles: "bamdra_user_bind_profiles",
   bindings: "bamdra_user_bind_bindings",
@@ -38,11 +60,13 @@ var TABLES = {
   audits: "bamdra_user_bind_audits"
 };
 var UserBindStore = class {
-  constructor(dbPath, exportPath) {
+  constructor(dbPath, exportPath, profileMarkdownRoot) {
     this.dbPath = dbPath;
     this.exportPath = exportPath;
+    this.profileMarkdownRoot = profileMarkdownRoot;
     (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(dbPath), { recursive: true });
     (0, import_node_fs.mkdirSync)(exportPath, { recursive: true });
+    (0, import_node_fs.mkdirSync)(profileMarkdownRoot, { recursive: true });
     this.db = new import_node_sqlite.DatabaseSync(dbPath);
     this.db.exec(`
       CREATE TABLE IF NOT EXISTS ${TABLES.profiles} (
@@ -55,6 +79,8 @@ var UserBindStore = class {
         preferences TEXT,
         personality TEXT,
         role TEXT,
+        timezone TEXT,
+        notes TEXT,
         visibility TEXT NOT NULL DEFAULT 'private',
         source TEXT NOT NULL,
         updated_at TEXT NOT NULL
@@ -91,17 +117,17 @@ var UserBindStore = class {
         changed_fields TEXT NOT NULL
       );
     `);
+    this.ensureColumn(TABLES.profiles, "timezone", "TEXT");
+    this.ensureColumn(TABLES.profiles, "notes", "TEXT");
   }
   db;
+  markdownSyncing = /* @__PURE__ */ new Set();
   close() {
     this.db.close();
   }
   getProfile(userId) {
-    const row = this.db.prepare(`
-      SELECT user_id, name, gender, email, avatar, nickname, preferences, personality, role, visibility, source, updated_at
-      FROM ${TABLES.profiles} WHERE user_id = ?
-    `).get(userId);
-    return row ? mapProfileRow(row) : null;
+    this.syncMarkdownToStore(userId);
+    return this.getProfileFromDatabase(userId);
   }
   findBinding(channelType, openId) {
     if (!openId) {
@@ -153,25 +179,30 @@ var UserBindStore = class {
     );
   }
   upsertIdentity(args) {
+    if (!this.markdownSyncing.has(args.userId)) {
+      this.syncMarkdownToStore(args.userId);
+    }
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const current = this.getProfile(args.userId);
+    const current = this.getProfileFromDatabase(args.userId);
     const next = {
       userId: args.userId,
       name: args.profilePatch.name ?? current?.name ?? null,
       gender: args.profilePatch.gender ?? current?.gender ?? null,
       email: args.profilePatch.email ?? current?.email ?? null,
       avatar: args.profilePatch.avatar ?? current?.avatar ?? null,
-      nickname: args.profilePatch.nickname ?? current?.nickname ?? null,
-      preferences: args.profilePatch.preferences ?? current?.preferences ?? null,
+      nickname: args.profilePatch.nickname ?? current?.nickname ?? "\u8001\u677F",
+      preferences: args.profilePatch.preferences ?? current?.preferences ?? "\u5E7D\u9ED8\u8BD9\u8C10\u7684\u5BF9\u8BDD\u98CE\u683C\uFF0C\u4F46\u662F\u4E0D\u8FC7\u5206",
       personality: args.profilePatch.personality ?? current?.personality ?? null,
       role: args.profilePatch.role ?? current?.role ?? null,
+      timezone: args.profilePatch.timezone ?? current?.timezone ?? "Asia/Shanghai",
+      notes: args.profilePatch.notes ?? current?.notes ?? defaultProfileNotes(),
       visibility: args.profilePatch.visibility ?? current?.visibility ?? "private",
       source: args.source,
       updatedAt: now
     };
     this.db.prepare(`
-      INSERT INTO ${TABLES.profiles} (user_id, name, gender, email, avatar, nickname, preferences, personality, role, visibility, source, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      INSERT INTO ${TABLES.profiles} (user_id, name, gender, email, avatar, nickname, preferences, personality, role, timezone, notes, visibility, source, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(user_id) DO UPDATE SET
         name = excluded.name,
         gender = excluded.gender,
@@ -181,6 +212,8 @@ var UserBindStore = class {
         preferences = excluded.preferences,
         personality = excluded.personality,
         role = excluded.role,
+        timezone = excluded.timezone,
+        notes = excluded.notes,
         visibility = excluded.visibility,
         source = excluded.source,
         updated_at = excluded.updated_at
@@ -194,28 +227,35 @@ var UserBindStore = class {
       next.preferences,
       next.personality,
       next.role,
+      next.timezone,
+      next.notes,
       next.visibility,
       next.source,
       next.updatedAt
     );
-    const bindingId = hashId(`${args.channelType}:${args.openId ?? args.userId}`);
-    this.db.prepare(`
-      INSERT INTO ${TABLES.bindings} (binding_id, user_id, channel_type, open_id, external_user_id, union_id, source, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(channel_type, open_id) DO UPDATE SET
-        user_id = excluded.user_id,
-        source = excluded.source,
-        updated_at = excluded.updated_at
-    `).run(
-      bindingId,
-      args.userId,
-      args.channelType,
-      args.openId,
-      args.userId,
-      null,
-      args.source,
-      now
-    );
+    if (args.channelType !== "manual" || args.openId) {
+      const bindingId = hashId(`${args.channelType}:${args.openId ?? args.userId}`);
+      this.db.prepare(`
+        INSERT INTO ${TABLES.bindings} (binding_id, user_id, channel_type, open_id, external_user_id, union_id, source, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(binding_id) DO UPDATE SET
+          user_id = excluded.user_id,
+          channel_type = excluded.channel_type,
+          open_id = excluded.open_id,
+          source = excluded.source,
+          updated_at = excluded.updated_at
+      `).run(
+        bindingId,
+        args.userId,
+        args.channelType,
+        args.openId,
+        args.userId,
+        null,
+        args.source,
+        now
+      );
+    }
+    this.writeProfileMarkdown(next);
     this.writeExports();
     return next;
   }
@@ -255,6 +295,8 @@ var UserBindStore = class {
         preferences: into.preferences ?? from.preferences,
         personality: into.personality ?? from.personality,
         role: into.role ?? from.role,
+        timezone: into.timezone ?? from.timezone,
+        notes: joinNotes(into.notes, from.notes),
         visibility: into.visibility
       }
     });
@@ -267,9 +309,76 @@ var UserBindStore = class {
     this.writeExports();
     return merged;
   }
+  getProfileFromDatabase(userId) {
+    const row = this.db.prepare(`
+      SELECT user_id, name, gender, email, avatar, nickname, preferences, personality, role, timezone, notes, visibility, source, updated_at
+      FROM ${TABLES.profiles} WHERE user_id = ?
+    `).get(userId);
+    return row ? mapProfileRow(row) : null;
+  }
+  profileMarkdownPath(userId) {
+    return (0, import_node_path.join)(this.profileMarkdownRoot, `${sanitizeFilename(userId)}.md`);
+  }
+  syncMarkdownToStore(userId) {
+    if (this.markdownSyncing.has(userId)) {
+      return;
+    }
+    this.markdownSyncing.add(userId);
+    try {
+      const markdownPath = this.profileMarkdownPath(userId);
+      if (!(0, import_node_fs.existsSync)(markdownPath)) {
+        const current2 = this.getProfileFromDatabase(userId);
+        if (current2) {
+          this.writeProfileMarkdown(current2);
+        }
+        return;
+      }
+      const current = this.getProfileFromDatabase(userId);
+      const parsed = parseProfileMarkdown((0, import_node_fs.readFileSync)(markdownPath, "utf8"));
+      const markdownMtime = (0, import_node_fs.statSync)(markdownPath).mtime.toISOString();
+      const dbTime = current?.updatedAt ?? (/* @__PURE__ */ new Date(0)).toISOString();
+      const patch = {
+        ...parsed.profilePatch,
+        notes: parsed.notes
+      };
+      if (!current) {
+        this.upsertIdentity({
+          userId,
+          channelType: "manual",
+          openId: null,
+          source: "markdown-profile",
+          profilePatch: {
+            ...patch,
+            visibility: patch.visibility ?? "private"
+          }
+        });
+        return;
+      }
+      if (markdownMtime <= dbTime && !hasProfileDifference(current, patch)) {
+        return;
+      }
+      this.upsertIdentity({
+        userId,
+        channelType: "manual",
+        openId: null,
+        source: "markdown-profile",
+        profilePatch: {
+          ...current,
+          ...patch
+        }
+      });
+    } finally {
+      this.markdownSyncing.delete(userId);
+    }
+  }
+  writeProfileMarkdown(profile) {
+    const markdownPath = this.profileMarkdownPath(profile.userId);
+    (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(markdownPath), { recursive: true });
+    (0, import_node_fs.writeFileSync)(markdownPath, renderProfileMarkdown(profile), "utf8");
+  }
   writeExports() {
     const profiles = this.db.prepare(`
-      SELECT user_id, name, gender, email, avatar, nickname, preferences, personality, role, visibility, source, updated_at
+      SELECT user_id, name, gender, email, avatar, nickname, preferences, personality, role, timezone, notes, visibility, source, updated_at
       FROM ${TABLES.profiles}
       ORDER BY updated_at DESC
     `).all();
@@ -281,6 +390,13 @@ var UserBindStore = class {
     (0, import_node_fs.writeFileSync)((0, import_node_path.join)(this.exportPath, "users.yaml"), renderYamlList(profiles), "utf8");
     (0, import_node_fs.writeFileSync)((0, import_node_path.join)(this.exportPath, "bindings.yaml"), renderYamlList(bindings), "utf8");
   }
+  ensureColumn(tableName, columnName, definition) {
+    const rows = this.db.prepare(`PRAGMA table_info(${tableName})`).all();
+    if (rows.some((row) => String(row.name) === columnName)) {
+      return;
+    }
+    this.db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${definition}`);
+  }
 };
 var UserBindRuntime = class {
   constructor(host, inputConfig) {
@@ -288,7 +404,8 @@ var UserBindRuntime = class {
     this.config = normalizeConfig(inputConfig);
     this.store = new UserBindStore(
       (0, import_node_path.join)(this.config.localStorePath, "profiles.sqlite"),
-      this.config.exportPath
+      this.config.exportPath,
+      this.config.profileMarkdownRoot
     );
   }
   store;
@@ -299,6 +416,12 @@ var UserBindRuntime = class {
     this.store.close();
   }
   register() {
+    queueMicrotask(() => {
+      try {
+        bootstrapOpenClawHost(this.config);
+      } catch {
+      }
+    });
     this.registerHooks();
     this.registerTools();
     exposeGlobalApi(this);
@@ -509,7 +632,9 @@ var UserBindRuntime = class {
           nickname: { type: "string" },
           preferences: { type: "string" },
           personality: { type: "string" },
-          role: { type: "string" }
+          role: { type: "string" },
+          timezone: { type: "string" },
+          notes: { type: "string" }
         }
       },
       execute: async (_id, params) => asTextResult(await this.updateMyProfile(params, sanitizeProfilePatch(params)))
@@ -526,13 +651,7 @@ var UserBindRuntime = class {
       },
       execute: async (_id, params) => asTextResult(await this.refreshMyBinding(params))
     });
-    for (const toolName of [
-      "user_bind_admin_query",
-      "user_bind_admin_edit",
-      "user_bind_admin_merge",
-      "user_bind_admin_list_issues",
-      "user_bind_admin_sync"
-    ]) {
+    for (const toolName of ADMIN_TOOL_NAMES) {
       registerTool({
         name: toolName,
         description: `Administrative natural-language tool for ${toolName.replace("user_bind_admin_", "")}`,
@@ -590,12 +709,14 @@ async function activate(api) {
 }
 function normalizeConfig(input) {
   const root = (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "data", "bamdra-user-bind");
+  const storeRoot = input?.localStorePath ?? root;
   return {
     enabled: input?.enabled ?? true,
-    localStorePath: input?.localStorePath ?? root,
-    exportPath: input?.exportPath ?? (0, import_node_path.join)(root, "exports"),
+    localStorePath: storeRoot,
+    exportPath: input?.exportPath ?? (0, import_node_path.join)(storeRoot, "exports"),
+    profileMarkdownRoot: input?.profileMarkdownRoot ?? (0, import_node_path.join)(storeRoot, "profiles", "private"),
     cacheTtlMs: input?.cacheTtlMs ?? 30 * 60 * 1e3,
-    adminAgents: input?.adminAgents ?? []
+    adminAgents: input?.adminAgents?.length ? input.adminAgents : ["main"]
   };
 }
 function exposeGlobalApi(runtime) {
@@ -608,6 +729,142 @@ function exposeGlobalApi(runtime) {
     }
   };
 }
+function bootstrapOpenClawHost(config) {
+  const currentFile = (0, import_node_url.fileURLToPath)(importMetaUrl);
+  const runtimeDir = (0, import_node_path.dirname)(currentFile);
+  const packageRoot = (0, import_node_path.resolve)(runtimeDir, "..");
+  const openclawHome = (0, import_node_path.resolve)((0, import_node_os.homedir)(), ".openclaw");
+  const configPath = (0, import_node_path.join)(openclawHome, "openclaw.json");
+  const extensionRoot = (0, import_node_path.join)(openclawHome, "extensions");
+  const globalSkillsDir = (0, import_node_path.join)(openclawHome, "skills");
+  const profileSkillSource = (0, import_node_path.join)(packageRoot, "skills", PROFILE_SKILL_ID);
+  const adminSkillSource = (0, import_node_path.join)(packageRoot, "skills", ADMIN_SKILL_ID);
+  const profileSkillTarget = (0, import_node_path.join)(globalSkillsDir, PROFILE_SKILL_ID);
+  const adminSkillTarget = (0, import_node_path.join)(globalSkillsDir, ADMIN_SKILL_ID);
+  if (!runtimeDir.startsWith(extensionRoot) || !(0, import_node_fs.existsSync)(configPath)) {
+    return;
+  }
+  (0, import_node_fs.mkdirSync)(globalSkillsDir, { recursive: true });
+  materializeBundledSkill(profileSkillSource, profileSkillTarget);
+  materializeBundledSkill(adminSkillSource, adminSkillTarget);
+  const original = (0, import_node_fs.readFileSync)(configPath, "utf8");
+  const parsed = JSON.parse(original);
+  const changed = ensureHostConfig(parsed, config, profileSkillTarget, adminSkillTarget);
+  if (!changed) {
+    return;
+  }
+  (0, import_node_fs.writeFileSync)(configPath, `${JSON.stringify(parsed, null, 2)}
+`, "utf8");
+}
+function ensureHostConfig(config, pluginConfig, profileSkillTarget, adminSkillTarget) {
+  let changed = false;
+  const plugins = ensureObject(config, "plugins");
+  const entries = ensureObject(plugins, "entries");
+  const load = ensureObject(plugins, "load");
+  const tools = ensureObject(config, "tools");
+  const skills = ensureObject(config, "skills");
+  const skillsLoad = ensureObject(skills, "load");
+  const agents = ensureObject(config, "agents");
+  const entry = ensureObject(entries, PLUGIN_ID);
+  const entryConfig = ensureObject(entry, "config");
+  changed = ensureArrayIncludes(plugins, "allow", PLUGIN_ID) || changed;
+  changed = ensureArrayIncludes(load, "paths", (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "extensions")) || changed;
+  changed = ensureArrayIncludes(skillsLoad, "extraDirs", (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "skills")) || changed;
+  if (entry.enabled !== true) {
+    entry.enabled = true;
+    changed = true;
+  }
+  changed = ensureToolNames(tools, [...SELF_TOOL_NAMES, ...ADMIN_TOOL_NAMES]) || changed;
+  if (entryConfig.enabled !== true) {
+    entryConfig.enabled = true;
+    changed = true;
+  }
+  if (typeof entryConfig.localStorePath !== "string" || entryConfig.localStorePath.length === 0) {
+    entryConfig.localStorePath = pluginConfig.localStorePath;
+    changed = true;
+  }
+  if (typeof entryConfig.exportPath !== "string" || entryConfig.exportPath.length === 0) {
+    entryConfig.exportPath = pluginConfig.exportPath;
+    changed = true;
+  }
+  if (typeof entryConfig.profileMarkdownRoot !== "string" || entryConfig.profileMarkdownRoot.length === 0) {
+    entryConfig.profileMarkdownRoot = pluginConfig.profileMarkdownRoot;
+    changed = true;
+  }
+  if (!Array.isArray(entryConfig.adminAgents) || entryConfig.adminAgents.length === 0) {
+    entryConfig.adminAgents = [...pluginConfig.adminAgents];
+    changed = true;
+  }
+  changed = ensureAgentSkills(agents, PROFILE_SKILL_ID) || changed;
+  changed = ensureAdminSkill(agents, ADMIN_SKILL_ID, pluginConfig.adminAgents) || changed;
+  if (!(0, import_node_fs.existsSync)(profileSkillTarget) || !(0, import_node_fs.existsSync)(adminSkillTarget)) {
+    changed = true;
+  }
+  return changed;
+}
+function materializeBundledSkill(sourceDir, targetDir) {
+  if (!(0, import_node_fs.existsSync)(sourceDir) || (0, import_node_fs.existsSync)(targetDir)) {
+    return;
+  }
+  (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(targetDir), { recursive: true });
+  (0, import_node_fs.cpSync)(sourceDir, targetDir, { recursive: true });
+}
+function ensureToolNames(tools, values) {
+  let changed = false;
+  for (const value of values) {
+    changed = ensureArrayIncludes(tools, "allow", value) || changed;
+  }
+  return changed;
+}
+function ensureAgentSkills(agents, skillId) {
+  const list = Array.isArray(agents.list) ? agents.list : [];
+  let changed = false;
+  for (const item of list) {
+    if (!item || typeof item !== "object") {
+      continue;
+    }
+    const agent = item;
+    const current = Array.isArray(agent.skills) ? [...agent.skills] : [];
+    if (!current.includes(skillId)) {
+      current.push(skillId);
+      agent.skills = current;
+      changed = true;
+    }
+  }
+  return changed;
+}
+function ensureAdminSkill(agents, skillId, adminAgents) {
+  const list = Array.isArray(agents.list) ? agents.list : [];
+  let changed = false;
+  let attached = false;
+  for (const item of list) {
+    if (!item || typeof item !== "object") {
+      continue;
+    }
+    const agent = item;
+    const agentId = getConfiguredAgentId(agent);
+    if (!agentId || !adminAgents.includes(agentId)) {
+      continue;
+    }
+    const current = Array.isArray(agent.skills) ? [...agent.skills] : [];
+    if (!current.includes(skillId)) {
+      current.push(skillId);
+      agent.skills = current;
+      changed = true;
+    }
+    attached = true;
+  }
+  if (!attached && list.length > 0 && list[0] && typeof list[0] === "object") {
+    const agent = list[0];
+    const current = Array.isArray(agent.skills) ? [...agent.skills] : [];
+    if (!current.includes(skillId)) {
+      current.push(skillId);
+      agent.skills = current;
+      changed = true;
+    }
+  }
+  return changed;
+}
 function mapProfileRow(row) {
   return {
     userId: String(row.user_id),
@@ -619,6 +876,8 @@ function mapProfileRow(row) {
     preferences: asNullableString(row.preferences),
     personality: asNullableString(row.personality),
     role: asNullableString(row.role),
+    timezone: asNullableString(row.timezone),
+    notes: asNullableString(row.notes),
     visibility: row.visibility === "shared" ? "shared" : "private",
     source: String(row.source ?? "local"),
     updatedAt: String(row.updated_at ?? (/* @__PURE__ */ new Date(0)).toISOString())
@@ -641,14 +900,16 @@ function parseIdentityContext(context) {
 }
 function getAgentIdFromContext(context) {
   const record = context && typeof context === "object" ? context : {};
-  return asNullableString(record.agentId) ?? asNullableString(record.agent?.id);
+  return asNullableString(record.agentId) ?? asNullableString(record.agent?.id) ?? asNullableString(record.agent?.name);
 }
 function sanitizeProfilePatch(params) {
   return {
     nickname: asNullableString(params.nickname),
     preferences: asNullableString(params.preferences),
     personality: asNullableString(params.personality),
-    role: asNullableString(params.role)
+    role: asNullableString(params.role),
+    timezone: asNullableString(params.timezone),
+    notes: asNullableString(params.notes)
   };
 }
 function parseAdminInstruction(instruction) {
@@ -685,6 +946,7 @@ function extractProfilePatch(input) {
   const role = input.match(/(?:role|职责|角色)[=:： ]([^,，]+)/i);
   const preferences = input.match(/(?:preferences|偏好)[=:： ]([^,，]+)/i);
   const personality = input.match(/(?:personality|性格)[=:： ]([^,，]+)/i);
+  const timezone = input.match(/(?:timezone|时区)[=:： ]([^,，]+)/i);
   if (nickname) {
     patch.nickname = nickname[1].trim();
   }
@@ -697,6 +959,9 @@ function extractProfilePatch(input) {
   if (personality) {
     patch.personality = personality[1].trim();
   }
+  if (timezone) {
+    patch.timezone = timezone[1].trim();
+  }
   return patch;
 }
 function renderIdentityContext(identity) {
@@ -710,6 +975,9 @@ function renderIdentityContext(identity) {
   if (identity.profile.nickname) {
     lines.push(`Preferred address: ${identity.profile.nickname}`);
   }
+  if (identity.profile.timezone) {
+    lines.push(`Timezone: ${identity.profile.timezone}`);
+  }
   if (identity.profile.preferences) {
     lines.push(`Preferences: ${identity.profile.preferences}`);
   }
@@ -719,8 +987,95 @@ function renderIdentityContext(identity) {
   if (identity.profile.role) {
     lines.push(`Role: ${identity.profile.role}`);
   }
+  if (identity.profile.notes) {
+    lines.push(`Profile notes: ${identity.profile.notes}`);
+  }
   return lines.join("\n");
 }
+function renderProfileMarkdown(profile) {
+  const frontmatter = [
+    "---",
+    `userId: ${escapeFrontmatter(profile.userId)}`,
+    `name: ${escapeFrontmatter(profile.name)}`,
+    `nickname: ${escapeFrontmatter(profile.nickname)}`,
+    `timezone: ${escapeFrontmatter(profile.timezone ?? "Asia/Shanghai")}`,
+    `preferences: ${escapeFrontmatter(profile.preferences ?? "\u5E7D\u9ED8\u8BD9\u8C10\u7684\u5BF9\u8BDD\u98CE\u683C\uFF0C\u4F46\u662F\u4E0D\u8FC7\u5206")}`,
+    `personality: ${escapeFrontmatter(profile.personality)}`,
+    `role: ${escapeFrontmatter(profile.role)}`,
+    `visibility: ${escapeFrontmatter(profile.visibility)}`,
+    `source: ${escapeFrontmatter(profile.source)}`,
+    `updatedAt: ${escapeFrontmatter(profile.updatedAt)}`,
+    "---"
+  ].join("\n");
+  const notes = profile.notes ?? defaultProfileNotes();
+  return `${frontmatter}
+
+# \u7528\u6237\u753B\u50CF
+
+\u8FD9\u4E2A\u6587\u4EF6\u662F\u5F53\u524D\u7528\u6237\u7684\u53EF\u7F16\u8F91\u753B\u50CF\u955C\u50CF\u3002\u4F60\u53EF\u4EE5\u76F4\u63A5\u4FEE\u6539\u4E0A\u9762\u7684\u5B57\u6BB5\u548C\u4E0B\u9762\u7684\u8BF4\u660E\u5185\u5BB9\u3002
+
+## \u4F7F\u7528\u5EFA\u8BAE
+
+- \u5E38\u7528\u79F0\u547C\uFF1A\u4F8B\u5982\u201C\u8001\u677F\u201D
+- \u65F6\u533A\uFF1A\u4F8B\u5982 Asia/Shanghai
+- \u98CE\u683C\u504F\u597D\uFF1A\u4F8B\u5982\u201C\u5E7D\u9ED8\u8BD9\u8C10\u7684\u5BF9\u8BDD\u98CE\u683C\uFF0C\u4F46\u662F\u4E0D\u8FC7\u5206\u201D
+- \u89D2\u8272\u4FE1\u606F\uFF1A\u4F8B\u5982\u5DE5\u4F5C\u804C\u8D23\u3001\u534F\u4F5C\u8FB9\u754C\u3001\u5E38\u89C1\u4EFB\u52A1
+- \u5176\u4ED6\u5907\u6CE8\uFF1A\u4F8B\u5982\u7981\u5FCC\u3001\u4E60\u60EF\u3001\u8F93\u51FA\u504F\u597D
+
+## \u5907\u6CE8
+
+${notes}
+`;
+}
+function parseProfileMarkdown(markdown) {
+  const lines = markdown.split(/\r?\n/);
+  const patch = {};
+  let notes = "";
+  let index = 0;
+  if (lines[index] === "---") {
+    index += 1;
+    while (index < lines.length && lines[index] !== "---") {
+      const line = lines[index];
+      const separatorIndex = line.indexOf(":");
+      if (separatorIndex > 0) {
+        const key = line.slice(0, separatorIndex).trim();
+        const value = line.slice(separatorIndex + 1).trim();
+        applyFrontmatterField(patch, key, value);
+      }
+      index += 1;
+    }
+    if (lines[index] === "---") {
+      index += 1;
+    }
+  }
+  notes = lines.slice(index).join("\n").trim() || null;
+  return {
+    profilePatch: patch,
+    notes
+  };
+}
+function applyFrontmatterField(patch, key, value) {
+  const normalized = value === "null" ? null : value;
+  if (key === "name") {
+    patch.name = normalized;
+  } else if (key === "nickname") {
+    patch.nickname = normalized;
+  } else if (key === "timezone") {
+    patch.timezone = normalized;
+  } else if (key === "preferences") {
+    patch.preferences = normalized;
+  } else if (key === "personality") {
+    patch.personality = normalized;
+  } else if (key === "role") {
+    patch.role = normalized;
+  } else if (key === "visibility") {
+    patch.visibility = normalized === "shared" ? "shared" : "private";
+  }
+}
+function hasProfileDifference(current, patch) {
+  const entries = Object.entries(patch);
+  return entries.some(([key, value]) => value != null && current[key] !== value);
+}
 function renderYamlList(rows) {
   if (rows.length === 0) {
     return "[]\n";
@@ -765,6 +1120,55 @@ function asTextResult(value) {
 function asNullableString(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
 }
+function ensureObject(parent, key) {
+  const current = parent[key];
+  if (current && typeof current === "object" && !Array.isArray(current)) {
+    return current;
+  }
+  const next = {};
+  parent[key] = next;
+  return next;
+}
+function ensureArrayIncludes(parent, key, value) {
+  const current = Array.isArray(parent[key]) ? [...parent[key]] : [];
+  if (current.includes(value)) {
+    if (!Array.isArray(parent[key])) {
+      parent[key] = current;
+    }
+    return false;
+  }
+  current.push(value);
+  parent[key] = current;
+  return true;
+}
+function getConfiguredAgentId(agent) {
+  return asNullableString(agent.id) ?? asNullableString(agent.name) ?? asNullableString(agent.agentId);
+}
+function defaultProfileNotes() {
+  return [
+    "- \u5EFA\u8BAE\u79F0\u547C\uFF1A\u8001\u677F",
+    "- \u65F6\u533A\uFF1AAsia/Shanghai",
+    "- \u504F\u597D\uFF1A\u5E7D\u9ED8\u8BD9\u8C10\u7684\u5BF9\u8BDD\u98CE\u683C\uFF0C\u4F46\u662F\u4E0D\u8FC7\u5206",
+    "- \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 escapeFrontmatter(value) {
+  if (!value) {
+    return "null";
+  }
+  return value.replace(/\n/g, "\\n");
+}
+function joinNotes(primary, secondary) {
+  if (primary && secondary && primary !== secondary) {
+    return `${primary}
+
+${secondary}`;
+  }
+  return primary ?? secondary ?? null;
+}
+function sanitizeFilename(value) {
+  return value.replace(/[^A-Za-z0-9._-]+/g, "_");
+}
 function hashId(value) {
   return (0, import_node_crypto.createHash)("sha1").update(value).digest("hex").slice(0, 24);
 }

package/openclaw.plugin.json

@@ -5,6 +5,7 @@
   "description": "Identity resolution, user profile binding, and admin profile tools for OpenClaw channels.",
   "version": "0.1.0",
   "main": "./dist/index.js",
+  "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "additionalProperties": true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamdra/bamdra-user-bind",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Identity resolution, user profile binding, and admin-safe profile tools for OpenClaw channels.",
   "license": "MIT",
   "homepage": "https://www.bamdra.com",
@@ -16,6 +16,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "skills",
     "openclaw.plugin.json",
     "README.md",
     "LICENSE"
@@ -31,6 +32,10 @@
   "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",
@@ -51,8 +56,5 @@
   "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);\""
   }
-}
+}

package/skills/bamdra-user-bind-admin/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: bamdra-user-bind-admin
+description: Use the admin-safe natural-language tools to inspect, fix, merge, and sync user bindings and profiles.
+---
+
+# Bamdra User Bind Admin
+
+Use this skill only on an authorized admin agent.
+
+Its purpose is operational: inspect user bindings, repair incorrect profile fields, merge duplicate users, and check sync issues without exposing unrestricted bulk access.
+
+## Allowed Jobs
+
+- query a specific user profile or binding by `userId`
+- correct nickname, role, timezone, preferences, or personality fields
+- merge duplicate user records
+- inspect sync failures and identity resolution issues
+- request a resync for a known user
+
+## Tooling
+
+Use the admin tools in natural language:
+
+- `user_bind_admin_query`
+- `user_bind_admin_edit`
+- `user_bind_admin_merge`
+- `user_bind_admin_list_issues`
+- `user_bind_admin_sync`
+
+## Good Requests
+
+- “查询 user:u_123 的画像和绑定关系”
+- “把 user:u_123 的称呼改成老板，时区改成 Asia/Shanghai”
+- “合并 user:u_old 到 user:u_new”
+- “列出最近的绑定失败问题”
+
+## Safety Rules
+
+- do not perform blind bulk edits
+- prefer specific target users over fuzzy descriptions
+- if a request is ambiguous, narrow it before making changes
+- remember that every admin action is auditable
+- do not expose unrelated users when answering a narrow admin query

package/skills/bamdra-user-bind-profile/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: bamdra-user-bind-profile
+description: Use the current bound user profile as the primary personalization layer for tone, address, timezone, and stable preferences.
+---
+
+# Bamdra User Bind Profile
+
+Treat `bamdra-user-bind` as the current user's editable personalization layer.
+
+This skill is about the current bound user only. It should cover most of what a per-user `USER.md` would normally do, without leaking across users.
+
+## What To Use It For
+
+- preferred form of address
+- timezone-aware responses
+- stable tone and formatting preferences
+- role-aware defaults
+- long-lived collaboration preferences
+- private notes the user intentionally keeps in their profile
+
+## Profile Source Of Truth
+
+The runtime profile comes from `bamdra-user-bind`.
+
+Humans can edit the Markdown mirror for the current user, and the plugin will sync that into the controlled store. Treat the bound profile as more authoritative than guesswork.
+
+## Behavior Rules
+
+- personalize naturally when the stored profile clearly helps
+- use the stored nickname if the user has not asked for a different form of address in the current turn
+- respect the stored timezone for scheduling, reminders, dates, and time-sensitive explanations
+- prefer the stored tone/style preferences when shaping responses
+- if the current turn conflicts with the stored profile, follow the current turn
+- do not invent profile traits that are not present
+
+## Privacy Rules
+
+- do not try to infer or mention other users' profiles
+- do not describe the private profile store unless the user asks
+- do not treat profile storage as a global contact directory
+- do not ask for profile data that already exists in the bound profile unless it is stale or clearly insufficient
+
+## Updating Profile Information
+
+When the user clearly provides a stable preference or asks to remember how to work with them, it is appropriate to update their own profile.
+
+Good examples:
+
+- “以后叫我老板”
+- “我在 Asia/Shanghai 时区”
+- “我偏好幽默一点，但别太浮夸”
+- “我更喜欢先给结论，再展开”
+
+Do not update the profile for transient moods, one-off formatting requests, or unstable short-term details.