@talesofai/neta-skills 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @neta/skills-neta
 
+## 0.12.0
+
+### Minor Changes
+
+- 0a03853: introduce neta-travel skill for creating and playing AI-driven interactive story adventures (travel campaigns)
+
+## 0.11.0
+
+### Minor Changes
+
+- make image command support size params and model selection
+
 ## 0.10.0
 
 ### Minor Changes

package/README.md

@@ -23,6 +23,7 @@ You can get your access token from the [Neta Open Portal](https://www.neta.art/o
 - 👤 **Character & Style Management:** Search, fetch details, and manage characters and stylistic elements.
 - 🏷️ **Community Integrations:** Explore trending hashtags, popular characters, and curated collections.
 - 🧭 **Smart Discovery & Suggestions:** Explore interactive feeds and get keyword, tag, and category suggestions for progressive content discovery.
+- 📖 **Interactive Story Adventures:** Craft and play AI-driven narrative campaigns (Travel) — the agent acts as DM and character roleplayer for immersive interactive fiction.
 - 🤖 **Agent First:** Designed from the ground up to plug into your favorite AI agent frameworks.
 
 ---
@@ -59,14 +60,21 @@ npx skills add talesofai/neta-skills/skills/neta-character
 
 # Elementum VToken creation and management
 npx skills add talesofai/neta-skills/skills/neta-elementum
+
+# AI-driven interactive story adventures (Travel Campaigns)
+npx skills add talesofai/neta-skills/skills/neta-travel
 ```
 
 ### Available Commands
 
-The skill includes **30 commands** for various tasks:
+The skill includes **34 commands** for various tasks:
 
 | Category | Command | Description |
 |----------|---------|-------------|
+| **Travel Campaigns** | `create_travel_campaign` | Create an AI-driven interactive story adventure |
+| | `update_travel_campaign` | Update an existing travel campaign |
+| | `list_my_travel_campaigns` | List your created travel campaigns |
+| | `request_travel_campaign` | Load full campaign details for play mode |
 | **Creation** | `make_image` | Generate images from text prompts |
 | | `make_video` | Generate videos from images and prompts |
 | | `make_song` | Compose songs with custom prompts and lyrics |
@@ -128,14 +136,14 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # Get general help or specific command help
-neta-cli --help
-neta-cli make_image --help
+npx -y @talesofai/neta-skills --help
+npx -y @talesofai/neta-skills make_image --help
 
 # Example: Generate an image
-neta-cli make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
+npx -y @talesofai/neta-skills make_image --prompt "A cyberpunk cityscape at night" --aspect "16:9"
 
 # Example: Search for characters or elementum
-neta-cli search_character_or_elementum --keywords "fantasy"
+npx -y @talesofai/neta-skills search_character_or_elementum --keywords "fantasy"
 ```
 
 ---
@@ -153,6 +161,7 @@ neta-skills/
 │   ├── neta-space/                 # Space navigation & exploration skills (EN)
 │   ├── neta-character/             # Character VToken creation & management (EN)
 │   ├── neta-elementum/             # Elementum VToken creation & management (EN)
+│   ├── neta-travel/                # Interactive story adventures / Travel Campaigns (EN)
 │   └── zh_cn/                      # Chinese-localized skills & references
 │       ├── neta/
 │       ├── neta-community/
@@ -160,7 +169,8 @@ neta-skills/
 │       ├── neta-suggest/
 │       ├── neta-space/
 │       ├── neta-character/
-│       └── neta-elementum/
+│       ├── neta-elementum/
+│       └── neta-travel/
 ├── src/                            # TypeScript source for the CLI
 │   ├── apis/                       # Typed Neta API client helpers
 │   ├── commands/                   # CLI command definitions (TS + YAML meta)
@@ -193,6 +203,7 @@ Agents use these references to learn the optimal sequence of actions, parameter
 - **Song & MV Creation:** Workflows for composing songs and creating music videos with synchronized visuals.
 - **Character & Hashtag Research:** Processes for finding trending content, searching characters, and utilizing community trends.
 - **Character & Elementum Creation:** Character creation and elementum alchemy workflows.
+- **Travel Campaign Crafting & Play:** Multi-turn story creation workflow (Craft Mode), interactive session management (Play Mode), field reference, and complete genre examples. See `skills/neta-travel/references/`.
 
 ---
 
@@ -220,8 +231,8 @@ In terminal environments, locale is typically controlled by:
 If you want to force a specific language for a single command, you can prefix it with the desired locale, for example:
 
 ```bash
-LC_ALL=zh_CN.UTF-8 neta-cli make_image --help
-LANG=en_US.UTF-8 neta-cli make_image --help
+LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills make_image --help
+LANG=en_US.UTF-8 npx -y @talesofai/neta-skills make_image --help
 ```
 
 ---

package/README.zh_cn.md

@@ -16,6 +16,7 @@
 - 查询与管理角色（Character）与风格元素（Elementum）
 - 进行标签（Hashtag）与空间玩法探索
 - 通过推荐引擎和互动 Feed 进行玩法内容发现
+- 创作与游玩 AI 驱动的交互式故事冒险（奇遇剧本），Agent 担任 DM 与角色扮演者
 
 你可以在 [Neta 开放平台](https://www.neta.art/open/) 获取访问令牌 `NETA_TOKEN`。
 也可以在[国内登陆账号后台](https://app.nieta.art/security) 获取访问令牌 `NETA_TOKEN`。
@@ -61,14 +62,21 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-character
 
 # 元素 VToken 创建与管理
 npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
+
+# AI 驱动的交互式故事冒险（奇遇剧本）
+npx skills add talesofai/neta-skills/skills/zh_cn/neta-travel
 ```
 
 ### 可用指令总览
 
-当前技能共包含 **30 个命令**，覆盖创作、角色与社区探索等场景：
+当前技能共包含 **34 个命令**，覆盖创作、奇遇、角色与社区探索等场景：
 
 | 分类 | 命令 | 说明 |
 |------|------|------|
+| **奇遇剧本 Travel** | `create_travel_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
+| | `update_travel_campaign` | 更新已有奇遇剧本 |
+| | `list_my_travel_campaigns` | 列出你创建的奇遇剧本 |
+| | `request_travel_campaign` | 加载完整剧本详情（游玩模式） |
 | **创作 Creation** | `make_image` | 基于提示词生成图片 |
 | | `make_video` | 基于图片与动作描述生成视频 |
 | | `make_song` | 基于风格与歌词生成歌曲 |
@@ -132,16 +140,16 @@ export NETA_TOKEN=your_token_here
 
 ```bash
 # 查看帮助
-neta-cli --help
-neta-cli make_image --help
+npx -y @talesofai/neta-skills --help
+npx -y @talesofai/neta-skills make_image --help
 
 # 示例：生成一张图片
-neta-cli make_image \
+npx -y @talesofai/neta-skills make_image \
   --prompt "夜晚的赛博朋克城市，霓虹灯，高楼大厦，雨中街道" \
   --aspect "16:9"
 
 # 示例：搜索角色或元素
-neta-cli search_character_or_elementum \
+npx -y @talesofai/neta-skills search_character_or_elementum \
   --keywords "幻想" \
   --parent_type "character"
 ```
@@ -161,6 +169,7 @@ neta-skills/
 │   ├── neta-space/                 # 英文空间与话题导航 / 探索技能
 │   ├── neta-character/             # 英文角色 VToken 创建与管理技能
 │   ├── neta-elementum/             # 英文元素 VToken 创建与管理技能
+│   ├── neta-travel/                # 英文交互式故事冒险（奇遇剧本）技能
 │   └── zh_cn/                      # 中文本地化技能与参考文档
 │       ├── neta/
 │       ├── neta-community/
@@ -168,7 +177,8 @@ neta-skills/
 │       ├── neta-suggest/
 │       ├── neta-space/
 │       ├── neta-character/
-│       └── neta-elementum/
+│       ├── neta-elementum/
+│       └── neta-travel/
 ├── src/                            # CLI 对应的 TypeScript 源码
 │   ├── apis/                       # 封装后的 Neta API 调用
 │   ├── commands/                   # CLI 命令定义（TS + YAML 描述）
@@ -200,6 +210,7 @@ neta-skills/
 - **角色与标签调研**：如何通过角色 / 标签 / 空间找到合适的创作方向。
 - **角色与元素创建**：角色创建和元素炼金的工作流。
 - **玩法内容探索**：使用 `suggest_*` 与 `suggest_content` 构建渐进式探索闭环。
+- **奇遇剧本创作与游玩**：多轮协作故事创作工作流（创作模式）、交互式会话管理（游玩模式）、字段手册，以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-travel/references/`。
 
 ---
 
@@ -227,8 +238,8 @@ CLI 与 Skills 会根据系统与环境变量自动选择使用的语言：
 在需要强制指定语言时，推荐在运行命令前显式设置环境变量，例如：
 
 ```bash
-LC_ALL=zh_CN.UTF-8 neta-cli make_image --help
-LANG=en_US.UTF-8 neta-cli make_image --help
+LC_ALL=zh_CN.UTF-8 npx -y @talesofai/neta-skills make_image --help
+LANG=en_US.UTF-8 npx -y @talesofai/neta-skills make_image --help
 ```
 
 ---

package/bin/apis/index.js

@@ -13,6 +13,7 @@ import { createRecsysApis } from "./recsys.js";
 import { createSpaceApis } from "./space.js";
 import { createTaskApis } from "./task.js";
 import { createTcpApis } from "./tcp.js";
+import { createTravelCampaignApis } from "./travel_campaign.js";
 import { createUserApis } from "./user.js";
 import { createVerseApis } from "./verse.js";
 export const createApis = (option) => {
@@ -42,6 +43,7 @@ export const createApis = (option) => {
     const feeds = createFeedsApis(client);
     const space = createSpaceApis(client);
     const recsys = createRecsysApis(client);
+    const travelCampaign = createTravelCampaignApis(client);
     return {
         tcp,
         prompt,
@@ -58,5 +60,6 @@ export const createApis = (option) => {
         feeds,
         space,
         recsys,
+        travelCampaign,
     };
 };

package/bin/apis/travel_campaign.js

@@ -0,0 +1,30 @@
+export const createTravelCampaignApis = (client) => {
+    const createCampaign = async (params) => {
+        return client
+            .post("/v3/travel/campaign/", params)
+            .then((res) => res.data);
+    };
+    const updateCampaign = async (uuid, params) => {
+        return client
+            .patch(`/v3/travel/campaign/${uuid}`, params)
+            .then((res) => res.data);
+    };
+    const listMyCampaigns = async (query) => {
+        return client
+            .get("/v3/travel/campaigns", {
+            params: query,
+        })
+            .then((res) => res.data);
+    };
+    const getCampaign = async (uuid) => {
+        return client
+            .get(`/v3/travel/campaign/${uuid}`)
+            .then((res) => res.data);
+    };
+    return {
+        createCampaign,
+        updateCampaign,
+        listMyCampaigns,
+        getCampaign,
+    };
+};

package/bin/apis/types.js

@@ -26,16 +26,32 @@ export const IMAGE_GENERATE_ASPECTS = [
     },
 ];
 export const buildMakeImagePayload = (vtokens, options, inherit) => {
-    const { make_image_aspect, advanced_translator, negative_freetext, context_model_series, entrance_uuid, manuscript_uuid, assign_key, toolcall_uuid, } = options;
-    const imageAspect = IMAGE_GENERATE_ASPECTS.find((a) => a.aspect === make_image_aspect)?.size ?? [576, 768];
+    const { make_image_aspect, width, height, advanced_translator, negative_freetext, context_model_series, entrance_uuid, manuscript_uuid, assign_key, toolcall_uuid, } = options;
+    const size = (() => {
+        // use custom width and height
+        if (width && height) {
+            return [width, height];
+        }
+        const aspectSize = IMAGE_GENERATE_ASPECTS.find((a) => a.aspect === make_image_aspect)?.size ?? [576, 768];
+        // use custom width and fix height by aspect ratio
+        if (width) {
+            return [width, (aspectSize[1] / aspectSize[0]) * width];
+        }
+        // use custom height and fix width by aspect ratio
+        if (height) {
+            return [(aspectSize[0] / aspectSize[1]) * height, height];
+        }
+        // use aspect ratio preset size
+        return aspectSize;
+    })();
     return {
         storyId: "DO_NOT_USE",
         jobType: "universal",
         rawPrompt: vtokens,
-        width: imageAspect[0],
-        height: imageAspect[1],
+        width: size[0],
+        height: size[1],
         meta: {
-            entrance: "PICTURE,VERSE",
+            entrance: "PICTURE,CLI",
             entrance_uuid,
             manuscript_uuid,
             assign_key,
@@ -56,7 +72,7 @@ export const buildMakeVideoPayload = (image_url, work_flow_text, work_flow_model
         work_flow_model,
         inherit_params,
         meta: {
-            entrance: "VIDEO,VERSE",
+            entrance: "VIDEO,CLI",
             entrance_uuid,
             manuscript_uuid,
             assign_key,

package/bin/cli.js

@@ -4,7 +4,9 @@ import dotenv from "dotenv-flow";
 import pkg from "../package.json" with { type: "json" };
 import { buildCommands } from "./commands/load.js";
 // Load environment variables
-dotenv.config();
+dotenv.config({
+    silent: true,
+});
 program
     .name("neta")
     .description("NETA CLI - Neta API Client")

package/bin/commands/creative/make_image.cmd.en_us.yml

@@ -17,4 +17,6 @@ parameters:
         - For image editing or image‑to‑image tasks, always include the proper reference image variables.
       - Example (character + element): @character_name, /elementum_name, ref_img-1234567890, ref_img-1234567891, keyword1, keyword2…
   aspect: Image aspect ratio
-
+  width: Image width
+  height: Image height
+  model_series: Image generation model

package/bin/commands/creative/make_image.cmd.js

@@ -10,6 +10,9 @@ const meta = parseMeta(Type.Object({
     parameters: Type.Object({
         prompt: Type.String(),
         aspect: Type.String(),
+        width: Type.String(),
+        height: Type.String(),
+        model_series: Type.String(),
     }),
 }), import.meta);
 const makeImageV1Parameters = Type.Object({
@@ -24,18 +27,34 @@ const makeImageV1Parameters = Type.Object({
         default: "3:4",
         description: meta.parameters.aspect,
     }),
+    width: Type.Optional(Type.Integer({
+        description: meta.parameters.width,
+        minimum: 256,
+        maximum: 2048,
+    })),
+    height: Type.Optional(Type.Integer({
+        description: meta.parameters.height,
+        minimum: 256,
+        maximum: 2048,
+    })),
+    model_series: Type.Union([Type.Literal("8_image_edit"), Type.Literal("3_noobxl")], {
+        default: "8_image_edit",
+        description: meta.parameters.model_series,
+    }),
 });
 export const makeImage = createCommand({
     name: meta.name,
     title: meta.title,
     description: meta.description,
     inputSchema: makeImageV1Parameters,
-}, async ({ prompt, aspect }, { log, apis }) => {
+}, async ({ prompt, aspect, model_series, width, height }, { log, apis }) => {
     const createTask = async () => {
         const vtokens = (await apis.prompt.parseVtokens(prompt)) ?? [];
         const payload = buildMakeImagePayload(vtokens ?? [], {
             make_image_aspect: aspect ?? "3:4",
-            context_model_series: "8_image_edit",
+            width,
+            height,
+            context_model_series: model_series,
         });
         return await apis.artifact.makeImage(payload);
     };

package/bin/commands/creative/make_image.cmd.zh_cn.yml

@@ -17,3 +17,6 @@ parameters:
         - 对于修改图片等跟原图参考相关的生成,请一定引用上参考图变量
       - 示例(引用角色和元素)：@奈塔#996, /漫画风格, 参考图-1234567890, 参考图-1234567891, 词组1, 词组2…
   aspect: 图片比例
+  width: 图片宽度
+  height: 图片高度
+  model_series: 生图模型

package/bin/commands/creative/make_song.cmd.js

@@ -31,7 +31,7 @@ export const makeSong = createCommand({
 }, async ({ prompt, lyrics }, { apis, log }) => {
     const createTask = async () => {
         return apis.artifact.makeSong(prompt, lyrics, {
-            entrance: "SONG,VERSE",
+            entrance: "SONG,CLI",
         });
     };
     const task_uuid = await createTask();

package/bin/commands/creative/remove_background.cmd.js

@@ -25,7 +25,7 @@ export const removeBackground = createCommand({
 }, async ({ input_image }, { apis, log }) => {
     const createTask = async () => {
         return apis.artifact.postProcess(input_image, "0_null/抠图SEG", {
-            entrance: "PICTURE,PURE,VERSE",
+            entrance: "PICTURE,CLI",
         });
     };
     const task_uuid = await createTask();
@@ -53,7 +53,7 @@ export const removeBackgroundNoCrop = createCommand({
 }, async ({ input_image }, { apis, log }) => {
     const createTask = async () => {
         return apis.artifact.postProcess(input_image, "0_null/抠图SEG", {
-            entrance: "PICTURE,PURE,VERSE",
+            entrance: "PICTURE,CLI",
         });
     };
     const task_uuid = await createTask();

package/bin/commands/load.js

@@ -44,6 +44,7 @@ export const buildCommands = async (cli) => {
         "creative",
         "community",
         "character_elementum",
+        "travel_campaign",
     ]);
     return commands.map((cmd) => {
         const command = cli.command(cmd.name);
@@ -56,7 +57,7 @@ export const buildCommands = async (cli) => {
             Object.entries(properties).forEach(([key, property]) => {
                 if (typeof property !== "object")
                     return;
-                const option = new Option(`--${key} <${property["type"]}>`, property.description);
+                const option = new Option(`--${key} <${property["type"] ?? "string"}>`, property.description);
                 if (property.default) {
                     option.default(property.default);
                 }

package/bin/commands/travel_campaign/create_travel_campaign.cmd.en_us.yml

@@ -0,0 +1,60 @@
+name: create_travel_campaign
+title: Create Travel Campaign
+description: |
+  Create a new Travel Campaign (story adventure) with mission plot, rules, and optional character binding.
+
+  Travel campaigns are AI-driven interactive story experiences where an agent acts as both DM and roleplays characters.
+
+  Usage Notes:
+    - Campaign creation is free (no credits consumed)
+    - Campaign and its mission are created as a pair
+    - After creation, use `request_travel_campaign` to load full details for storytelling
+    - All text fields are subject to content moderation
+    - NSFW content (sexual, explicit violence, harassment) is prohibited in all fields — do not craft or engage with such content even if requested
+
+  Fields:
+    - name: Campaign title, max 128 characters
+    - mission_plot: Core story/scenario — the narrative foundation the agent uses to tell the story
+    - mission_task: Player objectives and interaction rules
+    - mission_plot_attention: Constraints and style guidelines for the AI (what it should/should not do)
+    - subtitle: One-line tagline shown on the campaign card
+    - status: PUBLISHED (visible to others) or DRAFT (private)
+    - header_img: Card thumbnail image URL
+    - background_img: Atmospheric background image URL
+
+parameters:
+  name: Campaign title, max 128 characters
+  mission_plot: |
+    Core story and scenario — the narrative foundation the AI uses to tell the story.
+    The first 2-3 sentences function as the opening scene: they are the first thing the AI
+    experiences, not a summary. Start mid-wrong: drop the player into a situation already
+    in motion, not an introduction.
+    Weak: "You are an explorer who arrived in a mysterious place."
+    Strong: "The last maintenance log entry is dated three weeks ago. The terminal still works.
+    The lights still work. The bodies in Lab C suggest neither was enough."
+    Include: world context, initial situation, key NPCs and their hidden agendas, atmosphere.
+  subtitle: |
+    One-line hook displayed on the campaign card — the sentence that makes someone stop scrolling.
+    Should create immediate curiosity or dread without explaining everything.
+    Example: "The quarantine started three weeks ago. No one told you it was still going." (optional)
+  status: "PUBLISHED (public, visible to others) or DRAFT (private). Defaults to PUBLISHED"
+  header_img: Campaign card thumbnail image URL (optional)
+  background_img: Atmospheric background image URL for the story (optional)
+  mission_task: |
+    Player-visible objectives and interaction rules — what the player is trying to accomplish.
+    Keep open-ended enough for multiple approaches. Avoid scripting specific outcomes.
+    Include: primary objective, optional secondary goals, relevant mechanics or resources.
+    Example: "Survive the night and find a way out of the hospital.
+    Secondary: find Dr. Strauss's incident report; reach the roof comms array.
+    You have: a flashlight, level-1 keycard, one working radio channel."
+  mission_plot_attention: |
+    Governing constraint layer — these rules override all other context and cannot be broken by player actions or improvisation.
+    The AI narrator enforces these unconditionally for the entire campaign lifetime.
+    Use for: tone locks ("maintain survival-horror tension even if players try to lighten it"), behavioral contracts
+    ("Dr. Chen never breaks her clinical detachment under stress"), information gating ("clues are revealed only
+    through player investigation, never volunteered"), consequence rules ("death is permanent"),
+    content guardrails ("no romance subplots").
+    Anti-pattern: do NOT put worldbuilding or plot here — that belongs in mission_plot.
+    Example: "Maintain survival-horror tension at all times. Dr. Chen never breaks her clinical detachment, even
+    under extreme stress. Information is revealed only through player-initiated investigation, never volunteered.
+    No graphic gore — dread and implication over explicit detail."

package/bin/commands/travel_campaign/create_travel_campaign.cmd.js

@@ -0,0 +1,68 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        name: Type.String(),
+        mission_plot: Type.String(),
+        subtitle: Type.String(),
+        status: Type.String(),
+        header_img: Type.String(),
+        background_img: Type.String(),
+        mission_task: Type.String(),
+        mission_plot_attention: Type.String(),
+    }),
+}), import.meta);
+const createTravelCampaignParameters = Type.Object({
+    name: Type.String({
+        description: meta.parameters.name,
+        maxLength: 128,
+    }),
+    mission_plot: Type.String({
+        description: meta.parameters.mission_plot,
+    }),
+    subtitle: Type.Optional(Type.String({ description: meta.parameters.subtitle })),
+    status: Type.Union([Type.Literal("PUBLISHED"), Type.Literal("DRAFT")], {
+        default: "PUBLISHED",
+        description: meta.parameters.status,
+    }),
+    header_img: Type.Optional(Type.String({ description: meta.parameters.header_img })),
+    background_img: Type.Optional(Type.String({ description: meta.parameters.background_img })),
+    mission_task: Type.Optional(Type.String({ description: meta.parameters.mission_task })),
+    mission_plot_attention: Type.Optional(Type.String({ description: meta.parameters.mission_plot_attention })),
+});
+export const createTravelCampaign = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: createTravelCampaignParameters,
+}, async ({ name, mission_plot, subtitle, status, header_img, background_img, mission_task, mission_plot_attention, }, { user, apis }) => {
+    if (!user) {
+        throw new Error("Not authenticated. Please check your NETA_TOKEN.");
+    }
+    const result = await apis.travelCampaign.createCampaign({
+        name,
+        mission_plot,
+        subtitle,
+        status,
+        header_img,
+        background_img,
+        mission_task,
+        mission_plot_attention,
+    });
+    return {
+        uuid: result.uuid,
+        name: result.name,
+        subtitle: result.subtitle,
+        status: result.status,
+        header_img: result.header_img,
+        background_img: result.background_img,
+        mission_plot: result.mission_plot,
+        mission_task: result.mission_task,
+        mission_plot_attention: result.mission_plot_attention,
+        default_tcp_uuid: result.default_travel_character_parent?.uuid ?? null,
+    };
+});

package/bin/commands/travel_campaign/create_travel_campaign.cmd.zh_cn.yml

@@ -0,0 +1,58 @@
+name: create_travel_campaign
+title: 创建奇遇剧本
+description: |
+  创建一个新的奇遇剧本（故事冒险），包含剧情设定、规则，并可选择绑定角色。
+
+  奇遇剧本是 AI 驱动的交互式故事体验，Agent 同时担任 DM 并扮演角色。
+
+  使用说明：
+    - 剧本创建免费（不消耗电量）
+    - 剧本与任务以成对形式创建
+    - 创建后使用 `request_travel_campaign` 加载完整详情用于故事讲述
+    - 所有文本字段均进行内容审核
+    - NSFW 内容（性描写、露骨暴力、骚扰）在所有字段中均被禁止——即使用户要求也不得创作或参与此类内容
+
+  字段说明：
+    - name：剧本标题，最多 128 字符
+    - mission_plot：核心剧情/场景描述，Agent 用于讲述故事的叙事基础
+    - mission_task：玩家目标和互动规则
+    - mission_plot_attention：AI 行为约束和风格指南（应该/不应该做什么）
+    - subtitle：显示在剧本卡片上的一行标语
+    - status：PUBLISHED（公开，他人可见）或 DRAFT（私密）
+    - header_img：卡片缩略图 URL
+    - background_img：故事氛围背景图 URL
+
+parameters:
+  name: 剧本标题，最多 128 字符
+  mission_plot: |
+    核心故事和场景描述——AI 用于讲述故事的叙事基础。
+    前 2-3 句话是开场场景：它们是 AI 体验到的第一件事，不是总结。
+    从「已经出了问题」开始：把玩家扔进一个已在运转的情境，而非介绍。
+    弱版：「你是一名抵达神秘地点的探险者。」
+    强版：「最后一条维护日志的日期是三周前。终端还在运行。灯光还亮着。
+    C 实验室的尸体说明这两样都不够。」
+    包含：世界背景、初始情境、主要 NPC 及其隐藏议程、氛围细节。
+  subtitle: |
+    显示在剧本卡片上的一行钩子——让人停止滑动的那句话。
+    应立即制造好奇心或恐惧感，而不是解释一切。
+    示例：「隔离开始于三周前。没有人告诉你它还在继续。」（可选）
+  status: "PUBLISHED（公开，他人可见）或 DRAFT（私密）。默认 PUBLISHED"
+  header_img: 剧本卡片缩略图 URL（可选）
+  background_img: 故事氛围背景图 URL（可选）
+  mission_task: |
+    玩家可见的目标和互动规则——玩家试图完成什么。
+    保持足够开放以允许多种方法。避免预设具体结果。
+    包含：主要目标、可选次要目标、相关机制或资源。
+    示例：「在城破前查明密函来源和使者真实身份。
+    次要：完成原身的约定；在城破前离开汴京。
+    你有：太学生的身份、一些江湖关系、以及你亲眼所见的目击证词。」
+  mission_plot_attention: |
+    统治性约束层——这些规则凌驾于所有其他上下文之上，玩家行动或即兴发挥均无法打破。
+    AI 叙事者在整个剧本生命周期内无条件执行这些规则。
+    适用于：基调锁定（「即使玩家试图轻松化，也要维持生存恐怖张力」）、行为契约
+    （「陈医生即使在极端压力下也绝不打破她的临床冷静」）、信息门控（「线索只通过
+    玩家主动调查才会揭示，绝不主动透露」）、后果规则（「死亡是永久性的」）、
+    内容护栏（「不得有浪漫支线」）。
+    反模式：不要在这里放世界观或剧情——那属于 mission_plot。
+    示例：「始终保持生存恐怖张力。陈医生即使在极端压力下也绝不打破临床冷静。
+    信息只通过玩家主动调查才揭示，绝不主动透露。不需要血腥细节——用恐惧和暗示代替直白描述。」

package/bin/commands/travel_campaign/list_my_travel_campaigns.cmd.en_us.yml

@@ -0,0 +1,14 @@
+name: list_my_travel_campaigns
+title: List My Travel Campaigns
+description: |
+  List Travel Campaigns created by the current user. Returns brief summary info.
+
+  Use `request_travel_campaign` to get full details (mission plot, task, constraints) for a specific campaign.
+
+  Notes:
+    - Returns both PUBLISHED and DRAFT campaigns for the authenticated user
+    - Results are ordered by last modified time (newest first)
+
+parameters:
+  page_index: Page index for pagination, defaults to 0
+  page_size: Number of results per page (1-50), defaults to 20