Chinese–English glossary

Browse Saavo's Chinese and English terminology, code names, and commonly confused concepts by topic.

This glossary standardizes common names used throughout the preceding chapters and explains concepts found in English code, logs, and platform dashboards. Chinese terminology follows the conventions here. Filenames, types, configuration fields, commands, and protocol identifiers retain their source spelling.

Definitions apply to the current template and documentation context. Listing a technology or recovery mechanism does not mean the project implements it. For exact fields and defaults, see the Reference. For specific problems, see Troubleshooting.

Usage and writing conventions

  • When introducing an unfamiliar concept in Chinese, you can give the Chinese term followed by the English name in parentheses. Use the same term afterward.
  • Keep names such as Cloudflare, Stripe, OAuth, Webhook, API, URL, JSON, and SQL in English rather than forcing a literal translation.
  • Use backticks for identifiers, paths, commands, and literal values, such as DB, SAAS_SECRET, and payment_succeeded.
  • Prefer commas and periods in Chinese sentences. Use semicolons for parallel clauses whose structure requires that separation, not as the default ending for list items or ordinary sentences.
  • Specify the context when an English word has different meanings in different domains. For example, both a database transaction and a payment transaction use transaction.
  • “Template defaults” are values in the template source files. “Initialized configuration” may already have been rewritten by the CLI. “Effective configuration” also depends on the runtime environment and deployed version.
  • A claim of “support” requires an actual implementation and an entry point that invokes it. A type, error code, or example in a comment does not mean the corresponding feature is available.
  • Describe behavior with actions such as “read,” “write,” “send,” “match,” “grant,” and “revoke.” Avoid saying only “processing completed” without specifying which step completed.

Projects, versions, and development workflows

English / codeChinese termMeaning and usage
SaavoSaavoProduct name. Keep it unchanged
Saavo CLISaavo 命令行工具Tool for signing in, selecting templates, and creating projects, among other tasks. It is not the application runtime
template模板Base source code and configuration used to create a project
project / application项目 / 应用“Project” emphasizes source code and development. “Application” emphasizes the running product
initialization初始化Preparing the initial state of a project or resource. Specify whether it is local or remote
template version模板版本The source version of the template when obtained. Record it separately from the application version
application version应用版本Your own product's version. It cannot establish which template source was used
dependency依赖A third-party package or module installed and used by the project
lockfile依赖锁文件Records resolved dependency versions, for example package-lock.json
build构建Converts source code into build output. It is neither deployment nor database migration
type checking类型检查TypeScript static checking, distinct from a Vite build
lint代码规范检查Checks configured code rules. It does not replace tests of business behavior
test测试Uses inputs, operations, and assertions to verify expected behavior
branch分支A Git reference used to organize independent development work
commit提交A code snapshot in Git, or the action of creating one
tag标签Marks a Git state. It does not mean that state has been deployed
diff差异Changes between two code or configuration states
merge conflict合并冲突Changes on two sides cannot be merged automatically and require understanding before resolution
source archive源码包An archive of a specific source state. It excludes runtime data and Secrets
changelog / release notes变更记录 / 更新说明Internal records document implementation details. Public notes describe changes for users

Code structure and interface contracts

