快速开始

以下命令在取得的OG源码根目录运行。已有数据先备份；不要用重置数据库命令处理升级。项目已验证环境包括macOS、Node.js 22.23.1和npm 10.9.8，其他环境需自行验证。

安装与准备新库

npm ci
npm run db:generate
node --import tsx scripts/qa/candidate-init.ts .local/candidate-demo.db
cp -n .env.example .env.local

候选初始化脚本只接受项目内.local目录中的新.db文件，目标已存在时拒绝覆盖。它执行迁移并写入虚拟品牌资料，不生成AI内容。若所取得的源码不含该脚本，可以采用下方标准初始化；两种方式选择一种即可。

DATABASE_URL=file:./.local/demo.db npm run db:setup

标准初始化依次生成Prisma Client、应用迁移并写入安全合成种子。重复运行不会清空数据库；已有库仍应先备份。

配置与启动

在.env.local中填入自己的DEEPSEEK_API_KEY，保留默认模型或配置可用模型。不要把凭据复制到文档、截图或公开仓库。

DATABASE_URL=file:./.local/candidate-demo.db npm run dev -- --port 3105

如选择标准初始化，将启动命令中的数据库改为.local/demo.db。在本机打开http://localhost:3105。无登录页面，不能直接暴露到公网。

最小检查

打开品牌知识库，确认虚拟品牌与证据已显示；创建目标前检查价格、规格与活动规则。新生成需要联网和模型额度，失败不会替换为演示回答。语义检索首次下载见品牌知识与检索。