pixifact-cli 0.7.0 → 0.9.0

package/README.md

@@ -29,7 +29,13 @@ pixifact scene validate --all
 
 默认使用当前工作目录作为项目根目录；不在项目根目录运行时再加 `--project-root <path>`。
 
-其他命令是辅助入口：`scene create` 用于新建 Scene；`node inspect` 用于查看 `scene inspect` 返回的已知 locator；`editor context` 用于读取当前 Scene 和 selection；`editor screenshot --output <png-path>` 用于截取当前 Authoring Scene。不要使用 `scene get`，file mode 只保留 `scene inspect`。旧 `live ...` 命令已经删除。
+新建空 Scene 文件对使用：
+
+```bash
+pixifact scene create src/scenes/Hud.scene
+```
+
+路径必须是项目相对的 `.scene` 路径。命令会按路径 basename 推导 `Hud`，并创建 `Hud.scene` 和 `Hud.ts`。其他辅助入口包括：`node inspect` 用于查看 `scene inspect` 返回的已知 locator；`editor context` 用于读取当前 Scene 和 selection；`editor screenshot --output <png-path>` 用于截取当前 Authoring Scene。不要使用 `scene get`，file mode 只保留 `scene inspect`。旧 `live ...` 命令已经删除。
 
 ## Agent Runtime
 
@@ -38,6 +44,7 @@ pixifact scene validate --all
 ```bash
 pixifact runtime list
 pixifact runtime tree --output .pixifact/runtime/tree.json
+pixifact runtime screenshot
 pixifact runtime node <pixi-uid>
 pixifact runtime state
 pixifact runtime logs --after <seq>
@@ -49,6 +56,8 @@ pixifact runtime input key Space
 
 `runtime tree` 默认将节点树输出到终端；传入 `--output <json-path>` 时，改为保存运行时快照 JSON，终端只返回路径和采集元数据。快照包含 `schemaVersion`、`capturedAt`、当前 `runtimeId` 和 `root` 节点树，适合 Agent 使用文本搜索或 JSON 工具分析。快照中的 `runtimeId` 和 PixiJS `uid` 只对本次运行有效，不应写回项目源文件。
 
+`runtime screenshot` 默认将当前 PixiJS Canvas 的 PNG 截图写入项目根下的 `.pixifact/runtime/frame.png`，也可用 `--output <png-path>` 指定路径。截图使用当前 `app.screen` 逻辑尺寸和 renderer 背景色，只包含 `app.stage` 的 PixiJS 渲染内容，不包含浏览器 UI、HTML/CSS 或 DOM overlay；多个页面时添加 `--runtime <runtime-id>`。
+
 ## 浏览器 Editor
 
 在目标项目根目录运行：

package/editor/assets/browserAll-CG--e3R8.js

@@ -0,0 +1 @@
+import{a as e,c as t,i as n,l as r,o as i,s as a,u as o}from"./index-BUZ_WtnT.js";import"./init-CzHI7RKj.js";o.add(t),o.mixin(r,a),o.add(i),o.add(e),o.mixin(r,n);