Repository navigation
简体中文
中文更新
主要更新
- Core 运行时:新增统一 runtime API,支持编译 Markdown / Flow 运行时程序、快照与回滚、存储契约、声明式插件运行时,并暴露无头 runtime/compiler 入口(0151e5d、5e1c855、414b301)。
- 原生音频与 JSON Flow:新增原生音频契约与稳定对白标识,运行时可执行序列化 Flow 项目;新增 TTS 语音创作与示例审阅(3f7fd85、c1eb571、abbb28a)。
- Editor / 桌面端:新增桌面端打包创作客户端、统一 UI 插件工作区、项目流程层级可视化、角色与音频资源面板(db456fe、9200eb9、4e86f5d、6c27dfe)。
- Studio:新增托管 AI 创作、云端资源同步、移动端创作流程、编辑时编译脚本、原生 SSO(2f44b6e、e9796440、0a71b4a、5ed6407)。
- 玩家功能:手动/自动/快速存档(19949d2);对白术语映射与解释弹窗(#31);项目自定义起始页(069221c)。
- 开发工具:DevTools 静态诊断、运行时检查器与命令轨迹;CLI 新增 runtime program 检查和 agent 辅助工作流(c399259、d537e83、4a6ed48、5d86853)。
- Three.js / 插件 / 示例:可复用渲染 API 与场景示例、地图角色移动;活动渲染器插件;新增 Hamster 旗舰示例(48318be、4cc6440、6959009、eddb33d)。
问题修复
- 缩放视口下对白与选项可读性(5600083);BGM 切换重叠(b745a5f)。
- Editor:原子保存后保留文件通知、持久化清空的角色语音配置(52d633b、7202dd4)。
- 编译器保留显式 Markdown 结尾、解析内联角色引用(d0124bd、0264433)。
- create-adv 脚手架打包与完整模板(#30);core 声明 dayjs 依赖(#43);支持 Vite 8 构建 VRM(895d207)。
升级注意
English
Release Highlights
Highlights
- Core runtime: unified runtime API, compilation of Markdown/Flow runtime programs, snapshots and rollback, a storage contract, a declarative plugin runtime, and headless runtime/compiler entries (0151e5d, 5e1c855, 414b301).
- Native audio and JSON Flow: native audio contracts with stable dialogue identities, runtime execution of serialized Flow projects, and TTS voice authoring with sample review (3f7fd85, c1eb571, abbb28a).
- Editor / desktop: a packaged desktop authoring client, a unified UI plugin workspace, hierarchical project flow visualization, and character and audio resource panels (db456fe, 9200eb9, 4e86f5d, 6c27dfe).
- Studio: managed AI authoring, cloud asset sync, mobile authoring workflows, compile-while-editing, and first-party native SSO (2f44b6e, e9796440, 0a71b4a, 5ed6407).
- Player features: manual/auto/quick save (19949d2); dialogue glossary mapping with explanation popups (#31); project-defined start pages (069221c).
- Dev tooling: DevTools static diagnostics, runtime inspector and command traces; CLI runtime program checks and agent-assisted workflows (c399259, d537e83, 4a6ed48, 5d86853).
- Three.js / plugins / demos: reusable rendering APIs and a scene demo, map character movement, activity renderer plugins, and a new Hamster flagship showcase (48318be, 4cc6440, 6959009, eddb33d).
Fixes
- Dialogue and choices stay readable on scaled viewports (5600083); overlapping BGM transitions prevented (b745a5f).
- Editor: file notifications retained after atomic saves, and cleared character voice profiles now persist (52d633b, 7202dd4).
- Compiler preserves explicit Markdown endings; inline character references resolve (d0124bd, 0264433).
- create-adv scaffolder packaging and full templates (#30); core declares the dayjs dependency (#43); VRM builds with Vite 8 (895d207).
Upgrade Notes
完整变更记录 / Full Changelog
0.1.4
Source: 55584d6f3cd903d74c985e6b8fcd27dbbc3394db
Features
- three-map: add character movement and animation lifecycle (4cc6440)
- demo: migrate examples to native audio and JSON Flow (b29a2f0)
- studio: add voice authoring and native Flow export (0fb45fa)
- editor: add voice authoring and native Flow workspaces (dc762ea)
- voice: add durable TTS jobs and audio publication services (1f973e7)
- runtime: execute native audio and serialized Flow projects (c1eb571)
- audio: add native audio contracts and stable dialogue identities (3f7fd85)
- 支持对白术语映射与解释弹窗 (#31) (bf6de95)
- 选择性迁移旧 Editor 分支并补齐安全与生命周期验证 (78ba854)
- voice: add provider-neutral authoring and sample review (abbb28a)
- editor: visualize hierarchical project flows (4e86f5d)
- editor: add project authoring and starter previews (77c7610)
- core: expose headless runtime and compiler entries (414b301)
- three: add reusable rendering APIs and scene demo (48318be)
- devtools: add static diagnostics and runtime inspection (c399259)
- editor: expand desktop workspaces and project previews (cc2c247)
- ui: unify AGUI and player controls (580131d)
- desktop: add packaged project authoring client (db456fe)
- editor: unify character and audio resource panels (6c27dfe)
- agui: unify numeric controls and resource navigation (c878e50)
- ui: isolate game color modes and accessible overlays (f7cad83)
- ui: separate game and authoring design systems (6113c8f)
- editor: add unified UI plugin workspace (9200eb9)
- deploy: add Cloudflare origin proxy (c1bfad2)
- studio: hydrate cloudbase user profile (711a983)
- studio: add managed AI authoring runtime (2f44b6e)
- brand: align ADV.JS icon family (5316c06)
- studio: refine app icon for adventure stories (5e7f9e6)
- studio: add dedicated app icon (78854b3)
- studio: add first-party native SSO (5ed6407)
- assets: add Codex authoring workflow (1511195)
- character: add shared character catalog package (6fd0b1f)
- save: add manual auto and quick save workflows (19949d2)
- cli: add agent-assisted editor and deployment workflows (5d86853)
- hamster: rebuild flagship showcase experience (eddb33d)
- studio: add managed mobile authoring workflows (0a71b4a)
- runtime: add unified project assets and presentation (fe6a900)
- studio: add managed cloud asset sync (e979644)
- hamster: polish flagship demo presentation (2ba075f)
- client: resolve project stage assets (ca106c5)
- client: support project-defined start pages (069221c)
- adv-art: prepare hashed hamster assets (25cf0d4)
- hamster: adapt complete two-part story (bde055c)
- runtime: add duplicate-safe array action (6a2cec2)
- runtime: persist whitelisted meta progression (6128962)
- hamster: catalog complete source adaptation (bd855eb)
- skills: add ADV content workflows (a36108d)
- studio: compile scripts while editing (af943a0)
- devtools: surface compile diagnostics (73f1e1d)
- studio: embed runtime inspector (10a3305)
- devtools: add interactive runtime inspector (d537e83)
- runtime: record bounded command traces (4220a63)
- runtime: define command trace contract (dac3492)
- hamster: add original audiovisual assets (dd8c29b)
- hamster: add civilization and three endings (b361056)
- hamster: author cage and last-night chapters (920c284)
- compiler: support authored choice ids (0649310)
- hamster: define showcase game model (3a9778f)
- studio: support official runtime plugins (5c97eda)
- studio: load classic runtime projects (51f6f55)
- interactions: provide activity renderers (9309456)
- client: register activity renderers (6d80e11)
- plugin: load activity renderers (6959009)
- playground: inspect runtime programs (e0ad97e)
- cli: check runtime programs (4a6ed48)
- core: validate runtime capabilities (fda4a5d)
- demo: add hamster interaction story (243715a)
- runtime: add activity host adapters (0357764)
- plugin: add lightweight interactions (6fa30af)
- core: add declarative plugin runtime (5e1c855)
- core: compile flow runtime programs (445b900)
- core: add runtime storage contract (06793fc)
- core: add runtime snapshots and rollback (61275e8)
- core: link markdown choice targets (9df303d)
- parser: preserve runtime links and stable anchors (aebe4c0)
- core: expose unified runtime api (0151e5d)
- core: add deterministic runtime transition (daa0b4b)
- core: compile markdown runtime programs (89709ab)
- core: add runtime program linker (0a61e66)
- types: add runtime data contracts (0a97cd5)
- studio: add cloudbase marketplace backend (1f53e18)
- studio: unify 「紫幕金章」design system — purple theme, semantic colors, UI kit (28eace4)
- studio: marketplace taxonomy/publish, iOS packaging, privacy & telemetry (1209d97)
- parser,cli: validate scene frontmatter in adv check (format-freeze hardening) (d1d0052)
- cli: add galgame init template (adv init --template galgame) (d98f2c1)
- skills: add adv-review — AI content-quality review skill (657ef18)
- mcp,types,parser: branches/coverage MCP resources + character imagePrompt (00de404)
- core,cli,skills: project-wide
adv debug coverage+ fix dup-scene graph bug (c8cb4ed) - core,cli,skills: add
adv debug coveragebranch coverage report (b398b71) - cli,skills: expose rollback via
adv play back+ roadmap refresh (d9a0396) - core,cli,mcp-server,skills,studio: v0.3 Skills round (fe08c0c)
- studio: integrate @advjs/client AdvGame in Play Tab (cb91c8f)
- client: expose $logic.goToFountainOrder for external hosts (18bfc7c)
- client: playback polish — BGM fade, tachie crossfade, auto/skip mode (5b42eaa)
- parser,types,studio: add mystery character template (efa1caa)
- core,cli: track stage state and add play save/load snapshot (83974c9)
- studio: UI refactor, new components, and style improvements (d9482eb)
- studio: workspace refactor, chapter jumping & resume generation (4d5b870)
- studio: add collab sync, plugin registry, and AI provider system (ee48839)
- studio: add shortlink, templates, creator analytics and import improvements (a5dee61)
- studio: Phase M10 source-to-project wizard + life-story example (a3ed07d)
- studio: character frontmatter completion, attributes panel and parser schema (67f2130)
- studio: M10 source-to-project pipeline (6b7dc03)
- studio: add CloudBase auth, marketplace, and portfolio (3098ab9)
- studio: add ADV language support, preview panel, quality evaluator & batch scene import (1fbfeb1)
- studio: project share page, onboarding improvements & build optimizations (47a775a)
- studio: core experience P0/P1 — health panel, onboarding, share, cover & description (bef0947)
- studio: improve project health and docs (aa0720e)
- studio: improve chat experience and sharing tools (8ed4a9b)
- studio: add IFileSystem abstraction layer and migrate consumers (30a4758)
- studio: add character sharing, project health panel, multi-language support & E2E tests (90fbd52)
- studio: i18n aria-labels, unified error collection, test fixes (193515f)
- studio: Phase M14 emotional arc + CSV/Markdown export + mood filter (0394e51)
- studio: add batch import and expand mcp server (1db3bca)
- studio: group chat branch tree + project template library + e2e rewrite (7c9853f)
- studio: add LocationGraph, extract shared refs to parser, CLI location check (aa781fa)
- studio: Phase M11 — scene bg inheritance, TTS auto-read, snapshot branch tree (a823559)
- studio: add per-character TTS voice override (2e1d607)
- studio: Location module L1/L2 + cleanup temp docs (fd0600e)
- Add Locations feature to Studio with CRUD operations (11839d2)
- studio: add audio management, knowledge base, marketplace pages and project export (42230ec)
- studio: add character detail pages, diary, stats cards and recent activity (b7be6b2)
- studio: enhance editor, add project settings & extract UI components (120a36f)
- studio: add workspace content pages (chapters, characters, scenes) (5f4c138)
- studio: add file diff preview after save (d3fe504)
- studio: major refactor + fix P0 issues from code review (3401a05)
- studio: 实现 AI Living World 系统(Phase 6-12) (f855dab)
- studio: 实现 Studio 完整应用 - AI 对话、编辑器、云同步与项目管理 (510c90b)
- adv: 实现 Phase 3 Skills 与工作流 (ffde8d9)
- plugin-cos: 实现 COS 存储插件上传下载功能 (fb349e7)
- studio: 新增 Studio 移动应用 (2a31a3d)
- advjs: 新增 check/context/sync CLI 命令和项目模板 (5a10249)
- mcp-server: 新增 MCP Server 包 (14ce201)
- 添加角色系统、编辑器增强与文档更新 (e50c3de)
- plugin-pominis: support private story by token (9cbdbc6)
- plugin-pominis: support max concurrency (9a9f40c)
- plugin-pominis: build with library audio (8b02d40)
- examples: add build by scripts (27983c9)
- playground: download storyId to build (47342f0)
- playground: add xterm to display build process (2e879ef)
- support webcontainer build (3ba5754)
- add webcontainer for playground build (7bd5055)
Fixes
- npm: require repository metadata for trusted publishing (55584d6)
- npm: reuse identical immutable gzip archives across platforms (af15ad4)
- npm: preserve bootstrap metadata and use the rc tag (0d2dd23)
- vrm: load virtual module constants without CLI internals (86031da)
- editor: retain file notifications after atomic source saves (52d633b)
- editor: persist cleared character voice profiles (7202dd4)
- desktop: build raw templates without Nuxt preparation (f915fbf)
- cli: preserve the default advjs executable alongside audio server (3a84db0)
- create-adv: include scaffolder in verified releases (5a09a0c)
- player: keep dialogue and choices readable on scaled viewports (5600083)
- parser: restore playground and clarify dialogue output (f41de63)
- create-adv: 修复脚手架打包与完整模板 (#30) (9605124)
- ci: 修复预览构建与浏览器验证并移除重复执行 (5ac727b)
- test: preserve launch environment isolation and npm diagnostics (b69aff6)
- desktop: bound Windows Forge cleanup to staged application (13c201b)
- devtools: keep mobile launcher clear of player controls (14953a2)
- e2e: follow current editor navigation and bounded render readiness (5d777fb)
- e2e: isolate persistent workspaces and align accessible controls (39b2fdd)
- ci: order packed builds and exercise dismissible editor overlays (3cb0906)
- voice: isolate HMR authoring data and model caches (fca3ad2)
- compiler: preserve explicit markdown endings (d0124bd)
- desktop: use native macOS editor menus (0e21c94)
- editor: tie splash progress to startup tasks (1f9f1f2)
- editor: align splash colors with AGUI theme (546c342)
- editor: remember desktop language and inline splash logo (fd8e72f)
- studio: stabilize resource workflows and embedded previews (2117383)
- editor: stabilize experimental hex map interactions (1c298e1)
- editor: align PixiJS and unify authoring UI (ead5de1)
- deploy: record latest Worker deployment (6754cad)
- deploy: preserve trusted client IP (0142041)
- deploy: avoid future Worker date (cea82d1)
- studio: support cloudbase v3 sessions (ecc6436)
- studio: validate sso ticket adoption (6ee4def)
- studio: restore privacy policy scrolling (bf860fd)
- studio: restore clean deployment build (2dcf62d)
- parser: build playground prerequisites (98d4c60)
- ci: align hosted deployment toolchains (f36ab3d)
- ci: restore launch validation pipeline (57e6c2d)
- deps: align workspace lockfile importers (fd4c337)
- release: publish resolved dependency metadata (1af9389)
- ci: bypass Windows npx command shim (c397f07)
- ci: allow release manifest imports on Windows (0b0aecd)
- ci: stabilize clean cross-platform launch gates (35a1755)
- core: resolve inline character references (0264433)
- playground: stabilize project setup and downloads (48edeb0)
- studio: isolate embedded client entry (95a827b)
- audio: preserve concurrent bgm transitions (439690a)
- audio: prevent overlapping bgm transitions (b745a5f)
- hamster: remove reader glasses (2ca8f12)
- check: validate configured chapter sources (7156826)
- studio: restore project before editing (b685025)
- vrm: support vite 8 build (895d207)
- client: initialize sounds outside components (7c5cc24)
- build: dedupe vue router runtime (e79197c)
- plugin: load runtime plugins in browser (8c2799d)
- runtime: skip scene metadata during transitions (0763bd7)
- runtime: normalize pure data boundaries (a785978)
- client: keep narration sentence list typed (9594cd4)
- build: support function-based manual chunks (7e15009)
- core: exclude node storage from browser builds (367a0eb)
- core: declare dayjs runtime dependency (#43) (4443ab5)
- docs: resolve clean vitepress build (af1e001)
- docs: avoid vitepress dead links (e9639df)
- studio: make Vitest load vite config under the forks pool (6704e73)
- studio: make Play tab render + create work cross-platform; repair install (415f53c)
- eslint: ignore Capacitor native dirs to stop
eslint .crash (59a8931) - gui: adopt splitpanes 4.1.x resize payload type (3eb9ca9)
- client: wire choice.target through scene + chapter lookups (5d35317)
- client: skip fountain fetch when AdvFountainNode.ast is preset (a96c353)
- studio: remove invalid project share card tags (71eeac6)
- studio: resolve workspace reconnect and IndexedDB issues (200435c)
- studio: 修复 TypeScript 构建错误与类型断言 (20c9da9)
- editor: 修复 Pinia 初始化并优化编辑器依赖预构建 (0385817)
- plugin-pominis: start from startNodeId & bgm convert (e757db9)
- @vitejs/plugin-vue typecheck (8bb3fbf)
- use pominis cdn when playground set adv config cdn (6635124)
- playground: bg-gradient-to-r unocss fix (248cd5f)
- playground: ssr build for xterm (92f6378)
- add exports for unocss (ff26847)
- components search exclude & gradient text (58abb1c)
- import advjs client for playground build (498339c)
Performance
- studio: limit Pages builds to workspace dependencies (f57686f)
- assets: optimize application images (8b31842)
Refactors
- agui: standardize compact inspector controls (991d873)
- studio: migrate cloudbase auth to v3 (818845b)
- agent: extract private workspace package (#50) (c6dd107)
- unocss: migrate shared styles to Wind4 (ba9ef2d)
- release: separate promotion state and adapters (9b5f06d)
- advjs: consolidate file and hash helpers (95edee4)
- devtools: share runtime inspector model (7b60cb2)
- demo: separate starter and hamster showcases (38bfdac)
- client: render plugin activities generically (7ebccbb)
- studio: preview unified runtime state (650b4ed)
- client: use unified adventure runtime (1b597de)
- cli: use unified adventure runtime (e27f69d)
- studio: TtsProvider extends StudioPlugin (ef7829e)
- studio: finish fs consumer migration (8e83df7)
- studio: extract LayoutPage, decompose WorldPage into sub-components (a3612ec)
- core: 重构 @advjs/core 架构 & 新增引擎核心 + OpenClaw Skills 体系 (#41) (be0fb3f)
- 使用 Node.js 原生 fs 模块替代 fs-extra (7478240)
Documentation
- audio: document authoring protocols and verification results (e3135cf)
- 完善贡献者环境配置与调试指南 (#21) (07735c2)
- voice: validate configuration example and formatting (31c85cf)
- document editor authoring and web game integration (b43dfeb)
- organize specifications plans and verification records (8c6557e)
- desktop: record packaged acceptance and delivery (5aa82f8)
- deploy: document Cloudflare origin proxy (f6cc28f)
- assets: record agent workflow roadmap (93c9ac3)
- audio: clarify phased implementation status (1ad9ace)
- audio: define multi-track system architecture (b5289d5)
- launch: record real agent acceptance (7cd8e8b)
- launch: define product boundaries and author journey (9f28cb5)
- studio: document Pages production build (5b5c86e)
- hamster: define full adaptation pipeline (accb23b)
- devtools: explain runtime debugging workflow (681c67d)
- demo: present starter and hamster showcases (5ef7860)
- runtime: explain activity renderers (fcff666)
- demo: plan hamster showcase implementation (b15211d)
- demo: design hamster showcase project (fab8cf3)
- studio: make release commands portable (2742c33)
- runtime: document unified authoring (260e3be)
- demo: document content and asset licenses (f11186b)
- runtime: document unified runtime foundation (257a527)
- runtime: add unified runtime design (7e1890c)
- roadmap: mark v0.4 done items, surface blocked items honestly (a879e2c)
- cli: document v0.3 commands in the CLI guide (989e8f7)
- studio: update roadmap - M12 complete, add M13/M14 plans (fa4edf4)
- Add quick start guide for post-merge onboarding (08d320a)
- Add comprehensive implementation summary for Locations feature (24647c3)
- Fix dead links in skill documentation pointing to GitHub (b44031e)
- Link Studio strategic roadmap to VitePress navigation (0930bb3)
- Add Pinia store architecture diagram with data flow visualization (68c472e)
- Expand Phase 11 knowledge system documentation with examples and troubleshooting (9681ec4)
- studio: expand Phase 25-27 documentation with user guides and examples (e5c745a)
- 新增 AI 策略和格式文档,更新 MCP 与项目结构文档 (c6d311f)
Tests
- e2e: budget complete authoring and reading matrix journeys (5491758)
- e2e: exercise built packages and production Flow previews (3064a28)
- unit: organize tests by feature (30584aa)
- launch: cover non-CI Windows cleanup (d149917)
- launch: defer Windows CI cache cleanup (bfdf495)
- launch: avoid waiting on aborted registry handlers (61fb5aa)
- launch: close registry connections deterministically (c265b4e)
- launch: accommodate Windows npx cold installs (4d49c21)
- launch: isolate package runner caches (70183f7)
- launch: allow cold npx installs on Windows (9be1348)
- launch: isolate package runner smoke timeouts (3d80525)
- audio: cover restore during crossfade (007b985)
- runtime: cover built flow entry ordering (c704c28)
- cli: document subprocess timeout strategy (0fe7cf4)
- cli: stabilize subprocess contract tests (e4ea187)
- hamster: target inspector by accessible name (3fccc48)
- demo: cover minimal starter flow (1b0979c)
- demo: cover hamster browser flow (43c21d6)
- runtime: verify cross-host conformance (e22da3c)
- core: add runtime conformance baseline (8bcb572)
- e2e: remove useless test (752bb3e)
- e2e: fix prepare dev lib (3059756)
Build
- studio: allow disabling legacy bundle (bcdae47)
- fix editor build with adv virtual module plugin (2ebf799)
- add advjs npm publish scripts (a60034d)
CI
- npm: validate workflow contexts and exact release commits (f5b0328)
- npm: publish verified packages with OIDC (bddda6a)
- launch: stabilize Windows installs and preview builds (88e03c2)
- pages: verify VRM deployments on a supported Node runtime (a0c38d1)
- provision FFmpeg and native smoke build memory (aa02e13)
- desktop: validate package sources and streamline native builds (70e46a5)
- pages: scope builds to affected applications (e301c1d)
- ui: enforce game theme contracts and document migration gaps (3b14b30)
- playwright: install Chromium headless shell (244ca48)
- studio: retry production build (2a9d089)
- studio: apply EdgeOne environment (71a0c23)
- studio: retry EdgeOne deployment (aa25937)
- restore cross-platform release gates (981f0d2)
- release: enforce launch readiness and promotion gates (27c1085)
- core: publish packed artifact by local path (#48) (8a62e9b)
- core: build dependencies before release tests (#47) (5b17f46)
- core: expose release test failures (8cb5f9b)
- merge test-e2e to ci.yml (1f46546)
- amplify: add customHeaders for webcontainter (8862bcc)
- use pnpm ... (154c280)
- update amplify.yml (#39) (0fa36ca)
- amplify allow max-old-space-size (0cc4333)
- use dev stub (ad724b9)
- fix play:build (2b2ce8a)
- fix amplify playground build (830fce7)
- dynamic import @advjs/parser (58aade4)
- fix advjs import @advjs/core constants (40effce)
- fix e2e md parse (fcf37ab)
Maintenance
- desktop: expose noninteractive Forge packaging stages (9acaa1f)
- lint: ignore generated desktop artifacts (eb795e5)
- workspace: align catalogs and verification configuration (c4f4995)
- deps: upgrade workspace dependency baseline (53b68b7)
- deps: synchronize workspace lockfile (0e1587b)
- lint: normalize showcase files (d3883f3)
- router: refresh generated route maps (73454fb)
- core: prepare 0.1.2 release (461d631)
- git: ignore local claude config (954177f)
- add AGENTS.md guide and codex MCP config (4551362)
- deps: regenerate lockfile for splitpanes 4.1.2 (3c40103)
- gitignore .claude/worktrees (e3821bb)
- workspace: 更新工作区配置并添加新包依赖 (4b045e0)
- 优化代码并更新依赖 (9b0525d)
- remove postinstall script (e604703)
- update icons dep (0451026)
- update icons dep (648f098)
- update lock (b21befc)
- release can build adv version (d3d198f)
- remove useless cmd (1b79bcd)
- upgrade deps (1383d69)