Record the task card for svc-remote-source

2026-09-30 18:30:02 +00:00
parent f65d89e59b
commit b575bcc910
1 changed files with 35 additions and 0 deletions
@@ -0,0 +1,35 @@
+# feature/svc-remote-source 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：进行中；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= f65d89e59b6974c7a5db63be0677d192bfaa7e9c
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-svc-remote-source（worktree）；分支：feature/svc-remote-source
+- 启动方式说明：主检出存在 owner 本人未收尾现场（`modules/frontend` 子模块修改态，前端重设计进行中），`task.sh start` 按门禁硬拒。owner 在任务对话中明确指示本任务并要求"更新/部署不依赖当前仓库状态"，即 collaboration.md 的"经 owner 确认"路径；本工作区由 Agent 以与 task-start 完全相同的命令手动建立（同 R0、同命名、子模块零漂移），**全程未写主检出、未触碰该未提交现场**。
+- 授权与交付终点：修改 `scripts/svc.sh` 与 `docs/svc.md`（实现 + 文档），验证后推送并建 PR；不合并（合入由 owner 决定）；不动主检出 `modules/frontend` 现场。
+
+## 目标与非目标
+
+**背景**：`scripts/svc.sh update dev` 在主检出工作树不干净时跳过更新（"主检出工作树不干净——跳过"）。owner 明确要求：更新、部署等操作不应依赖当前仓库状态；不指定时默认使用最新仓库；构建放在独立于当前仓库/目录的地方。
+
+**目标**：
+1. 新增"独立部署源仓"：脚本自有的干净克隆（默认 `~/.cache/agent-system-svc/src`，`SVC_SRC_DIR` 覆盖；可随时删除重建），dev 源的解析、列举（commits）、worktree 物化全部基于它。
+2. 默认来源改为远端最新：裸 `deploy` 与 `--from dev`（不带 @sha）= 源仓 `origin/main` 最新提交；`--from local` 保留为显式"构建当前工作区"。
+3. `update` 去 pull 化：删除"local 源 → 主检出 pull（要求分支=main + 树干净）"路径；`local@`/`dev@` 源一律重新部署为 `dev@<远端最新>`（隔离 worktree 构建），与工作区脏净/所在分支无关。领先/分叉/提交不在远端三种情形仍不动作（不盲目降级）。
+4. `update` 的 fetch 也走源仓（不再 fetch 主检出）；`commits dev` 列表改为源仓 `origin/main`（自动确保+fetch），`[HEAD]` 标记改为 `[最新]`。
+5. 文档同步：脚本头注释、`help` 各主题、`docs/svc.md`（§2/§5/§6.3/§9.3/§11/§13/§14）。
+
+**非目标**：不改 `--from local` 语义与实现；不改 release 源、数据库、生命周期、dbops 行为；不动 Makefile。
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | 2026-09-30（手动 task-start 复刻） |
+
+## 结果与验证（完成后填写）
+
+- 结果：
+- 验证：
+- 影响与剩余项：