Release PPT workflow 0.7.1 with portable installation and production components

USAGE.md

@@ -1,19 +1,57 @@
-# Use the standalone Skill
+# 使用指南
 
-Read [SKILL.md](SKILL.md), then explicitly select the supplied external template manifest and theme. Use the absolute Skill location; no installed companion Skill or original machine path is required.
+安装与升级见 [INSTALL.md](INSTALL.md)。开始任务时提供内容、用途、template 来源和 theme；沿用已确认选择。一次激活一个 template 和其中一个 theme，页面再选择 layout。没有模板来源时 Agent 会询问，不会猜一个全局默认模板。
+
+可以直接这样请求：
+
+```text
+使用 ppt-template-workflow。模板 manifest：/path/to/template/manifest.json，
+theme：THEME。根据附件制作可编辑 PPT，先设计并审阅第一页，通过后再继续。
+```
+
+```text
+使用 ppt-template-workflow。沿用本工程的模板与主题，
+把这份数据做成对比图表，保留真实数据、单位和来源，先给我审阅当前页。
+```
+
+```text
+将这个 PPT 工程整理为可版本管理、可多人按页协作的源码项目，
+保存数据、讲稿、素材、模板快照和构建入口，并验证移动后重建。
+```
+
+## 选择模板与制作页面
+
+命令中的 `PPT_PYTHON` 指向准备好的 venv Python，`PPT_SKILL` 指向安装目录。两者是本机命令变量，不写入可移植工程源码。Windows 的 venv Python 在 `Scripts/python.exe`，其他平台在 `bin/python`。
 
 ```sh
-python3 /path/to/skill/scripts/template_ref.py export-style \
+PPT_PYTHON=/path/to/venv/bin/python
+PPT_SKILL=/path/to/installed/ppt-template-workflow
+"$PPT_PYTHON" "$PPT_SKILL/scripts/template_ref.py" list --catalog /path/to/catalog.json
+"$PPT_PYTHON" "$PPT_SKILL/scripts/template_ref.py" inspect --manifest /path/to/template/manifest.json
+"$PPT_PYTHON" "$PPT_SKILL/scripts/template_ref.py" export-style \
   --manifest /path/to/template/manifest.json --theme THEME --layout LAYOUT
-python3 /path/to/skill/scripts/template_ref.py resolve \
+"$PPT_PYTHON" "$PPT_SKILL/scripts/template_ref.py" resolve \
   --manifest /path/to/template/manifest.json --theme THEME --layout LAYOUT \
-  --route native --workflow interactive-page
-python3 /path/to/skill/scripts/native_export.py \
+  --route native --workflow interactive-page --out /path/to/project/template-selection.json
+```
+
+Agent 读取导出的调色板、字体、网格、素材 paint 契约、结构和版式容量，按模板槽位制作当前页 SVG。页面库存在时先检查其设计思路、实现方法和预览，再适配；参考页不改变模板几何和审阅顺序。`resolve` 只绑定完整的正式模板，提案可以 `inspect`／`export-style`，不能绕过发行状态制作。
+
+```sh
+"$PPT_PYTHON" "$PPT_SKILL/scripts/native_export.py" \
   --manifest /path/to/template/manifest.json --theme THEME \
   --source /path/to/project/pages/page.svg --source-root /path/to/project \
   --output /path/to/project/exports/review.pptx
 ```
 
-The native exporter accepts released v2 templates, preserves the complete layout roster, and protects existing output. Prepare reviewed page SVGs using the template's slots, typography, grid and paint rules. Inspect actual rendering separately from native structure. See [native authoring](references/native-authoring.md), [PowerPoint checks](references/powerpoint-checks.md), and [project workspace](references/project-workspace.md).
+输出文件保护既有内容，修订时使用新路径。原生页面保留 Master／Layout／占位符；图表保留数据缓存和内嵌工作簿，表格保留单元格。图标按 SVG＋paint 的 palette／fixed／structural 通道处理。图表和表格示例位于 `assets/components/`，用法见[图表](references/charts.md)和[基础组件](references/components.md)。
 
-For a portable project, initialize an honest empty skeleton with `ppt_project.py init`. `prepare_native_project.py --project /path/to/project` explicitly copies a local builder/runtime into a clean skeleton. It neither installs dependencies nor updates the author lock automatically. The supplied builder consumes finalized SVGs and notes; data-driven page generation requires the author's explicit binding and build step. Provision the declared dependencies/fonts and verify a relocated rebuild before claiming portability.
+## 工程和协作
+
+需要可重建工程时，按[工程接口](references/project-workspace.md)执行 `ppt_project.py init`，为已定稿 SVG 准备 `prepare_native_project.py`，添加页面、讲稿及显式数据绑定，再 `lock`／`check`／`build`／`pack`。初始化只是骨架，不能把空工程当作完成的 PPT。
+
+协作时负责人固定页 ID、页序、风格和共用资源，参与者只修改分配的页面目录；负责人串行整合共享内容和锁。详见[页面分工](references/page-collaboration.md)。
+
+## 交付标准
+
+先核对当前页内容、布局、字体和实际预览，再报告原生对象、结构与应用证据。引用与哈希、原生结构、实际渲染、PowerPoint 编辑、投影和其他设备分别验证。无宿主能力时完成独立部分并说明具体缺口。逐页审阅、原生路线和用户已定选择优先；工程化或安装 Skill 不授予批量制作、提交、推送或发布权限。