面向参与本项目开发的工程师 - 架构、环境、构建、接口与工程协作

阅读顺序

1. 总体架构与仓库关系 —— 三个仓库的职责、依赖关系与数据流
2. 技术栈与目录结构 —— 逐仓库的目录职责、核心模块与入口
3. 环境要求 —— Node.js、.NET SDK、系统依赖
4. 构建、运行与测试 —— 安装、开发、构建、打包、测试命令
5. 配置说明 —— 环境变量、配置文件、默认值与敏感项
6. 各端开发 —— 网页端、桌面端、Windows 7 兼容
7. 接口与数据模型 —— API 清单、错误码、数据模型
8. CI/CD 与发布 —— 流水线、产物、版本号规则、回滚
9. 安全与权限 —— 鉴权、敏感数据处理、日志脱敏、依赖安全
10. 贡献指南 —— 分支、提交、代码风格、评审流程

一句话概括

网页端仓库是唯一数据权威源；两个桌面端是外壳客户端，均通过 GitHub 公开仓库直读网页端的软件数据，安装包不自带内容包。

已确认与待确认

已确认：三仓数据流关系、网页端 8 条路由与 11 个内置工具、Windows 7 版的版本号规则与更新双通道、安装脚本的系统门槛与进程处理策略、日志与缓存的目录结构、提交服务三条路由与 OSS 直传/票据下载协议、age 公钥加密联系方式、CI/CD 五个工作流的职责分工。

待确认：

项	说明
ClassSoftwareHub-Desktop 仓库实现	本地未定位到该仓库，主进程/渲染进程划分、IPC、自动更新、打包与签名细节待确认
提交服务 Worker 源码	仓库文档明确其不在仓库内，仅保留源码备份分支
访问统计 Worker 源码	同样不在仓库内
Authenticode 签名	安装脚本未配置签名工具，是否需要引入待确认

代码依据约定

本文档中的命令、路径、端口、环境变量、接口与配置项均来自仓库文件或脚本。关键结论附代码依据，格式为 相对路径/文件名:行号 或 相对路径/文件名。无法从代码确认的信息统一标注「待确认」。

贡献者

椰汁

更新日志

2026/10/20 06:59

查看所有更新日志

• 6b8a2-docs: 添加 docs/download.md于 2026/10/20

版权所有

版权归属：ClassSoftwareHub

许可证：GPL-3.0

编辑此页

下一页总体架构与仓库关系