项目标签： 工程造价 造价数据库 清单编制 Excel 导入 数据治理 项目指标 清单匹配 本地优先 FastAPI React AI 助手
面向个人工程造价师的 AI 驱动、本地优先的工程造价数据管理与清单编制工作台。
项目当前为技术预览版（V0.1）：已覆盖从历史 Excel 数据导入、清洗治理、检索比对到清单编制辅助的核心闭环；由于尚未使用真实脱敏广联达样本完成准确率验收，暂不标记为正式 V1。
- 历史数据入库：导入 Excel，识别工作表与字段映射，保留源文件、来源行号与导入问题。
- 数据治理：项目画像、版本发布、口径与可比性提示、质量报告、单位换算及规范化规则。
- 多库检索：在项目库、指标库、资源库、定额库中搜索，并支持跨项目工作台检索与来源追溯。
- 参考样本筛选：清单库支持按地区、专业、计价时间、项目类型、计价体系、成果阶段、价格区间、含税方式和价格来源状态筛选；可区分可参考与受限样本，并按可用性、单价、工程量或计价时间排序。
- 比对与分析：工程量清单比对、候选匹配、项目指标计算和同类项目基准参考。
- 清单编制辅助：维护清单记录，导出参考价格与导入质量报告。
- 可控 AI 增强：支持 DeepSeek 的自然语言检索、候选审阅和导入映射建议；API Key 存于 macOS Keychain，未配置 AI 也不影响确定性功能。
- 本地数据保护：业务数据默认保存在本机，支持自动/手动备份与恢复。
- 后端：Python 3.13、FastAPI、SQLAlchemy、SQLite
- 前端：React 19、TypeScript、Vite
- 数据处理：openpyxl
- 前端组件：React Query、可复用表单控件与响应式筛选工具栏
- 打包：PyInstaller（macOS arm64）
要求 Apple Silicon Mac、Python 3.13、uv、Node.js 22 和 pnpm 10。
make install
make dev打开 http://127.0.0.1:5173。生产构建由 FastAPI 同源提供：
make build
cd backend && uv run python -m cost_data.launcher业务数据默认位于 ~/Library/Application Support/cost-data/。
make test
./packaging/build-macos.sh人工测试可使用 backend/.venv/bin/python scripts/generate_sample.py 生成样本文件；仓库不包含客户数据。
清单库默认展示可参考样本。点击“高级筛选”可展开价格口径和项目属性条件；“常用组合”提供近三年结算价、同专业可用样本和含税综合单价等预设，也支持保存和读取个人筛选条件。受限样本仍可查询，但会明确标注为“参考受限”，不进入同类项目标杆池。
- 已完成历史项目数据治理、多库检索与清单编制工作台的技术预览闭环。
- 待以真实 Excel 脱敏样本校准解析器，并完成正式 V1 的准确率验收。