@zhin.js/plugin-text-adventure 1.0.0

package/lib/story-transitions.js

@@ -0,0 +1,193 @@
+export function resolveTransition(state, choiceId) {
+    const { sceneId } = state;
+    if (choiceId === 'restart') {
+        return { nextSceneId: 'start', hpDelta: 100 - state.hp, endingId: '' };
+    }
+    if (sceneId === 'flooded_hall' && choiceId === 'wade_market') {
+        const hp = state.hp - 25;
+        if (hp <= 0)
+            return { nextSceneId: 'drowned', hpDelta: -25, endingId: 'drowned' };
+        return { nextSceneId: 'market_ruins', hpDelta: -25 };
+    }
+    const hpFail = (next, delta) => ({
+        nextSceneId: state.hp + delta <= 0 ? 'defeat' : next,
+        hpDelta: delta,
+        endingId: state.hp + delta <= 0 ? 'defeat' : '',
+    });
+    const map = {
+        start: {
+            push_door: { nextSceneId: 'corridor' },
+            search_rubble: { nextSceneId: 'rubble' },
+            climb_tower: { nextSceneId: 'watchtower' },
+            vine_path: { nextSceneId: 'vine_path' },
+            leave: { nextSceneId: 'coward', endingId: 'coward' },
+        },
+        rubble: {
+            take_torch: { nextSceneId: 'start', addItem: 'torch' },
+            take_blade: { nextSceneId: 'start', addItem: 'rusted_blade' },
+            back_entrance: { nextSceneId: 'start' },
+        },
+        watchtower: {
+            survey_map: { nextSceneId: 'watchtower', setFlag: 'saw_map' },
+            take_chart_fragment: { nextSceneId: 'watchtower', addItem: 'star_chart' },
+            enter_observatory: { nextSceneId: 'observatory' },
+            descend_tower: { nextSceneId: 'start' },
+        },
+        vine_path: {
+            enter_garden: { nextSceneId: 'garden' },
+            back_entrance: { nextSceneId: 'start' },
+        },
+        corridor: {
+            go_blue: { nextSceneId: 'spring' },
+            go_stairs: { nextSceneId: 'depths' },
+            go_flooded: { nextSceneId: 'flooded_hall' },
+            study_mural: { nextSceneId: 'mural_room' },
+            enter_bell_tower: { nextSceneId: 'bell_tower' },
+            go_back: { nextSceneId: 'start' },
+        },
+        mural_room: {
+            memorize: { nextSceneId: 'mural_room', setFlag: 'knows_sequence' },
+            enter_whisper: { nextSceneId: 'whisper_gallery' },
+            back_corridor: { nextSceneId: 'corridor' },
+        },
+        whisper_gallery: {
+            listen_deep: { nextSceneId: 'whisper_gallery', setFlag: 'whisper_lore' },
+            back_mural: { nextSceneId: 'mural_room' },
+        },
+        spring: {
+            drink: { nextSceneId: 'spring', hpDelta: 30, setFlag: 'healed' },
+            take_gem: { nextSceneId: 'spring', addItem: 'gem' },
+            talk_spirit: { nextSceneId: 'spring', setFlag: 'spirit_met' },
+            offer_gem: { nextSceneId: 'spring', removeItem: 'gem', addItem: 'amulet', setFlag: 'spirit_blessed' },
+            leave_spring: { nextSceneId: 'corridor' },
+        },
+        flooded_hall: {
+            use_feather_wade: { nextSceneId: 'market_ruins', removeItem: 'elf_feather' },
+            drink_elixir_warm: { nextSceneId: 'market_ruins', removeItem: 'elixir' },
+            back_corridor: { nextSceneId: 'corridor' },
+        },
+        market_ruins: {
+            buy_mask_coin: { nextSceneId: 'market_ruins', removeItem: 'silver_coin', addItem: 'masquerade_mask' },
+            trade_gem_coin: { nextSceneId: 'market_ruins', removeItem: 'gem', addItem: 'silver_coin' },
+            go_bridge: { nextSceneId: 'ghost_bridge' },
+            leave_market: { nextSceneId: 'flooded_hall' },
+        },
+        garden: {
+            pick_herb: { nextSceneId: 'garden', addItem: 'herb' },
+            rest_tree: { nextSceneId: 'garden', hpDelta: 20, setFlag: 'rested' },
+            enter_greenhouse: { nextSceneId: 'greenhouse' },
+            open_iron_door: { nextSceneId: 'library' },
+            stay_forever: { nextSceneId: 'hermit', endingId: 'hermit' },
+            back_corridor: { nextSceneId: 'corridor' },
+        },
+        greenhouse: {
+            brew_elixir: { nextSceneId: 'greenhouse', removeItem: 'herb', addItem: 'elixir' },
+            back_garden: { nextSceneId: 'garden' },
+        },
+        library: {
+            take_scroll: { nextSceneId: 'library', addItem: 'scroll' },
+            take_key: { nextSceneId: 'library', addItem: 'key' },
+            read_archive: { nextSceneId: 'library', setFlag: 'read_archive' },
+            enter_forge: { nextSceneId: 'ember_forge' },
+            back_garden: { nextSceneId: 'garden' },
+        },
+        ember_forge: {
+            forge_blade: { nextSceneId: 'ember_forge', setFlag: 'forged_blade' },
+            upgrade_amulet: { nextSceneId: 'ember_forge', removeItem: 'moon_shard', setFlag: 'amulet_upgraded' },
+            back_library: { nextSceneId: 'library' },
+        },
+        bell_tower: {
+            ring_bell: { nextSceneId: 'bell_tower', addItem: 'spirit_bell' },
+            back_corridor: { nextSceneId: 'corridor' },
+        },
+        depths: {
+            fight: hpFail('crypt_entry', -50),
+            fight_blade: { nextSceneId: 'crypt_entry', hpDelta: -20, setFlag: 'shadow_banished' },
+            use_torch: { nextSceneId: 'crypt_entry', setFlag: 'shadow_banished' },
+            use_herb: { nextSceneId: 'crypt_entry', removeItem: 'herb', setFlag: 'shadow_banished' },
+            flee: { nextSceneId: 'escape', endingId: 'escape' },
+        },
+        crypt_entry: {
+            go_vault: { nextSceneId: 'vault' },
+            go_catacombs: { nextSceneId: 'catacombs' },
+            go_spider: { nextSceneId: 'spider_nest' },
+            go_sealed: { nextSceneId: 'sealed_gates' },
+            back_corridor: { nextSceneId: 'corridor' },
+        },
+        spider_nest: {
+            cut_web_blade: { nextSceneId: 'shadow_maze' },
+            burn_web: { nextSceneId: 'shadow_maze' },
+            flee_spider: { nextSceneId: 'spider', endingId: 'spider' },
+        },
+        shadow_maze: {
+            navigate_compass: { nextSceneId: 'crystal_cave' },
+            wander_maze: { nextSceneId: 'labyrinth', endingId: 'labyrinth' },
+            back_spider: { nextSceneId: 'spider_nest' },
+        },
+        catacombs: {
+            read_scroll: { nextSceneId: 'ossuary' },
+            dash_trap: hpFail('ossuary', -35),
+            enter_prison: { nextSceneId: 'prison_cell' },
+            take_key_skeleton: { nextSceneId: 'catacombs', addItem: 'key' },
+            back_crypt: { nextSceneId: 'crypt_entry' },
+        },
+        prison_cell: {
+            take_coin: { nextSceneId: 'prison_cell', addItem: 'silver_coin' },
+            free_ghost: { nextSceneId: 'redemption', endingId: 'redemption' },
+            back_catacombs: { nextSceneId: 'catacombs' },
+        },
+        ossuary: {
+            answer_greed: { nextSceneId: 'ossuary', hpDelta: -25 },
+            answer_flood: { nextSceneId: 'wisdom', endingId: 'wisdom' },
+            answer_star: { nextSceneId: 'ossuary', addItem: 'amulet' },
+            back_catacombs: { nextSceneId: 'catacombs' },
+        },
+        ghost_bridge: {
+            pay_coin: { nextSceneId: 'crystal_cave', removeItem: 'silver_coin' },
+            cross_feather: { nextSceneId: 'crystal_cave', removeItem: 'elf_feather' },
+            back_market: { nextSceneId: 'market_ruins' },
+        },
+        crystal_cave: {
+            take_moon_shard: { nextSceneId: 'crystal_cave', addItem: 'moon_shard' },
+            take_feather: { nextSceneId: 'crystal_cave', addItem: 'elf_feather' },
+            enter_moon_pool: { nextSceneId: 'moon_pool' },
+            back_bridge: { nextSceneId: 'ghost_bridge' },
+        },
+        moon_pool: {
+            align_chart: { nextSceneId: 'moon_pool', setFlag: 'moon_blessed' },
+            dive_shrine: { nextSceneId: 'sunken_shrine' },
+            back_crystal: { nextSceneId: 'crystal_cave' },
+        },
+        sunken_shrine: {
+            ritual_star_keeper: { nextSceneId: 'star_keeper', endingId: 'star_keeper' },
+            back_moon_pool: { nextSceneId: 'moon_pool' },
+        },
+        observatory: {
+            craft_compass: { nextSceneId: 'observatory', addItem: 'compass' },
+            back_tower: { nextSceneId: 'watchtower' },
+        },
+        sealed_gates: {
+            open_gates: { nextSceneId: 'vault' },
+            back_crypt: { nextSceneId: 'crypt_entry' },
+        },
+        vault: {
+            seq_light_shadow_door: { nextSceneId: 'vault_open' },
+            seq_door_light_shadow: { nextSceneId: 'wisdom', endingId: 'wisdom' },
+            seq_shadow_door_light: { nextSceneId: 'defeat', hpDelta: -100, endingId: 'defeat' },
+            back_crypt: { nextSceneId: 'crypt_entry' },
+        },
+        vault_open: {
+            descend_throne: { nextSceneId: 'throne_room' },
+            take_treasure_now: { nextSceneId: 'treasure', endingId: 'treasure' },
+            back_crypt: { nextSceneId: 'crypt_entry' },
+        },
+        throne_room: {
+            ascend: { nextSceneId: 'ascension', endingId: 'ascension' },
+            ascend_mask: { nextSceneId: 'mask_king', endingId: 'mask_king' },
+            claim_crown: { nextSceneId: 'curse', endingId: 'curse' },
+            retreat_throne: { nextSceneId: 'treasure', endingId: 'treasure' },
+        },
+    };
+    return map[sceneId]?.[choiceId] ?? null;
+}
+//# sourceMappingURL=story-transitions.js.map

