SDK 与示例
四语言官方 SDK，装好即用
所有 SDK 与 API v1.1 协议对齐：会话创建、事件推送、决策接收、自动重连与用量查询均已封装。配套 GitHub 示例仓库包含可运行的完整 Demo。
最后更新：2026年10月 · SDK v1.1.0
🟩
Node.js / TypeScript
全类型定义，回调与异步迭代器双模式事件流，内置指数退避重连。
github.com/zhenren-ai/zhenren-node
安装
npm install @zhenren/sdk🐍
Python
同步/异步双客户端，类型注解完整，dataclass 决策模型开箱即用。
github.com/zhenren-ai/zhenren-python
安装
pip install zhenren-ai☕
Java
适配服务端常见 JDK 11+ 环境，Netty WebSocket 客户端与连接池。
github.com/zhenren-ai/zhenren-java
安装
implementation "cn.zhenren:sdk:1.1.0"🐹
Go
context 全链路传递，goroutine 安全的会话管理，标准库零额外依赖。
github.com/zhenren-ai/zhenren-go
安装
go get github.com/zhenren-ai/zhenren-go示例项目
可运行的完整 Demo
示例仓库（github.com/zhenren-ai/examples）包含三个端到端项目，全部可通过 README 一条命令启动。
ddz-quickstart
三人斗地主命令行对局 Demo：创建会话、事件流、决策回放，50 行核心代码。
mahjong-room-server
四川麻将房间服务示例：AI 托管、掉线补位、dynamic 填充模式的完整接线。
cold-start-lab
冷启动模拟器：注入玩家到达流，观察匹配成功率随 AI 占比的变化曲线。