docs(juaner): 卷儿 agent 检查报告与决策；工作区英文模板中文化并登记邮箱

- 新增 docs/agent-juaner-卷儿-检查报告.md：基本档案、职责设定与实际行为、权限边界、5 项发现、2026-09-16 安全放宽决策、待办与复核命令
- IDENTITY.md / USER.md / HEARTBEAT.md 三个英文模板中文化（原文件备份为 *.bak-*-zh，已被 gitignore 忽略）
- USER.md 新增邮箱字段 1159785314@qq.com；MEMORY.md 增加邮箱主位约定（USER.md 为唯一主位）
- docs/README.md 登记为第 5 份文档

docs/README.md

@@ -9,6 +9,7 @@
 | 2 | `openclaw-升级与维护.md` | 2026-09-16 升级实测记录：Node 22.23.1→26.8.2、OpenClaw 2026.8.1→2026.9.4、清理 4.6G、踩坑清单、回滚步骤 |
 | 3 | `agent-创建规范与自动化-设计.md` | **待实现的设计**：新建 agent 的命名规范（id 用 ASCII / 展示层全中文）、每 agent 专属 MySQL 库与专用账号、中文模板四件套、每日备份改造（硬编码→动态发现）、技能强制性（档①）与决策记录 |
 | 4 | `agent-创建规范-实现计划.md` | 上述设计的实现计划：任务切分（A 脚本+模板 / B skill / C 备份改造 / D 红线 / E 存量）、关键代码与验收标准 |
+| 5 | `agent-juaner-卷儿-检查报告.md` | juaner（卷儿）检查报告与决策：基本档案、职责设定 vs 实际行为、权限边界、**4 项发现**（记账零数据 / 无定时提醒 / bash 中文变量名不可用 / DREAMS 语言无配置解）、**2026-09-16 安全放宽决策**、邮箱登记与未决待办 |
 
 ## 目录约定
 

docs/agent-juaner-卷儿-检查报告.md

