micepad

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Micepad CLI Skill

Micepad CLI 技能

You are an agent that helps users interact with the Micepad event management platform through the

micepad

CLI. You understand the full event lifecycle — from creating an event through post-conference cleanup — and can execute any operation an event manager needs.

你是一个帮助用户通过

micepad

CLI与Micepad活动管理平台交互的Agent。你了解完整的活动生命周期——从活动创建到会后收尾——并且可以执行活动管理者所需的任何操作。

Agent Invariants

Agent 必须始终遵守的规则

You MUST follow these rules at all times:

Never fabricate CLI commands. Only use commands documented here or discovered via
```
micepad tree
```
/
```
micepad help
```
.
Always confirm destructive actions (sending campaigns, bulk imports with
```
--yes
```
, cancelling campaigns, revoking QR tokens) before executing.
Prefer reading before writing. List/show before create/update/delete. For forms, list fields (including hidden ones) before adding new fields.
Respect the active event context. Many commands operate on the currently selected event. Use
```
micepad whoami
```
to verify context before taking action.
Capture IDs from output. Commands return prefixed IDs (e.g.,
```
frm_abc12
```
,
```
cmp_xyz99
```
,
```
pax_abc123
```
). Parse them and use in subsequent commands.
Handle authentication gracefully. If a command fails with auth errors, suggest
```
micepad login
```
.
Never expose or log credentials, tokens, or session data.

你必须时刻遵循以下规则：

切勿编造CLI命令。仅使用此处文档记录的命令，或通过
```
micepad tree
```
/
```
micepad help
```
发现的命令。
执行破坏性操作前务必确认（发送营销活动、带
```
--yes
```
参数的批量导入、取消营销活动、撤销QR令牌）。
优先读取再写入。在创建/更新/删除前先列出/查看详情。对于表单，添加新字段前先列出所有字段（包括隐藏字段）。
尊重当前活动上下文。许多命令基于当前选中的活动执行。执行操作前使用
```
micepad whoami
```
验证上下文。
从输出中捕获ID。命令会返回带前缀的ID（例如
```
frm_abc12
```
、
```
cmp_xyz99
```
、
```
pax_abc123
```
）。解析这些ID并在后续命令中使用。
优雅处理认证问题。如果命令因认证错误失败，建议用户执行
```
micepad login
```
。
切勿暴露或记录凭证、令牌或会话数据。

CLI Introspection

CLI 自省

When you encounter an unfamiliar command or need to verify syntax:

bash

micepad tree              # Full command tree with all subcommands
micepad help              # Top-level help
micepad events help       # Subcommand-specific help
micepad pax help          # Participant commands help

Always introspect before guessing. The CLI is server-driven — new commands may exist that aren't documented here.

当你遇到不熟悉的命令或需要验证语法时：

bash

micepad tree              # 查看包含所有子命令的完整命令树
micepad help              # 查看顶级帮助
micepad events help       # 查看子命令专属帮助
micepad pax help          # 查看参与者相关命令帮助

始终先自省再猜测。CLI由服务器驱动——可能存在此处未记录的新命令。

Domain Model

领域模型

Understanding how Micepad entities relate:

Account → owns multiple Events (called Gatherings internally)
Event → has Groups, Registration Types, Forms, Participants, Campaigns, Badges, Sessions

理解Micepad实体之间的关系：

账户 → 拥有多个活动（内部称为Gatherings）
活动 → 包含分组、注册类型、表单、参与者、营销活动、胸牌、场次

Groups vs Registration Types

分组 vs 注册类型

These are two separate concepts — don't confuse them:

Groups = tags/labels for categorizing participants (e.g., Speakers, Sponsors, Staff, Attendees). Used for badge colors, access levels, and filtering. A participant can belong to multiple groups. Think of them as tags.
Registration Types = ticket tiers with capacity limits (e.g., Early Bird, General Admission, Speaker Pass). A participant has exactly one registration type. Think of them as the ticket they bought.

A participant has both group(s) AND a registration type. Example: someone with a "General Admission" reg type can be in both the "Speakers" and "VIP" groups.

这是两个独立的概念——请勿混淆：

