paseo-plugin 是一个用于构建和管理本地 Paseo 插件的技能。当用户要求创建、编辑、安装、重载、启用、禁用、移除或排查 Paseo 插件时使用。
用途与准备：优先获取 https://paseo.sh/llms.txt 索引及当前插件 Markdown 页面，以获取最新契约；网络不可用时仍可依据本技能工作。文档不一致时以已部署文档为准。在 Paseo 仓库中可参考 public-docs/plugins/reference.md 与 docs/plugins.md。
创建项目：使用绝对路径执行 paseo plugin init /absolute/path/to/my-plugin，随后在目录内运行 npm install（init 只写文件不装依赖）。生成结构含 paseo-plugin.json、OVERVIEW.md、package.json、tsconfig.json、index.client.tsx、index.server.ts 以及 client/、server/、shared/ 目录。清单需正确维护 requirements.paseo（npm semver 范围，缺失代表 <0.8.0）。
主要能力：可贡献屏幕与侧边栏项（addScreen、addSidebarHeaderItem/addSidebarFooterItem）、工作区面板（addWorkspacePanel）、命令中心项（addCommandCenterItem）、斜杠命令（addSlashCommand）、输入框胶囊（addComposerPill）、时间线转换器与渲染器、附件来源、主题、插件 RPC（defineRpc + server.handle + useRpc）、生命周期与创建/启动钩子（server.on、server.before）以及通过 usePaseo() 调用常规 Paseo SDK 操作。
使用方式：客户端入口 index.client.tsx 与 server 入口 index.server.ts 各自默认导出一个贡献函数并返回清理函数；至少需要其中一个入口。客户端只能用 React Native 原语（View、Text、Pressable、ScrollView、TextInput），颜色取自 theme.colors，布局参考 layout.compact，图标用 Lucide 名称。共享模块放 Zod 契约与普通值。
限制与排查：客户端与服务端互相导入、客户端可达的 node: 导入、插件根目录中相对导入其他代码文件均为编译错误。使用 paseo plugin logs my-plugin（可加 --json 或 --host <url>）查看日志，Settings → Plugins → Logs 亦可查看。不要记录凭据或密钥。安装、发布、定价及更多 API 细节资料中暂未提供。