本机演示数据

seed_home_workbench.py 给创业平台首页工作台造一套演示数据：只经 HTTP 接口（假登录头 Fake <subject>），不直接写库，可重复运行。只接受 127.0.0.1／localhost 的后端，其余地址直接退出 2。

运行前提

本机栈要和 apps/web/playwright.config.ts 的 webServer 段一样接仓库内的假服务。区别只有一处：库用开发库 venture_os，不用 venture_os_e2e（端到端每轮会清空那个库）。

1. 库：仓库根 make db-up，然后在 apps/api 下执行 uv run alembic upgrade head。
2. 假服务（都在 apps/api 下，各开一个终端）：
   • 假积分：uv run python -m tests.fake_credits --port 9801
   • 假 CS：uv run python -m tests.fake_cs --port 9800 --service-name venture_os_cs
   • 假漫剧平台：uv run python -m tests.fake_story --port 9810（脚本只用手工资产，不调它；和端到端保持一致，方便演示时在界面上导入项目）
3. 后端：.env 里要有 APP_ENV=local、FAKE_LOGIN_ENABLED=true、DATABASE_URL 指向 venture_os、CS_HOST=http://127.0.0.1:9800，积分一组照抄 .env.test（AGENTIA_CREDITS_ENABLED=true、AGENTIA_CREDITS_BASE_URL 与 BTS_BASE_URL 指向 http://127.0.0.1:9801，以及同一份假密钥），然后 uv run uvicorn app.main:app --port 8000。档里不能有公司凭据或 CLOUD_CONFIG_*。
4. 管理员：脚本用 uc-demo-admin 发任务、建认证、公开作品。第一次运行会让它先登录一次，然后停下，提示执行 uv run python -m app.cli grant-admin uc-demo-admin；授予后重跑即可。

运行

uv run --directory apps/api python -m tests.demo.seed_home_workbench \
  --base-url http://127.0.0.1:8000 --demo-at 2026-10-16T14:00:00+08:00

必须在 apps/api 里运行（这里用 --directory）：tests 包从当前目录导入，只写 --project apps/api 找不到它。--demo-at 是演示时刻，必须带时区；截止时间都按它算。一次完整运行约 50 秒，大部分时间在等假积分发放预付和尾款。

造出什么

不造团团项目：项目归团团那一路，首页本批也不读项目。

重复运行与边界

• 判重按固定 subject 与任务标题：已有的任务、认证、承接、交付原样复用，只补缺的那一步。第二次运行不会再发任务。
• 「−1 天」那单的意思是演示时它已过期。运行时如果它的截止已经过去，发布接口不收，脚本跳过这一单并给出提示，公开任务仍有 8 条。
• 任务已经存在时，截止时间不会随新的 --demo-at 改。要换演示日，就换一个空库重跑。

冷启动内置数据

seed_cold_start.py 给平台放一批「别人做的作品」、几条开着等人接的任务和可以去学的官方认证：新用户自己还没有单时，首页「看看别人在做什么」与发现页「作品」页签里也有东西可看，「我能接的单」里有单可接，认证目录里有可学的认证。看板卡 AIC-3277。和上面的首页演示数据不同，这批内容会放到测试环境给真实新用户看，所以标题与说明写成真实需求的口吻，不出现「演示」「测试」字样。

放了什么

每件作品走一遍真实业务流程，不直接写库：管理员发布任务（任务封面＝作品封面）→ 承接账号先为任务要求的认证提交截图，再承接 → 交付三件套（工程包 ZIP：全部原图＋交付说明；成片：脚本用 ffmpeg 把封面与两张过程图合成约 11 秒的 1280×720 MP4；过程资产：两张过程图；另传封面作为作品封面）→ 提交即系统自动验收、发尾款、生成隐藏作品 → 管理员设为公开。成片与工程包在临时目录现做，不入库。本机要装 ffmpeg。

开放任务：只发布、不承接

作品是「发布 → 承接 → 交付 → 公开」走完的成品；开放任务是另一种流程，只由管理员发布，不承接、不交付，以开放状态挂在平台上等新用户来接。两类的用意是新用户在首页「我能接的单」里两组都有单：四条新手练习进「现在就能接」，接下来去 Story 做一条 15 秒左右的短片，走一遍「接单 → 制作 → 交付 → 系统验收 → 拿到报酬」；两条 AI 漫剧需求要求「AI漫剧制作流程」，没有这项认证的人在「差 1 个认证」里看到，学习推荐因此写「学完可多接 2 单」，引他去拿认证。交付门槛和普通任务一样（工程包 ZIP 或 Story 工程二选一、一个成片视频、至少一个过程资产，见 app/deliveries/README.md），所以新手题目都设计成一两个小时能做完、三样都交得出来的练习。

• 新手练习不要求认证：发布接口原先要求至少一项官方或自定义认证，10-16 白晨定放开（app/tasks/schemas.py 的 require_bounded_response、前端 features/tasks/logic.ts 同步放开，AC-231）。不要求认证的任务在前台任务卡上写「无需认证」，谁都能直接承接。测试环境要先部署含这处改动的后端，browser 路线才发得出新手单。
• 新手练习的奖励是最小档位，不是 0：白晨原意是 0 积分，但发布必须从奖励目录选预付、尾款档位（app/tasks/schemas.py:47-54 必填），0 积分档位在规则判定里不可用（app/credits/rule_policy.py:139，credits <= 0 判 not_fixed_positive_credits）。所以清单里不写积分，预付与尾款都取目标环境奖励目录里积分最少的档位（本机假积分服务是 1 积分），脚本读目录时自动选、不写死数值，只读核对会打出取到的档位。AI 漫剧需求两条照作品的量级写明积分。
• 任务类型都用「AI 漫剧制作」：库里有 CHECK 约束、接口只收这一种（alembic/versions/0003_tasks.py:56），新增「新手练习」类型要迁移，10-16 定不做；新手单靠标题前缀「新手练习：」和需求方区分。
• 一张单只能一个人接：接走就从公开列表消失（白晨接受）。判重按标题，同名任务已在（不论有没有人接走）就不再发；要再放一批，改标题重跑。
• 挂着时首页不显示学习引导：「我能接的单」只在平台上没有开放任务时才改做学习引导（apps/web/src/features/workbench/rules/opportunities.ts 的 hasOpenTask），开放任务挂着，新用户看到的是任务清单而不是认证引导。六条都被接走或过期后，引导才会回来。

