Skip to content
TheLastSheepPublic

About

面向用户与 Agent 的高性能、轻量、本地优先的桌面工具运行时与结果工作台。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

101 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ATools Logo

ATools 3.0

基于 Rust + Tauri v2 的本地优先 AI-Native 桌面启动器与跨平台插件运行时
无缝兼容 uTools / ZTools 插件生态 · 零分配微秒级检索 · 原生 MCP + Skills + Agent Harness

CI Release Packages Version Tauri Rust License: MIT

简体中文 | English | 架构设计 (DESIGN.md) | 第三方开源声明


一、项目简介

ATools 3.0 是一款面向开发者与高频效率用户的本地优先(Local-First)桌面启动器、跨平台插件宿主与 AI-Native 能力工作台。

相比基于重型 Chromium + 常驻 Node.js 主进程与 LevelDB/LMDB 的传统桌面工具箱,ATools 采用 Rust 核心引擎 + Tauri v2 系统原生 WebView + SQLite WAL 嵌入式存储 + QuickJS 沙箱 + 按需(On-Demand)Node 兼容层 构建:

  • 极致性能:零分配 ASCII 匹配、全量 Unicode CJK 汉字(20,902+)编译期静态拼音索引、十万级(100,000)指令集 P99 搜索延迟约 0.1 ms(见下方基准表)。
  • 双命名空间生态兼容:同时提供 window.utools 与 window.ztools 双向等价桥接(125+ 宿主 API 契约面 + 原型链兜底探针),支持直接导入并运行原版 uTools / ZTools 插件与内置 40+ 原生增强工作台插件。
  • AI-Native 双向赋能:内置本地 MCP(Model Context Protocol)服务端、Skills 技能编排 与 Agent Harness 安全围栏,让 Claude Code、Cursor、Codex 等外部智能体可经过细粒度权限审批与脱敏审计调用桌面与插件能力。
  • 数据主权与隐私优先:所有文档、剪贴板历史、配置与插件数据默认保存在本地 SQLite WAL 数据库,支持 WebDAV 端到端加密同步与可选私有化部署的 Rust/Axum 同步服务(atools-sync-server)。

二、核心架构

flowchart TB
    subgraph Entry["双入口层 (Human + AI Agent)"]
        HumanUI["桌面交互入口\n(Tauri v2 原生窗口 / 全局快捷键 / 悬浮球 / 超级面板)"]
        AgentMCP["外部 AI 智能体入口\n(Claude Code / Cursor / Codex via 本地 MCP Server)"]
    end

    subgraph Core["ATools Rust 核心引擎 (crates/atools-core)"]
        Matcher["零分配检索引擎\n(20,902+ CJK 拼音 + 正则缓存 + ASCII 位掩码过滤)"]
        Harness["AI-Native Harness\n(权限门禁 + Prompt 脱敏 + 结构化错误观测)"]
        DB["SQLite WAL 存储引擎\n(prepare_cached + 256MB mmap + 附件/KV/审计日志)"]
        TaskRun["统一执行管线\n(TaskRun 状态机 + Artifact 产物 + Scoped Memory)"]
    end

    subgraph Runtime["三层混合插件与系统运行时 (3-Tier Hybrid Runtime)"]
        Tier0["Tier 0: Rust 原生系统能力\n(应用扫描 / 剪贴板监听 / 屏幕取色与截图 / 原生 OCR / 系统调用)"]
        Tier1["Tier 1: WebView 纯前端桥接\n(window.ztools & window.utools 双向等价 API + 111+ 原型链兜底)"]
        Tier2["Tier 2: QuickJS 预加载沙箱 + 按需 Node/Electron CJS 兼容层\n(rquickjs 轻量沙箱 + 隔离进程 JSON-RPC / 同步 HTTP 桥接)"]
    end

    HumanUI --> Matcher
    HumanUI --> TaskRun
    AgentMCP --> Harness
    Harness --> TaskRun
    Matcher --> DB
    TaskRun --> DB
    TaskRun --> Tier0
    TaskRun --> Tier1
    TaskRun --> Tier2
