想体验 **NETA Skills 的 Adventure Campaign（奇遇剧本）**吗？只需一句设定，AI Agent 就会同时化身 **DM（地下城主）**和演员，为你讲述一场可操控、可转向的AI 互动叙事冒险。本指南带你从零创建剧本、进入游玩模式，并掌握让故事不"漂移"的关键技巧。

一、什么是 Adventure Campaign？AI 如何扮演 DM

Adventure Campaign 是 NETA Skills 提供的AI 驱动交互式故事冒险功能，位于 skills/neta-adventure/SKILL.md。它把传统"跑团"的体验交给 AI：

• 🎲DM 职责：Agent 依据你写好的剧情、目标和规则推进叙事，描述世界、扮演 NPC、裁决你的行动
• 🎭双重声音：若绑定了角色，世界会通过该角色的眼睛呈现；未绑定角色时，则由干净自信的 DM 声音叙述
• 📖两种模式：**创作模式（Craft）**负责把灵感变成完整剧本；**游玩模式（Play）**负责把剧本演出来

与纯聊天机器人对话不同，游玩模式被定义为"表演"而非"问答"——AI 会主动推进故事、在戏剧性节点暂停等你选择，而不是每句话都问"要继续吗？"

二、快速开始：安装技能并配置认证

一键安装 adventure 技能

把技能装进你的 AI Agent 环境，只需一条命令：

npx skills add talesofai/neta-skills/skills/neta-adventure

也可以安装统一版neta技能，一次获得全部能力（详见 skills/neta/SKILL.md）。

配置认证（两种方式任选其一）

1. 令牌方式：在 Neta Open Portal 获取NETA_TOKEN，配置到环境变量
2. 设备登录：当NETA_API_BASE_URL指向全球 API 时，可直接运行login命令完成 OAuth 设备授权

export NETA_TOKEN=your_token_here

三、创作模式：先出草稿的剧本工作流

创作模式的核心理念是"先出草稿"：你给出一个词级别的灵感种子，Agent 会立即生成完整剧本草稿，再根据你的反馈做局部微调，而不是来回追问十个问题。

五个核心字段：剧本的完整骨架

一个剧本由五个字段构成有机整体（字段语义详见 adventure-crafting.md）：

其中mission_plot_attention最值得花心思——它是凌驾于一切上下文之上的约束层，适合写：基调锁定（"始终保持生存恐怖张力"）、NPC 行为契约（"陈医生绝不打破临床冷静"）、信息门控（"线索只通过主动调查揭示"）、内容护栏等 3–6 条规则。

⚠️ 常见误区：把世界观和剧情事件写进mission_plot_attention。那些内容属于mission_plot，字段错位会导致游玩时 AI 行为漂移（参见 adventure-field-guide.md）。

创建你的第一个剧本

字段确认后，一条命令即可创建（剧本创建免费，不消耗电量）：

npx -y @talesofai/neta-skills@latest create_adventure_campaign \ --name "汴京最后三天" \ --mission_plot "公元1127年，靖康元年十一月。金兵已兵临汴京城下..." \ --mission_task "在城破前查明密函来源和使者真实身份。" \ --mission_plot_attention "保持历史正剧质感。信息只通过调查获得，不主动透露。"

创建成功后会返回剧本uuid，这是之后游玩和更新的唯一凭证。官方还准备了四个跨题材的完整范例（恐怖、科幻、权谋、武侠），可作为质量标杆参考：adventure-examples.md。

创建后建议：立即调用request_adventure_campaign回读一次，确认mission_plot_attention已正确存储——它统治所有后续游玩会话。

四、游玩模式：DM 的主动推进与玩家操控

拿到 UUID 后进入游玩模式，规则定义在 adventure-playing.md：

npx -y @talesofai/neta-skills@latest request_adventure_campaign --campaign_uuid "你的剧本UUID"

会话如何展开

• 🎬幕布直接升起：Agent 完成初始化后立即开始讲述，不问"准备好了吗"
• ⏱️主动推进：每轮约 150–300 字（场景锚点 + 发展 + 后果钩子），Agent 会连续推进 2–3 轮后暂停
• ⏸️方向校准点：暂停时 Agent 给出 2–3 个以角色内心独白呈现的分支选项，或开放式指向；你的回复就是"导演指令"

你可以怎样操控故事

沉浸式体验的小贴士 💡

• 把输入当作世界内行为来写（"我推开门看看"），而不是提要求（"请安排一个敌人"）
• 若确实需要跳出剧情说话，用[OOC:]标记
• 跨会话续玩时，Agent 会用 3–5 句回顾开场，衔接你上次离开时的位置
• 若同时安装了 neta-creative 技能，Agent 会在开场、重大转折等关键时刻为你生成场景图（单场上限 5 张）

五、剧本迭代：更新、管理与避免漂移

只改想改的字段

update_adventure_campaign是部分更新语义——只传需要修改的字段，其余保持原值（见 update_adventure_campaign.cmd.zh_cn.yml）：

npx -y @talesofai/neta-skills@latest update_adventure_campaign \ --campaign_uuid "campaign-uuid-here" \ --mission_plot_attention "更新后的行为规则..."

新规则立即作用于所有后续会话，是修复 AI 漂移的利器：首次试玩后，留意 AI 在哪里偏离了基调，就去收紧那一条规则。

管理你的剧本库

# 列出你创建的所有剧本（按修改时间倒序） npx -y @talesofai/neta-skills@latest list_my_adventure_campaigns # 分页 npx -y @talesofai/neta-skills@latest list_my_adventure_campaigns --page_index 0 --page_size 10

命令实现位于 src/commands/adventure_campaign/ 目录，包含创建、更新、列出、获取详情四个完整命令。

六、常见问题 FAQ

Q：Adventure Campaign 会消耗电量（AP）吗？剧本创建免费不消耗；游玩中的叙事讲述不额外消耗，但若开启场景图生成等 neta-creative 能力，则按对应生成功能计费。

Q：绑定角色（default_tcp_uuid）是必须的吗？不是。未绑定角色时由干净自信的 DM 声音叙述；绑定角色后，叙事会染上角色的个性色彩。角色与剧本字段冲突时，剧本字段优先。

Q：AI 说着说着跑偏了怎么办？99% 的情况是mission_plot_attention没覆盖到那个"破壁向量"。回读官方质量自检清单（adventure-crafting.md），找到漂移点后用update_adventure_campaign补一条规则即可，无需重建剧本。

现在就试试：把一个词丢给你的 Agent——"末日图书馆"、"赛博朋克侦探"、"深海沉船"——然后看它如何以 DM 身份为你拉开第一幕。