Pi 扩展兼容

Keenkind 可以兼容一部分 Pi 扩展生态，便于迁移现有工具和 Skill。兼容层的目标是复用工具能力，不是复制 Pi 的完整界面和会话系统。

支持范围

标准 SKILL.md；
TypeScript/JavaScript 工具注册；
JSON Schema 或 TypeBox 风格的工具参数；
工具执行、进度和取消；
常用的启动、关闭和工具生命周期事件；
非交互式子进程调用。

不支持

Pi 的终端界面和自定义渲染；
快捷键、主题和交互命令；
自定义模型 Provider 和模型切换；
接管 Keenkind 对话、权限或设置；
依赖终端持续交互的扩展。

不支持的能力会显示为兼容诊断，不会被模拟成已经成功。

迁移步骤

在 设置 > 扩展 > 插件 导入或启用 Pi 扩展。
查看详情页中的兼容诊断。
确认注册的工具名称、说明和参数。
在 请求审批 模式测试只读调用。
验证结果、错误、取消和重启。
对依赖 Pi UI 的部分改写为 Keenkind Skill 或原生插件。

兼容建议

把核心能力放在普通工具函数中，不依赖终端 UI；
使用可序列化的参数和结果；
不依赖全局可变状态；
明确处理取消与异常；
避免在模块加载时修改用户环境；
新项目优先使用 Keenkind 原生插件规范。

Pi 扩展会执行第三方代码。迁移前请检查来源、依赖和权限，并在隔离的测试项目中验证。