tranduong29/Shockwave-Revival-Kit
GitHub: tranduong29/Shockwave-Revival-Kit
开源 Flash SDK 与运行时环境，用于反编译、分析、转换并在现代浏览器中无插件运行遗留 SWF 内容。
Stars: 0 | Forks: 0
# 🚀 LibreFlashpoint：开源 Adobe Flash SDK 与运行时环境
[](https://tranduong29.github.io)
## 🌟 项目愿景：重燃互动数字遗产
LibreFlashpoint 是一项全面的、由社区驱动的计划，旨在保存、分析和复兴最初使用 Adobe Flash 创建的交互式内容。与仅捕获静态截图的传统保存方法不同，LibreFlashpoint 通过先进的 SDK、反编译工具包和现代运行时环境，为 Flash 应用程序注入了新的生命。想象一下，在一个考古实验室中，古老的互动文物不仅得到了保存，而且还能在现代系统上完全运行——这就是我们的使命。
诞生于 LibreShockwave 等项目的遗产之上，LibreFlashpoint 将视野扩展到曾经为互动网络提供动力的庞大 Flash 内容生态系统。我们为创作者、研究人员和爱好者提供工具，以便不受限制地探索、修改和重新部署这些数字体验。
## 📦 立即获取
最新的稳定版、源代码和文档均已开放获取。
[](https://tranduong29.github.io)
## 📖 目录
- [✨ 独特功能](#-distinctive-capabilities)
- [⚙️ 系统先决条件](#️-system-prerequisites)
- [🚀 入门指南](#-commencement-guide)
- [🔧 配置文件示例](#-profile-configuration-example)
- [💻 控制台调用示例](#-example-console-invocation)
- [📊 架构概览](#-architectural-overview)
- [🌐 操作系统兼容性](#-operational-system-compatibility)
- [🛠️ 集成 AI 认知服务](#️-integration-with-ai-cognition-services)
- [⚠️ 重要提示](#️-essential-notice)
- [🤝 社区贡献](#-community-contribution)
- [📄 许可信息](#-licensing-information)
## ✨ 独特功能
* **高级反编译引擎：** 将编译后的 SWF 二进制文件还原为人类可读的 ActionScript 和资源定义，支持最高至 Flash Player 32 的版本。
* **现代运行时环境：** 基于 WebAssembly 和 WebGL 构建的安全沙盒 Web 播放器，无需传统插件即可在现代浏览器中直接渲染内容。
* **完整 SDK 套件：** 包含全面的工具，用于使用现代开发工作流编译、调试和打包与 Flash 相当的项目。
* **自适应界面：** 响应式控制面板，可适应桌面、平板和移动设备屏幕，在各种设备上提供最佳的工具访问体验。
* **语言灵活性：** 内置支持多种界面语言，并配备社区驱动的翻译系统。
* **持续协助：** 可访问由社区管理的支持渠道和文档，并由全球各时区的贡献者全天候维护。
* **资产管线：** 将旧版 Flash 资产（SPR、FLA）转换为现代格式（SVG、PNG 精灵图、WebM），同时保留动画时间轴。
* **交互式调试器：** 对原始和反编译内容提供单步执行、变量检查和网络调用监控功能。
## ⚙️ 系统先决条件
* **处理器：** x86-64 或 ARM64 架构。
* **内存：** 至少 4 GB RAM（处理复杂项目建议 8 GB）。
* **存储：** 2 GB 可用空间。
* **操作系统：** 见下文兼容性表格。
* **软件依赖：** Python 3.9+、Node.js 18+、CMake 3.20+。
## 🚀 入门指南
1. **获取发行版：** 从本文档顶部和底部提供的链接获取适合您系统的软件包。
2. **解压归档：** 将下载的压缩包解压到您选择的目录中。
3. **环境初始化：** 在终端中导航至解压后的文件夹，并执行安装脚本：
cd LibreFlashpoint
./scripts/setup_env.sh # On Linux/macOS
# 或
scripts\setup_env.bat # On Windows
4. **启动控制面板：** 启动图形界面以开始操作。
./libreflashpoint gui
5. **探索示例：** 打开 `examples/` 目录，以试用预置的 SWF 文件。
## 🔧 配置文件示例
用户特定的设置在 `~/.config/libreflashpoint/config.yaml` 中进行管理。这允许对工具链进行深度自定义。
```
# LibreFlashpoint 用户配置
user:
name: "Developer"
interface_language: "en-US" # Options: en-US, ja-JP, es-ES, fr-FR, de-DE
decompiler:
output_format: "typescript" # as2, as3, javascript, typescript
generate_source_maps: true
aggressive_rename: false
runtime:
graphics_backend: "webgl" # canvas, webgl
audio_emulation: "high-fidelity" # legacy, high-fidelity
max_execution_cycles: 10000
ai_integration:
openai_enabled: false
openai_base_url: "https://api.openai.com/v1"
openai_model: "gpt-4-turbo"
anthropic_enabled: false
anthropic_base_url: "https://api.anthropic.com"
anthropic_model: "claude-3-opus-20240229"
network:
allow_remote_fetch: true
local_asset_port: 8080
```
## 💻 控制台调用示例
命令行界面提供了强大的、可编写脚本的控制功能，用于自动化和集成到构建管线中。
```
# 将 SWF 文件反编译为现代 TypeScript 项目
libreflashpoint decompile --input legacy_game.swf --output ./remastered_src --format typescript
# 在本地提供并运行 SWF 项目以进行测试
libreflashpoint run --project ./my_flash_project --port 3000 --open-browser
# 将一批 FLA 资源文件转换为 sprite atlas
libreflashpoint assets convert --input ./assets/*.fla --output ./public/sprites.png --format spritesheet
# 分析 SWF 的结构并生成安全报告
libreflashpoint analyze --input advertisement.swf --report security,performance
```
## 📊 架构概览
下图说明了 LibreFlashpoint 内部的核心数据流和组件交互：
```
graph TD
A[Legacy SWF/FLA Input] --> B{Decompilation Engine};
B --> C[ActionScript AST];
B --> D[Extracted Media Assets];
C --> E[Code Transformation];
D --> F[Asset Modernization];
E --> G[Modern JS/TS Output];
F --> H[SVG/WebM/PNG Output];
G --> I[Runtime Environment];
H --> I;
I --> J[Web-Based Player];
I --> K[Native Embed SDK];
J --> L[End-User Browser];
K --> M[Desktop/Mobile App];
subgraph "AI Cognition Layer"
N[OpenAI API] --> O[Code Analysis & Documentation];
P[Claude API] --> Q[Interactive Tutorial Generation];
end
E -.-> N;
I -.-> P;
```
## 🌐 操作系统兼容性
| 平台 | 状态 | 备注 |
| :--- | :--- | :--- |
| **Windows 10/11** | ✅ 完全运行 | 提供原生可执行文件。建议使用 DirectX 11。 |
| **macOS 12+** | ✅ 完全运行 | 适用于 Intel 和 Apple Silicon 的通用二进制文件。 |
| **Linux (Ubuntu 22.04+)** | ✅ 完全运行 | AppImage 和原生软件包格式。 |
| **ChromeOS** | ⚠️ 部分运行 | 需要启用 Linux 环境 (Crostini) 以运行完整工具链。 |
| **BSD 变体** | 🔁 社区支持 | 端口由贡献者网络维护。 |
| **Web 浏览器** | ✅ 核心运行时 | 播放器组件可直接在 Chrome、Firefox、Safari 15+ 中运行。 |
## 🛠️ 集成 AI 认知服务
LibreFlashpoint 可选择与领先的 AI 认知平台集成，以增强开发体验。
* **OpenAI API 集成：** 在配置中启用后，反编译器可以利用 GPT 模型生成文档、重构反编译后的代码以提高可读性，并为旧版 ActionScript 模式建议现代的 JavaScript 等效实现。
* **Anthropic Claude API 集成：** 可以利用 Claude 模型从分析过的 SWF 文件生成交互式的分步教程，解释原始代码结构并提出保存策略建议。
这些集成是选择加入的，并需要您自己的 API 凭证。所有通信均可配置为指向官方端点或自托管的替代方案。
## ⚠️ 重要提示
LibreFlashpoint 是一款用于**保存、教育和互操作性**的工具。其旨在实现：
* 对具有历史意义的互动媒体进行归档。
* 对旧版游戏和应用程序设计进行研究。
* 在无法获取原始源代码的情况下，对项目进行现代化改造和延续。
本项目不隶属于、未受认可也并未与 Adobe Inc. 建立联系。“Adobe Flash”是 Adobe Inc. 的注册商标。不允许使用此工具绕过您未获得权利所有者明确许可的软件或内容的访问控制。贡献者不对本软件的使用或误用承担任何责任。
## 📄 许可信息
版权所有 © 2026 LibreFlashpoint 贡献者。
本项目基于 **MIT License** 发布。此宽松许可证允许重复使用、修改和分发，仅要求在所有副本中保留原始版权和许可声明。
有关完整的法律条款，请参阅发行版中包含的 [LICENSE](https://tranduong29.github.io) 文件，或在线查看仓库源码。
### 🎯 准备好开始保存数字历史了吗？
获取工具包，立即开始探索互动遗产。
[](https://tranduong29.github.io)
标签：Adobe Flash, AI工具, AI集成, Bash脚本, Flash Player, LibreFlash, LibreFlashpoint, MITM代理, 互动内容, 内容保存, 反编译工具, 多媒体, 安全头部检测, 开源, 数字考古, 数字遗产, 数据可视化, 桌面应用, 游戏引擎, 生成式AI安全, 老旧系统兼容, 虚拟机, 运行时, 逆向工具