Loading

三、核心特性矩阵

维度 核心能力说明
极速启动与检索 全局快捷键呼出、应用/文件/系统指令/网页快开/聚合计算检索;支持首字母拼音(如 fygj)、全拼(fanyigongju)、JS 正则字面量(/pattern/flags)与多模态剪贴板自动识别。
双生态插件兼容 完整实现 window.utools 与 window.ztools API 契约(db / dbStorage / dbCryptoStorage、copyText / copyImage / copyFile、createBrowserWindow、ubrowser、ai、allAiModels、动态 setFeature、子输入框 setSubInput 等)。
三层插件运行时 Tier 1 纯 Web 插件直连 Tauri IPC;Tier 2A 纯 JS preload.js 运行于嵌入式 rquickjs 沙箱;Tier 2B 含 require('fs'|'child_process'|'electron') 的重度插件按需唤醒受控 Node 兼容工作进程并支持空闲回收。
40+ 内置精品插件 内置 JSON/数据工作台、颜色转换、剪贴板历史(Pasteboard Pro)、贴图截屏(Snipaste)、请求调试(HTTP/Webhook Lab)、密码/编解码、翻译、计算稿纸、二维码、待办事项、进程/启动项管理、文件/归档/Office/PDF/字幕工作台等。
AI-Native & MCP 治理 内置本地 MCP 服务端与一键生成客户端配置;支持细粒度权限策略(Allow / Confirm / Deny)、单次/会话级授权令牌、提示词脱敏(Prompt Sanitizer)与全链路审计日志。
跨平台原生集成 支持 macOS(NSPanel 无焦点浮层、原生 NSWorkspace 应用图标提取、Vision OCR、辅助功能联动)、Windows(Win32 窗口控制、句柄检索、注册表应用扫描)与 Linux(X11/Wayland 桌面适配)。
多端同步与自托管 支持本地数据导入导出、WebDAV 自动/手动同步(AES-GCM 加密),并提供独立 crate atools-sync-server 支持私有化部署同步服务。

四、性能基准对比

