使 用 手 册

栖 光

光遇 NFC 徽章 · 收藏与随身切换

留住每一道光 · 愿它有处可栖

阳光糖果 SOLARCANDIES 出品 · 适配 App v0.1.2 · 2026 年 9 月

栖光是一款光遇 STAR 徽章工具:把你手里的实体徽章读进手机、永久留底, 再写进一台叫星匣的小设备随身带着——在游戏里想用哪枚,点一下就切换。 这本手册按「从零到完全掌握」的顺序编排,全部截图取自真实界面。

刚拿到星匣?从 02 十分钟上手 开始,连接、读卡、切换,三步走完。
想查某个功能?卷二按页面组织:首页、徽章库、详情、账号、图鉴,每页一章。
遇到问题?直接翻 13 疑难解答——第一句几乎总是「按一下星匣的按钮」。
说明手册截图基于 App 内置演示数据(v0.1.2),点击任意截图可放大查看。你的界面内容会随收藏不同而不同,位置与操作完全一致;个别选项随平台(iOS App / Android App / 微信小程序)略有差异,文中会单独标注。
第 01 章 · 卷一 入门

认识栖光与星匣

一句话说完整个产品:把星星收进匣子,让每道光有处可栖。

1.1它解决什么问题

光遇的 STAR 实体徽章有三个天生的麻烦,栖光对应给出三个答案:

麻烦栖光的答案
备份卡会丢、会坏、会被借走不还 —— 读一次就永久留底,存在你自己的手机里,随时可写回。
随身一抽屉卡带不动,想用的那张永远没带 —— 徽章写进星匣,几十枚装在口袋里。
切换大号小号各一套,换号就得翻卡 —— App 里点一下切换,iPhone 还能在游戏内不退出直接换(见第 10 章)。

1.2你需要准备什么

  • 星匣:栖光的随身设备,装载专用固件,通过蓝牙与手机相连,负责替你「变成」任意一枚徽章。已发售,购买方式见 14.5 节。
  • 实体徽章:你已有的 STAR 徽章。读一次入库,之后实体卡收进抽屉就行。
  • 手机:iOS App(主力,功能最全)、Android App,或微信小程序。手机 NFC 不是必需——没有 NFC 也能用「星匣读取」入库。

1.3三个页面,认识全貌

App 只有三个页签:星匣(首页,切换在这里发生)、徽章库(收藏与图鉴)、设置(备份、外观与一切偏好)。

首页 · 星匣星匣(首页)
徽章库徽章库
设置设置
图 1-1三个页签一览。首页管「现在用哪枚」,徽章库管「我有哪些」,设置管「备份与偏好」。

1.4五个核心概念

概念含义
徽章一条被读取保存下来的徽章数据。它的身份在链接里,与是哪张实体卡无关——白卡复制件和原卡在库里是同一枚。
第 N 位星匣里的一个位置。位置数由星匣上报(常见 8 个,新固件可以更多),装满可换可清。
使用中星匣此刻正在模拟的那一枚——游戏里贴手机时读到的就是它。同时只有一枚在用。
在星匣 / 未装入这枚装没装进星匣。未装入的徽章安全地住在徽章库里,随时可装入。
账号你给徽章标注的归属(大号 / 小号…)。徽章在游戏里永久绑定一个账号,所以「这枚是哪个号的」是第一等信息,详见第 7 章。

1.5三端能力对照

能力App · iOSApp · Android微信小程序
连接星匣(蓝牙)✓✓✓
星匣读取实体徽章✓✓✓
手机 NFC 读取 / 批量添加✓✓仅 Android(iPhone 微信无 NFC)
备份 / 加密分享 / 导入✓ 系统分享面板✓✓ 转发到聊天
游戏内快捷切换(快捷指令)✓ 需 iOS 16+——
星匣固件升级✓✓—
提示iPhone 用户在微信小程序里读不了卡是微信的限制,不是徽章的问题——改用「用星匣读取」,或下载 iOS App。
第 02 章 · 卷一 入门

十分钟上手

连接星匣 → 读入第一枚徽章 → 一步切换。走完这三步,日常使用就全会了。

2.1第一步:连接星匣

欢迎页首次打开 · 欢迎页
首页未连接还没连过时的首页
图 2-1首次打开是欢迎页;点「连接星匣」开始,或「稍后连接」先逛逛——首页的设备卡上随时可以再连。
  1. 打开星匣电源,按一下它的按钮星匣平时深度休眠、不发出信号;按一下按钮它会醒来约 8 秒——这 8 秒就是连接窗口。之后遇到任何「连不上」,第一反应都是再按一下按钮。
  2. 点「连接星匣」连接卡会自动搜索并连上,全程不需要去系统设置里配对。认识过的那台会被记住,下次直接连它,不再重新搜索。
  3. 看到「已连接」,点「完成」连接卡会报告「星匣中有 N 枚徽章」。以后打开 App 会自动重连,无需每次手动连接。
正在搜索正在搜索星匣
未找到未找到 · 唤醒后重试
已连接已连接
图 2-2连接卡的三种时刻。搜索中的提示永远是那句要紧话:「按一下它的按钮唤醒」。第一次连接成功,页脚会多一行只出现一次的小字。
它只说看见了的连接卡的标题分得很细,因为它们是三件不同的事:正在搜索星匣(真的在扫描)·正在连接星匣(认识这台,直接连它——此刻还没「看见」它,所以不说「已找到」)·已找到星匣(扫描真的扫到了)。附近不止一台星匣时,App 连信号最强的那台(=离你最近的那台),并在连上时如实写一句「附近有 N 台星匣,已连接信号最强的那台」。
星匣会睡觉断开连接约 4 秒后星匣就深度休眠、停止发出信号。「搜不到」的头号原因是它睡着了,不是距离太远——按一下按钮唤醒,几乎能解决所有连接问题。连接建立后它保持清醒,不会中途睡着。

2.2第二步:读入第一枚徽章

  1. 点首页右上角「+」,选一条读取方式抽屉里第一条是用手机 NFC 读取(推荐,直接把卡贴在手机背面);没有 NFC 的手机(如 iPhone 上的微信小程序)用用星匣读取,把星匣当读卡器。两条路读到的数据完全相同,下面以星匣读取为例。
  2. 把实体徽章贴在星匣屏幕上,点「开始读取」保持贴紧几秒,读取成功会振动提示。
  3. 在读取成功页确认账号,点「装入星匣 · 第 N 位」读取成功当场标注所属账号(默认沿用上一次的选择),直接装入第一个空位。也可以「稍后装入」只存进库,或「继续读下一枚」连着读。
星匣读卡引导贴卡引导
读取成功页读取成功页
装入完成装入完成 · 回到首页
图 2-3星匣读取:贴稳 → 开始读取 → 一颗星划入、徽章浮现。读取成功页上一次做完三件事:确认身份、标注账号、装入星匣;装入完成回到首页,绿色提示「已装入第 2 位,使用中」。

2.3第三步:一步切换

