CLI开发工具AI 应用【免费下载链接】ocxOpenCode extension manager with portable, isolated profiles. Your setup, anywhere.项目地址https://gitcode.com/gh_mirrors/ocx/ocx点击查看免费下载OCX 是 OpenCode 的扩展管理器通过注册表Registry分发 skill、agent、plugin 等 AI 组件。本教程带你从一份registry.jsonc清单出发搭建属于自己的 OCX 扩展注册表并免费部署到 Cloudflare Workers——让任何人都能用一条ocx add命令安装你的组件。▲ OCX 快速上手从注册表安装组件、启动 OpenCode 的完整体验为什么自己搭一个OCX注册表场景收益 团队内部分发把团队沉淀的 skill、agent、command 打包给同事一键安装 个人组件库发布品牌化 AI 扩展沉淀自己的最佳实践 零成本注册表本质是静态 JSON 文件Cloudflare Workers 免费额度即可托管 安全可控组件经 SHA-256 校验后拷贝到项目的.opencode/目录代码完全归你所有可自由定制官方将这种模式概括为Cargo ShadCN 模型注册表负责身份与分发组件以干净的文件名拷入项目而不是藏在node_modules里。完整背景见 docs/registries/create.mdx。准备工作3 分钟完成环境配置开始前只需准备好 3 样东西工具用途安装方式OCX CLI脚手架 构建 安装组件npm install -g ocxBun运行构建脚本的运行时官方安装脚本OCX 的 npm 包依赖 BunCloudflare 账号免费托管静态资源浏览器注册即可提示OCX 支持 macOS、Linux 和 Windows跨平台体验一致。注册表的目录结构一览一个最小可用的注册表项目长这样my-registry/ ├── registry.jsonc # 注册表清单核心文件 ├── files/ # 组件源文件 │ ├── agents/ # AI 角色定义 │ ├── skills/ # 技能模块 │ ├── plugins/ # TypeScript 插件 │ └── commands/ # 自定义命令 ├── dist/ # 构建产物ocx build 自动生成 └── wrangler.jsonc # Cloudflare Workers 配置有两种最快的创建方式方式一OCX 脚手架推荐ocx init --registry ./my-registry --namespace my-org --author 你的名字方式二使用仓库内置的 Starter 模板git clone https://gitcode.com/gh_mirrors/ocx/ocx # 将 ocx/examples/registry-starter/ 复制到你的工作目录即可Starter 模板已经预置了构建脚本和多平台部署配置结构可参考 examples/registry-starter/。读懂核心文件 registry.jsoncregistry.jsonc是整个注册表的户口档案。下面是最小可用示例{ $schema: https://ocx.kdco.dev/schemas/v2/registry.json, name: My Registry, version: 0.0.1, author: 你的名字, components: [ { name: hello-world, type: skill, description: An example skill to get you started, files: [skills/hello-world/SKILL.md] } ] }关键字段速查$schema声明 v2 规范开启 IDE 自动补全与校验完整定义见 docs/schemas/registry.schema.jsoncomponents[]组件列表每项必须包含name、type、description、filesfiles支持字符串简写目标路径自动推断或对象形式pathtargetStarter 模板中的完整清单可参考 examples/registry-starter/registry.jsonc。7 种组件类型类型用途文件格式skillAI 行为指令知识模块MarkdownagentAI 角色定义Markdownplugin扩展 OpenCode 功能TypeScriptcommand自定义 TUI 命令Markdowntool自定义工具实现TypeScriptbundle多个组件的集合包JSONprofile可分享的完整配置JSON添加你的第一个组件以最简单的skill为例只需两步第 1 步创建files/skills/my-skill/SKILL.md写清楚何时使用和具体指令。仓库里有一个可直接参考的示例 examples/registry-starter/files/skills/hello-world/SKILL.md。第 2 步在registry.jsonc的components数组中注册它{ name: my-skill, type: skill, description: 我的第一个技能, files: [skills/my-skill/SKILL.md] }⚠️ 命名规则组件名只能用小写字母、数字和连字符如code-review最长 64 个字符。构建与本地验证ocx build 生成 dist 目录构建命令就一行bun run build # 等价于 bunx ocx build . --out distexamples/registry-starter/package.json 中已预置好该脚本。构建过程会自动完成 4 件事校验registry.jsonc是否符合 schema生成dist/index.json注册表索引和每个组件的packument元数据把组件文件拷贝到dist/components/生成可选的发现端点dist/.well-known/ocx.json构建完成后可以先在本地起服务预览bun run dev # 启动 http://localhost:8787此时你的本地服务需要暴露 3 个标准端点详见 docs/registries/protocol.mdx端点作用/index.json注册表索引OCX 安装时首先请求它/components/{name}.json单个组件的完整元数据/components/{name}/{path}组件文件原文免费部署到 Cloudflare Workers关键配置只有两行。wrangler.jsonc告诉 Cloudflare把dist/目录作为静态资源发布{ name: my-registry, compatibility_date: 2025-01-01, assets: { directory: ./dist } }参考 examples/registry-starter/wrangler.jsonc。然后执行bun run deploy # 等价于 ocx build wrangler deploy部署成功后你会得到一个形如https://my-registry.你的子域名.workers.dev的 URL。Cloudflare Workers 免费层每月提供大量请求额度个人注册表绰绰有余——全程零费用。验证上线一条命令安装你的组件把 URL 发给朋友对方只需# 方式一临时访问不写入配置 ocx add hello-world --from https://my-registry.xxx.workers.dev # 方式二永久注册注册表推荐起个别名即可 ocx registry add https://my-registry.xxx.workers.dev --name myreg ocx add myreg/hello-world命令细节可查 docs/cli/registry.mdx 和 docs/cli/add.mdx。▲ 注册表配置完成后ocx add 别名/组件名即可一键安装进阶通过注册表分享 profile 配置profile类型的组件最强大它把ocx.jsonc、opencode.jsonc和指令文件打包成一个可分享的配置方案安装到~/.config/opencode/profiles/name/。接收方只需ocx profile add my-profile --source myreg/my-profile --global▲ OCX 支持多 profile 隔离配置你的注册表可以分发整套 profile其他免费托管方案Cloudflare Workers 并非唯一选择Starter 模板已内置多平台配置平台配置方式Vercel预置 examples/registry-starter/vercel.json连接仓库自动构建Netlify预置 examples/registry-starter/netlify.tomlGitHub Pages构建后直接发布dist/目录任意 HTTP 服务器把dist/当作纯静态目录部署常见问题速查Q1构建报错怎么办依次检查registry.jsonc是否为合法 JSONC、files数组中的文件是否真实存在。可用--verbose参数查看详细信息。Q2部署后组件找不到确认dist/index.json中包含了该组件排除 CDN 缓存影响后重新构建部署。Q3ocx registry add提示 URL 冲突同一 URL 不能注册多个别名先用ocx registry remove name移除旧的再重新添加。Q4安装时提示 File conflict新组件与已装组件写入了同一文件。先移除旧文件或重命名再重试安装。总结搭建自己的 OCX 扩展注册表只需四步写registry.jsonc→ 放组件文件 →bun run build构建 →bun run deploy部署。整套流程完全免费且产物是标准静态文件随时可以迁移到任何托管平台。 延伸阅读注册表完整指南docs/registries/create.mdx注册表协议规范docs/registries/protocol.mdxStarter 模板examples/registry-starter/注册表清单 schemadocs/schemas/registry.schema.json赞分享CLI开发工具AI 应用【免费下载链接】ocxOpenCode extension manager with portable, isolated profiles. Your setup, anywhere.项目地址https://gitcode.com/gh_mirrors/ocx/ocx点击查看免费下载相关推荐GKD_THS_List部署与扩展如何搭建自己的订阅收录平台GKD_THS_List部署与扩展如何搭建自己的订阅收录平台 想要搭建属于自己的GKD第三方订阅收录平台吗GKD_THS_List项目提供了完整的解决方案知识库如何将 Vite 项目部署到 Cloudflare Workers如何将 Vite 项目部署到 Cloudflare Workers 如果你已经有一个 Vite 项目并希望在 Cloudflare Workers 上运行它前端前端构建开发工具如何从零搭建自己的SUSI SkypebotBot Framework注册到上线的完整分步指南如何从零搭建自己的SUSI SkypebotBot Framework注册到上线的完整分步指南 本教程面向新手带你使用开源项目 susi_skypebot上一篇高德地图-Qt地图插件安装和配置指南下一篇揭秘Penumbra配色算法如何用Oklab色彩空间打造视觉平衡的代码主题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考