docs: 精简项目文档并清理 Ruff 问题

docs/README.md

@@ -1,52 +1,40 @@
 # 项目文档索引
 
-更新时间：2026-10-02
+更新时间：2026-11-06
 
-## 当前入口
+本文只列当前仍有维护价值、能直接用于开发或排查的文档。已被代码实现取代的
+一次性计划、事故经过和中间抓包记录已删除；需要追查历史时使用 Git 历史。
 
-- [自动化与资料收集规划](自动化与资料收集规划.md)：CK 自动管理、资料收集链接、皮肤台账与半自动工单的分期计划（规划中，未开工）。
-- [皮肤准入映射分析](皮肤准入映射分析.md)：C 桶皮肤类到斗鱼商品目录的归一与覆盖分析（923 个快手名 → 78 个斗鱼商品，覆盖率 40.1%）。
-- [虎牙 Cookie 路线状态](HUYA_COOKIE路线状态.md)：当前实现、字段状态、验证边界和后续工作。
-- [虎牙网页设备字段溯源](HUYA_WEB_FIELD_TRACE.md)：浏览器证据、字段来源和生成算法。
-- [虎牙 Cookie 合并审计与来源矩阵](HUYA_COOKIE合并审计与来源矩阵.md)：字段来源约束和合并策略。
-- [虎牙精英宝典联调指南](HUYA精英宝典联调指南.md)：工作台联调顺序和只读验证方法。
+## 当前使用
 
-## 虎牙业务与协议
+- [自动化与资料收集](自动化与资料收集.md)：账号巡检、CK 自动重登、资料刷新、订单读取、文件存储的运行规则。
+- [账号全生命周期](设计-账号全生命周期.md)：斗鱼账号状态、CK、事件流和自动化边界。
+- [虎牙外部 CK 协作台账](设计-虎牙外部CK协作台账.md)：外部订单、CK、业务状态、核账、归档和权限规则。
+- [虎牙 Cookie 路线状态](虎牙/HUYA_COOKIE路线状态.md)：当前 Cookie 字段来源、已完成链路和已知边界。
+- [虎牙浏览器兑换](虎牙/HUYA_BROWSER_EXCHANGE.md)：人工兑换页面、扩展注入和目标页说明。
+- [虎牙精英宝典联调指南](虎牙/HUYA精英宝典联调指南.md)：WSS/HTTP 选路和联调验收流程。
+- [小X分身虎牙 CK 提取](虎牙/分身CK提取.md)：ADB、WebView Cookie 与 cred0 解密提取流程。
+- [精英宝典 HAR 提取](虎牙/HAR提取CK与积分中心.md)：HAR 中的完整 CK、积分中心和商品结构。
+- [皮肤准入映射分析](皮肤准入映射分析.md)：快手皮肤订单到斗鱼商品的覆盖与映射边界。
 
-- [虎牙精英宝典 9.1 全流程分析](HUYA_精英宝典-9.1-全流程分析.md)
-- [虎牙精英宝典后端与抓包对照](HUYA_精英宝典-后端与9.1抓包对照.md)
-- [虎牙精英宝典 8.31 Python 重分析](HUYA_精英宝典-8.31-PY重新分析.md)
-- [虎牙精英宝典联调指南](HUYA精英宝典联调指南.md)
-- [网页 Cookie 缺失字段历史方案](HUYA_CHAT_缺失字段补齐方案.md)
-- [虎牙 App 登录总览](HUYA_APP_OVERVIEW.md)
-- [虎牙纯 Python 自动登录总结](虎牙纯Python全自动登录-总结与交接.md)
+## 协议与逆向证据
 