回到首页,在星匣的格子里点一下任何一枚就是切换。顶部的当前徽章卡随即换成它,亮出使用中标签——之后在游戏里把星匣靠近手机,读到的就是这枚。切换约一两秒;若星匣没响应,底部会给出「重试」。

就这么多日常使用就是这一下:打开 App → 点想用的那枚 → 回游戏。其余一切(账号、图鉴、备份、快捷指令)都是为这「一下」服务的锦上添花。

2.4日常速查表

学完三步以后,这张表覆盖你此后九成的操作——想做什么,一眼查到在哪里做:

想做什么去哪里
切换徽章首页 → 点星匣格子里那一枚
读入新徽章首页 / 徽章库右上角「+」→ 用手机 NFC 读取(或用星匣读取)
腾出一个位置首页长按那一格 → 「从星匣取下」(徽章保留在库中)
把库存装进星匣首页点空位 → 「从徽章库选择」;批量走徽章库多选 → 「装入」
一次换一整套首页「星匣里」段标题右侧的整理(见 3.8 节)
给徽章分组自己建分类:设置 → 分类,或详情页「更多操作 → 分类」(见 7.5 节)
改一枚的账号 / 名字长按它 → 快捷菜单;或进详情页「标注」组
备份全部徽章设置 → 导出全部备份
发一枚给共号伙伴详情页 → 更多操作 → 加密分享(先发文件、再发口令)
收下别人发来的文件聊天里点开 .skybadge → 「用其他应用打开」→ 栖光
游戏内不退出切换设置 → 快捷切换(iOS,见第 10 章)
撤销一次误操作设置 → 历史快照 → 恢复到操作前
升级星匣固件设置 → 固件升级(App 端,见 12.4 节)
第 03 章 · 卷二 页面指南

首页 · 星匣

首页 = 正在用的徽章 + 一步切换的星匣格子。每天打开 App 的九成时间都停在这一屏。

3.1界面导览

首页标注图 1 2 3 4 5 6 7 8
图 3-1首页各区域。
  1. 1状态胶囊:连接状态与电量,点击进「设备信息」。
  2. 2+ 添加徽章:五种添加方式的总入口(第 5 章)。
  3. 3当前徽章卡:正在用的那一枚——名字、账号、「第 N 位 · 用过 N 次」。
  4. 4筛选条:点账号名就只看那个号,「筛选」里是只看已收藏与排序(建过分类的话还会多一组分类)。
  5. 5段标题与「整理」:左边「星匣里 · 6 / 8」是占用情况,右边的整理一次换一整套(3.8 节)。
  6. 6星匣格子:星匣里的徽章,点一下即切换;金框 = 使用中。
  7. 7空位:虚线格,点一下选择装入方式。
  8. 8页签栏:星匣 / 徽章库 / 设置。

下拉页面可刷新星匣状态;格子右上角的小圆点是账号标记色,扫一眼就知道每枚是谁的。

3.2切换徽章

点一枚已装入的徽章即开始切换:顶部卡片变为切换中,格子区右上角出现「正在切换到第 N 位…」,目标格子亮起金环。成功后顶部卡片换成新徽章并播一声轻响;切换失败不会丢东西——底部提示「星匣未响应,请按一下它的按钮后重试」,点「重试」即可。

切换中切换中
切换失败失败 · 点「重试」
图 3-2切换的两种结局。失败最常见的原因还是那一个:星匣睡着了。
细节切换成功那一拍,旧徽章的光会化作一粒光点升回天空,天色随新徽章的环境色轻轻变化——不是错觉,是设计。

3.3长按格子:快捷菜单

长按快捷菜单长按任意徽章格
空位装入点空位 · 选装入方式
图 3-3左:长按已装入的徽章 → 切换到这枚 / 收藏 / 重命名 / 从星匣取下 / 删除。右:点空位 → 从徽章库选择 / 用手机 NFC 读取 / 用星匣读取(标题写明是第几位)。
  • 从星匣取下:清空该位置,徽章保留在库中——腾位置的标准动作。
  • 删除:移入回收站,可在徽章库底部的「回收站」里恢复或永久删除。
  • 长按在全 App 意思一致:长按 = 快捷菜单,徽章库里也是同一套。

3.4装入与更换位置

从徽章库选择「从徽章库选择」抽屉
写入进度卡写入进度 · 逐段报告
星匣已满时选择替换哪一位星匣已满 · 替换一位
图 3-4左:点空位 → 从徽章库选择,挑一枚,写入后立即切换。中:写入约 15 秒,进度卡逐段报告(准备位置 → 写入 → 读回校验 → 保存)——写完自动核对一遍才算成功,绝不留半截数据。右:星匣已满时不是死路,而是一次选择。

「装入」在全 App 只有一个意思:把这一枚换上。无论从哪个入口发起(详情页主按钮、长按菜单、读卡成功页、首页空位),结果都一样:有空位就写进第一个空位,没有空位就弹出「星匣已满 · 替换一位」让你挑掉谁。

  • 替换候选的排序就是「先牺牲谁」:无记录的位置 → 从未用过 → 最久没用过 → 正在用的永远排最后。被替换的徽章只是从星匣上移除,徽章库里的记录完好无损。
  • 徽章从一个位置换到另一个位置时,原位置会自动清空,不会留下重复数据。
  • 「更换位置」(详情页)只挪位置、不切换;空位直接写入,已有徽章的位置需二次确认。

3.5筛选与排序

首页筛选抽屉首页「筛选」抽屉(100 位星匣)
图 3-5筛选条上点「筛选」:只看已收藏、按「位置 / 最近用过」排序,底部实时预告「查看 N 枚」。筛选生效时段标题写「筛出 N 枚」,空位不进结果;点筛选条上的账号名,就只看那个号的。自己建过分类之后,这里会多出一组分类可筛(图中还没建过,所以那一组整个不出现——见 7.5 节)。

3.6更多位置:横滑翻页

24 位翻页24 位星匣 · 第 2 页
图 3-6位置多于 8 个时网格按每页 8 格横向翻页,左右滑动切页,底部圆点可点跳页,「第 9–16 位」标明当前范围。位置数由星匣固件决定,App 自动适配。

3.7没连上时,首页也说得清楚

星匣已休眠星匣已休眠 · 等待唤醒
图 3-7星匣睡着时:设备卡写明「按一下它的按钮唤醒,将自动连接」——App 正在守候,你按一下按钮它就自己连上;网格显示「上次连接」的记忆(压暗、连接后可切换)。

设备卡共有三种未连接形态,说的话各不相同、且都是真的:

形态出现时机该做什么
连接星匣还没连过任何星匣点「连接星匣」,按一下设备按钮
星匣已断开你手动断开过App 尊重你的选择、不自动重连;想连点「现在连接」
星匣已休眠连接意外中断 / 设备睡着按一下设备按钮即可,App 守候中会自动连上(状态胶囊显示「等待唤醒…」)

3.8整理:一次换一整套

收藏多起来之后,一枚一枚装入就太慢了。「星匣里」段标题右侧的整理一次安排全部位置:

