Przejdź do treści
Biblioteka skilli
Nauka i badania · Konwersja i formaty

vesta-render

/vesta-render

Renderuje struktury krystaliczne z plików CIF lub POSCAR przez zainstalowany VESTA na Windows: zapisuje obrazy PNG i automatyzuje VESTA.

Repozytorium
many-crafts ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

93/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena13 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
24
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: lib/pwsh.js, lib/scene.js, lib/vesta.js, scripts/doctor.mjs, scripts/vesta.mjs

Co robi i kiedy

Renderuje struktury krystaliczne z plików CIF lub POSCAR przez zainstalowany VESTA na Windows: zapisuje obrazy PNG i automatyzuje VESTA.

Oryginalny opis (EN)

Render crystal-structure figures from CIF / POSCAR / .vesta files with a locally installed VESTA on Windows. Use when the user asks to draw a crystal structure, render a VESTA scene, export a structure image, convert CIF to PNG, or automate VESTA.

Jak działa

  1. 这个技能做什么
  2. 环境
  3. 安装
  4. 怎么用
  5. 失败怎么办
  6. 边界
  7. 跨 agent 接入
  8. 许可 / 声明
  9. English
Sekcje z nagłówków SKILL.md, w oryginale · 121 linii, 543 słów
Podgląd SKILL.md
---
name: vesta-render
description: Render crystal-structure figures from CIF / POSCAR / .vesta files with a locally installed VESTA on Windows. Use when the user asks to draw a crystal structure, render a VESTA scene, export a structure image, convert CIF to PNG, or automate VESTA.
license: MIT
---

# vesta-render

## 这个技能做什么

