@zhushanwen/pi-unified-hooks

Unified hooks extension - collect scattered hooks in one place for easy maintenance

Packages

Package details

extension

Install @zhushanwen/pi-unified-hooks from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@zhushanwen/pi-unified-hooks
Package
@zhushanwen/pi-unified-hooks
Version
0.0.2
Published
Jun 2, 2026
Downloads
not available
Author
zhushanwen321
License
MIT
Types
extension
Size
3.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

unified-hooks

统一 hooks 管理器 — 将散落的 hooks 收集到一个扩展中统一维护,每个 hook 可独立启用/禁用。

功能

内置 Hooks

Hook 说明
edit-whitespace-autofix edit 工具因空白字符不匹配失败时,自动注入 steering 让 AI 修复空白并重试
tool-error-handler 记录所有工具执行错误到控制台,方便调试

扩展方式

src/hooks/ 下新建 hook 模块,然后在 src/index.tshookModules 数组中注册即可。

安装

# symlink 方式(开发推荐)
ln -s /path/to/xyz-pi-extensions-workspace/main/packages/unified-hooks \
      ~/.pi/agent/extensions/unified-hooks

# npm 方式(正式)
pi install npm:@zhushanwen/pi-unified-hooks

使用

安装后自动生效。edit 空白修复无需配置,工具错误日志自动输出到控制台。

文件结构

unified-hooks/
├── index.ts
└── src/
    ├── index.ts               # 入口 — hook 注册
    └── hooks/
        └── tool-error-handler.ts  # 工具错误处理