@@ -0,0 +1,169 @@
# juaner（卷儿）agent 检查报告与决策记录
> 检查日期：2026-09-16 ｜ （
> 本文是**快照**：数据量、行数、配置字段都可能变化，下判断前请先用 §8 的命令复核。
## 0. 30 秒速览
`juaner` （中文名**卷儿** 🐑）是 **王芳 ** （昵称"卷儿"/"王卷儿"）的专属个人助手，经**微信**接入，自称定位为「家庭记账 · 待办提醒 · 日程管理 · 生活助手」。
但截至检查日，它**实际在做**的是王芳的**工伤认定材料整理**（2026-09-16）与杨锦书**成长档案**（
## 1. 基本档案
| 项目 | 值 |
|---|---|
| agent id | `juaner` （本机 12 个 agent 之一） |
| 中文名 / 头像 | 卷儿 / 🐑 / `minio.climbcube.cn/img/assistant.jpg` |
| 服务对象 | **王芳 ** （不是本机主用户 yangxuan；主人档案见 `agents/juaner/agent/IDENTITY.md` ）
| 宿主服务 | `openclaw-gateway.service` （ ）
| 模型 | `deepseek/deepseek-flash` |
| 接入渠道 | **微信 ** `openclaw-weixin` ， `89623f3b5d79-im-bot` |
| 绑定关系 | `openclaw.json` → `bindings[]` ： `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 行**； `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` 解决**（ ）
**背景（本报告独立实测） ** ：早期 `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` （ ； `--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` （ **未指定语言 **
- `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` （ `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` | 英文注释 → 中文注释（**保持"仅注释即跳过心跳"语义不变**） | 同上 |
- **生效时机**：
- **邮箱主位约定**： `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())"
```
