更新日志（Changelog）
Nekoloc（前身 NodeLoc APP）—— NodeLoc 第三方开源猫咪主题客户端的全部版本变更记录。
各版本安装包与详细说明见 Releases。
[v1.3.7] — 2026-10-05 · Google Play 更新渠道
新功能：按安装来源选择更新方式
- Google Play 更新：从 Play 商店安装的 Android 客户端，点击“检查更新”打开对应商店页面，由 Play 提供公开测试或正式版更新
- 来源识别：读取 Android 的安装来源；Play 安装版本停止检查 GitHub Release，避免提示下载不同签名的 APK
- 其他渠道：从 GitHub 下载的 APK 及桌面端继续使用原有 GitHub 更新方式
内部改进
- 新增 Android 原生安装来源桥接，兼容 Android 11 前后的安装来源接口
- Play 专用构建增加渠道标记，在系统无法提供安装来源时保留 Play 更新渠道
- 增加更新来源、桌面端隔离及 Play 下载跳转回归测试，版本号更新为 1.3.7
详细对比：v1.3.6…v1.3.7
[v1.3.6] — 2026-09-30 · Android 软件包名称调整
新功能：使用 Zerexa 域名对应的包名
- Android 包名：软件包名称调整为
net.zerexa.nekoloc，适用于 APK 安装及 Google Play 的 AAB 上传 - 安装身份：新包名会被 Android 识别为另一个应用；旧包名版本的登录状态、本机设置和草稿不会自动迁移
内部改进
- 平台生成后统一配置 Android
applicationId，明确启动 Activity 的完整类名 - 包名配置失败时终止构建，避免静默产出旧包名的安装包
- CI 检查通用及三种架构 APK 的实际包名，版本号更新为 1.3.6
详细对比：v1.3.5…v1.3.6
[v1.3.5] — 2026-09-30 · 投票与写作工具
新功能：帖子投票与编辑体验
继续参考 NodeLoc 官方 Android / iOS 客户端，补齐投票、写作、搜索和收藏的日常操作。
- 帖子内投票：支持 Discourse 单选 / 多选投票、修改选择与取消投票；多选遵守服务器的最少 / 最多选择数，已结束的投票只读；结果票数按服务端权限显示
- 插入投票：编辑器新增投票工具，每行一个选项，可选择单选或多选；自动生成独立名称，方便一篇帖子插入多个投票
- Markdown 工具栏：支持粗体、斜体、删除线、标题、引用、列表、代码块和链接；对选中文字应用格式，保留周围内容
- 编辑预览：可在正文编辑和本机 Markdown 预览之间切换；投票等站点插件的最终效果以发布后为准
- 搜索筛选与分页：按标题、作者、标签筛选，选择相关程度 / 最新发布 / 最多点赞排序；支持继续加载、失败重试和重复结果去重
- 逐楼收藏：每层楼的“更多”菜单可收藏 / 取消收藏；我的收藏支持分页、直接取消收藏和下拉刷新；收藏及搜索结果可直接打开目标楼层，包含首批列表之外的回复
内部改进
- 投票复用官方
PUT /polls/vote和DELETE /polls/vote接口；保留命名投票与当前用户选择，缺失票数时不伪造结果 - 修复收藏编号丢失和取消收藏误匹配其他楼层的问题，优先查找准确楼层记录并清除已删除编号
- 修复加载更多楼层和表情响应覆盖刚完成的互动状态；编辑器上传返回后检查页面是否仍存在，上传期间禁用发送
- 增加投票解析 / 权限 / 多选限制、Markdown 选区、投票区块生成、搜索分页、收藏定位和 HTTP 参数编码测试
- 新增
markdown依赖，版本号更新为 1.3.5
详细对比：v1.3.4…v1.3.5
[v1.3.4] — 2026-09-29 · 官方客户端互动功能
新功能：对齐官方客户端的日常操作
参考 NodeLoc 官方 Android / iOS 客户端，补充话题互动、用户资料与编辑体验。
- 帖子举报：每层楼的“更多”菜单新增举报入口；理由和顺序读取 NodeLoc 站点配置，按站点要求填写补充说明，提交结果直接反馈
- 标签浏览：话题标题下展示站点标签，点击后进入对应话题列表，支持下拉刷新和分页
- 帖子投票：站点启用
discourse-vote的帖子显示分数和赞成 / 反对按钮；点击已选方向可撤回，反对权限由服务端决定 - 用户资料与关注：点击楼层作者查看公开资料、已发布话题；可关注 / 取消关注、发起私信，允许时可忽略或取消忽略用户
- 编辑草稿：新话题、回复及私信的标题、正文等内容自动保存在本机；重新打开编辑器恢复，发送成功后清除
内部改进
- 举报调用 Discourse 的
POST /post_actions，标签列表复用GET /tag/{slug}.json与现有话题卡片 - 关注、忽略和投票使用官方客户端相同的站点端点；用户资料的权限和状态读取服务端字段
- 增加举报理由、标签、资料及投票字段的解析测试；发布工作流在全部测试和构建通过后创建标签，并从本文件提取版本日志作为 Release 正文
- 版本号更新为 1.3.4
详细对比：v1.3.3…v1.3.4
[v1.3.3] — 2026-09-26 · 日常使用与可靠性
新功能：帖子编辑与话题通知
日常发帖、阅读和管理话题的操作进一步贴近 Discourse 网页版。
- 编辑帖子：对服务端允许修改的帖子提供编辑入口，读取原始 Markdown 并保留缩进、换行等格式
- 话题通知：可将话题设为关注 / 追踪 / 普通 / 静音，与 Discourse 通知级别同步
- 站内阅读：普通话题链接在客户端打开；指向具体楼层的链接继续交给浏览器定位
修复与体验改进
- 授权写入：修复浏览器授权登录后发帖、互动及图片上传受 CSRF 校验阻挡的问题
- 楼层与收藏：修复空话题及楼层加载异常；取消收藏时准确匹配对应帖子，避免影响同话题的其他收藏
- 搜索与显示：处理搜索请求竞态，并修正分类颜色解析
- 登录与报错：修复 CSRF 失效导致的登录递归，改进接口错误信息展示；更新检查改用当前仓库地址
内部改进
- 增加帖子编辑、话题链接及收藏记录相关回归测试
- Android、iOS、macOS、Windows、Linux 构建通过；版本号更新为 1.3.3
详细对比：v1.3.2…v1.3.3
[v1.3.2] — 2026-09-05 · 发帖设备信息
新功能：发帖显示设备信息（对齐官方 APP）
移动端发帖 / 回复时，帖子下方显示设备徽章（如「Pixel 8 Pro」），与 NodeLoc 官方 APP 的 mobile_source 功能一致。
- 等级开关：设置页新增四档开关 —— 关闭 / 仅平台 / 品牌 / 完整型号（默认完整型号），并实时预览当前设备将显示的徽章文本
- Android：按官方逻辑识别子品牌（iQOO / Redmi / POCO / realme / HONOR / Nothing），未命中子品牌时显示厂商名（Build.MANUFACTURER）
- iOS：硬件标识（utsname.machine）自动转换为友好型号名，如
iPhone16,2→ 「iPhone 15 Pro Max」；未收录的新机型回退为泛称 - 隐私边界：桌面端（Windows / macOS / Linux）与 Web 不发送任何设备信息；私信不携带设备信息，仅公开帖与回复生效
内部改进
- 新增
device_info_plus依赖（读取设备品牌 / 型号） - 发帖（
createTopic）与回复（createReply）请求体自动合并mobile_source_*字段 - 设置项持久化（SharedPreferences
post_source_level），升级保留用户选择 - 单元测试覆盖等级语义 / 子品牌识别 / iOS 型号映射（12 用例）
详细对比：v1.3.1…v1.3.2
[v1.3.1] — 2026-08-31 · 品牌打磨
新图标
- 应用图标更换为新设计稿：黑底猫面字标（双行 neko/loc 排版 + 猫耳 + 胡须 + 翘尾），全平台同步
修复
- Windows 顶栏透明：无边框窗口下自绘标题栏缺少背景色导致透出桌面，现填充主题色并加底部分隔线
- 原生窗口背景改为暖黑色（#12100D），启动不再闪白
- 补齐 v1.3.0 遗漏的品牌改名：窗口标题、标题栏文字、登录授权页标题、User-Agent、授权应用名、个人页版本行、Android 更新包名 —— 全部统一为 Nekoloc
仓库已更名为 hekuo5310/Nekoloc，旧地址自动重定向，无需更换书签。
详细对比：v1.3.0…v1.3.1
[v1.3.0] — 2026-08-29 · Nekoloc 品牌重塑
本客户端正式更名为 Nekoloc（neko 猫 + loc NodeLoc）—— 一只爱逛 NodeLoc 的第三方猫咪客户端，与 NodeLoc 官方无关。
品牌设计（猫元素全面融入）
- 新字标：neko（绿）+ loc（橙），顶部两只猫耳，结尾一条甩出的 S 形猫尾
- 新应用图标：绿橙渐变底 + 白色猫耳字标（各平台启动器名称同步改为 Nekoloc）
- 新加载动画：猫耳先立起 → “nekoloc” 逐笔写出 → 猫尾甩出（3.5s 循环），全局加载态焕新
- 猫爪空态：所有「空空如也」页面换上猫爪图标
- 彩蛋：设置页「关于」标题连点 5 次，有惊喜
体验与新功能
- 开屏动画完整播放：启动页第一次加载会完整播完一轮品牌动画再进入应用
- 全屏图片查看器：帖子图片点击全屏查看，双指缩放、双击放大、多图左右切换、页码指示
其他
- 应用 User-Agent 更新为
Nekoloc/x.y.z；更新检查、设置页关于信息同步 Nekoloc 品牌与第三方免责声明 - 安装包文件名改为
Nekoloc-*（Android）；修复模板测试为真实冒烟测试
详细对比：v1.2.1…v1.3.0
[v1.2.1] — 2026-08-29 · 品牌加载动画
品牌加载动画
- 全新「nodeloc」字标加载动画：绿橙双色字母逐笔写出 → 悬停 → 淡出，3.5 秒循环
- 取代全部整页加载占位（9 个屏幕）、启动页与列表「加载更多」状态
- 按钮内的忙碌小菊花保留（尺寸语义更适合）
内部改进
- 修复全部静态分析告警（flutter analyze 0 issue）
- 版本号 1.2.0 → 1.2.1
详细对比：v1.2.0…v1.2.1
[v1.2.0] — 2026-08-24 · 表情反应 + 自动更新检查
表情反应（discourse-reactions 插件）
- 话题详情支持 5 种表情：红心 / 赞同 / 哈哈 / 惊讶 / 庆祝
- 单击点赞按钮 = 快速红心；长按或点小箭头 = 打开 5 表情选择器
- 端点逆向自站点前端 JS：
PUT /discourse-reactions/posts/{id}/custom-reactions/{emoji}/toggle.json
自动更新检查
- 启动后台查询 GitHub Releases 最新版本并比较版本号
- 首页顶部新版本横幅 + 更新说明对话框；设置页「检查更新」一键手动检查
- 下载按钮直达对应平台安装包（Android = universal APK，Windows/macOS/Linux = 对应压缩包，iOS = Release 页）
内部改进
- 版本号 1.1.0 → 1.2.0
详细对比：v1.1.0…v1.2.0
[v1.1.0] — 2026-08-23 · Roadmap 全部功能
新功能
- 浏览器授权登录（User API Key 流程）：RSA-2048 + PKCS1v15，内置 webview 打开授权页并拦截
discourse://回调；支持第三方 OAuth（LinuxDo Connect 等）、邮箱登录链接、2FA 等站点提供的全部登录方式 - 私信：会话列表 / 多收件人新建 / 回复（
target_usernames[]数组格式） - 图片上传：编辑器选择本地图片上传（
/uploads.json），自动以 Markdown 插入正文 - 收藏：新版
bookmarkable_id/type=PostAPI，话题内一键收藏 / 取消 - 阅读进度同步：离开话题时静默上报阅读时间（
/topics/timings），与网页版共享已读状态 - 桌面端自定义标题栏：window_manager；Windows 无边框 + 自绘按钮，macOS 隐藏原生标题栏
变更
- 站点固定为 www.nodeloc.com，移除多站点切换
- 许可证 MIT → MPL-2.0
- CI：Linux 增加 webkit2gtk 依赖；macOS 沙盒增加文件选择权限
[v1.0.x] — 2026-08-23 · 首个版本（初始开发期）
首个可用版本，尚未发布正式 Release（正式发版自 v1.1.0 起）。
核心功能
- Flutter 单代码库覆盖 Android / iOS / Windows / macOS / Linux 五平台
- Discourse 用户级 API：账号密码登录（支持 2FA 动态口令，CSRF / Cookie 会话管理）
- 话题流（最新 / 热门 / 新帖 / 未读）、分类浏览、话题详情（HTML 富文本渲染）、发帖 / 回复、点赞、通知中心、搜索、个人中心
- NodeLoc 官方品牌配色（暖黑 + 松石绿 + 橘橙），深浅双主题
发布前关键修复
- 点赞端点修正为
POST /post_actions（PUT 返回 404） - 分类支持子分类展平；发帖分类选择器只列子分类（顶级分类为容器不可发帖）
- 已用真实账号全流程验证：登录 / 浏览 / 发帖 / 回复 / 点赞 / 通知 / 搜索
基础设施
- GitHub Actions 五平台自动编译工作流 + tag 自动发版（含 macOS ditto 打包、Windows 控制台 UTF-8、绝对路径打包等一系列构建修复）
版本时间线总览
| 版本 | 日期 | 主题 |
|---|---|---|
| v1.0.x | 2026-08-23 | 首个五平台版本（未发正式 Release） |
| v1.1.0 | 2026-08-23 | Roadmap 全部功能：授权登录 / 私信 / 上传 / 收藏 / 进度同步 |
| v1.2.0 | 2026-08-24 | 表情反应 + 自动更新检查 |
| v1.2.1 | 2026-08-29 | 品牌加载动画 |
| v1.3.0 | 2026-08-29 | 品牌重塑 Nekoloc（猫主题 + 图片查看器） |
| v1.3.1 | 2026-08-31 | 新 1:1 猫面图标 + Windows 顶栏修复 |
| v1.3.2 | 2026-09-05 | 发帖设备信息（对齐官方 APP） |
| v1.3.3 | 2026-09-26 | 帖子编辑与话题通知、日常使用修复 |
| v1.3.4 | 2026-09-29 | 举报、标签、投票、用户关注与草稿 |