-## 虎牙设备与加密逆向
-
-- [HDID 算法生成](HUYA_HDID_ALGORITHM_GEN.md)
-- [HDID 研究记录](HUYA_HDID_RESEARCH.md)
-- [标识符命名规范](HUYA_ID_NOMENCLATURE.md)
-- [铸币机终局总结](HUYA_铸币机-终局总结.md)
-- [App 登录协议抓包实证](虎牙App密码登录协议-抓包实证.md)
-- [App 登录 WUP 明文抓包](虎牙App密码登录-WUP明文抓包.md)
-- [App 登录加密算法动态验证](虎牙App登录-加密算法动态验证.md)
-- [App 登录 APK 静态分析](虎牙App登录-APK静态分析.md)
-- [App 登录逆向笔记](虎牙App登录逆向笔记.md)
-- [扫码登录闭环逆向](虎牙扫码登录闭环逆向.md)
-- [hyCred 签发侦察笔记](虎牙hyCred签发-侦察笔记.md)
-
-## 设备注册与运行工具
-
-- [dfpReport 生成流程](dfpReport生成流程.md)
-- [dfpReport 破解进度](dfpReport破解进度.md)
-- [Frida 绕过配方](Frida绕过配方.md)
-- [Hook 脚本运行与捕获约定](Hook脚本运行与捕获约定.md)
-- [模拟器存活闪退诊断](模拟器存活闪退诊断报告.md)
-- [登录系统全流程定案](登录系统全流程定案.md)
+- [虎牙 App 协议总览](虎牙/HUYA_APP_OVERVIEW.md)：先看这一篇，再按需进入算法或登录细节。
+- [设备标识命名规范](虎牙/HUYA_ID_NOMENCLATURE.md)：GUID32、HDID32、DEVID40、MID16、ACTION 的统一口径。
+- [网页设备字段溯源](虎牙/HUYA_WEB_FIELD_TRACE.md)：浏览器实测字段来源和生成规则。
+- [Cookie 合并审计与来源矩阵](虎牙/HUYA_COOKIE合并审计与来源矩阵.md)：每个字段允许从哪里来。
+- [HDID 研究记录](虎牙/HUYA_HDID_RESEARCH.md)：32hex 登录 hdid 的证据边界。
+- [HDID 算法生成路径](虎牙/HUYA_HDID_ALGORITHM_GEN.md)：doLaunch、服务端签发和相关实验。
+- [dfpReport 生成流程](虎牙/dfpReport生成流程.md)：设备注册链已破解与未破解部分。
+- [App 登录加密算法动态验证](虎牙/虎牙App登录-加密算法动态验证.md)：XXTEA/AES/arg7/key 来源。
+- [虎牙证书算法闭环](虎牙/虎牙证书算法闭环-差分实证.md)：biz_token 结构、AES 与重铸验证。
+- [扫码登录闭环逆向](虎牙/虎牙扫码登录闭环逆向.md)：qrLgn 协议、wupData 和证书边界。
+- [Frida 绕过配方](虎牙/Frida绕过配方.md)：当前稳定注入流程与失败方案。
+- [Hook 脚本运行与捕获约定](虎牙/Hook脚本运行与捕获约定.md)：脱敏、落盘和复现约定。
 
 ## 鱼翅充值接口
 
-- [对接信息](鱼翅充值api/对接信息.md)
+- [对接说明](鱼翅充值api/对接信息.md)：环境变量和接口入口；供应商凭据不入库、不写文档。
 - [账户信息查询](鱼翅充值api/账户接口/账户信息查询.md)
 - [创建订单](鱼翅充值api/订单接口/1.创建订单_必要.md)
 - [查询订单](鱼翅充值api/订单接口/2.查询订单_必要.md)
@@ -54,7 +42,7 @@
 
 ## 文档约定
 
-1. 带日期的抓包和逆向笔记属于历史证据，结论以对应日期为准。
-2. 当前代码行为和未完成项以“虎牙 Cookie 路线状态”为准。
-3. Cookie、UID、订单号和设备标识进入文档时使用脱敏值；真实数据只保存在本地 evidence 目录。
+1. 代码是当前行为的最终依据；文档只记录代码难以直接表达的协议、边界和排查路径。
+2. 带日期的逆向记录是当时证据，不能覆盖后来代码中的已验证结论。
+3. Cookie、UID、订单号、手机号和设备标识必须脱敏；凭据只放环境变量或权限为 `0600` 的本地文件。
 4. 兑换、下单和支付属于写操作，除非明确确认，不纳入自动回归测试。