AIO Hub 工具架构总集篇
本文档按当前
HEAD（2026-07-31）翻新，汇总src/tools/下已经提供ARCHITECTURE.md的 41 个工具模块。 每个条目只保留定位、架构主线和近期需要关注的边界；完整设计、数据流和实现约束请参阅对应模块的ARCHITECTURE.md。当前
src/tools/共包含 47 个顶层工具目录，另有agent-manager、git-committer、retrieval、user-profile-manager、wallpaper-detector、window-automator6 个目录尚未建立架构文档，因此不纳入本篇 41 个文档条目的统计。
一、AI / LLM 核心工具
1. llm-chat — 核心对话系统
项目的旗舰 Agent 交互平台，以 ChatMessageNode 树维护非破坏性分支历史，并由会话索引/详情管理器负责多会话、收藏夹和原子化持久化恢复。
- 统一上下文管道：当前为 11 个核心处理器，覆盖会话加载、异步任务、正则、转写、世界书、预设注入、Recall、会话变量、Token 限制、消息格式化和资源解析。
- 跨工具编排：Agent、User Profile、Recall、Knowledge、ST Worldbook Manager、Tool Calling 和 Skill Manager 通过明确的门面/类型边界协作，
llm-chat不再独占这些领域的数据所有权。 - 交互与诊断：支持树状分支、推理状态回放、上下文分析、搜索取消与竞态保护、快捷操作、附件管道、虚拟时间线和跨窗口同步。
亮点：树形会话、11 步上下文管道、原子化恢复、SillyTavern 兼容、Recall/Worldbook 解耦、VCP 工具调用和跨窗口同步。
2. media-generator — 媒体生成中心
一站式 AI 媒体生成工作站，采用会话—任务双轨制管理图片、视频、音频和 3D 生成。生成运行时只读取模型自身的 mediaGenParams，参数清洁、上下文规则和资产元数据嵌入在任务管道内完成。
亮点：会话与任务解耦、树形分支实验、按媒体类型的提示词优化、参数清洁与资产元数据闭环。
3. tool-calling — 工具调用基础设施
为 LLM Agent 提供“工具发现 → 协议解析 → 安全执行 → 结果回注”的闭环。协议层可扩展，当前生产实现以 VCP 文本标记协议为主，并通过 discovery、parser、executor、engine 分层承载工具调用。
亮点：协议可插拔、工具上下文发现、双重安全校验、AbortSignal 取消传播、超时/资源释放、授权原子检索工具和内置调试工作台。
4. knowledge-base — Knowledge 文档资料库
面向文档资料的独立领域，负责资料导入、持久摄取、目录同步、标签管理、检索过滤和显式授权访问。它与 Recall 的完整语义条目域分离，不再把 Recall store、entry 类型或运行时状态当作自己的实现。
亮点：文档域与 Recall 域分离、统一资料格式、持久摄取与目录同步、标签/过滤、显式资料引用和授权原子检索。
5. recall — Recall 思绪召回
管理完整语义条目、思绪集、标签、优先级、向量和检索运行时；以 SQLite 为真源，前端通过服务门面访问，后端提供模块化检索管线和监控能力。
- 检索预设：当前稳定预设为
algorithmic与comprehensive，分别覆盖无需外部向量的算法召回和融合关键词/内容向量/标签/关联信号的综合召回。 - 产品接入：支持 Agent binding、
recallConfig、与【recall::key=value】契约，供llm-chat的上下文管道执行被动召回。
亮点：SQLite 真源、原子条目模型、可编译检索管线、全局 LRU 检索缓存、向量空间身份隔离、迁移兼容边界清晰。
6. embedding-playground — Embedding 测试场
交互式 Embedding 调试与评估工具，提供 A/B 相似度、1:N 排行、多模型竞技场、检索模拟和原始向量调试五种工作模式。
亮点：模型身份与 Embedding 空间分离、二级缓存隔离、向量数学工具、检索原型验证和多模型横向比较。
7. token-calculator — Token 计数器
在 Web Worker 中离线计算文本和多模态图片 Token。Tokenizer 通过资产注册表按需加载，主线程维护权威状态，Worker 使用无状态镜像，避免动态 loader 和主线程阻塞。
亮点：Tokenizer 资产化、Worker 主从架构、缓存隔离、OpenAI 图片 Token 估算和向后兼容的计算结果扩展。
8. skill-manager — Skill 技能管理器
Agent Skills 规范的运行时基础设施。采用 Backend-First 架构（Rust 引擎 + TypeScript 桥接），通过渐进式披露把 Skill 包接入工具调用系统，并用 SkillProxy 与 SkillManagerProxy 分离激活、上下文、脚本执行和文件读取职责。
亮点：Rust 路径沙箱与超时控制、Bundle 安装管理、用户主动安装、.env 环境变量管理、工厂桥接热加载、渐进式披露和双代理分工。
9. translator — 翻译工作台
多渠道 LLM 并排翻译工具，采用 Facade + 子模块结构，通过 Pinia Store 编排设置、预设、引擎和历史。支持流式并发、单渠道停止/重试、场景化预设、智能语言粘性和输出 Token 风险估算。
亮点：多渠道对比、独立 AbortController、8 套场景预设、XML 保护、智能分片和三级 Token 风险预警。
10. st-worldbook-manager — ST 世界书管理器
从 llm-chat 完全剥离出的自治工具，管理 SillyTavern 格式世界书的存储、编辑、导入导出和跨窗口同步。其他模块通过单向依赖引用其组件、Store 和类型。
亮点：独立工具注册、冷启动自动迁移、JSON 存储闭环、跨窗口同步、原子选择器到完整管理面板的分层 UI。
二、开发与调试工具
11. llm-inspector — LLM 请求代理拦截器
面向 LLM 请求的开发调试面板，提供请求捕获、筛选、详情查看和响应分析；外部代理运行时会计算并展示监听地址，支持复制地址进行联调。
亮点：请求/响应可视化、代理状态与监听地址联动、调试数据与业务会话解耦。
12. api-tester — HTTP API 测试工具
支持请求构建、变量模板、响应查看、请求历史和接口校验的 API 调试工作台。
亮点：预设一键填充、变量系统、请求历史、响应面板和流式响应自动检测。
13. code-formatter — 代码格式化工具
基于 FormatterCore 的 Prettier 格式化工具。Prettier 核心和 YAML、PHP、XML 等语言插件均按需动态加载并缓存，通过启发式语言检测选择解析器，加载失败时提供 warning 回退。
亮点：全量按需加载、插件缓存、启发式语言检测、失败回退和零配置体验。
14. component-tester — 组件测试面板
内部开发调试工具，集中展示和测试 UI 组件，验证主题系统、消息系统和通用组件在不同状态下的表现。
亮点：Tab 分类管理、主题色板验证、消息系统测试和组件级快速回归。
15. service-monitor — 工具注册中心监控
通过 toolRegistryManager / ToolRegistry 读取已注册工具的元数据、分类和方法签名，为应用内部工具提供可视化发现和调试入口。
亮点：自动注册、工具分类、方法签名可视化和运行时注册边界检查。
三、文件与数据处理
16. dir-search — 目录内容搜索
Rust 后端流式搜索与前端实时渲染的目录内容搜索/替换工具。基于 ignore 并行遍历和有界 channel 背压，支持正则、大小写、全词匹配、上下文展示、预览和单项替换。
亮点：资源范围安全限制、完整取消生命周期、流式结果竞态保护、列表/树形双视图、Monaco 预览和 Preserve Case 替换。
17. aio-file-operator — 本地文件操作器
面向 Agent 的本地文件操作桥，通过 registry 暴露文件读写方法，复用通用文件命令、文档解析器和 web-canvas Diff 引擎。白名单/黑名单沙箱、审批区、大小限制、覆盖策略和审计日志共同构成安全边界。
亮点：Agent 可调用文件读写、双层安全策略、审批区前置校验、CRLF/LF 保持的 Diff 修改和操作审计。
18. asset-manager — 中央资产管理中心
全局统一的资产管理服务，以 Rust 后端索引提供高性能查询、哈希去重和多媒体元数据提取，并为图片、视频、音频等资产提供统一入口。
亮点：Rust 索引、哈希去重、视频缩略图、音频波形/封面采样、无限滚动懒加载和跨工具资产复用。
19. content-deduplicator — 内容查重工具
以 Rust 五阶段扫描漏斗处理文本文件：文件收集、尺寸分桶、快速指纹、全文规范化哈希和结果构建。支持精确副本与仅存在格式差异的规范化副本检测。
亮点：漏斗式过滤、BLAKE3 哈希、流式读取、进度事件和回收站安全删除。
20. data-filter — 数据筛选工具
面向大规模 JSON/YAML 数组的数据筛选和清洗工具，支持深层路径访问、多条件组合过滤、自定义脚本、预设和 keepUnmatched 结果控制。
亮点：lodash 深层路径取值、脚本过滤、预设系统、Agent 调用入口和未匹配项保留策略。
21. json-formatter — JSON 格式化工具
支持可控展开层级的 JSON 格式化工具，逻辑、视图和注册入口分层，允许用户精确控制折叠深度和输出结构。
亮点：自定义递归序列化、可控展开深度、Logic/Registry 解耦。
22. config-converter — 配置格式转换器
采用 Parse → JS Object → Serialize 三阶段管道，在 JSON/YAML/TOML/INI/XML/.env 六种格式之间进行 N×N 互转。提供实时预览和批量处理两种工作模式，并对有损转换收集警告而非静默丢失信息。
亮点：统一中间表示、路径优先+内容嗅探、300ms 防抖预览、批处理和有损转换警告。
23. regex-applier — 正则批量处理工具
前后端双引擎架构：前端 JavaScript 引擎提供实时预览，Rust 后端负责批量文件处理，并在跨引擎执行前进行兼容性检查。
亮点：双引擎协同、兼容性校验、规则链预设和批量处理。
24. text-diff — 文本对比工具
深度集成 Monaco Diff Editor，支持智能文件拖拽分配、差异查看和 Unified Diff Patch 生成。
亮点：企业级 Diff 编辑器、智能文件分配和统一补丁格式。
25. directory-tree — 目录树可视化
基于 Rust ignore 引擎高性能遍历目录并返回结构化 TreeNode，前端通过组合式状态层进行路径/文件名、多路径和多条件二次筛选，默认过滤模式为 gitignore。
亮点：后端初筛+前端二次筛选、路径历史、文件/目录大小统计、忽略规则支持和大目录性能。
26. directory-janitor — 目录清理器
Rust 后端驱动的目录清理工具，支持 Glob 名称、年龄、大小和深度等多条件过滤，并通过回收站删除降低误操作风险。
亮点：高性能扫描、AND 组合过滤、删除前校验和回收站保护。
27. symlink-mover — 符号链接搬家
将文件或目录移动到新位置并创建链接，支持符号链接和硬链接两种模式，Rust 后端在执行前完成路径与目标校验。
亮点：双操作模式、双链接类型、前置安全校验和可逆迁移思路。
四、媒体处理工具
28. ffmpeg-tools — FFmpeg 多媒体工作台
基于 Tokio 异步进程管理的 FFmpeg 前端，负责参数构建、子进程生命周期、stderr 进度解析、元数据提取和多任务并行；同时通过 Agent actions 支持自定义命令、串行 Pipeline 和媒体信息查询。
亮点：流式进度解析、Agent 命令编排、串行 Pipeline、任务并行、取消控制和智能码率计算。
29. media-info-reader — 媒体元数据读取
面向 AI 生成图片和通用媒体资产的元数据读取器，使用分层解析兼容 EXIF、WebUI 参数、非标准 PNG chunk、ST 角色卡和 ComfyUI 工作流。
亮点：三层递进解析、生成参数提取、角色卡支持和工作流提取。
30. danmaku-player — 弹幕播放器
非侵入式弹幕增强工具，支持外部播放器同步模式（双窗口 + Win32 吸附）和内置播放模式（单窗口 + 组件化集成），兼容 PotPlayer、mpv、VLC 等外部播放器。
亮点：窗口 Z-Order 吸附、虚拟时钟偏差校准、外部播放器适配和 GPU 合成层渲染。
31. transcription — 多模态转写管理
以任务驱动的插件化引擎处理图片、音频、视频、PDF 和 DOCX，将多模态资产转换为可复用的文本衍生数据，供 Chat 和其他工具消费。OCR 支持本地引擎、分批处理和 PDF 纯文字模式。
亮点：可插拔引擎、任务级模型优先级、OCR 分批、DOCX/PDF 引擎、资产衍生数据复用和物理清理。
32. realtime-subtitle-ocr — 实时字幕 OCR
定时采样屏幕字幕区域，通过 Rust 后端 aHash 去重后将截图放入异步 OCR 队列；前端按 pending / processing / done / error 管理字幕状态，再对已完成条目进行编辑距离合并、断句和 SRT 导出。
亮点：后端图像去重、异步 OCR 队列、失败状态可见、窗口几何同步、引用计数生命周期、独立 MonitorBox 和 SRT 输出。
33. smart-ocr — 智能 OCR
多引擎 OCR 工具，支持 Tesseract.js、Windows Native、VLMAPI 和 OCRAPI，并以智能切图处理长截图和批量任务。插件通过 manifest 声明能力，使用作业确认、结果和增量事件契约；插件注册和安装阶段还提供结构化诊断与平台产物预检。
亮点：多引擎插件化、空白横带切图、并发控制、作业协议、稳定贡献点、平台验证和可修复诊断。
34. sketch-pad — 画板
基于 Konva.js 矢量形状与 HTML Canvas 2D 位图手绘的轻量画板，两类图层可混合排列。支持自由笔、变换、文本编辑、图片导入、栅格化、合并、自动保存、.aiosk ZIP 导出和发送到 LLM Chat。
亮点：位图/对象 Canvas 分离、10 种撤销类型、图层混合模式、增量保存和断链占位图。
五、知识整合与外部连接
35. web-canvas — Agent 协作画布
采用 Physical-First 架构，编辑直接作用于磁盘，Git 负责版本追踪。内置 Search/Replace Diff 引擎，使用多级降级匹配策略处理 Agent 文件修改。
亮点：无影子文件、Git 原生版本控制、Bigram Dice 模糊匹配和 Diff 可审阅。
36. git-analyzer — Git 仓库分析
基于 git2-rs 的原生 Git 分析工具，流式加载提交、分支和仓库统计信息，并将分析结果交给前端格式化展示。
亮点：libgit2 性能、流式分批推送、分支加载回退保护和积木式格式化信息生成。
37. web-distillery — 网页蒸馏室
多模式网页内容提取工具，提供快速、Smart 和交互式三层蒸馏模式，并以本地 Axum 代理与浏览器注入能力处理同源、Cookie、指纹和交互采集问题。
亮点：分层蒸馏、配方/规则管理、身份与 Cookie 工作台、实时预览和本地代理。
38. vcp-connector — VCP 连接器
VCP 运行时桌面连接工具，分别管理 Observer 消息监控和分布式工具节点，支持 AIO → VCP 暴露工具、VCP → AIO 桥接工具及异步任务执行。分布式协议通过 requestId 维护 AbortController，支持 cancel_tool，断线时清理在途调用。
亮点：双 WebSocket、虚拟滚动监控、工具双向共享、审批系统、分布式超时保护、主动取消和断线清理。
39. color-picker — 智能取色器
图片颜色分析工具，并行运行 Quantize、Vibrant 和 Average Color 三种算法，结合资产服务和历史记录输出多维配色洞察。
亮点：并行多算法、资产复用、持久化历史和颜色结果对比。
六、系统与渲染引擎
40. system-pulse — 系统硬件监控仪表盘
推送驱动的实时硬件监控，覆盖 CPU、内存、磁盘、网络和 GPU。Rust 采集循环按采样层级推送，前端使用 RingBuffer 保存时间序列。
亮点：无轮询推送、分层采样、PDH/NVML 指标、RingBuffer 和可调密度展示。
41. rich-text-renderer — 富文本渲染引擎
面向 LLM 内容的交互式渲染引擎，以自研 V2 解析器融合 Markdown/HTML，提供稳定区/待定区流式更新、Patch 节流、样式隔离、Agent 资产解析、CDN 本地化和 VCP 可视化。
亮点：流式零闪烁、内容样式隔离、Patch 更新、嵌入式 SPA 沙箱和独立测试工作台。
附录：架构文档索引
📅 最后更新：2026-07-31
📁 文档来源：
src/tools/*/ARCHITECTURE.md（当前 41 篇）