Repository navigation
Releases
Releases · RasakiSSS/model-rps-protocol
v1.1.0 · 共享房间与 MCP 外部 Agent
新增
- 本机共享房间:两个人类终端、两个 MCP 桥接器,或人类与 Agent 任意组合加入同一场 BO。凭证绑定 Red / Blue,双方到齐才开赛;失联中止,不判弃权。
- 服务端管理指令
/start、/stop、/status、/quit、/help:双方 EXIT 后自动待机,可在同一进程连续开场,地址和 token 沿用。 - MCP 外部玩家(可选依赖
pip install -e ".[mcp]"):外部 Agent 占据 Red 或 Blue,提供开始、查看、提交、等待四个工具;--shared-room固定入口可让同一 DSH 的两个对话共用一个 MCP 进程。
变更(不向后兼容)
- 源码按职责分为
core、llm、players、engine、ui、room、mcp_agent七层,依赖只能向下,由tests/test_architecture.py强制;旧的模块路径不再保留。 - 命令入口更名:
model_rps.mcp_agent.server、model_rps.room.server、model_rps.room.client,调试窗口为model_rps.ui.debug_console。已有的 MCP 宿主配置需同步更新并重载。 - 文档重组:原
PROTOCOL.md拆为docs/下的规则、模型交互、日志与展示等文档;README 精简,命令行参数与排错见docs/cli.md。 - 验证与实验脚本移到
validation/、experiments/,输出写入被 Git 忽略的artifacts/。
验证
- 自动测试 284 项全部通过(不调用真实模型);ruff 通过。
- 2026-10-21 在 DSH 中经共享房间完成两场真实对局:一场对人类终端,一场对独立会话的另一个 Agent;每局只在第 1 个 Tick 结算,样本很小,不代表模型水平或长局稳定性。详见
docs/mcp.md。
完整记录见 CHANGELOG。
v1.0.1 · MIT 许可证与第三方声明
- 项目自身采用 MIT License,版权署名为 RasakiSSS。
- 新增第三方依赖清单及原始版权、许可声明副本,说明 certifi 的 MPL-2.0 适用范围。
- README 增加 MIT 徽章与许可证说明。
- 打包元数据声明 MIT,并将项目许可证和第三方声明纳入源码分发包与 wheel;构建工具最低版本调整为 setuptools 77.0.3,以支持标准许可证字段。
- 此次为许可证与发布信息补充,运行依赖、配置和游戏规则沿用 v1.0.0。
许可范围:本项目自身采用 MIT;第三方组件继续使用各自原有许可证。详见 LICENSE 和 第三方声明。
验证:源码分发包与 wheel 均包含 13 份许可证和声明文件,内容校验通过;隔离安装后的帮助入口与离线 BO3 通过。
v1.0.0 · 首个正式版本
首个正式版本,整合此前开发阶段的 CLI 博弈功能。
玩法与玩家
- 模型对战模型、人类对战模型;Red / Blue 席位独立,同一模型也可同时参赛。
- 任意正奇数 BO,同时行动或实验性轮流行动,锁定出拳或同时行动下的改拳模式。
- 人类和模型使用共同指令与信息权限;聊天即时公开,出拳和策略分析按规则揭晓。
- 同一场 BO 保留上下文,赛后继续聊天;连续比赛支持大厅选人和交换席位,新 BO 清空历史。
- 人类可在比赛中交给已配置的模型,继承本席位已提交的分析、行动和公共记录。
模型、配置与诊断
- OpenAI、DeepSeek、GLM、Gemini、Grok 和 Claude 六种适配方案。
- TOML 玩家 profile、思考级别、分析要求,以及每模型流式开关和等待时限。
- 公开聊天日志、双方私有思考与调试日志,以及独立 Windows 调试窗口。
- Grok 流式追加缩进换行 JSON 要求,缓解已测第三方服务的缺字符问题;响应继续严格校验。
本次发布整理
- 新增
run.ps1:定位项目虚拟环境、转发启动参数并保留退出码。 - README 增加项目徽章、Release 下载入口和 Windows 启动说明。
- 统一版本号和现行文档。
安装与现有限制
- 下载 Release 的 Source code (zip),解压后按 README 安装 Python 3.12+ 和依赖。
- 首次使用真实模型前,手动将
config.example.toml复制为config.toml并填写;现有配置无需因本次升级而修改。 - 一个终端最多一位人类玩家;本版局中接管仅支持人类交给模型。
- 轮流行动仍为实验性模式;尚无上下文自动摘要、截断、聊天额度或自动行动期限。
- 第三方服务的模型和参数支持以实际响应为准,已测范围见 模型适配说明。
此前各阶段的功能摘要见 开发计划。
验证:250 项离线测试通过;本次发布不新增模型 API 调用。
干净源码包已完成独立环境安装,依赖检查及 250 项测试再次通过。