This is the single source of truth for terminology used across Picora documentation, dashboards, and APIs. If a term in the table below is translated differently anywhere else, that’s a bug — please report it.
Concepts
| Term | Chinese | Definition |
|---|
| Resource hosting | 资源托管 | The act of storing user files on Picora and serving them via CDN. Replaces the older “image hosting / 图床” framing as of v0.15.0. |
| Resource type | 资源类型 | One of: image / video / audio / document (Markdown or Typst) / board. |
| Plan / Tier | 套餐 | The subscription level: none / trial / pro / pro_plus. Not “level” or “subscription level”. |
| Quota | 配额 | A limit on a specific dimension (e.g., image storage bytes, document count). Not “限额” or “限制”. |
| Bandwidth quota | 带宽配额 | The monthly CDN egress allowance, distinct from upload bandwidth. |
| External link | 外链 URL | A publicly accessible URL for a resource (e.g., media.picora.me/abc.png). |
| Public resource | 公开资源 | A resource with is_public = true; accessible without authentication. |
| Private resource | 私有资源 | A resource with is_public = false; requires JWT or API Key. |
| API Key | API Key (kept English) | A sk_live_* token used by tool clients (PicGo / Moraya / etc). Not translated to “密钥” to avoid confusion with cryptographic keys. |
AI workflows
| Term | Chinese | Definition |
|---|
| MCP | MCP（Model Context Protocol，模型上下文协议） | The standard AI assistants use to call external tools. Always spell out at first mention. |
| stdio MCP | stdio MCP | Local mode where @picora/mcp-server runs as a child process over stdin/stdout, authenticated with an API Key. |
| Remote MCP | 远程 MCP | Hosted mode where the MCP server runs at mcp.picora.me over Streamable HTTP, authenticated via OAuth 2.1. |
| MCP tool | MCP 工具 | A function exposed to AI clients, always prefixed picora. (e.g., picora.upload_image, picora.list_docs). The v0.84.0 catalog holds 19 tools. |
| OAuth scope | OAuth scope | A permission boundary requested at authorization time, written in dot notation (e.g., media.write, kb.read). |
| Refresh token rotation | refresh token 旋转 | Each refresh exchange issues a new refresh token and revokes the old one (v0.14.0). |
Documents — Markdown & Typst (v0.15.0 / v0.82.0)
| Term | Chinese | Definition |
|---|
| Document format | 文档格式 | The markup language of a document: markdown (.md/.markdown) or typst (.typ). Mutually exclusive, decided by file extension. |
| Typst | Typst | A document compiler language (.typ). Source is compiled to paginated SVG — in Picora this happens in your browser. |
| Markdown rewriting | Markdown 改写 | Auto-converting embedded base64 images in uploaded .md files into Picora CDN URLs. Markdown only — Typst source is stored byte-for-byte. |
| CDN allowlist | CDN 域名白名单 | Admin-configured list of trusted CDN domains; URLs matching the allowlist are skipped during rewriting (avoid duplicate uploads). |
| Source hash | 源哈希 | SHA-256 of the rewritten markdown text; used for idempotent upload detection. |
| Online viewer | 在线浏览 | The web-based markdown renderer in picora-center’s Library. |
Bandwidth & degradation (v0.10.0)
| Term | Chinese | Definition |
|---|
| Bandwidth degrade | 带宽降级 | Auto-switching video playback to 360p when the user’s monthly bandwidth quota is exhausted. |
| Suspended | 服务暂停 | Status when bandwidth usage exceeds 120% — video playback returns HTTP 451 instead of media. |
| Bandwidth attribution | 带宽分摊 | Hourly cron job that attributes Bunny.net bandwidth back to individual users by storage ratio. |
Billing (v0.5.0+)
| Term | Chinese | Definition |
|---|
| Lemon Squeezy | Lemon Squeezy | Overseas payment gateway. |
| Polar | Polar | Alternative overseas payment gateway (v0.11.0). |
| Webhook | Webhook（保留英文） | Server-to-server callback used by payment providers and video transcoding services. |
Account & security
| Term | Chinese | Definition |
|---|
| OTP | 验证码 | One-time password / 6-digit email or SMS code. Use “验证码” not “OTP” in user-facing Chinese copy. |
| MFA | 多因素认证 | Multi-factor authentication. |
| Locale | 语言偏好 | The user’s preferred language for emails and UI (en / zh-CN). |
| Term | Chinese | Definition |
|---|
| Overseas platform | 海外版 | The Cloudflare-based deployment serving picora.me. |
| CN platform / Mainland platform | 国内版 | The Aliyun/Tencent-based deployment serving picora.cn. |
| Object storage | 对象存储 | Generic term for R2 (CF) / OSS (Aliyun) / COS (Tencent). |