storyforge/docs/STORYFORGE_REPO_BOUNDARY_2026-03-26.md

StoryForge 仓库边界说明

本文档用于固定 StoryForge-gitea 的维护边界，避免把 StoryForge 与 AI Glasses 误判成同一个项目。

基本原则

• StoryForge 与 AI Glasses 是两个独立项目，分别独立维护。
• 当前仓库只负责 StoryForge 的产品、运行时、联调、部署与发布。
• AI Glasses 当前独立维护仓库为 krisolo/ai-glasses。
• 当前仓库已经移除混入的 android-app/ 目录；历史提交中的 Android / com.aiglasses.* 痕迹只作为拆分审计证据保留。

当前仓库内属于 StoryForge 的主维护范围

• collector-service/：StoryForge 后端与业务 API。
• web/storyforge-web-v4/：StoryForge Web 工作台和前端壳。
• scripts/douyin-browser-capture/：抖音浏览器辅助采集与工作台控制台。
• n8n/：StoryForge 编排工作流导出与说明。
• deploy/：StoryForge 部署模板与网关配置。
• docs/：StoryForge 审计、联调、实施与产品逻辑文档。
• docker-compose.yml、.env.example、scripts/start_business.sh、scripts/status_business.sh、scripts/smoke_business.sh：当前 StoryForge 运行与联调基线。

已拆出的独立项目边界

• AI Glasses 的 Android / BLE / Baidu / AAR / OTA 代码不再属于当前 StoryForge 主仓库边界。
• 与其相关的当前维护仓库、分支、发布应在 krisolo/ai-glasses 中进行。
• 若后续需要回看叠加来源，可参考 Git 历史中的 acb1103、ac6a8a8、7070c3a、fe07a5f 等提交，以及 StoryForge / AI Glasses 拆分评估方案。

提交与同步边界

• 提交到 Gitea 时，只纳入与 StoryForge 独立维护直接相关的改动。
• 原型、概念稿、临时预览图等目录只有在明确属于本轮 StoryForge 任务时才纳入提交。
• 本轮同步明确排除以下无关本次目标的本地变更：
  • concepts/studio-workbench/README.md
  • .tmp-previews-b/

本轮独立维护改动的收口范围

• 后端与部署安全收口：去掉默认超级管理员口令依赖，强化 orchestrator secret 校验，新增 readyz，修复 huobao/cutvideo 超时串线。
• n8n 工作流收口：内部回调地址与 secret 改为环境变量注入。
• Web 稳定性与结构收口：修账号切换竞态，收紧会话存储，引入平台能力 gate，并拆出首批运行时模块。
• 仓库边界收口：将混入的 android-app/ 从 StoryForge 主仓库移出，并确认 AI Glasses 继续在独立 Gitea 仓库维护。
• 基线验证：新增 scripts/check_repo_baseline.sh 作为统一回归入口。