Repository navigation
Releases
v2.3.0
三个平台的安装包(文件名带应用名 + 版本 + 平台):
Android 包(
ZRemoteX-v<版本>-android.apk):使用仓库配置的发布密钥签名,可直接安装;
若仓库未配置KEYSTORE_BASE64,则回退 debug 签名,可能无法覆盖本机已安装的正式签名版。iOS 包(
ZRemoteX-v<版本>-ios-unsigned.ipa,若存在)为未签名包,无法直接安装。
请使用 AltStore / Sideloadly / TrollStore 等工具,
用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。
若本次 Release 无 iOS 资产,是 macOS 运行器容量不足导致 iOS 构建取消(非代码问题),后续发行会补上。鸿蒙包(
ZRemoteX-v<版本>-ohos.hap):华为应用包,双 ABI(arm64 真机 + x86_64 模拟器)合体,使用发布证书 + 发布 Profile 签名。
用于 AGC 上架 / 内测分发;普通用户需通过应用市场/内测链接安装(鸿蒙 NEXT 不支持随意侧载)。若 secrets 未配齐则为未签名包,真机不可装。
Full Changelog: v2.2.1...v2.3.0
v2.2.1
三个平台的安装包(文件名带应用名 + 版本 + 平台):
Android 包(
ZRemoteX-v<版本>-android.apk):使用仓库配置的发布密钥签名,可直接安装;
若仓库未配置KEYSTORE_BASE64,则回退 debug 签名,可能无法覆盖本机已安装的正式签名版。iOS 包(
ZRemoteX-v<版本>-ios-unsigned.ipa,若存在)为未签名包,无法直接安装。
请使用 AltStore / Sideloadly / TrollStore 等工具,
用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。
若本次 Release 无 iOS 资产,是 macOS 运行器容量不足导致 iOS 构建取消(非代码问题),后续发行会补上。鸿蒙包(
ZRemoteX-v<版本>-ohos.hap):华为应用包,双 ABI(arm64 真机 + x86_64 模拟器)合体,使用发布证书 + 发布 Profile 签名。
用于 AGC 上架 / 内测分发;普通用户需通过应用市场/内测链接安装(鸿蒙 NEXT 不支持随意侧载)。若 secrets 未配齐则为未签名包,真机不可装。
Full Changelog: v2.2.0...v2.2.1
v2.2.0
三个平台的安装包(文件名带应用名 + 版本 + 平台):
Android 包(
ZRemoteX-v<版本>-android.apk):使用仓库配置的发布密钥签名,可直接安装;
若仓库未配置KEYSTORE_BASE64,则回退 debug 签名,可能无法覆盖本机已安装的正式签名版。iOS 包(
ZRemoteX-v<版本>-ios-unsigned.ipa,若存在)为未签名包,无法直接安装。
请使用 AltStore / Sideloadly / TrollStore 等工具,
用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。
若本次 Release 无 iOS 资产,是 macOS 运行器容量不足导致 iOS 构建取消(非代码问题),后续发行会补上。鸿蒙包(
ZRemoteX-v<版本>-ohos.app):华为应用包,双 ABI(arm64 真机 + x86_64 模拟器)合体,使用发布证书 + 发布 Profile 签名。
用于 AGC 上架 / 内测分发;普通用户需通过应用市场/内测链接安装(鸿蒙 NEXT 不支持随意侧载)。若 secrets 未配齐则为未签名包,真机不可装。
Full Changelog: v2.1.1...v2.2.0
v2.1.1
三个平台的安装包(文件名带应用名 + 版本 + 平台):
Android 包(
ZRemoteX-v<版本>-android.apk):使用仓库配置的发布密钥签名,可直接安装;
若仓库未配置KEYSTORE_BASE64,则回退 debug 签名,可能无法覆盖本机已安装的正式签名版。iOS 包(
ZRemoteX-v<版本>-ios-unsigned.ipa)为未签名包,无法直接安装。
请使用 AltStore / Sideloadly / TrollStore 等工具,
用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。鸿蒙包为未签名包:
ZRemoteX-v<版本>-ohos-arm64.hap用于真机(arm64),ZRemoteX-v<版本>-ohos-x64.hap用于模拟器(x86_64);均需使用华为签名证书签名后安装。
Full Changelog: v2.1.0...v2.1.1
v2.0.3
更新内容
V2.0.3:改名 ZRemoteX + 登录体验
- 应用改名 ZRemoteX:Android 启动器、iOS 显示名、应用内标题 / 关于页 / 设置页脚 / 锁屏与生物识别文案、拓扑图与左栏品牌全部改为
ZRemoteX;设置页在「官方开源仓库」下新增「当前仓库」入口(尊重原作者,区分上游与本分支) - 登录入口补齐:设备列表顶栏
+的导入弹层与底部「接入新设备」卡片各新增「登录账号」入口;顶栏+改为 0 设备也显示,有设备时也无需绕道会话页即可登录 - 从账户添加设备后登录态自动跟上:进入会话页自动检测「已绑定账号 + 缺登录票」并注入、重载一次,无需再去账号库手动「应用」;按「设备 id + 账号 id」防循环(换绑重新自检、解绑清键)
- 会话页销毁兜底:
dispose内改用缓存 notifier,修掉页面销毁时ref.read抛错 - README 演示图补全:中英双份重构为完整功能说明,演示图扩为 21 张真机截图(登录方式 / 账户选设备 / 账号库 / 权益领取 / 自动化 / 模型设置 / 桌面设置 / 诊断 / 扫码 / 0 设备空态 / 会话页等),OLED 纯黑、敏感信息已打码
升级说明
- 本版本 Android 包名仍为
cn.song.zremote,可与上游pjpv/zremote正式签名包同机共存;深链zrsong://import(兼容旧zremote://import)。- 发布资产文件名带应用名与版本:Android
ZRemoteX-v2.0.3-android.apk、iOSZRemoteX-v2.0.3-ios-unsigned.ipa(便于与上游 ZRemote 区分)。- iOS 包为未签名包,无法直接安装。请使用 AltStore / Sideloadly / TrollStore 等工具,用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。
v2.0.2
更新内容
V2.0.2:修复 + 增强(11 项修复,4 项新增)
- 设置页「连接诊断」点击没反应 已修:根因是「先发请求再关页面」,Riverpod 3 同步派发把刚压栈的诊断页又弹掉了;现先关页面再发请求,并加未消费降级提示
- 「检查更新」有动作无结果 已修:数据源指向上游旧仓库(v1.7.0)导致永远「无更新」,改回本仓;结果分「已是最新 / 有新版本 / 检查失败(六类原因)」三态并给 SnackBar 提示与重试
- 资产浏览「记忆」显示「响应形状不识别」 已修(归一化按真实契约形态);自动化表单「工作区」不再显示整条路径,改显示工作区名
- 「新任务默认权限模式」显示英文枚举 已修,改中文(变更前确认 / 自主模式 / 计划 / 完全访问)
- 额度中心「重置卡」显示「加载失败」 已修:三个重置卡 RPC 补齐账号访问参数;无可用套餐时改为隐藏而非报错
- 展开「剩余部分」后内容出屏幕 已修:自动化「展开运行」、工具箱「更多」展开后自动滚入可视区;设备切换弹层设备多时也可滚动
- 0 设备也能登录:设备列表空态与设置页新增「登录账号」入口,登录不再依赖已有设备;登录后可一键「导入账户设备」
- 账户设备导入解绑:账号保险库 / 从账户添加设备在 0 设备下可达可用(自动选全局活跃账号,可切换)
- 额度消耗预警(新增):阈值默认 80%(设置页可调)+ 耗尽档;额度中心顶部预警条(80% 黄 / 95% 红 / 耗尽红 +「去领取」)、系统通知(点击直达额度中心、动作直达领取页)、迟滞 5 点 + 同档 6h 去重;未配置/无凭据/加载失败不预警
- Git 概览增强(新增):详情页三来源分段(未暂存/已暂存/分支对比)带计数、
+新增/-删除统计;全屏 unified diff(行号、增删着色、按 hunk 折叠,大文件降级原始 patch) - Android 包名迁移:
applicationId改为cn.song.zremote,可与上游pjpv/zremote正式签名包同机共存;自定义深链 scheme 改为zrsong://import(解析兼容旧zremote://import) - 设置页仓库入口:区分「官方开源仓库」(上游
pjpv/zremote,尊重原作者)与「当前仓库」;README 同步补项目地址与 fork 说明
升级说明
- 本版本起 Android 包名为
cn.song.zremote:与上游包同机安装时互不覆盖;若要替代上游,请先卸载上游(账号数据因签名/密钥不同无法直接搬移,可用账号库导出.zsb再导入)。- 深链:
zrsong://import?...(旧zremote://import仍可解析)。- iOS 包
zremote-ios-unsigned.ipa为未签名包,无法直接安装。请使用 AltStore / Sideloadly / TrollStore 等工具,用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。
v2.0.1
更新内容
V2.0.1 修复版:登录页 · 额度/套餐 · 福利中心 · 权益中心 · 资产浏览 · Git
- 登录页不再"一直加载中":修复授权页 URL 在 WebView 创建前被静默丢弃(页面从未真正加载)的问题——新增待载 URL 队列并在视图就绪后补载;同时补齐加载失败、超时(授权有效期)、渲染进程消亡与"页面未渲染"空白探测的明确提示,并可一键改用弹窗登录
- 额度中心:宿主返回"未配置/未登录"不再被误报为「额度数据加载失败」,改为明确的引导空态;额度查询改为携带账号访问参数(原先只传开关项),账号已配置时直接显示真实额度
- 模型设置 · 套餐连接:修正账号访问参数构造(字段不全时降级而不是一律失败),「套餐信息获取失败」不再出现;未配置与真实错误分别给出可读文案
- 福利中心恢复登录态:接上账号供票(原先零注入),并补充页面所需的
zcodeBridge登录态桥;已用真实账号包验证页面显示为已登录 - 权益中心不再"点一次就变灰":把「服务可用」与「有无券可领」拆成两个状态——没有券只影响角标,入口保持可点;服务能力在设备转在线 / 打开工具箱 / 错误恢复时自动复查
- 资产浏览可用:Skills / Subagents / MCP / Hooks 不再因缺少工作区路径而整页报错(进入会话前显示占位),工作区路径改从宿主页面读取并随会话变化自动刷新
- Git 概览可点:点击打开只读 Git 详情页(分支 / ahead-behind / 改动文件分组 / 本地分支,点文件查看 diff),失败原因(无会话 / 非仓库 / 加载失败)直接显示
- 质量:本地 1072 例测试全绿;模拟器真机回归 7 项全通过(登录加载、额度、套餐、权益中心、资产、Git、福利中心登录态)
升级说明
- iOS 包
zremote-ios-unsigned.ipa为未签名包,无法直接安装。请使用 AltStore / Sideloadly / TrollStore 等工具,用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。- Android 包若系统拦截「未知来源」,请允许安装来自该来源的应用。
v2.0.0
更新内容
V2.0 大版本:账密登录 · 工具箱增强 · 活动自动领取 · 设置丰富 · 交互优化
- 登录与账号:应用内登录入口(Z.ai 中国 / Z.ai 全球 / BigModel 三选,内嵌官方登录页,浏览器同款账密 / 手机号 / 微信登录方式);账号保险库支持多账号保存 / 切换 / 应用到设备 / 同身份去重;
.zsb加密互导与桌面 zcode-switch 兼容 - 额度中心:多套餐分组(档位徽章 / 窗口条 / 各模型余额 / 重置倒计时),宿主快照 + 直连双通路,失败可一键切换
- 福利中心:官方 rewards 页内嵌(登录态注入、外链拦截、主题跟随)
- 活动自动领取:开关默认关;开启后每 10 分钟检查、单轮最多连领 5 个、服务端冷却精确读取、静默时段、手动优先让位、领取历史时间线与结果通知
- 原生审批:审批通知「批准 / 拒绝」动作按钮 + 会话卡「停止」(失败回退页面操作)
- 工具箱增强:桌面设置遥控(消息流显示思考 / TODO、任务自动归档等)、Git 概览卡、Skills/Commands/Subagents/MCP/Hooks/Memory 资产浏览、工具箱分组 + 搜索 + 折叠 + 待办徽章
- 深链导入:
https://zcode.z.ai/remote*App Links 与zremote://importscheme(白名单校验) - 设置丰富:通知细分 + 免打扰时段 + 每设备覆盖、数据管理(分设备清缓存 / 日志导出脱敏)、字号 / 动效 / 触感 / OLED 纯黑主题、默认权限模式记忆、启动恢复策略、软上限、自动锁定延时、更新检查、关于页
- 交互优化:设备卡长按菜单、会话面板搜索过滤、骨架屏 / 空态统一、≥600dp 宽屏双栏、触感动效统一、通知直达会话定位、无障碍 Semantics 补全
- 质量:本地 1005 例测试全绿;CI 双 job(Android check + iOS 构建巡检)绿;诊断面扩容(41 项方法探针实机全过);自动化运行历史轮询差量化
升级说明
- iOS 包
zremote-ios-unsigned.ipa为未签名包,无法直接安装。请使用 AltStore / Sideloadly / TrollStore 等工具,用自己的 Apple ID 签名后侧载(免费账号 7 天需重新签名)。- Android 包若系统拦截「未知来源」,请允许安装来自该来源的应用。