整理星匣的三个选项三选一
整理预览动手之前先摊开给你看
整理完成完成
图 3-8整理有三种:智能装入(挑一整套换上)·只填空位(已有的一枚都不动)·清空全部位置(徽章仍保留在徽章库中)。选完先出预览:保留几位、移出几位、装入几枚,一枚一枚列清楚,点「开始整理」才真的动手。
  • 挑选规则一句话说得完,所以你能预判它会挑谁:已收藏的优先,其次最近用过的;同一款每个账号各一枚;仅防伪的不装。多个账号时会先问你「装哪个账号的徽章」——徽章在游戏里绑定账号,跨号装进去不生效。
  • 已经在正确位置上的不会重写(预览里的「保留 N 位」):少写一位就少一次往返,也少一次磨损。
  • 候选不够填满时,多出来的位置保持原样——不做「清了又不填」这种纯粹的损失。
  • 入口有两个、走的是同一条路:首页段标题右侧的「整理」,与设置 → 设备信息 → 整理星匣。
先备份再清空如果某个位置上的徽章只存在于星匣上(徽章库里没有对应记录,见下一节),覆盖或清空它就真的没了。这种情况整理会要求你输入「继续」二字确认——看到这句提示,先去「设备信息 → 备份到本机」把它们读回来。

3.9换了一台星匣 · 星匣上有、库里没有

这是一台新的星匣换了一台盒子
还没读回来的徽章星匣上有,库里没有
图 3-9左:连上一台没见过的星匣(换货、加购第二台)时,App 自己就发现得了——首页如实写「这是一台新的星匣:徽章都在徽章库里,还没有装入这一台」,并给一条「从徽章库选择」。右:星匣上有数据、徽章库里查不到对应记录时,格子写「未记录」,上方一行提示「N 枚徽章还没读回来」,点「读回来」即收进徽章库。

这两件事以前都要你自己发现:换一台盒子之后,首页画着空格子、徽章库却还写着「在星匣 · 8」,两屏说的话相反。现在每次刷新星匣状态都会对一次账,方向永远是「设备说了算」。

第 04 章 · 卷二 页面指南

徽章库

你的全部收藏住在这里——搜索、筛选、批量整理,以及通往图鉴的门。

4.1界面导览

徽章库标注图 1 2 3 4 5 6 7 8
图 4-1徽章库各区域。
  1. 1「⋯」页面菜单:收藏海报 / 批量选择 / 网格·列表切换 / 排序。
  2. 2+ 添加徽章:与首页同一个添加抽屉。
  3. 3搜索:按徽章名、账号、来历搜。
  4. 4「我的 / 图鉴」分段:左边是你的收藏,右边是全部官方徽章图鉴(第 8 章),两边都带数量。
  5. 5筛选:点账号名即筛,另有完整筛选抽屉。
  6. 6最近用过:横向货架,常用的那几枚永远在手边。
  7. 7「选择」:进入多选模式的入口之一。
  8. 8徽章卡:角标显示位置(第 N 位 / 使用中),下方是账号与服务器。

列表按在星匣 / 未装入分组——先看装着的,再看库存。收藏超过 40 枚会自动改用列表视图(也可在「⋯ → 切换为网格 / 列表」手动切);滚到底分页加载,「全选」永远作用于筛选出的全部徽章,不止屏幕上这几张。

列表视图60 枚收藏 · 自动列表视图
图 4-2收藏上了规模后的列表视图:一行一枚,位置角标(使用中 / 第 N 位)一眼可辨,滚到底继续加载。收藏家攒到上百枚也不卡。

4.2「⋯」菜单与筛选

页面菜单「⋯」菜单
筛选抽屉筛选抽屉
图 4-3左:生成收藏海报 / 选择 / 切换为列表 / 排序(最近用过 · 名称 · 添加时间)。右:筛选按「只看已收藏、位置、添加时间、服务器」组合,底部实时预告「查看 N 枚」;建过分类之后会多出一组分类。发现重复徽章时菜单里还会出现「合并 N 组重复徽章」。

4.3多选与批量操作

多选模式多选模式 · 底部动作坞
图 4-4多选是一个专注模式:顶部「取消 / 已选 N 枚 / 全选」,底部动作坞替代页签栏——装入 · 分享 · 标注账号 · 修改分类 · 收藏 · 删除六个批量动作。做完点「取消」回到正常浏览。
  • 批量装入:把选中的未装入徽章按顺序写进空位;空位不够会先告诉你实际能装几枚,全程报进度,单枚失败不影响其余。
  • 批量标注账号:给一批徽章统一标账号,确认前会写明「将应用到选中的 N 枚徽章」。
  • 批量修改分类:与「标注账号」完全对称——分类是你自己建的分组方式,没理由只能一枚一枚标(见 7.5 节)。抽屉里可以直接「+ 新建分类」,建完立刻标上这几枚。
  • 批量分享:加密分享或直接导出成文件(第 9 章);他人加密分享给你的「受保护」徽章不参与再分享。
  • 批量删除:装在星匣上的会先清空位置再删;删除前自动留一份历史快照,后悔可恢复。
  • 进入多选的三条路:「⋯ → 选择」、分组标题右侧的「选择」、长按徽章 → 「选择」。
提示换了筛选条件后,不在当前筛选内的选中项会自动移出选择并提示你——批量动作永远只作用于你看得见的东西。
第 05 章 · 卷二 页面指南

添加徽章的五条路

首页与徽章库右上角的「+」通向同一个抽屉:五种添加方式,覆盖从「手里有卡」到「只有一条链接」的所有情形。

添加徽章抽屉「添加徽章」抽屉
图 5-1五条路,按推荐程度排:用手机 NFC 读取(推荐,光色底板)· 批量添加 · 用星匣读取 · 导入备份文件 · 粘贴徽章链接。这台手机没有 NFC 时(如 iPhone 上的微信小程序),前两条置灰并写明原因,「用星匣读取」升为推荐排到最前——不可用的选项不会藏起来,藏起来只会让人纳闷「为什么别人有我没有」。

5.1用手机 NFC 读取(推荐)

手机 NFC 读取单枚读取
批量添加批量添加 · 连续扫描
图 5-2左:把徽章贴在手机背面,保持约 2 秒。「感应区位置」卡提醒:多数 Android 手机在摄像头下方,iPhone 在机身顶部,厚壳可能影响读取。右:批量模式的计数与已录卡片流。

不用带星匣、不用先连蓝牙,一枚卡两秒钟——所以它是推荐的那条路。iPhone 上会弹出系统读卡窗,把卡贴在机身顶部;Android 在摄像头下方附近。

5.2用星匣读取(没有 NFC 时的那条路)

星匣也是一台读卡器:把实体徽章贴在星匣屏幕上 → 点「开始读取」→ 振动提示成功 → 在读取成功页确认。流程见 2.2 节。读到的数据与手机 NFC 完全相同(含防伪信息),也一样可以当场标注账号、直接装入。iPhone 上的微信小程序读不了卡(微信的限制),这条路就是那时候用的。