下表“门禁阈值”取自对应脚本的实际参数;“实测”为各场景中最差一项的 P99,于 2026-11-12 在 Apple M5 / macOS 27 / Node 24.15 本机运行得到(release 构建)。结果会写入 artifacts/performance/*.json,复现请运行对应命令。

基准测试项 规模 / 场景 门禁阈值 实测(最差 P99)
搜索索引 (pnpm benchmark:search:ci) 10,000 / 100,000 条别名 + 本地启动 + 网页快开 P99 ≤ 80 ms 0.109 ms
Rust 特征匹配 (cargo test -p atools-core --release --test matcher_performance_tests) 1,200 插件特性,逐条查询 ≤ 25 ms 0.24 ms
SQLite WAL 增长 (pnpm benchmark:database:ci) 10,000 / 100,000 任务记录与记忆条目 P99 ≤ 80 ms 13.1 ms
剪贴板历史检索 (pnpm benchmark:pasteboard:ci) 10,000 条记录 P99 ≤ 150 ms 3.0 ms
剪贴板历史检索 (pnpm benchmark:pasteboard:ci) 100,000 条记录 P99 ≤ 150 ms ⚠️ 857 ms(未达标):无匹配全文检索 857 ms、唯一文本检索 213 ms,已列为待优化项

五、仓库目录结构

atools/
├── crates/
│   ├── atools-core/          # Rust 核心引擎:零分配拼音/正则匹配、SQLite WAL、MCP Harness、TaskRun 管线
│   ├── atools-plugin/        # 插件加载器、兼容性分级器、QuickJS (rquickjs) 沙箱与权限校验
│   ├── atools-api-shim/      # uTools / ZTools 宿主 API 协议转换与 RPC 处理器
│   └── atools-sync-server/   # 可选私有化部署的 Rust/Axum 多端数据同步服务端
├── src-tauri/                # Tauri v2 桌面宿主:系统集成、多窗口编排、按需 Node 运行时与原生命令
├── src/                      # 桌面前端应用:启动器主面板、插件宿主容器、设置中心、双命名空间桥接库
├── packages/
│   ├── ztools-renderer/      # 锁定的 ZTools 兼容渲染层构建产物与溯源清单
│   ├── ztools-settings/      # 锁定的 ZTools 设置视图兼容包
│   └── ztools-updater/       # 锁定的 ZTools 更新器视图与宿主桥接包
├── resources/plugins/builtin/# 40+ 内置工作台插件与原生增强工具包
├── scripts/                  # 自动化验证、性能基准、宿主 API 审计与跨平台打包脚本
├── tests/                    # 460+ 组件/集成测试套件(近 4,000 条测试用例)
└── docs/                     # 架构决策记录 (ADR)、冒烟清单与演进规划文档

六、快速开始

1. 环境要求

  • Rust:1.80+(推荐最新稳定版,cargo / rustfmt / clippy)
  • Node.js:22+
  • 包管理器:pnpm 11+(可通过 corepack enable 启用)
  • 系统依赖:参考 Tauri v2 官方先决条件 安装对应操作系统的 WebView 与构建工具链。

2. 安装与开发调试

# 1. 克隆仓库
git clone https://github.com/TheLastSheep/atools.git
cd atools

# 2. 安装前端依赖
pnpm install --frozen-lockfile

# 3. 启动前端开发预览(浏览器模式)
pnpm dev

# 4. 启动 Tauri 桌面端完整开发模式
pnpm tauri dev

3. 构建与打包

# 构建前端与更新器静态产物
pnpm build:ztools-updater
pnpm build

# 构建当前平台 Tauri 桌面安装包 (.dmg / .app / .msi / .exe / .deb / .AppImage)
pnpm tauri build

七、质量门禁与测试验证

ATools 采用严格的分层自动化测试与性能门禁体系:

# 1. 前端与 Svelte/TypeScript 类型检查
pnpm check

# 2. 运行全量 Vitest 单元测试套件 (461 个测试文件 / ~4,000 条用例)
pnpm test:unit

# 3. 运行快速回归测试层与宿主 API 契约对账
pnpm test:fast
pnpm audit:host-api-surface

# 4. 运行 Rust 工作区格式、Clippy 静态检查与全量单元测试
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
pnpm test:rust

# 5. 运行十万级搜索、数据库与剪贴板性能基准门禁
pnpm benchmark:search:ci
pnpm benchmark:database:ci
pnpm benchmark:pasteboard:ci

八、CI/CD、版本发布与 GitHub Packages

仓库内置完整的 GitHub Actions 自动化流水线:

  • 持续集成 (.github/workflows/ci.yml):自动执行版本契约校验(test:version-consistency)、Rust Clippy/Test、前端类型检查、全量测试套件、性能基准门禁及 macOS / Linux / Windows 三端构建验证。
  • 多端发布与包分发:推送 v* 标签(如 v3.0.0)或手动触发时:
    1. .github/workflows/release.yml 构建 macOS Universal(Apple Silicon + Intel)、Windows x64、Linux x64 安装包与签名更新清单 latest.json,自动发布至 GitHub Releases。
    2. .github/workflows/packages.yml 打包并发布 4 个 npm 兼容包至 GitHub Packages(@thelastsheep/atools-ztools-renderer、@thelastsheep/atools-ztools-settings、@thelastsheep/atools-ztools-updater、@thelastsheep/atools-host-api-shim)。

九、开源协议与致谢

  • 本项目基于 MIT License 开源协议发布。
  • 项目中包含的第三方开源组件声明与上游兼容包许可证详见 THIRD_PARTY_NOTICES.md。
  • 感谢 Tauri、ZTools 及其插件社区贡献者为桌面效率工具生态奠定的坚实基础。

About

面向用户与 Agent 的高性能、轻量、本地优先的桌面工具运行时与结果工作台。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages