Imported from happycola233/BiliTools (
AGENTS.md). Install upstream withnpx skills add happycola233/BiliTools. Copyright stays with the author.
本项目是一个安卓 APP：哔哩哔哩视频解析与下载工具。历史上曾参考桌面端项目 ../BiliTools_Desktop。
深度思考，积极搜索互联网查阅最新开发文档与行业最佳实践。
确保代码可维护性，避免回归，拒绝代码冗余与「屎山」堆积。
命名及时重构，新变量命名需语义清晰，同时更新相关的旧变量名。
代码意图不明确时，主动编写清晰准确的中文注释。
涉及到 UI 的调整需同时兼顾浅色与深色模式。
需要任何工具或依赖，请自行安装。
临时文件统一放在 .tmp/ 目录（该目录已加入 .gitignore，不存在时自行创建）。
未被 .gitignore 忽略的文件不得包含敏感数据。
未经允许，不要使用 adb 连接设备进行调试。
不要为那些不可能发生的场景添加错误处理、回退逻辑或校验。应当信任内部代码以及框架提供的保证。只在系统边界处进行校验，例如用户输入、外部 API 等，防止过度工程化编程。 UI 界面上所有文案必须是站在使用者角度、可直接交付的最终产品语言，不得出现描述需求/规则/适用条件本身的元语言。
被要求写 commit 时，只撰写 conventional commit 文案，不要执行 commit 和 push（除非用户提到）， 内容应当描述最后一个「最后一个 commit → 当前工作区」的整体 diff， 而不应该提及本次实现过程中的尝试、报错、排查、返工或中间修正的迭代过程。 在保持 conventional commit 格式与描述准确的前提下，根据改动性质兼顾后续整理面向用户的更新内容：涉及用户可感知的变化时，优先写清新增能力、体验改善、问题修复及其实际影响等，便于后续提炼为更新日志、版本说明等内容。 这不是所有提交的固定写法；纯内部重构、构建配置、测试维护等改动，应以清晰准确的技术描述为主，无需强行套用面向用户的口吻或夸大用户收益。
可用的参考资料：
- 桌面端参考项目：
../BiliTools_Desktop—— 对齐功能行为时参考 - 哔哩哔哩 API 文档：
../bilibili-API-collect—— 凡涉及 B 站接口，一律先查此文档，不要凭记忆猜测字段与参数 - 配色系统：
docs/配色系统/—— 主题色板、角色约定、生成器与回归校验；三个配色 XML 由其中的gen_themes.py产出，不要手改
默认无需阅读 .devfiles/ 下的文件（除非提到），且禁止做任何修改。