面板一览
管理面板默认监听 http://127.0.0.1:8088，仅限本机访问。通过 SSH 端口转发或反向代理从其他设备访问的方式见首次配置。
导航结构
左侧主导航按日常高频操作与低频系统配置分为四组：
| 分组 | 页面 | 用途 |
|---|---|---|
| 运行 | 总览 | 连接与发送状态切换、今日消息与 token 统计、待处理事项、各群实时动态、运行健康 |
| 对话测试 | 基于现有群聊设置或角色草稿启动隔离试聊，全部回复仅在页面内展示，见对话测试 | |
| 群聊 | 群聊 | 按群查看现场时间线、会话回想、长期记忆、本群资料、任务与提醒、群内学习及单群设置 |
| 角色 | 编辑角色设定、说话方式与轮换风格、资料、表情、工具与技能许可，支持草稿试聊与提示词预览 | |
| 扩展 | 插件 | 从目录、Git 或 ZIP 安装插件，填写配置表单、分配使用的群、查看日志、更新或回退版本 |
| 能力 | 管理 MCP 服务、后台任务技能、网页搜索与读取服务、Docker 后台任务环境 | |
| 配置 | 模型 | 管理模型服务商连接、各用途模型绑定、向量模型、token 用量统计与每日额度上限 |
| 系统 | 设置（连接、全局权限、群聊、面板账号、数据保留、提示词、版本与更新、高级）与日志（系统日志、运行健康） |
顶栏右侧依次排列：快速跳转、发送方式徽标、平台连接状态、待处理通知与账号菜单。按下 ⌘K（macOS）或 Ctrl+K（Windows／Linux）可随时唤起快速跳转框，直接切换页面、跳转指定群聊、暂停或恢复某群聊天，或为某群切换角色。账号菜单支持切换界面外观（跟随系统／浅色／深色）、界面语言（中文／English）、重启 LenBot 与退出登录。
群聊工作台
群聊页左侧列出已接入的全部群聊和私聊，支持按名称、号码或角色筛选；点击 +（接入群聊）可从 Bot 已加入的 QQ 群列表中勾选接入，也可手动输入群号或私聊 QQ 号，保存后立即生效。
右侧为当前选中群的工作台：顶栏展示群名、人数、当前角色（点击即可切换角色）、聊天状态标签、聊天／插件模式与群开关；右上角 …（更多操作）菜单提供临时安静、开始新会话和使用本群设置试聊三项快捷操作。
工作台下设七个页签：
| 页签 | 内容 |
|---|---|
| 现场 | 群消息流与 Bot 的回合卡片，支持筛选只看回合或只看出错，右上角可查看语音转写队列与记录 |
| 会话 | 当前会话的回想摘要与实际送入模型的上下文条目，支持手动点击整理回想 |
| 记忆 | 浏览、搜索、后台整理、索引与设置五个视图，详见记忆与学习 |
| 资料 | 上传本群资料、从 QQ 群文件导入、查看分段与向量状态，详见资料检索 |
| 任务 | 任务、提醒、主动发起话题与任务空间与文件四个视图，详见后台任务 |
| 学习 | 审核与管理学到的说法、黑话、表情和回复效果，以及单群学习参数 |
| 设置 | 本群角色、参与方式、每日安静时段、每小时发言上限、主动发起话题、本群的称呼与额外要求、提醒与任务、本群启用的插件、权限、移除群聊 |
现场时间线与回合卡片
现场时间线中，群友消息居左，Bot 发言居右。每条群友消息旁带有唤醒判定图标：闪电代表唤醒了回合，月亮代表未唤醒，点击可查看唤醒渠道、原因及回复效果系数。
Bot 每执行一轮决策就生成一张回合卡片。折叠态摘要展示唤醒渠道、步数、发言条数、首句耗时、输入／输出 token 与调用的工具；展开后完整列出本轮自动召回的记忆条目，以及每一步的模型思考内容、工具参数、返回结果或错误原文。
账号与场景标识符格式
在权限名单、成员关系或提醒对象中填写身份时，统一使用带平台前缀的完整标识符：
onebot:90001 个人或 Bot 账号（平台:号码）
onebot:group:80001 QQ 群聊（平台:group:群号）
onebot:private:70001 QQ 私聊（平台:private:对方号码）设置生效时机与重启
面板中的设置按影响范围分为三类生效方式：
- 保存即生效：群开关、聊天／插件模式、唤醒档位、群聊接入、权限与额度、模型服务商与用途绑定、平台连接、MCP、网络参数、日志、数据保留、框架提示词和面板登录账号。模型新请求使用新连接，平台连接按服务重连。
- 当前回合结束时生效：编辑在用角色、为群切换角色、切换已在群内运行的长期记忆或压缩回想插件。若该群当前没有进行中的回合则立即切换；正在回复时等本轮收尾后无缝切换。
- 需要重新装配服务：面板监听地址、端口与代理信任设置，向量模型与索引绑定，记忆后端与目录、任务执行器，以及声明
reload = "host"或替换同进程已有依赖的插件。对应修改集中显示在顶栏的待重启列表。
在面板点击重启时，对话框会先列出待应用的修改项以及当前受影响的活动：进行中的群聊回合会先等待完成，执行中的后台任务会安全中断并保留工作区以便重启后按原编号续接，排队中的任务保留，进行中的试聊停止。新宿主进程就绪后自动刷新面板，登录会话保留。
框架提示词覆盖
系统 → 设置 → 提示词支持查看和覆盖 src/len_bot/prompts/ 下的框架提示词模板，保存后刷新所有群的提示词，后续模型请求使用新内容。
模板中形如 $name 的变量由宿主在运行时替换，保存前系统会校验占位符集合与默认模板完全一致；正文需要字面量 $ 时写作 $$。
自定义修改保存在实例目录的 state/prompts/ 下。升级 LenBot 版本时，默认将旧版自定义提示词移至 state/prompts/.replaced/ 并启用新版内置提示词；若开启更新 LenBot 后保留这些修改，升级后继续沿用自定义文件，并在面板中提示该文件基于哪个旧版本编写以便对照核查。