Evolving-Werewolf

English | 简体中文

Evolving-Werewolf — 自进化狼人杀

AI 玩家会越打越强。

跨局知识积累与进化：每一局结束后，引擎自动提炼复盘经验，按角色分区（狼人阵营 / 好人阵营 / 预言家 / 女巫 / 猎人策略等）写入知识库；下一局开局时，这些经验会以skill的形式注入到新一批玩家 agent 的 persona 中。AI 玩家会从每一局的失败和胜利中学习——学会更隐蔽的刀法、更精准的验人逻辑、更合理的投票策略。 局数越多，AI 越强。

它是如何进化的

第 1 局：AI 玩家凭规则和性格种子行事，可能犯初级错误
        ↓ 局末自动复盘 → 提炼经验条目写入 knowledge.json
第 2 局：新一批 AI 玩家携带上一局的经验开局，避免已知的坑
        ↓ 再次复盘 → 知识库累积
第 N 局：AI 玩家拥有数十局经验，发言逻辑更缜密、投票更精准、
         狼人刀法更隐蔽、好人推理更深入

人类玩家面对的不是固定策略的 AI，而是一个随着对局积累不断进化的对手群体。

其他特性

除了进化机制，这是一个完整的 9 人局狼人杀引擎（3 狼人 / 1 预言家 / 1 女巫 / 1 猎人 / 3 平民），运行在 DeepSeek Harness (DSH) 上：

• 引擎自动主持：无 LLM 上帝，全部流程由状态机驱动，省 token、零信息失真。
• 完整角色技能：狼人两轮讨论 + 多数决、预言家查验、女巫救/毒（首夜自救、同夜单药）、猎人出局开枪。
• 标准白天流程：警长竞选 → 警上发言 → 退水声明 → 警下投票 → 警长指定发言方向 → 按序发言 → 全员记名投票（警长 1.5 票，平票重投）。
• 信息隔离：刀口仅狼人与女巫可见；夜晚死亡不公开死因；各角色频道私密；增量投递只发"该玩家未见过的信息"。
• 防卡死机制：60s 催办 + 180s 超时跳过 + running 感知（慢玩家不误杀）+ 推进互斥锁。
• 死亡冻结 + 快照复盘：出局玩家信息冻结，局末输出因果纯净的决策轨迹复盘。
• 人类席位 + 浏览器面板：humanSeat 随机分配人类座位，通过 HTTP 面板行动，与 agent 玩家完全同场竞技。
• 素材管线：集成智谱 AI 读图（GLM-4V-Flash）+ 生图（CogView-3-Flash），免费额度即可为 UI 生成头像和角色贴图。
• 性格种子：9 种性格随机分配，玩家风格多样化。

---

安装

前置条件

• Node.js >= 18
• DSH (DeepSeek Harness) — 全局安装：

  npm install -g @deepseek-ai/dsh
  

安装插件到 DSH

# 1. 克隆仓库
git clone https://github.com/VegeFin/Evolving-Werewolf.git
cd Evolving-Werewolf

# 2. 安装依赖（插件运行时依赖 @deepseek-ai/dsh-tools）
pnpm install   # 或 npm install

# 3. 安装到 DSH web profile
dsh plugin --profile web add ./

# 4. 重启 DSH
dsh web

重启后 werewolf_* 系列工具全局可用，插件随 profile 自动加载。

配置

image-config.json（素材管线 API Key）

cp image-config.example.json image-config.json

编辑 image-config.json，填入智谱 API Key（在 open.bigmodel.cn 免费注册获取）：

{
  "apiKey": "你的APIKey",
  "baseURL": "https://open.bigmodel.cn/api/paas/v4",
  "visionModel": "glm-4v-flash",
  "drawModel": "cogview-3-flash",
  "drawSize": "1024x1024",
  "assetDir": "ui/assets"
}

素材管线为可选功能。不配置只影响读图/生图工具，核心游戏功能不受影响。

knowledge.json（知识库种子）

cp knowledge.example.json knowledge.json

引擎每局结束后会自动提炼经验并写入 knowledge.json。knowledge.example.json 提供 8 条初始种子知识。

---

使用

主持人视角

在 DSH agent 会话中调用工具：

工具	用途	调用者
werewolf_start	开局：随机分配身份、生成 8 个玩家 agent、与人类玩家共同开始游戏。不传 humanSeat 则自动随机 1-9 分配人类座位。 'humanSeat'=0 时、生成 9 个玩家agent自迭代进化。	主持人
werewolf_act	玩家行动（18 种 action）	玩家
werewolf_status	查看公开状态；主持人可看完整身份表与复盘报告	所有人
werewolf_ask_rule	查询规则/角色能力	所有人
werewolf_abort	主持人终止游戏	主持人
werewolf_look	用视觉模型分析图片	主持人
werewolf_draw	用文生图模型生成图片	主持人
werewolf_assets_status	查看素材管线状态	主持人

werewolf_start 返回值包含 hostGuide（主持人指引）和 panelUrl（人类玩家面板地址）。

玩家行动 (werewolf_act)