package/lib/story-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-transitions.js","sourceRoot":"","sources":["../src/story-transitions.ts"],"names":[],"mappings":"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"}

package/lib/story-types.d.ts

@@ -0,0 +1,30 @@
+/** 游戏 payload 前缀 */
+export declare const ADV_PREFIX = "adv";
+export interface SceneChoice {
+    id: string;
+    label: string;
+    style?: 'primary' | 'danger' | 'secondary';
+    requires?: (state: GameState) => boolean;
+}
+export interface Scene {
+    id: string;
+    text: string | ((state: GameState) => string);
+    choices: SceneChoice[];
+    terminal?: boolean;
+}
+export interface GameState {
+    sceneId: string;
+    hp: number;
+    inventory: string[];
+    flags: Record<string, boolean>;
+    endingId: string;
+}
+export interface ChoiceResult {
+    nextSceneId: string;
+    hpDelta?: number;
+    addItem?: string;
+    removeItem?: string;
+    setFlag?: string;
+    endingId?: string;
+}
+//# sourceMappingURL=story-types.d.ts.map

package/lib/story-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-types.d.ts","sourceRoot":"","sources":["../src/story-types.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC;IAC9C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/lib/story-types.js

@@ -0,0 +1,3 @@
+/** 游戏 payload 前缀 */
+export const ADV_PREFIX = 'adv';
+//# sourceMappingURL=story-types.js.map