5.3批量添加(收藏家模式)

  1. 选账号「这批徽章标注给哪个账号」——录入的新徽章自动标注;已在库中的不会被改动。
  2. 逐张贴在手机背面读到会振动,换下一张即可。iPhone 上系统读卡窗每次读一张,读完点「继续读取」开下一张——这是 iOS 的读卡规则,节奏稳定不丢卡。
  3. 点「完成」收工收尾汇总一句话:「新增 N 枚 · 合并 M 枚 · K 枚保留了更高次数」。
  • 屏幕上那个大数字是「我过了几张卡」(新增 + 已在库),下面一行才拆开写「新增 3 · 已在库 1」。把一摞录过的卡再过一遍是收藏家的常态,那时数字照样往上走——它回答的是你真正在问的那个问题。
  • 同一张卡本场重复贴会被拦下(「这张已录过了」),不会重复计数;iPhone 上这句话直接写在系统读卡窗里。
  • 同款白卡 / 复制卡按徽章身份自动合并,卡片流上带「合并」「已在库」角标。
  • 入场选「不标注账号」是一个明确的意思,不是「没意见」——这一批都不会被贴上上次那个号。
  • 读取停下来时会说明为什么:已录入某一枚 / 这张已录过 / 计数器异常 / 你取消了 / 会话结束。不会四件事共用一句「读取已停止」。

5.4粘贴链接与导入文件

导入备份导入备份 / 粘贴链接
礼物揭示收到加密分享 · 赠礼揭示
图 5-3左:「添加徽章」页的两个分段——导入 .skybadge 备份 / 分享文件,或粘贴 sky.thatg.co 开头的徽章链接直接生成。右:别人加密分享来的徽章,口令通过后先揭示——如果对方附了一句话,会以手写体呈现,并存进这枚徽章的「来历」。
  • 粘贴链接:只有链接、没有实体卡时的入库方式。无实体数据,无法判定真伪,但使用不受影响。
  • 导入文件:iOS 上在聊天里点开 .skybadge 文件 → 「用其他应用打开」→ 选栖光即可直达导入;微信里走「从聊天记录选文件」。加密文件会自动识别并询问口令(第 9 章)。

5.5添加结果只有五种,每种都说实话

结果什么意思
新增「已存入「大号」」——库里多了一枚新徽章。
已在库,已更新同一枚再次读取,数据已刷新(不覆盖你改过的账号与名字)。
合并白卡 / 复制卡与库中某枚是同一身份,合并为一条记录。
从回收站恢复这枚曾被删除,读到实体后自动恢复。
保留更高次数读到的使用次数低于库里的记录时,保留较高值(弹窗说明)——次数只增不减,调小会被游戏拒绝。
它只陈述观察,不下道德判断读过实体卡之后,详情页会记下这枚的持有形态:实体徽章(卡上的芯片编号与链接里签的一致)·复制卡(数据被抄到了另一张芯片上)·只有数据(买的、粘的、别人分享的,从没读过实体)。白卡不是假货,措辞上也不会那么说。粘链接生成的徽章诚实地标「只有数据」,绝不瞎猜。使用次数卡上的状态词见 6.1 节。
第 06 章 · 卷二 页面指南

徽章详情

一枚徽章的全部:状态、账号、次数、真伪、来历,以及能对它做的每件事。

6.1界面导览

徽章详情标注图 1 2 3 4 5 6
图 6-1徽章详情。
  1. 1状态与归属:在星匣、账号 · 服务器;标过分类的还有第三枚。
  2. 2主按钮:随状态变化(见下表)。
  3. 3更换位置:在星匣内挪位或替换。
  4. 4更多操作:九项进阶动作。
  5. 5使用次数卡:游戏内使用次数,右上角一枚状态词(见下)。
  6. 6标注组:账号 / 服务器 / 分区 / 来历。

顶上那枚徽章可以用手指转动:拖一下它会随之侧倾,高光沿着画面的形体扫过、光晕朝反方向让开;松手自己回正。放着不动时它也会跟着手机的姿态轻轻转——像把实物拿在手里换个角度看。

使用次数卡右上角那枚状态词回答的是「这个数还会不会长」,一共五种,每种都是一句实话:

状态含义与该做什么
随实体徽章记录与实体徽章上的读数一致。用过实体卡之后重新读一次,记录才跟得上。
落后 N 次实体徽章比这份记录高——你在别处用过它。「更多操作 → 重新读取实体徽章」即可更新;这枚若装在星匣里,更新后还要写入星匣。
高出 N 次这份记录比实体徽章高(被调大过 / 导入过更高的数据)。用这份在游戏里使用之后,实体徽章要在 NFC 下读 N 次才能再用。
固定复制卡或只有数据:次数不会随使用增加。绝大多数徽章是这种,正常。
未判定还没读过实体卡,无从比对。

6.2主按钮的五种状态

按钮出现条件
切换到这枚已装入星匣、但不是正在用的那枚。
装入星匣未装入且星匣已连接——写入第一个空位;已经装满时弹出「星匣已满 · 替换一位」让你挑掉谁(见 3.4 节)。
使用中 · 靠近手机即可正在用的就是这枚——不用再操作,回游戏使用即可。
写入星匣本机改过(比如修改了次数)、星匣上还是旧数据。
连接星匣后可切换未连接时如实置灰。

6.3「更多操作」分三组

更多操作更多操作
更换位置更换位置 · 选格子
重命名弹窗重命名
图 6-2左:菜单按分享(生成海报 · 导出徽章 · 加密分享)·这一枚(重新读取实体徽章 · 修改使用次数 · 排查游戏内报错)·整理(收藏 · 重命名 · 分类 · 删除)三组排列。中:更换位置——「空位直接写入 · 已有徽章的位置需二次确认替换」。右:重命名只改显示名称,随点随改。
  • 重新读取实体徽章:把这一枚重新读一遍,更新使用次数与持有形态——出门用过实体卡之后回来对个账。次数前进了会顺带更新写进星匣的那份。
  • 修改使用次数:仅建议调大。改到比实体徽章还高时会先告诉你后果(那张实体卡之后要在 NFC 下读 N 次才能再用)并默认取消——它不硬拦你,但一定把话说清楚。改完需「写入星匣」才生效。
  • 排查游戏内报错:游戏里提示徽章验证失败时点这里,按你这一枚的实际情况给出对应的处理办法。
  • 重命名:只改显示名称,不动徽章数据;改过的名字不会被自动更新覆盖。
  • 分类:把这一枚归进你自己建的分类(见 7.5 节)。
  • 来历(在「标注」组里):写下这枚的故事(谁送的、哪一天)。只存本机,分享时不带。

6.4受保护的徽章

别人加密分享给你的徽章会带受保护标记:不显示链接原文、不可复制、不可导出、不可再分享、不可改次数。原因很简单——链接就是徽章的身份,别人加密送来的东西,不该在你这里明文摊开;次数只增不减,改错这枚就废了。你自己的徽章永远不受这些限制。

6.5周年那一晚

周年角注详情页脚 · 周年小字
图 6-3某枚徽章入库满一年的那天打开它的详情,页脚会多一行手写体小字:「一年前的今晚,你接住了它。」每枚每年只出现一次,不推送、不弹窗。图中同时可见「详细信息」组:SKU、徽章日期、链接检测、来源与位置。
第 07 章 · 卷二 页面指南

