[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MaxBittker--rs-sdk":3,"tool-MaxBittker--rs-sdk":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",147882,2,"2026-04-09T11:32:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":79,"owner_twitter":80,"owner_website":81,"owner_url":82,"languages":83,"stars":107,"forks":108,"last_commit_at":109,"license":110,"difficulty_score":111,"env_os":112,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":118,"github_topics":77,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":119,"updated_at":120,"faqs":121,"releases":122},5915,"MaxBittker\u002Frs-sdk","rs-sdk","Runescape automation library, optimized for use by coding agents.","rs-sdk 是一个专为类《鲁恩斯科》（Runescape）风格的大型多人在线角色扮演游戏设计的自动化开发套件，旨在为编码智能体（Coding Agents）提供优化的研究与测试环境。它解决了在复杂经济体系和互动机制中，难以安全、高效地评估 AI 智能体自主决策、长期规划及多智能体协作能力的难题。\n\n这套工具非常适合 AI 研究人员、开发者以及对智能体技术感兴趣的技术爱好者使用。通过内置的服务器模拟器和 TypeScript SDK，用户无需担心真实游戏环境中的封号风险或伦理限制，即可在隔离的沙盒中训练机器人完成从新手到满级的全流程任务。项目特别针对“目标导向的程序合成”技术进行了优化，支持研究智能体间的竞争与合作策略，并提供了公开的排行榜和模型基准测试数据以量化评估效果。\n\nrs-sdk 的独特亮点在于其“开箱即用”的特性与高度可定制的游戏规则。为了加速开发迭代，模拟环境移除了反挂机随机事件，并提供无限奔跑能量和加速升级曲线。其架构采用网关模式，连接增强版 Web 客户端与后端模拟器，既支持直接连接公共演示服务器快速上手，也允许开发者本地部署以调整游戏 tick 率，满足高性能无头测","rs-sdk 是一个专为类《鲁恩斯科》（Runescape）风格的大型多人在线角色扮演游戏设计的自动化开发套件，旨在为编码智能体（Coding Agents）提供优化的研究与测试环境。它解决了在复杂经济体系和互动机制中，难以安全、高效地评估 AI 智能体自主决策、长期规划及多智能体协作能力的难题。\n\n这套工具非常适合 AI 研究人员、开发者以及对智能体技术感兴趣的技术爱好者使用。通过内置的服务器模拟器和 TypeScript SDK，用户无需担心真实游戏环境中的封号风险或伦理限制，即可在隔离的沙盒中训练机器人完成从新手到满级的全流程任务。项目特别针对“目标导向的程序合成”技术进行了优化，支持研究智能体间的竞争与合作策略，并提供了公开的排行榜和模型基准测试数据以量化评估效果。\n\nrs-sdk 的独特亮点在于其“开箱即用”的特性与高度可定制的游戏规则。为了加速开发迭代，模拟环境移除了反挂机随机事件，并提供无限奔跑能量和加速升级曲线。其架构采用网关模式，连接增强版 Web 客户端与后端模拟器，既支持直接连接公共演示服务器快速上手，也允许开发者本地部署以调整游戏 tick 率，满足高性能无头测试的需求。这是一个连接理论算法与复杂虚拟世界实践的理想桥梁。","# RS-SDK\n\nResearch-oriented starter kit for runescape-style bots, including a typescript sdk, agent documentation and bindings, and a server emulator. Works out of the box - tell it what to automate! \n\n\u003Cdiv align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMaxBittker_rs-sdk_readme_0c97e36f6d8d.gif\" alt=\"RS-SDK Demo\" width=\"800\">\n\u003C\u002Fdiv>\n\n[![Discord](server\u002Fcontent\u002Ftitle\u002Fdiscord.svg)](https:\u002F\u002Fdiscord.gg\u002F3DcuU5cMJN)\n[![Hiscores](server\u002Fcontent\u002Ftitle\u002Fhiscores.svg)](https:\u002F\u002Frs-sdk-demo.fly.dev\u002Fhiscores)\n\nBuild and operate bots within a complex economic role-playing MMO. You can automate the game, level an account to all 99s, and experiment with agentic development techniques within a safe, bot-only setting.\n\nThe goals of this project are to provide a rich testing environment for goal-directed program synthesis techniques (Ralph loops, etc), and to facilitate research into collaboration and competition between agents.\n\n![Task Length Distribution](server\u002Fcontent\u002Ftitle\u002Ftask_length.svg)\n\nThere is currently a [leaderboard](https:\u002F\u002Frs-sdk-demo.fly.dev\u002Fhiscores) for bots running on the demo server, with rankings based on highest total level per lowest account playtime.\n\nSee the [benchmark comparing models](https:\u002F\u002Fgithub.com\u002FMaxBittker\u002Frs-bench) for evaluation results across different LLMs.\n\n> [!NOTE]\n> RS-SDK is a fork of the LostCity engine\u002Fclient, an amazing project without which rs-sdk would not be possible. \n> Find their [code here](https:\u002F\u002Fgithub.com\u002FLostCityRS\u002FServer) or read their [history and ethos](https:\u002F\u002Flostcity.rs\u002Ft\u002Ffaq-what-is-lost-city\u002F16)\n## Getting Started:\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002FMaxBittker\u002Frs-sdk.git\n```\n\nOut of the box, you can connect to the provided demo server, choose a name that is not already taken!\n\nWith claude code:\n```sh\nbun install\nclaude \"start a new bot with name: {username}\"\n```\nManually:\n```sh\nbun install\nbun bots\u002Fcreate-bot.ts {username}\nbun bots\u002F{username}\u002Fscript.ts \n```\n\nChat is off by default to prevent scamming and prompt injection attacks, but you can opt in  with `SHOW_CHAT=true` in the bot.env file\n\nWarning: The demo server is offered as a convenience, and we do not guarantee uptime or data persistence. Hold your accounts lightly, and consider hosting your own server instance. Please do not manually play on the demo server. \n\n\n\n\n## Gameplay Modifications\n\nThis server has a few modifications from the original game to make development and bot testing easier:\n\n- **Faster leveling** - The XP curve is accelerated and less steep.\n- **Infinite run energy** - Players never run out of energy \n- **No random events** - Anti-botting random events are disabled \n\n\n## Architecture:\n\nrs-sdk runs against an enhanced web-based client (`botclient`) which connects to the LostCity 2004scape server emulator.\n\nThere is a gateway server which accepts connections from botclient and SDK instances, and forwards messages between them based on username.\nOnce connected to the gateway, the botclient will relay game state to the SDK, and execute low-level actions (e.g. `walkTo(x,y)`) sent from the SDK through the gateway.\n\nThis means that the SDK can't talk directly to the game server, but must go through the botclient. It will attempt to launch the botclient on startup if one is not already running. \n\nYou don't need to run the gateway\u002Fbotclient in order to run automations against the demo server, but you may choose to if you are fixing bugs or adding features to the rs-sdk project\n\n\n## Running the server locally\n\nRunning the server locally has many advantages, primary being the ability to set a high tickrate. \n\nYou can set tickrate in `server\u002Fengine\u002F.env` via the `TICK_RATE` variable (default is 600ms, try 200ms or 30ms for faster gameplay, especially useful for headless testing).\n\nYou want all three of these running: \n\n```sh\n# Game engine\ncd server\u002Fengine && bun run start\n```\n```sh\n# Web client bundler\ncd server\u002Fwebclient && bun run watch\n```\n```sh\n# Gateway (bridges SDK \u003C-> bot client)\ncd server\u002Fgateway && bun run gateway\n```\n\nThe gateway listens on `ws:\u002F\u002Flocalhost:7780` by default (configurable via `AGENT_PORT` env var).\n\n\n### 2. Connect a bot to the local gateway\n\nThe `SERVER` variable in `bot.env` controls where the bot connects. To use your local gateway, **leave `SERVER` blank**:\n\n```bots\u002F\u003Cbotname>\u002Fbot.env\nBOT_USERNAME=mybot\nPASSWORD=test\nSERVER=\nSHOW_CHAT=false\n```\n\nWhen `SERVER` is empty, all connection paths (scripts, CLI) default to `ws:\u002F\u002Flocalhost:7780`.\n\nWhen `SERVER` is set to a hostname (e.g. `rs-sdk-demo.fly.dev`), they connect to `wss:\u002F\u002F{SERVER}\u002Fgateway` instead.\n\n\n\n## Disclaimer\n\nThis is a free, open-source, community-run project.\n\nThe goal is strictly education and scientific research.\n\nLostCity Server was written from scratch after many hours of research and peer review. Everything you see is completely and transparently open source.\n\nWe have not been endorsed by, authorized by, or officially communicated with Jagex Ltd. on our efforts here.\n\nYou cannot play Old School RuneScape here, buy RuneScape gold, or access any of the official game's services! Bots developed here will not work on the official game servers.\n\n\n## License\nThis project is licensed under the [MIT License](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT). See the [LICENSE](LICENSE) file for details.\n","# RS-SDK\n\n面向研究的Runescape风格机器人入门套件，包含TypeScript SDK、代理文档与绑定，以及服务器模拟器。开箱即用——只需告诉它要自动化什么！\n\n\u003Cdiv align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMaxBittker_rs-sdk_readme_0c97e36f6d8d.gif\" alt=\"RS-SDK演示\" width=\"800\">\n\u003C\u002Fdiv>\n\n[![Discord](server\u002Fcontent\u002Ftitle\u002Fdiscord.svg)](https:\u002F\u002Fdiscord.gg\u002F3DcuU5cMJN)\n[![Hiscores](server\u002Fcontent\u002Ftitle\u002Fhiscores.svg)](https:\u002F\u002Frs-sdk-demo.fly.dev\u002Fhiscores)\n\n在复杂的经济角色扮演MMO中构建和运行机器人。你可以自动化游戏进程，将一个账号练到所有技能99级，并在一个完全由机器人组成的安全环境中尝试智能体开发技术。\n\n该项目的目标是为以目标为导向的程序合成技术（如Ralph循环等）提供丰富的测试环境，并促进对智能体之间协作与竞争的研究。\n\n![任务长度分布](server\u002Fcontent\u002Ftitle\u002Ftask_length.svg)\n\n目前有一个在演示服务器上运行的机器人排行榜（https:\u002F\u002Frs-sdk-demo.fly.dev\u002Fhiscores），排名依据是每个账号在最短游戏时间内达到的总等级最高值。\n\n有关不同LLM的评估结果，请参阅[模型比较基准](https:\u002F\u002Fgithub.com\u002FMaxBittker\u002Frs-bench)。\n\n> [!注意]\n> RS-SDK是LostCity引擎\u002F客户端的一个分支，这是一个非常出色的项目，没有它RS-SDK将无法实现。\n> 他们的代码可以在[这里](https:\u002F\u002Fgithub.com\u002FLostCityRS\u002FServer)找到，或者阅读他们的[历史与理念](https:\u002F\u002Flostcity.rs\u002Ft\u002Ffaq-what-is-lost-city\u002F16)。\n## 快速开始：\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002FMaxBittker\u002Frs-sdk.git\n```\n\n开箱即用，你可以连接到提供的演示服务器，并选择一个尚未被占用的用户名！\n\n使用Claude Code：\n```sh\nbun install\nclaude \"start a new bot with name: {username}\"\n```\n手动操作：\n```sh\nbun install\nbun bots\u002Fcreate-bot.ts {username}\nbun bots\u002F{username}\u002Fscript.ts \n```\n\n默认情况下聊天功能已关闭，以防止诈骗和提示注入攻击，但你可以在bot.env文件中通过设置`SHOW_CHAT=true`来启用它。\n\n警告：演示服务器仅作为便利设施提供，我们不保证其正常运行时间和数据持久性。请谨慎对待你的账号，并考虑自行托管服务器实例。请勿在演示服务器上手动游玩。\n\n\n\n\n## 游戏玩法修改\n\n该服务器对原版游戏进行了一些修改，以便于开发和机器人测试：\n\n- **更快升级** - 经验曲线加速且坡度更缓。\n- **无限跑步能量** - 玩家永远不会耗尽能量。\n- **无随机事件** - 禁用了反机器人随机事件。\n\n\n## 架构：\n\nrs-sdk运行在一个增强的基于Web的客户端（`botclient`）之上，该客户端连接到LostCity 2004scape服务器模拟器。\n\n有一个网关服务器，它接受来自botclient和SDK实例的连接，并根据用户名在它们之间转发消息。\n一旦连接到网关，botclient会将游戏状态传递给SDK，并执行从SDK通过网关发送的低级别动作（例如`walkTo(x,y)`）。\n\n这意味着SDK不能直接与游戏服务器通信，而必须通过botclient。如果启动时未运行botclient，它将尝试自动启动。\n\n你不需要运行网关\u002Fbotclient即可在演示服务器上运行自动化脚本，但如果你正在修复bug或为rs-sdk项目添加功能，则可以选择运行它们。\n\n\n## 在本地运行服务器\n\n在本地运行服务器有许多优势，最主要的是可以设置较高的更新频率。\n\n你可以在`server\u002Fengine\u002F.env`文件中通过`TICK_RATE`变量设置更新频率（默认为600毫秒，可尝试200毫秒或30毫秒以获得更快的游戏体验，尤其适用于无头测试）。\n\n你需要同时运行以下三个服务：\n\n```sh\n# 游戏引擎\ncd server\u002Fengine && bun run start\n```\n```sh\n# Web客户端打包工具\ncd server\u002Fwebclient && bun run watch\n```\n```sh\n# 网关（连接SDK与bot客户端）\ncd server\u002Fgateway && bun run gateway\n```\n\n网关默认监听`ws:\u002F\u002Flocalhost:7780`（可通过`AGENT_PORT`环境变量配置）。\n\n\n### 2. 将机器人连接到本地网关\n\n`bot.env`文件中的`SERVER`变量控制机器人连接的地址。要使用你的本地网关，**请将`SERVER`留空**：\n\n```bots\u002F\u003Cbotname>\u002Fbot.env\nBOT_USERNAME=mybot\nPASSWORD=test\nSERVER=\nSHOW_CHAT=false\n```\n\n当`SERVER`为空时，所有连接路径（脚本、命令行）都会默认连接到`ws:\u002F\u002Flocalhost:7780`。\n\n当`SERVER`设置为某个主机名（例如`rs-sdk-demo.fly.dev`）时，它们则会连接到`wss:\u002F\u002F{SERVER}\u002Fgateway`。\n\n\n\n## 免责声明\n\n这是一个免费、开源、由社区运营的项目。\n\n其目的严格限于教育和科学研究。\n\nLostCity服务器是在经过长时间的研究和同行评审后从零开始编写的。你所看到的一切都是完全透明的开源内容。\n\n我们在此项工作上并未得到Jagex Ltd.的认可、授权或官方沟通。\n\n你无法在这里玩《老派RuneScape》，购买RuneScape金币，或访问任何官方游戏的服务！在此开发的机器人将无法在官方游戏服务器上运行。\n\n\n## 许可证\n本项目采用[MIT许可证](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)。详细信息请参阅[LICENSE](LICENSE)文件。","# rs-sdk 快速上手指南\n\nrs-sdk 是一个面向研究的开源工具包，用于在类 RuneScape 的 MMO 环境中构建和运行自动化机器人（Bot）。它提供了 TypeScript SDK、代理文档绑定以及服务器模拟器，旨在为目标导向的程序合成技术及多智能体协作\u002F竞争研究提供安全的测试环境。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Linux, macOS 或 Windows (推荐 WSL2)\n*   **Node.js 运行时**: 本项目使用 `bun` 作为包管理器和运行时，需先安装 bun。\n    ```bash\n    curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n    ```\n*   **Git**: 用于克隆代码仓库。\n*   **网络环境**: 需要能够访问 GitHub 及项目演示服务器 (`rs-sdk-demo.fly.dev`)。若连接演示服务器不稳定，建议参考下文“本地部署”方案。\n\n## 安装步骤\n\n1.  **克隆仓库**\n    将项目代码克隆到本地：\n    ```sh\n    git clone https:\u002F\u002Fgithub.com\u002FMaxBittker\u002Frs-sdk.git\n    cd rs-sdk\n    ```\n\n2.  **安装依赖**\n    使用 bun 安装项目所需依赖：\n    ```sh\n    bun install\n    ```\n\n## 基本使用\n\n您可以选择直接连接官方提供的**演示服务器**进行快速体验，或者在**本地运行服务器**以获得更稳定的开发和测试环境。\n\n### 方案 A：连接演示服务器 (最快上手)\n\n官方提供了一个公共演示服务器，无需配置即可运行 Bot。请注意：演示服务器不保证数据持久性，且禁止手动玩游戏。\n\n#### 方式 1：使用 Claude Code (推荐)\n如果您已配置好 Claude Code 环境，可直接通过自然语言指令创建并启动 Bot：\n\n```sh\nclaude \"start a new bot with name: {username}\"\n```\n*请将 `{username}` 替换为您想要的唯一用户名。*\n\n#### 方式 2：手动运行\n依次执行以下命令来创建并运行脚本：\n\n```sh\n# 1. 创建新 Bot (替换 {username} 为您的用户名)\nbun bots\u002Fcreate-bot.ts {username}\n\n# 2. 运行 Bot 脚本\nbun bots\u002F{username}\u002Fscript.ts \n```\n\n> **注意**: 默认情况下聊天功能已关闭以防止攻击。如需开启，请在生成的 `bots\u002F{username}\u002Fbot.env` 文件中设置 `SHOW_CHAT=true`。\n\n---\n\n### 方案 B：本地运行服务器 (推荐用于开发)\n\n本地运行允许您调整游戏速度（Tickrate），适合高频测试和功能开发。您需要同时启动三个服务：**游戏引擎**、**Web 客户端打包器**和**网关**。\n\n1.  **启动游戏引擎**\n    ```sh\n    cd server\u002Fengine && bun run start\n    ```\n\n2.  **启动 Web 客户端打包器** (在新终端窗口运行)\n    ```sh\n    cd server\u002Fwebclient && bun run watch\n    ```\n\n3.  **启动网关** (在新终端窗口运行)\n    网关负责桥接 SDK 与 Bot 客户端，默认监听 `ws:\u002F\u002Flocalhost:7780`。\n    ```sh\n    cd server\u002Fgateway && bun run gateway\n    ```\n\n4.  **配置 Bot 连接本地网关**\n    编辑您的 Bot 配置文件 `bots\u002F\u003Cbotname>\u002Fbot.env`，**留空 `SERVER` 变量**以强制连接本地网关：\n\n    ```env\n    BOT_USERNAME=mybot\n    PASSWORD=test\n    SERVER=\n    SHOW_CHAT=false\n    ```\n\n5.  **运行 Bot**\n    配置完成后，再次运行脚本即可连接本地服务器：\n    ```sh\n    bun bots\u002F{username}\u002Fscript.ts \n    ```\n\n### 进阶配置：加速游戏节奏\n\n在本地运行时，您可以通过修改 `server\u002Fengine\u002F.env` 中的 `TICK_RATE` 变量来加快游戏速度，这对于无头测试（headless testing）非常有用。\n*   默认值：`600` (ms)\n*   推荐测试值：`200` 或 `30` (ms)","某 AI 研究团队希望在《鲁恩斯科》（Runescape）风格的复杂 MMO 环境中，测试大语言模型自主完成“从 1 级练至全技能 99 级”的长期规划与执行能力。\n\n### 没有 rs-sdk 时\n- **环境搭建极其繁琐**：研究人员需自行逆向游戏协议、搭建服务器模拟器并编写底层通信代码，耗时数周才能跑通第一个\"Hello World\"脚本。\n- **缺乏标准化测试场**：直接在官方服务器运行机器人面临封号风险，且无法控制游戏变量（如随机事件干扰），导致实验数据不可复现。\n- **代理开发门槛高**：缺少专为 Coding Agent 优化的 SDK 绑定，模型难以理解游戏状态对象，常因解析错误导致动作执行失败。\n- **效率评估困难**：没有内置的排行榜和指标系统，难以量化对比不同模型在“单位时间内的等级提升效率”这一核心指标上的表现。\n\n### 使用 rs-sdk 后\n- **开箱即用的实验环境**：通过 `bun install` 和一行命令即可连接预设的演示服务器或本地实例，内置的服务器模拟器直接消除了逆向工程需求。\n- **可控的纯净沙盒**：利用其修改版游戏机制（无限奔跑能量、加速升级曲线、禁用随机事件），团队能在无干扰环境下专注于测试模型的决策逻辑。\n- **原生支持智能体开发**：rs-sdk 提供的 TypeScript SDK 和详细文档让 Coding Agent 能精准调用 `walkTo` 等底层动作，大幅提升了任务合成的成功率。\n- **内置量化评估体系**：直接对接官方排行榜（Hiscores），实时基于“总等级\u002F游玩时间”比率自动评估并对比不同 LLM 模型的自动化效率。\n\nrs-sdk 将原本需要数月的游戏逆向与环境搭建工作压缩至几分钟，让研究人员能立即聚焦于多智能体协作与目标导向程序合成的核心算法验证。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMaxBittker_rs-sdk_a0ee3a0b.png","MaxBittker","Max Bittker","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMaxBittker_e2c1f57c.jpg","creative tools for people ",null,"brooklyn","maxbittker@gmail.com","maxbittker","https:\u002F\u002Fmaxbittker.com","https:\u002F\u002Fgithub.com\u002FMaxBittker",[84,88,92,96,100,104],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",98.1,{"name":89,"color":90,"percentage":91},"EJS","#a91e50",1,{"name":93,"color":94,"percentage":95},"JavaScript","#f1e05a",0.8,{"name":97,"color":98,"percentage":99},"Dockerfile","#384d54",0.1,{"name":101,"color":102,"percentage":103},"Nix","#7e7eff",0,{"name":105,"color":106,"percentage":103},"Shell","#89e051",533,75,"2026-04-07T09:32:59","MIT",4,"未说明",{"notes":114,"python":112,"dependencies":115},"该项目基于 TypeScript 开发，需安装 Bun 运行时环境。默认连接官方演示服务器，也可本地部署服务端（包含游戏引擎、Web 客户端打包器和网关）。本地部署时可调整 TICK_RATE 变量以加速游戏节奏。项目旨在教育和科研，无法用于官方《老派 RuneScape》服务器。",[116,117],"bun","typescript",[13,14],"2026-03-27T02:49:30.150509","2026-04-09T23:55:45.984213",[],[]]