Cute Island — Development skill for Claude Code

Cute Island

Windows、macOS、Linux 上的 PC 灵动岛。黑胶囊贴在屏幕顶部正中，用来看 agent 正在做什么。 首次启动默认位于顶部居中，可以按住胶囊或会话标题拖动；松手记住位置，重启后恢复。默认半透明，鼠标悬浮、拖动、键盘聚焦或点击展开时恢复实色，收起并移开焦点后恢复半透明。

支持两种显示模式，可在独立配置窗口或系统托盘右键菜单中切换，重启后记住选择：

• 关注模式（默认）：保留上述悬浮、点击展开、拖动和贴边收纳行为。
• 托管模式：平时只保留淡显的紧凑状态或贴边把手（28% 不透明度，空闲细条为 16%），鼠标悬浮不加深，点击、滚动和拖动穿透到下方窗口。明确的审批、用户输入请求、会话失败或后台任务异常会主动展开并恢复实色；提醒期间只显示需要关注的会话，只有提醒面板接收鼠标，周围透明区域继续穿透。点击「知道了」或按 Escape 可收起当前会话的提醒，不会删除会话；问题恢复后也会自动收起，回到原来的贴边状态。

托管提醒不会因客户端、进度或时间刷新反复弹出；新的审批命令、新一轮任务或异常再次发生时会重新提醒。普通「等待中」也可能表示等待 Agent 回复，不会仅凭这个状态弹出。用户输入提醒识别明确的 `AskUserQuestion`、`AskQuestion`、`ask_user`、`request_user_input` 和 `request_user_input_async` 调用；未接入交互通道的会话仍提醒你回到原 Agent 处理。浏览器预览可在底部切换两种模式。

闲置时它收成一条细胶囊。有活动时变成紧凑态：左侧是状态图标，右侧是一行标题。点一下展开，能看到 agent 名称、说明、进度、最近步骤和耗时。成功会短暂打勾后收回；失败保持展开，直到被新状态盖掉，或点「关闭」。

执行状态和操作类型使用 SVG 图标：命令终端、文件读写、搜索、MCP、Skill 和子 Agent 协作各有标识。执行中显示轻量动画，遵循系统「减少动态效果」设置。Codex 标识采用官方 VS Code 扩展使用的 OpenAI Blossom 矢量图形。

紧凑态、多会话列表和展开详情均显示来源客户端，独立于 Agent 名称和命令 Shell。例如同为 Claude Code 的会话可以分别标注 VS Code、Cursor、Windows Terminal 或 PowerShell。来源标签只用于展示；点击会话仍展开详情。

「执行时间」表示最近一轮执行已持续多久：从本轮开始累计，工具切换、状态刷新和客户端标签变化不重置；新一轮开始时重新计时。紧凑态与会话列表显示在状态下方，展开后显示在右上角。完成或失败后保留本轮耗时；仍有子 Agent 或后台命令运行时继续计时。超过一小时显示 `时:分:秒`。

展开命令可查看命令内容、Shell 和工作目录；长命令支持换行、滚动和选择复制。MCP 显示服务与工具名称，Skill 显示读取或调用的技能名称，子 Agent 显示任务名称。需要审批时自动展开琥珀色提示；配置自动审批并接入支持的 Agent 后，可按规则自动回传批准或回答。

配置窗口与自动审批

首次启动会打开独立配置窗口。之后可通过托盘「打开配置…」、双击托盘图标、灵动岛右键菜单，或再次启动应用打开。启动参数 `--settings` 也可直接打开配置。关闭配置窗口后，灵动岛继续运行。

配置分为常规、自动审批、Agent 接入和处理记录：

• 常规：切换关注 / 托管模式、控制本机会话识别、显示或隐藏灵动岛、恢复顶部位置、播放演示。
• 自动审批：独立总开关，默认关闭。可分别开启权限审批、选择题回答；推荐项支持 （推荐）、(Recommended) 或原生推荐标记。无推荐时默认保留手动回答，也可选择第一项。自由输入、密码、重复问题标识、无法确定唯一答案的问题保留手动处理；多题请求必须能完整回答才提交。
• Agent 接入：显示安装和连接状态。读取日志只能展示状态，自动审批必须使用下列原生交互通道。
• 处理记录：保留本次启动最近 50 条批准、回答或转交手动的记录，可清空；不会把提交回答伪装成工具执行成功。

设置自动保存至 Electron 用户数据目录的 `preferences.json`，与托盘实时同步，重启后恢复。旧版仅含 `mode` 的文件自动兼容。`CUTE_ISLAND_WATCH=0`