账号与分类

账号回答「这枚是哪个号的」——徽章在游戏里永久绑定账号、不可解绑,所以那不是备注,是第一等信息。分类回答「我想怎么摆它们」——完全由你自己定。

7.1为什么要标账号

  • 标注后,首页与徽章库的筛选条点一下账号名即可只看那个号;快捷指令在选徽章之前也会先问账号,还有一条独立的「切换账号」指令。
  • 账号只是 App 内的分组标签,不影响游戏内绑定,可随时修改。
  • 国服 / 国际服分开绑定,所以每枚还可以标「服务器」;同系列多枚时再加「分区」细分。

7.2怎么标:读卡当场标,之后随时改

  • 读卡时:揭示页的账号胶囊默认沿用上一次的选择——连读同一个号的一批卡时,一次都不用点。
  • 之后:详情页「标注 → 账号」,或徽章库多选 → 「标注账号」批量改。
  • 重复读卡不会覆盖你改过的标注,也不会把你特意清空的账号又填回去。
选择账号选择账号
账号管理账号管理 · 「⋯」菜单
图 7-1左:账号选择器——每行带标记色圆点与「N 枚 · M 枚在星匣」,底部「+ 新建账号」。右:设置 → 账号 的管理页,每个账号的「⋯」里可重命名 / 合并到其他账号 / 查看徽章 / 删除账号。

7.3「未绑定」和「未标注」不是一回事

分组含义
未绑定你确认过的选择:「这枚我就是不绑任何账号」——管理白卡、公用卡时最需要的一句话。
未标注还没做选择的兜底。整理收藏时,把「未标注」清零就算整理完了。

7.4管理动作的安全边界

  • 重命名:该账号下的全部徽章一并更新(包括回收站里的),不会出现改了名字就走散的徽章。
  • 合并:把 A 的徽章全部并入 B,A 随之删除;操作前自动留历史快照,可反悔。
  • 删除账号:仅清除标注,徽章本身一枚都不会少,全部变回「未标注」。
  • 账号的标记色按登记顺序自动分配、互不重复——格子角上的小圆点就是它。

7.5分类:完全归你

栖光一个分类都不预置。分类是你自己建、自己命名、自己排序、随时可删的标签,只存在这台手机上——云端不知道你建了什么,也不会给你「系统替你分好的类」。

还没建过分类起点:一个都没有
分类管理建好之后
批量修改分类多选 → 修改分类
图 7-2设置 → 分类。左边那一屏不是故障,是起点——绝大多数人一个分类都不需要,需要的人自己建就好,比如「常用」「送人的」「国际服」。
  • 建:设置 → 分类 →「新建分类」;也可以在详情页「更多操作 → 分类」或徽章库多选 →「修改分类」里就地新建。
  • 标:一枚一枚标(详情页),或一批一起标(徽章库多选,与「标注账号」完全对称)。
  • 删:删一个分类,徽章一枚都不会少,只是回到「未分类」。而且如果你之后又建了一个同名同号的分类,标过的那些会自己回去——所以删除是安全、可反悔的,也正因为如此,分类没有「隐藏」这种第二个动作。
  • 自适应:一个分类都没建时,筛选面板里那一组整个不出现、详情页不画分类标签、海报不画那一格、快捷指令也不会多问你一次「哪个分类」——不做无意义的一次点击。
「未分类」不是一个分类它只是筛选面板里的一个桶(同账号那边的「未标注」),永远不会出现在你的分类名单里,也不会被写进任何一枚徽章。
别和图鉴的「分组」搞混图鉴里那排「先祖 · 图区 / 斗篷 · 面具 …」是分组,回答的是「官方这批货怎么摆」,随 App 版本发布、你改不了也删不掉。这里的分类是你自己的东西。两者互不相干,见 8.1 节。
第 08 章 · 卷二 页面指南

图鉴与你的星空

全部官方徽章的图鉴住在徽章库的第二个分段里;你每收进一枚,属于它的那颗星就在你的夜空里点亮。

8.1图鉴

图鉴图鉴 · 进度卡与网格
图鉴详情图鉴详情抽屉
图 8-1左:进度卡「已点亮 11 / 113」,上方那片星空里每颗星对应一款徽章,点亮的才发光;下方按分组浏览,金勾 = 已拥有。右:点任意一款看官方描述、冷却时间与 SKU,已拥有的可「在徽章库中查看」。
  • 入口:徽章库 → 「图鉴」分段。可搜索名称与 SKU,按分组筛选。
  • 图鉴收的是「有真实魔法的 NFC 徽章」,目前 113 枚。计数按款算:同一款收了好几枚也只算一格。
  • 那排标签是分组,按「这枚在游戏里给你什么」划分,共 8 个:先祖 · 图区 / 斗篷 · 面具 / 召唤 · 烟花 / 生物 / 乐器 · 道具 / 互动 · 双人 / 联名 · 纪念 / 其他。它随 App 版本发布,不是你自己的分类(那是另一件事,见 7.5 节)。
  • 右上角的「只看未点亮 N」是图鉴真正要回答的那个问题:我还差哪些。默认排序把已拥有的排在最前,点一下就只剩没收的。
  • 图鉴数据可在线更新:设置 → 图鉴数据,新上架的徽章名称、配图会自动补齐,无需升级 App。
仅防伪的那些不在图鉴里有一类徽章(如部分 Protector 芯片)扫了只显示一句正品提示,游戏内没有任何魔法——切过去不会有效果,不是故障。它们在徽章库里照常有名字、有图,卡片右下角带一枚盾形小标,只是不占图鉴的格子,也不计进「已点亮」。

8.2你的星空

星空里每颗星的位置由徽章本身决定:所有人的星图排布相同,点亮的组合各不相同——那片天就是你收藏的形状。星的数量从不写死:图鉴在线更新长出新款,天上就多一颗新星。集齐全部图鉴的那一刻,会有一整屏只出现一次的仪式:

全部点亮之夜全部点亮之夜(一生一次)
图 8-2「全部点亮。这片夜空,是你的了。」——整片星空全部亮起的一屏仪式,轻触任意处继续。

8.3三种海报

我的夜空海报我的夜空(星图)
收藏海报收藏海报(九宫格)
单枚海报徽章海报(单枚)
图 8-3三种可分享的海报:图鉴进度卡「分享」出我的夜空(海报上的天就是卡片上那片天);徽章库「⋯ → 生成收藏海报」出九宫格收藏(带称号与图鉴进度);详情页「更多操作 → 生成海报」出单枚特写。都可切黑夜 / 白天配色、改署名(默认「光之子」),保存到相册或直接发给朋友。
隐私干净海报上只有数量、称号与下载二维码——没有账号名、没有徽章链接,放心发到群里。
第 09 章 · 卷三 进阶

备份 · 分享 · 接收

备份的全部意义是「出事了还能找回来」。这一章讲三张安全网:历史快照、备份文件、加密分享。

9.1历史快照:自动的后悔药

