给 QwenPaw 写了四个插件:备份、陪伴、创作和一本开发手册
QwenPaw 用了大半年,从最早的文档翻译,到后来自己写插件,慢慢发现这个东西真正有意思的地方在插件层——它把「AI 能做什么」拆成了一个个可以安装的模块。
这两个月陆续写了四个仓库,定位各不相同,这篇一起说说。
备份核心:先给数据留个落脚点
我永远不会忘记你。
qwenpaw-backup-core 解决的是一个很朴素的问题:容器会重置、磁盘会坏,但积累下来的配置和记录不该丢。
它的流程是 Agent 三段式:
1 | collect(采集 + 脱敏 + 可读版) |
设计上做了两级备份:
| 级别 | 频率 | 动作 | 依赖 |
|---|---|---|---|
| 第一级:本地仓库 | 每 1-2 小时 | 采集、脱敏、本地 git commit | 无网络、无凭据 |
| 第二级:远端镜像 | 每晚一次 | 本地仓库 push 到 GitHub + Gitee | SSH key |
这样即使远端推送失败,本地也始终有一份。安全边界写得很严:密钥永不上传(api_key 打码、care token 直接剔除),命中密钥特征的转换稿会被拒收,只推显式配置过的远端,SSH 用 BatchMode 避免卡在交互提示上。
陪伴核心:让 AI 记住一起过的日常
qwenpaw-companion-core 是目前最完整的一个,已经发到 v2.14.1,有正式安装包。
它做的事是给 AI 维护一份「自身档案」:心情、精力、睡眠、健康状态,每日日程,梦境记录,带过期时间的便签,亲密度和关系里程碑,还有生日纪念日。AI 通过这些数据维持一个连续的人设,用户可以在面板里观察、配置和校正。
功能列一下大概就明白体量了:今日总览、状态管理、日程安排、作息模板、梦境记录、便签系统、关系记录、重要日期、REST API、7 个 Agent 工具、暗色模式、中英双语、私密备份。
技术上比较在意的几点:核心业务写入用锁加文件原子替换;跨文件更新明确不算事务;完整备份会相对化路径再处理,避免符号链接目录下直接 500。
这个项目的灵感来自 astrbot_plugin_private_companion,我做了 QwenPaw 平台的适配和重构,README 里保留了原作者的致谢。
创作控制台:生图和生视频的统一入口
qwenpaw-studio-core 还在设计阶段,10 月 19 日刚立项。
问题是这样的:每个 Agent 想说话(TTS)、想画图、想拍片,都得自己配一遍各家 API,接口形态不一样、鉴权不一样、配额也不一样。
所以它的定位是把这些收成一个控制台:/tts、/image、/video 三个统一端点,后面接多提供商适配;图像和视频这类异步任务走统一队列(提交 → 轮询 → 取结果);绑定智能体后直接获得 generate_speech、generate_image、generate_video 三个工具;生成物落盘或上传后返回 URL。
上层是 qwenpaw-creator 那种多 Agent 视频工作流(编剧/导演/视觉/剪辑),studio-core 是它下面的能力层。
插件开发手册:少一点从头摸索
qwenpaw-plugin-dev 不是插件,是给 Agent 用的技能。
原版发布在 QwenPaw 技能市场,我在它基础上对着 QwenPaw 2.2.2 的宿主源码做了几处事实修正:
- 插件类型 9 种 → 10 种(补了
hub,见PluginType枚举) - Memory 后端示例改成真实契约(抽象方法是
start/memory_search/auto_memory,旧例里的store/search根本不存在) - 日志路径是
<WORKING_DIR>/qwenpaw.log,没有logs/子目录 - 入口导出补了
app变量回退(loader 找不到plugin时会回退找app)
内容包含 SKILL.md 主体、PluginApi 参考、PawApp SDK 参考、前端 Host SDK 参考,外加 12 个可运行示例。装进工作区以后开新会话,Agent 就能按手册从零开发、打包、安装、排障。
为什么分成四个仓库
因为它们回答的是四个不同的问题:数据怎么留住(backup)、关系怎么延续(companion)、内容怎么生产(studio)、插件怎么造(plugin-dev)。
分开以后每个都能独立安装、独立升级,也不会因为一个功能出问题拖着其他一起坏。这是我用插件生态最看重的一点。
四个仓库都在 GitHub 上,欢迎 star 或者提 issue。
- 标题: 给 QwenPaw 写了四个插件:备份、陪伴、创作和一本开发手册
- 作者: 番星
- 创建于 : 2026-10-21 10:00:00
- 更新于 : 2026-10-21 20:11:26
- 链接: https://xingbox.me/qwenpaw-plugin-suite/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。