BossAgents左帮右臂 —— 部署与使用手册
Agent Hackathon 2026 · 行业应用·智能制造
版本：v1.0 | 提交日期：2026-06-22
一、部署环境
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows / Linux / macOS |
| Node.js | >= 18.0.0（推荐 v22+） |
| 包管理器 | pnpm >= 10.22.0 或 npm 9+ |
| 内存 | >= 512MB（推荐 2GB+） |
| 数据库 | SQLite（内置，无需额外安装） |
| 昇腾 NPU（可选） | Ascend 310P / 910 芯片 |
| 开发工具 | AtomCode + CodingPlan Pro |
二、快速部署
2.1 克隆代码
git clone https://atomgit.com/tuan_zhang/bossagents.git
cd bossagents
2.2 安装依赖
# 推荐使用 pnpm
pnpm install
# 或使用 npm
npm install --legacy-peer-deps
2.3 配置环境变量
cp .env.example .env
# 编辑 .env，填入 LLM API Key（如需 AI 功能）
2.4 启动服务
node server.js
服务启动后访问：http://localhost:3006
三、功能验证
启动后按以下顺序验证核心功能：
| 验证项 | 预期结果 | 操作 |
|--------|----------|------|
| 页面加载 | 显示登录界面 | 访问 http://localhost:3006 |
| 登录 | 成功进入主界面 | 输入 SCSAI 用户名密码 |
| 产品列表 | 显示分页产品数据 | 点击"产品列表" |
| BOM 展开 | 多层 BOM 树可逐级展开 | 点击行首 ▶ 图标 |
| Where Used | 显示使用此零件的父项 | 右键零件 → "哪里使用" |
| 版本对比 | 差异高亮显示 | 选择两个版本 → 对比 |
四、昇腾NPU适配（可选）
4.1 安装昇腾插件
在 AtomCode 中执行：
/plugin marketplace add https://gitcode.com/gmq123/ascend-model-agent-plugin
/plugin install ascend-model-agent-plugin@ascend-model-agent-plugin
4.2 配置昇腾推理
编辑 config.yaml：
mtclaw:
enabled: true
base_url: "http://127.0.0.1:18790/v1"
upstream:
model: "ascend-glm-5.1"
4.3 验证 NPU 适配
npu-smi info
curl http://127.0.0.1:18790/v1/models
五、运行指令
| 指令 | 说明 |
|------|------|
| node server.js | 标准启动（端口 3006） |
| PORT=3007 node server.js | 指定端口启动 |
| LOG_LEVEL=debug node server.js | 调试模式启动 |
| npm run dev:vite | Vite 前端热更新开发 |
| pm2 start server.js --name "zuobangyoubi" | 生产环境进程管理 |
六、项目结构
bossagents/
├── server.js # 服务入口（Node.js）
├── config.yaml # 业务配置
├── package.json # 依赖管理
├── .env # 环境变量（敏感信息）
├── README.md # 项目说明 + 落地案例
├── INSTALL.md # 详细部署指南
├── DEPLOY.md # 本文档（快速部署手册）
│
├── SCSAI/ # SCSAI PLM 核心客户端（AML）
├── core/ # 规则引擎 + 能力运行时
├── server/ # 后端：路由/服务/数字员工
│ ├── routes/ # API 路由
│ ├── services/ # 业务服务
│ ├── digital-staff/ # 数字员工核心
│ └── agents/ # 事件驱动代理
├── src/ # Vue 3 前端源码
├── SCIOT/ # 7,706 个工业对象模型
├── generated/ # 自动生成的规则/模板
├── scripts/ # 数据脚本
└── docs/ # 技术文档
七、技术栈
| 层级 | 技术 | 说明 |
|------|------|------|
| 前端 | Vue 3 + Vite + Pinia + Vue Router | 响应式 SPA |
| 后端 | Node.js + Express | REST API + AML 代理 |
| 数据 | MySQL + SQLite + SCSAI AML | 多源数据融合 |
| AI | DeepSeek / OpenAI 兼容接口 | LLM 大脑 |
| NPU | 昇腾 Model-Agent 插件 | 模型加速与调优 |
| 开发工具 | AtomCode（CodingPlan Pro） | 参赛指定开发工具 |
八、常见问题
Q: 启动时报错 "port 3006 is already in use"
netstat -ano | findstr :3006
# 修改端口：PORT=3007 node server.js
Q: 登录失败？
检查 config.yaml 中 SCSAI 服务器地址、用户名密码是否正确。
Q: 数字员工不执行？
检查 LLM API Key 是否配置，config.yaml 中 cron.enabled: true。
九、提交检查清单
- [x] 源码已提交至 AtomGit 赛事官方仓库
- [x] README.md 包含落地案例与价值说明书
- [x] 代码仓包含完整项目源码
- [x] 昇腾 NPU 适配已完成（使用昇腾 Model-Agent Skill）
- [x] AtomCode + CodingPlan Pro 已配置
- [ ] 已推送至 AtomGit（最后一步）
左帮右臂 —— 不只是工具，是工业数据资产平台。
