bigharm/dsh-agentnoodle

可扩展的 AI 群像聊天游戏框架（DeepSeek Harness 插件）。

输入一个行动/一句话，场景中多个 NPC 会各自做出反应——每条反应独立成一条聊天室消息，带自己的头像插图（无头像自动用名字首字占位圆）。叙事、场景切换、NPC 关系变化全由 AI 实时驱动，对话历史持久化到本地 JSON。

框架定位：世界、地点、NPC 乃至功能扩展都通过 harness 对话框让 agent 直接添加和修改——无需写代码。天然的可扩展性意味着玩家可以按需长出自己的玩法，例如：

• 接入第三方绘图 API，为 NPC 实现动态表情与动作绘制；
• 追加语音、任务、战斗、经济等系统；
• 自定义提示词与规则，塑造独特的叙事风格。

源自 LazyNoodle 项目的 DSH 插件化改造。

特性

• 🎭 群像反应：一次行动 → AI 挑选 2-4 个在场 NPC 各自回应，每条独立渲染
• 🖼️ 头像插图：每条消息显示说话人头像；无头像显示名字首字占位圆
• 🌍 多世界：每个世界独立的世界观 / 地点 / NPC / 角色存档
• 💬 对话建世界：无需写代码，直接在对话里创建世界、生成地点与 NPC
• 🧩 可扩展框架：世界、地点、NPC 与新功能都可在对话里让 agent 添加修改（如接入绘图 API 实现 NPC 动态表情动作）
• 🎴 角色卡导入：兼容 SillyTavern 角色卡（V1/V2/V3 JSON 或 PNG 内嵌卡片）
• 📦 世界导入：直接迁移 LazyNoodle 风格世界目录
• 🗃️ 本地持久化：JSON 文件存档，AI 解锁的新地点自动注册进地点库
• 🪟 悬浮窗面板：可拖动、可最小化，不打扰主界面
• 🤖 模型无关：复用 DeepSeek Harness 的默认模型路由，无需额外 API Key

安装

dsh plugin --profile web add dsh-agentnoodle

或打开 Settings → Plugin Market 搜索 dsh-agentnoodle 一键安装。安装后重启 dsh web，页面右下角出现 🍜 AgentNoodle 聊天室 悬浮窗。

快速开始

① 从零建一个新世界（全在对话里完成）

1. 世界观：粘贴你的世界观文本，或让 agent 起草 → 对话里几轮修改、确认；
2. 生成地点：agentnoodle_generate_content(worldId, stage=locations) → AI 生成区域与场景；
3. 生成 NPC：agentnoodle_generate_content(worldId, stage=npcs) → AI 生成 NPC（自动校验地点归属）；
4. 开玩：面板刷新 → 选世界 → 建角色 → 输入行动。

② 直接玩默认世界

「暮色酒馆」世界内置在 seed 中，首次启动自动播种，含默认角色「无名旅人」——打开即可开始。

对话工具总表

以下工具注册为模型工具，agent 在对话里直接调用：

工具	作用
agentnoodle_create_world	创建新世界（worldId + name + 可选世界观），建骨架并切换为当前世界
agentnoodle_update_worldview	更新世界观文本（世界观迭代阶段）
agentnoodle_generate_content	按世界观用 AI 生成地点（stage=locations）/ NPC（stage=npcs）/ 两者（stage=all）
agentnoodle_list_worlds	世界概览；传 worldId 查看详情（地点+NPC 名单）
agentnoodle_add_location	手工添加地点
agentnoodle_add_npc	手工添加 NPC（校验地点归属）
agentnoodle_import_card	导入 SillyTavern 角色卡为 NPC
agentnoodle_import_world	导入 LazyNoodle 风格世界目录

示例：「帮我建一个『青云门』的修仙世界，掌门叫青云真人」→ agent 依次调用 create_world → add_location / generate_content → add_npc，全程不用碰代码。

真实对话示例

用户：在 agentnoodle 里创建一个仙侠世界，地点 10 个，人物若干

agent 会依次调用：

