oh-my-pi marketplace 完整指南:如何快速发布并安装自己的扩展生态

📅 发布时间:2026/8/30 9:50:18
oh-my-pi marketplace 完整指南:如何快速发布并安装自己的扩展生态
oh-my-pi marketplace 完整指南如何快速发布并安装自己的扩展生态【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pioh-my-piomp是一款内置 IDE 深度集成的开源 AI 编码代理coding agent它的marketplace 扩展市场系统只需两条命令就能发现、安装和管理插件也允许任何人发布自己的扩展生态。本文带你从安装第一个插件到发布自己的 marketplace走一遍完整流程 marketplace 是什么先搞懂两个概念在 oh-my-pi 中扩展生态由两个核心概念组成Marketplace扩展市场一个 Git 仓库或本地目录根目录放一份目录清单文件marketplace.json声明里面有哪些插件可用插件Plugin一个目录按约定位置存放技能skills、斜杠命令、子代理、钩子、自定义工具、MCP 服务器等内容。插件安装后分两个作用域生效作用域范围记录位置user默认所有项目可用~/.omp/plugins/installed_plugins.jsonproject仅当前项目项目/.omp/plugins/installed_plugins.json同名插件中已启用的 project 作用域安装会覆盖 user 作用域的版本。更多机制细节可查阅官方文档docs/marketplace.md。⚡ 快速安装两条命令接入扩展市场在 oh-my-pi 的 TUI 中输入以下命令即可无参数运行/marketplace会打开交互式插件浏览器/marketplace add owner/my-marketplace # 添加一个市场源 /marketplace install my-pluginmy-marketplace # 安装其中的插件命令行下也有等价命令omp plugin marketplace add owner/my-marketplace omp plugin install my-pluginmy-marketplace/marketplace add会自动识别多种来源格式owner/repo简写、https://...的 Git 仓库、以.json结尾的直接目录 URL、git...SSH 地址以及./path本地目录——这为本地开发测试提供了极大便利。下面的 TUI 中/marketplace discover可以浏览各市场中的插件列表左侧是插件清单右侧展示每个插件如技能的描述、来源与激活状态 插件怎么组织约定目录就是全部一个插件目录不强制要求任何固定文件所有位置都是可选的插件把内容放进约定目录即可被自动发现my-plugin/ skills/名称/SKILL.md ← 技能 commands/*.md ← 斜杠命令 agents/*.md ← 子代理定义 hooks/pre/、hooks/post/ ← 钩子 tools/ ← 自定义工具 .mcp.json ← MCP 服务器定义 package.json ← 可选版本号与 omp.extensions 扩展模块 README.md ← 建议提供说明文档如果想让插件携带 TypeScript 扩展模块在package.json中声明omp.extensions即可marketplace 安装时会像 npm 安装一样把它链接进运行时。参考仓库内置的最小插件示例docs/skills/examples/mini-marketplace/my-plugin/package.json扩展模块的编写方法见 docs/skills/authoring-extensions.md。 marketplace.json扩展市场的目录清单清单文件放在仓库根目录的.omp-plugin/marketplace.json推荐或.claude-plugin/marketplace.json兼容 Claude Code 格式的回退路径。最简格式只需要三个必填字段{ name: my-marketplace, owner: { name: 你的名字 }, plugins: [ { name: my-plugin, description: 这个插件做什么, source: ./plugins/my-plugin } ] }插件条目的source支持五种格式格式适用场景相对路径./xxx插件就在市场仓库内最常用Git URL指向独立插件仓库可用ref/sha锁定版本GitHub 简写Git URL 的简写形式Git 子目录插件位于 monorepo 的某个子目录npm 包格式可解析但当前安装器尚不支持命名规则市场和插件名只能用小写字母、数字、连字符和点且必须以字母或数字开头结尾最长 64 字符。仓库内的完整示例可看这份可直接运行的迷你市场docs/skills/examples/mini-marketplace/.claude-plugin/marketplace.json其说明文档为 docs/skills/examples/mini-marketplace/README.md。 发布自己的 marketplace五步走完新建仓库在根目录创建marketplace.json清单文件添加插件条目指向仓库内的子目录或外部 Git 来源推送到你的 Git 仓库分享owner/repo字符串用户执行/marketplace add owner/repo即可接入持续更新修改清单后用户运行/marketplace update 市场名拉取最新版本。发布前建议先本地验证marketplace 支持直接添加本地路径作为来源/marketplace add ./path/to/my-marketplace从 0 到 1 的完整编写规范清单字段表、来源类型、发布流程都整理在官方技能文档里docs/skills/authoring-marketplaces.md。 更新、升级与日常管理装好插件后的日常操作TUI 命令与 CLI 一一对应操作TUI 命令刷新市场清单/marketplace update [市场名]升级插件/marketplace upgrade [--scope user\|project] [namemarketplace]查看已装插件/marketplace installed卸载插件/marketplace uninstall [--scope user\|project] namemarketplace启用 / 禁用/plugins enable//plugins disable两个实用细节/marketplace update只刷新清单、不会重装插件upgrade才会真正重装且只有清单中声明了version的条目才参与版本比较安装或卸载工具、钩子、扩展模块后运行/reload-plugins刷新技能与斜杠命令重启会话即可加载新能力。下图展示了插件生效后的实际会话代理正在分派多个 explore 子代理并行分析packages/{ai,tui,agent}底部的状态栏实时显示 token 用量与费用——这正是扩展生态为编码代理带来的能力增益 延伸阅读市场系统机制、磁盘布局与命令参考docs/marketplace.md市场编写指南docs/skills/authoring-marketplaces.md扩展模块编写docs/skills/authoring-extensions.md可运行的迷你市场示例docs/skills/examples/mini-marketplace/扩展市场与技能体系总览docs/skills.md【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考