项目总览

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，推荐先读：

这样能先建立“项目总览 -> 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 唯一性校验、群聊管理和微信自动回复配置区块。

8.6 KiB Raw Blame History Unescape Escape