Blueprints

一款本地优先的发布规划工具，专为开发者和小型团队设计。 规划版本，生成更新日志，并信任文件。

## 为什么选择 Blueprints？ 发布说明通常散落在各种 issue、commit 消息和私密文档中。Blueprints 将发布意图保存在一个可移植的工作区中，无需服务器即可保持可读性： - 规划版本和分类的发布条目； - 在持久化、已签名的 blueprint 画布上安排版本和工作条目； - 生成稳定且人类可读的条目键（item keys）； - 冻结并发布包含不可变的已发布内容的版本； - 导出 Markdown 更新日志，可选择通过本地 Git 历史记录进行丰富； - 发现更新日志、路线图、GitHub issue 和项目（Project）信号，作为可编辑的、审批优先的提案； - 验证已签名的项目文件，并在信任失效时进入只读模式； - 通过共享文件夹交换已签名的更改，并提供明确的 push、pull 和冲突解决机制； - 在一个桌面应用程序中检查成员资格、审计历史、同步状态和集成边界； - 检查被动的 VaultSync 备份和恢复就绪证据，而无需将已签名的项目事实与备份元数据耦合。 ## 当前状态 | 领域 | 状态 | | --- | --- | | 本地项目、版本和条目工作流 | 正常运行 | | 持久化的已签名画布布局 | 正常运行 | | 已签名的持久化与信任验证 | 正常运行 | | Markdown 更新日志导出 | 正常运行 | | 共享文件夹的 push/pull | 正常运行，具有独特的签名身份和分阶段验证 | | 冲突和审计诊断 | 具备文档感知能力，可恢复且具有可操作性 | | 本地 Git 感知 | 提供只读集成 | | 更新日志、路线图和 GitHub issue 发现 | 正常运行，需要明确批准 | | GitHub 和 GitLab 源码发现 | 正常运行，只读且有边界限制 | | VaultSync 集成 | 被动的元数据和备份健康状态感知 | | 安装程序和受支持的发布 | 尚未就绪 | 标准的交付计划见 [ROADMAP.md](Roadmap.md)。较早的规划文件仅作为设计历史保留，并非活动的 backlog。 ## 快速开始 前置条件： - .NET 10 SDK（`10.0.300` 或更新的补丁版本）； - Git（如果您需要本地源代码更改诊断）。 ``` git clone https://github.com/ATAC-Helicopter/Blueprints.git cd Blueprints ./scripts/verify.sh ./scripts/run-app.sh ``` 在任何平台上等效的命令： ``` dotnet restore Blueprints.sln dotnet build Blueprints.sln --configuration Release --no-restore dotnet test Blueprints.Tests/Blueprints.Tests.csproj --configuration Release --no-build dotnet run --project Blueprints.App/Blueprints.App.csproj ``` 请参阅[开发指南](docs/development.md)以获取平台说明和故障排除。 ## 架构概览 | 项目 | 职责 | | --- | --- | | `Blueprints.Core` | 领域模型、枚举、条目键规则 | | `Blueprints.Security` | 身份验证、密钥保护、Ed25519 签名 | | `Blueprints.Storage` | 规范的 JSON 和已签名的工作区持久化 | | `Blueprints.Collaboration` | 同步分析、清单、审计链、共享文件夹安全 | | `Blueprints.App` | Avalonia UI、工作流、更新日志和 Git 集成 | | `Blueprints.Tests` | 单元和集成测试覆盖 | Blueprints 使用本地工作区作为可编辑的事实来源，并使用单独的共享目录作为交换层。请参阅[架构](docs/architecture.md)、[工作区格式](docs/workspace-format.md)和[安全模型](docs/security-model.md)。 ## 文档 - [文档索引](docs/README.md) - [用户指南](docs/user-guide.md) - [无障碍功能](docs/accessibility.md) - [画布引擎](docs/canvas-engine.md) - [Source Lens](docs/source-lens.md) - [VaultSync 集成](docs/vaultsync-integration.md) - [故障排除](docs/troubleshooting.md) - [架构](docs/architecture.md) - [工作区格式](docs/workspace-format.md) - [安全模型](docs/security-model.md) - [威胁模型](docs/threat-model.md) - [支持政策](docs/support-policy.md) - [SonarQube Cloud](docs/sonarqube.md) - [开发指南](docs/development.md) - [发布流程](docs/releasing.md) - [发布历史](docs/releases.md) - [路线图](Roadmap.md) - [贡献指南](CONTRIBUTING.md) - [安全策略](SECURITY.md) ## 贡献 欢迎提交 issue 和 pull request。请从 [CONTRIBUTING.md](CONTRIBUTING.md) 开始，使用 `develop` 作为 pull request 的基础分支，并请勿在公开的 issue 中报告安全问题。 ## 许可证 Blueprints 基于 [MIT 许可证](LICENSE)提供。

标签：CVE, Git集成, Linux 内核安全, 变更日志生成, 数字签名, 桌面应用, 版本发布, 离线协作, 网络安全研究, 项目管理