Skip to content

Commit 61b7fdb

Browse files
authored
New version: QZYH123.OrbCue version 0.2.9 (microsoft#446902)
1 parent 3b92cf1 commit 61b7fdb

4 files changed

Lines changed: 165 additions & 0 deletions

File tree

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Created with YamlCreate.ps1 Dumplings Mod
2+
# yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json
3+
4+
PackageIdentifier: QZYH123.OrbCue
5+
PackageVersion: 0.2.9
6+
InstallerType: nullsoft
7+
Scope: user
8+
ProductCode: OrbCue
9+
ReleaseDate: 2026-10-05
10+
InstallationMetadata:
11+
DefaultInstallLocation: '%LocalAppData%\OrbCue'
12+
Installers:
13+
- Architecture: x64
14+
InstallerUrl: https://github.com/QZYH123/OrbCue/releases/download/v0.2.9/OrbCue_0.2.9_x64-setup.exe
15+
InstallerSha256: FAB13008D290C6A74F87EA740F75E08CC25155061F25B150D3EE7BE2194EDB61
16+
ManifestType: installer
17+
ManifestVersion: 1.12.0
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Created with YamlCreate.ps1 Dumplings Mod
2+
# yaml-language-server: $schema=https://aka.ms/winget-manifest.locale.1.12.0.schema.json
3+
4+
PackageIdentifier: QZYH123.OrbCue
5+
PackageVersion: 0.2.9
6+
PackageLocale: en-US
7+
ShortDescription: A desktop orb for Windows that cues you when an AI coding agent needs you
8+
Description: 'OrbCue places a small orb on your Windows desktop: working sessions show only a count, and it cues you the moment an agent waits for your input, authorization, or fails. Clicking the orb opens a list grouped by project, and each entry can jump back to its terminal. It never reads conversations, prompts, commands, or code, stays offline by default, and keeps all state in the current user profile. It supports CLI tools such as Claude Code, Grok Build, Codex, and Cursor Agent.'
9+
Tags:
10+
- ai
11+
- claude-code
12+
- codex
13+
- grok-build
14+
- notification
15+
ManifestType: locale
16+
ManifestVersion: 1.12.0
Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
# Created with YamlCreate.ps1 Dumplings Mod
2+
# yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json
3+
4+
PackageIdentifier: QZYH123.OrbCue
5+
PackageVersion: 0.2.9
6+
PackageLocale: zh-CN
7+
Publisher: orbcue
8+
PublisherUrl: https://github.com/QZYH123
9+
PublisherSupportUrl: https://github.com/QZYH123/OrbCue/issues
10+
Author: QZYH123
11+
PackageName: OrbCue
12+
PackageUrl: https://github.com/QZYH123/OrbCue
13+
License: MIT
14+
LicenseUrl: https://github.com/QZYH123/OrbCue/blob/HEAD/LICENSE
15+
Copyright: Copyright (c) 2026 OrbCue contributors
16+
ShortDescription: 在 Windows 桌面上提醒你 AI 命令行助手需要你处理的悬浮小球
17+
Description: |-
18+
同时开着几个终端里的 AI 助手,窗口一多就很难看出谁在干活、谁在等你。
19+
OrbCue 在 Windows 桌面上放一个小球:orb 是形态,cue 是该你出手了。工作时只显示数量,需要你处理时才提醒。 点开小球是按项目分组的列表,点条目上的返回箭头可以跳回对应终端。命令行是 orb。
20+
- 不读取对话、提示词、命令或代码,也不替你操作这些工具
21+
- 默认不联网;状态只保存在本机当前用户目录
22+
- 支持的命令行工具:
23+
| 工具 | 命令 |
24+
| ------------ | -------------------- |
25+
| Claude Code | claude |
26+
| Grok Build | grok |
27+
| Codex | codex |
28+
| Cursor Agent | agent / cursor-agent |
29+
以上指的都是 CLI 版本。
30+
31+
它做什么、不做什么
32+
33+
做
34+
- 多个工具共用一个小球。数字是「正在工作的主会话 / 当前列表里的主会话」,例如 2/5
35+
- 等待输入、等待授权或失败时,弹一次系统通知并播提示音;正常完成只播提示音,不弹通知
36+
- 在「连接」页接上本机已经装好的工具:不替换可执行文件,确认前会列出将要改的文件
37+
- 从列表跳回终端。用 orb run 在 Windows Terminal 里开出的专属标签,可以精确回到那个标签
38+
39+
不做
40+
- 不读取对话记录、提示词、命令、代码、终端输出或凭据
41+
- 不扫描进程列表去猜测工具是否在工作
42+
- 不替换工具的可执行文件;连接失败也不会下载或重装任何东西
43+
- 不监听网络端口,不上传任何数据
44+
- 面板不展示对话摘要,只显示工具名、所属项目和状态
45+
46+
界面
47+
点小球展开面板;再点一次或点面板右上角 × 收起。托盘菜单可以「打开 OrbCue」、隐藏或显示小球、退出。
48+
| 页面 | 作用 |
49+
| ---- | ----------------------------------------------------------------------------------------- |
50+
| 小球 | 桌面常驻。数字是工作中 / 追踪中;? 表示有任务在等你,! 表示有失败。可拖到屏幕边缘贴成半圆 |
51+
| 动态 | 当前会话列表,按项目分组,可筛选全部 / 工作中 / 未工作 |
52+
| 审计 | 本次运行里最近的完成、失败、等待和关闭,最多 128 条,只在内存中,重启即清空 |
53+
| 连接 | 列出本机检测到的工具,确认后连接或断开 |
54+
| 设置 | 外观、提示音、系统通知、开机自启、快捷键、圆标、侧边收起,以及启动别名 |
55+
外观主题有五套:原型、Fluent、Glyph、Braun、Glass,在「设置」里切换。
56+
57+
动态
58+
每条会话显示工具名、项目和状态,没有对话内容。
59+
- 已读:去掉等待提醒
60+
- 清除:把卡住的条目从列表拿掉。只影响 OrbCue 的显示,不会向工具发命令;清掉之后这条不会再回来
61+
- 返回箭头:跳回终端。用 orb run 开出的专属标签能精确回去(标签被拖出或合并过也有效);自己手动开的终端只回到该窗口最近交互过的位置,窗口已经关掉时会提示失败,不会跳错地方
62+
- 底栏「全部已读」「清除全部」对当前列表一次性操作
63+
- 工具进程退出后,对应条目会自动消失
64+
- 子任务计入所属的主任务,不单独占小球上的数字
65+
要精确跳到某一个 Windows Terminal 标签:在「设置」里给启动方式起一个短命令(启动别名),然后用这个短命令在新标签里打开工具。没设别名时,在新开的 Windows Terminal 里运行 orb run grok(或 claude / codex 等)效果相同。第一次用之前需要先启动过一次 OrbCue,并新开终端。
66+
67+
连接
68+
每一行是一个已检测到的工具,并标明在 Windows 还是 WSL。状态是「可连接」或「已连接」。
69+
- 连接:先弹出将要改哪些文件,点「确认连接」才动手
70+
- 断开:只移除 OrbCue 自己写入的内容,不会动你后来改过的其他设置
71+
- 刷新:重新检测本机工具
72+
- 从文件夹添加:官方安装路径里找不到时,选包含可执行文件的文件夹
73+
同名工具在 Windows 和 WSL 各装了一份,就各占一行,分开连接。Cursor 编辑器本身不会被当成命令行工具。
74+
连接页会查看:桌面程序能看到的 PATH、用户 PATH,以及常见安装目录(例如 %USERPROFILE%\.local\bin、Grok Build 的 %USERPROFILE%\.grok\bin、Cursor 命令行的 %LOCALAPPDATA%\cursor-agent)。装了 WSL 时再查看 WSL 里的 PATH(WSL 里能看到的 Windows 程序不重复计)。
75+
76+
设置
77+
- 启动别名:给 orb run 起短命令,方便精确跳回
78+
- 隐藏圆标:小球右上角不再显示 ? / !
79+
- 收到侧边:默认打开。拖到屏幕边缘约一个球宽内,小球会贴成半圆,略透明、不显示数字;鼠标悬停会沿同一边滑出来,移开后再贴回去。出现 ? 或 ! 时会保持展开,直到你再把它拖到边上。关掉则只是普通拖动
80+
- 完成 / 等待 / 失败提示音、系统通知
81+
- 开机自启:登录 Windows 后自动打开 OrbCue
82+
- 全局快捷键:默认 Ctrl+Shift+Space 打开或收起面板
83+
84+
连接时改了什么
85+
连接方式取决于工具是否提供 hook(工具自带的事件通知机制):
86+
| 工具 | 连接方式 | 能报告的状态 |
87+
| ----------------------- | ----------------------------- | ---------------------------------------------- |
88+
| Claude Code、Grok Build | 在该工具自己的配置里登记 hook | 开始、等待、完成、失败、关闭 |
89+
| Cursor | 在该工具自己的配置里登记 hook | 开始、完成、失败、关闭;选择题不会标成「等待」 |
90+
| Codex | 在该工具自己的配置里登记 hook | 开始、等待、完成、关闭;打断和报错看不到 |
91+
92+
限制会写在连接页对应行上:
93+
- Cursor 命令行偶尔不会通知已经结束,任务会停在「工作中」,直到进程退出才消失
94+
- Codex 用 Esc 或 Ctrl+C 打断当前回复时,不会通知 OrbCue,任务停在「工作中」;对话报错也不会显示为失败。在动态页点「清除」即可;退出 Codex 后任务也会从列表消失
95+
- Claude Code / Codex 在授权框里点拒绝时,不会通知 OrbCue。小球会停在「等待授权」,直到它继续干活或这一轮结束;也可以在动态页点「清除」。Grok Build 点拒绝会马上回到工作中
96+
- 首次修改 Claude Code / Codex / Cursor 的配置前,会保留一份备份(例如 settings.json.orbcue.bak)
97+
98+
隐私与数据
99+
- 只在本机、当前用户范围内通信:Windows 用命名管道,WSL 里的命令行用 Unix socket;不监听任何网络端口
100+
- 写入磁盘的只有:来源、任务 ID、状态、时间、已读标记、终端标记、项目路径。Windows 在 %LOCALAPPDATA%\OrbCue\state.json;WSL / Linux 命令行在 $XDG_STATE_HOME/orbcue/state.json(默认 ~/.local/state 下)
101+
- 任务摘要只在内存里短暂存在,不写盘;对话、提示词、命令一概不经手
102+
- 重启后会恢复上述最小状态,但不会重播提醒;过期事件直接丢弃
103+
- 判断工具进程是否退出时,只查询连接时记下的那一个进程,不扫描整个进程列表
104+
- 提示音、界面或某个连接出问题,不影响状态服务本身;卡住的条目可以随时「清除」
105+
Tags:
106+
- claude-code
107+
- codex
108+
- grok-build
109+
- 人工智能
110+
- 通知
111+
ReleaseNotes: |-
112+
设置里可以改语言。OpenCode 和 Pi 的命令行可以接到小球上。
113+
新增
114+
- 语言:跟随系统、中文或 English。面板、通知、托盘和 orb 命令一起改。系统语言不是中文时,默认是英文。
115+
- OpenCode 命令行:在连接页接入。关掉标签或客户端后,这一行会去掉。
116+
- Pi 命令行:在连接页接入。退出或关掉它所在的终端后,这一行会去掉。
117+
修复
118+
- OpenCode 2 的会话能认出来,按所在文件夹显示,不再标成「其他」。
119+
- 同一个项目路径末尾多一个斜杠时,归在同一个项目下,不再拆成两行。
120+
- Cursor 主会话还在等子代理时,不再提前标成已完成。
121+
- 连接失败的长说明留在面板里,不再挡住下面的页面切换。
122+
ReleaseNotesUrl: https://github.com/QZYH123/OrbCue/releases/tag/v0.2.9
123+
ManifestType: defaultLocale
124+
ManifestVersion: 1.12.0
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Created with YamlCreate.ps1 Dumplings Mod
2+
# yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json
3+
4+
PackageIdentifier: QZYH123.OrbCue
5+
PackageVersion: 0.2.9
6+
DefaultLocale: zh-CN
7+
ManifestType: version
8+
ManifestVersion: 1.12.0

0 commit comments

Comments
 (0)