AIO Hub 工具架构总集篇
本文档是
src/tools/下目前(2026-06-30)为止全部 39 个工具模块的架构速览花名册，按功能大类分组。 每个条目仅概述核心定位与关键亮点，完整架构细节请参阅对应模块的ARCHITECTURE.md。
一、AI / LLM 核心工具
1. llm-chat — 核心对话系统
项目的旗舰交互模块，实际上是一套拥有 25 个子系统 的完整 Agent 平台。
- 树状对话架构: 基于
ChatMessageNode的树形历史，支持非破坏性分支探索与嫁接；lastSelectedChildId记忆分支偏好；内建完整的撤销/重做栈。 - 统一上下文管道: 9 步处理器流水线（加载→正则→注入→RAG→转写→世界书→Token限制→格式化→资源解析），确保 Prompt 构建高度可控。
- 高级 Agent 配置: 深度集成用户档案、SillyTavern 兼容（角色卡/预设导入）、私有资产管理（
agent-asset://）、虚拟时间线与三阶段宏引擎。 - 内容增强与处理: 内置双向翻译（含 XML 保护）、上下文压缩（非破坏性摘要）、续写补全、快捷操作、本地路径转附件等功能。
- RAG 与知识系统: 智能 RAG（四种触发模式、双引擎检索、语义缓存）与世界书（关键词实时匹配注入）双轨并行。
- 基础设施与调试: VCP 纯文本工具调用协议、统一思考能力控制（Thinking Budget）、上下文分析器、消息 JSON 编辑器、TTFT/TPS 性能监控。
- UI 交互设计: 支持 CSS content-visibility 原生虚拟渲染（千级消息不卡顿）、Vue Flow 驱动的对话树图、跨窗口主从同步、输入草稿持久化。
亮点：树形分支结构、9 步统一上下文管道、SillyTavern 生态兼容、VCP 工具调用、非破坏性压缩、跨窗口同步、虚拟时间线。
2. media-generator — 媒体生成中心
一站式 AI 媒体生成工作站，采用会话-任务双轨制架构。支持图片/视频/音频/3D 多种模态生成，内置参数清洁、上下文规则、资产元数据嵌入等完整流程。
亮点：双轨解耦设计、树形分支实验管理、自动参数清洁与上下文规则。
3. tool-calling — 工具调用基础设施
为 LLM Agent 提供"感知工具→生成调用→解析执行→回注结果"闭环。支持多协议扩展，当前实现 VCP（文本标记协议）。内置调试测试界面。
亮点：协议可插拔、双重安全校验、超时保护、自动预览钩子。
4. knowledge-base — 知识库 / RAG 引擎
高性能本地 RAG 引擎，支持关键词、向量、混合等多种检索引擎热切换。基于原子知识单元和标签池体系，提供不同风格的召回体验。
亮点：多引擎热切换、标签之海语义关联。
5. embedding-playground — Embedding 测试场
交互式 Embedding 调试工具，提供相似度对比、RAG 检索模拟、基础向量调试三大面板。内置增量缓存机制。
亮点：二级缓存模型隔离、多种向量算法支持、RAG 原型快速验证。
6. token-calculator — Token 计数器
精确的 Token 计数工具，Web Worker 离线计算避免卡顿。支持动态 Tokenizer 懒加载和多模态图片 Token 估算。
亮点：Worker 主从架构、懒加载缓存策略、OpenAI 瓦片法/固定成本法兼容。
7. skill-manager — Skill 技能管理器 🆕
Agent Skills 规范的运行时基础设施。采用 Backend-First 架构（Rust 引擎 + TS 桥接层），将符合规范的 Skill 包无缝桥接到 AIO 工具调用系统。支持渐进式披露策略避免 Prompt 膨胀，双代理设计（SkillProxy 负责激活+上下文，SkillManagerProxy 提供脚本执行/文件读取）职责分离。内置可视化管理界面，支持从本地/Git/URL 安装 Skill。
亮点：Backend-First 安全架构（Rust 路径沙箱+超时控制）、工厂桥接热加载、渐进式披露、双代理分工、具名方法增强。
8. translator — 翻译工作台 🆕
多渠道 LLM 并排对比翻译工具。采用 门面 + 子模块（Facade + Sub-modules） 架构，通过 Pinia Store 编排四个独立 Composable（Settings / Presets / Engine / History）实现关注点分离。内置 8 套场景化预设模板（快速查词 / 学术精翻 / 代码注释 / 代码解释 / 文学润色 / 商务正式 / 字幕翻译 / 口语化），支持一键导入模板到现有预设。流式并发翻译，每渠道独立 AbortController 实现单渠道停止/重试。支持智能语言粘性、输出 token 事前风险估算（三级预警 + 二次确认）、自定义语言扩展、流式自动吸底与字符/词数实时统计。
亮点：门面 + 子模块解耦设计、8 套场景化内置预设模板、多渠道并发独立流控制、输出超限三级预警与二次确认、智能语言粘性、自动 Expansion Factor 与 max_tokens 估算、自定义语言扩展。
二、开发与调试工具
9. llm-inspector — LLM 请求代理拦截器
基于 Rust 原生 Axum 代理的 LLM 请求拦截工具。事件驱动通信，支持 SSE 流式实时捕获和解析。
亮点：Rust 层高性能代理、实时 SSE 流处理、请求/响应生命周期追踪。
10. api-tester — HTTP API 测试工具
预设驱动的 HTTP API 测试环境，内置 模板变量系统，原生支持 SSE 流式响应。
亮点：预设一键填充、变量系统、流式响应自动检测。
11. code-formatter — 代码格式化工具
基于 Prettier 的代码格式化，采用静态+动态混合插件加载策略，内置启发式语言检测。
亮点：按需动态加载插件、启发式语言检测、零配置体验。
12. component-tester — 组件测试面板
内部开发调试工具，集中展示和测试 UI 组件，验证主题系统在不同组件上的表现。
亮点：Tab 分类管理、主题色板验证、消息系统测试。
13. service-monitor — 服务注册中心监控
应用内部服务 API 可视化查询工具，读取 serviceRegistry 展示服务的元数据和方法签名。
亮点：自动服务发现、方法签名可视化。
三、文件与数据处理
14. dir-search — 目录内容搜索 🆕
轻量级目录内容搜索与替换工具，Rust 后端流式搜索 + 前端实时渲染架构。基于 ignore crate 并行遍历，有界 channel 背压控制，支持正则/大小写/全词匹配、上下文行展示、单项精确替换。
亮点：并行流式搜索（sync_channel 背压）、搜索代计数器竞态解决、双视图（列表/树形）、Monaco 可编辑预览、Preserve Case 替换。
15. aio-file-operator — 本地文件操作器 🆕
面向 Agent 的本地文件操作工具桥，通过 registry 暴露 8 个可调用方法，复用 Tauri 通用文件命令、文档解析器和 web-canvas Search/Replace Diff 引擎。内置白名单/黑名单沙箱、死区/审批区规则、文件大小限制、覆盖策略和最近操作审计日志。
亮点：Agent 可调用文件读写、双层安全策略、审批区前置校验、CRLF/LF 保持的 Diff 修改、ConfigManager 持久化审计。
16. asset-manager — 中央资产管理中心
全局统一的资产管理服务。基于Rust 后端索引实现高性能查询，支持自动去重、多媒体元数据提取（视频缩略图、音频封面）。
亮点：哈希去重、Rust 高性能索引、无限滚动懒加载。
17. content-deduplicator — 内容查重工具
基于 Rust 五阶段扫描漏斗算法：文件收集→尺寸分桶→快速指纹→全文规范化哈希→结果构建。支持精确/规范化副本检测。
亮点：五阶段漏斗过滤、BLAKE3 高速哈希、流式读取避免内存溢出、回收站安全删除。
18. data-filter — 数据筛选工具
处理大规模 JSON/YAML 数组的效率工具，支持深层路径访问和多条件组合过滤。
亮点：lodash 深层路径取值、自定义 JS 脚本过滤、预设系统。
19. json-formatter — JSON 格式化工具
支持可控展开层级的 JSON 格式化，允许用户精确控制折叠深度。
亮点：自定义递归序列化、可控展开深度、解耦的 Logic/Registry 分层。
20. config-converter — 配置格式转换器
采用 "Parse → JS Object → Serialize" 三阶段管道 的配置文件格式互转工具。通过统一的中间表示（JS 对象）实现 JSON/YAML/TOML/INI/XML/.env 六种格式任意双向 N×N 互转。提供单文件实时预览（300ms 防抖 CodeMirror 双栏）和批量文件处理双模式。内置"路径优先 + 内容嗅探"的格式自动检测引擎，对 INI/.env 等扁平格式的有损转换自动收集警告而非阻断。
亮点：三阶段统一管道 N×N 互转、双模式（实时预览 + 批量处理）、路径优先+内容嗅探格式检测、有损转换警告收集不阻断流程。
21. regex-applier — 正则批量处理工具
前后端双引擎架构：前端 JS 引擎提供实时预览，Rust 后端处理批量文件。内置正则兼容性检查。
亮点：双引擎协同、跨引擎兼容性校验、规则链预设。
22. text-diff — 文本对比工具
深度集成 Monaco Diff Editor，支持智能文件拖拽分配和 Unified Diff Patch 生成。
亮点：Monaco 企业级对比、智能文件分配、统一补丁格式。
23. directory-tree — 目录树可视化
基于 Rust ignore（ripgrep 引擎）高性能遍历，返回结构化 TreeNode，前端负责动态渲染与二次筛选。
亮点：后端结构化输出+前端动态渲染分离、原生 .gitignore 支持。
24. directory-janitor — 目录清理器
Rust 后端驱动的目录清理工具，支持多条件过滤（Glob 名、年龄、大小、深度）和安全回收站删除。
亮点：Rust 高性能扫描、灵活 AND 组合过滤、回收站保护。
25. symlink-mover — 符号链接搬家
将文件/目录移动到新位置并创建链接，支持符号链接和硬链接两种模式。Rust 后端前置安全校验。
亮点：双操作模式、双链接类型、前置校验防误操作。
四、媒体处理工具
26. ffmpeg-tools — FFmpeg 多媒体工作台
基于 Tokio 异步进程管理的 FFmpeg 前端，支持实时 stderr 进度解析和元数据提取。
亮点：流式进度解析、多任务并行管理、智能码率计算。
27. media-info-reader — 媒体元数据读取
专为 AI 生成图片设计的元数据提取器，三层解析策略兼容易用 EXIF、WebUI 参数、非标准 PNG chunk。
亮点：分层递进解析、ST 角色卡支持、ComfyUI 工作流提取。
28. danmaku-player — 弹幕播放器
非侵入式弹幕增强工具，支持外部同步模式（双窗口+Win32 API吸附）和内置播放模式（单窗口+组件化集成）。
亮点：窗口精准 Z-Order 吸附、虚拟时钟偏差校准、GPU 合成层渲染优化。
29. transcription — 多模态转写管理
弥合多模态资产与纯文本模型之间的鸿沟。插件化引擎架构支持图片/音频/视频/PDF 四种模态转写。
亮点：任务驱动架构、可插拔引擎、资产衍生数据秒开复用。
30. smart-ocr — 智能 OCR
四引擎 OCR 工具（Tesseract.js / Windows Native / VLMAPI / OCRAPI），内置智能切图算法处理长截图。
亮点：多引擎架构、空白横带检测切图、并发控制。
31. sketch-pad — 画板
轻量画板工具，基于 Konva.js 实现矢量形状编辑，结合 HTML Canvas 2D 实现位图手绘。两种图层类型自由混合排列。内置 perfect-freehand 笔画平滑、多色铅笔/马克笔/橡皮擦画笔、Transformer 变换控制与 10 种类型的混合撤销栈。支持图片导入（Asset Manager 集成）、文本就地编辑、图层栅格化与向下合并。项目以目录式结构持久化（appDataDir），支持自动保存、.aiosk ZIP 打包导出及一键发送到 LLM Chat。
亮点：专用位图/对象 Canvas 分离、10 种撤销类型、智能工具-图层自动匹配、图层混合模式控制、增量保存与断链占位图。
五、知识整合与外部连接
32. web-canvas — Agent 协作画布
Physical-First 架构的 Agent 协作画布，所有编辑直接作用磁盘，Git 追踪版本。内置强大的 Search/Replace Diff 引擎（4 级降级匹配策略）。
亮点：Physical-First 无影子文件、Git 原生版本控制、Bigram Dice 模糊匹配。
33. git-analyzer — Git 仓库分析
基于 git2-rs 的原生 Git 分析，流式加载百万级提交记录。
亮点：原生 libgit2 高性能、流式分批推送、积木式格式化信息生成。
34. web-distillery — 网页蒸馏室
多模式网页内容提取工具，三层蒸馏模式（快速/Smart/交互），内置本地 Axum 代理绕过同源限制。
亮点：三层蒸馏能耗递增、本地代理+反检测注入、可视化配方编辑器（开发中）。
35. vcp-connector — VCP 连接器
与 VCP（开源 AI 运行时）的桌面端对接工具。支持消息监控（6 种运行时事件实时展示）、分布式节点（暴露本地工具）、工具桥接到 AIO Hub 中使用。
亮点：双 WebSocket 独立管理、虚拟滚动消息监控、双向工具共享。
36. color-picker — 智能取色器
图片颜色分析工具，三种算法并行（Quantize / Vibrant / Average Color）提供多维度配色洞察。
亮点：并行多算法分析、资产去重集成、持久化历史记录。
六、系统与渲染引擎
37. system-pulse — 系统硬件监控仪表盘
推送驱动的实时硬件监控，覆盖 CPU/内存/磁盘/网络/GPU。Rust 采集循环（1s/5s 分层采样），前端 RingBuffer 存储。
亮点：推送式架构无轮询、PDH 实时频率、NVML GPU 监控、三档密度缩放。
38. rich-text-renderer — 富文本渲染引擎 🔥
LLM 时代的交互式内容渲染引擎。超越基础 Markdown，通过自研 V2 解析器实现 HTML 与 Markdown 的深度融合，支持嵌入式 SPA 沙箱运行与 VCP 工具调用可视化。
亮点：双区域 Patch 更新（零闪烁）、CSS 作用域隔离、嵌入式应用沙箱、多线程词法分析、LLM 思考链与可交互按钮支持。
七、包装入口工具
39. st-worldbook-editor — ST 世界书编辑器
轻量包装器，直接复用 llm-chat 的 WorldbookFullManager 组件，提供可分离窗口访问世界书编辑能力。
附录：架构文档索引
📅 生成时间: 2026-06-30
📁 文档来源:
src/tools/*/ARCHITECTURE.md（39 篇架构文档汇总）