English / codeChinese termMeaning and usage
configuration / config配置Application settings and rules. Distinguish static configuration from runtime variables
source of truth权威来源 / 唯一依据The authoritative definition for a piece of data or a rule
schemaSchema / 数据结构Chinese documentation commonly retains “Schema” for configuration and input validation, and uses table or data structure terminology for databases
domain业务领域A business domain, distinct from a website's domain name
service服务层 / ServiceOrganizes business rules and workflows. Keep specific code names unchanged
repository仓储层 / RepositoryCalls the database access layer and converts stored values into business values. This is not a Git repository
DB access / DAO数据库访问层Handles SQL, raw rows, and database operations. DB on its own may also refer to a binding
UI界面 / UIUse the Chinese term for interface in user-facing text. UI can remain in discussions of architecture layers
DTO数据传输对象(DTO)A request or response structure at an API boundary, distinct from a raw database row
contract约定 / 契约Rules both sides of a call must follow, such as interface or data contracts
route路由The mapping between a request path, method, and handling entry point
endpoint接口 / EndpointAn entry point for external calls. Object names in platform dashboards can remain in English
handler处理函数A function that handles requests, messages, events, or commands
middleware中间件Shared logic executed during request handling
guard访问守卫(Guard)Checks access conditions. Return values and redirects depend on the call site
provider服务商 / ProviderAn external service provider in a business context, or an adapter implementing a capability in code
runtime运行时The execution environment or entry-point context, such as fetch, queue, or scheduled
context上下文Environment, language, logging, and other information needed for the current execution, such as Ctx or WorkerCtx
serialization序列化Converts data into a form that can be stored or transmitted. It is not encryption
validation校验Checks input formats, types, or constraints. Do not equate it broadly with user authentication

Cloudflare, environments, and storage

English / codeChinese termMeaning and usage
Cloudflare WorkersCloudflare WorkersPlatform name. An individual deployed application can be called a Worker. Do not translate it as a worker thread
Binding资源绑定 / BindingConfiguration that connects a Worker to a resource, with names such as MAIN_KV
resource name / resource ID资源名称 / 资源 IDA platform resource's name and identifier, distinct from its binding name in code
environment variable环境变量Configuration supplied through a runtime or build environment. Preserve variable names from the source
SecretSecret / 敏感配置A way to store sensitive variables in a Worker. Values may be keys, tokens, or passwords
SAAS_SECRET应用主密钥The project's long-term key for operations such as encryption and signing. It is not a version number
build-time variable构建时变量A value read during the build and potentially written into the output. Changes usually require a rebuild
runtime variable运行时变量A value read during application execution. Check the actual Worker's configuration
D1D1 数据库The template accesses two databases through DB and ANALYTICS_DB
DB业务库 BindingStores business data such as accounts, payments, and permissions
ANALYTICS_DB统计库 BindingStores first-party analytics data
KVKV 存储Key-value storage used by the template for content, logs, ticket bodies, and more. It is not just a cache
R2R2 对象存储R2 is the service name. A bucket is an individual storage container
bucket存储桶A container in object storage, such as the bucket referenced by MAIN_R2
object key对象 Key / 对象标识An object's name within a bucket, not an encryption key
Durable Object / DODurable Object / DOA Cloudflare component providing persistent state and coordination. Keep the name unchanged
local environment本地环境Runs on your machine. Resource state is managed separately from remote environments
local preview本地预览Viewing built output locally. It does not imply that a separate test Worker has been configured
staging environment预发布环境An isolated environment for validating behavior similar to production. The template does not automatically provide a complete one
production environment生产环境The environment that serves users
Origin源 / OriginA source defined by scheme, host, and port. It excludes the URL path
hostname主机名For example, app.example.com. It excludes the scheme and path
custom domain自定义域名A domain you own that is bound to the application

Databases, migrations, and data state

English / codeChinese termMeaning and usage
database数据库Specify whether it is the business, analytics, local, or remote database
baseline / initial schema初始表结构 / 数据库基线In these docs, a baseline is the starting point for initialization, not a backup or incremental migration
initialization script初始化脚本Prepares the initial schema. The template's *-init.sql files include table deletion operations
migration数据库迁移A versioned change to existing structures or data, not just copying data
seed data初始化数据Base or sample data written into a new environment. This term does not imply that the template provides a general seed command
record / row记录 / 数据行“Record” is common in business descriptions, while “row” is common in SQL contexts
raw row原始数据行Data returned directly by the database before conversion to business types
transaction数据库事务A transaction boundary for database operations, distinct from a payment transaction
primary key主键A key that identifies records in a table
foreign key外键Constrains references between records
unique constraint唯一约束Prevents duplicate combinations of specified field values
index索引Specify whether the context is a database index or a search index
backfill数据补写Adds values required by new rules to historical records
soft delete软删除Retains a record and marks it deleted. Restoration depends on the business implementation
purge彻底清除 / 物理删除Physically removes records with no ordinary undo operation. Recovery depends on backups or similar measures
revoke撤销Invalidates authorization, roles, entitlements, or tokens. It does not mean deleting historical records
expire / expiration过期 / 到期The end of a validity period. It does not mean records have been physically removed
retention数据保留策略 / 保留期A retention period is a duration. A retention policy also includes cleanup scope and execution rules
Unix timestampUnix 时间戳Specify seconds or milliseconds. Most persisted timestamps in the template use milliseconds
UTC协调世界时(UTC)A time standard. Do not treat it as the visitor's local time zone

