# 使用手册-AI 目录

VOTX Agent AI 助手专用使用手册，包含系统内部架构和执行原理的完整分析。

## 文件列表

| 文件 | 说明 |
|------|------|
| `01-system-prompt拼接架构.md` | System Prompt 七层拼接顺序、注入规则、可见性分类、缓存机制 |
| `02-对话历史保留与压缩原理.md` | ChatManager 消息模型、20 轮保留策略、LLM 摘要压缩、JSONL 日志存储 |
| `03-工具调用原理.md` | Skill 注册体系、ToolRunner 执行流程、run_chat_turn 循环、上下文绑定 |
| `04-memory生命周期执行原理.md` | 三层数据模型、永久层与临时层、被动触发与主动审阅、清理机制 |
| `05-临时记忆生命周期执行原理.md` | 临时记忆创建、system prompt 注入、过期清理、临时→永久转化 |
| `06-定时任务执行位置.md` | CLI/Web 两种执行模式、cron 调度循环、并发安全、结果推送 |
| `07-消息路由编号原理.md` | 四层编号体系、身份映射、OneBot/Telegram 路由、推送队列 |
| `08-任务计划实际执行原理.md` | 无专用引擎设计、子代理生成、审批流程、system prompt 驱动执行 |
| `09-智能体工作规范.md` | Skill 优先、默认输出目录、临时文件、上传文件、知识库索引维护、插件收口状态 |

| `10-回复渲染与工具产物展示.md` | 回复渲染边界、正文层与 artifact 层规则、内嵌代码面板、图片气泡、文件下载、用户附件预览 |
| `deployment.md` | 普通 Python 启动、环境变量、外部访问/局域网访问、Windows 打包与手动源码更新说明 |
| `message-config.md` | 外部消息路由配置说明（同 knowledge/message-config.md） |
| `users-config.md` | 用户配置文件说明：目录结构、默认输出/上传目录、工具超时、技能禁用、用户知识库索引维护 |

## 与全局知识库的关系

本目录为 AI 助手的详细分析手册，内容比全局知识库更详尽。
全局知识库 `knowledge/` 中的 01~09 系列文件为本目录的精简版或同步版。