1. agentnoodle_create_world(worldId, name, worldview) — 创建世界骨架并写入世界观；
2. agentnoodle_generate_content(worldId, stage=locations) — AI 生成地点（不足 10 个时用 agentnoodle_add_location 补齐）；
3. agentnoodle_generate_content(worldId, stage=npcs) — AI 生成 NPC（可再 agentnoodle_add_npc 补充）；
4. 告知世界已就绪——刷新面板即可开玩。

内置示例：seed/worlds/jiuxiao/ 就是一个完整的「九霄仙域」仙侠世界（10 地点 + 8 NPC），全新安装后直接可选。

游戏规则（对话里添加，随时生效）

世界可以带一份玩家规则（<dataDir>/worlds/<id>/rules.txt，每行一条，# 为注释）。规则是硬性约束：注入游戏提示词的醒目位置、优先于世界观，内容生成（地点/NPC）也会遵守。

• 工具：agentnoodle_update_rules(worldId, rulesText) — 覆盖整份规则（传空文本清空）
• 查看：agentnoodle_list_worlds(worldId) 详情含 rules
• 例如玩家说：「加一条规则：NPC 被问及关键情报时不得撒谎」→ agent 调用工具 → 下次行动立即生效（无需重启、无需改代码）

提示：提示词层规则是"软约束"（AI 大部分时候遵守）；需要程序强制的机制（死亡状态、数值系统等）属于插件代码扩展——这是框架可扩展定位的一部分。

角色卡 / 世界导入

• SillyTavern 角色卡（agentnoodle_import_card）：
  • 粘贴 JSON（cardText）或本地 PNG/JSON 卡路径（filePath，PNG 从 tEXt chara 块自动解析）；
  • 字段映射：name→NPC 名、description→描述、personality→性格标签、scenario+personality→背景、first_mes→存档备用；
  • locationId 指定所在位置（默认第一个地点）。
• LazyNoodle 世界（agentnoodle_import_world）：导入一个世界目录（需 worldview.txt，可选 locations.json / npcs.json / avatars/），注册进索引并切换为当前世界。

面板玩法

• 世界下拉：切换世界（加载各自的世界观/地点/NPC/角色存档）
• 角色：创建/选择角色；角色位于某场景，场景决定在场的 NPC
• 行动输入：动作或话语 → AI 生成旁白 + 多个 NPC 群像反应
• 日志：每条消息带头像（无头像用名字首字占位圆）；旁白为场景描写样式
• 悬浮窗：可拖动、最小化成右下角 🍜 按钮

数据与配置

• 默认数据目录：~/.dsh/agentnoodle（首次启动自动从包内 seed/ 播种）
• 覆盖方式：在 profile 的 cordis.patch.yml 里给该行配置 dataDir，或在 Settings → Plugins → 插件配置中修改
• 提示词：<dataDir>/prompts/（environment.txt 游戏叙事、generate_locations.txt 生成地点、generate_npcs.txt 生成 NPC），改完即时生效
• AI 参数：<dataDir>/.env（AI_TEMPERATURE / AI_MAX_TOKENS / HISTORY_TAIL）

世界数据格式

世界就是普通文件（<dataDir>/worlds/<id>/），任何能写这些文件的入口都能建世界：

<worldId>/
├── worldview.txt          # 世界观设定
├── locations.json         # { regions: [{id,name,description,icon}], locations: [{id,name,parent,description,icon}] }
├── npcs.json              # { npcs: [{id,name,gender,profile,location_id,avatar,active,dead}] }
├── avatars/               # NPC 头像 PNG（可选）
└── sessions/characters/   # 角色存档（运行时生成）

开发

npm test            # 跑自测（假 fs/AI，无需 harness 运行时）
npm run check       # 语法检查 + 自测

结构：

lib/game.js        # 游戏核心逻辑（纯函数、依赖注入）
lib/index.js       # Host 插件入口：HTTP API + 头像路由 + 数据播种 + 模型工具
client/client.js   # 浏览器面板（ModuleLoader bundle）
seed/              # 首次启动的默认世界/提示词

许可证

MIT