扩展可以添加什么.
扩展几乎可以在 OpenChamber 的每个部分添加内容,有些工作甚至不需要窗口。选一个编号,看看那里能放什么、我们的某个扩展怎么用它,以及由 SDK 的哪个部分实现。
选一个编号,看看那里能放什么。
1 全屏页面 "页面"下的一行会把扩展全屏打开,取代聊天。
2 侧边栏行上的标记 扩展指定的会话和工作树上会出现一个小图标,提示中显示它的文字。
3 侧栏中的面板 右侧栏上的图标会在聊天旁打开扩展的页面。
4 实时画面 扩展的面板显示智能体正在操作的画面,例如手机模拟器,点进画面就能从智能体手中接过控制。
5 Work Status 中的分区 聊天旁面板中的一个分区,标题里最多可放四个控件。
6 聊天中的工具 扩展工具的调用会带上它的图标和标题,输出以卡片、列表、表格、JSON、Markdown 或代码显示。
7 智能体回复中的区块 智能体可以把扩展的组件写进回复,由扩展的页面绘制。
8 变成链接的 ID 消息中像 UPL-31 这样的任务 ID,或指向扩展跟踪器的链接,会变得可点击。
9 提示消息 窗口右下角的一条短消息,显示在所有内容之上。
10 与 GitHub 并列的 Git 主机 远程仓库在扩展的 Git 主机上的项目,会在"Issue 和 PR"看板上看到该主机的合并请求和 Issue,并使用主机自己的叫法。
11 与 Linear 并列的跟踪器 扩展跟踪器中的任务会在"Issue 和 PR"看板上拥有自己的标签页,紧挨着 Linear。
-
扩展指定的会话和工作树上会出现一个小图标,提示中显示它的文字。Acme CI 会在检查失败的分支的每个会话上打一个红叉。
使用在文档中阅读contributes.markshost.setMark() -
聊天旁面板中的一个分区,标题里最多可放四个控件。OpenChamber 可以根据扩展服务的回答自己绘制各行,这样分区不需要页面。
使用在文档中阅读contributes.statusSectionhost.setStatusControls() -
远程仓库在扩展的 Git 主机上的项目,会在"Issue 和 PR"看板上看到该主机的合并请求和 Issue,并使用主机自己的叫法。可以在那里评审和合并,也可以从任意一项开始工作树或会话。
使用在文档中阅读provides: ["source-control"]contributes.sourceControl -
扩展跟踪器中的任务会在"Issue 和 PR"看板上拥有自己的标签页,紧挨着 Linear。同样的任务也会出现在 + 菜单、New Worktree 以及会话的关联条目中。
使用在文档中阅读provides: ["tracker"]contributes.tracker
选一个编号,看看那里能放什么。
1 + 菜单中的条目 输入框 + 菜单中的扩展条目会在窗口中打开它的选择器。
2 附加的条目 扩展附加的条目以标签形式出现在输入框上,与 GitHub 和 Linear 条目位置相同。
3 斜杠命令 /task UPL-31 会直接附加任务,不打开任何东西。
4 @ 菜单中的行 扩展的服务会回应用户在 @ 后输入的内容。
5 命令面板 当用户搜索会话操作、斜杠命令或扩展名称时,它们会出现在 ⌘P 中。
6 提供方图标 当扩展的 OpenCode 插件添加模型提供方时,模型选择器和设置会用它自己的图标显示该提供方。
选一个编号,看看那里能放什么。
1 Git 主机 扩展添加一个与 GitHub、GitLab 和 Gitea 并列的 Git 主机。
2 跟踪器 扩展添加一个与 Linear 并列的跟踪器。
3 通知渠道 扩展的服务会收到手机本应收到的每条通知,并发送到聊天或自己的服务器。
4 账户卡片 "扩展账户"下的一张卡片,用户在这里用令牌或登录连接服务。
5 用量提供方 "用量"页面上与内置提供方并列的卡片,也可以显示在 Work Status 中。
6 智能体的浏览器 扩展的服务可以响应智能体的浏览器操作,这样不打开桌面应用智能体也能浏览。
-
扩展添加一个与 GitHub、GitLab 和 Gitea 并列的 Git 主机。该主机上的项目会获得 Issue 和 PR 看板、拉取请求徽章,以及从拉取请求创建工作树。
使用在文档中阅读provides: ["source-control"]contributes.sourceControl -
扩展添加一个与 Linear 并列的跟踪器。该跟踪器的任务会出现在选择器、+ 菜单、New Worktree 以及会话的关联条目中。
使用在文档中阅读provides: ["tracker"]contributes.tracker -
扩展的服务会收到手机本应收到的每条通知,并发送到聊天或自己的服务器。令牌保留在 OpenChamber 中。
使用在文档中阅读provides: ["notifications"]contributes.notifications -
"扩展账户"下的一张卡片,用户在这里用令牌或登录连接服务。扩展通过 OpenChamber 调用服务,从不接触令牌。
使用在文档中阅读contributes.integrationhost.request() -
"用量"页面上与内置提供方并列的卡片,也可以显示在 Work Status 中。数字由扩展读取,由 OpenChamber 绘制。
使用在文档中阅读provides: ["quota"]contributes.quota
Git 主机
扩展添加一个与 GitHub、GitLab 和 Gitea 并列的 Git 主机。该主机上的项目会获得 Issue 和 PR 看板、拉取请求徽章,以及从拉取请求创建工作树。
provides: ["source-control"]contributes.sourceControl选一个编号,看看那里能放什么。
1 智能体回复中的区块 扩展加入智能体回复的区块,在手机上按回复宽度显示,作者无需额外处理。
2 变成链接的 ID 聊天消息中像 UPL-31 这样的任务 ID 在手机上也会变成链接,作者无需额外处理。
3 聊天中的工具 扩展工具的调用在手机上同样带有扩展的图标、标题和输出布局,作者无需额外处理。
4 附加的条目 扩展附加的条目以标签形式放在手机输入框上,与桌面端相同。
5 提示消息 扩展的提示消息在手机上以屏幕顶部横幅显示,包括"复制"按钮。
6 工作区标签页 带有 panel.mobile: true 时,扩展的面板会成为手机工作区中的全屏标签页,排在内置标签页之后。
7 实时画面 带有 panel.mobile: true 和实时画面的扩展,会在工作区标签页中显示画面,并停靠作者自己的控件。
8 工作状态中的分区 扩展的 Work Status 分区会显示在工作区的"工作状态"标签页中,作者无需额外处理。
9 以底部面板显示的弹出框 扩展从锚点打开的弹出框,在手机上以标题为扩展名称的底部面板显示,作者无需额外处理。
10 全屏页面 标记为 page: { entry, mobile: true } 的页面会列在手机会话列表的"更多"中,并以带返回箭头的全屏打开。
11 会话行上的标记 扩展给会话和工作树加的标记会显示在手机的会话列表中,作者无需额外处理。
12 会话长按菜单中的操作 mode: "background" 的会话操作,会排在长按会话行打开的菜单中"归档"之后。
13 + 面板中的扩展行 带有 panel.mobile: true 时,扩展的附加入口会出现在输入框的 + 面板中,位于选择器下方。
14 + 面板中的跟踪器 扩展添加的跟踪器会出现在输入框的 + 面板中,与 GitHub 和 Linear 并列,作者无需额外处理。
15 斜杠命令 扩展的斜杠命令可以在手机输入框中使用,作者无需额外处理。
16 @ 菜单中的行 扩展服务在 @ 菜单中加入的行,在手机上同样显示,作者无需额外处理。
17 消息操作 mode: "background" 的消息操作,会出现在手机上消息的"更多操作"面板中。
18 选中文字的操作 mode: "background" 的选中操作,会以按钮形式出现在手机上选中文字的面板中。
19 文件编辑器 扩展为某种文件类型提供的编辑器,会在手机上占满"文件"标签页,作者无需额外处理。
20 文件中长按的操作 mode: "background" 的文件操作,会排在长按"文件"中某行打开的菜单里"复制路径"之后。
21 选中差异行的操作 mode: "background" 的差异操作,会在手机上以带文字的按钮出现在选中行的评论框下方。
22 提供方图标 扩展附带的提供方图标会显示在手机的模型选择器中,作者无需额外处理。
23 设置 → 扩展 手机的设置中有"扩展"页面,可以添加、批准、暂停和移除扩展。
24 账户卡片 扩展的跟踪器、通知渠道和账户卡片会显示在手机的 设置 → 集成 中。
25 用量卡片 扩展的用量提供方会在手机的 设置 → 用量 页面获得一张带扩展图标的卡片,作者无需额外处理。
26 智能体的浏览器 手机上的 设置 → OpenChamber 工具 可以把扩展的服务选为智能体的浏览器。
-
聊天消息中像 UPL-31 这样的任务 ID 在手机上也会变成链接,作者无需额外处理。扩展带有 panel.mobile: true 时,点击会打开扩展的工作区标签页,否则链接保持原本的行为。
使用在文档中阅读contributes.links -
扩展附加的条目以标签形式放在手机输入框上,与桌面端相同。带有 panel.mobile: true 时,点击会在扩展的标签页中打开,否则会弹出提示,说明该扩展无法在手机上打开。
使用在文档中阅读host.attach()panel.mobile: true -
带有 panel.mobile: true 时,扩展的面板会成为手机工作区中的全屏标签页,排在内置标签页之后。徽标计数显示在标签图标上,设置 → 通用 可以和其他标签页一起排序或隐藏它。
使用在文档中阅读panel.mobile: truehost.setBadge() -
带有 panel.mobile: true 和实时画面的扩展,会在工作区标签页中显示画面,并停靠作者自己的控件。状态显示"轻点即可接管控制","交还给智能体"会交还控制。
使用阅读 SDK 参考panel.mobile: trueservice.surface -
扩展的 Work Status 分区会显示在工作区的"工作状态"标签页中,作者无需额外处理。控件会放大到适合手指的 36 px,分区选择器会把它标为"扩展"。
使用在文档中阅读contributes.statusSection -
扩展从锚点打开的弹出框,在手机上以标题为扩展名称的底部面板显示,作者无需额外处理。面板高度按扩展的要求,点叉号、点面板外或返回即可关闭。
使用阅读 SDK 参考mountPopoverAnchor() -
标记为 page: { entry, mobile: true } 的页面会列在手机会话列表的"更多"中,并以带返回箭头的全屏打开。page: true 的页面复用面板的 HTML,所以遵循 panel.mobile。
使用在文档中阅读page: { entry, mobile: true } -
扩展给会话和工作树加的标记会显示在手机的会话列表中,作者无需额外处理。扩展带有 panel.mobile: true 时,点击会打开它的工作区标签页,否则会显示标记文字,并在有链接时打开链接。
使用在文档中阅读contributes.marks -
mode: "background" 的会话操作,会排在长按会话行打开的菜单中"归档"之后。打开面板的操作只有在 panel.mobile: true 时才会出现。
使用在文档中阅读where: "session"mode: "background" -
带有 panel.mobile: true 时,扩展的附加入口会出现在输入框的 + 面板中,位于选择器下方。对话框以全屏打开,面板则作为扩展的工作区标签页打开。
使用在文档中阅读contributes.attachpanel.mobile: true -
mode: "background" 的消息操作,会出现在手机上消息的"更多操作"面板中。打开面板的操作只有在 panel.mobile: true 时才会出现。
使用在文档中阅读where: "message"mode: "background" -
mode: "background" 的选中操作,会以按钮形式出现在手机上选中文字的面板中。打开面板的操作只有在 panel.mobile: true 时才会出现。
使用在文档中阅读where: "selection"mode: "background" -
扩展为某种文件类型提供的编辑器,会在手机上占满"文件"标签页,作者无需额外处理。文件由 OpenChamber 保管和保存,与桌面端相同。
使用在文档中阅读contributes.fileEditors -
mode: "background" 的文件操作,会排在长按"文件"中某行打开的菜单里"复制路径"之后。打开面板的操作只有在 panel.mobile: true 时才会出现。
使用在文档中阅读where: "file"mode: "background" -
mode: "background" 的差异操作,会在手机上以带文字的按钮出现在选中行的评论框下方。打开面板的操作只有在 panel.mobile: true 时才会出现。
使用在文档中阅读where: "diff"mode: "background" -
手机的设置中有"扩展"页面,可以添加、批准、暂停和移除扩展。权限会在底部面板中打开,作者无需为此做任何事。
在文档中阅读
不打开窗口的工作
本地服务在 OpenChamber 旁运行,没人看着时也会继续工作。
service.keepRunningservice.schedule contributes.sessionEvents contributes.sessionControl contributes.instructionscontributes.skills contributes.opencodePlugin contributes.waits host.generate() host.readFile()contributes.filesystem host.storage host.onRunningShells() provides: ["opencode"]