成本智能分析助手 - DeepSeek-R1 版

基于 DeepSeek-R1 推理大模型的成本分析工具，采用后端代理模式，API Key 安全存储在服务器端。

架构说明

┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│   前端页面   │ ──▶  │  本地后端    │ ──▶  │ DeepSeek API│
│  (浏览器)   │      │ (localhost) │      │  (R1模型)   │
└─────────────┘      └─────────────┘      └─────────────┘
                            │
                            ▼
                     API Key 安全存储
                   (不暴露给前端用户)

功能特点

🤖 DeepSeek-R1 推理模型: 展示完整思考过程 + 最终答案
🔒 后端代理模式: API Key 存储在服务器，前端无需配置
💰 多种分析模式: 成本核算、差异分析、敏感性分析、方案对比
📝 丰富模板: 内置 BOM 成本、盈亏平衡、自制外购等常用模板
💾 本地历史记录: 分析记录保存在浏览器本地

快速开始

1. 启动后端服务

1 2	cd factor-api start.bat

服务将启动在 http://localhost:8001

2. 启动前端（Hexo）

1	npm run dev

访问 http://localhost:4000/factor-generator/

3. 开始使用

打开页面即可直接使用，无需配置 API Key！

使用说明

选择分析类型

模式	说明	适用场景
💰 成本核算	计算产品/项目的单位成本和总成本	BOM 分析、产品定价
📊 差异分析	对比标准成本与实际成本	成本控制、预算分析
📈 敏感性分析	分析价格波动对成本的影响	风险评估、采购决策
⚖️ 成本对比	对比不同方案的成本	自制外购、技术路线选择

输入分析需求

在文本框中详细描述你的成本分析需求，建议包含：

产品/项目基本信息
各项成本构成（材料、人工、费用）
数量、单价等具体数据
希望得到的分析结果

提示: 输入越详细，AI 分析越精准。

R1 模型特点

DeepSeek-R1 是推理模型，会：

展示思考过程: 在结果上方显示灰色思考框，展示 AI 的推理过程
给出详细分析: 逻辑严密，计算步骤清晰
响应时间: 由于需要推理，通常需要 20-60 秒

常用模板

左侧边栏提供以下快速模板：

💰 通用成本分析
📦 BOM 成本核算
📊 成本差异分析
📈 价格敏感性分析
⚖️ 盈亏平衡分析
🏭 自制或外购决策
⚙️ 工序成本分析
🧮 材料用量差异

快捷键

Ctrl/Cmd + Enter: 快速开始分析

技术说明

后端 API

框架: FastAPI
地址: http://localhost:8001
端点:
- POST /api/ai/analyze - AI 成本分析
- GET /api/ai/status - 检查 AI 服务状态
- GET /api/prices - 获取材料价格数据

DeepSeek API 配置

API Key 存储在 factor-api/main.py 中：

1 2	DEEPSEEK_API_KEY = "sk-4cb086f508464f39835424bbfa372dd6" DEEPSEEK_MODEL = "deepseek-reasoner" # R1 推理模型

如需修改 API Key，编辑 main.py 文件即可。

数据存储

历史记录: 浏览器 localStorage['ai_cost_analysis_history']
API Key: 仅存储在服务器端，不暴露给前端

注意事项

后端服务必须先启动，否则前端无法使用 AI 功能
R1 模型推理时间较长，请耐心等待 20-60 秒
网络要求: 服务器需要能够访问 api.deepseek.com
Token 消耗: 详细分析可能消耗较多 Token，请注意余额

故障排查

前端提示 “无法连接到后端服务”

检查后端是否已启动：

1 2	cd factor-api python main.py

AI 分析超时

R1 模型推理时间较长，如遇到超时：

检查网络连接
尝试简化分析需求
查看后端控制台是否有错误信息

API Key 失效

如遇到认证错误：

登录 https://platform.deepseek.com/
检查 API Key 是否有效
更新 factor-api/main.py 中的 DEEPSEEK_API_KEY

更新日志

v1.0 (2026-03-06)

初始版本发布
集成 DeepSeek-R1 推理模型
后端代理模式，API Key 安全存储
支持四种分析模式
添加历史记录功能

开源协议

MIT License