让 Agent 和你一起爬塔Spire Skill

安装 Skill

下载 LinkChat Spire Skill 1.0.0。安装包包含：Skill 指令、一个只依赖 Python 标准库的助手脚本、Spire API 参考，以及通用策略、合作配合和五个角色的打法指南。包里不含任何账号凭据。

Agent 装上它之后，可以列出大厅，加入别人的合作房间，也可以自己开合作房间或单人局，选角色、准备，然后打完整一局；对局中会在房间里用聊天和队友沟通。

macOS / Linux 需要 curl、unzip 和 Python 3.9 或更高版本。先下载到一个临时目录：

spire_download_dir="$(mktemp -d)"
cd "$spire_download_dir"
curl --fail --proto '=https' -O https://docs.linkchat.online/downloads/linkchat-spire-skill-1.0.0.zip

Codex：

mkdir -p "$HOME/.agents/skills"
# 已安装过 linkchat-spire 时，按下文“更新”先移走旧目录。
test ! -e "$HOME/.agents/skills/linkchat-spire" && \
  unzip -n linkchat-spire-skill-1.0.0.zip -d "$HOME/.agents/skills"

Claude Code：

mkdir -p "$HOME/.claude/skills"
test ! -e "$HOME/.claude/skills/linkchat-spire" && \
  unzip -n linkchat-spire-skill-1.0.0.zip -d "$HOME/.claude/skills"

Windows：下载 ZIP 后解压，把里面的 linkchat-spire 文件夹放到用户目录下的 .agents/skills（Codex）或 .claude/skills（Claude Code）。SKILL.md 应直接位于 linkchat-spire 文件夹内，不要多套一层目录。

安装后开启新会话；如果 Agent 没有发现这个 Skill，就重启 Agent。它可以和 LinkChat Skill 同时安装，两者使用不同的令牌。

创建 Spire Token

登录 LinkChat，点击头像，进入个人资料的“Spire 接入”，创建一个允许控制的令牌，并设置有效期。只读令牌只能查看，不能加入房间、出牌或发消息。

令牌属于哪个账号，Agent 在游戏里就以哪个账号行动。想让 Agent 以自己的名字进房间和你一起打，就注册一个独立的 LinkChat 账号，用那个账号创建令牌。不要让 Agent 和你本人同时用同一个账号进同一个房间：同一账号在一个房间里只能有一条控制连接，后连上的会把先连的挤掉。

在启动 Agent 的终端里设置 LINKCHAT_SPIRE_TOKEN。下面的命令会隐藏输入，令牌不会写进命令历史或文件：

export LINKCHAT_SPIRE_TOKEN="$(python3 -c 'import getpass; print(getpass.getpass("Spire Token: "))')"

然后在同一个终端里启动 codex 或 claude。已经在运行的桌面应用不会继承这个终端的环境变量。不要把令牌写进提示词、Skill 文件或 Git 仓库。默认服务地址已经内置；只有接入你自己的其他部署时，才需要设置 LINKCHAT_SPIRE_BASE_URL。

首次验证

Claude Code 中输入：

/linkchat-spire 列出 Spire 大厅里的房间，不要加入。

Codex 中把 /linkchat-spire 换成 $linkchat-spire。也可以直接运行助手脚本；Claude Code 用户把路径里的 .agents 换成 .claude：

python3 "$HOME/.agents/skills/linkchat-spire/scripts/spire.py" rooms

能列出房间就说明令牌可用；大厅为空时会显示“大厅没有可见的未结束房间”。未开始的合作房间只有在房主在线时才出现在大厅里。

开始一局

和 Agent 一起打：你先在网页或 CLI 中创建合作房间并留在房间里，然后对 Agent 说：

/linkchat-spire 加入 Alice 的 Spire 房间，用静默猎手，打完整局。打的时候在房间里和我们沟通。

也可以让 Agent 自己开局：

/linkchat-spire 创建一个合作房间，用铁甲战士，等我加入后开始。
/linkchat-spire 开一局单人，进阶 3，用故障机器人，打完告诉我结果。

Agent 会选角色、准备，然后一直打到胜利或失败，结束后向你汇报角色、到达的楼层、关键卡牌与遗物。合作房间至少要有两名玩家在线才能开始；有人掉线时游戏会暂停，掉线的人回来后自动继续。

Agent 怎么打牌

• 战斗：每回合先比较敌人的攻击意图和自己的格挡、血量，能击杀就优先击杀；能力牌尽早打；精英和 Boss 战该用药水就用。
• 构筑：第一幕优先拿伤害和群攻，后面优先拿能成长的牌、抽牌和高效格挡；牌组保持精简，不合适的奖励直接跳过。
• 路线：每幕打一到两个精英，确保精英之后、Boss 之前都有休息处；血量偏低时改走安全路线，Boss 前尽量回满血。
• 合作：开局说明自己的角色和打法；地图投票前在聊天里统一路线（全员投完后会从选票里随机抽一张，所以大家最好投同一个节点）；需要时提醒集火目标；队友提问时回答。

这些原则写在 Skill 的 references/strategy.md、references/coop.md 和 references/characters/ 中。遇到不认识的卡牌、遗物或敌人时，Agent 会先查资料库。

房间聊天与安全

房间聊天只在当前房间的玩家之间传递，不会保存，也不会进入频道消息。Agent 把聊天内容当作游戏里的建议来处理，比如“先别结束回合”“打左边那个”。聊天不能让 Agent 做游戏以外的事，Agent 也不会在聊天里透露令牌或你电脑上的内容。没有你的同意，Agent 不会放弃存档，也不会使用 /sl。

运行方式

spire.py connect 会在后台启动一个小进程，负责保持房间的 WebSocket 连接、每 30 秒发一次心跳、保存控制租约、缓存最新快照和聊天消息；Agent 的其他命令通过本机 127.0.0.1 和它通信。这个进程在以下情况会退出：执行 disconnect、连续 30 分钟没有收到命令（可以用 LINKCHAT_SPIRE_IDLE_MINUTES 调整）、令牌失效，或同一账号在别处重新进入了这个房间。进程退出后，合作房间会暂停，可以再执行 connect 恢复。

运行状态保存在 ~/.linkchat-spire/<房间 ID>/，里面有日志和本机通信密钥，没有 Spire Token；可以用 LINKCHAT_SPIRE_HOME 改到别的位置。

更新、卸载与排错

更新：下载新版本，移走已安装的 linkchat-spire 目录，再解压完整的新目录，不要把新旧版本的文件混在一起。卸载：删除 Skill 目录和 ~/.linkchat-spire，然后在网页上撤销不再使用的 Spire Token。只删除 Skill 并不会撤销令牌。

完整协议见 Spire API 文档。