Files

T

cat-shark 966f3e6b4b docs: AGENTS.md 只保留代理规则，项目信息迁入 README 与 docs/

把 AGENTS.md（545 行）中的项目知识按性质拆开，只留下对代理的要求：

- AGENTS.md（176 行）只写规则：读文档指引、提交许可、等待规则、TDD、
  测试规则（模块边界/三段结构/功能覆盖优先）、注释规范、目标运行环境、
  PowerShell 规则、文档维护规则；
- 项目信息新建 docs/ 专题：architecture、node-protocol、workflows、
  configuration、operations、testing、decisions；
- README 改为项目索引（定位、快速开始、文档导航、目录、工作流、结论摘要）；
- 修正旧文档错误：README 的"详细约定见 AGENTS.md"与"100% 行覆盖率"
  （pytest 已移除该门槛）；环境变量表补齐 WOV_AUTO_VAD 等 3 项。

新增 scripts/check_doc_links.py 校验相对链接与锚点，当前 14 个文档全部可达。

2026-09-13 15:40:31 +08:00

3.1 KiB

Raw Blame History

配置与启动

启动

uv sync
uv run uvicorn wov_app.main:app --reload

访问：

http://127.0.0.1:8000/              应用中心（上传视频 → 字幕生成）
http://127.0.0.1:8000/tasks.html    任务管理
http://127.0.0.1:8000/batch.html    批量处理（按文件夹）
http://127.0.0.1:8000/admin.html    管理后台（工作流）
http://127.0.0.1:8000/workflow.html 工作流编排（DAG JSON）
http://127.0.0.1:8000/docs          API 文档

环境变量

变量	默认值	说明
`WOV_DATA_DIR`	`<根>/data`	数据目录
`WOV_DB_PATH`	`<根>/data/wov.db`	SQLite 路径
`WOV_STORAGE_DIR`	`<根>/data/storage`	上传与产物根目录
`WOV_AUTO_SEED`	`1`	启动时创建内置工作流
`WOV_SCHEDULER_ENABLED`	`1`	启动后台调度器
`WOV_SCHEDULER_INTERVAL_SECONDS`	`1.0`	调度轮询间隔
`WOV_CLEANUP_ENABLED`	`1`	开启孤儿数据定时清理
`WOV_CLEANUP_INTERVAL_SECONDS`	`3600`	孤儿清理扫描周期（秒）
`WOV_CLEANUP_GRACE_SECONDS`	`3600`	孤儿清理宽限期（秒）
`WOV_BATCH_ENABLED`	`1`	开启文件夹批量处理引擎（处理 source=batch 任务）
`WOV_BATCH_INTERVAL_SECONDS`	`1.0`	批量引擎轮询间隔
`WOV_AUTO_VAD`	`1`	开启每视频自适应 VAD 调参（详见 adaptive_vad.md）
`WHISPER_MODEL_PATH`	见模型权重解析	显式指定 whisper 模型路径
`WHISPER_DEVICE`	`auto`	转写设备
`LLM_API_BASE`	`https://api.siliconflow.cn/v1/chat/completions`	LLM 兼容接口
`LLM_API_KEY`	空（读 `.env`）	SiliconFlow Bearer Key，存于 gitignored 的 `.env`
`LLM_MODEL`	`Qwen/Qwen3.5-35B-A3B`	LLM 模型名（默认值与例外说明见 decisions.md）
`LLM_TIMEOUT_SECONDS`	`600`	LLM 单请求超时（llm-filter 内部默认 60）
`OLLAMA_HOST`	`http://192.168.123.70:11434`	Ollama 服务地址
`VLM_MODEL`	`glm-ocr:latest`	VLM OCR 模型
`VLM_PROMPT`	提取图像中的文字，不要描述图片中的内容	OCR 提示词（字幕流水线在 ocr-subtitle 工作流的 subtitle-ocr 节点参数中显式指定同一提示词）
`VLM_TIMEOUT_SECONDS`	`5`	VLM 单请求整体超时上限（每次调用 5 秒，超时即终止；流式读取同样受此截止约束）
`FFMPEG_BIN`	空	显式 ffmpeg 路径（否则 PATH → imageio-ffmpeg）

Python 环境与 uv 管理

统一使用 uv 管理虚拟环境和依赖，禁止直接使用 pip 修改依赖。
基础命令：uv sync（安装含 dev 组依赖）、uv run <command>、 uv add <package>、uv lock。
虚拟环境位于 .venv，测试依赖在 [dependency-groups] dev。
新增依赖时使用 uv add，不修改系统 Python 或全局环境。

3.1 KiB Raw Blame History Unescape Escape

配置与启动

启动

环境变量

Python 环境与 uv 管理

相关文档

3.1 KiB

Raw Blame History