dantech0xff/pencil-blade-2026
GitHub: dantech0xff/pencil-blade-2026
通过对遗失 Android 游戏的静态取证分析,以净室重构方式用 Cocos Creator 重新实现为可玩版本,同时提供完整的工程案例研究。
Stars: 2 | Forks: 0
Pencil Blade:重构一款遗失的游戏
一款无法运行的 Android 游戏,从静态证据被重构为可玩的 Cocos Creator 项目——全程未执行或嵌入原始 APK。
▶ 游玩重构版
·
探索取证分析
·
Tiếng Việt
Cocos Creator 3.8.8
TypeScript
Web Mobile + Android
源码可见 · 非商业用途
## 本项目存在的原因
原始的 *Pencil Blade 1.5* 包无法在本项目可用的现代 Android 设备上运行。在不使用模拟器包装旧二进制文件或凭记忆猜测的情况下,本次重构遵循了一条更严格的路径:
1. 从保留的包和资源清单中**提取静态证据**。
2. 从 Java、native 和 asset 关系中**恢复行为契约**。
3. 使用 TypeScript **净室重写游戏**,然后独立验证新的 Android 和 Web Mobile runtime。
每个结论都保持明确标记为**已恢复**、**推断**或**未知**。其结果是一个可玩的重构版本和一项可复现的工程案例研究——而非宣称与历史 runtime 完全一致。
## 可玩的重构版

01 · Main Menu
|

02 · Settled Mode Select
|

03 · Classic Ready
|

04 · Slice in Action
|
## 证据,而非凭空感觉
| 面 | 审查结果 |
|---|---|
| Native 分析 | `713/713` 个白名单 application 函数已通过调用、常量、字符串引用和审查状态进行丰富 |
| 资源核算 | `862/862` 个暂存 asset 已分类;`761` 个已连接到活跃的 runtime 消费者 |
| 声明记录 | `39` 项已审查声明:`38` 项已恢复的技术声明和 `1` 项未解决的权利声明 |
| 支持的输出 | 用于内部验证的 Android debug APK 和经过审计的 Web Mobile H5 |
这些分母描述了不同的证据面。它们被刻意分开,绝不能压缩成“100% 还原”的声明。
## 重构的组织方式
```
static evidence
↓
reviewed contracts + resource ledger
↓
clean-room TypeScript implementation
↓
Cocos Creator 3.8.8
↓
Android debug + Web Mobile H5 verification
```
| 路径 | 你会找到什么 |
|---|---|
| `game/` | Cocos Creator 项目、TypeScript gameplay、场景以及重构的资源集 |
| `forensics/` | 已审查声明、native/asset 分析、保真度记录和 runtime 观察结果 |
| `scripts/` | 故障关闭审计、数据生成、构建检查和捕获验证 |
| `docs/` | 方法、架构、兼容性、权利和重构报告 |
| `release/` | 独立的技术保留与公开/商业发布决策 |
## 在本地探索
最快的途径是托管的**[Play 启动器](https://dantech0xff.github.io/pencil-blade-2026/play/)**。要检查代码库:
```
git clone https://github.com/dantech0xff/pencil-blade-2026.git
cd pencil-blade-2026
# 在本地运行 documentary 站点。
npm --prefix site ci
npm --prefix site run dev
```
要检查游戏项目,请使用 **Cocos Creator 3.8.8** 打开 `game/`。本代码库有意不提供未经核实的单命令 Creator 构建。
## 阅读案例研究
- [项目概述](./docs/project-overview-pdr.md)
- [重构报告](./docs/reconstruction-report.md)
- [系统架构](./docs/system-architecture.md)
- [兼容性矩阵](./docs/compatibility-matrix.md)
- [发布权利核对表](./docs/release-rights-checklist.md)
## 范围与许可证
这是一个**非官方、非商业性、净室重构**项目。它不隶属于原始所有者、开发者或发行商。
- 原始 APK 仅用作静态证据;它从未在重构版本中被执行或嵌入。
- 本项目不宣称恢复了原始源码或与历史 runtime 完全一致。
- 贡献者拥有的重构代码和文档在 [PolyForm Noncommercial License 1.0.0](./LICENSE) 下提供。这是源码可见(source-available),而非 OSI 开源(open source)。
- 恢复或第三方的 artwork、音频、字体、名称和标识,并不会仅仅因为出现在本代码库中就获得许可。
- 学术演示不授予商业权利。在另行完成权利清算之前,公开/商业发布仍被阻止。
如果证据优先的游戏保存、净室重构或 Cocos 逆向工程对您有所帮助,请考虑为代码库加星——这有助于更多有保存意识的开发者发现这项工作。
标签:Cocos Creator, MITM代理, TypeScript, 云安全监控, 云资产清单, 净室重构, 安全插件, 安卓游戏, 游戏开发, 自动化攻击, 逆向工程, 静态分析