agentscope-ai / agentscope-ai/QwenPaw

[Feature]: 增加“暂停快照”辅助机制、鼓励测试远程ZFS挂载、期待Docker备份密钥修复 | Add "pause for snapshot" mechanism, encourage testing remote ZFS mounts, and look forward to Docker backup key fix

Offen
#3,921 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement
Vorherrschende Sprache
Python
Sterne
34.9k
Forks
3.1k
Ø Merge
1 T. 15 Std.
Gemergte PRs (30 T.)
225

Beschreibung

## Summary

希望在 QwenPaw 中增加一个可选的“暂停”能力,方便在 ZFS / NAS 上做一致性快照。
同时鼓励有条件的社区用户尝试将工作目录放在远程 ZFS 存储上,并期待 Docker 备份恢复时的密钥损坏问题早日修复。

We’d like to see an optional “pause” capability in QwenPaw to enable consistent ZFS/NAS snapshots.
We also encourage community members to test remote ZFS mounts for work/config directories and look forward to the fix for API key corruption when restoring Docker backups.

## Component(s) Affected

- [O ] Core / Backend (app, agents, config, providers, utils, local_models)
- [ ] Console (frontend web UI)
- [ ] Channels (DingTalk, Feishu, QQ, Discord, iMessage, etc.)
- [ ] Skills
- [ ] CLI
- [ ] Documentation (website)
- [ ] Tests
- [ ] CI/CD
- [ ] Scripts / Deploy

Problem / Motivation | 问题 / 动机
1. 我希望在部署 HiClaw + QwenPaw 时,能够采用存算分离架构,把工作目录和配置目录直接通过 NFS 或 NVMe‑oF 挂载到已有的 ZFS SAN/NAS(如 TrueNAS)上。
我认为这种方案很适合已经拥有 NAS 或 SAN 的团队,但目前官方还没有专门测试过这种用法。我不是想给项目组压力,只是鼓励有条件的朋友尝试一下,然后把经验反馈给社区。

I hope to deploy HiClaw + QwenPaw in a disaggregated compute/storage architecture, mounting the work and config directories directly over NFS or NVMe‑oF to an existing ZFS SAN/NAS (e.g., TrueNAS).
I believe this approach fits well for teams that already have NAS or SAN infrastructure, but there hasn’t been official testing yet. I’m not trying to push the team—just encouraging community members with the right setup to give it a try and share their experience.

2. Docker 备份密钥损坏 – 期待修复 (Docker backup key corruption – looking forward to the fix)
开发者日会上提到恢复完整 Docker 备份后可能丢失或损坏 API 密钥。团队已知晓并计划修复,这里只是想表达一下期待,让这个常见操作更可靠。
It was mentioned on Developer Day that restoring a full Docker backup could corrupt API keys. The team is aware and already working on it – just leaving a note of encouragement to make this common workflow more robust.

3. 缺乏“快照友好”的暂停能力 (Missing snapshot‑friendly pause)
ZFS 能瞬时快照,但如果 QwenPaw 正在写文件,快照只是崩溃一致的。目前要做到干净快照只能完全停服。如果有一个简单的 pause/resume 命令,管理员就能在不停服的情况下安全地进行 ZFS 快照备份。
ZFS snapshots are instant, but if QwenPaw is writing at that moment the snapshot is only crash‑consistent. The only current way to get a clean snapshot is a full service stop. A lightweight pause/resume would let admins safely take storage‑level snapshots without downtime.

Proposed Solution | 建议方案
(一)增加可选的“暂停快照”机制 (Optional “pause for snapshot”)

提供 CLI 命令或 API,例如 qwenpaw agent pause 和 qwenpaw agent resume。
执行 pause 时,临时暂停 Agent 任务执行并刷新待写数据,使数据目录进入静默状态。
该命令只负责提供一个安全窗口,不直接操作 ZFS,快照仍由存储管理员在 SAN/NAS 侧完成。

支持 cron 风格的定时配置,这样团队可以周期性地自动执行“暂停 → 外部快照 → 恢复”的流程。

Provide a CLI command or API, e.g., qwenpaw agent pause / qwenpaw agent resume.
Pause temporarily stops agent task execution and flushes pending writes, putting the data directories in a quiet state.
This command does not manage ZFS itself; it only creates a safe window for the storage admin to take a filesystem‑level snapshot.

Support a cron‑style schedule to automate periodic “pause → external snapshot → resume” cycles.

(二)鼓励尝试远程 ZFS 挂载 (Encourage trial of remote ZFS mounts)

目前这项用法还没有经过官方测试,文档里也没有相关说明。希望可以在文档或讨论区邀请有 ZFS/NAS 环境的用户尝试一下 NFSv4 / NVMe‑oF 远程挂载,并反馈结果。

如果后续测试顺利,再考虑是否加入简单的部署范例(Kubernetes PersistentVolume 或 Docker Compose 卷配置)。

As of now, this usage hasn’t been tested officially and there’s no mention in the docs. It would be great to invite users with ZFS/NAS setups to experiment with NFSv4/NVMe‑oF mounts and share their findings.

If the trials go well, we can consider adding simple deployment examples later (Kubernetes PersistentVolume with NFS/NVMe‑oF or Docker Compose volume configs).

(三)备份与回滚操作手册 (Backup & rollback runbook)

文档化一个推荐流程:pause → ZFS snapshot → resume,以及如何用 ZFS clone/rollback 恢复并重启 QwenPaw。

Document the recommended flow: pause → ZFS snapshot → resume, and how to restore or restart via ZFS clone/rollback.

Additional Context | 附加上下文
HiClaw+QwenPaw 搭配 TrueNAS 或类似 ZFS 设备,文件系统级快照是比较好的运维习惯,本项目只需要提供一个小小的“暂停”窗口就能完美配合。

理想工作流:qwenpaw agent pause → zfs snapshot tank/qwenpaw@backup → qwenpaw agent resume

Docker 备份密钥的问题期待修复后,这套快照方案可以与 Docker 备份互补,一起增强数据安全性。

## Willing to Contribute

- [ ] I am willing to open a PR for this feature (after discussion).

Beitragsleitfaden

Beitragsleitfaden öffnen

Bewertung

Dieses Issue wurde noch nicht bewertet.

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.