feat: add task workflow and asset downloads

README.md

@@ -1,11 +1,19 @@
 # 智念AIGC平台
 
+[完整中文说明](./README.zh-CN.md)
+
 这是 `智念AIGC平台` 的 Web 极简 MVP。当前产品只保留核心闭环：统一创作图片/视频、查看结果、局部重绘、智能超清和必要设置。
 
-旧的 `runtime/nianxx-play` standalone 运行包只作为旧流程、样例素材和 Seedance 参考，不再作为主应用入口。仓库只保留旧运行时元数据；大体积本地媒体与依赖不纳入代码提交。
-
 ## 启动
 
+服务器一键部署：
+
+```bash
+bash scripts/deploy.sh
+```
+
+开发环境：
+
 ```bash
 cd /Users/inmanx/Documents/zhinian-creation-assistant
 npm install
@@ -22,6 +30,8 @@ http://127.0.0.1:3000
 
 ```bash
 npm start
+npm run start:server
+npm run worker
 npm run build
 npm test
 npm run health
@@ -30,11 +40,7 @@ npm run info
 
 `npm start` 会自动先执行一次生产构建，再启动 `http://127.0.0.1:3000`；开发调试建议继续使用 `npm run dev`。
 
-旧 runtime 仍可手动启动：
-
-```bash
-npm run legacy:start
-```
+Docker 部署默认使用 `docker-compose.yml` 同时启动 Web 服务和 `zhinian-worker` 任务 Worker，访问 `http://服务器IP:3000`。如需修改端口，调整 `.env.local` 中的 `APP_PORT` 和 `NEXT_PUBLIC_APP_URL` 后重新执行 `bash scripts/deploy.sh`。
 
 ## Web MVP 信息架构
 
@@ -145,6 +151,30 @@ supabase/schema.sql
 - `generation_jobs`
 - `usage_events`
 
+## 任务管理与开放 API
+
+平台支持服务端任务管理：页面和 `/api/v1` 创建任务后只入队，Worker 统一提交供应商、轮询、转存结果、失败重试和 Webhook 回调。生产部署建议配置 Supabase/Postgres；本地开发可继续使用 `.runtime/data/web-app-state.json`。
+
+开放 API 使用 API Key：
+
+```env
+ZHINIAN_API_KEYS=demo-agent:change-me-public-api-key
+ZHINIAN_INTERNAL_WORKER_TOKEN=change-me-worker-token
+```
+
+主要接口：
+
+- `GET /api/v1/capabilities`
+- `POST /api/v1/assets`
+- `GET /api/v1/assets`
+- `POST /api/v1/jobs`
+- `GET /api/v1/jobs`
+- `GET /api/v1/jobs/[id]`
+- `POST /api/v1/jobs/[id]/cancel`
+- `GET /api/v1/openapi.json`
+
+任务创建支持 `Idempotency-Key` 幂等键和 `webhookUrl` 完成回调。Worker 可用 `npm run worker` 常驻运行，或 `npm run worker:once` 单次处理。
+
 ## API
 
 核心图片 API：