内容
# tangOS
一个用于逆向工程/反编译项目的统一品牌和工具包。
所有内容都读取 **每个仓库一个文件** - `tangos.json` - 一个描述符，它将任何反编译仓库（无论其布局如何）标准化为一个统一的词汇表。指向一个仓库的 tangOS 应用程序，它就会了解该仓库的工具、编译器、数据源和规则。
## 应用程序
| 应用程序 | 介绍 | 状态 |
|---|---|---|
| **tangOS 控制台** | 可下载的桌面应用程序。通过 **MCP 服务器** 将仓库的工具暴露给 AI 连接，并使用 **实时查看器** 实时观察 AI 的操作。 | 进行中 (`console/`) |
| **tangOS 文档** | 仓库工具的可浏览目录，根据 `tangos.json` 生成。 | 计划中 (`docs/`) |
| **tangOS 地图** | 进度地图/树形图（前身为 Chaos Viewer）。 | 计划更名 |
## 下载
**tangOS 控制台** 作为桌面应用程序发布，从该仓库的 [发布页面](https://github.com/tangosdev/tangOS/releases) 自动更新。
- **Windows** - 下载并运行安装程序；它会从此处自动更新。尚未签名，因此 Windows 会警告一次：点击 *更多信息*，然后 *仍然运行*。
- **macOS** - 下载 `.dmg` 文件（Intel 或 Apple Silicon）。由于未签名，右键单击应用程序并选择 *打开*（或运行 `xattr -cr "/Applications/tangOS Console.app"`）。
## 描述符：`tangos.json`
- 架构：[`schema/tangos.schema.json`](schema/tangos.schema.json)
- 参考示例：[`sm64ds-decomp/tangos.json`](https://github.com/tangosdev/sm64ds-decomp/blob/main/tangos.json)
- 尚未拥有 `tangos.json` 的仓库将由控制台（启发式扫描 + 可选 AI 优化）**生成** 描述符。
描述符声明了一个 `tools[]` 注册表；控制台将每个条目转换为 MCP 工具，因此 tangOS 本身保持与仓库无关，而仓库自己的工具则完成工作。
## 目录结构
```
tangOS/
├── schema/ tangos.json JSON 架构
├── packages/ui/ 共享的 Aero 主题令牌 + 玻璃组件
├── console/ Electron 控制台应用程序（MCP + 实时查看器）
└── docs/ 工具目录网站（计划中）
```
## 开发
```
npm install # 从仓库根目录（工作区）
npm run console # 在开发环境中启动控制台（electron-vite）
```
使用 Claude Code 构建。
MCP 市场