iii Worker Registry 使用指南浏览、安装与管理可复用 Worker【免费下载链接】iiiEffortlessly compose, extend, and observe every service in real-time for the first time ever.项目地址: https://gitcode.com/GitHub_Trending/mo/iii本指南聚焦 iii 的 Worker RegistryWorker 注册中心它是 iii 项目中可安装 Worker 的索引你可以像使用 npm 包一样通过iii worker add将 registry 中的 Worker 安装进自己的项目。读完本文你将掌握如何浏览 registry、以三种来源registry 名称、本地路径、OCI 镜像添加 Worker、理解 Worker 的两种产物类型原生二进制与 OCI 镜像以及如何通过iii.lock锁定版本实现可复现安装。什么是 Worker RegistryWorker 是 iii 中的自带运行时的独立服务任何新增功能都以 Worker 的形式引入且无需额外集成即可使用——安装和管理方式类似 npm 包但获得的是完整的、可部署的运行时而非一个库参见 docs/0-16-0/using-iii/workers.mdx。iii Worker Registryworkers.iii.dev是所有可安装 Worker 的索引。registry 中每个 Worker 的页面都会列出它提供的函数functions与触发器类型trigger types它的配置 schema支持的平台platforms附带的Agent skills用于 Agent 化工作的技能包。你可以依据这些信息在 registry 中定位能满足你项目某项能力的 Worker。除了官方 registryWorker 也可以发布在 Docker 与 OCI 兼容的镜像仓库中从那里直接安装。添加一个 Worker三种来源iii worker add接受三种来源且无论哪种来源Worker 都会被写入项目的config.yaml并自动启动iii worker add iii-state # registry 名称 iii worker add ./workers/my-worker # 本地路径 iii worker add ghcr.io/org/worker:tag # Docker 或 OCI 镜像registry 名称如iii-state从 workers.iii.dev 解析并安装本地路径如./workers/my-worker加载本地 Worker 目录Docker / OCI 镜像如ghcr.io/org/worker:tag从任意 OCI 兼容仓库拉取镜像运行。在添加 Worker 之前你需要先完成 iii 的安装并让引擎处于运行状态若只想快速测试可运行iii --use-default-config启动一个临时实例见 docs/0-16-0/using-iii/engine.mdx。版本与锁定registry 中的 Worker 以 semver 语义化版本发布。安装时若不指定版本则默认取最新 release追加version可以固定到某个具体版本iii worker add iii-state1.2.0这个版本锁定会被记录到项目根目录的iii.lock文件中并在之后的每次安装中复现。iii.lock是一个 YAML 文件将每个受管 Worker 固定到具体的版本与来源保证同一套 Worker 在不同机器与平台上以相同方式安装原生二进制 Worker 还能在同一份 lockfile 中按平台macOS、Linux、Windows分别固定各自的构建产物。建议将iii.lock与config.yaml一起提交到版本库以获得可复现安装。与 lockfile 直接相关的命令有iii worker sync # 严格按 iii.lock 安装 Worker iii worker sync --frozen # CI 场景校验 lockfile 而不改动本地文件 iii worker verify # 报告 config.yaml 与 iii.lock 之间的漂移iii worker update是第三个与 lockfile 相关的命令它会按最新允许的版本重新解析已锁定的 Worker并把新的版本写回iii.lock单传 Worker 名则只更新这一个省略则更新全部。添加后的管理完整生命周期iii worker子命令覆盖了项目中每个 Worker 的完整生命周期在 registry 中寻找新的 Worker、将其安装进config.yaml与iii.lock、控制运行状态、查看日志、以及在不再需要时移除详见 docs/0-16-0/using-iii/workers.mdx。iii worker list # 列出 config.yaml 中声明的 Worker 及其状态 iii worker start name # 启动一个 Worker iii worker stop -y name # 停止一个 Worker-y 跳过确认 iii worker restart name # 先停后启 iii worker status name # 查看配置、沙箱状态与最近日志 iii worker logs name # 流式查看 Worker 日志 iii worker exec name -- command # 在 Worker 沙箱内执行命令 iii worker remove -y worker-name # 从 config.yaml 移除并销毁进程-y 跳过确认 iii worker clear -y worker-name # 同时删除下载到本地的构建产物省略名称则清理全部需要强制重新下载某个已存在的 Worker 时可用iii worker reinstall name等价于add --force。生命周期背后的机制从源码看Worker 通过 WebSocket 连接到 iii 引擎连接后该 Worker 对整个 iii 系统及其他 Worker 可见断开后其函数与触发器在重连之前将不可调用docs/0-16-0/using-iii/workers.mdx。函数与触发器正是来自已连接的 Worker——例如通过 iii-http Worker 添加http触发器后你就能像在 Express 或 FastAPI 中那样为函数暴露 HTTP 端点。Worker 的产物类型registry 中的每个 Worker 以两种形态之一发布原生二进制native binary按平台分别发布构建产物macOS、Linux、Windows引擎按当前平台拉取对应 artifactDocker / OCI 兼容镜像一个镜像即可在所有受支持的平台上运行。在引擎源码中可以看到这类按平台分发的痕迹engine/src/cli/registry.rs定义了BinarySpec其中supported_targets列出每个二进制支持的平台三元组如x86_64-unknown-linux-gnu、aarch64-apple-darwin、x86_64-pc-windows-msvc等并支持has_checksum校验与命令映射。也就是说一个发布版本即可覆盖所有受支持的宿主平台无需按平台分别发布。版本化策略发布侧视角registry 中的 Worker 遵循 semverpatch用于 bug 修复minor用于新增能力additive capabilitymajor用于函数或触发器签名的破坏性变更。作为使用者你只需记住默认安装追踪最新 releaseversion固定版本iii worker update升级iii.lock记录解析结果docs/0-16-0/creating-workers/workers-registry.mdx。Worker skillsAgent 化能力每个 Worker 还随附面向 Agent 工作的 skills。Skills 由skillsWorker 管理——这是一个仍在积极开发的内容注册型 Worker和任何其他 Worker 一样通过iii worker add加入项目。Skill 正文按需懒加载顶层条目保持精简Agent 仅在函数引用解析到某个iii://worker/leaf章节 URI 时才拉取更深层内容。结语Worker Registry 是 iii 生态的包管理器入口iii worker add用一条命令即可将 registry 中的 Worker、本地目录或 OCI 镜像接入你的项目自动写入config.yaml并启动semver iii.lock的组合保证了跨机器、跨平台的可复现安装原生二进制与 OCI 镜像两种产物类型则覆盖了从轻量二进制到通用容器镜像的全部部署形态。想了解移除、启动/停止、同步与校验等更完整的iii worker命令集可继续阅读 Workers 页面与安装指南。【免费下载链接】iiiEffortlessly compose, extend, and observe every service in real-time for the first time ever.项目地址: https://gitcode.com/GitHub_Trending/mo/iii创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 iii Worker Registry 使用指南：浏览、安装与管理可复用 Worker
iii Worker Registry 使用指南浏览、安装与管理可复用 Worker【免费下载链接】iiiEffortlessly compose, extend, and observe every service in real-time for the first time ever.项目地址: https://gitcode.com/GitHub_Trending/mo/iii本指南聚焦 iii 的 Worker RegistryWorker 注册中心它是 iii 项目中可安装 Worker 的索引你可以像使用 npm 包一样通过iii worker add将 registry 中的 Worker 安装进自己的项目。读完本文你将掌握如何浏览 registry、以三种来源registry 名称、本地路径、OCI 镜像添加 Worker、理解 Worker 的两种产物类型原生二进制与 OCI 镜像以及如何通过iii.lock锁定版本实现可复现安装。什么是 Worker RegistryWorker 是 iii 中的自带运行时的独立服务任何新增功能都以 Worker 的形式引入且无需额外集成即可使用——安装和管理方式类似 npm 包但获得的是完整的、可部署的运行时而非一个库参见 docs/0-16-0/using-iii/workers.mdx。iii Worker Registryworkers.iii.dev是所有可安装 Worker 的索引。registry 中每个 Worker 的页面都会列出它提供的函数functions与触发器类型trigger types它的配置 schema支持的平台platforms附带的Agent skills用于 Agent 化工作的技能包。你可以依据这些信息在 registry 中定位能满足你项目某项能力的 Worker。除了官方 registryWorker 也可以发布在 Docker 与 OCI 兼容的镜像仓库中从那里直接安装。添加一个 Worker三种来源iii worker add接受三种来源且无论哪种来源Worker 都会被写入项目的config.yaml并自动启动iii worker add iii-state # registry 名称 iii worker add ./workers/my-worker # 本地路径 iii worker add ghcr.io/org/worker:tag # Docker 或 OCI 镜像registry 名称如iii-state从 workers.iii.dev 解析并安装本地路径如./workers/my-worker加载本地 Worker 目录Docker / OCI 镜像如ghcr.io/org/worker:tag从任意 OCI 兼容仓库拉取镜像运行。在添加 Worker 之前你需要先完成 iii 的安装并让引擎处于运行状态若只想快速测试可运行iii --use-default-config启动一个临时实例见 docs/0-16-0/using-iii/engine.mdx。版本与锁定registry 中的 Worker 以 semver 语义化版本发布。安装时若不指定版本则默认取最新 release追加version可以固定到某个具体版本iii worker add iii-state1.2.0这个版本锁定会被记录到项目根目录的iii.lock文件中并在之后的每次安装中复现。iii.lock是一个 YAML 文件将每个受管 Worker 固定到具体的版本与来源保证同一套 Worker 在不同机器与平台上以相同方式安装原生二进制 Worker 还能在同一份 lockfile 中按平台macOS、Linux、Windows分别固定各自的构建产物。建议将iii.lock与config.yaml一起提交到版本库以获得可复现安装。与 lockfile 直接相关的命令有iii worker sync # 严格按 iii.lock 安装 Worker iii worker sync --frozen # CI 场景校验 lockfile 而不改动本地文件 iii worker verify # 报告 config.yaml 与 iii.lock 之间的漂移iii worker update是第三个与 lockfile 相关的命令它会按最新允许的版本重新解析已锁定的 Worker并把新的版本写回iii.lock单传 Worker 名则只更新这一个省略则更新全部。添加后的管理完整生命周期iii worker子命令覆盖了项目中每个 Worker 的完整生命周期在 registry 中寻找新的 Worker、将其安装进config.yaml与iii.lock、控制运行状态、查看日志、以及在不再需要时移除详见 docs/0-16-0/using-iii/workers.mdx。iii worker list # 列出 config.yaml 中声明的 Worker 及其状态 iii worker start name # 启动一个 Worker iii worker stop -y name # 停止一个 Worker-y 跳过确认 iii worker restart name # 先停后启 iii worker status name # 查看配置、沙箱状态与最近日志 iii worker logs name # 流式查看 Worker 日志 iii worker exec name -- command # 在 Worker 沙箱内执行命令 iii worker remove -y worker-name # 从 config.yaml 移除并销毁进程-y 跳过确认 iii worker clear -y worker-name # 同时删除下载到本地的构建产物省略名称则清理全部需要强制重新下载某个已存在的 Worker 时可用iii worker reinstall name等价于add --force。生命周期背后的机制从源码看Worker 通过 WebSocket 连接到 iii 引擎连接后该 Worker 对整个 iii 系统及其他 Worker 可见断开后其函数与触发器在重连之前将不可调用docs/0-16-0/using-iii/workers.mdx。函数与触发器正是来自已连接的 Worker——例如通过 iii-http Worker 添加http触发器后你就能像在 Express 或 FastAPI 中那样为函数暴露 HTTP 端点。Worker 的产物类型registry 中的每个 Worker 以两种形态之一发布原生二进制native binary按平台分别发布构建产物macOS、Linux、Windows引擎按当前平台拉取对应 artifactDocker / OCI 兼容镜像一个镜像即可在所有受支持的平台上运行。在引擎源码中可以看到这类按平台分发的痕迹engine/src/cli/registry.rs定义了BinarySpec其中supported_targets列出每个二进制支持的平台三元组如x86_64-unknown-linux-gnu、aarch64-apple-darwin、x86_64-pc-windows-msvc等并支持has_checksum校验与命令映射。也就是说一个发布版本即可覆盖所有受支持的宿主平台无需按平台分别发布。版本化策略发布侧视角registry 中的 Worker 遵循 semverpatch用于 bug 修复minor用于新增能力additive capabilitymajor用于函数或触发器签名的破坏性变更。作为使用者你只需记住默认安装追踪最新 releaseversion固定版本iii worker update升级iii.lock记录解析结果docs/0-16-0/creating-workers/workers-registry.mdx。Worker skillsAgent 化能力每个 Worker 还随附面向 Agent 工作的 skills。Skills 由skillsWorker 管理——这是一个仍在积极开发的内容注册型 Worker和任何其他 Worker 一样通过iii worker add加入项目。Skill 正文按需懒加载顶层条目保持精简Agent 仅在函数引用解析到某个iii://worker/leaf章节 URI 时才拉取更深层内容。结语Worker Registry 是 iii 生态的包管理器入口iii worker add用一条命令即可将 registry 中的 Worker、本地目录或 OCI 镜像接入你的项目自动写入config.yaml并启动semver iii.lock的组合保证了跨机器、跨平台的可复现安装原生二进制与 OCI 镜像两种产物类型则覆盖了从轻量二进制到通用容器镜像的全部部署形态。想了解移除、启动/停止、同步与校验等更完整的iii worker命令集可继续阅读 Workers 页面与安装指南。【免费下载链接】iiiEffortlessly compose, extend, and observe every service in real-time for the first time ever.项目地址: https://gitcode.com/GitHub_Trending/mo/iii创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考