---
name: realsee-spatial-analysis
description: 以如视 Work 为主索引、伽罗华目录产物为精度补充，解释资源用途与关联，完成适用空间理解分析并交付结果与报告；用户选择开发后，配合 vr-cli 和空间智能 Viewer 预设、开发规范与验收规则交付应用。客户可以只有数据包，也可以已有 vr-cli 项目；有项目且 BFF 已配对时，`work.json`/`floorplan.json` 默认从项目 `GET /api/work/<RC>` 物化，本地数据目录可选。
---

# 如视空间理解

## 0. 标准任务：一句话触发

用户在 vr-cli 项目中（或显式给出 `<app>`）给出 `<RC>`（可选本地 `<data>`），只说“用 realsee-spatial-analysis 做空间理解分析”时，按 [标准任务契约](references/standard-run.md) 先执行盘点和只读预检。所选档位和下载范围确认后，核对点位与坐标，执行适用分析，交付 v2 JSON、中文报告、图谱和预览，并回装 `<app>/analysis-data/<RC>/` 验证「空间智能」入口。不要要求用户重贴步骤、命令或验收清单；按契约说明缺项和影响。

**选档是对话停止点**：`mode: "choose"`、`awaitingChoice: true` 或 `choice.requiresUserChoice: true` 表示把预检结论和可选方案发给用户，提出明确选择问题，并结束当前轮等待回复。A 使用已有数据做精简分析（交代能出房间还是仅点位），B 补数据后再分析，C 暂缓。付费补数据只在接口可用时作为选项说明。即使只有点位档能立即执行，也须等待用户选择。仅给资源码、说「分析」「继续」「能做的先做」和同意下载均不足以选择降档。用户明确选择精简档后才传 `--inputs work-only`，此前只做只读预检和必要的 Work 物化。

**资源码与输出目录**：`--resource-code` 必须与 `resources/` 下的目录名逐字一致（`pipeline.py all` 在开头核对，写错会给出相近的资源码并退出）；输出统一放 `analysis-output/<RC>`（已在模板 `.gitignore` 与 `.prettierignore` 里），不要另起 `spatial-analysis-out/` 之类的目录。

**消费层属于本 skill，只在分析之后接入**：`vr-cli create` 出的工程默认没有 HUD/BFF，这是预期；`pipeline.py all` 的最后一步（应用回装）会给 `apply_analysis.py` 传 `--write --wire`，缺消费层就先跑 `scripts/wire_host.py`（安装插件并改 vite/BFF/App），不要手改这三个文件；单独补接线也用它。回装规则见 [已有项目接入](references/my-app.md)。

**回装是默认交付动作，不是用户的参数配置任务**：在 Viewer 工程或其子目录发起时，脚本自动识别工程并在分析成功后接入结果；不再问「是否回装」，不要求用户理解或输入 `--app` / `--replace` 等命令开关。完成后用人话告知「分析完成，结果已回装到 Viewer」；没有项目就交付报告与数据，用户明确只要报告时由 agent 内部使用 `--no-apply` 跳过回装。重跑会自动更新安装记录匹配的结果；被用户修改或未受安装记录管理的已有文件保留，新分析仍交付并说明未回装原因。

**取 Work 只有一种做法**：有 vr-cli 项目且已配对时，首次获取或需要刷新 Work 时运行 `scripts/materialize_work_inputs.py --resource-code <RC>`（走项目 `GET /api/work/<RC>`），不要自己写脚本调开放平台，也不要因为资源目录里没有 `work.json` 就走 `--no-work`。

**默认输入**：在 vr-cli 项目中发起时，`<app>` 默认就是当前项目目录，脚本可直接省略 `--app`（跨项目时再显式指定）；先物化输入，而不是要求客户提供数据目录。项目 BFF 已配对并启动（`npm run setup`、`npm run dev`）时，运行 `scripts/materialize_work_inputs.py --resource-code <RC>`，从项目 `GET /api/work/<RC>` 取得 `work.json` 与可选 `floorplan.json`（`capabilities.modelFloorplan.data`），保存于 `<app>/resources/<RC>/`。没有目录时由脚本创建。经开放平台 API 获取的全景、模型与点云也存入同一资源码目录。后续分析可复用这里的同资源数据，报告和分析输出仍写独立的 `analysis-output/<RC>/`。显式提供的离线 `<data>` 保留原件。只传裸 `work.json` 时，管线会自动在它同目录找 `work-envelope.json` / `floorplan.json` 补上平面图（房间与门洞），仍缺失时 `inspect` 的 `components.floorplan.present=false` 并给出退化提示，`overview.rooms`/`doors` 退回 `source=geometry`。

