@duanz/pi-d-restart

D-restart: safe restart for pi-web: snapshot every busy session, restart the service, then wake each session back up so no work is lost.

Package details

extension

Install @duanz/pi-d-restart from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@duanz/pi-d-restart

Pi manifest JSON

{
  "extensions": [
    "./extensions/d-restart.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

给 pi-web 用的安全重启插件：重启服务前先记下谁在干活，重启完再把它们叫醒接着干。

直接 systemctl restart pi-web 会掐断所有正在跑的会话——对话断在半路，工具调用悬空，回来还得自己解释「刚才做到哪了」。d-restart 把这件事变成一次无损交接。

守护进程用 systemd-run --user 派发到独立 unit，否则重启 pi-web 会把它自己一起掐死。

pi install git:github.com/DuanZGit/D-Hub

D-Hub 是一个包，装它会把里面的 10 个扩展一起装上；只想要 d-restart 的话，把 plugins/d-restart/ 单独拷进 ~/.pi/agent/extensions/ 也能用。

装完 /reload 或重启一次 pi-web 生效。

三种触发方式，效果一样：

方式	用法
斜杠命令	`/d-restart`（简写 `/restart`，旧名 `/safe-restart` 仍可用）
Agent 工具	模型自己调 `d_restart`（改完插件让它重启时）
命令行	`d-restart`（已装好的 wrapper），或 `node <包目录>/plugins/d-restart/scripts/d-restart.mjs`

插件还会拦一道：任何 bash 里出现 systemctl restart pi-web 的调用，都会被自动改写成安全接力，并弹一条提示。

命令行参数：

d-restart.mjs --delay 3 --caller <sessionId>
d-restart.mjs --dry-run        # 只看当前有几个忙碌会话，不重启

变量	默认	说明
`PI_WEB_PORT`	自动探测	探测 `~/.pi/agent/pi-web-run/*.json`，失败退回 `30142`
`PI_WEB_SERVICE`	`pi-web.service`	systemd user unit 名
`PI_WEB_RESTART_CMD`	空	自定义重启命令，设置后优先于 systemctl（docker / pm2 用户用这个）
`PI_SAFE_RESTART_STATE`	`~/.pi/agent/state/piweb-restarting-sessions.json`	快照文件
`PI_SAFE_RESTART_LOG`	`/tmp/piweb-safe-restart.log`	日志

非 systemd 环境示例：

export PI_WEB_RESTART_CMD="docker restart pi-web"
export PI_WEB_PORT=30142

Linux + systemd user 是默认路径。macOS 没有 systemd，靠 PI_WEB_RESTART_CMD 兜底，但守护进程只能用普通 detached 进程，重启命令若把整个进程树带走就失效了。
依赖 pi-web 的 /api/agent/running 与 /api/agent/:id 接口，纯 CLI 模式（没有 pi-web 服务）用不上。
快照只存会话 ID 和 session 文件路径，不存对话内容——内容本来就在 session 文件里。

tail -f /tmp/piweb-safe-restart.log

日志会记录扫到几个会话、重启是否成功、每个会话恢复下发返回什么。常见失败：

MIT