Authentication, verification, and OAuth

English / codeChinese termMeaning and usage
authentication身份认证 / 用户认证Establishes a visitor's identity. Chinese prose can use the shortened term for authentication
verification验证Confirms a fact or submitted value, such as email ownership or a verification code
authorization授权 / 权限控制Use the Chinese term for authorization in OAuth contexts, and access permission control when discussing business access decisions
account用户账号A user's identity, distinct from an individual session
session会话Distinguish sign-in, verification, and OAuth sessions by purpose
CookieCookieData stored by a browser and sent according to rules. It is not the server-side session itself
sign up注册The account creation process
sign in / log in登录Both English expressions use the same Chinese term
sign out / log out退出登录Do not confuse this with deleting an account
account deletion注销账号Ends use of an account and handles its data according to business rules. It does not mean ending the current session
password reset重置密码Usually a recovery process when the original password cannot be used, distinct from changing a password
email verification邮箱验证Confirms email ownership. Distinguish verification by this site from a third-party provider's assertion
two-factor authentication / 2FA双重验证(2FA)Uses a second authentication factor. It is not simply entering a password twice
TOTP基于时间的一次性密码(TOTP)A dynamic code generated by an authenticator based on time
recovery code恢复码A backup verification method for 2FA, distinct from an email verification code
step-up authentication敏感操作二次验证Reconfirms identity before a specific operation. It does not necessarily use a new authentication factor
rate limit / throttling限流 / 请求节流Limits the frequency of operations. It does not mean permanently disabling an account
TurnstileCloudflare TurnstileAn anti-automation verification service, not user authentication or role-based authorization
OAuth 2.0OAuth 2.0An authorization protocol. Preserve the space in its name
OAuth ClientOAuth 客户端An application that initiates authorization and uses tokens, distinct from the signed-in user
authorization server授权服务器The party that handles authorization and issues tokens
Redirect URI回调地址 / 重定向 URIThe address used to return to the client in OAuth. Verify actual values against the protocol and configuration
authorization code授权码A code exchanged for tokens in an authorization flow, not an email verification code
Access Token访问令牌A token used to access protected resources
Refresh Token刷新令牌Used to obtain new tokens, not to download project source code again
Client Secret客户端 SecretA client credential, distinct from a user password or application master key
PKCEPKCEA verification mechanism linking an authorization request to a token exchange request. Preserve parameter names
Scope授权范围(Scope)An OAuth token's access scope, also called 作用域 in Chinese. It is not a user role
consent授权确认 / 同意Use authorization consent for OAuth pages and consent for cookie preferences

Roles, capabilities, and entitlements

