# 3Dviz Pro Max skill 安装记录（DSH）

- 日期：2026-10-24 02:03（北京时间）
- 结论：**已安装并验证可用**，DSH 已热发现，无需重启、无需新开会话。

## 1. 装在哪

| 项 | 值 |
|---|---|
| 安装路径 | `/vol1/ai/home/.dsh/skills/3dviz-pro-max/`（DSH 用户级技能目录，`DSH_HOME=/vol1/ai/home/.dsh`） |
| 内容 | 805 个文件 / 9,830,277 B（约 9.4 MiB，磁盘占用 12 MB） |
| 入口 | `SKILL.md`（name: `3dviz-pro-max`，description 与上游一致） |
| 权限 | `drwxr-xr-x root:root`（与其他用户级技能一致） |

未装第二份：`/vol1/ai/home/.agents/skills/` 与项目级 `.dsh/skills/` 都**没有**放副本，避免「同一技能两份、agent 读到旧版」。

## 2. 来源

| 项 | 值 |
|---|---|
| 仓库 | https://github.com/viettranx/3dviz-pro-max |
| 版本 | 0.1.0（`data/catalog-summary.json` 的 `version`） |
| 提交 | `d077e0e68915c25be8e71d74684d3144fd1c2aca`（2026-09-11，`fix(examples): keep readout chips where the study has room`） |
| 许可证 | MIT（代码/数据/自制媒体；BodyParts3D 解剖网格为 CC BY-SA 2.1 JP，字体 SIL OFL 1.1） |
| 安装方式 | `git clone` 后把**完整** `skills/3dviz-pro-max/` 目录整包拷入（不是只拷 `SKILL.md`） |

## 3. 校验证据（都实跑了）

1. **逐文件完整性**：安装树与上游 `skills/3dviz-pro-max/` 逐文件 sha256 全等，805/805 一致；
   安装树清单摘要（对 `sha256sum` 排序结果再取 sha256）= `3bc49f14f9f830eef2d332621f8d407c465fe47aa9b32a3048e601dc1a400a1c`。
2. **DSH 发现**：拷贝完成后 DSH 的 skill-filesystem watcher 立即热更新技能目录，本会话的可用技能列表已出现 `3dviz-pro-max`（无需重启 GUI / 无需新会话）。
3. **加载**：`skill` 工具按名字加载成功，返回的 base directory 正确指向 `/vol1/ai/home/.dsh/skills/3dviz-pro-max`，正文完整（10 步 workflow + 路由表 + 参考资料索引）。
4. **上游自测**：仓库自带 261 个 Python 单测全过（`Ran 261 tests ... OK (skipped=11)`，46.2 s；11 个 skip 是 Playwright 相关）。
5. **脚本冒烟**（在安装目录内直接跑，全部 exit 0）：
   - `scripts/search.py "fantasy village"` → `status: candidates`，首条 `knowledge.theme-fantasy-woodland`，含 `recipe.fantasy-village-diorama`；catalog_hash `7c6f93ce…`（与 catalog-summary 一致）
   - `scripts/resolve.py recipe.fantasy-village-diorama` → 记录 + bundle_hash 正常
   - `scripts/design-context.py "small fantasy village to explore" --blueprints` → 候选分组正常
   - `scripts/host-probe.py` → 探测成功：Linux x86_64 / Intel i5-14400（16 逻辑核）/ 15.3 GB / Intel UHD 730
6. **目录卫生**：跑脚本产生的 `scripts/__pycache__/` 已清掉，安装树回到与上游逐字节一致的 805 文件。

## 4. 运行时依赖现状

| 依赖 | 状态 | 影响 |
|---|---|---|
| Python 3 | ✅ `/usr/bin/python3` 3.11.2 | 检索/解析/设计上下文脚本只需标准库，已可用 |
| Blender | ✅ `/usr/local/bin/blender` | 可走 T3 hero 烘焙（`scripts/hero-tier.py`） |
| Playwright | ❌ 未安装 | `scripts/capture.py` 自动截图不可用（退出码 3）。需要时：`pip install playwright && playwright install chromium` |

> 说明：Playwright 只影响「自动抓帧检查」，不影响建模/检索/生成场景；没有它时应如实报告「未观察到画面」，不要凭描述当证据。

## 5. 怎么用

直接在对话里说，例如：

```
用 3dviz-pro-max 搭一个可以自由探索的小型奇幻村庄，先定一个鲜明美术方向，
加几个会动的生物，最后把渲染出来的画面截给我看。
```

上游给的识别自检口令（验证发现 + 文件访问）：

```
Find the installed 3dviz-pro-max skill. Tell me which local entrypoint you loaded
and which pilot recipe fits a fantasy village. Do not generate the scene yet.
```

本次实测答案：入口 `/vol1/ai/home/.dsh/skills/3dviz-pro-max/SKILL.md`，契合的 pilot recipe 是 `recipe.fantasy-village-diorama`。

技能规模（上游 `catalog-summary.json`）：223 recipes / 440 knowledge records / 22 kit blueprints / 37 style profiles / 24 directions。

## 6. 更新与卸载

```sh
# 更新：重新克隆到所选 revision，整包替换（不要新旧文件混着合并）
git clone https://github.com/viettranx/3dviz-pro-max /tmp/3dviz
rm -rf /vol1/ai/home/.dsh/skills/3dviz-pro-max
cp -a /tmp/3dviz/skills/3dviz-pro-max /vol1/ai/home/.dsh/skills/3dviz-pro-max
# 卸载：只删这一个目录，技能目录外的场景工程不受影响
rm -rf /vol1/ai/home/.dsh/skills/3dviz-pro-max
```

DSH 的 watcher 会自动感知目录变化，更新/卸载都不需要重启。

## 7. 备注

- 该仓库根目录同时是 Claude Code / Codex 插件（`.claude-plugin/`、`.codex-plugin/`），但**技能本体就是 `skills/3dviz-pro-max/` 这一个目录**；本机按目录方式装，没走插件/市场路线。
- 仓库里的 `examples/`、`site/`、`evidence/`（约 100 MB+）**没有装**：技能自带 `templates/` 脚手架，官方也明确 examples 是独立可跑的研究，不属于技能包。
- 模板是「复制到你自己项目里再 `pnpm install`」，不要在技能目录内安装依赖（上游打包检查会拒绝）。
