不改动 cmhub，也不依赖 cmhub 运行；核心逻辑是重写移植而非代码复用。
技术栈：Go + Gin + GORM + go-admin（管理端）+ html/template + HTMX + Alpine（用户端），MySQL 8.0，单库。
开发过程遵循 DevHarness：Gitea 工单是单次任务唯一事实来源，Gitea Wiki 管理长期文档，Git 记录代码变更，由人工确认方案与验收。

当前阶段

项目处于 MVP-0（跑通全流程的最小闭环）。目标不是把方案里的功能一次做全，而是先让一条数据从「用户提交提示词」走到「页面看到结果」全程可运行、可验证，再逐步补齐多 Provider 路由、熔断、管理端定制页等能力。

MVP-0 的范围、非目标和验收口径见产品需求总览。

快速开始（Wiki 初始化门禁）

线上 Gitea Wiki 已于 2026-08-20 初始化完成，当前 16 个映射页面均已创建并回读确认，docs/ 已转为只读镜像。以下是该门禁的完整顺序，供后续项目复用与核对：

创建 Gitea 远端仓库并推送当前引导提交，启用工单和 Wiki。
配置 wiki-docs.json 和安全访问方式；优先使用已配置的 Gitea MCP，MCP 不可用时才使用 Gitea API 并记录原因。令牌只通过环境变量或 MCP 安全配置提供。
按新项目文档初始化查询线上 Wiki；Home 不存在时先创建并回读 Home，取得 revision 后再创建其他核心页面。
逐页把 docs/ 中的初始内容写入 Wiki 并回读确认；本地 docs/ 的存在不能证明线上 Wiki 已初始化。
把项目不可违反的安全规则写入根目录或子目录的 AGENTS.md。
使用 .gitea/issue_template/ 中的模板创建第一个 Epic、MVP 和单元任务。

运行：

python dev_scripts/harness.py sync --verify

新仓库在 Gitea 尚未建立前允许一次不关联工单的引导提交。远端和工单系统配置完成后，新功能、接口/配置契约、数据库、高风险、跨模块和重大 UI 工作必须先有单元任务工单；明确的低风险修改边界见开发工作流。

默认不创建任务归档。任务专项快照和原型 HTML 只在用户明确要求或项目专用规则要求时创建；已有快照继续作为历史证据保留。

文档入口

想知道什么	读哪里
项目目标、环境、命令、目录边界	docs/00-project-profile.md
长期需求、MVP 分期、状态	docs/09-product-requirements-overview.md
代码从哪里开始读、两条主要执行路径	docs/02-architecture-and-code-map.md
术语、状态机、不能破坏的规则	docs/03-business-rules-and-glossary.md
怎样跑起来、怎样验证	docs/04-local-development-and-verification.md
简单修改怎么做、什么时候必须停	docs/05-common-changes.md
报错了先查什么	docs/06-troubleshooting.md
怎样部署、检查、备份和回退	docs/10-deployment-and-operations.md
建单、实施、验收、关闭流程	docs/01-workflow.md

docs/ 是 Wiki 的只读镜像，不是编辑入口。修改长期文档的顺序见项目档案的“文档状态”。

AGENTS.md                         Agent 的通用工作规则
CLAUDE.md                         Claude Code 的规则入口
.gitea/issue_template/            Epic、MVP、单元任务工单模板
docs/                             核心长期文档（Wiki 初始化后转为只读镜像）
docs/task/                        人工明确要求的专项或历史兼容 Wiki 快照
prototypes/                       按需导出的本地 HTML 原型快照
wiki-docs.json                    核心 Wiki 页面到本地镜像的显式映射
dev_scripts/harness.py            check / sync 入口，兼容 archive / export
tests/                            Harness 工具自动化测试

Go 代码目录（internal/core、portal/、admin/、migrations/）在 MVP-0 首个实现工单落地，规划见架构与代码地图。

README.md Unescape Escape

chorus

当前阶段

快速开始（Wiki 初始化门禁）

文档入口

目录

README.md