ilaandClaude Fable 5 0184595ccc
Harness governance / validate (push) Has been cancelled
Add harness coding docs for SoftBox (Go + Gio dual-build)
Initialize the full harness coding document set from the
harness_coding_docs template, customized for the SoftBox project:

- Vision, requirements, tech stack (modern Go 1.25 + Gio v0.10.1;
  Win7 legacy Go 1.20.14 + Gio v0.6.0), architecture, coding rules
- Protocol contracts (signed catalog, package protocol v1, Ed25519
  license, events, CLI) and Gio view structure
- Roadmap Phase 0-6 with 20 suggested tasks; T-001 (monorepo
  skeleton) filed and ready to claim
- Agent entry points (AGENTS.md, docs/00-ai-start-here.md),
  context manifest, governance scripts and tests
- Merge Go gitignore with harness rules; keep go.work tracked

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 14:33:54 +08:00

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 落地真实命令)。

文档

本项目采用 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/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 离线治理检查工作流模板
S
Description
No description provided
Readme
1.3 MiB
Languages
Python 93.5%
PowerShell 4.6%
Shell 1.9%