成套报价软件
电气成套设备报价桌面软件：报价三表（图号/箱号/元件）+ CAD/PDF 图纸扒图 + 元件库选型 + 公式计算 + 甲方报表，单机 SQLite 存储，可选 AI 助手与云端会员服务。
改代码前必读：代码索引.md（所有功能的文件/方法级定位 + 修改铁律） 组件属性手册：
.agents\skills\sd-enhanced-components\SKILL.md（WinForms 控件白名单、设计器规则、版本号铁律、git 推送排查手册）
功能概览
- 项目管理：新建/修改/删除/复制项目，zip 项目包导入导出，最近项目自动恢复
- 报价三表：图号/箱号/元件三级联动，虚拟模式万行秒开，编辑实时落库；公式自动计算（成本价/报出价/利润/毛利率，公式可自定义）；批量粘贴/删除/撤销、费用模板行
- CAD 扒图：内嵌网页 CAD 查看器（mlightcad）打开 DWG/DXF；框选扒图号/箱号/元件，表格点行定位图上蒙版，F1/F2/F3 元件合并
- PDF 扒图：pdfium 渲染 + 框选 OCR（百度/智谱 GLM/千帆/UApiPro/Umi-OCR 本地五引擎），自动纠正文本方向，入库/合并/定位同 CAD
- 元件库与选型：厂家/系列/价格网页选型，收藏跳转，方案库独立库文件，用户库/柜体库管理与 CSV 导入导出
- 计算与报表：GCS 母排计算与铜排推荐、批量调系数、元件排序、甲方报表 Excel 导出
- 其它：停靠布局保存恢复、数据备份恢复、登录门禁、可选 AI 助手（ZCode 引擎）
技术栈
| 项 | 说明 |
|---|---|
| 框架 | WinForms，.NET Framework 4.8，x86（SharpDevelop 5.x 工具链） |
| 数据库 | SQLite（WAL + Pooling + BusyTimeout=5000），连接串统一见 成套报价软件\数据库连接.cs |
| 内嵌网页 | WebView2（元件库/CAD 查看器/AI 助手面板） |
| PDF/OCR | pdfium 渲染 + 多引擎 OCR（扒图\ 下为唯一源码，pdfbt 链接共享） |
| Excel | NPOI（甲方报表/导入导出） |
| UI 组件 | Smart.CustomComponents（自研）、WeifenLuo Docking、AdvancedDataGridView |
仓库结构
成套报价软件\ 主程序源码（MainForm 拆 14 个 partial；xiangmu/shezhi/ku 子模块窗体）
└ 扒图\ CAD/PDF 扒图窗口 + OCR/PDF 基础设施（唯一权威源）
cadbt\ CAD 网页引擎运行时（node.exe + CAD-Viewer；2026-10-01 独立 cadbt.exe 退役）
ai助手\ ZCode 引擎发行包 + 启停脚本（发行包不进 git）
会员服务器\ 肥牛 fnnas 会员服务端 v1.5.1（fpk 工程）
tools\ 构建/打包/维护脚本（见下表）
release\ 组装产物（仅 setup.iss 进 git）
（已退役：独立 cadbt.exe/pdfbt.exe 扒图程序、ghj/yjktool 试验小工具、cadcj 旧 AutoCAD 插件——扒图功能全部由主程序内嵌窗口承载。）
数据目录（运行时，均不进 git）：sjk\bjb\项目<编号>.db 每项目一库；sjk\fak.db 公式库；sjk\方案库\*.db 一方案一库；shezhi\ 用户配置；xiangmu\ 报表模板。
构建与验证
# 主程序（工作目录必须是 成套报价软件\ 子目录！rsp 相对路径基于它）
cd 成套报价软件
& "C:\Windows\Microsoft.NET\Framework\v4.0.30319\csc.exe" "@..\tools\verify_build.rsp" /warn:1
# pdfbt 独立程序（链接共享主项目扒图\ 源码，改 OCR 相关先确认两项目都编译）
& "C:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe" pdfbt\pdfbt.csproj /t:Build /p:Configuration=Debug
注意：编译前杀掉运行中的主程序（exe 被锁报 CS0016）；rsp 默认 /warn:0 压警告，排查时加 /warn:1。
版本号与发版流程
版本号唯一事实源 = 成套报价软件\Properties\AssemblyInfo.cs 的 AssemblyVersion（固定三段式 主.次.修订.0，禁用 1.0.* 自动号）；关于软件窗口运行时自动读它显示；安装包文件名带版本号。
# 每次发版必须先递增版本号（规则详见技能"版本号铁律"）
powershell -File tools\递增版本号.ps1 # 修订号+1；大版本: tools\递增版本号.ps1 1.1.0
# 发版链（顺序固定）
递增版本号 → 编译 → python tools\make_package.py → ISCC release\成套报价软件\setup.iss
→ python tools\make_update_package.py → git add/commit/push → Gitea Release（tag=v版本号，附件=安装包+更新包）
常用工具脚本（tools\）
| 脚本 | 用途 |
|---|---|
递增版本号.ps1 |
版本号一键递增，同步 AssemblyInfo + setup.iss |
make_package.py |
组装发布目录（exe+DLL+数据目录+cadbt+pdfbt+AI 助手） |
make_update_package.py |
生成覆盖式更新包（exe+说明.txt+zip） |
扒图同步检查.ps1 |
Cad/Pdf Form3.cs 双胞胎漂移护栏（超基线报警） |
perf_load.py |
性能加载测试 |
版本控制与远程
- 远程：
http://192.168.9.43:3000/0999we/ctbjrj（Gitea，remote URL 内嵌访问令牌自动认证） - 节奏：每轮改动
git add -A → commit（中文消息）→ push；Release 附件只在发版时上传一次 - 故障排查（认证失败/rebase 整合/文件占用/gitignore 陷阱等 7 类场景）：见技能"git 推送流程与故障排查"
- 发版历史：Gitea Releases（含安装包与更新包附件）
开源组件致谢
软件内嵌的开源组件（WeifenLuo Docking、ADGV、NPOI、DotNetZip、SharpZipLib、ReoGrid、System.Data.SQLite、pdfium、WebView2、Node.js、ZCode、mlightcad CAD-Viewer、Umi-OCR、Lucide）的版权与许可声明见软件"关于→开源致谢"页及安装目录 licenses\。