本地优先的跨境电商多品牌运营 Agent 工作台
让运营主管、商品运营、内容策划、新媒体文案、视觉设计与内容审核成为可配置、可协作的数字员工。
快速开始 · 核心功能 · 系统架构 · API · 安全策略
一句话：传统电商工具告诉你任务在哪里；NEXUSCommerce 让一组有明确岗位、能力和协作边界的数字员工持续推进内容生产与品牌运营。
NEXUSCommerce 是面向跨境电商品牌与运营团队的 AI 原生工作环境。它将多品牌运营驾驶舱、Agent 工作区、内容流水线、长期记忆、能力矩阵和多渠道触达放进同一个可控运行时中。
平台把六类传统岗位抽象成可配置数字员工：
- 运营主管：拆解经营目标、安排协作并复盘交付结果。
- 商品运营：负责选品研究、竞品对标、卖点与 Listing 策略。
- 内容策划：规划受众、选题、内容矩阵、Brief 与发布节奏。
- 新媒体文案：生产多语言、多平台、符合品牌语气的内容。
- 视觉设计：将内容策略转化为视觉方向、尺寸与交付规范。
- 内容审核：执行事实、品牌、语言、平台规则与合规检查。
每名数字员工都可以独立配置身份 Prompt、行为规则、模型、思考级别、Skills、MCP、运行环境和所属工作区。岗位模板不会自动绑定工作区或执行外部操作。
驾驶舱中的 GMV、曝光、转化率和示例品牌均带有“演示数据”标识；Agent、工作区与任务运行状态来自真实后端数据。
- 集中查看品牌矩阵、渠道概览、内容流水线与数字员工状态。
- 从驾驶舱直接进入工作区、部署岗位或创建内容任务。
- 示例数据与真实状态明确区分，不用虚构指标填补数据缺口。
- 内置六类标准岗位蓝图，一键部署后仍可完整编辑。
- 通过 Agent Profile 管理身份、人格、协作规则和工具说明。
- 工作区、Session、Memory 与渠道绑定按 Agent 隔离。
- 支持主会话、子会话、流式输出、取消、恢复和 Subagents。
- 围绕策划、制作、审核、发布组织内容生产任务。
- 支持 Cron、固定间隔和一次性任务。
- 提供立即运行、暂停、停止、重试、回收站和运行历史。
- 任务沿用所属工作区的 Agent、权限、上下文与通知渠道。
- 统一管理 Skills、MCP 与 Plugins，并显示来源、依赖和可用状态。
- 可按数字员工决定继承全部能力、选择部分能力或禁用。
- 工作区与项目能力在运行时叠加，同时保持权限和路径边界。
- 支持 Web、Electron、飞书、Telegram、QQ、钉钉、微信、Discord 与 WhatsApp。
- 数据库、会话、工作区文件和运行配置默认保存在本机。
- 支持 Host 和 Docker 两种 Agent 执行模式。
- Renderer 不直接接触数据库、凭据、Docker 或宿主机进程权限。
Web Client / Electron / Message Channels
│ HTTP + WebSocket
▼
NEXUSCommerce Backend
Auth · ACL · Queue · Scheduler
│
┌────────────┼─────────────┐
▼ ▼ ▼
Digital Employees Workspaces Channels
Prompt / Model Session Bindings
Skills / MCP Memory Delivery
└────────────┼─────────────┘
▼
Pi Agent Runtime
Host / Docker · Subagents
Backend 负责认证、持久化、调度和授权；Agent Runtime 负责执行；Workspace 决定文件与上下文边界；Web 与 Electron 只负责界面和受限客户端能力。
- Node.js 20+
- npm
- 可选：Docker（仅容器执行模式需要）
git clone https://github.com/<your-account>/NEXUSCommerce.git
cd NEXUSCommerce
npm install
npm --prefix web install
npm --prefix container/agent-runner install
# 开发模式：同时启动 Backend 与 Web Client
npm run dev:all默认 Backend 地址：http://127.0.0.1:3000
默认 Vite 地址：http://127.0.0.1:5173
首次进入时创建管理员账户，然后在设置中配置模型服务。消息渠道、Docker 与外部能力均可稍后接入。
生产式本地运行：
npm run build:all
npm start| 命令 | 说明 |
|---|---|
npm run dev:all |
启动 Backend 与 Vite Web Client |
npm run build:all |
构建 Backend、Web 与 Agent Runner |
npm run typecheck |
检查 Backend TypeScript |
npm test -- --run |
运行 Vitest 测试 |
npm run desktop:dev |
启动 Electron 开发环境 |
npm run desktop:package |
构建当前平台安装包 |
- 不要提交
data/、.env*、数据库、密钥、Session Cookie 或 Provider 凭据；.gitignore已默认排除这些内容。 - 远程部署应使用 HTTPS/WSS，并独立配置反向代理、Cookie 和访问控制。
- Host 执行模式拥有更高本机权限；不可信任务优先使用 Docker 隔离。
- Agent 不应声称拥有未配置的能力，示例指标也不能被当作真实经营数据。
- 完整权限模型见
docs/ACL-MATRIX.md，漏洞报告流程见SECURITY.md。
NEXUSCommerce 当前处于早期开发阶段，已经具备 Web 工作台、六岗位数字员工蓝图、Agent 工作区、内容任务、Memory、Skills、MCP、Plugins、多渠道适配与 Electron Shell。
近期计划：
- 接入真实的品牌、商品、渠道和内容效果数据源。
- 增加品牌资料库、内容日历和审核流可视化。
- 补充跨市场本地化、平台合规与内容质量评测。
- 完善 Windows、macOS 与 Linux 桌面打包和发布流程。
本项目基于 Miniclaw 改造，Agent 运行时由 Pi Agent Runtime 驱动。感谢原项目作者和所有上游开源贡献者。
项目沿用仓库中的 MIT License。