快速开始 - opcstack

1. 使用 Agent 创建

首次使用：

Create an OPCStack app named <APP_NAME> by following:
https://raw.githubusercontent.com/glidea/opcstack/main/QUICK_START.md

Agent 会按照当前平台规范安装用户级 create-opcstack-app Skill，然后创建并初始化项目。如果 <APP_NAME> 没有替换，Agent 会先询问应用名。

以后创建新项目时直接调用已安装的 Skill：

Use create-opcstack-app to create an app named <APP_NAME>.

Skill 每次运行都会读取最新流程，不需要手动更新。

2. 手动安装

git clone https://github.com/glidea/opcstack <your-app-name>
cd <your-app-name>
git remote rename origin upstream
pnpm install
vim .env.dev
pnpm dev

启动后打开 http://localhost:5173

首次准备前填写 SYSTEM_EMAIL。准备脚本用它创建 D1 管理员，并在终端显示随机的一次性密码。登录后在设置页修改密码，再到后台系统设置配置业务能力。.env.dev 和 .env.prod 还负责构建期主题和 R2 上传策略。内部根密钥由脚本自动生成，业务凭据加密保存在 D1。

3. 部署到 Cloudflare

pnpm deploy:cloudflare

首次远程部署时会提示创建 Cloudflare API Token。按链接创建后粘贴一次即可。之后 Token 会缓存在 .wrangler/cloudflare-api-token。

完整的资源供给和部署流程请参阅部署。

4. 访问管理控制台

使用首次准备流程打印的管理员邮箱和一次性密码登录，在设置页修改密码，然后打开 /{locale}/admin。全部页面和运营操作参阅管理控制台。

5. 开发浏览器扩展

pnpm dev:extension
pnpm build:extension

扩展的入口点和共享前端层请参阅前端。

可选：中国访问域名

如需独立的中国入口，在 .env.dev 或 .env.prod 中设置 APP_CN_DOMAIN。prepare:cloudflare:* 会将其接入 R2 CORS 和 Turnstile 域名。不设置 APP_CN_CNAME_TARGET 时使用 Worker 自定义域名；设置后保留优选 CNAME，并通过普通 zone route 接入 Worker。

同步模板更新

git fetch upstream --tags
git merge upstream/main