package/lib/story-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-types.js","sourceRoot":"","sources":["../src/story-types.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC"}

package/lib/story.d.ts

@@ -0,0 +1,21 @@
+export { ADV_PREFIX } from './story-types.js';
+export type { SceneChoice, Scene, GameState, ChoiceResult } from './story-types.js';
+export { ITEM_LABELS, ITEM_IDS, itemLabel } from './story-items.js';
+export { SCENES, countScenes } from './story-scenes.js';
+import type { GameState, ChoiceResult, Scene } from './story-types.js';
+export declare function parseInventory(value: string | string[] | unknown): string[];
+export declare function parseFlags(value: string | Record<string, boolean> | unknown): Record<string, boolean>;
+export declare function stateFromSession(row: {
+    scene_id: string;
+    hp: number;
+    inventory: string;
+    flags: string;
+    ending_id: string;
+}): GameState;
+export declare function formatStatusBar(state: GameState): string;
+export declare function resolveChoice(state: GameState, choiceId: string): ChoiceResult | null;
+export declare function getScene(sceneId: string): Scene | undefined;
+export declare function visibleChoices(scene: Scene, state: GameState): import("./story-types.js").SceneChoice[];
+export declare function applyChoiceResult(state: GameState, result: ChoiceResult): GameState;
+export declare function sceneNarrative(scene: Scene, state: GameState): string;
+//# sourceMappingURL=story.d.ts.map

