docs: 更新 AGENTS 中的 Git 仓库地址

This commit is contained in:
cat-shark
2026-08-08 21:21:46 +08:00
parent 15100a0c97
commit 008261d755
+25 -22
View File
@@ -83,23 +83,24 @@ uv lock # 仅更新 uv.lock
| 目录 | 用途 | 仓库 | | 目录 | 用途 | 仓库 |
| --- | --- | --- | | --- | --- | --- |
| `wov-api` | FastAPI 后端:节点注册、工作流、调度、用户 API | `wov/wov-api.git` | | `subtitle-generate` | WOV meta 仓库 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/subtitle-generate.git` |
| `wov-web` | React 管理后台和用户端 | `wov/wov-web.git` | | `wov-api` | FastAPI 后端:节点注册、工作流、调度、用户 API | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-api.git` |
| `wov-sdk` | 节点协议、Manifest、SDK 与测试工具 | `wov/wov-sdk.git` | | `wov-web` | React 管理后台和用户端 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-web.git` |
| `wov-node-echo` | 示例节点,验证节点协议和生命周期回收 | `wov/wov-node-echo.git` | | `wov-sdk` | 节点协议、Manifest、SDK 与测试工具 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-sdk.git` |
| `wov-node-ffmpeg` | 提音、转码、媒体处理节点 | `wov/wov-node-ffmpeg.git` | | `wov-node-echo` | 示例节点,验证节点协议和生命周期回收 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-echo.git` |
| `wov-node-whisper` | faster-whisper ASR 节点 | `wov/wov-node-whisper.git` | | `wov-node-ffmpeg` | 提音、转码、媒体处理节点 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-ffmpeg.git` |
| `wov-node-llm` | LLM 翻译/润色节点 | `wov/wov-node-llm.git` | | `wov-node-whisper` | faster-whisper ASR 节点 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-whisper.git` |
| `wov-node-ass` | SRT/ASS 和 VR 双眼字幕节点 | `wov/wov-node-ass.git` | | `wov-node-llm` | LLM 翻译/润色节点 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-llm.git` |
| `wov-docs` | 系统文档与设计文档 | `wov/wov-docs.git` | | `wov-node-ass` | SRT/ASS 和 VR 双眼字幕节点 | `ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-ass.git` |
| `wov-infra` | Docker/Kubernetes/部署清单 | `wov/wov-infra.git` | | `wov-docs` | 系统文档与设计文档 | 待创建:`ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-docs.git` |
| `wov-infra` | Docker/Kubernetes/部署清单 | 待创建:`ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-infra.git` |
仓库地址中的 `wov/` 是命名空间占位符,实际地址确定后必须更新本表。节点数量不限于上表,新增模型时新增独立仓库即可。 已推送仓库的分支均为 `master`。SSH 端口为 `2222`,认证使用本机 `id_ed25519` key。节点数量不限于上表,新增模型时新增独立仓库即可。
### meta-repo 规则 ### meta-repo 规则
- 主仓库只维护 `AGENTS.md``.gitignore`,不创建业务代码。 - 主仓库只维护 `AGENTS.md``.gitignore`,不创建业务代码。
- MVP 阶段设计文档暂时保留在主仓库;`platform-docs` 建立后迁出。 - MVP 阶段设计文档暂时保留在主仓库;`wov-docs` 建立后迁出。
- `.gitignore` 忽略所有子项目目录,避免把独立 Git 仓库提交进主仓库。 - `.gitignore` 忽略所有子项目目录,避免把独立 Git 仓库提交进主仓库。
- 首次 clone 主仓库后,子项目目录缺失时按本表 clone;主仓库自身不复制子项目内容。 - 首次 clone 主仓库后,子项目目录缺失时按本表 clone;主仓库自身不复制子项目内容。
- 修改子项目时必须进入对应目录,并使用 `git -C <目录> <command>` 执行 Git 操作。 - 修改子项目时必须进入对应目录,并使用 `git -C <目录> <command>` 执行 Git 操作。
@@ -110,16 +111,18 @@ uv lock # 仅更新 uv.lock
### 子仓库初始化 ### 子仓库初始化
```powershell ```powershell
git clone <wov-api-url> wov-api git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/subtitle-generate.git subtitle-generate
git clone <wov-web-url> wov-web git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-api.git wov-api
git clone <wov-sdk-url> wov-sdk git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-web.git wov-web
git clone <wov-node-echo-url> wov-node-echo git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-sdk.git wov-sdk
git clone <wov-node-ffmpeg-url> wov-node-ffmpeg git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-echo.git wov-node-echo
git clone <wov-node-whisper-url> wov-node-whisper git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-ffmpeg.git wov-node-ffmpeg
git clone <wov-node-llm-url> wov-node-llm git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-whisper.git wov-node-whisper
git clone <wov-node-ass-url> wov-node-ass git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-llm.git wov-node-llm
git clone <wov-docs-url> wov-docs git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-node-ass.git wov-node-ass
git clone <wov-infra-url> wov-infra # wov-docs / wov-infra 尚未创建,创建后执行:
# git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-docs.git wov-docs
# git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/wov-infra.git wov-infra
``` ```
进入或修改某个子仓库前,先读取该子仓库根目录的 `AGENTS.md`;如果缺失,则读取 `README.md` 进入或修改某个子仓库前,先读取该子仓库根目录的 `AGENTS.md`;如果缺失,则读取 `README.md`