历史快照设置 → 历史快照
图 9-1删除、清空、写入星匣、修改账号、导入……这些动作之前,App 自动保存一份整库快照(最多 8 份滚动)。点任意一份即可恢复到当时的状态;恢复前还会先给「现在」留一份——后悔可以再后悔。

9.2备份成文件:换手机的保险

  1. 导出设置 → 备份 → 导出全部备份。星匣连接时会先同步一遍设备上的徽章再导出,进度逐位报告。
  2. 收好文件产物是一个 .skybadge 文件,文件名带日期与枚数(如「栖光备份-20260901-1200-12枚.skybadge」)。iOS 走系统分享面板——发给微信文件传输助手、存 iCloud 都行;微信小程序里直接「转发到聊天」。
  3. 导回来新手机装上 App → 「+ → 导入备份文件」→ 选中那份文件,全部徽章连同账号分组一起回来。iOS 上也可以在聊天里点开文件 → 「用其他应用打开」→ 栖光。
建议库有变化后设置页会挂出「建议备份」的小字。请当真——徽章数据只存在你手机本机(这是隐私承诺),App 不会也不能替你云端兜底,备份文件就是唯一的异地保险。

9.3加密分享:给共号伙伴的一份光

共号(多人共用一个游戏账号)在光遇里很普遍,而徽章魔法绑定的是账号——把徽章数据分享给同号伙伴是正当需求。入口有三个:详情页「更多操作 → 加密分享」(单枚)、徽章库多选 → 「分享」(多枚)、设置 → 加密分享(整库)。流程相同:

  1. 生成加密文件App 自动生成一个 10 位口令并展示给你;确认时可以附一句话(可选)——它会随文件加密,对方导入时看到,并存进那枚徽章的「来历」。
  2. 先发文件,再单独发口令这是界面反复强调的顺序:同一条消息里同时发文件和口令,加密就失去意义。文件走分享面板 / 聊天,口令单独发一条。
  3. 对方导入对方点开文件 → 输入口令 → 揭示页「收下,放进徽章库」。口令输错可以就地重输,不用重选文件;从聊天里复制口令时带进的空格、换行等隐形字符会被自动清理。

加密与解密都在你的手机上完成,整库也只等一两秒——不会卡着不动,也不会把界面冻住。

边界说清楚加密只保护传输途中的文件不被无关的人读到;徽章在游戏里仍然只对绑定的那个账号有效——分享改变不了绑定,也不该有人向你承诺能。收到的徽章带「受保护」标记(见 6.4 节)。

9.4三端小差异

端递文件要点
App · iOS系统分享面板,一步选微信 / 文件.skybadge 已注册为文档类型,聊天里可直接「用其他应用打开」导入
App · Android文件保存到本机 + 指路导入走「+ → 导入备份文件」选择文件
微信小程序「转发到聊天」直接进对话发给「文件传输助手」就是最好的云备份;导回用「从聊天记录选文件」

9.5清空数据:两条路,说的都是实话

设置 → 清空数据给的是两个不同的东西,选之前先看清楚哪一个是你要的:

动作抹掉什么能不能恢复
清空徽章库本机全部徽章(含回收站里的)可以——清空前自动留一份历史快照,之后在设置 → 历史快照里恢复
彻底清除徽章、历史快照、账号、分类、壁纸与全部偏好设置不能。请先「导出全部备份」

两个都要输入文字确认(「清空」/「彻底清除」),不是点两下就完事。「彻底清除」按前缀抹掉本应用在这台手机上留下的每一个键——不是照着一份名单删,所以不会漏。万一有删不掉的,它会如实报出来,而不是假装成功。

为什么要有第二条「清空徽章库」只删徽章。手机要转手、借人或送修时,历史快照里仍然完整躺着你的整库数据(连同徽章链接里的身份)——那是一个你完全不知情的数据面。要交出这台手机,用「彻底清除」。
第 10 章 · 卷三 进阶

游戏内快捷切换(iOS)

人在光遇里,双击一下悬浮球或敲两下手机背面——徽章就换好了,全程不退出游戏。需要 iOS 16 及以上的 App 版本。

10.1原理一句话

栖光把「换徽章」等动作注册成了系统快捷指令。快捷指令可以被 Siri、辅助触控(悬浮球)、轻点背面等系统入口触发——触发后由 App 在后台连星匣完成切换,光遇始终留在前台。

10.2设置:跟着页面走就行

选择触发方式第一步 · 选触发方式
已验证设好后 · 已验证
图 10-1设置 → 快捷切换。选「辅助触控」(推荐,所有 iPhone 支持)或「轻点背面」,页面按所选方式生成分步指引,每步都有按钮或写清系统设置路径。
  1. 把「换徽章」加进「我的快捷指令」点「获取快捷指令」,在快捷指令 App 里点「添加快捷指令」即可(网络不畅时用页面上的「从本地文件添加」)。这一步各种触发方式通用,做一次就好。
  2. 打开辅助触控(悬浮球路线)设置 → 辅助功能 → 触控(在「动作交互」下)→ 辅助触控 → 打开。轻点背面路线跳过此步。
  3. 把「轻点两下」设为「换徽章」同一页「自定操作」(或「轻点背面」)→ 轻点两下 → 下翻到「快捷指令」→ 换徽章。

设置完当场试一下:不用离开这页,双击悬浮球(或敲两下背面),状态标签就会从「等待测试」变成已验证,并写出「最近一次:切换到「××」」。此后设置页那一行会一直显示最近的运行情况。

10.3游戏里的实际体验

  • 双击 → 系统弹出徽章菜单(收藏优先、「● 正在用」标当前)→ 点一枚 → 稍候即切好,继续玩。
  • 菜单只在真的能省事时才多问一层。装入的徽章不多时就一次摊开,一步选完;多起来才先问账号(多个账号时)、再问分类(建过分类时)。
  • 每一层都回得去。系统的选择框只有「取消」,而取消掉的是整条指令——所以栖光自己在菜单里放了返回行:徽章那一级第一条是「← 换一个分类」,分类那一级第一条是「全部徽章」与「← 换一个账号」。选错一层,退回去重选就行,不用整条重跑。
  • 没标账号的徽章照样选得到:它们归在「未标注」这个桶里,和你建的号平级。
  • 「下一枚徽章」零点选:在当前账号的徽章里轮换,适合只想换着用的场景。
  • 全程星匣要在身边;若它睡着了,指令会提示「按一下它的按钮唤醒后重试」。

10.4全部快捷指令一览

指令做什么
切换到徽章从已装入的徽章中选一枚切换(就是「换徽章」的核心)。
切换账号切到指定账号的徽章;只有一枚就直接切,多枚运行时问你。
下一枚徽章当前账号内轮换到下一枚,零参数。
按位置切换按位置号切换,给高级玩家的手动挡。
查询连接状态 / 位置状态 / 徽章概览看星匣状态与清单,不用打开 App。
星匣已连接吗 / 星匣电量 / 当前徽章名称 / 当前账号 / 星匣状态(JSON)返回可判断的值,专供你自己搭自动化(如「到家 → 若已连接 → 切大号」)。
顺手的小设置① 只想在光遇里见到悬浮球:快捷指令 → 自动化 → 「打开光遇」时设定辅助触控开、「关闭光遇」时关(选「立即运行」)。② 不想每次弹结果卡片:快捷指令 App 长按「换徽章」→ 详细信息 → 关闭「运行时显示」。③ 对 Siri 说「栖光换徽章」也能触发。
第 11 章 · 卷三 进阶

