---
name: verdict-gallery
description: 发布 HTML 到 verdict 网页博物馆 gallery.verdictfinance.top。默认谁有链接谁能看；只有用户明确要求加密才加密码。当用户说 verdict 博物馆、网页博物馆、gallery.verdictfinance.top、发一页 HTML、做完页面要可分享链接，且没提公司/客户/juzibot 时使用。公司句子博物馆 html-gallery.juzibot.com 走 html-gallery，不要用本 skill。
---

# verdict-gallery 发布

把本地 HTML（单文件或目录）发到博物馆，返回 `https://gallery.verdictfinance.top/p/<slug>`。

展页默认公开。谁有链接谁能看、也能问讲解员，不用注册。这不是飞书登录，也不是公司 html-gallery。发布、挂文件、管展才需要馆账号。

## 位置

- 配置文件：`~/.miaoji-gallery/config.json`（含 baseUrl 和 token，由登录脚本写入）
- 脚本：与本 `SKILL.md` 同级的 `scripts/`。常见安装位置：
  - `~/.cursor/skills/verdict-gallery/scripts/`
  - `~/.claude/skills/verdict-gallery/scripts/`
- 禁止读写 `~/.html-gallery/config.json`（那是公司馆）

没有脚本时先装，再登录：

```bash
curl -fsSL https://gallery.verdictfinance.top/install.sh | sh
```

## 流程

1. **检查登录**：若 `~/.miaoji-gallery/config.json` 不存在或没有 `token`，先运行：

   ```bash
   node ~/.cursor/skills/verdict-gallery/scripts/login.mjs
   ```

   Cursor 没有该路径则改用 `~/.claude/skills/verdict-gallery/scripts/login.mjs`。  
   脚本会打开浏览器。没有账号时，用新用户名提交即注册。成功 stdout：`{"ok":true}`。

2. **发布**：

   ```bash
   node ~/.cursor/skills/verdict-gallery/scripts/deploy.mjs <文件或目录> --slug <slug> --title "<标题>"
   ```

   成功 stdout：`{"ok":true,"url":"...","updated":false}`。

3. **把 url 原样告诉用户**（完整链接，用户直接复制发给别人）。

## 规则

- **slug**：小写字母/数字/连字符，可用 `/` 分层（如 `linalg/course`）。按标题或用途起一个短英文名。
- **visibility**：默认 `open`，谁有链接谁能看。不要用 `login`，不要走飞书。用户明确说加密、密码、不要公开 → `--visibility public --password <密码>`。
- **同一 slug 重复 deploy = 原地更新**，链接不变。
- **退出码**：2 = 未登录或 token 失效 → 跑 login.mjs 后重试；3 = slug 被他人占用 → 换 slug。
- **目录发布**：入口必须是 `index.html`，其余 css/js/图片相对引用。
- 仅支持 macOS / Linux，Node ≥ 18。

## 看展（可选）

- 展：`https://gallery.verdictfinance.top/p/<slug>/`。右下角就能问讲解员，不用登录。
- 注册/登录：`https://gallery.verdictfinance.top/dashboard/login`（发展、挂文件、管展才需要）
- 划词即问。馆主可以把 PDF 等 Cmd+V 或拖进讲解员，挂到当前这组展。
- 不要把论文全文粘进对话框。