shop_helm/docs/current-state.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。

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

当前可运行内容

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

./init.ps1

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

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

./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。