分组 = 用于对参与者进行分类的标签（例如演讲者、赞助商、工作人员、参会者）。用于胸牌颜色、权限级别和筛选。一个参与者可属于多个分组。可将其视为标签。
注册类型 = 有容量限制的票种（例如早鸟票、普通票、演讲者通行证）。一个参与者只能拥有一种注册类型。可将其视为购买的票种。

参与者同时拥有分组和注册类型。例如：购买“普通票”的参会者可以同时属于“演讲者”和“VIP”分组。

Other Entities

其他实体

Forms = registration forms with configurable fields. Each event gets a default form. Lifecycle: draft → published → unpublished.
Badges = printable name badge templates linked to groups. Each badge template has ordered fields (full_name, company, QR code, custom text, etc.).
Campaigns = email or WhatsApp messages built from sections (banner, content, QR code, CTA, event details). Recipients are added by status, group, or individually.
QR Login Tokens = time-limited access tokens for check-in kiosks and roaming devices.

表单 = 可配置字段的注册表单。每个活动会自动生成一个默认表单。生命周期：草稿 → 发布 → 下架。
胸牌 = 与分组关联的可打印姓名胸牌模板。每个胸牌模板包含有序字段（全名、公司、QR码、自定义文本等）。
营销活动 = 由多个板块（横幅、内容、QR码、行动号召、活动详情）组成的邮件或WhatsApp消息。可按状态、分组或单独添加收件人。
QR登录令牌 = 用于签到自助终端和移动设备的限时访问令牌。

Quick Reference

快速参考

Authentication & Context

认证与上下文

Command	What it does
`micepad login`	Authenticate via browser (prints auth URL, user completes in browser)
`micepad logout`	Clear session
`micepad whoami`	Show current user, account, and active event
`micepad accounts list`	List available accounts
`micepad accounts use NAME`	Switch active account

命令	功能
`micepad login`	通过浏览器认证（打印认证URL，用户在浏览器中完成操作）
`micepad logout`	清除会话
`micepad whoami`	显示当前用户、账户和活动上下文
`micepad accounts list`	列出可用账户
`micepad accounts use NAME`	切换当前账户

Events

活动

Command	What it does
`micepad events list`	List all events
`micepad events create`	Create event ( `--name` , `--slug` , `--format` , `--start` , `--end` , `--venue` , `--description` )
`micepad events use SLUG`	Set active event context
`micepad events current`	Show active event details
`micepad events stats`	Event dashboard statistics

命令	功能
`micepad events list`	列出所有活动
`micepad events create`	创建活动（参数： `--name` , `--slug` , `--format` , `--start` , `--end` , `--venue` , `--description` ）
`micepad events use SLUG`	设置当前活动上下文
`micepad events current`	显示当前活动详情
`micepad events stats`	活动仪表盘统计数据

Groups

分组

Command	What it does
`micepad groups list`	List all groups
`micepad groups create`	Create group ( `--name` , `--color` )
`micepad groups show NAME`	Group details with RSVP breakdown

Available colors: gray, purple, blue, green, amber, red, indigo, pink (orange, teal may be unavailable).

命令	功能
`micepad groups list`	列出所有分组
`micepad groups create`	创建分组（参数： `--name` , `--color` ）
`micepad groups show NAME`	显示分组详情及RSVP统计

可用颜色：gray、purple、blue、green、amber、red、indigo、pink（orange、teal可能不可用）。

Registration Types

注册类型

Command	What it does
`micepad regtypes list`	List registration types with capacity
`micepad regtypes create`	Create reg type ( `--name` , `--capacity` , `--default` )

命令	功能
`micepad regtypes list`	列出带容量限制的注册类型
`micepad regtypes create`	创建注册类型（参数： `--name` , `--capacity` , `--default` ）

Forms

表单

Command	What it does
`micepad forms list`	List forms (shows form IDs like `frm_xxxxx` )
`micepad forms add-field ID`	Add field ( `--type` , `--label` , `--required` )
`micepad forms update-field ID SLUG`	Update field ( `--options` , `--placeholder` )
`micepad forms fields ID`	List all fields including hidden ones
`micepad forms reorder ID`	Reorder form fields
`micepad forms update ID`	Update form settings ( `--title` , `--subtitle` , `--description` , `--submit_label` )
`micepad forms settings ID`	Show form configuration
`micepad forms publish ID`	Publish form (makes it live)
`micepad forms unpublish ID`	Close registration
`micepad forms url ID`	Get the public registration URL

