asecli 0.8.4__tar.gz → 0.8.6__tar.gz

{asecli-0.8.4 → asecli-0.8.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: asecli
-Version: 0.8.4
+Version: 0.8.6
 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.8.4](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.4)** · [PyPI](https://pypi.org/project/asecli/0.8.4/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
+当前正式版：**[0.8.6](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6)** · [PyPI](https://pypi.org/project/asecli/0.8.6/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
 
-ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；独立 report 与发布 receipt 都不进入创建输入，创建成功也不代表转换效果等价。
+ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；spec 是唯一图规格；独立 report 与发布 receipt 通过各自参数提供转换认证证据，创建成功也不代表转换效果等价。
 
 ```
 你：提需求（"给这个 shader 加个可调描边"）
@@ -132,7 +132,7 @@ curl -fsSL https://raw.githubusercontent.com/seeseeczl/ASECLI/main/scripts/insta
 uv tool uninstall asecli
 ```
 
-当前正式版本为 `0.8.4`（ASE→SG 诊断收敛、Custom Function 原样证据与 MZGUI 呈现分层），可从 [PyPI](https://pypi.org/project/asecli/0.8.4/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.4) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.3` 保留为回滚点。
+当前正式版本为 `0.8.6`（补齐 ASE→SG 三文件交接、时间后缀与验收边界说明；运行行为沿用 0.8.5），可从 [PyPI](https://pypi.org/project/asecli/0.8.6/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.5` 保留为回滚点。
 
 已知限制：真实 MCP 下，属性+纹理 v2 和 Reciprocal 降级 v2 的 create、manifest、validate、独立 recompile 已通过；SGCLI SphereMask v3 spec 在重载时仍可能返回 `node missing after reload: Radius` 并回滚。本次不承诺该 recipe 端到端可用，也不改变 SGCLI v2 默认值契约。
 
@@ -162,7 +162,7 @@ asecli --help
 
 ```bash
 shasum -a 256 -c SHA256SUMS
-uv tool install /path/to/asecli-0.8.4-py3-none-any.whl
+uv tool install /path/to/asecli-0.8.6-py3-none-any.whl
 asecli --help
 ```
 
@@ -202,11 +202,28 @@ asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
 ```bash
 asecli export-sg Assets/ConvertedNew.shader --out-dir ./out
 sgcli sg create Assets/ConvertedNew.shadergraph \
-  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json
+  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json \
+  --conversion-report ./out/ConvertedNew.asecli-to-sgcli.report.json \
+  --publication-receipt ./out/ConvertedNew.asecli-to-sgcli.receipt.json \
+  --write
 ```
 
 `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`。
 
+需要保存在源文件同目录并添加时间后缀时：
+
+```bash
+asecli export-sg /path/to/Shader.shader \
+  --out-dir /path/to \
+  --output-suffix "_$(date +%Y%m%d_%H%M%S)"
+```
+
+三份文件共用同一后缀，例如 `Shader_20260914_163000.asecli-to-sgcli.spec.json`。`--name` 只修改图名称，不能用于文件命名。将实际生成的三份路径原样传给 SGCLI；不要合并、解包或改写 JSON。
+
+导出检查算法连接或已识别的数学等价映射、变量名、属性类型、默认值、范围、资源和 Shader 设置。已匹配的 AlphaModulate 可折叠到目标管线，输出路径保持一次调制；局部精度差异在 CLI 的 `precision_warnings` 和报告的检查证据中说明，不把整个图改成 Half，也不因缺少浮点逐位证明而阻断。错误连接、混合变化及无法映射的运行时属性仍会阻断。
+
+验收分三层：ASECLI 导出通过；SGCLI 契约/转换认证及真实创建通过；最终编译、画布与效果验收。前一层不代表后一层。最终视觉不是生成 JSON 的前置条件，未运行证据保持 `not_run`。消费者若返回 `SEM-BLEND-002` 等认证错误，应在 SGCLI 侧核对具体规则，不修改 JSON 或省略证据绕过认证。
+
 ASECLI 随 wheel 发布自己的 EditorGraphSpec v3 Schema，以及源自 SGCLI `0.3.5` 的固定 `sgcli.native.v3` JSON 快照。快照 SHA-256 标识本包完整性与精确协议修订，不依赖对方当前分支或安装版本。构建、测试、发布与安装只使用 ASECLI，不拉取或执行 SGCLI 源码，不要求同步发布。`MultiplySourceAlpha` 等扩展仍要求实际消费者和目标 URP 支持，导出成功不代表旧消费者兼容。跨产品端到端验收是独立黑盒流程，不是本仓发布前置；本仓任务不自动跨仓修改。
 
 可用 `asecli contract editor-graph --version 3 --spec FILE` 在不连接 Editor 时执行权威 Schema/loader 并返回原文件 SHA。报告分开记录来源快照、发布前复核、生产者 Schema 与真实消费者读取状态。旧 `{graph,report}` wrapper 只允许按已登记形状显式迁移，且内层必须已经是 `sgcli.native.v3`；无版本 discriminator 的旧输入只报告 `legacy_format`，不得伪称已识别版本化 Schema：
@@ -268,7 +285,7 @@ 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。 |
+| `export-sg <file> --out-dir DIR [--target-project PROJECT] [--output-suffix SUFFIX]` | 直接输出裸 `sgcli.native.v3`、独立转换报告和发布回执。 | spec 是唯一图规格；report/receipt 分别作为转换认证证据；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 或未知版本尾部。 |
@@ -340,9 +357,9 @@ asecli recompile Assets/Example.shader
 除显式 `--help` 保留人类可读文本外，stdout 恒为单行严格 JSON，agent 可直接解析。`--version` 也返回 JSON：
 
 ```json
-{"contract_version":1,"cli_version":"0.8.4","command":"parse","ok":true,"data":{"node_count":7}}
-{"contract_version":1,"cli_version":"0.8.4","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
-{"contract_version":1,"cli_version":"0.8.4","command":"version","ok":true,"data":{"version":"0.8.4"}}
+{"contract_version":1,"cli_version":"0.8.6","command":"parse","ok":true,"data":{"node_count":7}}
+{"contract_version":1,"cli_version":"0.8.6","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
+{"contract_version":1,"cli_version":"0.8.6","command":"version","ok":true,"data":{"version":"0.8.6"}}
 ```
 
 常见错误码：`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`。

{asecli-0.8.4 → asecli-0.8.6}/README.md

@@ -4,9 +4,9 @@
 
 AseCLI 是面向 AI Agent 的本地 CLI：离线读取、编辑和校验 ASE 节点图；通过运行中的 Unity/团结引擎与 MCP，让真实 ASE 创建节点、提供精排几何并重新生成 HLSL。Skill 提供跨 Agent 的操作规则，CLI 提供可验证的执行结果。
 
-当前正式版：**[0.8.4](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.4)** · [PyPI](https://pypi.org/project/asecli/0.8.4/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
+当前正式版：**[0.8.6](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6)** · [PyPI](https://pypi.org/project/asecli/0.8.6/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
 
-ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；独立 report 与发布 receipt 都不进入创建输入，创建成功也不代表转换效果等价。
+ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`，并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”；spec 是唯一图规格；独立 report 与发布 receipt 通过各自参数提供转换认证证据，创建成功也不代表转换效果等价。
 
 ```
 你：提需求（"给这个 shader 加个可调描边"）
@@ -108,7 +108,7 @@ curl -fsSL https://raw.githubusercontent.com/seeseeczl/ASECLI/main/scripts/insta
 uv tool uninstall asecli
 ```
 
-当前正式版本为 `0.8.4`（ASE→SG 诊断收敛、Custom Function 原样证据与 MZGUI 呈现分层），可从 [PyPI](https://pypi.org/project/asecli/0.8.4/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.4) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.3` 保留为回滚点。
+当前正式版本为 `0.8.6`（补齐 ASE→SG 三文件交接、时间后缀与验收边界说明；运行行为沿用 0.8.5），可从 [PyPI](https://pypi.org/project/asecli/0.8.6/) 或 [GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6) 安装。历史版本见 [GitHub Releases](https://github.com/seeseeczl/ASECLI/releases)，`v0.8.5` 保留为回滚点。
 
 已知限制：真实 MCP 下，属性+纹理 v2 和 Reciprocal 降级 v2 的 create、manifest、validate、独立 recompile 已通过；SGCLI SphereMask v3 spec 在重载时仍可能返回 `node missing after reload: Radius` 并回滚。本次不承诺该 recipe 端到端可用，也不改变 SGCLI v2 默认值契约。
 
@@ -138,7 +138,7 @@ asecli --help
 
 ```bash
 shasum -a 256 -c SHA256SUMS
-uv tool install /path/to/asecli-0.8.4-py3-none-any.whl
+uv tool install /path/to/asecli-0.8.6-py3-none-any.whl
 asecli --help
 ```
 
@@ -178,11 +178,28 @@ asecli recompile Assets/ConvertedNew.shader --mcp-url http://127.0.0.1:9080/mcp
 ```bash
 asecli export-sg Assets/ConvertedNew.shader --out-dir ./out
 sgcli sg create Assets/ConvertedNew.shadergraph \
-  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json
+  --spec ./out/ConvertedNew.asecli-to-sgcli.spec.json \
+  --conversion-report ./out/ConvertedNew.asecli-to-sgcli.report.json \
+  --publication-receipt ./out/ConvertedNew.asecli-to-sgcli.receipt.json \
+  --write
 ```
 
 `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`。
 
+需要保存在源文件同目录并添加时间后缀时：
+
+```bash
+asecli export-sg /path/to/Shader.shader \
+  --out-dir /path/to \
+  --output-suffix "_$(date +%Y%m%d_%H%M%S)"
+```
+
+三份文件共用同一后缀，例如 `Shader_20260914_163000.asecli-to-sgcli.spec.json`。`--name` 只修改图名称，不能用于文件命名。将实际生成的三份路径原样传给 SGCLI；不要合并、解包或改写 JSON。
+
+导出检查算法连接或已识别的数学等价映射、变量名、属性类型、默认值、范围、资源和 Shader 设置。已匹配的 AlphaModulate 可折叠到目标管线，输出路径保持一次调制；局部精度差异在 CLI 的 `precision_warnings` 和报告的检查证据中说明，不把整个图改成 Half，也不因缺少浮点逐位证明而阻断。错误连接、混合变化及无法映射的运行时属性仍会阻断。
+
+验收分三层：ASECLI 导出通过；SGCLI 契约/转换认证及真实创建通过；最终编译、画布与效果验收。前一层不代表后一层。最终视觉不是生成 JSON 的前置条件，未运行证据保持 `not_run`。消费者若返回 `SEM-BLEND-002` 等认证错误，应在 SGCLI 侧核对具体规则，不修改 JSON 或省略证据绕过认证。
+
 ASECLI 随 wheel 发布自己的 EditorGraphSpec v3 Schema，以及源自 SGCLI `0.3.5` 的固定 `sgcli.native.v3` JSON 快照。快照 SHA-256 标识本包完整性与精确协议修订，不依赖对方当前分支或安装版本。构建、测试、发布与安装只使用 ASECLI，不拉取或执行 SGCLI 源码，不要求同步发布。`MultiplySourceAlpha` 等扩展仍要求实际消费者和目标 URP 支持，导出成功不代表旧消费者兼容。跨产品端到端验收是独立黑盒流程，不是本仓发布前置；本仓任务不自动跨仓修改。
 
 可用 `asecli contract editor-graph --version 3 --spec FILE` 在不连接 Editor 时执行权威 Schema/loader 并返回原文件 SHA。报告分开记录来源快照、发布前复核、生产者 Schema 与真实消费者读取状态。旧 `{graph,report}` wrapper 只允许按已登记形状显式迁移，且内层必须已经是 `sgcli.native.v3`；无版本 discriminator 的旧输入只报告 `legacy_format`，不得伪称已识别版本化 Schema：
@@ -244,7 +261,7 @@ 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。 |
+| `export-sg <file> --out-dir DIR [--target-project PROJECT] [--output-suffix SUFFIX]` | 直接输出裸 `sgcli.native.v3`、独立转换报告和发布回执。 | spec 是唯一图规格；report/receipt 分别作为转换认证证据；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 或未知版本尾部。 |
@@ -316,9 +333,9 @@ asecli recompile Assets/Example.shader
 除显式 `--help` 保留人类可读文本外，stdout 恒为单行严格 JSON，agent 可直接解析。`--version` 也返回 JSON：
 
 ```json
-{"contract_version":1,"cli_version":"0.8.4","command":"parse","ok":true,"data":{"node_count":7}}
-{"contract_version":1,"cli_version":"0.8.4","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
-{"contract_version":1,"cli_version":"0.8.4","command":"version","ok":true,"data":{"version":"0.8.4"}}
+{"contract_version":1,"cli_version":"0.8.6","command":"parse","ok":true,"data":{"node_count":7}}
+{"contract_version":1,"cli_version":"0.8.6","command":"parse","ok":false,"error":{"code":"NOT_FOUND","message":"..."}}
+{"contract_version":1,"cli_version":"0.8.6","command":"version","ok":true,"data":{"version":"0.8.6"}}
 ```
 
 常见错误码：`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`。

{asecli-0.8.4 → asecli-0.8.6}/docs/00-governance/change-register.md

@@ -46,3 +46,4 @@ evidence: [docs/05-audits/2026-09-01-122217-optimization-tasks.md]
 | 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 仍不在范围。
+| CR-0031 | ASE→SG 已知算法等价与精度证据分层；属性保真复核和输出后缀 | MOD-CLI MOD-SG-EXPORT MOD-SKILL | 加性 precision_warnings、surface_semantics、custom_function_manifest 和 --output-suffix；sgcli.native.v3 与公共报告 Schema 不变；不声明视觉等价 | REG-0064 | 安装 asecli==0.8.4；保留用户 Shader 和导出文件 | 485 passed/3 skipped；实文件导出及 SHA 对账通过；发布候选 v0.8.5 |

{asecli-0.8.4 → asecli-0.8.6}/docs/00-governance/timeline.md

@@ -98,3 +98,6 @@
 | 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 |
 | 2026-09-14 | v0.8.1 双渠道发布与本机安装完成 | tag `v0.8.1` 解引用到 `610a7a3`；[publish run 34796442345](https://github.com/seeseeczl/ASECLI/actions/runs/34796442345) 的双 Python、可复现构建、供应链、锁定 SGCLI `b4f8310` 的跨 CLI 门禁与 PyPI OIDC 全绿。[GitHub Release](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.1) wheel/sdist 与 PyPI 摘要一致，本机 CLI 为 `0.8.1`，用户级 Skill 已同步；Editor/画布/render 保持开放披露。 | REL-0017 CR-0030 TASK-0066 REG-0063 |
+| 2026-09-14 | v0.8.5 发布准备 | 用户授权推送发布；本地 485 passed/3 skipped，实文件导出成功；算法/属性/设置门禁保留，精度边界提示；远端与双渠道校验待执行 | CR-0031 TASK-0067 REG-0064 REL-0018 |
+| 2026-09-14 | v0.8.5 双渠道发布完成 | tag cb80828；主线 CI 34823345703 与 publish 34823348963 全成功；GitHub 五资产回读与 PyPI SHA 一致，本机 0.8.5 和 Skill 校验通过；隔离回滚通过，Editor/视觉未运行 | CR-0031 TASK-0067 REG-0064 REL-0018 |
+| 2026-09-14 | v0.8.6 文档补丁准备 | 已按用户要求删除仓库内三份未跟踪实机副本；README 补齐三文件认证、--write、时间后缀和分层验收；运行行为不变 | CR-0031 TASK-0068 REG-0064 REL-0019 |

{asecli-0.8.4 → asecli-0.8.6}/docs/00-governance/traceability.csv

@@ -63,3 +63,4 @@ BUG-0023,缺陷,已修复,ADR-0020,MOD-BRIDGE,TASK-0060,REG-0059,2026-09-08 两
 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 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/画布/渲染仍开放
+CR-0031,变更,已发布,,MOD-CLI MOD-SG-EXPORT MOD-SKILL,TASK-0067,REG-0064,v0.8.5@cb80828；run 34823348963；双渠道 SHA 与安装回滚通过,REL-0018,long,数学映射与精度证据分层；视觉不作前置

{asecli-0.8.4 → asecli-0.8.6}/docs/01-architecture/module-map.md

@@ -6,13 +6,13 @@
 | 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 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-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 CR-0031 | 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 CR-0031 | 通用 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-SG-EXPORT | src/asecli/export_sg.py; src/asecli/sg_export | CR-0030 CR-0031 | 从 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 或建立跨仓运行时依赖 |
 
 ## 依赖规则
@@ -31,3 +31,7 @@
 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。
+
+### MOD-CLI / MOD-SG-EXPORT：CR-0031
+
+`export-sg --output-suffix` 只为 spec/report/receipt 文件名追加 ASCII 字母、数字、下划线或连字符，不改变图名称，默认空串且禁止覆盖。CLI 成功返回新增 `precision_warnings`、`surface_semantics`、`custom_function_manifest`；失败返回也携带精度提示。公共 spec/report Schema 保持不变，报告既有 evidence 字段保存精度边界，不将其标记为视觉已验证。

{asecli-0.8.4 → asecli-0.8.6}/docs/01-architecture/project-architecture-and-requirements.md

@@ -135,3 +135,7 @@ kickoff_completion: complete
 - [x] 技术路径与需求基线已经用户确认（本会话对话确认）
 - [x] 模块边界与依赖方向已定义并写入模块地图
 - [x] 首批 14 张任务卡与追溯矩阵已建立且双向链接
+
+## CR-0031 — 转换保真与精度边界
+
+导出必须保留算法或采用已认证数学映射，并对账变量名、类型、默认值、范围、资源和 Shader 设置。已识别 AlphaModulate 的局部浮点精度边界单独提示；浮点逐位或视觉未验证不阻断 JSON。错误连接、混合和无法表示的运行时属性继续失败关闭。关联 TASK-0067、REG-0064。

{asecli-0.8.4 → asecli-0.8.6}/docs/03-quality/regression-catalog.md

@@ -65,3 +65,4 @@
 | 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 未关闭，不得声明发布或视觉等价。 |
+| REG-0064 | CR-0031 | export-fidelity：已知算法折叠、精度提示、属性篡改拒绝、设置负例与后缀 receipt | `uv run --frozen pytest tests/test_export_precision_diagnostics.py tests/test_export_property_visibility.py tests/test_export_fidelity.py tests/test_surface_semantics.py` | 自动通过；私有真实 Shader 仅显式 opt-in，不作为公开 CI 必需输入 |

{asecli-0.8.4 → asecli-0.8.6}/docs/04-delivery/project-plan-task-charter.md

@@ -121,3 +121,5 @@ kickoff_completion: complete
 - [x] 64 张原子任务卡已定义；本次新增 CR/REG 双向链接完整（实机项保持待验）
 - [x] 里程碑、验收命令、停止条件与回滚已定义
 - [x] 门禁与审计计划已建立
+| TASK-0067 | CR-0031 REL-0018 | 发布 ASE→SG 精度提示与保真修复 v0.8.5 | 用户明确授权推送并发布 | 导出、报告、测试、Skill 与发布元数据 | SGCLI、源 Shader、Editor 与视觉验收 | long/2026-09-14 | REG-0064；pytest、治理、双构建、远端 CI、双渠道 SHA、隔离安装回滚 | 任一发布检查失败则停止 | 本地 485 passed/3 skipped；正式候选 484 passed/4 skipped；run 34823348963、GitHub/PyPI SHA、本机安装与回滚通过 | released |
+| TASK-0068 | CR-0031 REL-0019 | 清理本地实机副本并发布 README 说明补丁 0.8.6 | 用户授权丢弃三文件、更新 README、推送发布和本机安装 | 三个未跟踪文件、README 与版本发布记录 | 源 Tuanjie 资产、SGCLI 与运行逻辑 | long/2026-09-14 | REG-0064；文档 diff、发布治理、测试、双构建、双渠道 SHA 与安装回滚 | 发布检查失败则停止，保留 0.8.5 | 清理及 README 更新完成，发布验证中 | verified |

{asecli-0.8.4 → asecli-0.8.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asecli"
-version = "0.8.4"
+version = "0.8.6"
 description = "Agent-native CLI for reading, modifying, validating and compiling Amplify Shader Editor assets"
 readme = "README.md"
 requires-python = ">=3.10"

{asecli-0.8.4 → asecli-0.8.6}/skills/asecli/SKILL.md

@@ -26,7 +26,9 @@ description: Create, modify, validate, and strictly lay out Amplify Shader Edito
 
 - 先核对 CLI 路径/版本和源 SHA；当前 `.shader`、历史 `.bak`、旧 report 不可混为同一次转换证据。
 - 新版失败返回的顶层 `data` 包含 `blockers`、`blocker_count`、`unverified_checks`、源快照与 `surface_semantics`。它是本次检测清单，不保证穷尽所有潜在问题；旧版没有这些字段时读取 `report_json`，不要猜测只有一个阻断。
-- `ALPHA_MODULATE_TARGET_CAPABILITY_REQUIRED` 表示末端表达式不能安全折叠到 URP 的 half AlphaModulate；读取 `required_target_capabilities`，不得把 `MultiplySourceAlpha` 用于需要保留背景 Alpha 的源 Shader。
+- AlphaModulate 仅在表达式、Alpha 来源及 RGB/Alpha 混合方程匹配后折叠到目标管线，输出路径只调制一次。局部精度差异通过 `precision_warnings` / `ALPHA_MODULATE_PRECISION_BOUNDARY` 报告，不阻断导出；不得全局改为 Half，也不得把 `MultiplySourceAlpha` 用于需要保留背景 Alpha 的源 Shader。旧版 `ALPHA_MODULATE_TARGET_CAPABILITY_REQUIRED` 不是 SG 不支持 float 的证据。
+- 默认门禁检查算法映射、变量名、默认值、范围、类型、资源和 Shader 设置；最终视觉及浮点逐位一致不作为 JSON 发布前置，未运行的 Editor/效果证据保持 `not_run`。
+- 同目录时间后缀使用 `export-sg FILE --out-dir DIR --output-suffix _YYYYMMDD_HHMMSS`，同时命名 spec/report/receipt；`--name` 只修改图名称，不能替代文件名后缀。
 - 上游 Custom Function 作为目标 Custom Function 原样交接；用 `custom_function_manifest` 核对节点、精度和规范化函数载荷 SHA，不因 Agent 无法解释函数数学意义而拒绝。
 - 已确认的 `MZGUI.MZGUI`、Tooltip/Foldout/HelpBox 只影响 Inspector 呈现，列在 `presentation_warnings`，不阻断渲染语义交接。其他未知 Custom ShaderGUI 仍可能有材质副作用并失败关闭。
 - `retry_unchanged_input=false` 时不要重复相同导出、猜命令或找强制开关。报告缺失能力并停止；SGCLI 的新增能力必须通过公开 JSON 契约另行交接，不跨仓修补。

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/__init__.py

@@ -1,3 +1,3 @@
 """AseCLI — agent-native toolkit for Amplify Shader Editor assets."""
 
-__version__ = "0.8.4"
+__version__ = "0.8.6"

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/cli/export_sg_command.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import hashlib
 import json
+import re
 from pathlib import Path
 
 from ..contracts import validate_sgcli_native_spec
@@ -35,6 +36,7 @@ def configure_export_sg_parser(sub) -> None:
         help="target Unity project; defaults to the project containing the source Shader",
     )
     parser.add_argument("--name")
+    parser.add_argument("--output-suffix", help="filename suffix, e.g. _20260914_163000; does not change graph name")
     parser.add_argument("--asset-map")
     parser.set_defaults(func=cmd_export_sg)
 
@@ -42,7 +44,10 @@ def configure_export_sg_parser(sub) -> None:
 def cmd_export_sg(args) -> dict:
     source = Path(args.file).resolve()
     out = Path(args.out_dir).resolve()
-    spec_path, report_path = _conversion_paths(source, out)
+    suffix = getattr(args, "output_suffix", None) or ""
+    if suffix and not re.fullmatch(r"[A-Za-z0-9_-]+", suffix):
+        raise CliError("USAGE_ERROR", "output suffix must contain only letters, digits, underscores or hyphens")
+    spec_path, report_path = _conversion_paths(source, out, suffix)
     receipt_path = _receipt_path(spec_path)
     if not source.is_file():
         raise CliError("NOT_FOUND", f"file not found: {source}")
@@ -128,6 +133,8 @@ def cmd_export_sg(args) -> dict:
     write_result = _write_pair(spec_path, spec, report_path, report)
     return {
         "written": True,
+        "precision_warnings": internal.get("precision_warnings", []),
+        "surface_semantics": internal.get("surface_semantics"),
         "spec_json": str(spec_path),
         "report_json": str(report_path),
         "receipt_json": str(receipt_path),
@@ -135,13 +142,14 @@ def cmd_export_sg(args) -> dict:
         "connection_count": len(spec["connections"]),
         "source_sha256": internal["source"]["sha256"],
         "write": write_result,
+        "custom_function_manifest": internal.get("custom_function_manifest", []),
     }
 
 
-def _conversion_paths(source: Path, out: Path) -> tuple[Path, Path]:
+def _conversion_paths(source: Path, out: Path, suffix: str = "") -> tuple[Path, Path]:
     return (
-        out / f"{source.stem}{SPEC_SUFFIX}",
-        out / f"{source.stem}{REPORT_SUFFIX}",
+        out / f"{source.stem}{suffix}{SPEC_SUFFIX}",
+        out / f"{source.stem}{suffix}{REPORT_SUFFIX}",
     )
 
 
@@ -207,7 +215,8 @@ def _failure_details(report_path: Path, internal: dict | None, report: dict) ->
         "blocker_count": len(blockers),
         "blocker_scope": "detected_in_this_run_not_exhaustive",
         "presentation_warnings": warnings,
-        "warning_count": len(warnings),
+        "precision_warnings": internal.get("precision_warnings", []),
+        "warning_count": len(warnings) + len(internal.get("precision_warnings", [])),
         "custom_function_manifest": internal.get("custom_function_manifest", []),
         "required_target_capabilities": (internal.get("surface_semantics") or {}).get(
             "required_target_capabilities"

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/sg_export/decoder.py

@@ -1,7 +1,6 @@
 """Build an unbound SGCLI candidate from certified ASE semantics."""
 
 from __future__ import annotations
-
 from pathlib import Path
 
 from ..core import (AseFile, COMMENTARY_TYPE, GET_LOCAL_VAR_TYPE,
@@ -13,7 +12,7 @@ from .model import (
 )
 from .nodes import convert_node
 from .sources import compiled_properties, load_asset_map
-from .evidence import inspector_degradations, record_custom_functions, record_port, validate_template_passes
+from .evidence import mark_folded_functions, inspector_degradations, record_custom_functions, record_port, validate_template_passes
 from .surface_semantics import normalize_surface_outputs
 from .reconciliation import (
     groups, reconcile_shaderlab_properties, unique_properties, verify_texture_dependencies,
@@ -123,8 +122,9 @@ def build_candidate(
     for node in nodes:
         for target_id in node.source_ids:
             edges.append(SemanticEdge(node.target_id, 0, target_id, -1))
-    record_custom_functions(nodes, report)
+    record_custom_functions(nodes, report, _graph_precision(master))
     nodes, edges = normalize_surface_outputs(nodes, edges, target_spec, mappings, report, text)
+    mark_folded_functions(nodes, report)
     groups_spec = groups(ase, mappings, diagnostics)
     report["output_bindings"] = [
         {"block": edge.target_id, "port": edge.target_port}

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/sg_export/evidence.py

@@ -10,7 +10,8 @@ from .alpha_modulate import _strip_comments
 from .model import MASTER_TYPE, URP_UNLIT_GUID, URP_UNLIT_PASSES, diagnostic
 
 
-def record_custom_functions(nodes, report):
+def record_custom_functions(nodes, report, graph_precision=None):
+    report["source_graph_precision"] = graph_precision
     manifest = []
     for node in nodes:
         if node.target_type != "custom-function" or node.function is None:
@@ -102,3 +103,10 @@ def record_port(report, source_id, source_port, source_end, target_id, target_po
             row["ports"].append({"source": [source_id, source_port], "target": list(source_end)})
         if target_id in row["source_nodes"]:
             row["ports"].append({"source": [target_id, target_port], "target": list(target_end)})
+
+
+def mark_folded_functions(nodes, report):
+    remaining_ids = {node.target_id for node in nodes}
+    for item in report["custom_function_manifest"]:
+        if item["target_node_id"] not in remaining_ids:
+            item["mapping"] = "folded_into_target_pipeline"

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/sg_export/reconciliation.py

@@ -22,6 +22,40 @@ _TEMPLATE_PROPERTIES = {
 
 def reconcile_shaderlab_properties(compiled, properties, report, diagnostics):
     mapped = {row["name"] for row in properties}
+    for prop in properties:
+        name = prop["name"]
+        source = compiled.get(name)
+        if source is None:
+            diagnostics.append(diagnostic(None, "PROPERTY_FIDELITY_MISMATCH",
+                {"property": name, "field": "name"}, "Target property has no source declaration"))
+            continue
+        for attribute in source.get("attributes", []):
+            tag = attribute.split("(", 1)[0].strip()
+            if tag in {"Toggle", "ToggleOff", "KeywordEnum", "Gamma", "PerRendererData",
+                       "Enum", "IntRange", "Normal", "NoScaleOffset", "MainTexture", "MainColor"}:
+                diagnostics.append(diagnostic(None, "PROPERTY_ATTRIBUTE_UNSUPPORTED",
+                    {"property": name, "field": "attributes", "attribute": attribute},
+                    "Runtime property attribute has no certified target mapping"))
+        kind = prop["type"]
+        expected = {"type": source["type"], "default": source.get("default"),
+                    "range": source.get("range"), "hdr": source.get("hdr", False),
+                    "hidden": not source["exposed"], "exposed": True}
+        actual = {"type": kind, "default": prop.get("default"), "range": prop.get("range"),
+                  "hdr": prop.get("hdr", False),
+                  "hidden": prop.get("settings", {}).get("hidden", False),
+                  "exposed": prop.get("exposed", True)}
+        if kind in {"vector2", "vector3"} and source["type"] == "vector4":
+            expected["type"] = kind
+            expected["default"] = source["default"][:int(kind[-1])]
+        # Texture bindings are checked against GUID/importer snapshots separately.
+        if kind == "texture2d":
+            expected.pop("default")
+            actual.pop("default")
+        for field, value in expected.items():
+            if actual[field] != value:
+                diagnostics.append(diagnostic(None, "PROPERTY_FIDELITY_MISMATCH",
+                    {"property": name, "field": field, "source": value, "target": actual[field]},
+                    "Property runtime data changed during conversion"))
     for name, row in sorted(compiled.items()):
         if name in mapped:
             continue

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/sg_export/report_semantics.py

@@ -18,7 +18,6 @@ _VERIFIED_EVIDENCE = {
 _SEMANTIC_CODES = {
     "ALPHA_BLEND_UNREPRESENTABLE", "PASS_BLEND_UNPROVEN",
     "DUPLICATE_ALPHA_MODULATE_UNRESOLVED", "ALPHA_MODULATE_UNPROVEN",
-    "ALPHA_MODULATE_TARGET_CAPABILITY_REQUIRED",
 }
 
 
@@ -51,7 +50,6 @@ def _blend_details(name: str, internal: dict[str, Any] | None) -> str:
     rewrites = semantics.get("rewrites") or []
     matcher = (
         "unresolved" if semantics.get("unresolved")
-        or semantics.get("fold_precision", {}).get("status") == "unproven"
         else "folded" if rewrites
         else "preserved_graph_float_expression"
         if semantics.get("alpha_modulate_strategy") == "preserve_graph_float_expression"
@@ -63,4 +61,6 @@ def _blend_details(name: str, internal: dict[str, Any] | None) -> str:
         f" source={semantics.get('source_pass_blend')}"
         f" target={semantics.get('target_pass_blend')}"
         f" alpha_modulate=matcher-v4/{matcher}"
+        + "; precision_evidence=" + json.dumps(semantics.get("fold_precision"), ensure_ascii=False, sort_keys=True)
+        + "; algorithm verification excludes bitwise and visual equivalence"
     )

asecli-0.8.6/src/asecli/sg_export/surface_precision.py

@@ -0,0 +1,56 @@
+"""Record precision boundaries separately from certified algorithm rewrites."""
+
+import re
+
+from .alpha_modulate import _strip_comments
+
+
+def record_fold_precision(node, nodes, edges, report, semantics):
+    """Called only after expression, inputs and blend equations match.
+
+    A precision boundary is not a proof of bitwise or visual equivalence.
+    Explicit body types are evidence, not the effective type of a whole function.
+    """
+    declared = node.settings.get("precision", "Inherit")
+    graph = report.get("source_graph_precision")
+    inherited = declared in {"Inherit", "Graph"}
+    resolved = graph if inherited else declared
+    body = (_strip_comments((node.function or {}).get("body", ""))
+            if node.target_type == "custom-function" else None)
+    explicit = sorted(set(re.findall(r"\b(?:float|half)(?:[1-4])?\b", body or "")))
+    by_id = {item.target_id: item for item in nodes}
+    operands = [by_id.get(edge.source_id) for edge in edges if edge.target_id == node.target_id]
+    operand_precisions = [item.settings.get("precision", "Inherit") if item else "Unknown"
+                          for item in operands]
+    half_boundary = resolved == "Half" and (
+        (bool(explicit) and all(t.startswith("half") for t in explicit))
+        if body is not None else
+        (bool(operands) and all((graph if p in {"Inherit", "Graph"} else p) == "Half"
+                               for p in operand_precisions))
+    )
+    proof = {
+        "source_node_id": node.source_id,
+        "source_node_precision": declared,
+        "source_graph_precision": graph,
+        "inheritance_source": "graph" if inherited else "node",
+        "source_resolved_precision": resolved or "Unknown",
+        "source_explicit_types": explicit,
+        "source_operand_precisions": operand_precisions,
+        "source_expression": body,
+        "target_precision": "Half",
+        "target_function": "half3 AlphaModulate(half3 albedo, half alpha)",
+        "status": "matched_half_boundary" if half_boundary else "precision_difference_or_unknown",
+        "bitwise_equivalence": "not_proven",
+        "transformation": "fold_explicit_alpha_modulate_into_pipeline",
+    }
+    semantics["fold_precision"] = proof
+    if not half_boundary:
+        report.setdefault("precision_warnings", []).append({
+            "code": "ALPHA_MODULATE_PRECISION_BOUNDARY",
+            "source_node_id": node.source_id,
+            "classification": "precision",
+            "evidence": proof,
+            "impact": "Certified mathematical mapping preserves one modulation and blend factors; "
+                      "the pipeline half boundary may change rounding or representable range. "
+                      "Bitwise and visual equivalence have not been verified.",
+        })

{asecli-0.8.4 → asecli-0.8.6}/src/asecli/sg_export/surface_semantics.py

@@ -12,7 +12,7 @@ from __future__ import annotations
 from .alpha_modulate import inputs as alpha_modulate_inputs
 from .model import SemanticEdge, SemanticNode, diagnostic
 from .pass_blend import record_pass_blend
-from .surface_precision import fold_precision_verified
+from .surface_precision import record_fold_precision
 from .surface_matching import (
     _input_port,
     _native_alpha_modulate,
@@ -81,6 +81,11 @@ def normalize_surface_outputs(
             semantics.get("pass_blend_parser", {}),
             "The source Forward-pass RGB and alpha blend factors were not uniquely proved",
         ))
+    if (target.get("surface") == "Transparent" and (
+        semantics.get("rgb_blend_equivalent") is not True
+        or semantics.get("alpha_blend_equivalent") is not True
+    )):
+        return nodes, edges
     if not semantics["target_pipeline"]["implicit_alpha_modulate"]:
         return nodes, edges
 
@@ -95,9 +100,7 @@ def normalize_surface_outputs(
     native = _native_alpha_modulate(nodes, edges, color_edge, alpha_edge)
     if native is not None:
         modulate, color_input, alpha_input, route_nodes, white_node = native
-        precision_ok = fold_precision_verified(modulate, nodes, edges, report, semantics)
-        if not precision_ok:
-            return nodes, edges
+        record_fold_precision(modulate, nodes, edges, report, semantics)
         replacement = SemanticEdge(
             color_input.source_id,
             color_input.source_port,
@@ -185,9 +188,7 @@ def normalize_surface_outputs(
             "AlphaModulate alpha input differs from Surface Alpha",
         )
         return nodes, edges
-    precision_ok = fold_precision_verified(node, nodes, edges, report, semantics)
-    if not precision_ok:
-        return nodes, edges
+    record_fold_precision(node, nodes, edges, report, semantics)
     replacement = SemanticEdge(
         color_input.source_id,
         color_input.source_port,