Add harness coding docs for SoftBox (Go + Gio dual-build)
Harness governance / validate (push) Has been cancelled
Harness governance / validate (push) Has been cancelled
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>
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
# 项目愿景
|
||||
|
||||
## 一、核心目标
|
||||
|
||||
SoftBox 软件盒子要解决:用户获取和维护自家系列软件时,需要手动访问下载页、选择安装包、解压、找 EXE、手动升级、手动输注册码的低效和易错问题。
|
||||
|
||||
> 让自家软件的用户能够在一个桌面客户端里完成「发现软件 → 下载/更新 → 启动 → 授权」的完整闭环,并获得安全、可回滚的安装体验。
|
||||
|
||||
它不是 MSI 安装器、应用商店服务或系统级包管理器,而是一个为「自家软件产品家族的分发、更新和授权」服务的桌面工具:远程软件目录 + 安全下载器 + 便携安装器 + 更新器 + 启动器 + 授权入口。
|
||||
|
||||
## 二、目标用户
|
||||
|
||||
- **Win10/Win11 主流用户**:一站式获取、更新和启动系列软件,不关心安装细节。
|
||||
- **Win7 SP1 遗留用户**(少量存量):在老系统上继续可用的遗留版盒子,能下载兼容其系统的软件版本。
|
||||
- **软件发布者(自己)**:通过签名 Catalog 集中发布、更新和撤销软件,通过许可证系统管理授权与绑定电脑。
|
||||
|
||||
## 三、产品原则
|
||||
|
||||
遇到取舍时,以这些原则为准:
|
||||
|
||||
- **业务逻辑优先**:清单、下载、校验、更新、授权的正确性优先于视觉效果。
|
||||
- **安全更新**:HTTPS + 签名清单 + SHA-256 + staging/backup/回滚;未验证内容绝不执行。
|
||||
- **Gio 仅限 UI**:业务核心不感知 UI;Windows 能力隔离在平台层。
|
||||
- **现代版和 Win7 版共享核心**:一个主分支、共享 core、两个构建模块、两个更新通道;不维护两个长期开发分支。
|
||||
- **小步交付**:每一步都能运行、能验证、能回退。
|
||||
- **可维护**:分层边界清晰,让后续 agent 能继续接手。
|
||||
|
||||
## 四、核心价值主张
|
||||
|
||||
| 价值点 | 说明 |
|
||||
| --- | --- |
|
||||
| 一站式软件管理 | 发现、下载、更新、启动在一个列表中完成,不再手动找包解压 |
|
||||
| 安全可回滚 | 签名清单 + 哈希校验 + 原子切换,更新失败自动恢复旧版本 |
|
||||
| Win7 兼容 | 遗留用户获得独立的 Legacy 版本和更新通道,不被现代版工具链抛弃 |
|
||||
| 离线授权 | Ed25519 签名许可证 + 机器绑定,离线可验证,支持换绑与恢复 |
|
||||
|
||||
## 五、不做什么(非目标)
|
||||
|
||||
- 不做用户评论、评分和社区功能。
|
||||
- 不做在线支付和多账号云同步。
|
||||
- 不做复杂皮肤市场、插件脚本执行。
|
||||
- 不做系统级驱动安装和强依赖管理员权限的软件部署。
|
||||
- 不做通用第三方软件商店;只分发自家 Catalog 中签名发布的软件。
|
||||
- 不把所有版本长期锁在 Win7 工具链;Win7 版定位 Legacy,限制新增功能。
|
||||
|
||||
> MVP 的具体功能范围与验收标准,见 [需求](02-requirements.md)。
|
||||
Reference in New Issue
Block a user