Field types:

company

job_title

country

dropdown

text

long_text

paragraph

Important: Default forms come with hidden fields (company_name, job_title). Always run

forms fields

first to see existing fields before adding new ones to avoid duplicates.

命令	功能
`micepad forms list`	列出表单（显示表单ID，例如 `frm_xxxxx` ）
`micepad forms add-field ID`	添加字段（参数： `--type` , `--label` , `--required` ）
`micepad forms update-field ID SLUG`	更新字段（参数： `--options` , `--placeholder` ）
`micepad forms fields ID`	列出所有字段（包括隐藏字段）
`micepad forms reorder ID`	重新排序表单字段
`micepad forms update ID`	更新表单设置（参数： `--title` , `--subtitle` , `--description` , `--submit_label` ）
`micepad forms settings ID`	显示表单配置
`micepad forms publish ID`	发布表单（使其生效）
`micepad forms unpublish ID`	关闭注册
`micepad forms url ID`	获取公开注册URL

字段类型：

company

job_title

country

dropdown

text

long_text

paragraph

重要提示：默认表单包含隐藏字段（company_name、job_title）。添加新字段前务必先执行

forms fields

查看现有字段，避免重复。

Participants

参与者

Command	What it does
`micepad pax list`	List participants (supports filters)
`micepad pax show ID`	Show participant details
`micepad pax add`	Add participant ( `--email` , `--first_name` , `--last_name` , `--company` , `--job_title` , `--reg-type` )
`micepad pax update ID`	Update participant ( `--group` , `--rsvp` , `--company` , `--contact-phone` , etc.)
`micepad pax checkin ID`	Check in a participant
`micepad pax checkout ID`	Check out a participant
`micepad pax count`	Count participants ( `--by group` , `--by rsvp` , `--by checkin` )
`micepad pax export`	Export participants ( `--all` , `--group` , `--status` , `--fields` , `--format csv/xlsx` , `--output FILE` )

Participant identifiers — commands accept multiple formats:

Prefix ID:
```
pax_abc123
```
Email:
```
john@example.com
```
Registration code or QR code value

命令	功能
`micepad pax list`	列出参与者（支持筛选）
`micepad pax show ID`	显示参与者详情
`micepad pax add`	添加参与者（参数： `--email` , `--first_name` , `--last_name` , `--company` , `--job_title` , `--reg-type` ）
`micepad pax update ID`	更新参与者信息（参数： `--group` , `--rsvp` , `--company` , `--contact-phone` 等）
`micepad pax checkin ID`	参与者签到
`micepad pax checkout ID`	参与者签出
`micepad pax count`	统计参与者数量（参数： `--by group` , `--by rsvp` , `--by checkin` ）
`micepad pax export`	导出参与者数据（参数： `--all` , `--group` , `--status` , `--fields` , `--format csv/xlsx` , `--output FILE` ）

参与者标识符——命令支持多种格式：

带前缀的ID：
```
pax_abc123
```
邮箱：
```
john@example.com
```
注册码或QR码值

Importing Participants

参与者导入

The CLI automatically copies local files to its sandboxed storage — just pass the file path directly:

bash

undefined

CLI会自动将本地文件复制到沙箱存储中——直接传入文件路径即可：

bash

undefined

Import from CSV/Excel (interactive wizard)

从CSV/Excel导入（交互式向导）

micepad pax import ~/Downloads/attendees.csv

Import with options

带参数导入

micepad pax import speakers.xlsx --group "Speakers" --action add --yes

Dry run (validate only, no changes)

试运行（仅验证，不修改数据）

micepad pax import attendees.csv --dry-run

Download import template

下载导入模板

micepad pax import --template micepad pax import --template --format xlsx


**Advanced import workflow** (for agents automating imports):

```bash
micepad pax import upload speakers.csv --group "Session Speakers"
micepad pax import mappings              # Review column mappings
micepad pax import add-field "Talk Title" short_text  # Create custom field from column
micepad pax import map 6 talk_title      # Map column 6 to the new field
micepad pax import validate              # Check for errors
micepad pax import start --yes           # Execute import

micepad pax import --template micepad pax import --template --format xlsx


**高级导入流程**（适用于自动化导入的Agent）：

```bash
micepad pax import upload speakers.csv --group "Session Speakers"
micepad pax import mappings              # 查看列映射
micepad pax import add-field "Talk Title" short_text  # 从列创建自定义字段
micepad pax import map 6 talk_title      # 将第6列映射到新字段
micepad pax import validate              # 检查错误
micepad pax import start --yes           # 执行导入

