# 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（查询）