外观与个性化

两套主题、六片天空、自定义壁纸,以及一些不打扰你的小天气。

11.1外观:烛光与晨曦

外观选择设置 → 外观
晨曦下的详情页晨曦 · 徽章详情
晨曦下的首页晨曦 · 首页
图 11-1三选一:跟随系统 / 白天(浅色主题「晨曦」,奶油与可可色)/ 黑夜(深色主题「烛光」,夜蓝与烛光金)。同一个页面两副面孔——对照第 6 章图 6-1 的烛光详情页看。切换即时生效,不闪不重启。

11.2六片内置天空

黑夜天空黑夜组:深空 · 栖光之夜 · 月海
白天天空白天组:晨霞 · 晴昼 · 蜜光
月海效果「月海」下的首页
图 11-2设置 → 壁纸。黑夜与白天各自记住一片天:黑夜默认「深空」,白天默认「晨霞」——主题切换时天也跟着换。上半屏就是实时预览,选中立即可见。

11.3自定义壁纸

自定义壁纸已设自定义壁纸
取景编辑调整取景 · 拖动 / 双指缩放
图 11-3「从相册选择」一张照片铺满每一页的背景。右图为取景编辑:拖动移动、双指缩放,「居中」恢复原位,「完成」保存。「遮罩」四档——默认「自动」按照片亮度调整深浅,保证文字始终清晰;「模糊」开关弱化照片细节。「移除」后回到内置天空,天空的选择不受影响。

11.4音效与触感

  • 设置 → 音效:连接、切换、读卡成功的几声轻响全在同一组音阶上,可整体关闭。播放采用混音模式,不会打断你正在放的光遇背景音乐。
  • 触感跟随系统:连接与切换成功是一下清脆的确认,失败是明显不同的提示;在系统设置里关掉「系统触感反馈」即全部安静。

11.5夜空的天气(不打扰的彩蛋)

使用内置天空时,夜空偶尔会有一点「天气」——它们不可点击、不弹提示、不写字,纯粹是天气不是奖励:

  • 流星:普通夜晚小概率划过一颗;真实流星雨极大期的夜晚必有。
  • 薄月:现实中的满月夜,首页天上挂一轮薄月(「月海」天空自带大满月,不重复挂)。
  • 睡颜:App 守候星匣醒来时,星点会以慢呼吸的节奏轻轻压暗。
第 12 章 · 卷三 进阶

设备信息与维护

星匣的体检中心:电量、固件、全部槽位,以及两把维修钥匙。

12.1设备信息页

设备信息标注图 1 2 3 4
图 12-1入口:首页状态胶囊,或设置 → 设备信息。
  1. 1设备卡:连接状态、信号强弱、固件版本、电量。
  2. 2连接 / 断开 / 停止:按钮随状态变化。
  3. 3槽位列表:每一位装着谁、上次使用时间;位置多时可按账号 / 最近用过分组。
  4. 4使用中行高亮;点空位行可直接装入,长按有快捷菜单。

槽位列表里偶尔会出现一行「已装入 · 徽章库中无记录」——星匣上有数据、库里却没有对应徽章(常见于借来的设备或很早以前写入的位置)。长按这一行可以「切换到这个位置」或「清空这个位置」;想把它收进库里,用下面的「备份到本机」。

12.2整台盒子的三件事

动作做什么
整理星匣一次安排全部位置:智能装入 / 只填空位 / 清空全部位置。与首页段标题右侧的「整理」是同一条路,详见 3.8 节。
备份到本机把星匣中的全部徽章读进徽章库——拿到一台装着徽章的星匣时先做这个。逐位报进度,哪一位失败会明确列出。
恢复到星匣把徽章库写入星匣空位:优先写回各枚原来的位置,被占用才写其他空位,已有徽章不动。

12.3连不上、状态不对时

  • 修复连接(本页「连接」组):断开并重新连接,专治「显示已连接却点什么都没反应」。
  • 换了一台星匣不用做任何事:直接连就好。App 自己认得出这是另一台盒子(认的是芯片编号,换手机也不会认错),并在首页如实告诉你,见 3.9 节。
  • 想让这台手机彻底忘掉配对过的星匣:设置 → 清空数据 → 彻底清除(会连徽章一起抹掉,见 9.5 节)。

12.4固件升级

固件升级页有新固件
已是最新版本已升级 · 已是最新
图 12-2设置 → 固件升级(App 端,微信小程序没有这一项)。页面写明当前版本、要升到哪一版、大概多久、这一版改了什么,点一下就升。
  • 升级约一分钟:星匣重启进入升级模式 → 写入 → 自动重启。过程中把星匣放在手机旁边、保持这一页打开。
  • 徽章数据与设备身份不受影响——升级不动你星匣里装着的那些徽章。
  • 中途断了不用慌:回到这一页会告诉你「星匣可能正停在升级模式等待固件」,点「继续升级」接着写完即可。
  • 电量太低时不会让你开始——先充一会儿。
  • 星匣固件基于开源项目 Chameleon Ultra(GPL-3.0)修改;完整对应源码公开于 github.com/SolarStormTec/qiguang-chameleon-ultra-firmware (每个发布版本旁都有同版本号的源码)。
第 13 章 · 卷四 参考

疑难解答

每一条都按「现象 → 该做什么」写。九成的连接问题,答案是同一句话。

13.1连接

搜不到星匣 / 一直「正在搜索」?

按一下星匣的按钮。它断开约 4 秒就深度休眠、停止发出信号,按钮唤醒后有约 8 秒连接窗口。搜不到的头号原因是睡着,不是距离——抱着手机贴过去没有用,按按钮才有用。

星匣关了电源再开,连不上?

开机后按一下按钮,然后在 App 里点「重试」或「现在连接」即可。任何情况下都不需要杀掉 App 重开;若界面状态明显不对,用「设备信息 → 修复连接」。

提示「蓝牙未开启」或「未授权使用蓝牙」?

按提示点「打开蓝牙」或「前往设置」——iOS 在设置里允许栖光使用蓝牙;Android 扫描蓝牙还需要定位权限(仅用于查找星匣,这是系统规则)。

身边有两台星匣,会不会连错?

不会随便连。规则是:上次连过的那台优先,否则连信号最强的那台(=离你最近的那台,多半就是你手上这台)。连上之后卡片会如实写一句「附近有 N 台星匣,已连接信号最强的那台」——它不会连了谁都不告诉你。

换了一台星匣要重新设置吗?

不用,直接连。第一次连新盒子会比平时多等两秒(先试直连旧的那台、失败才改扫描),之后就一直直连新的这台。徽章一枚都不会丢,首页会告诉你「这是一台新的星匣」,用「从徽章库选择」或「整理」把徽章装上去即可。

显示「已连接」但点什么都超时?

