# Boundary & Risk Card / 安装前决策卡

项目：0spoon/seamless

## 试用结论

## 安装验证层级

- 📄 引用自官方文档/README 的安装路径，未经 Doramagic 沙箱验证。
- 本 pack 已通过 Doramagic 的元数据与内容质量检查，但安装命令本身没有在这里被执行过。
- 首次安装请先在隔离环境（临时目录、容器或一次性宿主）中跑通这些命令，确认无误后再进主力机器。

## 用户现在可以做

- 可以先阅读 Human Manual，理解项目目的和主要工作流。
- 可以复制 Prompt Preview 做安装前体验；这只验证交互感，不代表真实运行。
- 可以把官方 Quick Start 命令放到隔离环境中验证，不要直接进主力环境。

## 现在不要做

- 不要把 Prompt Preview 当成项目实际运行结果。
- 不要把 metadata-only validation 当成沙箱安装验证。
- 不要把未验证能力写成“已支持、已跑通、可放心安装”。
- 不要在首次试用时交出生产数据、私人文件、真实密钥或主力配置目录。
- 不要在主力宿主 AI、主力 repo 或主力机器上直接安装。

## 安装前检查

- 宿主 AI 是否匹配：mcp_host, claude_code, claude, codex
- 官方安装入口状态：已发现官方入口
- 是否在临时目录、临时宿主或容器中验证：必须是
- 是否能回滚配置改动：必须能
- 是否需要 API Key、网络访问、读写文件或修改宿主配置：未确认前按高风险处理
- 是否记录了安装命令、实际输出和失败日志：必须记录

## 当前阻塞项

- install_not_sandbox_verified
- quick_start_not_verified
- review_required: documented_install_not_sandbox_verified

## 项目专属踩坑

- 能力证据存在缺口（high）：缺口未补前，Doramagic 不能把该能力当作可靠推荐卖点。
- 可能需要本地编译工具链（medium）：Windows/macOS 用户可能卡在编译依赖上。
- 失败模式：installation: v0.3.1（medium）：Upgrade or migration may change expected behavior: v0.3.1
- 失败模式：installation: v0.3.2（medium）：Upgrade or migration may change expected behavior: v0.3.2
- 失败模式：installation: v0.3.3（medium）：Upgrade or migration may change expected behavior: v0.3.3

## 风险与权限提示

- no_demo: medium

## 证据缺口

- 暂未发现结构化证据缺口。