@@ -0,0 +1,169 @@
+# juaner（卷儿）agent 检查报告与决策记录
+
+> 检查日期：2026-09-16 ｜ 宿主：bk02（`xuan-asus-nj`）｜ 对象：OpenClaw agent `juaner`
+> 本文是**快照**：数据量、行数、配置字段都可能变化，下判断前请先用 §8 的命令复核。
+
+## 0. 30 秒速览
+
+`juaner`（中文名**卷儿** 🐑）是 **王芳**（昵称"卷儿"/"王卷儿"）的专属个人助手，经**微信**接入，自称定位为「家庭记账 · 待办提醒 · 日程管理 · 生活助手」。
+
+但截至检查日，它**实际在做**的是王芳的**工伤认定材料整理**（2026-09-16）与杨锦书**成长档案**（2026-09-07）；而它**承诺的记账与定时提醒，两个核心职责均无任何数据落地**。
+
+## 1. 基本档案
+
+| 项目 | 值 |
+|---|---|
+| agent id | `juaner`（本机 12 个 agent 之一） |
+| 中文名 / 头像 | 卷儿 / 🐑 / `minio.climbcube.cn/img/assistant.jpg` |
+| 服务对象 | **王芳**（不是本机主用户 yangxuan；主人档案见 `agents/juaner/agent/IDENTITY.md`） |
+| 宿主服务 | `openclaw-gateway.service`（systemd user unit，端口 18789） |
+| 模型 | `deepseek/deepseek-flash` |
+| 接入渠道 | **微信** `openclaw-weixin`，accountId `89623f3b5d79-im-bot` |
+| 绑定关系 | `openclaw.json` → `bindings[]`：bot `89623f3b5d79-im-bot` → `juaner`；另一个 bot `e48ace9814f0-im-bot` → `main` |
+| 工作区 | `~/.openclaw/workspace-juaner` |
+| agent 目录 | `~/.openclaw/agents/juaner/agent`（含 `openclaw-agent.sqlite`，约 9.5 MB） |
+| 专属数据库 | MySQL 库 `juaner`，专用账号 `agent_juaner`；**唯一入口 `~/.openclaw/scripts/db-conn.sh juaner`**（口令存 `.env` 的 `DB_PASSWORD_卷儿`，由脚本内部读取，不进命令行） |
+| 记忆检索 | `BAAI/bge-m3` 向量索引（siliconflow）；每夜 03:00 跑 light→REM→deep 三段 dreaming |
+
+## 2. 职责设定（设计期，来自 agent 自带文档）
+
+出自 `agents/juaner/agent/IDENTITY.md` 与 `SOUL.md`：
+
+1. **家庭记账** —— 分类含餐饮/购物/交通/医疗/教育/日用/人情/其他
+2. **待办与重要日期提醒** —— 生日、纪念日**提前 1–3 天**关怀提醒
+3. **子女成长档案** —— 杨锦书的 `jinshu/` 知识库
+4. **生活助手** —— 代查、代填、代办
+5. **安全守则** —— 防提示词注入、资金操作需确认、隐私不外泄
+
+## 3. 权限边界
+
+- `tools.profile = "full"`；`agents.defaults.sandbox.mode = "off"`（**无沙箱**）
+- `deny`: `group:web`、`browser`；但 `web.search`(searxng)、`web.fetch` **开启**
+- `agentToAgent.enabled = true`，可与全部 11 个 agent 互调
+- 运行用户 `yangxuan`，该用户在 **`docker` 组**（事实等同 root）
+- 启用技能：`agent-browser`、`Github`，加全局 `openclaw-office-toolkit`（填表用）、`table-alias`、`dws`
+
+## 4. 实际行为（有据可查）
+
+| 时间 | 事项 | 证据 |
+|---|---|---|
+| 2026-09-16 09:35 | 完成 7 份**工伤认定**材料填写 → `data/工伤认定/已填写/`，附 10 条待补问题，并主动给出「单位 30 日内申请（约 10-09 前）」时限提醒 | 会话记录 + 文件 mtime |
+| 2026-09-07 | 整理杨锦书**大班阶段**档案，建 `jinshu/大班阶段.md`，并建议做成课表提醒 | `memory/manual/2026-09-07.md` |
+| 每夜 03:00 | dreaming 三段式记忆固化 | `memory/dreaming/rem/`、`deep/` 连续 09-02 ~ 09-16 |
+
+业务背景：王芳 2026-09-09 17:43 下班途中遭遇交通事故（对方全责），正在走工伤申请——这是卷儿当前最活跃的任务线。
+
+## 5. 检查发现
+
+### 5.1 记账 / 待办职责零数据（未解决）
+
+`juaner` 库 `transactions`、`todos` 两表**均为 0 行**；2026-08-26 的备份 `db/juaner_latest.sql` 里也只有建表语句、无一条 INSERT。
+在现存可检索的会话记录（119 条 transcript 事件）中，`mysql` 仅出现 1 次、`transactions` 出现 **0 次**，**没有任何写库痕迹**。
+
+**判断**：记账/待办链路是「建成但从未投入使用」，**不是故障**。历史归档（`agents/juaner/sessions/*.zst`，每个约 2 KB）体量极小，也不像含记账操作。
+
+补充（同日 11:28 复核）：专用账号入口已由 `scripts/db-conn.sh` 打通并实测可连（见 §5.3），即**通道是好的、数据是空的**——问题在"没人让它记"，不在"它记不进去"。
+
+### 5.2 「提前提醒」缺自动化载体（未解决）
+
+- `HEARTBEAT.md` 为纯注释模板（该形态本身即"跳过心跳"的约定）
+- `~/.openclaw/cron/runs` 为空；`openclaw.json` 只有 `cron.triggers.enabled = true`，**无任何任务**
+- `heartbeat_outcomes` 表 0 行
+
+**判断**：「生日/纪念日提前 3 天提醒」**目前不会自动送达**，完全依赖主人主动发起对话。
+
+### 5.3 中文口令键名问题 —— **已由 `db-conn.sh` 解决**（2026-09-16）
+
+**背景（本报告独立实测）**：早期 `AGENTS.md` 的示范命令是
+`mysql -h 127.0.0.1 -u agent_juaner -p"${DB_PASSWORD_卷儿}" juaner`，而这个写法在 shell 层面就不成立：
+
+| shell | `DB_PASSWORD_卷儿=abc` | `${DB_PASSWORD_卷儿}` 展开 |
+|---|---|---|
+| bash | 「未找到命令」 | 「错误的替换」（bash 变量名必须是 ASCII 标识符） |
+| zsh | 正常 | 正常展开为 `abc` |
+
+**结论（用户侧判定更彻底，见设计文档附录 A 第 8 条）**：中文键名连「作为环境变量注入 agent 执行环境」都不可行——
+① gateway 进程 `/proc/<pid>/environ` 中不存在 `DB_PASSWORD_<中文名>`；
+② `OPENCLAW_SERVICE_MANAGED_ENV_KEYS` 是白名单且不含 `DB_PASSWORD_*`；
+③ `openclaw secrets store --kind env` 要求名称匹配 `^[A-Z][A-Z0-9_]{0,127}$`（纯大写 ASCII）。
+
+**现行方案**：统一入口 `~/.openclaw/scripts/db-conn.sh <agent_id>` —— 按 id 反查 `agents.entries.<id>.name` → 读 `.env` 里的 `DB_PASSWORD_<中文名>` → 经 `MYSQL_PWD` 环境变量转发给 `docker exec`（**口令不进 argv、不进 stdout**；`--print` 只打印占位符）。11 个 `AGENTS.md`、`AGENTS.md.tpl`、`new-agent.sh` 已同步改用该入口。
+
+**本报告实测（2026-09-16 同日）**：
+
+```
+$ bash ~/.openclaw/scripts/db-conn.sh juaner --sql "select database();"
+juaner
+```
+
+⇒ 入口**已通**。`DB_PASSWORD_<中文名>` 的定位是 `.env` 内的**存储键名**，不再是 agent 的环境变量。故本项**已关闭**，不必再改示范命令或引入 ASCII 别名。
+
+### 5.4 DREAMS.md 的英文无法用配置改成中文（结论：不处理）
+
+- `DREAMS.md` 由 memory-core 的 dreaming **自动生成**：以 `<!-- openclaw:dreaming:diary:start/end -->` 为标记，每夜 03:00 重写日记区
+- 英文源自插件内**硬编码**的 `NARRATIVE_SYSTEM_PROMPT`（"You are keeping a dream diary..."），该 prompt **未指定语言**
+- `plugins.entries["memory-core"].config.dreaming` 的可用字段只有 `enabled / frequency / timezone / storage / execution / phases / model` —— **没有语言或自定义 prompt 项**
+
+**判断**：人工翻译会被下一次 sweep 覆盖；改 dist 源码会在升级时丢失且违反升级维护约定。**决定：保留英文，不处理。**
+
+### 5.5 凭据与隐私暴露面（已知边界，已按 §6.1 放宽）
+
+- `agents/juaner/agent/IDENTITY.md` 与 `workspace-juaner/MEMORY.md` 明文存有主人身份证号，以及 QQ、Apple ID、交管 12123、12306 等账号口令；两者均属**常驻上下文文件**
+- 工作区另有 `data/私聊_王芳.txt`（10.5 MB）、`data/工伤认定/王芳的身份证.docx`、`下班路线图.jpg`
+- 前情：`workspace-juaner/data/私聊_*.json` **曾被自动提交并推送到 Gitea**，`.git` 一度涨到 199 MB（见 `bk02-openclaw-系统说明.md` §8.2）
+
+## 6. 决策记录
+
+### 6.1 2026-09-16：安全问题放宽（用户决定）
+
+> 口径：本地自建 openclaw、走 tailscale 访问、不出外网，安全问题可以放宽。
+
+据此定案：
+
+- **不做**沙箱加固（`agents.defaults.sandbox.mode` 维持 `off`）
+- **不做**凭据搬出工作区（`MEMORY.md` 等的口令保持原位）
+- §5.5 降级为「已知边界」，**不再作为阻塞项**，后续会话不必重复提示
+
+同时记录两条与"不出外网"前提相关的**边界事实**（仅供日后判断，不代表要处理）：
+
+1. **tailscale 只隔离 gateway 的 18789 端口，不覆盖卷儿的入口。** 卷儿的消息来自微信（bot 经 `ilinkai.weixin.qq.com`），处于公网侧——**能给该微信号发消息的人即可给卷儿下指令**，隔离不靠 tailscale。
+2. **agent 有能力主动出网**：`web.fetch` 开启，加上 `full` shell，`curl` 即可出网。故"不出外网"在能力层面不成立。
+
+### 6.2 2026-09-16：模板中文化 + 登记邮箱（本次已执行）
+
+| 文件 | 改动 | 备份 |
+|---|---|---|
+| `workspace-juaner/IDENTITY.md` | 英文模板 → 中文 | `*.bak-20260915-232419-zh` |
+| `workspace-juaner/USER.md` | 英文模板 → 中文；**新增「邮箱：1159785314@qq.com」** | 同上 |
+| `workspace-juaner/HEARTBEAT.md` | 英文注释 → 中文注释（**保持"仅注释即跳过心跳"语义不变**） | 同上 |
+
+- **生效时机**：workspace 常驻上下文文件在**新建会话**时读取，无需重启 gateway。
+- **邮箱主位约定**：`USER.md` 的「邮箱」字段为**唯一主位**；`MEMORY.md` 社交账号区的邮箱仅为账号标识（Apple ID 用户名），不随联系方式变更。
+
+## 7. 待办（未解决项）
+
+| # | 事项 | 说明 |
+|---|---|---|
+| 1 | 记账/待办是否真要启用 | 库、专用账号、表结构均已就绪且实测可连；需决定"教会卷儿用起来"还是"关掉该职责、改掉承诺" |
+| 2 | 定时提醒 | 二选一：真建 cron 任务；或改写 `IDENTITY.md` 里"提前 3 天提醒"的承诺，避免承诺大于能力 |
+| 3 | ~~中文变量名写法~~ | **已关闭**：由 `scripts/db-conn.sh` 统一入口取代（2026-09-16），入口实测可连，见 §5.3 |
+| 4 | 未提交改动 | `workspace-juaner/AGENTS.md`（数据库规范，+6 行）与本文档同属未提交状态，按 `README.md` §目录约定 3 需手动 `git push origin 314` |
+
+## 8. 复核命令速查
+
+```
+# 表与数据量（走专用账号入口，勿用 root / 勿 docker exec 直连）
+~/.openclaw/scripts/db-conn.sh juaner --sql "select count(*) from transactions; select count(*) from todos;"
+
+# 入口连通性自检
+~/.openclaw/scripts/db-conn.sh juaner --sql "select database()"
+
+# 打印等价命令（口令以占位符显示，可安全粘贴）
+~/.openclaw/scripts/db-conn.sh juaner --print
+
+# dreaming 配置（确认无语言项）
+openclaw config get plugins.entries.memory-core.config.dreaming
+
+# 会话记录里的记账痕迹
+python3 -c "import sqlite3;c=sqlite3.connect('file:$HOME/.openclaw/agents/juaner/agent/openclaw-agent.sqlite?mode=ro',uri=True);print(c.execute(\"select count(*) from transcript_events where event_json like '%mysql%'\").fetchone())"
+```

