mirror of
https://github.com/SECTL/SecScore.git
synced 2026-07-19 19:04:23 +08:00
Linkon
65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
# 项目知识库（SecScore）
|
||
|
||
**生成时间：** 2026-03-21 01:41:11
|
||
**分支：** `tauri-dev`
|
||
**基线提交：** `517ce1e`
|
||
|
||
## 概览
|
||
|
||
SecScore 当前主线为 Tauri 桌面应用：前端 `React + TypeScript + Vite`，后端 `Rust + Tauri + SeaORM`。
|
||
仓库中存在 `old-ss/`（Electron 历史代码），默认按遗留参考处理，不作为本分支主实现目标。
|
||
|
||
## 目录结构
|
||
|
||
```text
|
||
.
|
||
├── src/ # 前端 UI、状态与共享逻辑
|
||
├── src-tauri/ # Rust/Tauri 后端与数据库
|
||
├── old-ss/ # 历史 Electron 代码（遗留）
|
||
├── scripts/ # 本分支启动脚本（如 tauri-dev）
|
||
└── .github/workflows/ # 构建/发布流程
|
||
```
|
||
|
||
## 去哪里找
|
||
|
||
| 任务 | 位置 | 说明 |
|
||
| -------------------- | ------------------------------------ | ----------------------------------------- |
|
||
| 前端入口与全局初始化 | `src/main.tsx` | 注入 `window.api`、日志桥接、平台标识 |
|
||
| 主应用路由与页面容器 | `src/App.tsx` | 页面切换、权限与流程协调 |
|
||
| Tauri 启动入口 | `src-tauri/src/main.rs` | 仅调用 `secscore_lib::run()` |
|
||
| 后端命令注册总线 | `src-tauri/src/lib.rs` | `invoke_handler` 注册命令与初始化流程 |
|
||
| 数据库连接/同步核心 | `src-tauri/src/commands/database.rs` | 复杂热点文件，改动需重点回归 |
|
||
| 前端构建配置 | `vite.config.ts` | `@` 别名、端口 `1420`、排除 `old-ss` 扫描 |
|
||
| Tauri 构建配置 | `src-tauri/tauri.conf.json` | `beforeDevCommand`、窗口/打包/插件设置 |
|
||
|
||
## 关键约束
|
||
|
||
- 当前开发目标：优先 Tauri 版本；不要把 Electron 新功能落在主线目录。
|
||
- 提交信息使用中文；提交后需推送远程（按仓库现有协作约束执行）。
|
||
- 包管理器默认使用 `pnpm`（注意：`src-tauri/tauri.conf.json` 的 `before*Command` 当前仍为 `npm run ...`）。
|
||
- 代码风格以配置文件为准：`.editorconfig`、`eslint.config.mjs`、`.prettierrc.yaml`。
|
||
|
||
## 反模式
|
||
|
||
- 不要在 `src-tauri/src/commands/database.rs`、`src/components/Home.tsx` 等超大文件里继续堆叠新职责；先拆分再扩展。
|
||
- 不要将 `old-ss/` 作为新功能主实现目录。
|
||
- 不要绕过静态检查直接交付（至少通过 `lint` 与 `typecheck`）。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
pnpm install
|
||
pnpm dev
|
||
pnpm tauri:dev
|
||
pnpm lint
|
||
pnpm typecheck
|
||
pnpm build
|
||
pnpm tauri:build
|
||
```
|
||
|
||
## 分层文档
|
||
|
||
- 前端细则：`src/AGENTS.md`
|
||
- Tauri/Rust 细则：`src-tauri/AGENTS.md`
|
||
- 遗留目录边界：`old-ss/AGENTS.md`
|