从注册到挂车视频，一份指南搞定

这份文档教你三件事：1）注册账号开始用；2）填入你自己的 API key 让所有调用走你的配额；3）把自己的 TikTok Shop 店铺绑定进来。整个流程 10 分钟。

1. 注册账号 & 登录

打开 aicockpit.io/app.html，右上角点 "注册"。需要：

• 一个能记住的邮箱（v1 不发验证邮件，邮箱仅作为登录账号）
• 至少 8 位的密码
• 姓名可选

注册完成自动登录，30 天 cookie 保活——之后开浏览器不用每次重新登。

2. 填入你自己的 API key

登录后，右上角头像旁边点 "设置"，弹出"我的 API Keys"面板。需要填两把：

2.1 DashScope（阿里通义） — 用于语音合成

1. 登录 dashscope.console.aliyun.com（阿里云账号即可）
2. 左侧菜单 → "API-KEY 管理" → "创建新的 API-KEY"
3. 复制 sk-... 开头的字符串
4. 回到 aicockpit 设置面板，粘贴到 "阿里 DashScope" 输入框 → 保存

之后所有语音合成（美嘉播报、试听）都按你的 DashScope 账户算钱，CosyVoice v2 的话大约 ¥0.005 / 1k 字符。

2.2 Anthropic — 用于 Claude AI 聊天

1. 登录 console.anthropic.com
2. 顶部 "API Keys" → "Create Key"
3. 复制 sk-ant-... 开头的字符串
4. aicockpit 设置面板 → "Anthropic" → 粘贴 → 保存

之后 hero 聊天、巡店对话都按你的 Anthropic 账户算钱。Claude Sonnet 4 大约 $3 / M input tokens, $15 / M output。每次完整对话通常 $0.01-0.10。

3. 绑定你的 TikTok Shop 店铺

设置完 key 后，回到 hero 主页。顶部店铺胶囊条最右边有 "+ 店铺绑定" 按钮。

1. 点 "+ 店铺绑定"
2. 弹出 TikTok Shop OAuth 授权页（services.tiktokshop.com）
3. 用你的 TikTok Shop Seller 账号登录
4. 勾选授权范围（建议全选给最大权限），点同意
5. 页面自动跳回 aicockpit，几秒内你的店铺会出现在 hero 顶部条上，带"✓ 挂车" 绿色标

有多家店？OAuth 一次性能授权所有同 app 下的店铺，全部自动加入你的账号。如果你在不同 TikTok app 下有店，分别走一次 OAuth 即可。

4. 跟美嘉语音对话

右上角看到你的邮箱+头像就说明登录态正常。然后：

• 按住 🎙 麦克风 不要松开（光标可以离开按钮区，pointer events 锁定）
• 说你的指令，比如："列出我的店铺" / "把 SKU PDTK004 改价到 19.99"
• 松开 → 输入框出现识别结果（停 0.7 秒让你看清楚）→ 自动发送给 AI
• 美嘉用台湾女声播报（默认 longxiaoxia_v2 + 嗲嗲口吻 + 称呼"老板"）
• 嘴巴动画暂时移除了（先稳定其它部分），后续会用 Lottie 重做

不想出声？点 🔊 喇叭按钮变灰 → 只看文字。localStorage 记住你的偏好。

5. 发挂车视频

这一块的 UI 还在 PAGE 2，目前流程已通：上传视频 + 选商品 + 选发布账号 → 提交 → 跑 6 步 TikTok Creator API → 完成后视频进入达人草稿/SELF_ONLY，需要达人本人 TikTok app 里手动审核+发布。这部分文档将在下一版更新更详细的截图。

配额、计费、隐私说明

多租户隔离

• 每个用户的店铺、达人、tokens、API keys 都在数据库以 user_id 做命名空间
• 用户 A 的 chat 永远看不到用户 B 的店铺（MCP 层走 ALLOWED_ALIASES 严格白名单）
• 用户 A 的 TTS 调用走他自己的 DashScope key，不会动用户 B 的额度
• admin 才能用 /api/admin/users 查所有用户的汇总

常见问题

登录没反应/点不动

Cookie 域名设置 SameSite=Lax，必须用 https://aicockpit.io（不能用 IP 直连）。如果浏览器禁用第三方 cookie 是可以的，本站点是 same-origin。

填 DashScope key 之后还是 401

需要硬刷新一次（Cmd+Shift+R）让前端拿到新状态。或者 console 跑 fetch('/api/auth/me').then(r=>r.json()).then(console.log) 验证。

店铺绑定弹窗失败

检查浏览器没拦截弹窗。如果拦了，店铺绑定页会改成当前 tab 跳转。完成后 TikTok 会跳回 aicockpit。

美嘉中文播报有怪音

这是 DashScope CosyVoice 的限制，特别是英文字母、长串数字、emoji。后端有 cleanForTTS 做了清理但不是万能。建议：让 AI 用纯中文回复（system prompt 已经要求），别让她念 SKU 长 ID。

密码忘了/邮箱写错了

邮件管理员（你部署 aicockpit 的人）。后续版本会接 Aliyun DirectMail 做自助密码重置。

能商用吗？

aicockpit 本身免费。但你需要为以下三方服务付费：阿里云 DashScope（语音合成）、Anthropic（Claude API）、TikTok Shop（OAuth 应用注册，多数场景免费）。