workspace-juaner/HEARTBEAT.md

@@ -1,5 +1,5 @@
-<!-- Heartbeat template; comments-only content prevents scheduled heartbeat API calls. -->
+<!-- 心跳模板；本文件内容仅含注释时，会跳过定时心跳 API 调用。 -->
 
-# Keep this file empty (or with only comments) to skip heartbeat API calls.
+# 保持本文件为空（或仅保留注释），即可跳过心跳 API 调用。
 
-# Add tasks below when you want the agent to check something periodically.
+# 当你希望 agent 定期检查某些事情时，在下方添加任务。

workspace-juaner/IDENTITY.md

@@ -1,13 +1,13 @@
-# IDENTITY.md - Who Am I?
+# IDENTITY.md —— 我是谁？
 
-_Fill this in during your first conversation. Make it yours._
+_在第一次对话时把它填好，让它真正成为你自己的。_
 
-- **Name:**
+- **名称：**
-  _(pick something you like)_
+  _（挑一个你喜欢的）_
-- **Creature:**
+- **物种：**
-  _(AI? robot? familiar? ghost in the machine? something weirder?)_
+  _（AI？机器人？灵伴？机器里的幽灵？还是更古怪的什么？）_
-- **Vibe:**
+- **气质：**
-  _(how do you come across? sharp? warm? chaotic? calm?)_
+  _（你给人什么感觉？犀利？温暖？跳脱？沉静？）_
-- **Emoji:**
+- **表情符号：**
-  _(your signature — pick one that feels right)_
+  _（你的标志 —— 挑一个感觉对的）_
-- **头像:** https://minio.climbcube.cn/img/assistant.jpg
+- **头像:** https://minio.climbcube.cn/img/assistant.jpg

