生产部署记录（2026-09-12）

发布

发布提交：49a916b（首页菜单增加"主页"入口；全站按钮改为透明底 + hover 动态背景，按钮内文字前加品牌 logo 小图标 components/brand-icon.tsx；CMS 中文化标签、i18n（en/zh）、自定义退出按钮 /cms/api/cms-logout）。
发布目录：/home/flym/releases/49a916b-www（www，服务器构建）、/home/flym/releases/cms-49a916b（CMS，服务器构建）。
软链：kaotings-www→releases/49a916b-www、kaotings-cms→releases/cms-49a916b、kaotings-api→releases/ad87a71/services/api（未变更，未重启）。
数据库迁移：无（CMS 改动仅为标签/i18n/组件，无字段结构变化）。

本地提交 49a916b 并推送 origin（57c854a..49a916b）。
git archive 打包 www 全量与 apps/cms，scp 上传（kaotings_deploy 密钥）。
服务器 cp -a 上一发布后解包覆盖；关键文件 SHA256 与本地一致（lib/content.ts、brand-icon.tsx、payload.config.ts）。
服务器构建：www（NODE_ENV=production CMS_PUBLIC_API_URL=http://127.0.0.1:3001/cms npm run build）与 CMS（npm run build）均成功。
CMS 产物完整性：.next/node_modules 经符号链接实文件 319 个（pino 207），符合"服务器构建"要求，无 09-11 的 Windows 构建空目录问题。
切换顺序：先 CMS（重启 kaotings-cms，验证 200）→ 再 www（重启 kaotings-web）。软链属主为 flym，切换本身无需 sudo；仅 systemctl restart 使用 sudo。

www 回滚：kaotings-www→releases/ad87a71-www + systemctl restart kaotings-web。
CMS 回滚：kaotings-cms→releases/cms-ad87a71-c + systemctl restart kaotings-cms。
无迁移，回滚无数据兼容问题。

systemctl is-active：kaotings-api / kaotings-cms / kaotings-web 均 active。
GET /healthz（127.0.0.1:8000 与 https://www.kaotings.com）：ok / 200。
www 首页（本地 3000 与外部 https 一致）：主导航含"主页"（→/）；登录/联系我们为统一透明底按钮（hover 出背景）；页面 /_next/image 图标 18 处（含按钮 logo 与品牌标）；/icon.png 200。
CMS：/cms/admin 200；/cms/api/products?where[status][equals]=published 200（www 产品列表依赖正常）。
管理端中文标签/i18n 与退出按钮：代码已上线，登录态界面待人工目视确认。

提交	内容	发布目录
`a06b5f4`	所有按钮 hover 统一为登录按钮的青色亮底，去除橙色	`releases/a06b5f4-www`
`d296b7a`	页头登录态感知（我的页面/退出登录）；修复 `lib/admin.ts` 请求丢失 Content-Type 导致删除用户 422	`releases/d296b7a-www`
`af5b4af`	退出登录后统一跳首页（页头与账户中心）	`releases/af5b4af-www`
`86fc51e`	管理后台 TTS 配置（迁移 `007_tts_settings.sql`，DB 优先于 env；GET/PUT `/admin/tts/settings` + POST `/admin/tts/settings/test` 探测；worker 动态读配置，兼容 mp3）	`releases/86fc51e`（www + API 同目录）

86fc51e 已应用迁移（schema_migrations 001–007 齐全）；/api/v1/admin/tts/settings 未登录 401；三服务 active；外部首页 200。
当前软链：kaotings-www→releases/86fc51e、kaotings-api→releases/86fc51e/services/api、kaotings-cms→releases/cms-49a916b。
待办：管理员在后台“TTS 配置”页填入上游地址与 API Key（探测通过后保存），解决生产 UPSTREAM_NOT_CONFIGURED；上游凭据仍建议只走后台配置，不写入 api.env。