SecScore/agents.md

项目知识库（SecScore）

生成时间： 2026-03-21 01:41:11
分支： tauri-dev
基线提交： 517ce1e

概览

SecScore 当前主线为 Tauri 桌面应用：前端 React + TypeScript + Vite，后端 Rust + Tauri + SeaORM。
仓库中存在 old-ss/（Electron 历史代码），默认按遗留参考处理，不作为本分支主实现目标。

目录结构

.
├── 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）。

常用命令

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