把本机安装的 [VESTA](https://jp-minerals.org/vesta/en/) 变成一个可脚本调用的工具:打开结构文件、用 `-export_img` 渲染 PNG、按晶向/缩放/范围/背景覆盖 `.vesta` 场景、关闭进程。渲染结果是普通图片文件,不依赖 OCR 或屏幕抓取。

不捆绑 VESTA,不读取 VESTA 内存,不注入进程。**前提:VESTA 必须由用户自行安装**(本包不包含、不下载、不代替安装),并遵守其许可与引用要求。

## 环境

| 项 | 要求 |
| --- | --- |
| 系统 | **Windows**(调用 PowerShell 5.1 与 Win32 窗口接口;macOS / Linux 不支持) |
| VESTA | **3.90.6a 实测**(2026-03 构建);**3.4.5 及更早版本未验证**,旧版可能缺少 `-export_img`,工具会明确报错。注意:`VESTA.ini` 里的 `3.4.5` 是文件格式常量,不是程序版本 |
| Node | **>= 22** |
| 依赖 | 无 npm 依赖;只用 Node 内置模块 |

## 安装

1. 解压本包到任意目录,例如 `C:\tools\vesta-render`;
2. 设置 VESTA 路径(二选一):
   - 环境变量 `VESTA_EXE=C:\Program Files\VESTA-win64\VESTA.exe`;
   - 每次命令加 `--vesta "C:\Program Files\VESTA-win64\VESTA.exe"`。
3. 自检:

```bash
node scripts/doctor.mjs --strict
```

`doctor` 只检查 Node / 平台 / VESTA 路径 / 场景改写,不启动 VESTA。必需项失败时退出码为 1。

## 怎么用

```bash
# 安装状态 + 窗口
node scripts/vesta.mjs status

# 打开结构文件(单实例时转发到已有窗口)
node scripts/vesta.mjs open examples/fe_fcc_cell.cif

# 用命令行渲染 PNG
node scripts/vesta.mjs export examples/fe_fcc_cell.cif --out out/cell.png --scale 2

# 渲染 .vesta 场景,并临时覆盖视角 / 缩放 / 显示范围 / 背景
node scripts/vesta.mjs render my-scene.vesta --view 0,0,1 --zoom 0.9 --boundary 0,1,0,1,0,1 --background 20,24,32 --out out/view.png

# 把覆盖后的场景另存(之后再渲染,便于复现)
node scripts/vesta.mjs render my-scene.vesta --view 1,1,0 --save-scene out/my-scene-view110.vesta --out out/view110.png

# 关闭
node scripts/vesta.mjs close
```

输入:

- `CIF` / `POSCAR` / `.vesta` 结构文件;
- `.vesta` 覆盖参数:`view`(晶向 `[h,k,l]`)、`zoom`、`boundary`(6 个分数坐标)、`background`(RGB)。

输出:

- 成功:stdout 输出 JSON(`ok: true` + 路径、尺寸、字节数、窗口信息等),退出码 0;
- 失败:stderr 输出 `错误:…`,退出码 1。

示例产物(用本包 + VESTA 3.90.6a 实际渲染,1740×1352;PNG 在完整包 / GitHub 仓库可见,Agensi 文本版 zip 不含图片):

| 输入 | 产物 |
| --- | --- |
| `examples/fe_fcc_cell.cif` | `examples/out-fe-cell.png` |
| `examples/fe_slab.vesta`(`view=[1,0,0]`、`zoom=0.8`) | `examples/out-fe-slab.png` |

复现命令见 `examples/README.md`。

## 失败怎么办

| 现象 | 处理 |
| --- | --- |
| `未配置 VESTA.exe 路径` | 设置 `VESTA_EXE` 或加 `--vesta`;路径要用 `.exe` 的绝对路径 |
| `找不到 VESTA.exe` | 检查路径与权限;VESTA 未安装时先从官网安装 |
| `VESTA 集成目前只支持 Windows` | 换 Windows 机器;本包不做跨平台移植 |
| `VESTA 在写出图片前退出` | 输入文件可能无法解析,或 VESTA 版本不支持 `-export_img`;先在 VESTA 里手工打开确认 |
| 等待超时 | 大结构/慢机器加 `--timeout 300000`;确认 VESTA 没有被弹窗挡住 |
| 渲染出的图是旧图/空图 | VESTA 是单实例:先 `close`,再单独渲染;确认输出路径可写 |
| 中文/空格路径 | 用引号包住路径;PowerShell 侧已用 `-EncodedCommand`,但仍需保证文件存在 |

## 边界

- 只做文件级控制 + 命令行渲染 + 窗口管理;**不读取 VESTA 内存**,不注入 DLL。
- VESTA 是单实例程序:已有窗口时,`open` / `render` 会把文件转发到该窗口,可能切换焦点;批量渲染前先 `close`。
- 多面体、空间填充、线框、逐元素半径/颜色、光照、标签没有程序化覆盖;需要时先在 VESTA 里调好并另存 `.vesta` 场景,再用 `view` / `zoom` / `boundary` / `background` 覆盖。
- 不读取 VESTA 内存,不注入 DLL,也不做屏幕抓取;渲染只走 VESTA 命令行与 `.vesta` 文件。
- 不捆绑 VESTA / 商业 SDK / 论文原图;示例只含自建结构的 CIF。

## 跨 agent 接入

本包的最小共同集是 `SKILL.md` + 一个 CLI。不同 agent 的目录约定不同,以各自官方格式为准:

- **Claude Code**:把 `vesta-render/` 放到 `.claude/skills/vesta-render/`,确认 `SKILL.md` 的 `name` 与目录名一致;
- **Cursor**:把 `SKILL.md` 作为规则/技能说明引用(或放进项目的 agent 指令目录),让 agent 通过终端调用 `node scripts/vesta.mjs`;
- **Copilot**:把 `SKILL.md` 内容并入仓库的 agent 指令文件(如 `.github/copilot-instructions.md`),入口仍是同一个 CLI;
- **其他 agent**:只要能执行 shell 命令并读取 `SKILL.md`,就可以用;不需要 DSH,不需要 session-bus。

## 许可 / 声明

- 代码:MIT(见 `LICENSE`;上游版权 dhd / dhd78)。
- 第三方:VESTA 不随包分发,见 `THIRD_PARTY_NOTICES.md`。
- AI 参与:见 `AI-DISCLOSURE.md`。
- 来源与重建:见 `SOURCE.md`。

## English

`vesta-render` is a Windows CLI skill that drives a locally installed [VESTA](https://jp-minerals.org/vesta/en/):
open CIF / POSCAR / `.vesta` files, render PNGs through `-export_img`,
override view / zoom / boundary / background on `.vesta` scenes, and close the process.

- Requirements: Windows, Node >= 22, VESTA 3.90.6a tested (not bundled; earlier versions untested; the `3.4.5` in `VESTA.ini` is a file-format constant, not the app version).
- Install: unzip anywhere, set `VESTA_EXE`, run `node scripts/doctor.mjs --strict`.
- Usage: `node scripts/vesta.mjs status|open|export|render|close` (JSON output, exit code 0/1).
- Boundaries: no OCR, no screen reading, no VESTA memory reading, no injection, no bundled VESTA; Windows-only.
- License: MIT; AI disclosure and third-party notices are included.
Pliki w paczce (24)
  • AI-DISCLOSURE.md 2 KB
  • CANONICAL.md 1 KB
  • LICENSE 1 KB
  • README.md 4 KB
  • SHA256SUMS.txt 2 KB
  • SKILL.md 6 KB
  • SOURCE.md 7 KB
  • THIRD_PARTY_NOTICES.md 2 KB
  • assets/logo-512-dark.png 56 KB
  • assets/logo-512-tile.png 57 KB
  • assets/logo-512-white.png 60 KB
  • examples/README.md 2 KB
  • examples/fe47x_surface.cif 2 KB
  • examples/fe_fcc_cell.cif 1 KB
  • examples/fe_slab.vesta 14 KB
  • examples/out-fe-cell.png 198 KB
  • examples/out-fe-slab.png 119 KB
  • lib/pwsh.js 3 KB
  • lib/scene.js 6 KB
  • lib/vesta.js 18 KB
  • references/IMPLEMENTATION.md 3 KB
  • scripts/doctor.mjs 3 KB
  • scripts/vesta.mjs 8 KB
  • templates/template.vesta 5 KB

Wersje

W bazie nie ma innych skilli o nazwie vesta-render.

Migawka bazy z 13.11.2026 · wersja paczki a9249ca7408f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100pymatgen
    Prowadzi przez pymatgen w obliczeniowej nauce o materiałach: struktury krystaliczne, pliki CIF i POSCAR, symetria, Materials Project API, diagramy fazowe i dane wejściowe DFT.
  • 100cif-to-vasp
    Generuje pliki wejściowe VASP (POSCAR, INCAR, KPOINTS, POTCAR) z plików CIF i pomaga przy błędach ZHEGV lub pamięci.
  • 95pymatgen
    Pracuje z kryształami w Pythonie: konwertuje formaty CIF i POSCAR, odpytuje Materials Project i liczy diagramy faz.
  • 100pymatgen-structure
    Obsługuje manipulację strukturami i analizę kryształów w pymatgen: odczyt i zapis CIF, POSCAR i XYZ, superkomórki, podstawienia, symetria i deskryptory struktury lokalnej.
  • 100alterlab-pymatgen
    Analizuje i przetwarza materiały biblioteką pymatgen: struktury krystaliczne, diagramy fazowe, struktury elektronowe, powierzchnie i dostęp do bazy Materials Project.
  • 100ase
    Obsługuje struktury atomistyczne w ASE: konwersja formatów (CIF, POSCAR, XYZ, dane LAMMPS), budowa supercel i powierzchni oraz małe optymalizacje geometrii.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.