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`。
|