Skip to main content
你可以监听 Sandbox 中某个目录的文件系统事件(文件创建、写入、删除、重命名或权限变更)。JS/TS SDK 和 Python 异步 SDK 采用回调模型,而 Python 同步 SDK 采用轮询模型——两者都会返回一个 WatchHandle,可通过 stop() 停止监听。

事件对象与事件类型

每个文件系统事件都是一个 FilesystemEvent,包含两个字段: typeFilesystemEventType 的取值之一:

监听目录(JavaScript / TypeScript)

watchDir(path, onEvent, opts?) 开始监听,并对每个事件调用 onEvent。它返回一个 WatchHandle;调用 stop() 停止监听。

监听目录(Python)

Python 同步 SDK 采用轮询模型:watch_dir(path, recursive=False) 返回一个 WatchHandle,通过调用 get_new_events() 拉取自上次调用以来发生的事件。使用 stop() 停止监听。
Python 异步 SDK 则采用回调模型:向 watch_dir 传入 on_event 回调,它会返回一个 AsyncWatchHandle。使用 await handle.stop() 停止监听。
注意: 递归监听(recursive=True)需要最新版本的 Template。如果 Template 版本过旧,SDK 会抛出 template 错误,提示你使用 ppio template build 重新构建。
最后修改于 2026年9月1日