---
id: T-001
title: 初始化 monorepo 骨架(core / app-modern / app-win7 + go.work)
phase: 0
deps: []
status: DONE
created: 2026-07-16
issue: null
context_ref: 0184595cccc3a516628fc6077c558b84606ad806
claim_branch: null
work_branch: agent/codex/T-001
write_paths:
  - docs/tasks/T-001.md
  - go.work
  - core/
  - app-modern/
  - app-win7/
  - init.sh
  - init.ps1
  - docs/00-ai-start-here.md
  - docs/03-tech-stack.md
  - docs/current-state.md
---

## 问题 / 背景

仓库当前只有 harness 文档,没有任何 Go 代码。按 `docs/04-architecture.md` 建立「单仓库、双构建」的工程骨架,是所有后续任务的前置。git 仓库与 Gitea 远端(origin)已存在,init 脚本三个命令仍是占位符。

## 方案

1. 创建 `core/`(go.mod,`go 1.20`),含 `domain/`、`application/` 空包和一个最小可测函数(如 SemVer 比较占位)+ 对应测试,保证 `go test ./...` 有真实断言可跑。
2. 创建 `app-modern/`(go.mod,锁定 Go 1.25 + Gio v0.10.1)与 `app-win7/`(go.mod,`go 1.20` + Gio v0.6.0),各含 `cmd/softbox/main.go`(暂可为无 UI 的最小 main,空 Gio 窗口归 T-003)、`ui/gio/`、`platform/windows/` 空包;两模块 require core(replace 由 go.work 处理,go.mod 不留本机路径)。
3. 根目录创建 `go.work` 纳入三个模块。
4. 替换 `init.sh` / `init.ps1` 顶部三个命令变量:
   - INSTALL:`go work sync`
   - VERIFY:`cd core && go vet ./... && go test -count=1 ./...`(脚本内等价写法)
   - START:打印双目标构建命令(桌面应用无常驻 dev server)
5. 把真实命令同步到 `docs/03-tech-stack.md`、`docs/00-ai-start-here.md`、`docs/current-state.md`。

## 验收要点

- `go work sync` 成功。
- `cd core && go vet ./... && go test -count=1 ./...` 通过(Linux 无头环境),至少一个真实测试。
- `cd app-modern && GOOS=windows GOARCH=amd64 go build ./cmd/softbox` 产出 EXE。
- `cd app-win7 && GOTOOLCHAIN=go1.20.14 GOOS=windows GOARCH=amd64 go build ./cmd/softbox` 产出 EXE(证明 Go 1.20 兼容)。
- `./init.sh` 全流程跑通,不再提示占位符未替换。
- core 的 go.mod 无 Gio、无 Windows 专属依赖;依赖方向 app-* → core。
- `docs/current-state.md` 已覆盖更新为骨架完成后的现实。

## 边界（不改什么）

- 不实现任何业务功能(清单、下载、安装、授权均不做)。
- 不写 Gio 界面(空窗口在 T-003)。
- 不建 `schemas/`、`testdata/` 业务内容。
- 不引入除 Gio 外的第三方依赖。

## 协作约束

(未启用 Gitea;单 agent 直接在独立分支领取,状态改 DOING 后开工。)

## 执行记录

- 2026-07-16:创建根 `go.work`、`core` / `app-modern` / `app-win7` 三个模块、最小命令入口、core 真实单元测试及预留包目录。
- 2026-07-16:根 workspace 使用 Go 1.25 并纳入三个模块;额外创建 `app-win7/go.work`(Go 1.20,仅含 win7 + core),使 Go 1.20.14 不必解析 modern 模块,同时保持 app → core 的依赖方向。
- 2026-07-16:替换 `init.sh` / `init.ps1` 占位命令并同步 `00-ai-start-here.md`、`03-tech-stack.md`、`current-state.md`。
- 验证通过:`go work sync`。
- 验证通过:`cd core && go vet ./... && go test -count=1 ./...`。
- 验证通过:`cd app-modern && GOTOOLCHAIN=go1.25.0 GOOS=windows GOARCH=amd64 go build -o ../dist/SoftBox.exe ./cmd/softbox`。
- 验证通过:`cd app-win7 && GOTOOLCHAIN=go1.20.14 GOOS=windows GOARCH=amd64 go build -o ../dist/SoftBox-win7.exe ./cmd/softbox`。本机镜像下载 toolchain 失败后,使用 Go 官方 `golang.org/dl/go1.20.14` 下载并验证同一版本工具链。
- 验证通过:`./init.ps1` 与 Git Bash `./init.sh`。
- 验证通过:`python scripts/validate_agent_context.py`、`python scripts/validate_harness_governance.py`。