链路可能已悄悄断掉。App 约十秒内会自己发现并重连;等不及就去「设备信息」点「修复连接」。

13.2读卡与写入

手机 NFC 贴了没反应?

对准感应区:多数 Android 在摄像头下方,iPhone 在机身顶部;摘掉厚壳、保持不动约 2 秒。iPhone 微信小程序没有 NFC 能力,请改用「用星匣读取」或 iOS App。

读到一半失败 / 提示「没读全」?

贴稳别移开,点「重试」再来一次。批量模式下失败的那张不会入库,重贴即可。页面上永远会有一个可以按的出口——不会出现「写着正在扫描、其实什么也没在跑」的死局。

装入 / 写入失败?

保持星匣在手机附近,点「重试」。写入前后 App 会自动读回校验,失败不会留下半截数据;多次失败时换一个位置试,或先「修复连接」。

切换后游戏里没反应?

确认首页那枚显示「使用中」,再把星匣贴近手机的 NFC 感应区。若这枚是仅防伪的徽章(卡片右下角带盾形小标),游戏内本来就没有效果,不是故障(见 8.1 节)。游戏里如果明确报了徽章验证失败,去详情页「更多操作 → 排查游戏内报错」,它会按你这一枚的实际情况给出办法。

某个位置显示「已装入 · 徽章库中无记录」?

星匣上有数据、库里没有对应记录(比如设备是别人用过的)。长按那一格可切换或清空;想收编它,去「设备信息 → 备份到本机」把星匣里的徽章全部读进徽章库。

13.3数据与分享

口令输对了却解不开?

口令区分大小写;从聊天复制常会带上看不见的空格与换行,App 会自动清理,但手打时注意形近字(口令里不含 0、1、大写 I、大写 O 等易混字符)。输错可就地重输,不必重选文件。

.skybadge 文件导不进来?

iOS:在聊天中点开文件 → 「用其他应用打开」→ 选栖光。微信:「+ → 导入备份文件 → 从聊天记录选文件」。还不行就把文件内容复制后走「直接粘贴备份内容」。

误删了徽章 / 误改了账号?

两层保险:徽章库底部「回收站」可恢复单枚;设置 → 历史快照可整库回到操作前的状态。

想把使用次数改小?

不建议。次数记录在徽章链接里、只增不减,游戏会拒绝变小的次数——App 允许你坚持修改,但会先警告后果。

图鉴里缺某款新徽章?

设置 → 图鉴数据检查更新——图鉴可以在线更新,不用等 App 发新版。刚上市的盒内款可能要等收录;你读取入库不受影响,图鉴稍后自动补全名称与配图。

13.4快捷切换

悬浮球菜单里找不到「换徽章」?

先完成第 1 步「把「换徽章」添加到「我的快捷指令」」——辅助触控与轻点背面只能选到「我的快捷指令」里的项目。

触发了但提示星匣未响应?

还是那句话:按一下星匣的按钮唤醒,再触发一次。

状态一直是「等待测试」?

按 10.2 节当场试一下(不用离开设置页);只有真正收到过一次切换,状态才会变「已验证」——它从不虚报。

菜单里进错了一层,怎么退回去?

别按「取消」(那会结束整条指令)。菜单里第一条就是出口:徽章那一级是「← 换一个分类」,分类那一级是「全部徽章」和「← 换一个账号」。

13.5固件升级

升级到一半断了怎么办?

回到设置 → 固件升级,页面会告诉你「星匣可能正停在升级模式等待固件」,把星匣放到手机旁边点「继续升级」即可。徽章数据不受影响。

升级会不会把我的徽章弄丢?

不会。徽章数据与设备身份都不受升级影响。真要图安心,升级前先设置 → 导出全部备份。

找不到「固件升级」这一项?

它在设置 → 星匣组里,只有 App 端有(微信小程序没有)。另外,没有新固件可发时这一项会置灰。

固件源码在哪?你们改了开源固件吗?

改了,按 GPL-3.0 完整公开。地址: github.com/SolarStormTec/qiguang-chameleon-ultra-firmware。 当前版本看仓库 Releases;每个 DFU 包旁都有同版本号的完整对应源码。

第 14 章 · 卷四 参考

附录:词汇 · 隐私 · 彩蛋

最后一章,留给查阅与惊喜。

14.1状态词速查

状态含义
使用中星匣正在模拟的那一枚。
在星匣已装入某个位置,随时可切换。
未装入只在徽章库里,装入后才能使用。
待写入星匣本机改过(如修改次数),星匣上还是旧数据——去详情页点「写入星匣」。
仅备份从备份导入、还没写过星匣的记录。
受保护他人加密分享而来:可使用,不可查看链接 / 再分享 / 改次数。
数据异常数据校验未通过,建议用实体徽章「重新读取实体徽章」。

使用次数卡上的五个状态词(随实体徽章 / 落后 N 次 / 高出 N 次 / 固定 / 未判定)见 6.1 节。

14.2名词对照

手册 / 界面用词它是什么
星匣栖光的随身设备,装载专用固件,负责模拟徽章(App 内的唯一称呼)。已发售。
第 N 位星匣中的一个存储位置(技术文档里叫「槽位」)。
图鉴全部「有真实魔法」的官方 STAR 徽章名录,目前 113 枚(页面标题为「徽章博物馆」)。可在线更新。
分组图鉴里那排标签(先祖 · 图区 / 斗篷 · 面具 …),按「在游戏里给你什么」划分,随 App 版本发布,你改不了。
分类你自己建的标签,零预置、随时可删、只存这台手机(7.5 节)。与「分组」互不相干。
.skybadge栖光的备份 / 分享文件格式,明文与加密共用同一扩展名。
使用次数记录在徽章链接末位的游戏内使用计数,只增不减。

14.3隐私承诺

  • 「徽章数据仅保存在本机」——徽章链接、账号备注、收藏、来历都只存在这台手机上,绝不上传。会离开手机的只有匿名的产品型号与运行状态(用于补全图鉴与改进 App),不含链接、不含你的任何数据。
  • 加密分享用你们约定的口令加密,口令不经过栖光的服务器,内容我们也看不到。
  • 同意可以撤回:设置 → 撤回同意。撤回后立即停止全部联网上报(匿名诊断、SKU 上报、设备校验与固件更新),本机徽章一个字节都不动——撤回的是「允许我们采集」,不是「删掉你的东西」。要删本机数据是另一件事,见 9.5 节。
  • 完整说明见 设置 → 隐私政策。

14.4只出现一次的时刻

栖光把几句话留给特定的时刻,一生只说一次。你可以现在知道它们,也可以合上这一节,等它们自己出现:

时刻那一句
第一次连接成功「从今晚起,这里有光了。」
收进第 1 / 10 / 30 / 60 枚「第一道光,安顿好了。」……
第一次备份成功「都安顿好了。」
某枚入库周年的当晚「一年前的今晚,你接住了它。」
图鉴全部点亮「全部点亮。这片夜空,是你的了。」

14.5找到我们

本手册对应栖光 v0.1.2(build 128,2026 年 9 月)。界面若与手册略有出入,以 App 内为准。