feat<docs>: update repo docs

Author: AuraElicase

.gitignore

@@ -25,3 +25,5 @@ run
 
 # Files from Forge MDK
 forge*changelog.txt
+deep-research-report.md
+DEV.md

AGENTS.md

@@ -0,0 +1,58 @@
+# Agents 角色与职责
+
+## 1. RequirementAgent （需求分析）
+- **职责**：拆解整体需求，产出明确的功能需求列表和模块任务分解。  
+- **示例提示**：请根据项目背景，列出实现 OSC 聊天功能所需的主要组件和接口，以及它们的功能描述。  
+- **交互示例**：
+  - **User**: “需要实现 VRChat OSC 聊天模块，请拆解任务。”
+  - **Agent**: 提供 OSC 接收、解析、权限验证、消息队列、主线程派发等任务。
+
+## 2. DesignAgent （架构设计）
+- **职责**：根据需求分析结果，设计系统架构图和模块类图，定义模块之间接口和数据流。  
+- **示例提示**：绘制组件关系图（drawio），并说明每个模块的责任和接口。  
+- **输出**：drawio 类图/流程图、模块职责说明表。
+
+## 3. ParserAgent （协议解析）
+- **职责**：实现或使用 OSC 协议解析功能，包括字节流与 OSCMessage 的互转。  
+- **提示模板**：`请实现OSC协议解析功能，包括 Address Pattern 和 Type Tags 的解析，遵循OSC 1.0规范。`  
+- **测试用例**：传入不同类型的OSC消息字节数组，验证解析结果是否正确。
+
+## 4. ChatEventAgent （消息处理）
+- **职责**：将OSC消息转换为内部ChatEvent对象，并执行权限和内容检查。  
+- **提示示例**：`处理接收到的OSC消息，如果地址为"/vrchat/chat"且来源信任，则创建ChatEvent并加入队列。否则记录日志并丢弃。`  
+- **测试案例**：传入合法与非法的OSC消息，确认队列接收和拒绝日志。
+
+## 5. DispatcherAgent （Minecraft注入）
+- **职责**：在Minecraft主线程中消费消息队列，将ChatEvent内容注入服务器聊天。  
+- **提示示例**：`订阅Forge的Tick事件，从队列取消息并调用MinecraftAPI发送聊天信息。确保线程安全。`  
+- **测试案例**：启动虚拟服务器，检查收到OSC消息后是否正确在聊天框显示。
+
+## 6. TestAgent （自动化测试）
+- **职责**：编写单元/集成测试用例，验证核心功能与接口契约。  
+- **提示示例**：`为OscReceiver编写单元测试：模拟UDP数据包，验证解析结果。`  
+- **执行**：使用JUnit测试消息解析、权限过滤、日志输出等。
+
+# 示例交互
+1. **设计交互**：  
+   - 提示：`绘制包括OscReceiver、PermissionManager、ForgeAdapter的系统流程图。`  
+   - Agent输出：Mermaid流程图代码。  
+
+2. **代码交互**：  
+   - 提示：`在OscReceiver的onPacketReceived方法加入错误处理：当解析异常时记录日志并跳过该消息。`  
+   - Agent输出：Java代码片段更新。  
+
+# 自动文档与注释生成
+- 使用语言模型自动补全注释：提供方法签名和简短说明，请 LLM 展开详细注释说明。
+- 示例模板：`/** * 方法功能：解析OSC消息并调用handler。参数说明：... */`。
+
+# 任务分解清单
+- OSC 接收服务
+- OSC 消息解析
+- 权限验证模块
+- 消息队列
+- Minecraft 事件订阅与注入
+- 配置和日志模块
+- 单元/集成测试
+- CI/CD 配置
+
+@RTK.md

CREDITS.txt

@@ -0,0 +1,65 @@
+Minecraft Forge: Credits/Thank You
+
+Forge is a set of tools and modifications to the Minecraft base game code to assist 
+mod developers in creating new and exciting content. It has been in development for 
+several years now, but I would like to take this time thank a few people who have 
+helped it along it's way.
+
+First, the people who originally created the Forge projects way back in Minecraft 
+alpha. Eloraam of RedPower, and SpaceToad of Buildcraft, without their acceptiance 
+of me taking over the project, who knows what Minecraft modding would be today.
+
+Secondly, someone who has worked with me, and developed some of the core features
+that allow modding to be as functional, and as simple as it is, cpw. For developing
+FML, which stabelized the client and server modding ecosystem. As well as the base
+loading system that allows us to modify Minecraft's code as elegently as possible.
+
+Mezz, who has stepped up as the issue and pull request manager. Helping to keep me
+sane as well as guiding the community into creating better additions to Forge.
+
+Searge, Bspks, Fesh0r, ProfMobious, and all the rest over on the MCP team {of which 
+I am a part}. For creating some of the core tools needed to make Minecraft modding 
+both possible, and as stable as can be.
+  On that note, here is some specific information of the MCP data we use:
+    * Minecraft Coder Pack (MCP) *
+      Forge Mod Loader and Minecraft Forge have permission to distribute and automatically 
+      download components of MCP and distribute MCP data files. This permission is not 
+      transitive and others wishing to redistribute the Minecraft Forge source independently
+      should seek permission of MCP or remove the MCP data files and request their users 
+      to download MCP separately.
+      
+And lastly, the countless community members who have spent time submitting bug reports, 
+pull requests, and just helping out the community in general. Thank you.
+
+--LexManos
+
+=========================================================================
+
+This is Forge Mod Loader.
+
+You can find the source code at all times at https://github.com/MinecraftForge/MinecraftForge/tree/1.12.x/src/main/java/net/minecraftforge/fml
+
+This minecraft mod is a clean open source implementation of a mod loader for minecraft servers
+and minecraft clients.
+
+The code is authored by cpw.
+
+It began by partially implementing an API defined by the client side ModLoader, authored by Risugami.
+http://www.minecraftforum.net/topic/75440-
+This support has been dropped as of Minecraft release 1.7, as Risugami no longer maintains ModLoader.
+
+It also contains suggestions and hints and generous helpings of code from LexManos, author of MinecraftForge.
+http://www.minecraftforge.net/
+
+Additionally, it contains an implementation of topological sort based on that 
+published at http://keithschwarz.com/interesting/code/?dir=topological-sort
+
+It also contains code from the Maven project for performing versioned dependency
+resolution. http://maven.apache.org/
+
+It also contains a partial repackaging of the javaxdelta library from http://sourceforge.net/projects/javaxdelta/
+with credit to it's authors.
+
+Forge Mod Loader downloads components from the Minecraft Coder Pack
+(http://mcp.ocean-labs.de/index.php/Main_Page) with kind permission from the MCP team.
+