第一版以**伽罗华设备产物**为基准，暂不处理 RAW。客户可以只有数据包，也可以已有基于 vr-cli 的项目；两种情况下都**不假定客户有此仓库、现有 Viewer、开发服务、历史结果或缓存**。流程是：**认识数据 → 理解关联 → 执行适用分析 → 交付结果和报告 → 引导后续应用开发**。客户可以只提供部分产物；不要求先有 Work 或资源码。设备型号不代表某项产物一定存在。

默认以用户指定的主 `work.json` 为基础，先识别其全景/六面图、模型或点云资源；目录其他产物是更详细或更精确的补充。先读 [Work 优先策略](references/work-first.md)，验证后再把补充数据注册到主 Work，不能反过来要求全套本地素材才能使用 Work。

完整 skill 发行包自带 `runtime/analysis/spatial_analysis` 分析源码、依赖清单与结果校验器；**不是把此项目交给客户**。Python 环境、推理权重与客户选择的输入能力仍需检查，不能声称已随包安装。`scripts/inventory.py` 仅需标准库，重分析通过 `scripts/pipeline.py` 调用随包引擎。Five / vr-cli 是结果交付后的可选开发路线。

## 1. 盘点本次交付

先读 [数据指引](references/data-guide.md) 和 [伽罗华产物说明](references/products.md)。读取可用的交付清单、格式版本与元数据，确认目标、采集/重建范围和实际文件。目标未明确时先完成盘点、用途说明与可行性建议，不自行启动全量推理。

有项目时默认先物化 Work 输入（见第 0 节）；下面是本地数据包的直接盘点命令。

```bash
# Python 3.10+，仅标准库；扫描已下载目录，不上传、不下载、不修改原件
python <skill-dir>/scripts/inventory.py --root <交付目录> --work <交付目录>/work.json --out <输出目录>/inventory.json
```

输出是**文件/结构候选清单**，不是格式验证、已对齐或算法可运行的证明。逐项补充单位、坐标系、站点身份、模型依赖和格式证据；扫描不完整时先说明覆盖范围。没有 Work 时用本地 datasetId，不伪造 resourceCode。

对每类数据回答：它是什么、能做什么、如何读取、需要哪些伴随文件、与什么关联、哪些用途受限。`references/products.md` 区分“已说明/待确认”；六视图、HDR 等格式未明确时只给条件路径。

有六视图时读 [cube 使用与对应](references/cube.md)，检查每组六面、尺寸与来源版本；编号不能直接当采集站点或 Work panoIndex，跨点位子集单独验证映射。

## 2. 选择输入与分析路径

按 [分析路径](references/workflows.md) 选择目标需要的最小输入，不因缺少无关产物拒绝整个任务。

| 客户持有的数据          | 优先完成                                      | 必须保留的边界                                    |
| ----------------------- | --------------------------------------------- | ------------------------------------------------- |
| 只有 Work               | 结构/资源说明、点位关联、受支持的 Web VR 展示 | 资源引用不代表原件已下载；不保证每类图层都有      |
| 只有全景/普通图像       | 图像浏览、二维识别/OCR/内容索引（有工具时）   | 无深度/几何/尺度不能输出可靠三维位置与米制尺寸    |
| 只有点云或模型          | 格式与坐标检查、几何候选分析                  | 单位/尺度不明时只给原生单位；不保证语义和可通行性 |
| 只有六视图              | 确认生成源、投影/相机依赖与可行用途           | 模型六视图不等同全景 cubemap                      |
| 全景 + 位姿 + 深度/几何 | 多视角对应、二维结果提升到三维                | 先验证站点、投影、遮挡与坐标变换                  |
| 多种同源产物            | 对齐、房间/物体/测量/导航等所需分析           | 每个任务单独检查输入，不把完整管线当必选项        |

任务状态取 `ready`（依赖和工具已验证）、`conditional`（列出待验证项）或 `blocked`（列出最小缺失输入）。另标实现来源 `bundled-pipeline` / `agent-tool` / `adapter-required`；概念上可做不等于已实现，已实现不等于本机可运行。

## 3. 建立可查询的数据关联

读 [关联与坐标](references/relationships.md)。主 Work 为根，先展开其点位、全景/六面和模型图层，再把目录补充按身份/坐标关联到这些实体。缺少主 Work 时才以本地交付为根，进入降级路径。

