# 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 更新通道。

## 快速开始

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

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

## 文档

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

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

## 文档与工件清单

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