章节 01
Paprwork V2: 基于TypeScript和Mastra重构的本地优先AI桌面助手(导读)
Paprwork V2是一款本地优先的AI桌面助手应用,通过TypeScript和Mastra框架完全重写,解决了V1版本的技术债务,构建了生产就绪的架构。核心特性包括多模型提供商支持、可扩展工具系统、子代理、定时任务、智能记忆系统等,兼顾隐私与功能扩展性,适合需要本地处理数据的AI交互场景。
正文
Paprwork 是一个本地优先的 AI 桌面助手应用,V2 版本使用 TypeScript 和 Mastra 框架完全重写,支持多模型提供商、工具系统、子代理、定时任务和智能记忆系统。
章节 01
Paprwork V2是一款本地优先的AI桌面助手应用,通过TypeScript和Mastra框架完全重写,解决了V1版本的技术债务,构建了生产就绪的架构。核心特性包括多模型提供商支持、可扩展工具系统、子代理、定时任务、智能记忆系统等,兼顾隐私与功能扩展性,适合需要本地处理数据的AI交互场景。
章节 02
V1版本存在严重技术债务:超过3万行的单体文件、90%代码进程间重复、工具调用需多个补丁、缺乏类型安全。这些问题阻碍了长期维护,因此V2进行彻底重写,目标是构建可维护、可扩展的代码库。
章节 03
V2采用模块化分层架构,核心目录core/作为共享库消除代码重复,所有组件100% TypeScript且无any类型。引入Mastra框架作为AI编排层,解决工具调用脆弱问题,提供统一Agent抽象、健壮工具调用和流式处理能力。架构灵感来自OpenClaw,但针对桌面环境调整(如Electron+React UI)。
章节 04
V2核心功能包括:多模型支持(Claude/GPT/Gemini)、流式响应、可扩展工具(Bash/文件操作等)、并行会话、定时任务自动化、智能记忆、Mini-Apps、子代理、安全密钥管理。隐私方面:遥测为匿名粗略事件(可关闭),用户可自定义遥测端点,API密钥加密存储。
章节 05
V2使用Rust工具提升开发效率:oxlint替代ESLint(快50-100倍)、oxfmt替代Prettier(快30倍)。开发支持热重载,测试体系全面:单元/集成/E2E测试、类型检查、格式化检查、代码行数限制,可通过npm run check一键运行。
章节 06
应用场景包括个人知识管理、自动化工作流、多模型对比、隐私优先AI交互。快速开始需Node.js v24+和npm v10+:克隆仓库→安装依赖→配置.env.local→启动应用(npm start)。
章节 07
Paprwork V2实现了从原型到产品的转变,解决V1技术债务,引入现代技术栈(TypeScript/Mastra/Rust工具)和严格规范,构建可维护扩展的架构。对本地优先AI助手用户和重构开发者均有参考价值。