记录身份键、出处、源/目标坐标系、单位、变换方向、验证方法、覆盖率和误差。文件名相似、索引相同、视觉叠加都不能直接证明对应。跨重建只用已验证映射，不沿用旧证据冒充新测量。

3DGS 可来自同一空间的另一项目：独立盘点身份与坐标，按 [人工对齐](references/manual-3dgs-alignment.md) 选择对应点或使用人工变换，验证后再作为可选基础数据参与对照。无 3DGS 则跳过，不阻塞其他数据分析。

输入满足时使用随包丰富图谱；有主 Work 时明确传入，不能默认只扫补充目录。字段与状态见 [图谱接口](references/graph.md)：

```bash
python <skill-dir>/scripts/pipeline.py graph --resource-code <主Work身份> --work-json <主Work.json> --resources-root <数据父目录> --workspace <输出目录> --no-analysis --out <图谱目录>
python <skill-dir>/scripts/pipeline.py graph query --graph <图谱目录>/data-graph.json --id <实体ID>
```

该命令不是任意文件夹的通用图谱生成器。部分产物路径按 `references/relationships.md` 交付轻量关联数据，使用独立 schema，不能冒充 pipeline 的 `data-graph.json`。

没有主 Work 时才改用本地数据ID和 `--no-work`。补充点位多于主 Work 时先做子集/版本注册，不能把目录索引直接当主 Work panoIndex，也不能直接送入要求同源同点位的完整 run。

## 4. 执行与交付

按选定任务运行可用工具，保留参数、版本、输入引用、检查结果和未评估项。识别类别是推断；三维框不是分割轮廓；3DGS 的显示/拟合残差不能直接当测量精度。长时推理先给小样预览，再扩大覆盖。

最小交付是 `inventory.json` + `data-guide.md`，说明实际输入、用途、关联、可做/不可做及下一步。需要分析时再交付 `relationships.json`、`results.json` 和 `report.zh-CN.md`，按 [输出与应用交接](references/application-handoff.md) 保留证据、误差和可信度。未执行的任务写未执行，不填虚构数值。可另用 `scripts/render_result.py` 把 v2.2 结果渲染成单文件 HTML 预览，方便业务方直接打开查看，但它不是交互 Viewer；若同时有 pipeline 生成的 `data-graph.json`，加 `--graph` 才能把站点位姿、实体关系、溯源与读取配方并入预览；有 `floorplan.json` 时加 `--floorplan` 补画完整墙体轮廓。

