storyforge/docs/STORYFORGE_REPO_BOUNDARY_2026-03-26.md

StoryForge 仓库边界说明

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

基本原则

• StoryForge 与 AI Glasses 是两个独立项目，分别独立维护。
• 当前仓库只负责 StoryForge 的产品、运行时、联调、部署与发布。
• 后续在本仓库中看到的 AI Glasses 命名残留，应优先视为历史迁移残留或暂未完成的命名收口，不应直接推导为“需要删除 AI Glasses 项目代码”。

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

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

需要特别注意的命名残留

以下内容说明 Android 客户端曾沿用旧命名空间，但当前业务入口已经是 StoryForge：

• android-app/app/src/main/java/com/aiglasses/app/：Android 包名仍是 com.aiglasses.app。
• android-app/app/src/main/java/com/aiglasses/app/MainActivity.kt：入口已经直接加载 StoryForgeScreen 与 StoryForgeViewModel。
• android-app/app/src/main/res/values/themes.xml：主题名仍为 Theme.AIGlasses。
• android-app/app/build.gradle.kts：构建命名空间仍与 com.aiglasses.* 保持一致。

这些文件目前应被视为 StoryForge Android 客户端的迁移残留，不属于“删除 AI Glasses 项目代码”的操作范围。若未来要统一命名，应作为独立重构任务推进，而不是在日常功能开发中顺手清除。

提交与同步边界

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

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

• 后端与部署安全收口：去掉默认超级管理员口令依赖，强化 orchestrator secret 校验，新增 readyz，修复 huobao/cutvideo 超时串线。
• n8n 工作流收口：内部回调地址与 secret 改为环境变量注入。
• Web 稳定性与结构收口：修账号切换竞态，收紧会话存储，引入平台能力 gate，并拆出首批运行时模块。
• Android 安全收口：会话加密存储、明文流量白名单、敏感输入遮罩、日志级别收紧。
• 基线验证：新增 scripts/check_repo_baseline.sh 作为统一回归入口。