本机跑

本机栈同上文「运行前提」，库换成独立的冷启动库（不要用开发库，也不要用端到端每轮清空的 venture_os_e2e）：

docker exec venture-os-postgres-1 psql -U venture -d postgres -c "create database venture_os_coldstart"
cd apps/api
DATABASE_URL=postgresql+asyncpg://venture:venture@127.0.0.1:5433/venture_os_coldstart uv run alembic upgrade head
DATABASE_URL=postgresql+asyncpg://venture:venture@127.0.0.1:5433/venture_os_coldstart \
  uv run uvicorn app.main:app --host 127.0.0.1 --port 8002
# 管理员：先让它登录一次，再授权（grant-admin 读的也是 DATABASE_URL，要指向同一个库）
curl -s --noproxy '*' http://127.0.0.1:8002/me -H "Authorization: Fake uc-official-ops" >/dev/null
DATABASE_URL=postgresql+asyncpg://venture:venture@127.0.0.1:5433/venture_os_coldstart \
  uv run python -m app.cli grant-admin uc-official-ops
# 导入（仓库根）
uv run --directory apps/api python -m tests.demo.seed_cold_start local --base-url http://127.0.0.1:8002

管理员默认 uc-official-ops，承接账号默认 uc-studio-creator（--admin／--worker 可改）；认证截图用仓库里的测试图片。加 --plan 只读核对、不写。一次完整运行约一分钟，多半时间在等假积分服务确认预付与尾款。

对测试环境跑

测试环境走公司 UC 登录，每个请求要 UC SDK 现算 MAC 签名，脚本自己没有签名能力，也不碰令牌。做法是在已登录的浏览器页面里发请求：脚本把每个请求写成一段代码，经 playwright-cli -s=<会话> --raw run-code --filename=… 交给那个会话执行；页面里按应用自己的规矩取后端地址（window.__VENTURE_RUNTIME_CONFIG__.VITE_API_BASE_URL，测试环境是 https://venture-os.debug.ndaeweb.com）、用运行配置里的网关与 sdp-app-id 构造 UC SDK、对「后端实际收到的绝对地址」现算签名头，再 fetch。签名头与令牌只在页面里用，不回传给脚本。文件上传把字节以 base64 带进页面再组 FormData。

前置（要白晨本人）：

1. 两个账号：管理员（白晨）与另一个公司 UC 测试账号（承接）。两人不能是同一账号，脚本开头会核对。
2. 积分：发布任务会冻结并按奖励目录扣管理员账号的积分，六件合计预付 1,600、尾款 3,500 积分（以 works.toml 为准），开放任务里两条 AI 漫剧需求另需预付 500、尾款 1,200，四条新手练习各占预付、尾款各一个最小档位；写明积分的档位必须在测试环境的奖励目录里存在，只读核对会先报出缺的档位，并打出取到的最小档位。
3. 认证截图：承接账号要先为「AI漫剧制作流程」提交一张截图（--cert-screenshot），提交即认证、本人不能替换，只有管理员能在后台移除；账号已有这项认证则跳过。
4. 登录：主控开两个有界面的会话，白晨分别登录：

mkdir -p /tmp/vos-cold-start-pw && cd /tmp/vos-cold-start-pw
playwright-cli -s=cold-admin open --headed --persistent https://start.debug.ndaeweb.com/
playwright-cli -s=cold-worker open --headed --persistent https://start.debug.ndaeweb.com/

然后先只读核对（只发 GET：核对身份、认证、奖励档位、每件作品还差哪几步、每条开放任务发没发），确认无误再加 --write：

uv run --directory apps/api python -m tests.demo.seed_cold_start browser \
  --web-url https://start.debug.ndaeweb.com --admin-session cold-admin --worker-session cold-worker
uv run --directory apps/api python -m tests.demo.seed_cold_start browser \
  --web-url https://start.debug.ndaeweb.com --admin-session cold-admin --worker-session cold-worker \
  --cert-screenshot <认证截图.png> --write

--signer fake 用假登录身份代替 UC 签名，只许对本机站点用，作用是在本机把这条浏览器路线完整演练一遍：起一个指向本机后端的前端（假登录模式），开两个会话各自写好 localStorage 的 venture-os:fake-subject，--web-url 指向这个前端即可。UC 签名本身只能在白晨登录后由只读核对那一步验证；未登录时页面内构造 UC SDK 并拦下请求这一段已对测试环境核过（不发任何请求）。

重跑与失败

每一步之前先读现状再决定做不做，所以任何一步失败后排除原因原样重跑即可，只补缺的步骤：

尾款到账由积分工作器异步确认，脚本最后最多等 90 秒，没到账只提示、不报错——作品与公开不依赖到账。 要改内容：任务一旦发布，标题、说明、截止都不会随清单变；要换就在后台处理旧任务后改标题重跑。