ETHAN WILKINS 桌面应用 · 技术架构

APPLICATION BLUEPRINT 01 / 01

Ethan Wilkins 技术栈

从界面交互到系统能力，再到模型调用、数据工具与交付链路，梳理桌面应用的模块边界、横切约束和端到端路径。

悬停或聚焦条目查看说明 · 依赖版本每日检查

Tauri 2.12.5 Stable
Rust MCP Vue Go Python Security Delivery
DESKTOP APP SHELL Tauri 2.12.5 Stable

跨层调用路径 · CALL PATHS

UI 界面调用
Vue 界面 Tauri IPC Command Handler Domain / Service System APIs
AI 模型调用
MCP Client stdio / HTTP MCP Adapter Tool Registry IPC Bridge Domain / Service
01

NATIVE CORE

Rust 1.99.1 stable

承载业务规则与系统访问，并通过 IPC 为界面和 Sidecar 提供本机服务。

Domain / Service Layer

核心业务逻辑

System APIs

  • Filesystem
  • Database
  • Crypto
  • OS APIs

Data & Persistence

  • SQL Engine
  • Migrations
  • File Store
  • Cache

引擎与迁移工具按数据模型选型后再跟踪版本

Async / Background Work

  • Tokio 1.54.1

Task & Event Bus

  • Job Queue
  • Scheduler
  • Progress Events
  • Cancellation

Infrastructure

  • serde 1.0.229
  • tracing 0.1.44
  • thiserror 2.0.21
  • anyhow 1.0.104

Observability & Diagnostics

  • Structured Logs
  • Metrics
  • Crash Report
  • Trace Context

Security & Secrets

  • Capability ACL
  • OS Keychain
  • Input Validation
  • Signature Check

Testing & Contract

  • Unit / Integration
  • IPC Contract Tests
  • MCP Contract Tests
  • Fixtures

IPC Bridge

命令注册、事件推送与 sidecar 通道

02

INDEPENDENT SIDECAR

TypeScript MCP Adapter

把本地能力封装成模型可调用的接口，也可连接外部 MCP 服务。

Official MCP TypeScript SDK

v2.x
SERVER

@modelcontextprotocol/server

2.4.0

MCP Server

  • Tools
  • Resources
  • Prompts
CLIENT

@modelcontextprotocol/client

2.4.0

MCP Client

  • Connect External MCP Servers
  • Call Tools
  • Read Resources

Schema

  • Zod 4.6.7
  • Standard Schema 1.1.0

Protocol & Transport

MCP PROTOCOL
JSON-RPC 2.0 2026-07-28

当前规范修订版；初始化时协商实际修订版与客户端 / 服务端能力

阅读 MCP 协议规范 ↗

传输方式

  • stdio 本机进程
  • Streamable HTTP 网络连接

旧 HTTP + SSE：仅用于兼容迁移；新连接优先使用 Streamable HTTP。

连接生命周期

  1. initialize
  2. 能力协商
  3. tools/list
  4. tools/call
  5. progress / cancel
  6. 关闭

Tool Registry

  • Tool Contract
  • Argument Schema
  • Result Encoding
  • Call Audit

Resources & Prompts

  • Resource Templates
  • Subscriptions
  • Prompt Templates
  • Completions

Auth & Policy

  • Token Check
  • Scopes
  • Rate Limits
  • Audit Log

IPC Client

调用 Rust 核心业务服务，并映射错误与超时

03

USER INTERFACE

Vue 3.5.45 stable

负责窗口内的页面、状态和交互，通过 Tauri IPC 调用 Rust 能力。

Core Tooling

  • TypeScript7.0.2
  • Vite8.3.8
  • Pinia4.1.0

Platform Bridge

  • Tauri JS API
  • Event Subscription
  • Window & Tray
  • File Dialog

Data Access

  • IPC Wrapper
  • Request Cache
  • Optimistic Update
  • Offline / Error State

UI System

  • Component Library
  • Design Tokens
  • Icons
  • Charts & Tables

组件库按需求单独选型

UX & A11y

  • Keyboard Path
  • Focus Management
  • Reduced Motion
  • i18n

Feature Modules

  • Pages & Routes
  • Feature Folders
  • Permission Views
  • Shortcuts

Feedback & States

  • Loading / Skeleton
  • Empty State
  • Toast / Dialog
  • Progress

Optional

  • Vue Router5.5.0
  • Tailwind CSS4.3.5

需要时按项目需求引入

04

LOCAL SIDECAR

Go 1.27.4 stable

编译为单文件二进制，承载本地 sidecar、CLI 工具与并发任务，降低分发与运行环境成本。

Sidecar Service

  • JSON-RPC
  • Local HTTP
  • Health Check
  • Graceful Shutdown

Concurrency & Scheduling

  • Goroutine
  • Channel
  • Context
  • Worker Pool

Standard Library

  • net/http
  • encoding/json
  • os/exec
  • log/slog

CLI & Tooling

  • cobra 1.10.2
  • Subcommands
  • Flag Parsing
  • Config Loading

Build & Release

  • Cross Compile
  • Static Binary
  • CGO Disabled
  • Version Stamp

Observability & Testing

  • pprof
  • Metrics
  • go test
  • Fuzz Test
05

AI & DATA TOOLING

Python 3.15.2 stable

承载模型评测、数据处理与自动化脚本，通过 MCP 和本地 IPC 与核心服务交换结果。

AI & Data Pipeline

  • Dataset Prep
  • Batch Eval
  • Embedding Jobs
  • Result Export

MCP Python SDK

  • mcp 2.3.0
  • Tools & Resources
  • Async Client

Data Models

  • pydantic 2.14.3
  • Schema Validation
  • Settings
  • JSON Serialization

Packaging & Environment

  • uv 0.13.7
  • pyproject.toml
  • Lockfile
  • Virtualenv

Quality

  • ruff 0.17.4
  • pytest
  • Type Hints
  • Coverage

Scripts & Automation

  • CLI Entrypoints
  • Scheduled Jobs
  • Report Export
  • Structured Logging

CROSS-CUTTING · 横切关注点

贯穿五条分支的工程约束

这些能力不单独占据一层，却在每次 IPC、MCP 和界面调用中持续生效。

SEC

安全边界

能力白名单、密钥托管、输入校验与签名验证。

OBS

可观测性

结构化日志、耗时指标与跨进程调用链。

CFG

配置与开关

环境分层、运行时配置与灰度特性开关。

RES

错误与恢复

统一错误类型、超时重试、降级与可读提示。

PERF

性能与资源

启动耗时、内存占用、序列化开销与任务调度。

A11Y

可访问性

键盘路径、焦点管理、减少动效与国际化。

DELIVERY PIPELINE · 交付链路

从本地开发到运行观测

架构不只描述运行时，也描述代码如何被验证、打包、签名和持续观察。

  1. 01

    本地开发

    Vite 热更新、Tauri dev 与本地 IPC 联调。

  2. 02

    质量门禁

    类型检查、格式、静态分析与测试，工具链按项目选型。

  3. 03

    构建产物

    Rust release 编译、前端生产构建与体积检查。

  4. 04

    打包签名

    平台安装包、代码签名与公证，按目标平台配置。

  5. 05

    更新分发

    更新清单、发布渠道、签名校验与回滚策略。

  6. 06

    运行观测

    崩溃上报、结构化日志、版本分布与灰度回滚。