用途 OpenWorker Apps 用于帮助开发者使用 OpenWorker Harness SDK 构建或适配桌面应用与 Web 应用。其定位是让开发者继续掌控自己的产品,由 OpenWorker 负责智能体循环,并保留开发者选定的 UI 框架、模型与部署目标。
主要能力与参考内容 技能资料按主题给出集成参考:
- SDK 集成:说明共享生命周期与包契约。
- 运行时选项:涵盖模型提供商配置、可重试的流式会话、推理内容展示、迁移历史、更改回合偏好。
- 独立子智能体:用于模型创建的儿童智能体,使用前需检查其运行时版本门槛。
- 可观测性:可选的回合轨迹、Langfuse 导出或评估证据,使用前需检查发布门槛。
- 应用形态:桌面应用参考 Desktop,浏览器/服务端应用参考 Web。
- 部署:Railway 部署参考,默认采用单个 Node 服务同时提供前端与 HTTP API,并搭配托管的 Rust harness。
这些参考资料随技能打包提供,不要求检出 OpenWorker 仓库。若存在 references/installation.json,则记录该技能支持的确切 SDK 版本;源码检出场景可使用技能包的 openworkerSdkVersion。技能发布可独立于 SDK 推进,使用 API 前应匹配应用已安装版本,不要静默升级现有应用。对于打包示例之外的 API,应使用已安装包的 TypeScript 声明;Rust 场景可查阅对应 SDK 版本的 API 文档或源码。对于未发布的本地候选版本,应使用提供的 SDK 与原生运行时归档;清单中的版本号不能证明包已在注册表存在,也不要回退到名称相似的三方包。
使用方式与集成边界 TypeScript 在 Electron 主进程或应用服务端启动托管的 Rust 子进程;浏览器/渲染进程代码通过应用 API 或窄 IPC 交互;Rust 可将 harness 进程内嵌入。模型凭据应保留在该可信进程中。应用自行负责 UI、认证、会话归属与生命周期。
工具选择应审慎:目录摘要与 PDF 示例自带输入,因此使用 tools: [] 并在这些场景禁用规划、记忆与调度;其他应用可能需要工具。禁用可选记忆不会禁用历史。文件与文档内容属于不可信数据,需安全渲染模型文本;目录读取器的排除项不是密钥扫描器,也不是操作系统沙箱。打包示例对应用自有输入选择 sandbox: "off",该模式下的工具具有宿主权限;若产品需要隔离的工具执行,应查阅 OpenShell 指南。
验证方式 应针对所选产品测试流式传输与终端状态、错误、取消、重启以及打包运行时路径。确定性模型夹具可在无真实密钥时验证传输与生命周期,但不能证明回答质量。只能声明实际验证过的目标平台与部署支持。安装本技能不会发布应用,也不会授予云部署权限。
适用场景与限制 适用于希望在自己的桌面或 Web 产品中嵌入 OpenWorker 智能体能力的开发团队,覆盖从 SDK 集成、模型配置、子智能体、可观测性到部署的链路。限制包括:必须匹配已安装 SDK 版本,不应静默升级;非打包示例的 API 需查已安装包声明;凭据须留在可信进程;sandbox: "off" 具有宿主权限,如需隔离执行需另行参考 OpenShell 指南;文件和文档内容不可信;资料未提供具体价格、收费模式或平台支持范围,这些事实暂未提供。