本文へ移動
cccskills
無料GitHub で公開

panotovr

Create a Realsee VR space from local equirectangular panoramas using PanoToVR. Use for image-directory or manifest submission, resuming a known VR task, and retrieving its VR URL. For depth maps, point clouds, or camera poses use Argus instead.

日本語の概要は準備中です。原文の説明を表示しています。

realsee-developer/skills
インストール方法を見る

含まれるファイル（26）

  • SKILL.md3.7 KB
  • assets/manifest.example.json259 B
  • LICENSE17.0 KB
  • package-lock.json109.4 KB
  • package.json493 B
  • README.md1.1 KB
  • README.zh-CN.md1019 B
  • references/api-workflow.md1.0 KB
  • references/api-workflow.zh-CN.md997 B
  • references/host-differences.md986 B
  • references/host-differences.zh-CN.md855 B
  • references/input-modes.md1.4 KB
  • references/input-modes.zh-CN.md889 B
  • references/pano-to-vr.openapi.json14.1 KB
  • references/troubleshooting.md2.0 KB
  • references/troubleshooting.zh-CN.md1.2 KB
  • scripts/lib/api.mjs7.9 KB
  • scripts/lib/archive.mjs2.2 KB
  • scripts/lib/args.mjs3.9 KB
  • scripts/lib/config.mjs2.7 KB
  • scripts/lib/constants.mjs825 B
  • scripts/lib/input.mjs4.8 KB
  • scripts/lib/logger.mjs755 B
  • scripts/lib/state.mjs1.4 KB
  • scripts/run-panorama-to-vr.mjs6.1 KB
  • SKILL.zh-CN.md3.3 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

PanoToVR

English | 简体中文

PanoToVR uploads panoramas, creates a remote VR task, polls it, and writes result.json with status, task_code, project_id, vr_url, and workspace_dir. This is independent of Argus and local Blender modeling.

Before execution

  • Obtain consent for remote upload and VR task creation. Reuse explicit authorization for the same files and scope. Selecting files alone is not consent.
  • Resolve <skillDir> as the directory containing this file, regardless of the caller's working directory.
  • Require Node.js 22+ and npm 10+. Install locked dependencies with npm ci --prefix <skillDir> --omit=dev --ignore-scripts --no-audit --no-fund.
  • Configure REALSEE_APP_KEY, REALSEE_APP_SECRET, and REALSEE_REGION=global|cn locally. The runtime reads the process environment or .env in the current working directory; it also accepts CLAUDE_PLUGIN_OPTION_REALSEE_*. It does not load Argus's credential file. Never request secrets in chat or print them.
  • Confirm the account region; the runtime defaults to global when omitted. For missing access, use my.realsee.ai for global or my.realsee.cn for CN. Request the panorama-to-VR API capability through developer@realsee.com with account region, UserID, and IdentityID. Do not send an email without authorization.
  • Keep workspaces outside the installed skill and repository. State includes upload receipts and may contain temporary download URLs; treat it as private. The runtime clears proxy environment variables for its own process.

Execute

Image directory (auto-generated manifest):

node <skillDir>/scripts/run-panorama-to-vr.mjs --images-dir <imagesDir> --workspace <workspaceRoot> --json

Existing manifest (read input modes and use the synthetic template):

node <skillDir>/scripts/run-panorama-to-vr.mjs --manifest <manifestPath> --images-dir <imagesDir> --workspace <workspaceRoot> --json

Resume a known task without packaging, upload, or submission:

node <skillDir>/scripts/run-panorama-to-vr.mjs --workspace <workspaceRoot> --task-code <taskCode> --json

--workspace is the parent root, including on resume; the emitted workspace_dir is the task subdirectory. Optional --project-name, --poll-interval-ms, and --poll-max-attempts configure new runs/polling. Defaults are 30 seconds and 60 attempts; environment alternatives are REALSEE_POLL_INTERVAL_MS and REALSEE_POLL_MAX_ATTEMPTS.

Interpret and recover

Read result.json in the emitted workspace and report the task identity, status, workspace, and VR URL when present. A remote error may be returned as status: error even with exit code zero; inspect the JSON rather than relying only on exit code. Polling timeout does not prove remote failure. Resume a known task after interruption; if submission may have succeeded without returning a task code, stop and reconcile before submitting again. Do not claim a usable VR link when it is null.

The runtime normalizes JPEG/PNG/WebP to JPEG and checks manifest structure and file matches; it does not enforce Argus's 1–99/RGB8/exact-2:1 validation contract. Confirm equirectangular inputs rather than claiming those checks ran.

Load references only as needed: API workflow, host installation, troubleshooting.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

argus

無料

Use this skill to process one to 99 local exact 2:1 equirectangular panorama images with Realsee Argus, producing depth maps, a merged GLB point cloud, camera poses, optional intrinsics, and a validated local output index. Trigger for Argus panorama reconstruction, Argus ZIP input, or explicit Argus start/status/collect lifecycle requests. Do not trigger for panorama editing or stitching, arbitrary-photo 3D generation, existing GLB inspection, or research-only questions.

日本語の概要は準備中です。原文の説明を表示しています。

realsee-developer/skills102026年10月20日 更新

realsee-blender-reconstruction

無料

Reconstruct an evidenced indoor space from local Realsee scan exports, point clouds, CAD, and panoramas as a separately editable native Blender scene. Use for scan-to-Blender space modeling, source-based geometry/material/light refinement, and requested walkthrough or physics exports. Argus panorama-to-depth inference is a separate capability.

日本語の概要は準備中です。原文の説明を表示しています。

realsee-developer/skills102026年10月20日 更新

realsee-developer のスキルをすべて見る

このスキルの問題を報告する