English / codeChinese termMeaning and usage
access control访问控制The overall access rules for pages, APIs, and business operations
Subject授权主体(Subject)The recipient of role and entitlement grants. Specific types follow the project's definitions
role角色A set of static capability definitions associated with an identity or responsibility, such as admin
capability能力A basic authorization unit included in roles and entitlements. It is not limited to static permissions
static capability静态能力Corresponds to CapabilityType.Static and is provided by role configuration
boolean capability布尔能力Corresponds to CapabilityType.Boolean and expresses whether a feature is available
numeric capability数值能力Corresponds to CapabilityType.Numeric and expresses measurable resources or quotas
entitlement权益Product access or resource rules granted to a subject. It can include dynamic capabilities
grant授予Adds a role or entitlement to a subject while preserving its source relationship
grant source授予来源Identifies the purchase, subscription, or system operation that provided access
quota额度 / 配额An available resource quantity or limit. The business defines its exact meaning
credits积分Consumable numeric resources defined by a product. They do not automatically represent a monetary balance
entitlement cycle权益周期The processing schedule for recurring entitlements. Describe it separately from the payment billing cycle

For example, a role can provide a static capability to manage users. A download entitlement can provide a boolean capability that determines whether downloads are allowed, as well as a numeric capability for the download count. A role or entitlement name is not the result of a capability check, and purchasing a plan does not automatically grant every paid feature.

Products, payments, and commercial features

English / codeChinese termMeaning and usage
product产品The application's own product configuration. Describe it separately from a Stripe Product object
Plan套餐A purchase option under a product. Use the designated Chinese term consistently rather than alternating with terms for a plan, proposal, or subscription tier
Stripe ProductStripe ProductA product object in Stripe
Stripe Price / Price IDStripe Price / Price IDStripe's price object and identifier, with values such as price_...
connection ID支付连接 IDA stable identifier the project uses for a payment connection, such as STRIPE_CONNECTION_ID
billing计费Describes charging methods and cycles. Do not label the entire module as invoices
subscription订阅A recurring billing relationship, distinct from an individual charge transaction
one-time purchase一次性购买A single payment. It does not automatically imply permanent entitlements or lifetime service
CheckoutCheckout / 收银台The payment checkout flow or page
Checkout SessionCheckout 会话An object representing one checkout flow, not a user sign-in session
payment customer支付客户A customer association on the payment provider's side, distinct from an application user record
transaction交易A business transaction in a payment context, distinct from a database transaction
line item明细项One product or charge entry in a transaction, subscription, or similar object
Billing Portal账单门户An entry point for users to manage payment and subscription information
Invoice账单 / Stripe InvoiceRetain the object name in technical explanations. Do not assume it means a Chinese tax invoice
trial period试用期Trial time provided according to plan or subscription rules
Coupon优惠券(Coupon)A Stripe object that stores discount rules
Promotion Code促销代码A user-entered code associated with a Coupon
Coupon Offer动态优惠活动The template's feature for selecting discounts through links, also called dynamic coupon codes in the relevant chapter
refund退款Distinguish requested, processing, successful, and failed refunds. A refund does not automatically revoke entitlements
affiliate联盟推广A feature through which affiliates earn income from referrals
referral推荐 / 推广来源In affiliate contexts, use referral link or referral source terminology. Do not confuse it with payment callbacks
commission佣金An earnings record from affiliate referrals
payout佣金支付 / 收益支付Pays eligible earnings to an affiliate. It is not a refund to a purchaser

Display prices, Stripe Prices, purchase transactions, and access entitlements are four different concepts. Displaying an amount on a page does not change what Stripe charges. Even after payment, a success page alone does not prove that entitlements were granted.

APIs, webhooks, and error handling

English / codeChinese termMeaning and usage
APIAPI / 接口Preserve the actual definitions of paths, methods, and parameters
request / response请求 / 响应Input and output at an HTTP or other explicit call boundary
request body / payload请求体 / 载荷A request body belongs to HTTP. A payload can also be message or event data
callback回调Broadly, calling another entry point after completing a step. Specify whether it is an OAuth or business callback
WebhookWebhook / 服务端回调An external service delivers events to the application. It is not the browser returning to a success page
signature verification签名验证 / 验签Checks origin and integrity. It does not decrypt the content
raw body原始请求体Request content that has not been reparsed and serialized. Preserve it for webhook signature verification
HTTP status codeHTTP 状态码For example, 200, 401, 403, or 500. It is distinct from a business error code
result code / error code结果码 / 错误码Allows programs to determine results. Distinguish the project's numeric codes from third-party string error codes
APIResponse<T>API 响应类型约定A type provided by the template. Not every actual endpoint returns the same complete structure
retryable可重试Allows another attempt under the relevant conditions. It does not guarantee that the next attempt will succeed
non-retryable不可重试The current failure should not be retried automatically. Input may need correction or side effects may need checking first
fallback备用值 / 备用处理Specify the fallback value or path. Do not confuse it with a version rollback
side effect副作用 / 外部效果An actual effect such as a data write, sent email, or payment. A code rollback may not undo it