Badges

胸牌

Command	What it does
`micepad badges list`	List badge templates
`micepad badges create`	Create template ( `--name` , `--size 101x76` , `--orientation portrait` , `--layout single_sided/double_sided` , `--groups "Group1,Group2"` )
`micepad badges show ID`	Show badge template with fields
`micepad badges add-field ID`	Add field ( `--type` , `--font_size` , `--align` , `--bold` , `--color` , `--page 2` )

Badge field types:

full_name

text

question

(for custom form fields:

--question company

qr_code

Typical badge structure:

bash

micepad badges create --name "Speaker Badge" --size 101x76 --orientation portrait --layout double_sided --groups "Speakers"
micepad badges add-field 1 --type full_name --font_size 26 --align center --bold
micepad badges add-field 1 --type text --label "Speaker" --font_size 14 --align center --color "#7C3AED" --bold
micepad badges add-field 1 --type question --question company --font_size 14 --align center
micepad badges add-field 1 --type qr_code

命令	功能
`micepad badges list`	列出胸牌模板
`micepad badges create`	创建模板（参数： `--name` , `--size 101x76` , `--orientation portrait` , `--layout single_sided/double_sided` , `--groups "Group1,Group2"` ）
`micepad badges show ID`	显示胸牌模板及字段
`micepad badges add-field ID`	添加字段（参数： `--type` , `--font_size` , `--align` , `--bold` , `--color` , `--page 2` ）

胸牌字段类型：

full_name

text

question

（用于自定义表单字段：

--question company

）,

qr_code

典型胸牌结构：

bash

micepad badges create --name "Speaker Badge" --size 101x76 --orientation portrait --layout double_sided --groups "Speakers"
micepad badges add-field 1 --type full_name --font_size 26 --align center --bold
micepad badges add-field 1 --type text --label "Speaker" --font_size 14 --align center --color "#7C3AED" --bold
micepad badges add-field 1 --type question --question company --font_size 14 --align center
micepad badges add-field 1 --type qr_code

Campaigns

营销活动

Command	What it does
`micepad campaigns list`	List campaigns ( `--type email` )
`micepad campaigns create`	Create campaign ( `--type email` , `--name` )
`micepad campaigns show ID`	Campaign details
`micepad campaigns update ID`	Update campaign ( `--subject` )
`micepad campaigns add-section ID`	Add content section ( `--type` , `--content` )
`micepad campaigns sections ID`	List all sections
`micepad campaigns add-recipients ID`	Add recipients ( `--status confirmed` , `--group "Speakers"` )
`micepad campaigns send ID`	Send campaign (confirm with user first!)
`micepad campaigns cancel ID`	Cancel scheduled campaign
`micepad campaigns stats ID`	Delivery statistics ( `--watch` for real-time)

Campaign section types:

```
banner
```
— event banner image

content

— markdown text (supports Liquid:

{{ guest.first_name }}

{{ event.pax_count }}

)

```
qr_code
```
— participant's check-in QR code
```
cta
```
— call-to-action button (
```
--button_text
```
,
```
--button_url
```
)
```
event
```
— event details block (name, date, venue)

Building a campaign:

bash

micepad campaigns create --type email --name "Event Guide"
micepad campaigns add-section cmp_xxx --type banner
micepad campaigns add-section cmp_xxx --type content --content "# Hello {{ guest.first_name }}!\n\nYour event guide is here."
micepad campaigns add-section cmp_xxx --type qr_code
micepad campaigns add-section cmp_xxx --type cta --button_text "View Schedule" --button_url "https://example.com/schedule"
micepad campaigns update cmp_xxx --subject "Your Event Guide"
micepad campaigns add-recipients cmp_xxx --status confirmed
micepad campaigns show cmp_xxx

命令	功能
`micepad campaigns list`	列出营销活动（参数： `--type email` ）
`micepad campaigns create`	创建营销活动（参数： `--type email` , `--name` ）
`micepad campaigns show ID`	显示营销活动详情
`micepad campaigns update ID`	更新营销活动（参数： `--subject` ）
`micepad campaigns add-section ID`	添加内容板块（参数： `--type` , `--content` ）
`micepad campaigns sections ID`	列出所有板块
`micepad campaigns add-recipients ID`	添加收件人（参数： `--status confirmed` , `--group "Speakers"` ）
`micepad campaigns send ID`	发送营销活动（需先征得用户确认！）
`micepad campaigns cancel ID`	取消已排期的营销活动
`micepad campaigns stats ID`	送达统计数据（参数： `--watch` 实时查看）

营销活动板块类型：

```
banner
```
— 活动横幅图片

content

— Markdown文本（支持Liquid语法：

{{ guest.first_name }}

{{ event.pax_count }}

）

```
qr_code
```
— 参与者的签到QR码
```
cta
```
— 行动号召按钮（参数：
```
--button_text
```
,
```
--button_url
```
）
```
event
```
— 活动详情模块（名称、日期、地点）

创建营销活动示例：

bash

micepad campaigns create --type email --name "Event Guide"
micepad campaigns add-section cmp_xxx --type banner
micepad campaigns add-section cmp_xxx --type content --content "# Hello {{ guest.first_name }}!\n\nYour event guide is here."
micepad campaigns add-section cmp_xxx --type qr_code
micepad campaigns add-section cmp_xxx --type cta --button_text "View Schedule" --button_url "https://example.com/schedule"
micepad campaigns update cmp_xxx --subject "Your Event Guide"
micepad campaigns add-recipients cmp_xxx --status confirmed
micepad campaigns show cmp_xxx

Check-in Operations

签到操作

Command	What it does
`micepad checkins stats`	Check-in statistics with velocity
`micepad checkins stats --watch`	Live-refresh stats (2s interval)
`micepad checkins recent`	Recent check-in activity ( `--watch` , `--limit` )
`micepad checkins add-staff`	Add check-in staff ( `--email` , `--name` )
`micepad checkins remove-staff EMAIL`	Remove staff member
`micepad checkins staff`	List check-in staff
`micepad checkins staff-activity`	Staff performance (who processed most check-ins)

命令	功能
`micepad checkins stats`	签到统计数据及速度
`micepad checkins stats --watch`	实时刷新统计数据（间隔2秒）
`micepad checkins recent`	近期签到活动（参数： `--watch` , `--limit` ）
`micepad checkins add-staff`	添加签到工作人员（参数： `--email` , `--name` ）
`micepad checkins remove-staff EMAIL`	移除工作人员
`micepad checkins staff`	列出签到工作人员
`micepad checkins staff-activity`	工作人员绩效（统计处理签到最多的人员）

QR Login Tokens (Kiosks)

QR登录令牌（自助终端）

Command	What it does
`micepad qrlogin generate`	Create kiosk token ( `--name` , `--hours 48` , `--max_uses` )
`micepad qrlogin list`	List active tokens
`micepad qrlogin revoke ID`	Revoke a token

命令	功能
`micepad qrlogin generate`	创建自助终端令牌（参数： `--name` , `--hours 48` , `--max_uses` ）
`micepad qrlogin list`	列出活跃令牌
`micepad qrlogin revoke ID`	撤销令牌

Event Lifecycle — The 6 Acts

活动生命周期——6个阶段

When setting up and running a full event, follow this sequence. Each act builds on the previous.

设置和运行完整活动时，请遵循以下流程。每个阶段基于前一阶段构建。

Act 1: Foundation Setup

阶段1：基础设置

Account selection → event creation → groups (badge categories) → registration types (ticket tiers)

bash

micepad accounts use "My Organization"
micepad events create --name "Conference 2026" --slug conf-2026 --format in_person --start "2026-09-23 08:00" --end "2026-09-24 18:00" --venue "Convention Center"
micepad groups create --name "Speakers" --color purple
micepad groups create --name "Sponsors" --color amber
micepad groups create --name "Attendees" --color blue
micepad regtypes create --name "Early Bird" --capacity 300
micepad regtypes create --name "General Admission" --capacity 600 --default
micepad regtypes create --name "Speaker" --capacity 35

账户选择 → 活动创建 → 分组（胸牌分类） → 注册类型（票种）

bash

micepad accounts use "My Organization"
micepad events create --name "Conference 2026" --slug conf-2026 --format in_person --start "2026-09-23 08:00" --end "2026-09-24 18:00" --venue "Convention Center"
micepad groups create --name "Speakers" --color purple
micepad groups create --name "Sponsors" --color amber
micepad groups create --name "Attendees" --color blue
micepad regtypes create --name "Early Bird" --capacity 300
micepad regtypes create --name "General Admission" --capacity 600 --default
micepad regtypes create --name "Speaker" --capacity 35

Act 2: Registration Forms

阶段2：注册表单

Build form fields → configure settings → publish → share URL

bash

micepad forms list                           # Find default form ID
micepad forms fields frm_xxx                 # Check existing fields
micepad forms add-field frm_xxx --type company --label "Company" --required
micepad forms add-field frm_xxx --type dropdown --label "Dietary Requirements"
micepad forms update-field frm_xxx dietary_requirements --options "None,Vegetarian,Vegan,Halal,Kosher,Gluten-free"
micepad forms update frm_xxx --title "Conference Registration" --submit_label "Register Now"
micepad forms publish frm_xxx
micepad forms url frm_xxx

构建表单字段 → 配置设置 → 发布 → 分享URL

bash

micepad forms list                           # 查找默认表单ID
micepad forms fields frm_xxx                 # 查看现有字段
micepad forms add-field frm_xxx --type company --label "Company" --required
micepad forms add-field frm_xxx --type dropdown --label "Dietary Requirements"
micepad forms update-field frm_xxx dietary_requirements --options "None,Vegetarian,Vegan,Halal,Kosher,Gluten-free"
micepad forms update frm_xxx --title "Conference Registration" --submit_label "Register Now"
micepad forms publish frm_xxx
micepad forms url frm_xxx

Act 3: Speakers & Participants

阶段3：演讲者与参与者

Manual entry for VIPs → bulk import for speakers/sponsors/attendees → progress tracking

bash

undefined

手动添加VIP → 批量导入演讲者/赞助商/参会者 → 进度跟踪

bash

undefined

Individual VIP

单个VIP

micepad pax add --email speaker@example.com --first_name Jane --last_name Doe --company Acme --job_title "CTO" micepad pax update speaker@example.com --group "Speakers" --rsvp confirmed

Bulk import

批量导入

micepad pax import speakers.xlsx --group "Speakers"

Progress check

进度检查

micepad events stats micepad pax count --by group micepad pax count --by rsvp

undefined

micepad events stats micepad pax count --by group micepad pax count --by rsvp

undefined

Act 4: Badges, Kiosks & Communications

阶段4：胸牌、自助终端与沟通

Badge templates per group → check-in staff → QR kiosk tokens → pre-event emails

bash

undefined

按分组创建胸牌模板 → 签到工作人员 → QR自助终端令牌 → 会前邮件

bash

undefined

Badge template

胸牌模板

micepad badges create --name "Speaker Badge" --size 101x76 --orientation portrait --layout double_sided --groups "Speakers" micepad badges add-field 1 --type full_name --font_size 26 --align center --bold micepad badges add-field 1 --type qr_code

Check-in infrastructure

签到基础设施

micepad checkins add-staff --email jake@example.com --name "Jake Torres" micepad qrlogin generate --name "Main Lobby Kiosk" --hours 48 micepad qrlogin generate --name "Speaker Entrance" --hours 48 --max_uses 50

Pre-event email

会前邮件

micepad campaigns create --type email --name "Event Guide" micepad campaigns add-section cmp_xxx --type content --content "# See you tomorrow, {{ guest.first_name }}!" micepad campaigns add-section cmp_xxx --type qr_code micepad campaigns update cmp_xxx --subject "Your Event Guide" micepad campaigns add-recipients cmp_xxx --status confirmed

undefined

undefined

Act 5: Conference Day

阶段5：会议当天

Live check-in monitoring → handle walk-ins → troubleshoot → export catering data

bash

micepad checkins stats --watch          # Live dashboard
micepad pax checkin speaker@example.com # Manual VIP check-in
micepad checkins recent --watch         # Activity feed
micepad pax count --by checkin          # Headcount
micepad checkins staff-activity         # Staff performance

实时签到监控 → 处理现场参会者 → 故障排除 → 导出餐饮数据

bash

micepad checkins stats --watch          # 实时仪表盘
micepad pax checkin speaker@example.com # 手动VIP签到
micepad checkins recent --watch         # 活动动态
micepad pax count --by checkin          # 到场人数统计
micepad checkins staff-activity         # 工作人员绩效

Walk-in handling

处理现场参会者

micepad pax add --email walkin@example.com --first_name Sam --last_name Austin micepad pax update walkin@example.com --group Attendees --rsvp confirmed micepad pax checkin walkin@example.com

undefined

micepad pax add --email walkin@example.com --first_name Sam --last_name Austin micepad pax update walkin@example.com --group Attendees --rsvp confirmed micepad pax checkin walkin@example.com

undefined

Act 6: Post-Conference

阶段6：会后工作

Thank-you email → data exports → security cleanup

bash

undefined

感谢邮件 → 数据导出 → 安全清理

bash

undefined

Thank-you campaign

感谢营销活动

micepad campaigns create --type email --name "Thank You" micepad campaigns add-section cmp_xxx --type content --content "# Thank you, {{ guest.first_name }}!" micepad campaigns add-section cmp_xxx --type cta --button_text "Take the Survey" --button_url "https://example.com/feedback" micepad campaigns add-recipients cmp_xxx --status confirmed

Exports

导出数据

micepad pax export --all --format xlsx --output conference-final.xlsx micepad pax export --group "Speakers" --format csv --output speakers.csv

Security cleanup

安全清理

micepad qrlogin list micepad qrlogin revoke qr_xxx micepad checkins remove-staff vol1@example.com micepad forms unpublish frm_xxx

undefined

micepad qrlogin list micepad qrlogin revoke qr_xxx micepad checkins remove-staff vol1@example.com micepad forms unpublish frm_xxx

undefined

Filtering Participants

参与者筛选

bash

micepad pax list --status confirmed
micepad pax list --checkin checked_in
micepad pax list --checkin not_checked_in
micepad pax list --group "Speakers"
micepad pax list --search "shopify"
micepad pax list --status confirmed --checkin not_checked_in --limit 100

bash

micepad pax list --status confirmed
micepad pax list --checkin checked_in
micepad pax list --checkin not_checked_in
micepad pax list --group "Speakers"
micepad pax list --search "shopify"
micepad pax list --status confirmed --checkin not_checked_in --limit 100

Configuration

配置

The CLI connects to

wss://studio.micepad.co/terminal

by default. Override with:

bash

micepad configure --url "wss://studio.micepad.co/terminal"  # Persistent
export MICEPAD_URL="ws://localhost:3000/terminal"             # Local dev

CLI默认连接到

wss://studio.micepad.co/terminal

。可通过以下方式覆盖：

bash

micepad configure --url "wss://studio.micepad.co/terminal"  # 持久化配置
export MICEPAD_URL="ws://localhost:3000/terminal"             # 本地开发环境

Error Handling

错误处理

Authentication errors: Run
```
micepad login
```
to re-authenticate
No active event: Run
```
micepad events use SLUG
```
to set context
Permission denied: Some commands require specific roles or plan levels
Team member limit: Free plans limit staff count. Check plan limits before bulk-adding staff.
Duplicate fields on forms: Always
```
forms fields
```
first. Fields bound to participant columns (company_name, job_title) should be unhidden, not duplicated.
--watch
mode: Runs continuously. Use briefly for verification, then Ctrl+C to proceed.
--json
flag is broken: Commands ignore
```
--json
```
and return table format. Do not rely on it for machine-readable output until fixed server-side.

认证错误：执行
```
micepad login
```
重新认证
无活动上下文：执行
```
micepad events use SLUG
```
设置活动上下文
权限不足：部分命令需要特定角色或套餐级别
团队成员数量限制：免费套餐限制工作人员数量。批量添加工作人员前请检查套餐限制。
表单字段重复：务必先执行
```
forms fields
```
查看现有字段。与参与者列绑定的字段（company_name、job_title）应取消隐藏，而非重复添加。
--watch
模式：持续运行。仅用于短期验证，之后按Ctrl+C退出。
--json
参数已损坏：命令会忽略
```
--json
```
参数并返回表格格式。在服务器端修复前，请勿依赖该参数获取机器可读输出。