给 QwenPaw 写了四个插件:备份、陪伴、创作和一本开发手册

番星

QwenPaw 用了大半年,从最早的文档翻译,到后来自己写插件,慢慢发现这个东西真正有意思的地方在插件层——它把「AI 能做什么」拆成了一个个可以安装的模块。

这两个月陆续写了四个仓库,定位各不相同,这篇一起说说。

备份核心:先给数据留个落脚点

我永远不会忘记你。

qwenpaw-backup-core 解决的是一个很朴素的问题:容器会重置、磁盘会坏,但积累下来的配置和记录不该丢。

它的流程是 Agent 三段式:

1
2
3
collect(采集 + 脱敏 + 可读版)
→ get_draft → Agent 转换成可读格式
→ submit_markdown → push(双远端)

设计上做了两级备份:

级别频率动作依赖
第一级:本地仓库每 1-2 小时采集、脱敏、本地 git commit无网络、无凭据
第二级:远端镜像每晚一次本地仓库 push 到 GitHub + GiteeSSH 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 的宿主源码做了几处事实修正:

  1. 插件类型 9 种 → 10 种(补了 hub,见 PluginType 枚举)
  2. Memory 后端示例改成真实契约(抽象方法是 start / memory_search / auto_memory,旧例里的 store / search 根本不存在)
  3. 日志路径是 <WORKING_DIR>/qwenpaw.log,没有 logs/ 子目录
  4. 入口导出补了 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 进行许可。