game/addons/game_ai_npc/overview.md

game_ai_npc 模块概览

已创建文件（16 个）

addons/game_ai_npc/
├── __init__.py
├── __manifest__.py
├── models/
│   ├── __init__.py
│   ├── npc.py                 # NPC 主模型 + Tick 逻辑 + Cron 批处理
│   ├── npc_relationship.py    # NPC 关系（好感度/关系层级）
│   ├── npc_behavior.py        # 行为日志
│   └── npc_knowledge.py       # NPC 所知信息（含谣言/准确性）
├── controllers/
│   ├── __init__.py
│   └── npc_api.py             # REST API
├── security/
│   └── ir.model.access.csv
├── views/
│   ├── npc_views.xml          # NPC 角色（列表+表单+ Cron）
│   ├── npc_relationship_views.xml
│   ├── npc_behavior_views.xml
│   ├── npc_knowledge_views.xml
│   └── menu.xml               # 菜单：AI NPC → 角色/关系/日志/知识
├── data/
│   └── game_npc_data.xml      # 7 个 NPC + 关系 + 知识 种子数据
└── overview.md

模型结构

模型	用途
game.npc	角色（身份/性格/统计/目标/行为刻）
game.npc.relationship	关系（好感度-100~100、自动推导层级）
game.npc.behavior.log	行为日志（每次 Tick 自动记录）
game.npc.knowledge	知识体系（含准确性、来源）

核心设计

NPC Tick 周期（Odoo Cron 每 15 分钟推一次）：

1. 按角色类型日程表确定当前活动（居民/商人/战士/学者/工匠/领袖/游荡者各有不同日程）
2. 消耗基础资源（精力↓、饱腹↓）
3. 应用活动效果（劳作涨目标进度、用餐涨饱腹、睡眠涨精力）
4. 30% 概率触发社交 → 性格兼容性计算 → 好感变化 → 关系层级自动推导
5. 综合状态更新心情
6. 记录行为日志

关系系统：好感度 -100~100，自动推到 7 个层级（死敌→敌对→陌生人→熟人→朋友→挚友→至亲），性格兼容性影响社交互动结果。

API 端点

路由	方法	说明
/game/api/npcs	GET	所有活跃 NPC 列表
/game/api/npc/<id>	GET	NPC 详情（含关系+行为+知识）
/game/api/npc/<id>/relationships	GET	NPC 关系网
/game/api/npc/<id>/tick	POST	手动触发单个 NPC Tick（需登录）
/game/api/npc/tick-all	POST	批量 Tick 所有 NPC（需登录）

种子数据（7 个角色）

NPC	类型	性格	目标
张伯·老村长	领袖	严肃	维持村落安全
林铁柱·铁匠	工匠	刚毅	铸灵器级武器
柳絮·游方学者	学者	好奇	记录古遗迹
花娘·行商	商人	开朗	开辟跨层商路
阿猛·猎户	战士	大胆	猎杀三尾狐兽
老鬼·流浪药师	游荡者	神秘	寻忘忧草
小禾·农家女	居民	善良	学会识字记账

初始关系：张伯↔林铁柱（信赖）、张伯↔花娘（商业伙伴）、柳絮↔小禾（师生）、阿猛→柳絮（暗恋）。