# 当前实现状态

> 可覆盖的仓库现实快照。历史执行和验证结果只追加到 [`../progress.md`](../progress.md)。

## 当前快照

- 日期：2026-07-11
- 阶段：Harness 文档基线完成，生产代码待初始化
- 项目目录：`D:\OPC\shop_helm`
- 产品：店小航 ShopHelm，Windows 本地跨境电商运营工作台
- 技术路线：Go + Gio + SQLite + 外部 Chrome
- 本机 Go：`go1.23.0 windows/amd64`
- 本机 Git：`git version 2.49.0.windows.1`
- Git 仓库：已初始化，当前为 `main`，已有初始提交并配置 `origin`
- Go module：尚未初始化
- 生产代码：无
- 自动测试：无
- Harness 校验：本地链接、占位符、空白、code fence、任务图、P0 追踪、脚本语法和 `git diff --check` 均已通过
- 当前 blocker：无；T-001 尚未执行是计划状态，不是阻塞

## 已存在内容

| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `AGENTS.md` | 已有 | 仓库级 agent 规则和安全边界 |
| `README.md` | 已有 | 人类入口和项目状态 |
| `.git` / `.gitignore` | 已有 | 现有 Git 仓库和 Go ignore 规则，保持用户配置 |
| `.gitattributes` | 已有 | 文本统一 LF，二进制素材不做行尾转换 |
| `docs/` | 已有 | 产品、技术、架构、任务和质量文档 |
| `progress.md` | 已有 | 只追加执行流水 |
| `init.ps1` / `init.sh` | 已有 | 计划中的标准 Go 启动入口 |
| `cmd/` | 待建 | T-001 创建 Gio 应用入口 |
| `internal/` | 待建 | T-002 起创建模块 |
| `migrations/` | 待建 | T-003 创建 |
| `go.mod` / `go.sum` | 待建 | T-001 创建并锁定版本 |

## 任务状态

任务权威来源是 [`06-tasks.md`](06-tasks.md)。

- 已完成：无生产开发任务。
- 正在进行：无。
- 下一个可领取任务：T-001 初始化 Go module 和最小 Gio 窗口。

## 当前可运行内容

当前只有文档，没有可启动应用。

```powershell
./init.ps1
```

该命令当前会因缺少 `go.mod` 主动退出并提示执行 T-001，这是设计行为。

T-001 完成后的预期标准命令：

```powershell
./init.ps1
go run ./cmd/shophelm
go test ./...
go vet ./...
go build -o build/shophelm.exe ./cmd/shophelm
```

在实际成功运行前，不得把这些预期命令描述为已验证。

## 已确认决策

- 首发只支持 Windows 本地桌面。
- 使用 Go + Gio，不使用 Wails。
- 首发按店铺 -> 商品/图片 -> 客服顺序交付。
- SQLite 保存结构化数据，原图按路径引用。
- MVP 不保存平台密码，不支持代理认证。
- 每个店铺使用独立 Chrome `user-data-dir`，但不提供防关联能力。
- 图片预览使用 Gio，正式导出使用独立 CPU 合成管线。
- 首发不接平台 API、不做 RPA 和自动页面操作。

## 下一轮开工

1. 读取 `AGENTS.md` 和 `docs/00-ai-start-here.md`。
2. 在 `docs/06-tasks.md` 把 T-001 改为 `DOING`。
3. 保留现有 Git 配置，初始化 module `shophelm`。
4. 用本机 Go 运行最小 Gio 窗口；若不兼容，升级到受支持 Go 工具链并记录结论。
5. 锁定依赖版本，同步本文和 `docs/03-tech-stack.md`。
6. 完成全部验收后才能将 T-001 改为 `DONE`。

## 维护规则

以下变化发生时覆盖更新本文件：

- Git 状态、Go module 或生产目录发生变化。
- 实际 Go/Gio 版本确定。
- 标准命令首次运行或发生变化。
- 任务状态变化。
- 新增 blocker 或文档与代码出现差异。

同时把任务状态同步到 `06-tasks.md`，把真实执行证据追加到 `../progress.md`。