语言：简体中文（当前） | English
QwenPaw Android 是基于 QwenPaw 服务端协议开发的原生安卓客户端。它连接用户自己的 QwenPaw 服务，提供移动端对话、工作区管理和常用配置入口。客户端不包含 QwenPaw 服务端；首次使用时需要填写自己的服务器地址和账号。
支持 Android 8.0（API 26）及以上。应用包名为 cn.qwenpaw.android.open。
公开版 1.1.0：GitHub Releases（含已签名 APK），Zealot 下载镜像。APK SHA-256：bc01462b753a2e3f0b4390892895e06eb244dc4c1186e567e1be1e777be8235d；签名证书 SHA-256：5c978fe946796168109911577c3b5ecb85ca4aa947039324dcf203e10615c7ee。
**服务端兼容性：**1.1.0 以 QwenPaw v2.2.2-beta.3 为适配目标。其他 QwenPaw 版本的接口和功能兼容性不作保证，详见 版本兼容说明。
| 范围 | 已实现功能 |
|---|---|
| 连接与账号 | 自定义 HTTPS 服务器地址、登录、令牌安全保存、个人资料、修改密码；不预置账号或业务服务器。 |
| 多账户 | 保存多个账户并随时切换，可连接不同的 QwenPaw 实例。每个账户的服务器地址、登录令牌、智能体选择、上次对话和本地草稿相互独立；可为单个账户选择加密记住密码，登录过期后自动重新登录。 |
| 对话 | SSE 流式回复、停止生成、重连、历史会话搜索与管理、置顶、归档、重命名、删除、对话内搜索、复制和 Markdown 导出。 |
| 模型与智能体 | 切换工作区与模型；按服务端声明显示思考选项；查看和调整智能体运行配置。 |
| 工具与命令 | 严格、智能、自动、关闭四种工具审批模式；审批操作、工具过程折叠、Loop 与命令面板。 |
| 技能与文件 | 浏览技能及技能池、查看 Markdown 正文、管理配置；选择上传文件，预览或保存对话附件。 |
| 用量 | 查看当前上下文占用、Token 用量和会话缓存命中率；支持压缩上下文。 |
| 应用升级 | 可配置 Zealot 升级源与只读通道；检查版本、下载 APK，并校验 SHA-256、包名和签名后交由系统确认安装。 |
界面使用原生 Android 控件，支持 Markdown、表格、代码块和内置 Mermaid 图表。聊天文件的文本预览由用户主动打开；视频和 HTML 交给系统应用处理。
截图由项目维护者提供，使用示例界面展示功能。
| 连接与个人中心 | 对话与模型 |
|---|---|
 |
 |
 |
 |
| 命令与技能 | 配置与用量 |
|---|---|
 |
 |
 |
 |
 |
安装公开版 APK 后，先填写 QwenPaw 服务地址并登录。服务器应提供与本客户端兼容的 QwenPaw API；某些能力取决于服务端版本和账号权限。升级通道在正式发布时由发布配置注入。自行从源码构建且未设置通道时，应用不会自动检查更新。
用 Android Studio 打开仓库，配置 Android SDK 35，使用 JDK 17 或 21。命令行可执行：
.\gradlew.bat :app:assembleDebug
.\gradlew.bat :app:testDebugUnitTest :app:lintDebug可通过 Gradle 属性 appEdition、appUpdateOrigin、appUpdateChannel、appDefaultServer 分别指定版本、升级源、只读通道和默认连接地址。公开源码默认升级源为 https://app.gzsuy.vip，默认连接地址与升级通道均为空。签名材料和发布令牌由仓库外的发布配置提供，不应提交到源码仓库。
本仓库是独立的安卓客户端，基于 QwenPaw 的接口与交互实现。QwenPaw 项目使用 Apache-2.0；本仓库原创代码采用 0BSD。复用的第三方资源分别遵循其原有许可，详见 第三方声明 与 third_party 目录。
本项目是个人爱好项目，客户端原创代码和文档全程由 GPT-6 编写，后续也会使用 AI 更新。维护者不保证及时跟进 QwenPaw 新版本或处理问题；有兴趣的开发者可以 Fork 后自行维护，也欢迎提交 Pull Request。