asecli 0.7.0__tar.gz → 0.8.1__tar.gz

{asecli-0.7.0 → asecli-0.8.1}/.github/workflows/ci.yml

@@ -90,6 +90,17 @@ jobs:
           test -f "$test_project/Assets/Editor/ASECLI/ASECLIMaterialGUI.cs"
       - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0 (Node 24)
         with:
-          name: asecli-${{ env.ASECLI_VERSION }}-python-${{ runner.arch }}
+          name: asecli-candidate-${{ github.sha }}
           path: dist/
           if-no-files-found: error
+
+  cross-cli:
+    needs: package
+    uses: ./.github/workflows/cross-cli.yml
+    with:
+      sgcli_ref: ${{ vars.SGCLI_CANDIDATE_SHA }}
+      asecli_artifact_name: asecli-candidate-${{ github.sha }}
+    secrets:
+      sgcli_read_ssh_key: ${{ secrets.SGCLI_READ_SSH_KEY }}
+    permissions:
+      contents: read

asecli-0.8.1/.github/workflows/cross-cli.yml

@@ -0,0 +1,123 @@
+name: Cross CLI Contract Gate
+
+on:
+  workflow_call:
+    inputs:
+      sgcli_ref:
+        description: Exact trusted SGCLI commit
+        required: false
+        default: ""
+        type: string
+      asecli_artifact_name:
+        description: Build-once ASECLI candidate artifact from the caller
+        required: false
+        default: ""
+        type: string
+    secrets:
+      sgcli_read_ssh_key:
+        description: Read-only deploy key for the private SGCLI repository
+        required: false
+  workflow_dispatch:
+    inputs:
+      sgcli_ref:
+        description: Exact trusted SGCLI commit
+        required: true
+        type: string
+      asecli_artifact_name:
+        description: Existing ASECLI candidate artifact in this run; blank builds for diagnostics
+        required: false
+        default: ""
+        type: string
+
+permissions:
+  contents: read
+
+jobs:
+  public-contract:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: "0.11.14"
+          python-version: "3.12"
+      - run: uv sync --frozen --python 3.12
+      - name: Validate public/fork-safe consumer contracts
+        run: uv run --frozen python -m pytest -q tests/test_contract_schema.py
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        if: ${{ inputs.asecli_artifact_name != '' }}
+        with:
+          name: ${{ inputs.asecli_artifact_name }}
+          path: ${{ runner.temp }}/asecli-candidate
+      - name: Smoke test the build-once candidate wheel
+        if: ${{ inputs.asecli_artifact_name != '' }}
+        run: |
+          uv venv "$RUNNER_TEMP/asecli-public-smoke" --python 3.12
+          uv pip install --python "$RUNNER_TEMP/asecli-public-smoke/bin/python" "$RUNNER_TEMP"/asecli-candidate/*.whl
+          "$RUNNER_TEMP/asecli-public-smoke/bin/asecli" contract editor-graph --version 3
+      - name: Record candidate gate boundary
+        if: ${{ github.event_name == 'pull_request' }}
+        run: >-
+          echo 'Private SGCLI candidate checkout is intentionally not available to pull requests;
+          the private SGCLI repository owns the full two-candidate WaveNoise gate.'
+
+  two-wheel-direct-json:
+    if: ${{ github.event_name != 'pull_request' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate trusted cross-repository inputs
+        env:
+          SGCLI_REF: ${{ inputs.sgcli_ref }}
+          SGCLI_READ_SSH_KEY: ${{ secrets.sgcli_read_ssh_key }}
+        run: |
+          test -n "$SGCLI_REF" || { echo "CROSS_REPO_REF_MISSING: configure SGCLI_CANDIDATE_SHA"; exit 2; }
+          [[ "$SGCLI_REF" =~ ^[0-9a-fA-F]{40}$ ]] || { echo "CROSS_REPO_REF_INVALID: SGCLI_CANDIDATE_SHA must be an exact 40-character commit SHA"; exit 2; }
+          test -n "$SGCLI_READ_SSH_KEY" || { echo "CROSS_REPO_AUTH_MISSING: configure read-only SGCLI_READ_SSH_KEY deploy key"; exit 2; }
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+        with:
+          path: ASECLI
+          persist-credentials: false
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1
+        with:
+          repository: seeseeczl/SGCLI
+          ref: ${{ inputs.sgcli_ref }}
+          ssh-key: ${{ secrets.sgcli_read_ssh_key }}
+          path: SGCLI
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          version: "0.11.14"
+          python-version: "3.12"
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        if: ${{ inputs.asecli_artifact_name != '' }}
+        with:
+          name: ${{ inputs.asecli_artifact_name }}
+          path: ${{ runner.temp }}/asecli-candidate
+      - name: Build ASECLI candidate for manual dispatch
+        if: ${{ inputs.asecli_artifact_name == '' }}
+        run: (cd ASECLI && uv build --wheel --out-dir "$RUNNER_TEMP/asecli-candidate")
+      - name: Build exact SGCLI candidate
+        run: (cd SGCLI && uv build --wheel --out-dir "$RUNNER_TEMP/sgcli-wheel")
+      - name: Run no-transform two-wheel WaveNoise matrix
+        run: >-
+          python SGCLI/scripts/check_cross_cli_contracts.py
+          --sgcli-root SGCLI
+          --asecli-root ASECLI
+          --sgcli-wheel "$RUNNER_TEMP"/sgcli-wheel/*.whl
+          --asecli-wheel "$RUNNER_TEMP"/asecli-candidate/*.whl
+          --output "$RUNNER_TEMP/cross-cli-artifacts/manifest.json"
+          --artifact-dir "$RUNNER_TEMP/cross-cli-artifacts"
+          --sgcli-ref "${{ inputs.sgcli_ref }}"
+          --asecli-ref "${{ github.sha }}"
+          --workflow-revision "${{ github.workflow_ref }}@${{ github.sha }}"
+      - name: Verify downloaded-artifact shape and hashes
+        run: >-
+          python SGCLI/scripts/verify_cross_cli_artifacts.py
+          "$RUNNER_TEMP/cross-cli-artifacts/manifest.json"
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        with:
+          name: cross-cli-contracts-${{ github.sha }}
+          path: ${{ runner.temp }}/cross-cli-artifacts/
+          if-no-files-found: error

{asecli-0.7.0 → asecli-0.8.1}/.github/workflows/publish.yml

@@ -85,12 +85,23 @@ jobs:
           test -f "$test_project/Assets/Editor/ASECLI/ASECLIMaterialGUI.cs"
       - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0 (Node 24)
         with:
-          name: dist-${{ github.sha }}
+          name: asecli-candidate-${{ github.sha }}
           path: dist/
           if-no-files-found: error
 
-  publish:
+  cross-cli:
     needs: package
+    uses: ./.github/workflows/cross-cli.yml
+    with:
+      sgcli_ref: ${{ vars.SGCLI_CANDIDATE_SHA }}
+      asecli_artifact_name: asecli-candidate-${{ github.sha }}
+    secrets:
+      sgcli_read_ssh_key: ${{ secrets.SGCLI_READ_SSH_KEY }}
+    permissions:
+      contents: read
+
+  publish:
+    needs: [package, cross-cli]
     if: ${{ vars.ASECLI_PYPI_ENABLED == 'true' }}
     runs-on: ubuntu-latest
     environment:
@@ -105,7 +116,7 @@ jobs:
           enable-cache: false
       - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 (Node 24)
         with:
-          name: dist-${{ github.sha }}
+          name: asecli-candidate-${{ github.sha }}
           path: dist/
       - run: cd dist && shasum -a 256 -c SHA256SUMS
       - run: uv publish dist/*.whl dist/*.tar.gz

{asecli-0.7.0 → asecli-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: asecli
-Version: 0.7.0
+Version: 0.8.1
 Summary: Agent-native CLI for reading, modifying, validating and compiling Amplify Shader Editor assets
 Project-URL: Homepage, https://github.com/seeseeczl/ASECLI
 Project-URL: Repository, https://github.com/seeseeczl/ASECLI
@@ -28,9 +28,9 @@ Description-Content-Type: text/markdown
 
 AseCLI 是面向 AI Agent 的本地 CLI：离线读取、编辑和校验 ASE 节点图；通过运行中的 Unity/团结引擎与 MCP，让真实 ASE 创建节点、提供精排几何并重新生成 HLSL。Skill 提供跨 Agent 的操作规则，CLI 提供可验证的执行结果。
 
-当前正式版：**[0.7.0](https://github.com/seeseeczl/ASECLI/releases/tag/v0.7.0)** · [PyPI](https://pypi.org/project/asecli/0.7.0/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
+当前正式版：**[0.8.1](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.1)** · [PyPI](https://pypi.org/project/asecli/0.8.1/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
 
-ASECLI 接收 `EditorGraphSpec`，不直接承担任意 Shader Graph 的转换。SGCLI 导出的源图 JSON、转换后的创建规格和已经整理的 `.shader` 是不同资产；创建成功不代表转换效果等价。
+ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；独立 report 与发布 receipt 都不进入创建输入，创建成功也不代表转换效果等价。
 
 ```
 你：提需求（"给这个 shader 加个可调描边"）
@@ -47,6 +47,7 @@ Agent：设计节点图 → asecli 写文件 → 校验 → 触发编译 → 你
 | 转换后核对 | `graph-review` 保守比较计算基线，按输出端口生成 Local Var 复用计划 | 只读计划不需要；不会自动创建 Register/Get |
 | 材质 Inspector | 原生 MZGUI 优先；缺失时才注入 ASECLI ShaderGUI fallback。两者兼容 `FoldoutMzgui`、`TooltipMzgui`、`HelpBoxMzgui` 和条件置灰 `EnableIfMzgui`；默认只生成 Tooltip，HelpBox 由用户按需添加 | 写元数据否；安装、重编译和最终 Inspector 验收需要 |
 | Shader 创建 | 从已满足属性呈现契约的编译壳克隆；或由严格 `EditorGraphSpec v2/v3` 让 ASE 自己创建节点、连线、保存和重载核对 | Editor 后端需要 |
+| ASE→SG 导出 | `export-sg` 直接生成裸 `sgcli.native.v3` 和同方向独立报告；名称槽位由 SGCLI 消费端解析 | 导出本身不需要；实际 SG 创建需要 |
 | 编译桥接 | 通过 MCP for Unity 请求 ASE 重新生成 HLSL，并验证工具结果/保存语义 | 是 |
 | Agent 集成 | 全部子命令单行 JSON 输出；稳定错误码与退出码，适合 Agent 子进程编排 | 否 |
 | 工程交付 | 双 Python CI、锁文件、回归目录、可复现 wheel/sdist、SBOM、供应链与许可证检查 | 否 |
@@ -131,7 +132,7 @@ curl -fsSL https://raw.githubusercontent.com/seeseeczl/ASECLI/main/scripts/insta
 uv tool uninstall asecli
 ```
 
-当前正式版本为 `0.7.0`（严格、原子、可版本化的 CLI JSON 输出契约），可从 [PyPI](https://pypi.org/project/asecli/0.7.0/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.7.0) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.6.4` 保留为回滚点。
+当前正式版本为 `0.8.1`（透明 Multiply 的 matcher-v4 语义修复与转换认证加固），可从 [PyPI](https://pypi.org/project/asecli/0.8.1/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.1) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.0` 保留为回滚点。
 
 已知限制：真实 MCP 下，属性+纹理 v2 和 Reciprocal 降级 v2 的 create、manifest、validate、独立 recompile 已通过；SGCLI SphereMask v3 spec 在重载时仍可能返回 `node missing after reload: Radius` 并回滚。本次不承诺该 recipe 端到端可用，也不改变 SGCLI v2 默认值契约。
 
@@ -161,7 +162,7 @@ asecli --help
 
 ```bash
 shasum -a 256 -c SHA256SUMS
-uv tool install /path/to/asecli-0.7.0-py3-none-any.whl
+uv tool install /path/to/asecli-0.8.1-py3-none-any.whl
 asecli --help
 ```
 
@@ -186,7 +187,9 @@ asecli graph-audit Assets/Example.shader
 前提：SGCLI 已生成合法的 EditorGraphSpec；目标工程已打开，MCP 地址与当前实例一致。下面的目标必须尚不存在。
 
 ```bash
-asecli create Assets/ConvertedNew.shader --backend editor --spec graph.json \
+sgcli convert Assets/Source.shadergraph --out-dir ./out
+asecli create Assets/ConvertedNew.shader \
+  --spec ./out/Source.sgcli-to-asecli.spec.json \
   --mcp-url http://127.0.0.1:9080/mcp
 asecli validate Assets/ConvertedNew.shader
 asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
@@ -194,6 +197,24 @@ asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
 
 核对创建结果的节点、端口、连接及属性 manifest。`staging_reloaded=true` 只表示暂存图重载成功；目标图仍需独立 `recompile`。超时后先检查目标与同目录 `ASECLI-Temp-*`，禁止盲目重试。
 
+### 将 ASE Shader 直接导出给 SGCLI
+
+```bash
+asecli export-sg Assets/ConvertedNew.shader --out-dir ./out
+sgcli sg create Assets/ConvertedNew.shadergraph \
+  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json
+```
+
+`export-sg` 自动从源 Shader 向上识别 Unity/Tuanjie 工程；跨工程资源解析时显式传 `--target-project`。它强制生成 `<stem>.asecli-to-sgcli.spec.json`、`.report.json` 与 `.receipt.json`，同名即失败；receipt 只证明 spec/report 两份文件的提交状态与 SHA，不是中间交接包。命令不调用 SGCLI，也不生成 ASE 自有中间 JSON。未知节点、Master/Pass、外部属性或纹理 Importer 语义时只写规范报告，不写半成品 spec。反方向 `.asecli-to-sgcli.spec.json` 不能交给 ASECLI `create --spec`。
+
+ASECLI 随 wheel 发布自己拥有的 EditorGraphSpec v3 Schema，并固定一份 SGCLI `0.3.3` 的 `sgcli.native.v3` 生产快照；SGCLI 同样固定 ASECLI `0.8.1` 快照。双仓兼容检查会比较两组原始 Schema SHA-256，任何漂移都必须先升级生产者再放行。
+
+可用 `asecli contract editor-graph --version 3 --spec FILE` 在不连接 Editor 时执行权威 Schema/loader 并返回原文件 SHA。报告分开记录来源快照、发布前复核、生产者 Schema 与真实消费者读取状态。旧 `{graph,report}` wrapper 只允许按已登记形状显式迁移，且内层必须已经是 `sgcli.native.v3`；无版本 discriminator 的旧输入只报告 `legacy_format`，不得伪称已识别版本化 Schema：
+
+```bash
+asecli migrate-package Old-graph-for-sgcli.json --out-dir ./out --extract-sg-spec
+```
+
 ### 整理转换后的复杂图
 
 先将当前已确认正确的 Shader 另存为**唯一基线备份**；相邻 `.bak` 会被后续写入更新，不能充当整个任务的永久基线。
@@ -247,6 +268,9 @@ asecli recompile Assets/Example.shader
 | `validate <file>` | 检查悬空连线、重复 ID、输入多来源、Local Var 一致性和 CHKSM。 | 只读；有 error 时返回退出码 2。 |
 | `graph-review <file> [--baseline FILE] [--reuse-policy consumer-groups\\|fanout]` | 保守核对计算基线并列出复用计划。 | 只读；基线不一致返回 `SEMANTIC_MISMATCH` / 2，不自动创建 Local Var。 |
 | `graph-audit <file>` | 从 Master 反向分析未参与输出的节点，区分 `unused_candidates` 与外部消费者。 | 只读；Property 的源码/HLSL/GUI 引用不会被误报为可删。 |
+| `export-sg <file> --out-dir DIR [--target-project PROJECT]` | 直接输出裸 `sgcli.native.v3`、独立转换报告和发布回执。 | spec 是唯一交接输入；receipt 只证明 spec/report 提交状态；不调用 SGCLI；同名失败；转换失败只写 report。 |
+| `contract editor-graph --version 3 [--spec FILE]` | 输出 wheel 内权威 EditorGraphSpec v3 JSON Schema；可离线校验并回执输入 SHA。 | 只读；loader 仍执行端口、中文属性和模板等更强语义校验。 |
+| `migrate-package <file> --out-dir DIR --extract-sg-spec` | 显式提取登记的旧 `{graph,report}` wrapper。 | 只接受内层 `sgcli.native.v3`；未知/v2 wrapper 只留失败报告，不进入正常消费者。 |
 | `set-field <file> --node N --field I --value V [--write]` | 修改一个已知节点的绝对序列化字段。 | 默认预演；`--write` 后写入。不要用它猜写 Master 或未知版本尾部。 |
 | `add-node <file> --type T [--id N] [--pos X,Y] [--write]` | 按 schema 创建可写节点与默认参数。 | 默认预演；未知、opaque 或版本不兼容节点会拒绝。`--line` 是复用真实序列化行的专家入口；若新行含 schema 占位符的 32 位 hex 标识，会返回 `warnings` 提示在 Unity 中核对唯一性。 |
 | `connect <file> --from A:P --to B:P [--write]` | 将来源节点输出端接到目标节点输入端。 | 默认预演；`--from` 是数据源，`--to` 是消费者。 |
@@ -259,7 +283,7 @@ asecli recompile Assets/Example.shader
 | `install-skill [--agent A] [--scope user\|project] [--project-root DIR] [--skill-root DIR]` | 将 wheel 内置的通用 ASECLI Agent Skill 安装到开放 `.agents` 目录或 Codex、Claude Code、Cursor、Gemini CLI、GitHub Copilot 原生目录。 | 无参数保持旧 Codex 目录；省略 `--agent` 但给 `--scope`/`--project-root` 时默认 `agents`；`all` 以两个非重复目标覆盖五类 Agent；相同内容幂等，任一冲突先整体拒绝，不修改 Shader、材质或 Unity/Tuanjie 工程。 |
 | `comment-group <file> [--nodes IDS --title T] [--note NOTE --padding P --id N] … [--write]` | 查询、创建、嵌套 ASE 原生 Comment 框；可检查成员越框或重叠。 | 创建默认用离线尺寸估算。`--editor-bounds`、`--check-bounds`、`--fit` 需连接 Editor；`--note` 写 Comment 头小字（默认 "Comment"），`--padding` 默认 50，`--id` 指定 Comment 节点 ID。 |
 | `create <out> --from TEMPLATE [--name NAME] [--graph-from DONOR]` | 复制一个已编译模板壳；可替换图或同步 Shader 名与 CHKSM。 | **立即创建/覆盖目标**；模板和 donor 组合后的文件必须已满足属性呈现契约，否则写前拒绝。 |
-| `create <out> --backend editor --spec graph.json` | 用白名单 `EditorGraphSpec v2/v3` 让 ASE 自身创建、保存和重载目标图。 | **立即请求 Editor 写入**；每个 Property 必填中文 `inspector_name` 和中文 `tooltip`，可选 `help` 写用户 HelpBox。v3 另支持版本化 primitive/recipe 与属性精度、默认值和范围。 |
+| `create <out> --spec graph.json` | 用白名单 `EditorGraphSpec v2/v3` 让 ASE 自身创建、保存和重载目标图。 | 提供 `--spec` 时默认选择 Editor 后端并立即请求写入；每个 Property 必填中文 `inspector_name` 和中文 `tooltip`，可选 `help` 写用户 HelpBox。v3 另支持版本化 primitive/recipe 与属性精度、默认值和范围。 |
 | `recompile <file> [--mcp-url URL] [--allow-remote-mcp]` | 调用运行中 ASE 重新生成 HLSL/保存，报告 `changed`；并自动快照→恢复材质 GUI 元数据、重算 CHKSM、强制 `AssetDatabase.ImportAsset` 二次导入。 | **立即触发 Editor 操作**；默认仅允许 loopback MCP。返回 `changed`，元数据被恢复时另返回 `metadata_restored` 与 `asset_import`。 |
 
 ### 详细操作入口
@@ -274,7 +298,7 @@ asecli recompile Assets/Example.shader
 
 ### Editor API 创建
 
-默认 `create` 仍是原有纯文本后端。`--backend editor --spec graph.json` 明确使用 Editor；`--backend auto` 在提供 `--spec` 时选择 Editor，否则选择文本后端。Editor 目标必须位于 Unity/Tuanjie 工程的 `Assets/` 下且尚不存在，不允许 `--force`。
+`create` 默认自动路由：提供 `--spec` 时选择 Editor；没有 `--spec` 时走原有纯文本后端。仍可用 `--backend editor|text|auto` 显式指定。Editor 目标必须位于 Unity/Tuanjie 工程的 `Assets/` 下且尚不存在，不允许 `--force`。
 
 最小 Caster-like 规格：
 
@@ -316,12 +340,12 @@ asecli recompile Assets/Example.shader
 除显式 `--help` 保留人类可读文本外，stdout 恒为单行严格 JSON，agent 可直接解析。`--version` 也返回 JSON：
 
 ```json
-{"contract_version":1,"cli_version":"0.7.0","command":"parse","ok":true,"data":{"node_count":7}}
-{"contract_version":1,"cli_version":"0.7.0","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
-{"contract_version":1,"cli_version":"0.7.0","command":"version","ok":true,"data":{"version":"0.7.0"}}
+{"contract_version":1,"cli_version":"0.8.1","command":"parse","ok":true,"data":{"node_count":7}}
+{"contract_version":1,"cli_version":"0.8.1","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
+{"contract_version":1,"cli_version":"0.8.1","command":"version","ok":true,"data":{"version":"0.8.1"}}
 ```
 
-常见错误码：`PARSE_ERROR`、`NOT_FOUND`、`USAGE_ERROR`、`SCHEMA_UNAVAILABLE`、`SCHEMA_VERSION_MISMATCH`、`VALIDATION_ERROR`、`PROPERTY_PRESENTATION_ERROR`、`LAYOUT_ERROR`、`CHECKSUM_FORMAT_ERROR`、`GUI_SUPPORT_ERROR`、`CUSTOM_GUI_ERROR`、`COMMENT_GROUP_ERROR`、`GRAPH_REVIEW_ERROR`、`SEMANTIC_MISMATCH`、`EXTERNAL_REFERENCE`、`SKILL_INSTALL_CONFLICT`、`SKILL_INSTALL_ERROR`、`WRITE_CONFLICT`、`UNSAFE_PATH`、`WRITE_ERROR`、`BRIDGE_ERROR`、`INTERNAL`。
+常见错误码：`PARSE_ERROR`、`NOT_FOUND`、`USAGE_ERROR`、`SCHEMA_UNAVAILABLE`、`SCHEMA_VERSION_MISMATCH`、`VALIDATION_ERROR`、`PROPERTY_PRESENTATION_ERROR`、`LAYOUT_ERROR`、`CHECKSUM_FORMAT_ERROR`、`GUI_SUPPORT_ERROR`、`CUSTOM_GUI_ERROR`、`COMMENT_GROUP_ERROR`、`GRAPH_REVIEW_ERROR`、`SEMANTIC_MISMATCH`、`SG_EXPORT_BLOCKED`、`EXTERNAL_REFERENCE`、`SKILL_INSTALL_CONFLICT`、`SKILL_INSTALL_ERROR`、`WRITE_CONFLICT`、`WRITE_PARTIAL`、`UNSAFE_PATH`、`WRITE_ERROR`、`BRIDGE_ERROR`、`INTERNAL`。
 退出码：`0` 成功 · `2` 用法/校验/解析错误 · `3` 桥接错误
 
 ## 安全与验收边界

{asecli-0.7.0 → asecli-0.8.1}/README.md

@@ -4,9 +4,9 @@
 
 AseCLI 是面向 AI Agent 的本地 CLI：离线读取、编辑和校验 ASE 节点图；通过运行中的 Unity/团结引擎与 MCP，让真实 ASE 创建节点、提供精排几何并重新生成 HLSL。Skill 提供跨 Agent 的操作规则，CLI 提供可验证的执行结果。
 
-当前正式版：**[0.7.0](https://github.com/seeseeczl/ASECLI/releases/tag/v0.7.0)** · [PyPI](https://pypi.org/project/asecli/0.7.0/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
+当前正式版：**[0.8.1](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.1)** · [PyPI](https://pypi.org/project/asecli/0.8.1/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
 
-ASECLI 接收 `EditorGraphSpec`，不直接承担任意 Shader Graph 的转换。SGCLI 导出的源图 JSON、转换后的创建规格和已经整理的 `.shader` 是不同资产；创建成功不代表转换效果等价。
+ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；独立 report 与发布 receipt 都不进入创建输入，创建成功也不代表转换效果等价。
 
 ```
 你：提需求（"给这个 shader 加个可调描边"）
@@ -23,6 +23,7 @@ Agent：设计节点图 → asecli 写文件 → 校验 → 触发编译 → 你
 | 转换后核对 | `graph-review` 保守比较计算基线，按输出端口生成 Local Var 复用计划 | 只读计划不需要；不会自动创建 Register/Get |
 | 材质 Inspector | 原生 MZGUI 优先；缺失时才注入 ASECLI ShaderGUI fallback。两者兼容 `FoldoutMzgui`、`TooltipMzgui`、`HelpBoxMzgui` 和条件置灰 `EnableIfMzgui`；默认只生成 Tooltip，HelpBox 由用户按需添加 | 写元数据否；安装、重编译和最终 Inspector 验收需要 |
 | Shader 创建 | 从已满足属性呈现契约的编译壳克隆；或由严格 `EditorGraphSpec v2/v3` 让 ASE 自己创建节点、连线、保存和重载核对 | Editor 后端需要 |
+| ASE→SG 导出 | `export-sg` 直接生成裸 `sgcli.native.v3` 和同方向独立报告；名称槽位由 SGCLI 消费端解析 | 导出本身不需要；实际 SG 创建需要 |
 | 编译桥接 | 通过 MCP for Unity 请求 ASE 重新生成 HLSL，并验证工具结果/保存语义 | 是 |
 | Agent 集成 | 全部子命令单行 JSON 输出；稳定错误码与退出码，适合 Agent 子进程编排 | 否 |
 | 工程交付 | 双 Python CI、锁文件、回归目录、可复现 wheel/sdist、SBOM、供应链与许可证检查 | 否 |
@@ -107,7 +108,7 @@ curl -fsSL https://raw.githubusercontent.com/seeseeczl/ASECLI/main/scripts/insta
 uv tool uninstall asecli
 ```
 
-当前正式版本为 `0.7.0`（严格、原子、可版本化的 CLI JSON 输出契约），可从 [PyPI](https://pypi.org/project/asecli/0.7.0/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.7.0) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.6.4` 保留为回滚点。
+当前正式版本为 `0.8.1`（透明 Multiply 的 matcher-v4 语义修复与转换认证加固），可从 [PyPI](https://pypi.org/project/asecli/0.8.1/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.1) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.0` 保留为回滚点。
 
 已知限制：真实 MCP 下，属性+纹理 v2 和 Reciprocal 降级 v2 的 create、manifest、validate、独立 recompile 已通过；SGCLI SphereMask v3 spec 在重载时仍可能返回 `node missing after reload: Radius` 并回滚。本次不承诺该 recipe 端到端可用，也不改变 SGCLI v2 默认值契约。
 
@@ -137,7 +138,7 @@ asecli --help
 
 ```bash
 shasum -a 256 -c SHA256SUMS
-uv tool install /path/to/asecli-0.7.0-py3-none-any.whl
+uv tool install /path/to/asecli-0.8.1-py3-none-any.whl
 asecli --help
 ```
 
@@ -162,7 +163,9 @@ asecli graph-audit Assets/Example.shader
 前提：SGCLI 已生成合法的 EditorGraphSpec；目标工程已打开，MCP 地址与当前实例一致。下面的目标必须尚不存在。
 
 ```bash
-asecli create Assets/ConvertedNew.shader --backend editor --spec graph.json \
+sgcli convert Assets/Source.shadergraph --out-dir ./out
+asecli create Assets/ConvertedNew.shader \
+  --spec ./out/Source.sgcli-to-asecli.spec.json \
   --mcp-url http://127.0.0.1:9080/mcp
 asecli validate Assets/ConvertedNew.shader
 asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
@@ -170,6 +173,24 @@ asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
 
 核对创建结果的节点、端口、连接及属性 manifest。`staging_reloaded=true` 只表示暂存图重载成功；目标图仍需独立 `recompile`。超时后先检查目标与同目录 `ASECLI-Temp-*`，禁止盲目重试。
 
+### 将 ASE Shader 直接导出给 SGCLI
+
+```bash
+asecli export-sg Assets/ConvertedNew.shader --out-dir ./out
+sgcli sg create Assets/ConvertedNew.shadergraph \
+  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json
+```
+
+`export-sg` 自动从源 Shader 向上识别 Unity/Tuanjie 工程；跨工程资源解析时显式传 `--target-project`。它强制生成 `<stem>.asecli-to-sgcli.spec.json`、`.report.json` 与 `.receipt.json`，同名即失败；receipt 只证明 spec/report 两份文件的提交状态与 SHA，不是中间交接包。命令不调用 SGCLI，也不生成 ASE 自有中间 JSON。未知节点、Master/Pass、外部属性或纹理 Importer 语义时只写规范报告，不写半成品 spec。反方向 `.asecli-to-sgcli.spec.json` 不能交给 ASECLI `create --spec`。
+
+ASECLI 随 wheel 发布自己拥有的 EditorGraphSpec v3 Schema，并固定一份 SGCLI `0.3.3` 的 `sgcli.native.v3` 生产快照；SGCLI 同样固定 ASECLI `0.8.1` 快照。双仓兼容检查会比较两组原始 Schema SHA-256，任何漂移都必须先升级生产者再放行。
+
+可用 `asecli contract editor-graph --version 3 --spec FILE` 在不连接 Editor 时执行权威 Schema/loader 并返回原文件 SHA。报告分开记录来源快照、发布前复核、生产者 Schema 与真实消费者读取状态。旧 `{graph,report}` wrapper 只允许按已登记形状显式迁移，且内层必须已经是 `sgcli.native.v3`；无版本 discriminator 的旧输入只报告 `legacy_format`，不得伪称已识别版本化 Schema：
+
+```bash
+asecli migrate-package Old-graph-for-sgcli.json --out-dir ./out --extract-sg-spec
+```
+
 ### 整理转换后的复杂图
 
 先将当前已确认正确的 Shader 另存为**唯一基线备份**；相邻 `.bak` 会被后续写入更新，不能充当整个任务的永久基线。
@@ -223,6 +244,9 @@ asecli recompile Assets/Example.shader
 | `validate <file>` | 检查悬空连线、重复 ID、输入多来源、Local Var 一致性和 CHKSM。 | 只读；有 error 时返回退出码 2。 |
 | `graph-review <file> [--baseline FILE] [--reuse-policy consumer-groups\\|fanout]` | 保守核对计算基线并列出复用计划。 | 只读；基线不一致返回 `SEMANTIC_MISMATCH` / 2，不自动创建 Local Var。 |
 | `graph-audit <file>` | 从 Master 反向分析未参与输出的节点，区分 `unused_candidates` 与外部消费者。 | 只读；Property 的源码/HLSL/GUI 引用不会被误报为可删。 |
+| `export-sg <file> --out-dir DIR [--target-project PROJECT]` | 直接输出裸 `sgcli.native.v3`、独立转换报告和发布回执。 | spec 是唯一交接输入；receipt 只证明 spec/report 提交状态；不调用 SGCLI；同名失败；转换失败只写 report。 |
+| `contract editor-graph --version 3 [--spec FILE]` | 输出 wheel 内权威 EditorGraphSpec v3 JSON Schema；可离线校验并回执输入 SHA。 | 只读；loader 仍执行端口、中文属性和模板等更强语义校验。 |
+| `migrate-package <file> --out-dir DIR --extract-sg-spec` | 显式提取登记的旧 `{graph,report}` wrapper。 | 只接受内层 `sgcli.native.v3`；未知/v2 wrapper 只留失败报告，不进入正常消费者。 |
 | `set-field <file> --node N --field I --value V [--write]` | 修改一个已知节点的绝对序列化字段。 | 默认预演；`--write` 后写入。不要用它猜写 Master 或未知版本尾部。 |
 | `add-node <file> --type T [--id N] [--pos X,Y] [--write]` | 按 schema 创建可写节点与默认参数。 | 默认预演；未知、opaque 或版本不兼容节点会拒绝。`--line` 是复用真实序列化行的专家入口；若新行含 schema 占位符的 32 位 hex 标识，会返回 `warnings` 提示在 Unity 中核对唯一性。 |
 | `connect <file> --from A:P --to B:P [--write]` | 将来源节点输出端接到目标节点输入端。 | 默认预演；`--from` 是数据源，`--to` 是消费者。 |
@@ -235,7 +259,7 @@ asecli recompile Assets/Example.shader
 | `install-skill [--agent A] [--scope user\|project] [--project-root DIR] [--skill-root DIR]` | 将 wheel 内置的通用 ASECLI Agent Skill 安装到开放 `.agents` 目录或 Codex、Claude Code、Cursor、Gemini CLI、GitHub Copilot 原生目录。 | 无参数保持旧 Codex 目录；省略 `--agent` 但给 `--scope`/`--project-root` 时默认 `agents`；`all` 以两个非重复目标覆盖五类 Agent；相同内容幂等，任一冲突先整体拒绝，不修改 Shader、材质或 Unity/Tuanjie 工程。 |
 | `comment-group <file> [--nodes IDS --title T] [--note NOTE --padding P --id N] … [--write]` | 查询、创建、嵌套 ASE 原生 Comment 框；可检查成员越框或重叠。 | 创建默认用离线尺寸估算。`--editor-bounds`、`--check-bounds`、`--fit` 需连接 Editor；`--note` 写 Comment 头小字（默认 "Comment"），`--padding` 默认 50，`--id` 指定 Comment 节点 ID。 |
 | `create <out> --from TEMPLATE [--name NAME] [--graph-from DONOR]` | 复制一个已编译模板壳；可替换图或同步 Shader 名与 CHKSM。 | **立即创建/覆盖目标**；模板和 donor 组合后的文件必须已满足属性呈现契约，否则写前拒绝。 |
-| `create <out> --backend editor --spec graph.json` | 用白名单 `EditorGraphSpec v2/v3` 让 ASE 自身创建、保存和重载目标图。 | **立即请求 Editor 写入**；每个 Property 必填中文 `inspector_name` 和中文 `tooltip`，可选 `help` 写用户 HelpBox。v3 另支持版本化 primitive/recipe 与属性精度、默认值和范围。 |
+| `create <out> --spec graph.json` | 用白名单 `EditorGraphSpec v2/v3` 让 ASE 自身创建、保存和重载目标图。 | 提供 `--spec` 时默认选择 Editor 后端并立即请求写入；每个 Property 必填中文 `inspector_name` 和中文 `tooltip`，可选 `help` 写用户 HelpBox。v3 另支持版本化 primitive/recipe 与属性精度、默认值和范围。 |
 | `recompile <file> [--mcp-url URL] [--allow-remote-mcp]` | 调用运行中 ASE 重新生成 HLSL/保存，报告 `changed`；并自动快照→恢复材质 GUI 元数据、重算 CHKSM、强制 `AssetDatabase.ImportAsset` 二次导入。 | **立即触发 Editor 操作**；默认仅允许 loopback MCP。返回 `changed`，元数据被恢复时另返回 `metadata_restored` 与 `asset_import`。 |
 
 ### 详细操作入口
@@ -250,7 +274,7 @@ asecli recompile Assets/Example.shader
 
 ### Editor API 创建
 
-默认 `create` 仍是原有纯文本后端。`--backend editor --spec graph.json` 明确使用 Editor；`--backend auto` 在提供 `--spec` 时选择 Editor，否则选择文本后端。Editor 目标必须位于 Unity/Tuanjie 工程的 `Assets/` 下且尚不存在，不允许 `--force`。
+`create` 默认自动路由：提供 `--spec` 时选择 Editor；没有 `--spec` 时走原有纯文本后端。仍可用 `--backend editor|text|auto` 显式指定。Editor 目标必须位于 Unity/Tuanjie 工程的 `Assets/` 下且尚不存在，不允许 `--force`。
 
 最小 Caster-like 规格：
 
@@ -292,12 +316,12 @@ asecli recompile Assets/Example.shader
 除显式 `--help` 保留人类可读文本外，stdout 恒为单行严格 JSON，agent 可直接解析。`--version` 也返回 JSON：
 
 ```json
-{"contract_version":1,"cli_version":"0.7.0","command":"parse","ok":true,"data":{"node_count":7}}
-{"contract_version":1,"cli_version":"0.7.0","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
-{"contract_version":1,"cli_version":"0.7.0","command":"version","ok":true,"data":{"version":"0.7.0"}}
+{"contract_version":1,"cli_version":"0.8.1","command":"parse","ok":true,"data":{"node_count":7}}
+{"contract_version":1,"cli_version":"0.8.1","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
+{"contract_version":1,"cli_version":"0.8.1","command":"version","ok":true,"data":{"version":"0.8.1"}}
 ```
 
-常见错误码：`PARSE_ERROR`、`NOT_FOUND`、`USAGE_ERROR`、`SCHEMA_UNAVAILABLE`、`SCHEMA_VERSION_MISMATCH`、`VALIDATION_ERROR`、`PROPERTY_PRESENTATION_ERROR`、`LAYOUT_ERROR`、`CHECKSUM_FORMAT_ERROR`、`GUI_SUPPORT_ERROR`、`CUSTOM_GUI_ERROR`、`COMMENT_GROUP_ERROR`、`GRAPH_REVIEW_ERROR`、`SEMANTIC_MISMATCH`、`EXTERNAL_REFERENCE`、`SKILL_INSTALL_CONFLICT`、`SKILL_INSTALL_ERROR`、`WRITE_CONFLICT`、`UNSAFE_PATH`、`WRITE_ERROR`、`BRIDGE_ERROR`、`INTERNAL`。
+常见错误码：`PARSE_ERROR`、`NOT_FOUND`、`USAGE_ERROR`、`SCHEMA_UNAVAILABLE`、`SCHEMA_VERSION_MISMATCH`、`VALIDATION_ERROR`、`PROPERTY_PRESENTATION_ERROR`、`LAYOUT_ERROR`、`CHECKSUM_FORMAT_ERROR`、`GUI_SUPPORT_ERROR`、`CUSTOM_GUI_ERROR`、`COMMENT_GROUP_ERROR`、`GRAPH_REVIEW_ERROR`、`SEMANTIC_MISMATCH`、`SG_EXPORT_BLOCKED`、`EXTERNAL_REFERENCE`、`SKILL_INSTALL_CONFLICT`、`SKILL_INSTALL_ERROR`、`WRITE_CONFLICT`、`WRITE_PARTIAL`、`UNSAFE_PATH`、`WRITE_ERROR`、`BRIDGE_ERROR`、`INTERNAL`。
 退出码：`0` 成功 · `2` 用法/校验/解析错误 · `3` 桥接错误
 
 ## 安全与验收边界

{asecli-0.7.0 → asecli-0.8.1}/docs/00-governance/change-register.md

@@ -43,5 +43,6 @@ evidence: [docs/05-audits/2026-09-01-122217-optimization-tasks.md]
 | CR-0027 | 将随 wheel 分发的 ASECLI Skill 从 Codex 默认安装扩展为主流 Agent Skills 通用安装 | MOD-CLI MOD-SKILL | 新增 `--agent`、`--scope`、`--project-root`；开放 `.agents/skills` 覆盖 Codex/Cursor/Gemini CLI/GitHub Copilot，Claude Code 使用 `.claude/skills`；无参数与 `--skill-root` 保持兼容；`all` 先检查所有内容冲突 | REG-0058 | 禁用新路由参数即可退回 CR-0015 的 Codex 默认目录；不删除或覆盖已安装 Skill | 定向 46 passed、Skill validator、Project Architect strict 与隔离 wheel 安装通过；BUG-0023 已修复固定片段编译与 SHA 回归；全量 358 passed/3 skipped；发布追溯 REL-0013 |
 | CR-0028 | 补齐 SG JSON 创建后的 ASE 图整理工作流：端口级复用计划、折叠接口计算基线、刚性计算岛排布与分层验收 | MOD-CORE MOD-LAYOUT MOD-CLI MOD-SKILL | 只读 graph-review；fanout 必须显式选择，默认消费组规则不变；island-columns 默认 1；不重建现有 Shader，不修改 SGCLI，不猜动态节点字段 | REG-0060 REG-0061 | 不用新增参数即保留原布局；回退本任务文件增量，不覆盖并行创建器改动；不发布 | 自动验证中；Local Var 自动 Editor 创建未实现，画布/GUI/渲染验收待具体目标，不以只读计划冒充写入 |
 | CR-0029 | 强化 CLI JSON 输出契约：原子 ASCII-safe 写出、拒绝非有限数、统一契约/命令/版本字段与错误码注册表 | MOD-CORE MOD-LAYOUT MOD-BRIDGE MOD-CLI MOD-SKILL | 除显式 `--help` 外 stdout 恒为一个严格 JSON；`--version` 改为 JSON；新增顶层字段为加性；损坏几何失败关闭 | REG-0062 | 回滚到 `v0.6.4`；不改 Shader 计算、Editor 交易或用户资产 | 对抗审计 5 项 finding 均关闭；定向 76 passed，全量 388 passed/3 skipped，wheel/ASCII/中文错误路径 smoke 通过；发布见 REL-0015 |
+| CR-0030 | 两 CLI 取消外部中间包：ASECLI 直接输出 SGCLI 原生裸 `sgcli.native.v3`，并以方向化 spec/report 文件名与 SGCLI 的 EditorGraphSpec 输出对称 | MOD-CLI MOD-BRIDGE MOD-SG-EXPORT MOD-CONTRACT MOD-SKILL | 新增 `export-sg`、`contract`；`create --spec` 拒绝 wrapper/report/反方向后缀；旧历史 JSON 不进入正式流程；候选 wheel Schema/篡改负例、发布 receipt 与跨仓 required workflow 失败关闭；不调用或依赖 SGCLI 运行时 | REG-0063 | 禁用新入口或回滚 wheel；不得恢复消费者隐式解包/正式 translator，不批量改名历史文件 | `v0.8.0@58ccf10` 已发布：publish run 34592028675、GitHub/PyPI 同源资产、本机 CLI/Skill 和 WaveNoise 双向原文件 SHA 全部复核通过；全量 `428 passed, 3 skipped`（Python 3.10 同结果）。最终 wheel Editor/画布/渲染仍开放，不声明视觉等价 |
 
 授权来源：用户于 2026-09-01 明确要求“执行优化任务，全部完成”，并于同日批准吸收 ASE Editor API 方案后要求“执行”；随后明确要求先推送并执行对抗性审计优化计划。2026-09-02 用户要求推送并进一步明确“以正式的 CLI 形式发布”，据此创建私有正式 GitHub Release `v0.1.0`；同日进一步明确说明条样式一致性必须成为 CLI 的规范能力，据此登记 CR-0011/BUG-0015，并明确所有通过 CLI 构建的 ASE 文件都必须使用中文属性显示名、自动变量名与默认值 Tooltip 和中文使用说明，据此登记 CR-0012。同日用户要求执行 `2026-09-02-211218` 优化计划，据此登记 CR-0013；随后书面授权打 tag 并发布 `v0.2.0`。2026-09-03 用户要求执行最新优化任务书并把剩余门槛全部完成，据此登记 CR-0014 并授权完成必要提交、直接推送与远程 CI 验证；随后明确要求“推送并发布”，据此授权创建私有正式版本 `v0.3.0`。2026-09-04 用户要求将 ASE 精排与 Inspector 编排规范作为可安装 Skill 并授权发布 `v0.3.1`。2026-09-05 用户要求执行 MZGUI 对接与效率优化，随后分别授权私有版本 `v0.4.0`、`v0.4.1` 和审计补丁 `v0.4.2`。2026-09-06 用户明确 Tooltip 必填、HelpBox 可选、条件置灰并授权 `v0.5.0`；随后要求脑图式 DAG 精排并授权 `v0.6.0`；又将 Local Var 门槛改为两个及以上不同消费组，据此登记 CR-0020；最后以多组人工示范明确递归局部鱼骨、Comment 保留和显式 WireNode 路由并要求执行，据此登记 CR-0021。2026-09-07 用户明确授权提交、推送、私有 Release `v0.6.1` 和本机安装。同日进一步明确要求开源该项目并提供同事安装命令，据此登记 CR-0022：采用 MIT 许可证并将 GitHub 仓库转为 public。随后要求做成最终、最常见的安装形态，据此登记 CR-0023：发布 PyPI 项目 `asecli`，用户命令为 `uv tool install asecli`；仍未授权 CLI Hub。2026-09-08 用户进一步明确要求推送、发布新版本并安装本机，据此授权 `v0.6.2` 的 main 推送、tag、GitHub Release、PyPI Trusted Publishing 与本机正式产物安装；CLI Hub 仍不在授权范围。首次 PyPI OIDC 因没有对应账号和 Trusted Publisher 失败后，用户说明没有 PyPI 账号并明确要求继续 GitHub Release 发布，据此以 CR-0025 将 PyPI 延后并完成 GitHub-only 交付。随后用户取得 PyPI 账号并明确要求继续配置，据此登记 CR-0026，启用精确匹配的 Pending Publisher 并通过 run 34192454152 attempt 3 完成首次 PyPI 发布。同日用户要求将现有 Skill 改为主流 Agent 通用，据此登记 CR-0027；本次不包含推送、tag 或发布。2026-09-10 用户要求对 JSON 输出能力执行对抗审计与优化，随后明确要求推送、发布并安装本机，据此登记 CR-0029 并授权 `v0.7.0` GitHub Release、PyPI Trusted Publishing 与本机 CLI/Skill 安装；CLI Hub 仍不在范围。

{asecli-0.7.0 → asecli-0.8.1}/docs/00-governance/timeline.md

@@ -92,3 +92,8 @@
 | 2026-09-08 | v0.6.4 发布及全局安装完成 | long 授权；verified → released；tag d4a5a46、publish run 34224245874 与主线 run 34224240036 成功；双 Python 各 371 passed/3 skipped，双渠道资产一致；本机 CLI 0.6.4、全局 .agents/.claude/.codex Skill 内容一致且幂等，旧 Codex Skill 已可恢复备份；并行创建器改动未纳入 | REL-0014 CR-0028 TASK-0061 TASK-0062 TASK-0063 REG-0060 REG-0061 |
 | 2026-09-10 | CLI JSON 契约对抗审计与整改 | 5 项 finding 全部关闭；新增原子 ASCII-safe writer、非有限数双门禁、contract/CLI version/command 顶层字段、version JSON、22 错误码注册表与 17 子命令动态契约覆盖；未触及 Shader 计算或 Editor 资产 | CR-0029 TASK-0064 REG-0062 AA-OPT-001 AA-OPT-002 AA-OPT-003 AA-OPT-004 AA-OPT-005 |
 | 2026-09-10 | v0.7.0 发布候选 | 用户明确要求推送后发布并安装本机；因 `--version` 的机器协议变化按 pre-1.0 语义版本升级为 0.7.0，保留 v0.6.4 回滚点，远程 CI/OIDC、双渠道回读与本机 CLI/Skill 安装按 REL-0015 执行 | REL-0015 CR-0029 TASK-0064 REG-0062 |
+| 2026-09-10 | v0.7.0 双渠道发布与本机安装完成 | tag `v0.7.0` 解引用为 `029fea4`；run 34475832000 的双 Python verify、package 与 PyPI OIDC publish 全成功；GitHub Release 为 Latest，五项资产与 PyPI wheel/sdist 摘要一致；本机 CLI、官方索引 uvx 及三处全局 Skill 均通过，旧 Skill 已完整备份 | REL-0015 CR-0029 TASK-0064 REG-0062 |
+| 2026-09-11 | 双向裸规格直连第二轮对抗整改 | CR-0030 / ADR-0022 / TASK-0065 / REG-0063：完成 AA-OPT-201～207，补齐 Draft parity、候选 wheel 契约可信根、篡改负例、required workflow、语义矩阵、离线 artifact、发布 receipt 与迁移 provenance。全量 `419 passed, 3 skipped`；最终 wheel `2e38ef11...` 可复现，真实双向 WaveNoise producer/consumer SHA 一致。用户级 ASECLI Skill 因不同内容按规则拒绝覆盖；最终 wheel Editor/画布/render 仍开放。未提交、未推送、未发布。 | CR-0030 ADR-0022 TASK-0065 REG-0063 AA-OPT-201 AA-OPT-202 AA-OPT-203 AA-OPT-204 AA-OPT-205 AA-OPT-206 AA-OPT-207 |
+| 2026-09-11 | 双向裸规格直连第三轮对抗整改 | 执行 AA-OPT-301～308：public PR 不读取 private SGCLI；可信链要求只读 token 和精确 40 位 SHA；package wheel 原样交给 cross-CLI/publish；WaveNoise 双向语义 fixture、receipt 绑定、fixture-set 完整性、Draft 数值等价与 clean provenance 通过。全量及 Python 3.10 均 `428 passed, 3 skipped`；本地 clean release-mode 双 wheel matrix/verifier 通过。AA-OPT-309 的远端 ruleset/required checks、最终 wheel Editor/画布/render 仍开放。未提交、未推送、未发布。 | CR-0030 TASK-0065 REG-0063 AA-OPT-301 AA-OPT-302 AA-OPT-303 AA-OPT-304 AA-OPT-305 AA-OPT-306 AA-OPT-307 AA-OPT-308 AA-OPT-309 |
+| 2026-09-11 | v0.8.0 双渠道发布与本机安装完成 | tag `v0.8.0` 解引用到 `58ccf10`；[publish run 34592028675](https://github.com/seeseeczl/ASECLI/actions/runs/34592028675) 的双 Python、package、public contract、Deploy Key cross-CLI 和 PyPI OIDC 全绿。GitHub Release 五项资产与 PyPI wheel/sdist 摘要一致且未 yanked；本机 CLI 为 0.8.0，`.agents`/`.claude` Skill 与 wheel 一致，旧三处 Skill 已备份。WaveNoise 双向生产/消费 SHA 一致；最终 wheel 的 Editor/画布/render 保持未验证披露。 | REL-0016 CR-0030 TASK-0065 REG-0063 |
+| 2026-09-14 | v0.8.1 发布候选 | matcher-v4 识别并折叠原生 `Lerp(white,color,alpha)`，保留 Wave Noise 不可表示 Alpha Blend 的失败关闭；SGCLI 普通 authoring 与转换认证分离。发布前全量 `461 passed, 3 skipped`，CI governance、供应链与 diff 通过；远端 publish/PyPI、正式资产回读和本机安装待执行，Editor/画布/render 保持开放披露。 | REL-0017 CR-0030 TASK-0066 REG-0063 |

{asecli-0.7.0 → asecli-0.8.1}/docs/00-governance/traceability.csv

@@ -61,4 +61,5 @@ CR-0026,变更,已发布,ADR-0019,MOD-CLI,TASK-0058,REG-0021 REG-0052 REG-0057,2
 CR-0027,变更,已发布,ADR-0021,MOD-CLI MOD-SKILL,TASK-0059 TASK-0060,REG-0058,2026-09-08 v0.6.3@a758d0f；run 34205409407；双 Python 358 passed/3 skipped；双渠道摘要与安装回滚通过,REL-0013,long,主流 Agent Skill；旧安装兼容
 BUG-0023,缺陷,已修复,ADR-0020,MOD-BRIDGE,TASK-0060,REG-0059,2026-09-08 两类真实 v2 CLI create/manifest/validate/recompile 通过；358 passed/3 skipped,REL-0013,long,方法体兼容 KeyValuePair；SphereMask Radius 重载仍为已知限制
 CR-0028,变更,已发布（视觉与自动LocalVar仍待验）,ADR-0021,MOD-CORE MOD-LAYOUT MOD-CLI MOD-SKILL,TASK-0061 TASK-0062 TASK-0063,REG-0060 REG-0061,端口级基线与复用计划及岛内刚性多列布局；未自动创建LocalVar；未做实机验收,REL-0014,long,保留并行创建器改动；不修改SGCLI
-CR-0029,变更,已验证,ADR-0001 ADR-0009,MOD-CORE MOD-LAYOUT MOD-BRIDGE MOD-CLI MOD-SKILL,TASK-0064,REG-0062,2026-09-10 对抗审计 5 项关闭；76 passed；全量 388 passed/3 skipped；wheel 与 ASCII/中文路径 smoke 通过,REL-0015,long,严格原子 JSON；非有限数拒绝；version JSON；22 错误码；17 子命令动态覆盖
+CR-0029,变更,已发布,ADR-0001 ADR-0009,MOD-CORE MOD-LAYOUT MOD-BRIDGE MOD-CLI MOD-SKILL,TASK-0064,REG-0062,2026-09-10 v0.7.0@029fea4；run 34475832000 全成功；GitHub/PyPI 摘要一致；本机 CLI/Skill 安装幂等,REL-0015,long,严格原子 JSON；非有限数拒绝；version JSON；22 错误码；17 子命令动态覆盖
+CR-0030,变更,已发布（视觉门禁开放）,ADR-0022,MOD-CLI MOD-BRIDGE MOD-SG-EXPORT MOD-CONTRACT MOD-SKILL,TASK-0065,REG-0063,2026-09-11 v0.8.0 publish run 34592028675 全绿；GitHub/PyPI 资产、本机 CLI/Skill 和 WaveNoise 双向原文件 SHA 通过,REL-0016,long,消费者原生裸规格与方向命名；最终 wheel Editor/画布/渲染仍开放

{asecli-0.7.0 → asecli-0.8.1}/docs/01-architecture/module-map.md

@@ -5,13 +5,15 @@
 | MOD-CORE | src/asecli/core | FR-0001 FR-0002 FR-0005 CR-0002 CR-0005 CR-0028 CR-0029 BUG-0002 BUG-0007 BUG-0009 | 行式模型、图块替换、最小差异写回 | `AseFile.from_path`；`parse_graph_text`；`parse_node_line`；`replace_graph` | 仅标准库；禁止依赖 schema/bridge/cli |
 | MOD-SCHEMA | src/asecli/schema | FR-0002 CR-0002 BUG-0001 | 节点 schema、版本兼容与 mutation allowlist | `schema_for`；`schema_version`；`is_version_compatible` | 允许依赖 MOD-CORE 类型；禁止依赖 bridge/cli |
 | MOD-CHECK | src/asecli/checks | FR-0003 CR-0002 CR-0003 BUG-0003 BUG-0006 | 图结构校验与 CHKSM 重算 | `validate_file`；`verify_checksum`；`fix_checksum` | 允许依赖 MOD-CORE；禁止依赖 bridge/cli |
-| MOD-BRIDGE | src/asecli/bridge | FR-0004 FR-0008 FR-0009 FR-0011 CR-0001 CR-0004 CR-0008 CR-0009 CR-0010 CR-0011 CR-0012 CR-0013 CR-0014 CR-0016 CR-0017 CR-0018 CR-0019 CR-0021 CR-0024 CR-0029 BUG-0005 BUG-0012 BUG-0013 BUG-0016 BUG-0021 BUG-0023 | MCP 客户端、loopback 信任边界、tool result/envelope、重编译、受控 Editor 图创建、WireNode 路由事务、确定性资源拼装与 GUI 支持升级 | `recompile_via_mcp`；`create_shader_via_mcp`；`apply_wire_routes_via_mcp`；`inspect_gui_support`；`install_gui_support`；`McpClient` | 仅标准库；禁止依赖 cli；远程需显式授权 |
-| MOD-CLI | src/asecli/cli | FR-0003 FR-0005 FR-0006 FR-0007 FR-0009 FR-0010 FR-0011 CR-0002 CR-0003 CR-0004 CR-0005 CR-0006 CR-0008 CR-0009 CR-0010 CR-0011 CR-0012 CR-0013 CR-0015 CR-0016 CR-0017 CR-0018 CR-0019 CR-0021 CR-0022 CR-0023 CR-0024 CR-0025 CR-0026 CR-0027 CR-0028 CR-0029 BUG-0004 BUG-0006 BUG-0008 BUG-0009 BUG-0010 BUG-0013 BUG-0017 BUG-0018 | 17 个命令、单行严格 JSON、原子 ASCII-safe 写出、写入/信任组合根、create 后端路由、属性呈现门禁、跨主流 Agent 的受控 Skill 安装与版本化可校验 CI 打包 | `asecli <command>`；`asecli install-skill` | 允许依赖 core/schema/check/bridge；只能使用公开 API |
-| MOD-SKILL | skills/asecli | FR-0006 FR-0008 FR-0009 FR-0010 FR-0011 CR-0007 CR-0008 CR-0010 CR-0013 CR-0015 CR-0016 CR-0018 CR-0019 CR-0020 CR-0021 CR-0027 CR-0028 CR-0029 | 通用 Agent Skill：ASE 格式说明、递归鱼骨精排、Inspector 分组/命名/说明规范、图/GUI/Comment/Local Var/编译操作手册、错误处理与跨 Agent 执行边界；随 wheel 打包并由 CLI 安装 | `SKILL.md`；`references/layout-standard.md`；`references/material-property-standard.md`（文档资产） | 无代码依赖；只要求 shell 与单行 JSON，不依赖某家 Agent 专属 API |
+| MOD-BRIDGE | src/asecli/bridge | FR-0004 FR-0008 FR-0009 FR-0011 CR-0001 CR-0004 CR-0008 CR-0009 CR-0010 CR-0011 CR-0012 CR-0013 CR-0014 CR-0016 CR-0017 CR-0018 CR-0019 CR-0021 CR-0024 CR-0029 CR-0030 BUG-0005 BUG-0012 BUG-0013 BUG-0016 BUG-0021 BUG-0023 | MCP 客户端、loopback 信任边界、tool result/envelope、重编译、受控 Editor 图创建、EditorGraphSpec 权威 Schema、WireNode 路由事务、确定性资源拼装与 GUI 支持升级 | `recompile_via_mcp`；`create_shader_via_mcp`；`editor_graph_schema`；`apply_wire_routes_via_mcp`；`inspect_gui_support`；`install_gui_support`；`McpClient` | 仅标准库；禁止依赖 cli；远程需显式授权 |
+| MOD-CLI | src/asecli/cli | FR-0003 FR-0005 FR-0006 FR-0007 FR-0009 FR-0010 FR-0011 CR-0002 CR-0003 CR-0004 CR-0005 CR-0006 CR-0008 CR-0009 CR-0010 CR-0011 CR-0012 CR-0013 CR-0015 CR-0016 CR-0017 CR-0018 CR-0019 CR-0021 CR-0022 CR-0023 CR-0024 CR-0025 CR-0026 CR-0027 CR-0028 CR-0029 CR-0030 BUG-0004 BUG-0006 BUG-0008 BUG-0009 BUG-0010 BUG-0013 BUG-0017 BUG-0018 | 20 个命令、单行严格 JSON、原子 ASCII-safe 写出、写入/信任组合根、create 后端路由、双向 contract/export/migration 入口、属性呈现门禁、跨主流 Agent 的受控 Skill 安装与版本化可校验 CI 打包 | `asecli <command>`；`asecli export-sg`；`asecli contract`；`asecli migrate-package`；`asecli install-skill` | 允许依赖 core/schema/check/bridge/export；只能使用公开 API |
+| MOD-SKILL | skills/asecli | FR-0006 FR-0008 FR-0009 FR-0010 FR-0011 CR-0007 CR-0008 CR-0010 CR-0013 CR-0015 CR-0016 CR-0018 CR-0019 CR-0020 CR-0021 CR-0027 CR-0028 CR-0029 CR-0030 | 通用 Agent Skill：ASE 格式说明、递归鱼骨精排、Inspector 分组/命名/说明规范、图/GUI/Comment/Local Var/编译操作手册、错误处理与跨 Agent 执行边界；随 wheel 打包并由 CLI 安装 | `SKILL.md`；`references/layout-standard.md`；`references/material-property-standard.md`（文档资产） | 无代码依赖；只要求 shell 与单行 JSON，不依赖某家 Agent 专属 API |
 | MOD-LAYOUT | src/asecli/core/layout.py; meticulous_layout.py; layout_audit.py; comment_layout.py; wire_geometry.py; wire_router.py | FR-0008 FR-0010 CR-0019 CR-0020 CR-0021 CR-0028 CR-0029 | 兼容分层布局；基于真实端口和直属来源局部输出线的递归鱼骨、Local Var 跨组审计、Comment 保留/收框/作用标题、显式 WireNode 路由计划 | `layout_positions`；`meticulous_layout_positions`；`audit_meticulous_layout`；`plan_wire_routes` | 允许依赖 core 模型；禁止依赖 schema/bridge/cli |
 | MOD-CUSTOM-GUI | src/asecli/core/custom_gui.py; custom_gui_versions.py; material_gui_spec.py; material_gui_condition.py; property_presentation.py | FR-0009 FR-0010 CR-0009 CR-0010 CR-0012 CR-0016 CR-0018 BUG-0011 | 真实版本能力矩阵；主 Master/ShaderLab CustomEditor 同步；PropertyNode MZGUI 元数据尾部、中文显示名、UTF-16 文案、旧标记兼容、条件置灰、批量治理与 `asecli.property-presentation.v2` 检查 | `inspect_custom_gui`；`resolve_property_node`；`apply_material_gui_spec`；`require_property_presentation` | 仅依赖 MOD-CORE model；禁止依赖 schema/check/bridge/cli |
 | MOD-GUI-SUPPORT | src/asecli/bridge/gui_support.py; gui_provider_detection.py; `_gui_project.py`; `_gui_resource_store.py`; `_gui_resource_upgrade.py`; gui_presentation.py; bridge/resources/asecli_material_gui*.cs.txt | FR-0009 CR-0009 CR-0010 CR-0011 CR-0014 CR-0016 CR-0018 BUG-0014 BUG-0015 BUG-0019 BUG-0020 BUG-0022 | 原生 MZGUI 优先选择；fallback 安全安装/已知哈希升级；以同一个 `MZGUI.MZGUI` 公共入口渲染 Inspector；ASE Editor 可视化编辑三类标准属性；打开图时恢复元数据；未知版本能力失败关闭 | `inspect_gui_support`；`install_gui_support`；`MZGUI.MZGUI`；`ASECLIGUIAttributesWindow` | Python 仅标准库；C# 仅 UnityEditor/UnityEngine，通过字符串反射适配 ASE，禁止源码补丁和编译期 ASE 引用 |
 | MOD-COMMENTARY | src/asecli/core/commentary.py | FR-0010 | CommentaryNode 可变长序列化、成员树检查与自动包围框 | `inspect_comment_groups`；`create_comment_group` | 仅依赖 MOD-CORE model/graph_ops；禁止依赖 schema/check/bridge/cli |
+| MOD-SG-EXPORT | src/asecli/export_sg.py; src/asecli/sg_export | CR-0030 | 从 ASE 图与生成 ShaderLab 建立源 manifest，映射属性、节点、连接、Register/Get、Comment、资源和 Target，输出裸 `sgcli.native.v3` 与独立转换报告 | `export_sg`；`build_native_spec`；`build_conversion_report` | 允许依赖 MOD-CORE 与公开 contracts；禁止调用 SGCLI、依赖 SGCLI Python 包或输出 source-native wrapper |
+| MOD-CONTRACT | src/asecli/contracts.py; src/asecli/contracts | CR-0030 | 随 wheel 发布 EditorGraphSpec v3 权威 Schema，并固定 SGCLI native v3 消费快照版本/SHA | `editor_graph_schema`；`native_v3_snapshot` | 仅静态 package resource；不得放宽运行时 loader 或建立跨仓运行时依赖 |
 
 ## 依赖规则
 
@@ -28,3 +30,4 @@
 11. `layout`/`comment-group` 的 JSON 只证明结构结果，固定返回独立的 `structural_validation` 与 `visual_validation`；真实画布签收必须引用版本化截图/人工证据，当前基线为 REG-0041。
 12. MaterialGUI 的长中文标签在窄宽度下自动换行，字段独占下一行；技术 Tooltip 默认值使用最多六位小数的 invariant 格式。REG-0042 是主题、宽度、缩放和交互状态回归基线。
 13. `asecli install-skill` 只安装随 wheel 打包的 `asecli` Skill。无参数保持原 Codex 用户目录；显式路由支持开放 `.agents` 以及 Codex、Claude Code、Cursor、Gemini CLI、GitHub Copilot 的用户级/项目级目录。`all` 只写 `.agents` 与 `.claude` 两个非重复根并在写入前检查全部内容冲突；同内容幂等，不同内容失败关闭，不覆盖用户自定义 Skill。wheel 必须包含 Skill 与所有引用规范。
+14. 双向转换的外部交接只允许消费者原生裸规格：ASECLI 只消费 `EditorGraphSpec v3`，只生产 `sgcli.native.v3`；spec/report 分文件，方向后缀固定，同名不覆盖。内部 manifest/IR 不得成为用户必须传递的第三份图 JSON。

{asecli-0.7.0 → asecli-0.8.1}/docs/01-architecture/technical-route.md

@@ -192,3 +192,13 @@
 - 决策：新增 `--agent agents|codex|claude|cursor|gemini|copilot|all`、`--scope user|project` 和 `--project-root`。`.agents/skills` 是 Codex、Cursor、Gemini CLI 与 GitHub Copilot 共同识别的开放目录；Claude Code 另用 `.claude/skills`。因此 `all` 只安装这两个根，避免向每个兼容别名重复复制同名 Skill。单一 Agent 仍可选择其原生目录。
 - 兼容与安全：无参数继续解析 `$CODEX_HOME/skills` 或 `~/.codex/skills`，`--skill-root` 保持显式覆盖。所有目标沿用完整树 digest、幂等、符号链接保护与不同内容拒绝覆盖；`all` 在创建任一目标前预检全部已有 Skill 内容冲突。
 - 边界：Skill 只约定 shell 与单行 JSON，不假设 Agent 专属工具、权限或消息格式。Editor、目标工程和视觉验收能力仍由实际运行环境决定；本 CR 不发布版本、不修改 Shader、不启动 Editor。
+
+### ADR-0022 双 CLI 使用消费者原生裸规格直连
+
+- 状态：已实现，视觉验收未关闭（2026-09-11，CR-0030）
+- 背景：历史 ASE→SG 需要 ASE 自有语义 JSON 和一次性翻译脚本，SG→ASE 又曾使用 `graph + report` wrapper；两者都让用户交接文件不能直接成为对方 CLI 的正式输入。
+- 决策：ASECLI 的 `export-sg` 直接生成裸 `sgcli.native.v3`，文件名为 `<stem>.asecli-to-sgcli.spec.json`；独立报告为同 stem 的 `.report.json`。反向由 SGCLI 直接生成裸 `EditorGraphSpec v3`，ASECLI `create --spec` 原样读取。两个 CLI 不互调，不发布 source-native 中间协议。
+- 契约所有权：ASECLI 随 wheel 发布并导出 EditorGraphSpec v3 Schema；SGCLI 随 wheel 发布 native v3 Schema。生产者快照固定消费者版本与 Schema SHA；消费者严格拒绝 wrapper、未知字段、已知反方向后缀和 report 文件。
+- 写入语义：输出目录由生产者强制生成规范名称；同名失败；转换失败可以写规范 report，但不得写不完整 spec。Schema 版本仅存在于内容。
+- 证据边界：producer/consumer 文件 SHA 完全一致只证明无变换交接。Editor 创建、保存重载、编译、正常缩放画布和同条件渲染仍分别验收；未运行渲染时 `visual_equivalent=false`。
+- 回滚：可禁用 `export-sg` 新入口或恢复旧发布版本，但不得让 `create --spec` 接受 wrapper，也不得把一次性 translator 恢复为正式主链。

{asecli-0.7.0 → asecli-0.8.1}/docs/03-quality/regression-catalog.md

@@ -64,3 +64,4 @@
 | REG-0060 | CR-0028 | conversion-baseline：来源输出分量、目标端口、Register/Get 等价折叠、错误引用/环/重复输入失败关闭、常量变化拒绝、显式 fanout 与默认消费组策略、既有 Register 幂等复用 | `uv run --frozen pytest tests/test_graph_review.py tests/test_layout_local_var_policy.py` | 定向 94 passed；自动环节已验证；真实历史 Wave Noise 文件只读识别 12 个候选；不声明源 SG 默认值或画面等价 |
 | REG-0061 | CR-0028 | island-packing：保持岛内鱼骨相对位置、逻辑依赖顺序、主输出锚定、二次幂等、非法几何与列数失败关闭、保留默认布局契约 | `uv run --frozen pytest tests/test_island_layout.py tests/test_layout_governance.py tests/test_layout.py tests/test_cli_contract.py` | 定向 94 passed；自动环节已验证；本次未写 Unity 工程，实机画布待验 |
 | REG-0062 | CR-0029 AA-DATA-001 AA-DATA-002 AA-CONTRACT-001 AA-CONTRACT-002 AA-TEST-001 | cli-json-contract-v1：先序列化后原子 ASCII-safe 写出；拒绝 NaN/Infinity 与非有限几何；顶层契约/版本/命令字段；version JSON/help 唯一文本例外；22 错误码与 17 子命令动态对账 | `uv run --frozen pytest tests/test_cli_contract.py tests/test_bridge_contract.py tests/test_commentary.py tests/test_smoke.py tests/test_install_scripts.py` + 全量 pytest + 隔离 wheel console-script smoke | 定向 76 passed；全量 388 passed/3 skipped；ASCII stdout+中文错误路径、wheel 安装、lock/CI/供应链/文档治理/diff 通过；Editor/Windows 未本地运行，Windows 交由发布 CI 验证 |
+| REG-0063 | CR-0030 ADR-0022 AUD-FLOW-001 AUD-CONTRACT-002 AUD-CONTRACT-003 AA-CONTRACT-201 AA-CI-202 AA-REL-203 AA-TEST-204 AA-EVIDENCE-205 AA-DATA-206 AA-MIGRATE-207 AA-CI-301 AA-CI-302 AA-TEST-303 AA-EVIDENCE-304 AA-REL-305 AA-EVIDENCE-306 AA-CONTRACT-307 AA-PROV-308 AA-GOV-309 | direct-cross-cli-json-v3：`export-sg` 规范命名与失败仅报告；裸 native v3 顶层；反方向/report/wrapper/未知字段拒绝；Draft 2020-12 数值 parity；三态 receipt 交叉绑定；build-once 候选 wheel；固定 WaveNoise 双向语义 fixture；fixture-set 完整性；clean provenance；生产者输出与消费者输入 SHA-256 完全一致 | `uv run --frozen pytest tests/test_export_sg.py tests/test_contract_schema.py tests/test_editor_create_cli.py tests/test_cli_contract.py tests/test_build_reproducibility.py tests/test_cross_cli_workflow.py` + SGCLI `tests/test_cross_cli_semantics.py`、双 wheel 黑盒 matrix/verifier + bridge 3 分层 E2E | 第三轮全量 `428 passed, 3 skipped`，Python 3.10 同结果；临时干净快照 release-mode matrix 两仓 `dirty=false`、WaveNoise configured、离线 verifier 通过。远端 required checks/ruleset、最终 wheel Editor/画布/render 未关闭，不得声明发布或视觉等价。 |

{asecli-0.7.0 → asecli-0.8.1}/docs/04-delivery/project-plan-task-charter.md

@@ -104,7 +104,9 @@ kickoff_completion: complete
 | TASK-0061 | CR-0028 | 核对转换图计算基线及端口级复用计划 | 用户缺口补齐授权 | graph_review.py/reuse_plan.py/core 公共导出/layout_audit.py 与相关测试 | SGCLI、生成 HLSL、猜写 Local Var | long/2026-09-08 | REG-0060；错误端口和常量变化必须失败，默认策略保持 | 折叠丢分量或误吞默认值即停止 | 定向 94 passed；自动环节已验证；只读，不宣称自动创建接口 | 自动验证完成，实机待验 |
 | TASK-0062 | CR-0028 | 独立计算岛刚性多列摆放 | TASK-0061；已有鱼骨与真实几何契约 | island_layout.py/meticulous_layout.py 与测试 | 拆改岛内连接、自动 WireNode 路由、虚构几何 | long/2026-09-08 | REG-0061；相对位置、依赖与二次幂等 | 几何缺失/布局硬失败时零写入 | 定向 94 passed；自动环节已验证；实机待验 | 自动验证完成，实机待验 |
 | TASK-0063 | CR-0028 | 将转换后交付流程接入 CLI 与 Skill | TASK-0061 TASK-0062；用户完整过程 | graph_review_command.py/main.py/layout_command.py；Skill/README/治理 | 发布、覆盖用户 Skill、改并行创建器、生产 Shader | long/2026-09-08 | REG-0060 REG-0061；CLI JSON/只读/失败码、Skill validator | 计划冒充创建或结构冒充视觉时停止 | 定向 94 passed；自动环节已验证；未接入自动 Local Var Editor 创建 | 自动验证完成，实机待验 |
-| TASK-0064 | CR-0029 | 关闭 JSON 输出对抗审计并发布安装 `v0.7.0` | AA-OPT-001～005；用户推送、发布、安装授权 | contract/main；Commentary/layout/Editor 几何；README/Skill；版本与 REL-0015 | CLI Hub；修改用户 Shader；覆盖未知 Skill；绕过发布门禁 | long/2026-09-10 | REG-0062；双 Python、完整治理、可复现构建、远程 publish/OIDC、双渠道摘要、本机 CLI/Skill | CI、OIDC、摘要、安装或 Skill 冲突任一失败即停止，保留 `v0.6.4` | 本地 76 passed；全量 388 passed/3 skipped；远程与安装证据回写 REL-0015 | 本地候选已验证 |
+| TASK-0064 | CR-0029 | 关闭 JSON 输出对抗审计并发布安装 `v0.7.0` | AA-OPT-001～005；用户推送、发布、安装授权 | contract/main；Commentary/layout/Editor 几何；README/Skill；版本与 REL-0015 | CLI Hub；修改用户 Shader；覆盖未知 Skill；绕过发布门禁 | long/2026-09-10 | REG-0062；双 Python、完整治理、可复现构建、远程 publish/OIDC、双渠道摘要、本机 CLI/Skill | CI、OIDC、摘要、安装或 Skill 冲突任一失败即停止，保留 `v0.6.4` | v0.7.0@029fea4；run 34475832000 全成功；GitHub/PyPI 摘要一致；本机 CLI/Skill 安装与幂等通过 | 已发布 |
+| TASK-0065 | CR-0030 ADR-0022 AA-OPT-201～207 AA-OPT-301～309 REL-0016 | 实现 ASECLI→native v3 与 SGCLI→EditorGraphSpec v3 的双向裸规格原文件直连并发布 0.8.0 | 用户确认的合并优化计划、三轮对抗审计与推送发布安装授权 | `export_sg.py`、`sg_export/**`、`contracts/**`、`schema_validation.py`、`conversion_output.py`、CLI/create、README/Skill、测试、治理和 cross-CLI workflows | 调用 SGCLI；恢复 source-native/wrapper 主链；修改生产 Shader；覆盖用户 dirty Skill；绕过失败门禁 | long/2026-09-11 | REG-0063；Draft parity；候选 wheel Schema/篡改负例；固定 WaveNoise 语义；artifact 完整性与 clean provenance；双 Python全量；远端 publish/OIDC；双渠道回读；本机 CLI/Skill；Editor/画布/渲染分层 | 未知 ASE/Target/资源/端口、部分 spec、同名覆盖、Schema 漂移、脏候选、远端门禁或资产冲突即停止 | `v0.8.0@58ccf10` 已发布；run 34592028675、GitHub/PyPI 资产、本机 CLI/Skill 和 WaveNoise 双向原文件 SHA 全部复核通过；最终 Editor/画布/渲染开放披露 | 已发布（REL-0016，视觉开放） |
+| TASK-0066 | CR-0030 ADR-0022 AA-OPT-201 AA-OPT-202 REL-0017 | 发布并安装 matcher-v4 与 ASE→SG 转换认证补丁 v0.8.1 | 用户要求两个 CLI 分别推送、发布并安装本机 | `sg_export/**`、report、版本、README、回归与发布证据 | 修改生产 Shader；绕过不可表示 Alpha Blend；恢复 wrapper；覆盖未知 Skill | long/2026-09-14 | REG-0063；两仓全量、治理、供应链、Tag publish、GitHub/PyPI 摘要、本机 CLI/Skill；Editor/视觉分层 | 任一自动/远端/摘要/安装门禁失败即停止并保留 v0.8.0 | 本地候选 `461 passed, 3 skipped`，远端与安装待执行 | verified |
 
 ## 验证、风险与回滚
 

{asecli-0.7.0 → asecli-0.8.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asecli"
-version = "0.7.0"
+version = "0.8.1"
 description = "Agent-native CLI for reading, modifying, validating and compiling Amplify Shader Editor assets"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -27,7 +27,7 @@ Issues = "https://github.com/seeseeczl/ASECLI/issues"
 Changelog = "https://github.com/seeseeczl/ASECLI/releases"
 
 [dependency-groups]
-dev = ["hatchling==1.32.0", "pytest>=8.0"]
+dev = ["hatchling==1.32.0", "jsonschema>=4.23,<5", "pytest>=8.0"]
 
 [project.scripts]
 asecli = "asecli.cli.main:app"
@@ -45,6 +45,8 @@ packages = ["src/asecli"]
 # wheel-based CLI install.
 [tool.hatch.build.targets.wheel.force-include]
 "skills/asecli" = "asecli/skills/asecli"
+"src/asecli/contracts/editor-graph-spec.v3.schema.json" = "asecli/contracts/editor-graph-spec.v3.schema.json"
+"src/asecli/contracts/sgcli.native.v3.schema.json" = "asecli/contracts/sgcli.native.v3.schema.json"
 
 [tool.hatch.build.targets.sdist]
 # Release/audit records contain artifact evidence and are kept outside the