GPU_GUARD_MONOREPO/docs/code-wiki/index.md

Wiki Index

Neta AI 电商平台代码知识库内容目录。 每个 wiki 页面按类型列出，并附一行摘要。 查询时先读此文件定位相关页面。 最后更新：2026-05-15 | 总页面数：39

Entities（实体）

• agent-channel - Agent 外部渠道接入，包括 ClawBot 私聊、weixin-db 群聊代理、群白名单和 v4 双 Agent 自动回复。
• agent-runtime - Agent 运行时核心；当前以 Session Tree、ChatOrchestrator、ToolResolver、Subagent Worker 和 canonical subagent projection 边界组成。
• base-module - 用户、角色、菜单、权限等 RBAC 基础设施。
• clarify-tool - Clarify 澄清工具，支持 Agent 向用户提问和 WebSocket/微信降级。
• cool-admin-framework - Cool Admin 8.0 的自动 CRUD、Service 代理和 BaseEntity 机制。
• crew-orchestration - Multi-Agent Crew 编排系统，支持画布编辑、任务运行和实时监控。
• document-skills - PDF、DOCX、XLSX 文档处理 Skills，覆盖 MiniMax 文档生成、编辑、验证和脚本工具包。
• desktop-op-module - 通用桌面 GUI Agent 模块，封装窗口定位、截图、键鼠、VLM 验证、队列互斥和微信发送审计。
• geo-module - Geo 账号与代理模块，管理平台账号、代理 IP、浏览器 sessionName、fingerprintSeed 和 cookie 登录态。
• image-generation-tools - 文生图/图生图工具族，支持火山引擎 Ark、MiniMax provider、图片持久化和前端结构化渲染。
• llm-providers - Anthropic、OpenAI、DeepSeek 等 LLM 提供商适配层。
• memory-system - Agent 长期记忆系统，支持 MySQL/SQLite 双后端、显式 recall、类型管理和 /agent/memory 管理页。
• mysql-data-source - MySQL 数据源、只读问数工具、SQL guard、schema/sample/query 服务、数据源管理页和查询审计。
• netaclaw-module - NetaClaw AI Agent 核心模块总览，包含 Session Tree、工具治理、Skill Runtime、记忆、子 Agent、渠道群聊和 19 张核心表。
• netabrowser-runtime - Netabrowser 反风控浏览器运行时，包含 CLI、后端 browser-daemon、patchright/neta-chromium、拟人化交互和持久 profile。
• patch-tool - Patch 模糊补丁工具。
• project-module - 项目管理模块，包括甘特图、日历、看板、列表和工时记录。
• project-overview - Neta monorepo 项目总览，包含 Agent 入口、Desktop Op、Windows 安装器/托盘、后端 Skills 和推荐阅读顺序。
• skill-system - Skill 技能系统，支持 GitHub、ZIP、本地安装、分类、诊断、密钥配置和附属文件。
• subagent-session - 普通对话中的会话级子 Agent 委派；现已包含 worker 进程、证据摘要、过程回放和后端 projection。
• todo-system - Agent 会话级任务管理。
• tool-catalog - Tool Catalog 工具目录系统，负责 schema 级工具注册。
• tool-governance - Tool 全局治理系统，负责 DB 同步、Agent 覆盖、运行时诊断和前端投影。
• tool-system - Agent 工具实现层，涵盖内置工具、Operations 注入、风险确认、执行链路、weixin_send_text 和子进程工具路由。
• vehicle-damage-skill - 汽车环车视频旧伤检测 Skill，负责抽帧、旧伤候选、定位标注、放大复核和最佳证据帧输出。
• websocket-gateway - Socket.IO 实时通信网关，承载 NetaClaw 对话和 Crew 监控事件。

Concepts（概念）

• context-compaction - 长会话上下文压缩机制，当前通过 Session Tree compaction 节点表达。
• development-conventions - 后端、前端、数据库统一开发规范。
• frontend-architecture - Vue 3 模块化前端架构，重点覆盖 Agent Chat Store、频道管理、会话树、子 Agent 回放、工具确认、工具治理页、Skill 页和记忆页。
• prompt-builder - Prompt Builder 分层注入系统，消费 ToolResolver 的最终工具列表和 Prompt Hint。
• react-loop - ReAct 推理模式，描述 LLM 思考和工具行动交替。
• runtime-process-events - 长耗时工具和 Skill 的运行时过程事件，支持进度流、JSONL 日志、采样 metadata 和前端时间线回放。
• session-tree-runtime - Session Tree 运行时，会话树、active path、snapshot、continue-from-entry、删除语义和子 Agent projection 契约。
• skill-runtime - Skill Runtime 执行体系，覆盖 skill.config.yaml、compute-entry、compute-toolkit、scoped secrets 和诊断。
• thinking-system - Thinking/Reasoning 能力系统，包括模型预算映射和会话级动态调节。
• tool-operations - 工具底层执行后端抽象，分离 File/Process/Search Operations 与工具业务逻辑。
• tool-runtime-policy - 工具运行时策略，负责 manifest、worker policy、工具路由、blocked reason 和 Operations 边界推导。
• windows-runtime - Windows 本地部署运行时，覆盖 backend.exe、托盘、安装器、dataDir 和本机控制接口。

Comparisons（对比）

• database-entity-overview - Entity 按模块分组和核心表字段速查，包含 netaclaw 渠道群表与 desktop_op 配置/审计表。

Queries（查询）