action	说明	阶段
speech + text	发言	day-speech / day-sheriff-speech
vote + target	放逐投票（0=弃票）	day-vote
sheriff_vote + target	警下投票	day-sheriff-vote
sheriff_run / sheriff_not	上警 / 不上警	day-sheriff-run
sheriff_stay / sheriff_quit	不退水 / 退水	day-sheriff-quit
direction + text=left/right	警长指定发言方向	day-direct
pass_sheriff + target	警长出局处置警徽	sheriff-pass
kill + target + text	狼人刀人	night-wolves
seer + target	预言家查验	night-seer
witch_save / witch_poison+target / witch_none	女巫用药	night-witch
hunter + target	猎人开枪（0=不开枪）	night/day-hunter
alive	在线确认	任意
review + text	提交复盘	review

人类玩家面板

开局后浏览器访问 http://127.0.0.1:<port>/werewolf/panel，面板提供：

• 身份卡（座位、角色）
• 事件流（按 kind 分类：wolf/seer/witch/death/sheriff/info）
• 发言舞台（逐条展示）
• 行动区（门禁驱动：只在轮到你时显示对应表单）

---

目录结构

Evolving-Werewolf/
├── lib/
│   └── index.js              # 固化版引擎主文件（v33，纯 host）
├── ui/
│   ├── panel.html            # 人类玩家面板（HTTP 路由提供）
│   ├── assets/               # 头像和角色贴图（PNG）
│   └── protos/               # UI 原型 HTML（开发参考）
├── archive/                  # 动态版源码存档（开发调试用，零重启迭代）
│   ├── dev/
│   │   ├── wwdev-engine.host.js    # 引擎动态版
│   │   ├── wwim6-assets.host.js    # 素材管线动态版
│   │   └── wwui10-panel.host.js    # 面板动态版
│   ├── v32.host.js           # v32 host 存档
│   ├── v32.client.js         # v32 client 存档
│   └── werewolf-v21.host.source.js  # v21 原始存档
├── cordis.patch.yml          # DSH bundle patch 配置
├── image-config.example.json # API Key 配置模板
├── knowledge.example.json    # 知识库种子模板
├── package.json
├── PROGRESS.md               # 版本历史与开发进度
└── .gitignore

公开 vs 私有

文件	状态	说明
lib/index.js	公开	引擎主代码
ui/	公开	面板、图片、原型
archive/	公开	动态版存档（开发参考）
*.example.json	公开	配置模板
package.json / cordis.patch.yml	公开	包元数据
*.md	公开	文档
knowledge.json	公开	运行时知识库数据
image-config.json	gitignore	含真实 API Key
last-review.json	gitignore	上一局复盘数据
review-processed.json	gitignore	复盘处理标记
node_modules/	gitignore	依赖
.ww-tmp/	gitignore	子进程临时文件

---

架构

平面划分

宿主平面（Host）
├── werewolf 引擎（本插件）
│   ├── 状态机（game 对象，内存）
│   ├── 工具注册（werewolf_*，全局可见）
│   ├── timer 心跳（30s 检查超时/催办）
│   ├── webServer 路由（/werewolf/panel + /werewolf/api/* + /werewolf-assets/*）
│   └── 消息投递（subagents.followup / Agent.steer 回退）
└── DSH 基础设施（subagents / agents / tools / webServer / timer / fs / subprocess）

Agent 平面
├── 主持人（当前会话）：werewolf_start / status / abort
└── 9 个玩家（continuable 子代理）
    ├── persona = 规则库 + 身份 + 性格种子 + 历史经验
    ├── toolFilter = 仅 werewolf_act / status / ask_rule
    └── 通过 werewolf_act 行动

状态机阶段

setup → night-wolves → night-seer → night-witch → night-settle
     → day-sheriff-run → day-sheriff-speech → day-sheriff-quit → day-sheriff-vote
     → day-direct → day-speech → day-vote → (night-*) 循环
     → gameover → review

关键服务依赖（inject 声明）

inject: ['subagents', 'agents', 'tools', 'webServer']

Cordis 服务驱动激活：等这四个服务就绪后再执行 apply()，避免路由注册早退。

---

规则实现

• 身份：3 狼 + 1 预 + 1 女 + 1 猎 + 3 民，shuffle 随机分配。
• 狼人：随机顺序两轮讨论，多数决裁决（平票取首票）。
• 预言家：每晚验 1 名存活玩家，结果私密。
• 女巫：解药/毒药各 1 次；首夜可自救；解药用后不再被告知刀口。
• 猎人：被狼刀/被投出局可开枪（被毒不开枪）。
• 警长：竞选产生，1.5 票权重，指定发言方向，出局时处置警徽。
• 投票：记名公开；平票进第二轮限平票人重投。
• 胜负：狼全灭 → 好人胜；神全灭或民全灭 → 狼胜（屠边）。

---

开发

固化版 vs 动态版

模式	文件	特点
固化版（生产）	lib/index.js	标准 Cordis 插件，dsh web 自动加载，重启生效
动态版（开发）	archive/dev/*.host.js	cordis_define 注入内存，改代码零重启，重启即失

开发迭代用动态版，改完固化到 lib/index.js。动态版用 harness.defineTool，固化版用 defineTool from @deepseek-ai/dsh-tools。

---

已知限制

• 一局约 15-40 分钟（9 玩家 × 每阶段 LLM 轮次）。
• 游戏状态存插件内存，重启清空当前局。
• 玩家 agent 会话为持久化冷存档，跨局累积（需手动清理或开局自动释放活跃层）。
• 复盘知识库为内存级（进程内跨局有效，重启清空；可落盘 knowledge.json）。

---

License

MIT