package/lib/story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAKvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,EAAE,CAW3E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAarG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,SAAS,CAQZ;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAKxD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErF;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,4CAE5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,CAwBnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAIrE"}

package/lib/story.js

@@ -0,0 +1,91 @@
+export { ADV_PREFIX } from './story-types.js';
+export { ITEM_LABELS, ITEM_IDS, itemLabel } from './story-items.js';
+export { SCENES, countScenes } from './story-scenes.js';
+import { itemLabel } from './story-items.js';
+import { SCENES } from './story-scenes.js';
+import { resolveTransition } from './story-transitions.js';
+export function parseInventory(value) {
+    if (Array.isArray(value)) {
+        return value.filter((x) => typeof x === 'string');
+    }
+    if (typeof value !== 'string' || !value)
+        return [];
+    try {
+        const v = JSON.parse(value);
+        return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function parseFlags(value) {
+    if (value != null && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value !== 'string' || !value)
+        return {};
+    try {
+        const v = JSON.parse(value);
+        return v != null && typeof v === 'object' && !Array.isArray(v)
+            ? v
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function stateFromSession(row) {
+    return {
+        sceneId: row.scene_id,
+        hp: row.hp,
+        inventory: parseInventory(row.inventory),
+        flags: parseFlags(row.flags),
+        endingId: row.ending_id,
+    };
+}
+export function formatStatusBar(state) {
+    const items = state.inventory.length
+        ? state.inventory.map(itemLabel).join('、')
+        : '无';
+    return `❤️ ${Math.max(0, state.hp)}  ·  🎒 ${items}`;
+}
+export function resolveChoice(state, choiceId) {
+    return resolveTransition(state, choiceId);
+}
+export function getScene(sceneId) {
+    return SCENES[sceneId];
+}
+export function visibleChoices(scene, state) {
+    return scene.choices.filter((c) => !c.requires || c.requires(state));
+}
+export function applyChoiceResult(state, result) {
+    const inventory = [...state.inventory];
+    if (result.addItem && !inventory.includes(result.addItem)) {
+        inventory.push(result.addItem);
+    }
+    if (result.removeItem) {
+        const idx = inventory.indexOf(result.removeItem);
+        if (idx >= 0)
+            inventory.splice(idx, 1);
+    }
+    const flags = { ...state.flags };
+    if (result.setFlag)
+        flags[result.setFlag] = true;
+    const hp = Math.min(100, Math.max(0, state.hp + (result.hpDelta ?? 0)));
+    const nextScene = getScene(result.nextSceneId);
+    const endingId = result.endingId ?? (nextScene?.terminal ? result.nextSceneId : '');
+    return {
+        sceneId: result.nextSceneId,
+        hp,
+        inventory,
+        flags,
+        endingId,
+    };
+}
+export function sceneNarrative(scene, state) {
+    const body = typeof scene.text === 'function' ? scene.text(state) : scene.text;
+    if (scene.terminal)
+        return body;
+    return `${body}\n\n${formatStatusBar(state)}`;
+}
+//# sourceMappingURL=story.js.map

package/lib/story.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.js","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@zhin.js/plugin-text-adventure",
+  "version": "1.0.0",
+  "description": "Zhin.js 交互式文字冒险 — 分支剧情与选项按钮",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "plugin.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "plugin",
+    "game",
+    "text-adventure"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "zhin.js": "4.1.0"
+  },
+  "dependencies": {
+    "@zhin.js/game-shared": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "zhin.js": "4.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/games/text-adventure"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,2 @@
+name: "@zhin.js/plugin-text-adventure"
+description: "交互式文字冒险游戏"

package/src/achievements.ts

@@ -0,0 +1,90 @@
+import { ITEM_IDS } from './story-items.js';
+import { endingIds, playableSceneIds } from './story-catalog.js';
+
+export interface AchievementDef {
+  id: string;
+  icon: string;
+  title: string;
+  description: string;
+  hidden?: boolean;
+}
+
+export interface AchievementContext {
+  visited: Set<string>;
+  endings: Set<string>;
+  itemsFound: Set<string>;
+  runsCompleted: number;
+  bestStepCount: number;
+  lastRun?: {
+    stepCount: number;
+    inventory: string[];
+    endingId: string;
+  };
+}
+
+export const ACHIEVEMENTS: AchievementDef[] = [
+  { id: 'first_footprint', icon: '👣', title: '初探者', description: '累计探索 5 个区域' },
+  { id: 'cartographer', icon: '🗺️', title: '制图师', description: '解锁半数区域（50%+）' },
+  { id: 'master_explorer', icon: '🧭', title: '全图行者', description: '解锁全部可探索区域' },
+  { id: 'ending_hunter', icon: '🎬', title: '结局猎人', description: '见证 3 种不同结局' },
+  { id: 'ending_collector', icon: '📚', title: '结局收藏家', description: '见证 8 种不同结局' },
+  { id: 'completionist', icon: '👑', title: '秘境通晓者', description: '见证全部 15 种结局' },
+  { id: 'star_ascendant', icon: '🌟', title: '星辉守忆', description: '达成「星辉归位」结局' },
+  { id: 'moon_guardian', icon: '🌙', title: '月池星守', description: '达成「星守誓约」结局' },
+  { id: 'mask_monarch', icon: '🎭', title: '面具之王', description: '达成「面具之王」结局' },
+  { id: 'item_hoarder', icon: '🎒', title: '拾荒大师', description: '生涯累计发现 10 种道具' },
+  { id: 'full_satchel', icon: '💎', title: '万象行囊', description: '生涯集齐全部 15 种道具' },
+  { id: 'marathon_runner', icon: '🏃', title: '马拉松探险', description: '单局步数达到 50+' },
+  { id: 'veteran', icon: '⚔️', title: '遗迹老兵', description: '完成 5 局冒险' },
+  { id: 'whisper_listener', icon: '👂', title: '低语聆听者', description: '进入低语画廊' },
+  { id: 'deep_diver', icon: '🌊', title: '沉殿潜行者', description: '抵达水下沉殿' },
+];
+
+const PLAYABLE_TOTAL = playableSceneIds().length;
+const ENDING_TOTAL = endingIds().length;
+const HALF_REGIONS = Math.ceil(PLAYABLE_TOTAL / 2);
+
+function checks(): Record<string, (ctx: AchievementContext) => boolean> {
+  return {
+    first_footprint: (ctx) => ctx.visited.size >= 5,
+    cartographer: (ctx) => ctx.visited.size >= HALF_REGIONS,
+    master_explorer: (ctx) => ctx.visited.size >= PLAYABLE_TOTAL,
+    ending_hunter: (ctx) => ctx.endings.size >= 3,
+    ending_collector: (ctx) => ctx.endings.size >= 8,
+    completionist: (ctx) => ctx.endings.size >= ENDING_TOTAL,
+    star_ascendant: (ctx) => ctx.endings.has('ascension'),
+    moon_guardian: (ctx) => ctx.endings.has('star_keeper'),
+    mask_monarch: (ctx) => ctx.endings.has('mask_king'),
+    item_hoarder: (ctx) => ctx.itemsFound.size >= 10,
+    full_satchel: (ctx) => ITEM_IDS.every((id) => ctx.itemsFound.has(id)),
+    marathon_runner: (ctx) => (ctx.lastRun?.stepCount ?? ctx.bestStepCount) >= 50,
+    veteran: (ctx) => ctx.runsCompleted >= 5,
+    whisper_listener: (ctx) => ctx.visited.has('whisper_gallery'),
+    deep_diver: (ctx) => ctx.visited.has('sunken_shrine'),
+  };
+}
+
+export function evaluateAchievements(
+  unlocked: string[],
+  ctx: AchievementContext,
+): string[] {
+  const have = new Set(unlocked);
+  const run = checks();
+  const newly: string[] = [];
+  for (const def of ACHIEVEMENTS) {
+    if (have.has(def.id)) continue;
+    if (run[def.id]?.(ctx)) {
+      have.add(def.id);
+      newly.push(def.id);
+    }
+  }
+  return newly;
+}
+
+export function achievementById(id: string): AchievementDef | undefined {
+  return ACHIEVEMENTS.find((a) => a.id === id);
+}
+
+export function totalAchievements(): number {
+  return ACHIEVEMENTS.length;
+}

package/src/adv-command.ts

@@ -0,0 +1,72 @@
+import type { Message, Plugin } from 'zhin.js';
+import { channelKey } from '@zhin.js/game-shared';
+import {
+  continueAdventure,
+  sessionSummary,
+  startAdventure,
+} from './game-flow.js';
+import { formatAchievements, formatMapProgress, formatProgressCompact } from './profile-format.js';
+import type { GameServices } from './session-service.js';
+
+export const ADV_HELP = [
+  '秘境探险 · 文字冒险',
+  '冒险 / adv — 帮助与状态',
+  '冒险 开始 — 开始新冒险',
+  '冒险 继续 — 刷新当前场景',
+  '冒险 地图 — 全图探索进度',
+  '冒险 成就 — 成就列表',
+  '冒险 放弃 — 放弃当前冒险',
+  '',
+  '推进方式：点击选项按钮，或回复数字（1、2…）',
+].join('\n');
+
+export async function runAdvCommand(
+  plugin: Plugin,
+  services: GameServices,
+  message: Message<any>,
+  action: string,
+): Promise<string | undefined> {
+  const ch = channelKey(message);
+  const userId = message.$sender.id;
+  const userName = message.$sender.name?.trim() || userId;
+
+  if (!action || action === 'help') {
+    const active = await services.sessions.getActiveByChannel(ch);
+    const profile = await services.profiles.getOrCreate(userId, userName);
+    const lines = [ADV_HELP, '', formatProgressCompact(profile), ''];
+    if (active) {
+      lines.push('— 当前频道 —');
+      lines.push(sessionSummary(active));
+    } else {
+      lines.push('暂无冒险，发送「冒险 开始」或从游戏大厅进入。');
+    }
+    return lines.join('\n');
+  }
+
+  if (action === 'start') {
+    return startAdventure(plugin, services, message);
+  }
+
+  if (action === 'continue') {
+    return continueAdventure(plugin, services, message);
+  }
+
+  if (action === 'map') {
+    const profile = await services.profiles.getOrCreate(userId, userName);
+    return formatMapProgress(profile);
+  }
+
+  if (action === 'achievements' || action === 'achievement') {
+    const profile = await services.profiles.getOrCreate(userId, userName);
+    return formatAchievements(profile);
+  }
+
+  if (action === 'quit') {
+    const row = await services.sessions.getActiveForUser(ch, userId);
+    if (!row) return '你没有进行中的冒险。';
+    await services.sessions.updateSession(row.id, { status: 'aborted' });
+    return '你已放弃冒险。';
+  }
+
+  return `未知子命令：${action}\n\n${ADV_HELP}`;
+}