ilaandClaude Fable 5 36d43cdf16
Harness governance / validate (push) Has been cancelled
Phase 0 build gate / verify (push) Has been cancelled
Require pausing on requirements conflicts; ignore local run scripts
Add a governance rule to AGENTS.md: when implementation reveals that
requirements cannot be satisfied as written (e.g. a capability the
frozen protocol cannot express), the agent must stop, record both
document sources and the technical reason in the task's execution log,
and request adjudication instead of silently narrowing scope or
altering a frozen protocol. After adjudication, every affected document
must be updated before work resumes or a new task is split off -
updating only the architecture/task docs while leaving
docs/02-requirements.md stale invalidates the acceptance criteria, which
is the drift observed in the Phase 5 trial conflict.

Also gitignore the local run-modern.bat / run-win7.bat dev scripts.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-20 11:10:17 +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/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 离线治理检查工作流模板
S
Description
No description provided
Readme
1.3 MiB
Languages
Python 93.5%
PowerShell 4.6%
Shell 1.9%