Background jobs, messages, and execution records

English / codeChinese termMeaning and usage
background job后台任务Work performed in the background. It does not automatically mean the work has been enqueued
Cloudflare Queues / Queue队列Used to deliver messages. Preserve queue and binding names
producer / consumer生产者 / 消费者The sender of a message and the party that receives and processes it
enqueue入队Places a message in a queue. It does not mean the business operation has completed
acknowledgement / ack消息确认Indicates that this message delivery no longer needs to be retried. It does not necessarily mean the business operation succeeded
redelivery重新投递A queue or provider delivers a message or event again
retry重试Specify whether it means a Command execution retry, an HTTP retry, or Queue redelivery
replay重放Processes a historical event or task again. Check idempotency and effects that have already occurred first
idempotency幂等性 / 幂等处理Repeating the same business operation does not duplicate effects within the defined scope
idempotency key幂等键Identifies the same business operation within the relevant scope, for example idempotencyKey
lease租约The right to process work for a limited time, used to coordinate concurrent execution
dead-letter queue / DLQ死信队列(DLQ)A queue that receives failed messages. Do not imply that the current template configures one for every queue
ReactionReactionThe project's internal system for organizing business events and command execution
Event业务事件 / Reaction EventDescribes a business fact that has occurred, with type names such as PaymentSucceededEvent
Command业务命令 / Reaction CommandAn execution step produced by an event, with type names such as GrantRoleCommand
Event executionEvent 执行记录Corresponds to event_execution. Distinguish it from an external provider's Event ID
Command executionCommand 执行记录Corresponds to command_execution and stores step status and execution information
synchronous / sync同步Processes work directly in the current execution flow
asynchronous / async异步Schedules work separately from the current step. The template's asynchronous Commands are processed through a queue
Cron TriggerCron 定时触发器Determines when a task is triggered. Its expression is called a Cron expression
scheduled handler定时任务入口The Worker entry point that handles scheduled triggers

Specify which object a status belongs to

StatusMeaning in this project
Webhook processingThe event processing record holds a lease. Check its update time to assess actual progress
Webhook succeededProcessing of this event has been recorded as successful. It does not guarantee completion of every subsequent asynchronous effect
Webhook failedProcessing of this event failed. Use the error records to investigate
Command pendingNot yet finished. It may be waiting for execution or a retry
Command succeededThe command succeeded and its result was saved
Command failedThe command ended with a business failure
Command erroredThe command ended with an exception
Event completedA completion status computed from its Commands
Event partial_failedExecution was allowed to continue after failure, all steps have ended, and at least one business failure occurred

Event status is computed from Command statuses. There is no separately persisted status column in event_execution. This table is not a complete list of all statuses. See Domain events and commands.

The word Event may also refer to a Stripe event or an analytics event. When describing flows across systems, specify “Stripe Event ID,” “Reaction execution ID,” or “analytics event.” Do not use a single “event ID” to refer to identifiers across all systems.

Content, analytics, and internationalization

