{"id":28160136,"url":"https://github.com/daymade/pkuxkx-mud-agent","last_synced_at":"2025-05-15T10:14:14.427Z","repository":{"id":289510116,"uuid":"971492473","full_name":"daymade/pkuxkx-mud-agent","owner":"daymade","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-23T16:12:37.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T17:27:05.774Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daymade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-23T15:50:00.000Z","updated_at":"2025-04-23T16:12:41.000Z","dependencies_parsed_at":"2025-04-23T17:27:19.662Z","dependency_job_id":"f10f567f-8e8c-4b17-a3dd-3c1a674caad1","html_url":"https://github.com/daymade/pkuxkx-mud-agent","commit_stats":null,"previous_names":["daymade/pkuxkx-mud-agent"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daymade%2Fpkuxkx-mud-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daymade%2Fpkuxkx-mud-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daymade%2Fpkuxkx-mud-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daymade%2Fpkuxkx-mud-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daymade","download_url":"https://codeload.github.com/daymade/pkuxkx-mud-agent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254319660,"owners_count":22051076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-15T10:12:53.572Z","updated_at":"2025-05-15T10:14:14.420Z","avatar_url":"https://github.com/daymade.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PKUXKX MUD Agent\n\n这是一个用于北大侠客行（PKUXKX）MUD 游戏的命令行客户端。它提供了一个后台运行的游戏会话，通过命令行与游戏进行交互，并支持 Cursor AI 辅助模式。\n\n## 功能特点\n\n- 后台运行游戏会话\n- 支持 UTF-8 编码\n- 实时日志记录\n- 命令行交互（通过命名管道）\n- 自动重连机制\n- 信号处理和优雅退出\n- Cursor AI 辅助模式（计划中）\n\n## 系统架构\n\n```mermaid\ngraph TB\n    subgraph \"Cursor AI Layer\"\n        CursorAgent[Cursor Agent]\n        GameKnowledge[Game Knowledge]\n        ActionPlanner[Action Planner]\n    end\n\n    subgraph \"Core Components\"\n        TelnetConn[Telnet Connection]\n        InputHandler[Input Handler]\n        OutputHandler[Output Handler]\n        Logger[Logger]\n        StateTracker[State Tracker]\n    end\n\n    subgraph \"I/O Files\"\n        InputPipe[Input Pipe]\n        LogFile[Log File]\n        PidFile[PID File]\n        GameState[Game State]\n    end\n\n    subgraph \"MUD Server\"\n        Server[PKUXKX Server]\n    end\n\n    %% Core Flow\n    InputPipe --\u003e InputHandler\n    InputHandler --\u003e TelnetConn\n    TelnetConn \u003c--\u003e Server\n    TelnetConn --\u003e OutputHandler\n    OutputHandler --\u003e LogFile\n    Logger --\u003e LogFile\n\n    %% AI Flow\n    OutputHandler --\u003e StateTracker\n    StateTracker --\u003e GameState\n    GameState --\u003e GameKnowledge\n    GameKnowledge --\u003e ActionPlanner\n    ActionPlanner --\u003e CursorAgent\n    CursorAgent --\u003e InputHandler\n    \n    %% State Management\n    StateTracker --\u003e GameKnowledge\n    \n    classDef planned fill:#f9f,stroke:#333,stroke-dasharray: 5 5\n    class CursorAgent,GameKnowledge,ActionPlanner,StateTracker,GameState planned\n```\n\n## 技术实现\n\n### 核心组件\n- **Telnet Connection**: 负责与 MUD 服务器的网络通信\n- **Input Handler**: 处理来自命名管道的用户输入\n- **Output Handler**: 处理服务器返回的游戏输出\n- **Logger**: 日志记录系统，使用 rich 库提供美化输出\n\n### Cursor AI 组件（计划中）\n- **Cursor Agent**: AI 代理，负责游戏决策和行动\n- **Game Knowledge**: 游戏知识库，存储地图、物品、NPC等信息\n- **Action Planner**: 行动规划器，根据当前状态和目标生成行动序列\n- **State Tracker**: 状态追踪器，维护游戏世界状态\n\n### 运行时文件\n- **mud_output.log**: 游戏输出日志\n- **mud_input_pipe**: 命令输入管道\n- **mud.pid**: 进程 ID 文件\n- **game_state.json**: 游戏状态存储（计划中）\n\n## 安装和配置\n\n1. 克隆仓库：\n```bash\ngit clone https://github.com/daymade/pkuxkx-mud-agent.git\ncd pkuxkx-mud-agent\n```\n\n2. 安装依赖：\n```bash\npip install -r requirements.txt\n```\n\n3. 配置环境变量：\n```bash\ncp .env.example .env\n```\n然后编辑 `.env` 文件，填入你的账号信息：\n```\nMUD_HOST=mud.pkuxkx.net\nMUD_PORT=8081\nMUD_USERNAME=your_username\nMUD_PASSWORD=your_password\n```\n\n## 使用方法\n\n1. 后台启动代理：\n```bash\npython3 mud_agent.py \u0026\n```\n\n2. 查看游戏输出：\n```bash\ntail -f mud_output.log\n```\n\n3. 发送命令：\n```bash\necho \"命令\" \u003e mud_input_pipe\n```\n\n4. 停止代理：\n```bash\nkill $(cat mud.pid)\n```\n\n## 项目结构\n\n```\npkuxkx-mud-agent/\n├── mud_agent.py      # 主程序\n├── requirements.txt  # 依赖列表\n├── .env.example     # 环境变量示例\n├── .env            # 实际环境变量（不提交到git）\n├── .gitignore     # git忽略文件\n└── README.md      # 说明文档\n```\n\n## 依赖说明\n\n- python-dotenv (1.0.0): 用于加载环境变量\n- rich (10.16.2): 用于美化控制台输出\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 许可证\n\nMIT License ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaymade%2Fpkuxkx-mud-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaymade%2Fpkuxkx-mud-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaymade%2Fpkuxkx-mud-agent/lists"}