---
url: /dev/index.md
---
> **面向参与本项目开发的工程师** - 架构、环境、构建、接口与工程协作

## 阅读顺序

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

## 一句话概括

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

## 已确认与待确认

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

**待确认**：

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

## 代码依据约定

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