# StoryForge 仓库边界说明

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

## 基本原则

- `StoryForge` 与 `AI Glasses` 是两个独立项目，分别独立维护。
- 当前仓库只负责 `StoryForge` 的产品、运行时、联调、部署与发布。
- `AI Glasses` 当前独立维护仓库为 [krisolo/ai-glasses](https://git.hyzq.site/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 拆分评估方案](./STORYFORGE_SPLIT_ASSESSMENT_2026-03-26.md)。

## 提交与同步边界

- 提交到 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` 作为统一回归入口。