English / codeChinese termMeaning and usage
MDXMDXA Markdown file format that supports component content. Follow the project's component conventions
FrontmatterFrontmatter / 文档元数据Metadata such as titles and descriptions enclosed by --- at the start of a file
content collection内容集合Structured content generated from source files such as documentation and blog posts
search index搜索索引Output used for search queries, distinct from body content or a database index
Slug路径标识(Slug)A path identifier in a content URL. Routing rules determine the actual path
analytics访问统计 / 统计This project's traffic and behavior analytics feature
first-party analytics第一方访问统计Analytics collection and reporting provided by this application itself
third-party analytics第三方统计服务Services such as Google Analytics and Clarity. Distinguish their configuration from first-party analytics
tracking event统计事件 / 事件采集The first Chinese term refers to a record, the second to the collection action. Neither is a business Event
page view / PV页面浏览 / 页面浏览量A page view or its count, not a count of unique visitors
visitor / visit / session访客 / 访问 / 统计会话Distinguish identity from the visit process according to the analytics implementation. These are not sign-in sessions
funnel转化漏斗Tracks completion and conversion across a set of steps
Do Not Track / DNT请勿跟踪(DNT)A browser tracking preference signal, not a cookie consent record
Cookie consentCookie 同意管理Manages consent preferences and the conditions for enabling related scripts
internationalization / i18n国际化The structures and mechanisms that allow an application to support multiple languages
localization / l10n本地化Translating content and adapting its presentation for a language or region
locale语言标识 / LocaleIn these docs, often an identifier such as en or zh-Hans. It does not necessarily include a region
language code语言代码Preserve actual configuration values, such as zh-Hant
translation key文案键A path used to find text in the standard language resources
LocalizedText可本地化文案配置A configuration object containing key and value, not a plain string
translation fallback文案备用值Content used when a translation is missing. It does not mean translation is complete
Newsletter邮件订阅A subscription to website update emails, not a paid product subscription

Analytics data helps observe visitor behavior. It cannot replace a payment ledger or audit records. An analytics session count cannot be treated directly as a count of signed-in users either.

Deployment, recovery, and maintenance

English / codeChinese termMeaning and usage
deployment部署Publishes the application and related runtime configuration to a target environment
release发布 / 版本发布May include code, configuration, data, and public notes. Specify the actual operations
upgrade / update升级 / 更新Specify whether the target is the CLI, template, dependencies, or live application
breaking change不兼容变更A change that prevents existing data, configuration, or usage from continuing to work without changes
backward compatibility向后兼容The new implementation still handles old inputs or states within a defined scope. It does not promise compatibility forever
health check健康检查Checks specified entry points or conditions. It is not full business acceptance testing
backup备份A copy retained for recovery. Specify which resources it includes
restore恢复Reconstructs state from a copy or recovery point. It may affect writes made after that point
recovery point恢复点A specific historical state available for recovery
Time TravelD1 Time TravelD1's point-in-time recovery mechanism, not an automatic rollback of the entire application
rollback回滚 / 版本回退Specify whether code, configuration, or data is being rolled back. Do not broadly promise to undo everything
roll forward向前修复Repairs the current state through subsequent changes rather than restoring an old version
log / audit log日志 / 审计日志Logs record runtime information. Audit logs track operations that require auditing
alert告警A notification of an abnormal condition requiring attention or action, distinct from an ordinary business notification
observability可观测性The ability to understand system state through logs, metrics, and execution records
incident / troubleshooting故障 / 故障排查An incident is a problem. Troubleshooting is the process of gathering evidence and locating its cause

Updating the CLI does not automatically update projects already created. deploy:update deploys code from the current directory and does not download a newer template either. Rolling back code does not automatically undo database migrations, completed payment transactions, or sent emails. See Upgrades and maintenance.

Maintaining this glossary

Add a term only when it recurs across articles, its translation is easy to confuse, or a misunderstanding could affect configuration or business behavior. Keep definitions concise and link to the relevant chapter for detailed procedures. Do not duplicate a tutorial in the glossary.

Before changing a term, check the source code responsible for the concept and the existing articles. Adding an English alias or clarifying context does not require mechanically replacing every expression. If you change an established Chinese name, also check body text, headings, and links so that the glossary and tutorials use consistent names.