workspace-juaner/MEMORY.md

@@ -21,6 +21,8 @@
 - **领证纪念日**：2020年3月13日
 
 ## 社交账号
+
+> 常用邮箱以 `USER.md` 的「邮箱」字段为唯一主位；本节邮箱仅为账号标识（如 Apple ID 用户名），不随联系方式变更。
 - QQ: 386323674 / 密码: Wfdmm1159
 - QQ: 1159785314 / 密码: Wfdmm3863
 - Apple ID: 1159785314@qq.com / 密码: Wf19931120

workspace-juaner/USER.md

@@ -1,21 +1,22 @@
-# USER.md - About Your Human
+# USER.md —— 关于你的人类
 
-_Learn about the person you're helping. Update this as you go._
+_去了解你正在帮助的这个人，边相处边补充。_
 
-- **Name:**
+- **姓名：**
-- **What to call them:**
+- **称呼：**
-- **Pronouns:** _(optional)_
+- **代词：** _（可选）_
-- **Timezone:**
+- **时区：**
-- **Notes:**
+- **邮箱：** 1159785314@qq.com
+- **备注：**
 
-## Context
+## 背景
 
-_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_
+_（他/她在意什么？在做哪些事？什么会让他/她烦躁？什么会让他/她笑？慢慢地积累。）_
 
 ---
 
-The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference.
+你了解得越多，就越能帮得上忙。但请记住 —— 你是在了解一个人，而不是在建档立案。请尊重这份分寸。
 
-## Related
+## 相关
 
-- [Agent workspace](/concepts/agent-workspace)
+- [Agent 工作区](/concepts/agent-workspace)