Zing 论坛

正文

Paprwork V2:基于 TypeScript 和 Mastra 重构的本地优先 AI 桌面助手

Paprwork 是一个本地优先的 AI 桌面助手应用,V2 版本使用 TypeScript 和 Mastra 框架完全重写,支持多模型提供商、工具系统、子代理、定时任务和智能记忆系统。

AI assistantdesktop appTypeScriptElectronMastralocal-firstmulti-providersub-agentsautomation
发布时间 2026/04/06 05:14最近活动 2026/04/06 05:21预计阅读 2 分钟
Paprwork V2:基于 TypeScript 和 Mastra 重构的本地优先 AI 桌面助手
1

章节 01

Paprwork V2: 基于TypeScript和Mastra重构的本地优先AI桌面助手(导读)

Paprwork V2是一款本地优先的AI桌面助手应用,通过TypeScript和Mastra框架完全重写,解决了V1版本的技术债务,构建了生产就绪的架构。核心特性包括多模型提供商支持、可扩展工具系统、子代理、定时任务、智能记忆系统等,兼顾隐私与功能扩展性,适合需要本地处理数据的AI交互场景。

2

章节 02

背景:V1的技术债务与V2重构的必要性

V1版本存在严重技术债务:超过3万行的单体文件、90%代码进程间重复、工具调用需多个补丁、缺乏类型安全。这些问题阻碍了长期维护,因此V2进行彻底重写,目标是构建可维护、可扩展的代码库。

3

章节 03

技术架构:模块化设计与Mastra框架的引入

V2采用模块化分层架构,核心目录core/作为共享库消除代码重复,所有组件100% TypeScript且无any类型。引入Mastra框架作为AI编排层,解决工具调用脆弱问题,提供统一Agent抽象、健壮工具调用和流式处理能力。架构灵感来自OpenClaw,但针对桌面环境调整(如Electron+React UI)。

4

章节 04

核心功能与隐私保障

V2核心功能包括:多模型支持(Claude/GPT/Gemini)、流式响应、可扩展工具(Bash/文件操作等)、并行会话、定时任务自动化、智能记忆、Mini-Apps、子代理、安全密钥管理。隐私方面:遥测为匿名粗略事件(可关闭),用户可自定义遥测端点,API密钥加密存储。

5

章节 05

开发体验优化与测试体系

V2使用Rust工具提升开发效率:oxlint替代ESLint(快50-100倍)、oxfmt替代Prettier(快30倍)。开发支持热重载,测试体系全面:单元/集成/E2E测试、类型检查、格式化检查、代码行数限制,可通过npm run check一键运行。

6

章节 06

应用场景与快速开始指南

应用场景包括个人知识管理、自动化工作流、多模型对比、隐私优先AI交互。快速开始需Node.js v24+和npm v10+:克隆仓库→安装依赖→配置.env.local→启动应用(npm start)。

7

章节 07

总结:从原型到产品的成熟转变

Paprwork V2实现了从原型到产品的转变,解决V1技术债务,引入现代技术栈(TypeScript/Mastra/Rust工具)和严格规范,构建可维护扩展的架构。对本地优先AI助手用户和重构开发者均有参考价值。