Pangolin 文档索引

全部设计 / 调研 / 排障文档汇总 · 单一入口

约定：新的设计文档 / 调研文档统一以 HTML 形式输出（深色家族风格，可直接 file:// 打开），并登记到本索引。历史 .md 文档保留原状、逐步迁移。

设计方案 / Specs

Pangolin Android 客户端设计方案 HTML

把 M2 纸面 PoC 推到真机端到端连通 + 切节点 + KillSwitch（清 TODO 11G）。里程碑 A–F、三处定调。

docs/android-client-design.html

iOS + iPad 支持设计方案 HTML

iOS 隧道从 PoC 桩推到真机连通 + TestFlight；五条工作线 + NE 50MB 内存闸门；iPad 横屏侧栏布局适配。

docs/ios-ipad-support-design.html

Windows 客户端设计 MD

Windows 端 sing-box 子进程 + wintun 隧道客户端设计。

docs/superpowers/specs/2026-06-21-windows-client-design.md

实现计划 / Plans

Android 客户端实现计划 MD

11 个任务：Go 1.24.3 工具链 → 构建 libbox.aar → 解析真实 API → Dart 接线 → 修原生编译 → 模拟器端到端 → 统计 → 切节点 → KillSwitch → 真机验证。

docs/superpowers/plans/2026-06-22-android-client.md

iOS + iPad 支持实现计划 HTML

阅读版；执行真相源为 docs/superpowers/plans/2026-06-22-ios-ipad-support.md（含 checkbox）。6 阶段 12 任务。

docs/ios-ipad-support-plan.html

Windows 客户端实现计划 MD

Windows 客户端的分步实现计划。

docs/superpowers/plans/2026-06-21-windows-client.md

统计体系整改实现计划（#5）HTML

阅读版；执行真相源为 docs/superpowers/plans/2026-06-24-stats-overhaul.md（含 checkbox）。三期：四端实时统计修复 → 每设备归因+GB综合配额 → 统计页重设计(上聚合·下分设备)。

docs/stats-overhaul-plan.html

知识库 / 调研

开发规范 · 可测试性五支柱 HTML

「怎么写才好测」——开发规范作为可测试性前置条件。五支柱（接缝即接口/契约单源/纯逻辑分离/错误是值/可观测）+ 支柱↔测试层咬合矩阵图 + 反例→真实bug→对应支柱对照表。与测试框架文档咬合。

docs/dev-conventions.html

统一测试框架 · 架构说明 HTML

多端项目可复用的分层测试方法论（L0 契约→L4 E2E）+ 四类诉求(界面一致/交互/数值/后端记账)→层→工具→量化指标映射 + 五张架构图（金字塔/契约接缝/CI 流水线/E2E 拓扑）。

docs/test-architecture.html

KillSwitch 设计与跨平台能力矩阵 HTML

断网保护 L0–L3 分级模型 + 各平台能力天花板 / 当前实现矩阵。KillSwitch 决策依据。

docs/killswitch-design.html

技术方案（总） MD

Pangolin 整体技术选型与架构方案。

docs/技术方案.md

VPN 内核内嵌 MD

sing-box 内核在各端的内嵌方式调研。

docs/vpn-core-embedding.md

VPN 测试调研 MD

VPN 黑盒测试方法与口径调研。

docs/vpn-testing-research.md

VPN 测试计划 MD

国内外站点矩阵 + 延迟/连通性测试计划。

docs/vpn-test-plan.md

排障 / Runbook

macOS 系统扩展 realize 失败（code=4）踩坑复盘 HTML

PacketTunnel 系统扩展无法激活的三个叠加配置 bug 排查与修复。

docs/macos-sysext-realize-troubleshooting.html

P1 macOS 系统扩展 MD

macOS 原生 System Extension 隧道方案说明。

docs/p1-macos-system-extension.md

节点重建检查单 MD

节点重装/重建的操作检查清单。

docs/node-rebuild-checklist.md

Scheduler Runbook MD

调度器运维手册。

docs/runbook-scheduler.md