98 lines
3.5 KiB
Markdown
98 lines
3.5 KiB
Markdown
# 当前实现状态
|
||
|
||
> 可覆盖的仓库现实快照。历史执行和验证结果只追加到 [`../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`。
|