独白匣 V1.5.0

软件测试

Android 的大模型角色聊天应用：

主要界面

Tab说明角色角色卡片列表、搜索与按标签筛选、新建/编辑角色回忆按角色汇总最近一条消息；进入某角色后为对话页配置大模型 API 地址、密钥、模型、温度、最大 Token设置个人资料、聊天显示、记忆条数、备份恢复、检查更新 / 网盘手动更新、深色模式等进入某一角色的对话页时底部导航会隐藏；在 「回忆」列表（未进入具体对话）时底部导航保持显示。

已实现功能角色

网格展示角色卡片（头像、名称、标签等）

新建 / 编辑角色：名称、头像（相册或随机色块）、标签、角色描述（长文）、主开场白、长期记忆开关

删除角色（含该角色全部聊天记录）

搜索：按名称、标签、描述过滤

筛选：按一个或多个标签多选筛选

回忆与对话

回忆页：各角色最近一条消息预览，支持搜索；长按菜单可清空该角色回忆或删除角色

对话页：与当前角色流式聊天；用户气泡 / 助手气泡，助手回复支持 Markdown（流式结束后渲染）；长按消息可复制或删除单条

主开场白：无历史消息时自动插入角色配置的开场白，不会再自动请求模型生成第二条

占位符：发送与展示时替换 {{user}}、{{persona}}、{{char}} 及常见别名，以及 {{date}}、{{time}} 等时间占位（见 UserPromptPlaceholders）

清空当前角色对话 / 清空全部回忆

左上角返回退出对话

API 配置

Base URL（自动补全 https:// 与末尾 /）

API Key、模型名、温度、最大 Token；修改后自动保存

API Key 支持显示 / 隐藏；可跳转硅基流动注册页获取 Key

根据模型名推荐默认 max_tokens（可再手动改）

流式请求（SSE）；失败时常见 HTTP 状态有中文提示

网络不可用、超时、域名解析失败等错误提示

长期记忆

按角色可选开启；后台调用同一套 API 将历史对话摘要为结构化 Markdown

聊天请求时以 system 消息注入 【长期记忆】；清空或删除角色时同步清除本地记忆文件

全量备份 ZIP 时包含 memories/ 目录，恢复后可继续使用

设置与个人资料

用户头像、显示名、人设（参与占位符替换）

深色 / 浅色模式

聊天是否显示双方头像

带入上下文的历史消息条数（0–10 条）

聊天背景图（选择 / 清除）

备份与恢复（ZIP 格式版本 3）：全部角色、头像文件、已开启角色的长期记忆、用户名/人设/用户头像，以及 API 配置（Base URL、API Key、模型、温度、最大 Token）；Android 10+ 保存到 Download/ChatBot/，较低版本写入存储根目录 ChatBot/Backups

检查更新：拉取 app/update.json，支持可选更新与强制最低版本；下载安装需「安装未知应用」权限

网盘手动更新：跳转夸克网盘分享页下载 APK（链接可在 update.json 的 manualUpdateUrl 配置，亦内置默认地址）

其它

本地 Room 数据库持久化角色与消息

启动时自动检查更新（强制更新立即提示；可选更新 24 小时内最多提示一次）

Release 构建开启 R8 压缩与资源收缩；Debug 下可选 HTTP 日志

未捕获异常写入应用私有目录 last_crash.txt

开源地址：https://github.com/Squemadylan/TalkChatBot

下载链接：https://github.com/Squemadylan/TalkChatBot/releases/download/v1.5.0-debug/debug.apk

沐雨57

思路很清晰，逻辑上也能自洽。

闻笛半盏

这种一手经验的分享比二手转述有价值多了。（补充第11点）

秋刀小筑

内容挺扎实的，不是那种拼凑出来的。

沉默长夏

这个案例很有代表性，能说明不少问题。希望能再展开讲讲某个细节。

闲云

这个角度之前没想过，记下来了。（补充第18点）

竹里浅夏

感谢整理，这类总结省了别人很多时间。有没有后续？想蹲一个更新。

听风62

这个角度之前没想过，记下来了。有遇到类似情况的吗？想听听别人的做法。

一苇

这篇值得慢慢看，我准备再读第二遍。（补充第3点）

慢半拍笔记

楼主说得挺实在，比那些空谈概念的强。期待后续的补充。