结果交付后，向客户介绍 [@realsee/vr-cli](https://www.npmjs.com/package/@realsee/vr-cli)、可开发能力及 [应用交接](references/application-handoff.md)。有 `<app>`（vr-cli 项目）时，[标准任务](references/standard-run.md)的默认目标 4 是**应用回装**：把结果包写入 `<app>/analysis-data/<RC>/` 并验证「空间智能」入口；这是交付的一部分，不需要额外的“开发授权”。只有没有项目（只交付数据与报告）、或用户明确只要分析/报告时，才在结果交付后停止。

回装分两种情况：

- 项目已具备空间智能 UI/BFF，或已安装 `@realsee/spatial-intelligence` 插件：在项目目录运行 `scripts/apply_analysis.py --write`（写入前自动校验，不过不写），再验证入口。
- 项目是普通 vr-cli 项目（缺消费层）：按 [已有项目接入](references/my-app.md) 先安装随包插件 `<skill>/plugin`（`@realsee/spatial-intelligence`）并完成文档中的最小接线，再写入结果包；插件安装与最小接线属于回装步骤，只增加依赖和接线，不重建、不覆盖用户项目。安装命令固定为项目内相对路径 `npm install file:.agents/skills/realsee-spatial-analysis/plugin`，它是 `AGENTS.md` 允许的唯一非注册表依赖，不与「`>=` 最低版本」规则冲突，**不需要为此暂停确认**。用户明确拒绝改代码时，才改为只交付结果并写明未回装原因。

默认基于用户已有的项目回装，不要为分析另建 Viewer。只有用户手里没有任何项目、并明确要一个带完整空间智能 UI 的 Viewer 时，才读 [空间智能 Viewer 预设](references/viewer-profile.md)，以 vr-cli 新建项目，应用随包的版本化 Viewer 组件（差异源码，需 vr-cli >= 0.4.0 且模板契约一致）与当前分析结果，再完成静态、构建和浏览器验收。

客户无需当前示例项目，但开发后的目标效果、规则和验收口径与示例同源。

## 5. 调用随包分析引擎

读 [引擎输入](references/pipeline-inputs.md)、[分析实现](references/analysis.md) 与 [环境准备](references/pipeline-setup.md)。调用前先按环境准备发现已有解释器（`check_env.py --json` 的 `pythonCandidates` / `suggestedPython`），优先复用；确认本机没有 3.12 后，再按参考文档的平台常规方式创建独立 venv，不要修改系统 `python3` 或复刻开发机环境。所有输入和输出目录显式指定，不复用开发机器的环境、缓存或服务；有项目时先用 `scripts/materialize_work_inputs.py` 从项目 BFF 物化 `work.json`/`floorplan.json`，无项目时用本地数据目录。数据ID可以是合法的本地目录名，不代表伪造线上资源码。

```bash
python <skill-dir>/scripts/check_env.py --json
python <skill-dir>/scripts/pipeline.py inspect --resource-code <数据ID> --resources-root <数据父目录>

# 完整层级需要检测权重（默认 owlv2-base-ensemble，约 620 MB，一次性下载；未缓存时和缺失的实体数据一起确认一次，装依赖/E57 读取库并入这次确认）
python <skill-dir>/scripts/pipeline.py fetch-model   # 默认缓存在用户级缓存目录（macOS/Linux: $XDG_CACHE_HOME 或 ~/.cache，Windows: %LOCALAPPDATA%）下的 realsee-spatial-analysis/hf，可用 --hf-home 覆盖；venv 同理在 realsee-spatial-analysis/venv，均不必询问用户

# 本地只有 Work，但 Work 声明了 panorama.list / model.layers[].tileset_url：
# 先把声明资源落到本地资源目录（cube→equirect、mesh tiles→OBJ、Work poses→S）
python <skill-dir>/scripts/prepare_work_assets.py --work-json <客户Work.json> --floorplan <floorplan.json> --out <资源父目录>

# 完整层级（默认）：不传 --inputs 即 auto，产出 objects / 层高 / 净空 / 可通行栅格
python <skill-dir>/scripts/pipeline.py run --resource-code <数据ID> --work-json <客户Work.json> --resources-root <资源父目录> --workspace <输出目录>

# 输入口径差异（例如点云头位姿与 Work 位姿系统性差 6 cm）让某条检查超阈值时，按已确认的差异放宽该检查，不改引擎代码：
python <skill-dir>/scripts/pipeline.py run ... --waive A3.translation=0.07 --waive A3.rotation=0.01
# 豁免写进 run-manifest.thresholdOverrides（可用 A3 这样的前缀一次覆盖一组）；只放宽该条检查的通过/致命档，
# 不关闭检查，值再超出豁免阈值仍然失败；导出成功后引擎自动在 analysis-decisions.json 写一条决定
# （放宽值、实测值、决定人）。--waive-reason 写依据，用户明确同意时加 --waive-by user；不要改发行包里的引擎源码
```

一条命令走完全部流程（预检 → 确认门 → 物化 → 权重 → run → deliver → apply）：

```bash
# 普通用户：不带参数运行，进入问答向导（预检 → 选范围 → 执行 → 结果摘要）
python <skill-dir>/scripts/pipeline.py

python <skill-dir>/scripts/pipeline.py all --resource-code <数据ID> --resources-root <资源父目录> --workspace <输出目录>
#   ↑ 只做只读预检并输出计划，然后停下等确认
python <skill-dir>/scripts/pipeline.py all ... --yes             # 确认下载清单（缺的全景图/模型/点云 + 检测权重）后继续；没有要下载的就不用加
python <skill-dir>/scripts/pipeline.py all ... --no-model        # 不下载某类实体：--no-panoramas / --no-model / --no-point-cloud；全不下载用 --inputs work-only

# 降级层级：只有 Work + 可解析平面图且已确认不需要物体/几何，恒为 objects: []
python <skill-dir>/scripts/pipeline.py run --inputs work-only --resource-code <数据ID> --work-json <客户Work.json> --workspace <输出目录>

python <skill-dir>/scripts/pipeline.py quality --resource-code <数据ID> --workspace <输出目录> --report <report.md>
```

交付产物（图谱、预览页、盘点、输入快照、交付说明与数据指引）一条命令补齐，幂等，可反复运行：

```bash
python <skill-dir>/scripts/pipeline.py deliver --resource-code <数据ID> --workspace <输出目录> --resources-root <资源父目录>
python <skill-dir>/scripts/pipeline.py run ... --deliver     # run 之后自动补齐交付产物
python <skill-dir>/scripts/pipeline.py deliver ... --verify    # 按 delivery-manifest.json 校验交付产物未被改动
```

交付前会核对图片：`deliver` 的 `images` 步扫描顶层及 reports/、graph/ 下 Markdown/HTML 的实际图片引用（忽略脚本中的动态模板）（必须存在、非空、文件头是真实图片），并数 PDF 的 `/Subtype /Image`；说明里声称「N 张图」而 PDF 一张图都没有时退出码为 1（`PDF_IMAGES_MISSING`）。修法：把图真的画进 PDF 或换成带图的 HTML/PNG，并同步改掉「N 张图」的表述；`deliver --check` 也会列出图片缺项。

交付清单里也有 `data/<RC>/analysis-decisions.json`：阈值放宽（`--waive`）与选择项的决定人、依据都在这里，回装时随之写入 `analysis-data/<RC>/`。放宽后的阈值同时出现在 `generator.params` 的 `checks.waived.<id>`；「已放宽」「对齐偏差」这类质量与告警信息只放在报告（`report.zh-CN.md` 结论段）和结果预览（质量校验页）里，**Viewer 的分析面板不展示**；也不要在应用代码里写死某次运行的阈值、报告原文或豁免结论（重跑就会过期）。

**档位必须由两个独立证据决定，不能互相替代**：

- 数据侧：`pipeline.py inspect` 的 `layout` / `missing` / `degraded`——回答“产物在不在”；
- 环境侧：`check_env.py` 的 `missing['work-only']` 与 `missing['full']`——回答“本机能不能跑”。`ok` / `workOnlyOk` 只表示 work-only 档就绪，`fullOk` 才表示完整档依赖齐备（模型权重仍需单独 `fetch-model`，默认检测器 `owlv2-base-ensemble` 约 620 MB；缺权重时 `run` 会在重阶段前以 exit 4 失败，详见标准任务契约 C 段）。

`prepare_work_assets.py --dry-run --json` 的 `capabilities.summary` 与 `capabilities.blockers` 是动手前的第一判断：`LEGACY_AT3D_MODEL`（model 只有 `file_url` 的 `.at3d` 兼容字段）、`NO_GEOMETRY`、`NO_FLOORPLAN` 说明哪些数据当前缺失。缺三角网格时解释完整档的几何限制；没有平面图时说明精简档只出点位。把精简分析、补数据或暂缓交给用户选择，即使当前只有点位档可立即执行。同一份输出里 `capabilities.data.sourceClass` 说明数据从哪来（只有 Work、按声明 URL 下载；Work + 自备数据包；Work + 开放平台 API 数据包，见下文），`capabilities.data.floorplanBasis` 说明户型依据（`work` 平面图 > `local` floorplan.json > `geometry` 几何推算）；有平面图就以平面图为准，只有几何推算时报告与交付说明必须写明「户型依据：几何推算」，不得说成图纸房间。

`run` 不传 `--inputs` 时默认就是完整层级；`--inputs work-only` 是主动降级，恒为 `objects: []`、`ceilingHeightM: null`。**先看数据侧：Work 声明了 panorama / mesh / point_cloud 时，必须先用 `prepare_work_assets.py` 落成本地资源，再跑完整层级；不能因为客户只给了 work.json 就默认 work-only。** 用户明确选择精简分析后才传 `--inputs work-only`；有同源平面图时可出房间，只有点位时只出点位。降级必须写明原因属于“环境/时间成本”还是“输入缺失”，**不得把依赖或权重缺失表述为数据不支持**；完整层级的权重来源（含镜像源）在报告中披露。缺少深度图或 3DGS 只让 D1、G1 变为不可用，不阻塞完整层级。

`prepare_work_assets.py` 需要已授权的 Work 资源下载；它会校验 Work 声明的 `panorama.list`、`model.layers[].tileset_url`（含 `type=point_cloud` 的 PLY 点云层），不伪造缺失资源。**物化前先跑 `inspect`（看 `declaredNotLocal`）与 `prepare_work_assets.py --dry-run --json`（站数/面数/tile 数/HEAD 字节数），再用一次带选项的对话确认下载范围，并用 `pipeline.py decide add --point inputs` 记录选择；用户已指定、缓存命中、本地资源已齐（`needsMaterialize` 全为 false）或 Work 未声明资源时不问，也不要把「Work 资源下载」列为待确认项。**预检的 `capabilities` 给出档位判定，**最少需要什么数据见 [minimum-data.md](references/minimum-data.md)**。缺数据时**不自行降档**：`pipeline.py all` 输出 `mode: "choose"` 与可选档位（各缺什么、怎么补、要跑的命令），由用户选 A 用 work-only / B 补数据再跑 / C 停下；向导里问一次。`--inputs full` = 要求完整档、缺数据即 exit 6 `FULL_TIER_UNAVAILABLE`（`all` 与 `run` 同义）；`--inputs work-only` 只读 Work：有平面图出房间，没有平面图只用 `observers[]`（`index` + `position`，`quaternion` 可选）出点位间距、包络与相对朝向，不下检测权重、不读资源根。`--inputs pano-only` 是旧名，等同 work-only。连平面图与 `observers` 都没有才以 `NO_BUILTIN_TIER` 退出 6。`run` 也一样：不传 `--inputs` 而本地只有点位时，它同样输出 `mode: "choose"` 与三条路（不再以 `RESOURCE_NOT_READY` 直接退出）。下载/物化失败也不再自动改档，而是停下来给出「修好重试」与「显式降档」两条路。

**开放平台下载接口是第三种拿法，计费，只在用户同意后用**：Work 没有网格或全景（典型是只有 `.at3d`）、本地也没有时，缺数据的 `choose` 输出里 `choice.apiDownload` 会列出经项目 BFF 的资源下载接口获取的产物与计费说明；用户同意后加 `--api-download`（只补完整档缺的网格 / 全景）重跑，先出计划；`--yes` 只确认下载清单，提交（计费）还要用户明确同意后再加 `--confirm-billing`。额外要 E57 点云用 `--api-products point_cloud`。任务号先落盘，重跑只续查不重复提交；提交结果未知、任务失败或过期时不自动重提，由用户决定后加 `--resubmit`。不要自己写脚本调开放平台。细节见 [开放平台下载接口](references/download-api.md)。

**重跑不重复索取已经确认的方位**：脚本会在参考点位未变时复用已保存的输入；补齐平面图也不需要重新确认。先前只有点位时，补齐平面图后可在同一工作区直接升级出房间，工具会同步刷新盘点、报告和数据指引。

**方位要用户确认，不要从“进门正对西方”这类描述里推断绝对值。** 只需确认一次：首点位（0 号）打开全景时的初始视角对着哪边，用 `--compass-deg <0-360>`（默认参考点位就是首点位，不用给 `--pano-index`；`all` 会先落 `inputs/orientation.json`），引擎据此写 `frame.orientation`（含 `northOffsetDeg` 与“未做地理北校准”的 `caveat`），其余点位与房间自动换算 `compassDeg`、`sector`（八方位）。用户不确认时不要猜：报告与交付说明会写「方位（未指定）」——角度只相对首点位视角、没有地理北、房间朝南/朝北与图纸对齐都不可用，此时**不得写“坐北朝南”之类的绝对结论**。`run` 默认在 Work 声明的全景或网格尚未物化且点位档可用时，返回 `choose` 并列出实缺项。显式选择完整档仍以 `FULL_TIER_UNAVAILABLE` 退出 6。`work-only` 有平面图时出房间；没有平面图时只出点位，连可用点位也没有才退出 6。**只有数据包不等于一定带 Work**：没有 Work 时仍完成盘点、数据指引、适用的独立分析和 `graph --no-work`；不能把另一项目的 3DGS Work 当主采集 Work，不为通过命令而伪造 Work。需要额外输入的任务明确列最小缺失项，由 agent 用已验证的独立工具或适配器完成可做部分。质量规则见 [quality.md](references/quality.md)，决策记录见 [decisions.md](references/decisions.md)。

## 6. 数据与执行边界

- 原件只读，派生数据写独立输出目录，不覆盖 Work、客户素材或既有结果。
- 盘点脚本不联网，不输出 Work 的签名、证书、凭据或资源 URL。目录/文件名仍属于本地客户数据，交付前按受众审阅。
- 推理默认本机执行；下载、第三方处理或发布需要已有明确授权，不能由“做分析”推导出素材外传许可。
- 可选 Work 经客户授权的服务端获取，AK/SK、token 留在服务端；不假定 `127.0.0.1:8088` 或任何现有 BFF 存在。发行包不继承示例项目的下载授权或历史验证结果。
- 不把单份样本的目录、坐标、残差或设备能力写成保证。其他设备先核格式再复用流程；RAW 不进入本版分析。

完整 skill 发行包和开发者用套件的区别见 [套件打包](references/package.md)。
