--- title: 项目总览 created: 2026-04-13 updated: 2026-05-14 type: entity tags: [architecture, module] sources: [packages/backend/package.json, packages/frontend/package.json, packages/frontend/src/modules/agent/config.ts, packages/frontend/src/modules/geo/config.ts, packages/backend/scripts/build-windows-installer.js, packages/windows-tray/, packages/backend/skills/, packages/netabrowser-cli/, packages/backend/src/modules/geo/, packages/backend/src/modules/netaclaw/browser-daemon/, packages/backend/src/modules/desktop_op/] --- # 项目总览 Neta AI 电商是一个 AI 驱动的企业运营平台，采用 pnpm workspace Monorepo 架构。 ## 项目结构 | 包 | 路径 | 技术栈 | 端口 | |---|---|---|---| | 后端 | `packages/backend/` | Midway.js 3.20 + Cool Admin 8.0 + TypeORM | 8003 | | 前端 | `packages/frontend/` | Vue 3.5 + Vite 5.4 + Element Plus 2.9 | 9001 | | Windows 托盘 | `packages/windows-tray/` | .NET WinForms 托盘程序 | 本机 | | 后端 Skills | `packages/backend/skills/` | `SKILL.md` + Python/Node/.NET/Bash 脚本 | Agent 运行时 | | Netabrowser CLI | `packages/netabrowser-cli/` | Patchright + neta-chromium 浏览器自动化 CLI | 本机/daemon | ## 后端模块（16个） | 模块 | 路径 | 职责 | |------|------|------| | **netaclaw** | `src/modules/netaclaw/` | AI Agent 引擎核心（ReAct、Session Tree、工具治理、记忆、技能、Crew、会话子代理、压缩、渠道接入） | | **desktop_op** | `src/modules/desktop_op/` | 通用桌面 GUI Agent 运行时；当前用于 PC 微信窗口发送群聊回复 | | **geo** | `src/modules/geo/` | 账号矩阵、代理 IP、浏览器 profile/sessionName、cookie 登录态和 Agent 绑定 | | **base** | `src/modules/base/` | 用户、角色、菜单、权限（RBAC） | | **project** | `src/modules/project/` | 项目管理（甘特图、日历、看板、列表） | | **data** | `src/modules/data/` | 药品/医保数据管理 | | **user** | `src/modules/user/` | C端应用用户 | | **dict** | `src/modules/dict/` | 字典/枚举配置 | | **task** | `src/modules/task/` | 定时任务调度 | | **space** | `src/modules/space/` | 文件存储空间 | | **notification** | `src/modules/notification/` | 通知服务（飞书等） | | **plugin** | `src/modules/plugin/` | 插件系统 | | **recycle** | `src/modules/recycle/` | 回收站 | | **demo** | `src/modules/demo/` | 演示代码 | | **swagger** | `src/modules/swagger/` | API 文档 | ## 前端模块（14个） | 模块 | 路由前缀 | 职责 | |------|---------|------| | **agent** | `/agent/*` | AI 对话、Agent 管理、Tool 管理、Skill 管理、模型渠道、Crew 编排画布/监控、频道管理 | | **geo** | `/geo/*` | 账号、代理 IP 和养号相关管理入口 | | **base** | `/` | 登录、首页、权限管理 | | **project** | `/project/*` | 项目管理四视图 | | **data** | `/data/*` | 药品数据管理 | | **ontology** | `/ontology/*` | 知识图谱可视化 | | 其他 | - | dict, task, space, user, notification, helper, recycle, demo | ## Agent 模块新增入口 `packages/frontend/src/modules/agent/config.ts` 当前已注册： - `/agent/chat` - `/agent/agents` - `/agent/tools` - `/agent/skills` - `/agent/model-channel` - `/agent/channel-management` - `/agent/detection-result` - `/agent/crew-editor` - `/agent/crew-monitor` - `/agent/memory` 其中 `/agent/tools` 是 2026-04-19 前后新增的重要管理入口，对应 [[tool-governance]]。 `/agent/memory` 是 2026-04-26 新增的记忆管理入口，对应 [[memory-system]]，支持跨 MySQL/SQLite 后端查看、编辑和类型管理。 `/agent/skills` 在 2026-04-27 后升级为 [[skill-runtime]] 管理入口，展示 prompt / compute-entry / compute-toolkit 分类、env secrets 配置和诊断信息。 `/agent/channel-management` 在 2026-05-14 后升级为微信渠道运营入口：支持 ClawBot 私聊和 weixin-db 本地群聊代理，并配置 v4 双 Agent 自动回复。 近期如果让 AI 快速熟悉项目，Agent 模块里优先级最高的入口已经变成： - `/agent/chat`：Session Tree 对话、continue-from-entry、子 Agent 回放与诊断。 - `/agent/tools`：全局工具治理、runtime diagnostic、renderer/worker 路由。 - `/agent/agents`：单 Agent 配置，尤其是工具局部覆盖和子 Agent 策略。 - `/agent/memory`：长期记忆管理、类型管理、Agent 维度统计。 ## Windows 本地部署 2026-04-25 后，项目新增 [[windows-runtime]] 子系统： - 后端可打包为 `backend.exe`，安装态从同目录 `config.yaml` 读取端口、数据库和数据目录。 - `dataDir` 成为所有可写路径的统一根，包括日志、SQLite 记忆、file session、skills 和 runtime info。 - `packages/windows-tray/` 提供托盘程序，负责启动/附着/停止后端，并打开系统、日志目录和配置目录。 - `packages/backend/installer/setup.iss` 和 `scripts/build-windows-installer.js` 负责 Windows 安装包构建。 ## 核心关系 - [[netaclaw-module]] 是整个平台的 AI 大脑 - [[tool-governance]] 管理 Agent 实际可见工具 - [[tool-operations]] 抽象工具底层文件、搜索和进程执行后端 - [[session-tree-runtime]] 管理 Agent Chat 的主会话状态载体 - [[subagent-session]] 为普通对话提供轻量子 Agent 能力 - [[context-compaction]] 解决长会话上下文膨胀问题 - [[memory-system]] 提供长期记忆和 `/agent/memory` 管理页面 - [[skill-runtime]] 提供 Skill 分类、配置、密钥和 compute-entry 执行 - [[document-skills]] 提供 PDF / DOCX / XLSX 文档处理能力 - [[image-generation-tools]] 提供文生图和图生图能力 - [[runtime-process-events]] 提供长耗时工具和 Skill 的过程进度表达 - [[vehicle-damage-skill]] 提供车辆环车视频旧伤检测能力 - [[geo-module]] 提供账号、代理 IP 和浏览器 profile 绑定能力 - [[netabrowser-runtime]] 提供反风控浏览器 CLI/daemon 和拟人化自动化能力 - [[desktop-op-module]] 提供本机桌面 GUI 操作运行时，当前用于微信自动发送 - [[windows-runtime]] 提供安装器、托盘和本机 runtime 控制 - [[project-module]] 提供项目管理能力 - [[base-module]] 提供认证和权限基础设施 - [[cool-admin-framework]] 提供自动 CRUD 和路由框架 ## 技术栈版本 | 技术 | 版本 | 用途 | |------|------|------| | Node.js | >= 24.0.0 | 运行时 | | Midway.js | 3.20.11 | 后端框架 | | TypeORM | 0.3.20 | ORM | | Vue | 3.5.13 | 前端框架 | | Element Plus | 2.9.3 | UI 组件库 | | Anthropic SDK | 0.81.0 | Claude API | | OpenAI SDK | 4.73.0 | OpenAI/兼容 API | | MCP SDK | 1.20.1 | MCP 协议 | | Socket.IO | 4.8.3 | 实时通信 | ## 2026-04-23 当前理解项目的推荐顺序 如果要让新 Agent 或新人快速熟悉 Neta，推荐先读： 1. [[project-overview]] 2. [[netaclaw-module]] 3. [[agent-runtime]] 4. [[session-tree-runtime]] 5. [[subagent-session]] 6. [[tool-governance]] 7. [[tool-operations]] 8. [[skill-system]] 9. [[skill-runtime]] 10. [[frontend-architecture]] 这样能先建立“项目总览 -> Agent 主链路 -> 会话状态 -> 子 Agent -> 工具治理/执行后端 -> Skill 运行时 -> 前端消费”的主骨架，再去看单个工具或业务模块。 ## 2026-05-07 增量 5 月 2 日之后新增的架构重点： - [[image-generation-tools]]：NetaClaw 新增 `text_to_image` / `image_to_image`，通过 Ark/MiniMax provider 和模型渠道配置生成图片。 - [[runtime-process-events]]：长耗时工具和 compute-entry Skill 现在可以流式输出过程事件，并由前端时间线恢复历史回放。 - [[vehicle-damage-skill]]：新增汽车环车视频旧伤检测 Skill，输出候选、最终旧伤、证据帧和复核图。 - [[geo-module]]：新增账号与代理 IP 模块，为账号矩阵、cookie 登录态和浏览器 profile 绑定打基础。 - [[netabrowser-runtime]]：新增反风控浏览器 CLI/daemon，提供 patchright、neta-chromium、拟人化交互、代理和持久 profile。 ## 2026-05-14 增量 5 月 8 日之后新增的架构重点： - [[agent-channel]]：微信渠道拆分为 `weixin` ClawBot 私聊和 `weixin-db` 本地群聊代理；新增群白名单、每群 Agent 覆盖、触发策略和 v4 双 Agent 自动回复配置。 - [[desktop-op-module]]：新增通用桌面 GUI Agent 模块，封装窗口定位、截图、键鼠、VLM 验证、队列互斥、任务取消和审计日志。 - [[tool-system]]：新增 `weixin_send_text` 工具，通过 `_netaRuntime.bizContext` 读取 channelId，通过当前桌面 Agent 读取 modelChannel，并委托 Desktop Op 操作 PC 微信。 - [[frontend-architecture]]：频道管理页新增 weixin-db、wxid 唯一性校验、群聊管理和微信自动回复配置区块。