SoftBox 软件盒子

使用 Go + Gio 开发的 Windows 软件盒子:远程软件目录 + 安全下载器 + 便携安装器 + 更新器 + 启动器 + 授权入口。

• 现代版:Win10/Win11 x64,当前受支持 Go 工具链 + 当前 Gio。
• Win7 遗留版:Win7 SP1,锁定 Go 1.20 + Gio v0.6.0,仅兼容与严重修复。
• 单仓库单主分支:共享 core + app-modern + app-win7 两个构建模块 + 两个签名 manifest 更新通道。

快速开始

./init.sh        # WSL / Git Bash / Linux
./init.ps1       # Windows 原生 PowerShell

统一完成依赖安装、基础验证并打印启动命令。脚本顶部命令未配置时会主动失败(由任务 T-001 落地真实命令)。

文档

• AI coding agent 入口:AGENTS.md → docs/00-ai-start-here.md
• 文档导航:docs/README.md
• 需求与验收:docs/02-requirements.md
• 架构与协议:docs/04-architecture.md、docs/api.md
• 任务路线图:docs/06-tasks.md;任务文件在 docs/tasks/

本项目采用 harness coding 工作方式:文档是给 agent 执行时用的约束、事实来源和验收标准,需求变化先改文档再改代码。

文档与工件清单

文件	作用
AGENTS.md	AI coding agent 仓库级入口(含硬性架构边界)
CLAUDE.md	Claude Code 薄入口,规则以 AGENTS.md 为准
init.sh / init.ps1	标准启动与验证入口脚本,按操作系统二选一
progress.md	可选历史归档 / 项目级大事记
docs/README.md	文档导航
docs/00-ai-start-here.md	agent 入口、阅读顺序、任务领取规则
docs/01-vision.md	项目愿景与非目标
docs/02-requirements.md	需求、用户故事、验收标准
docs/03-tech-stack.md	Go + Gio 双工具链矩阵与构建命令
docs/04-architecture.md	分层结构、目录、数据模型、安全流程
docs/05-coding-rules.md	编码硬规则(分层、工具链、安全纪律)
docs/06-tasks.md	任务路线图(Phase 0-6、里程碑、Backlog)
docs/tasks/README.md	一任务一文件约定
docs/api.md	Catalog / 软件包 / 许可证 / 事件 / CLI 协议合约
docs/routes.md	Gio 视图结构与交互约束
docs/troubleshooting.md	unsafe_cache 等人工故障排查与安全恢复步骤
docs/current-state.md	当前实现状态快照
docs/agent-context.md / docs/agent-context.json / docs/agent-context.schema.json	上下文路由清单及其契约
docs/adoption-checklist.md	已有项目接入迁移清单(备查)
docs/clean-state-checklist.md	会话收尾检查清单
docs/method-map.md	失败模式 → 首要修复 → 工件对照表
docs/evaluator-rubric.md	单次会话输出评审评分表
docs/quality-document.md	代码库长期健康度追踪
docs/gitea-mcp.md / docs/gitea-collaboration.md	可选 Gitea 协作(当前未启用)
gitea.env.example	Gitea MCP 本机私有配置示例;真实文件不得入库
scripts/validate_agent_context.py	校验上下文清单、Schema 和仓库相对路径
scripts/validate_harness_governance.py	离线检查导航、链接、任务、模板和敏感信息
scripts/setup_gitea_labels.py	Gitea 协作标签初始化(未启用,备查)
scripts/audit_gitea_coordination.py	只读审计远端任务协调(未启用,备查)
scripts/test_gitea_claim_race.py	claim 分支并发兼容性 smoke(未启用,备查)
tests/test_governance.py	标准库治理回归测试
.gitea/ISSUE_TEMPLATE/task.md / .gitea/PULL_REQUEST_TEMPLATE.md	Gitea 任务 Issue 与 PR 模板(未启用,备查)
.gitea/workflows/harness-governance.yml	push / PR 离线治理检查工作流模板