Home

🧠 LAT Wiki 首页

欢迎来到 LAT (LoongArch Architecture Translator) 项目的 Wiki！

LAT 是一个面向 LoongArch 平台的二进制翻译器，用于在 LoongArch 上运行来自其他架构的应用程序。本 Wiki 提供关于 LAT 的原理、使用方式、调试方法和开发指南，帮助用户深入理解并有效使用本项目。

---

🚀 快速导航（Quick Navigation）

如果你是第一次接触 LAT，从这里开始：

• 编译与运行（TODO）
• 调试与问题定位指南
• 常见问题 FAQ（TODO）

---

📘 项目简介（Overview）

• LAT 是什么？它能做什么？
  LAT 负责在 LoongArch 平台上运行来自其他 CPU 架构的二进制程序，通过动态二进制翻译技术实时生成可执行代码，并将动态生成的指令缓存成静态文件，提高后续运行效率。

• 特点：

  • 面向 LoongArch 优化的翻译流程
  • 关注兼容性、稳定性与工程可落地性
  • 强调调试方法与问题归因
  • 支持 OS 等平台差异、系统调用、内存模型等多方面的兼容处理

• 典型工作流程：
  Fetch → Decode → Translate → Optimize → Execute → Cache

更多内容将逐步完善。

---

🛠️ 使用指南（User Guide）

用户相关文档将随着功能完善逐步开放：

• 运行参数与示例（TODO）

---

🔍 深入理解 LAT（Technical Deep Dive）

面向开发者与贡献者的技术分类文档

• 调试与问题定位指南

还需要什么文档？也许可以听听大家的声音。

---

🧩 指令集支持情况（ISA Support）

• 支持程度矩阵（TODO）
• 未支持指令收集（TODO）
• 指令语义验证方法（TODO）

---

🤝 贡献指南（For Contributors）

LAT 欢迎社区参与。以下文档将指导你如何参与开发：

• 代码结构说明（TODO）
• 开发环境建议与依赖（TODO）
• 如何参与 Issue / PR（TODO）
• Commit 规范（编码风格遵循 QEMU）

---

📝 项目版本与发布（Releases）

• 发布/里程碑策略（TODO）
• 回归测试（TODO）

---

📚 外部资源（References）

• LoongArch 相关公开文档 （TODO）
• Loongson ABI 文档 （TODO）
• QEMU / Box64 等相关项目 （TODO）

---

📫 社区与支持

• 问题反馈：请通过 Issues
• 技术交流：请通过 Discussions
• 代码贡献：欢迎通过 Pull Requests
• 高优先级问题：请在 Issue 中添加详细复现信息，维护者会尽快处理

---

LAT 项目仍在迭代中，Wiki 将持续补充完善。欢迎贡献文档、调试经验和改进建议！