finch-session-board 0.0.0-stage → 0.1.2

package/finch.json

@@ -0,0 +1,41 @@
+{
+    "manifestVersion": 1,
+    "minVersion": "1.6.1",
+    "name": "Session Board",
+    "description": "List every running session and its state on a floating board that stays on top of your desktop.",
+    "miniToolType": "community",
+    "categories": ["productivity", "sessions"],
+    "main": "dist/index.js",
+    "activationEvents": ["onStartup"],
+    "systemPrompt": "Point the user to the session board when they ask what sessions are running.",
+    "promptGuides": [
+        {
+            "id": "running",
+            "title": "See what is running",
+            "description": "Open the session board and read which sessions are busy or waiting.",
+            "prompt": "Open the session board and tell me which sessions are still running and which are waiting for my confirmation."
+        }
+    ],
+    "contributes": {
+        "composerActions": [
+            {
+                "id": "session-board",
+                "icon": "ext:board",
+                "tooltip": "Session Board"
+            }
+        ],
+        "iconPacks": [
+            {
+                "id": "session-board",
+                "label": "Session Board Icons"
+            }
+        ]
+    },
+    "permissions": {
+        "filesystem": "none",
+        "network": false,
+        "shell": false,
+        "sessions": true,
+        "sessionWaits": "all"
+    }
+}

package/i18n/zh-CN.json

@@ -0,0 +1,37 @@
+{
+    "name": "会话看板",
+    "description": "把当前所有活跃会话列成常驻桌面的列表浮窗",
+    "systemPrompt": "用户问起当前有几个会话在跑、各自什么状态时，提示他打开会话看板浮窗。",
+    "promptGuides": {
+        "running": {
+            "title": "看看在跑什么",
+            "description": "打开看板，读出哪些会话在忙、哪些在等确认。",
+            "prompt": "打开会话看板，告诉我还有哪些会话在跑、哪些在等我确认。"
+        }
+    },
+    "composerActions": {
+        "session-board": {
+            "tooltip": "会话看板"
+        }
+    },
+    "board": {
+        "total": "会话",
+        "waiting": "等待"
+    },
+    "menu": {
+        "summary": "{count} 个会话",
+        "show": "显示看板",
+        "hide": "隐藏看板",
+        "preview": "图标预览",
+        "clearFinished": "清空已完成"
+    },
+    "preview": {
+        "title": "图标预览"
+    },
+    "toast": {
+        "unsupported": "当前 Finch 版本不支持浮动窗口",
+        "failed": "看板打开失败",
+        "initFailed": "看板启动失败",
+        "notReady": "看板脚本没有就绪"
+    }
+}

package/package.json

@@ -1,6 +1,22 @@
 {
-  "name": "finch-session-board",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "finch-session-board",
+    "version": "0.1.2",
+    "description": "会话看板小程序",
+    "homepage": "https://yicode.tech",
+    "license": "MIT",
+    "author": "陈随易 <bimostyle@qq.com>",
+    "files": [
+        "finch.json",
+        "dist/",
+        "i18n/",
+        "skills/",
+        "docs/",
+        "icon.png",
+        "README.md"
+    ],
+    "type": "module",
+    "main": "dist/index.js",
+    "devDependencies": {
+        "finch-shared": "0.0.0"
+    }
+}

package/skills/session-board/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: session-board
+description: 会话看板的操作手册。用户问起「现在有几个会话在跑」「哪个会话在等我确认」「在忙什么」，或者要打开、隐藏、清空会话看板浮窗时先读它，里面写了菜单入口、窗口内操作、状态图标与配色对照，以及这个看板拿不到哪些信息。
+---
+
+# 会话看板
+
+一块常驻桌面的置顶浮窗，把当前所有正在跑的会话列成一张表。
+
+它属于用户自己看的东西，Agent 读不到窗口画面，也没法用工具替用户操作它。Agent 能做两件事：按下面的入口告诉用户怎么打开或关掉，以及用图标和配色表解释用户看到的画面。
+
+## 入口
+
+点输入框下方工具栏的「会话看板」按钮，弹出菜单：
+
+| 菜单项              | 作用                                                                 |
+| ------------------- | -------------------------------------------------------------------- |
+| N 个会话            | 只读，当前记录条数                                                   |
+| 显示看板 / 隐藏看板 | 开关浮窗，状态会记下来，下次启动沿用                                 |
+| 图标预览            | 整窗铺 3 列图标墙加 8 色色卡，用来看 14px 下的实际观感，不改任何数据 |
+| 清空已完成          | 一次清掉所有跑完的记录，进行中的不动；没有已完成时置灰               |
+
+按钮本身在浮窗显示时是绿色，隐藏后恢复常态色，不显示数字。
+
+## 窗口内操作
+
+- 点一行跳到对应会话；已跑完的点一次就从列表移除
+- 按住标题带任意空白处拖动窗口，位置会记住
+- 标题栏右侧两个图标：眼睛隐藏面板，垃圾桶清空已完成
+- 鼠标压到按钮或行上，底色变亮、指针变手型
+
+窗口始终接受鼠标，不做穿透模式。获得焦点时 Finch 会描一圈主题强调色边，点别处失焦后消失。
+
+## 界面
+
+标题带左边是「N 会话」，有会话在等待时紧跟橙色的「· M 等待」，放不下的条数再跟 `+N`。
+
+一屏最多 8 行，没有记录时只剩标题带，不画占位格。窗口宽 240，零条时高 32，每多一条加 22。
+
+每行三段：左边状态图标，中间一句话加时长，右侧会话标题。
+
+中间那句只出一段，有具体动作就念动作（「读取文件」），没有就念阶段名（「思考中」）。
+
+右侧最多 8 个字，拿不到标题时显示会话 id 前 8 位。
+
+## 图标与配色
+
+图标回答「在做什么」，颜色回答「要不要紧」，两个维度互不干扰。
+
+| 状态       | 图标     | 颜色 |
+| ---------- | -------- | ---- |
+| 刚出现     | 半点     | 灰   |
+| 思考中     | 沙漏     | 蓝   |
+| 回答中     | 对话气泡 | 蓝   |
+| 读取文件   | 文件页   | 蓝   |
+| 查找       | 放大镜   | 蓝   |
+| 联网查询   | 地球     | 蓝   |
+| 调度子任务 | 待办清单 | 蓝   |
+| 压缩上下文 | 收缩箭头 | 蓝   |
+| 改写文件   | 铅笔     | 紫   |
+| 执行命令   | 终端     | 玫红 |
+| 等你确认   | 感叹号   | 橙   |
+| 重试中     | 循环箭头 | 黄绿 |
+| 正在打断   | 停止方块 | 黄绿 |
+| 已打断     | 方框斜杠 | 黄绿 |
+| 已完成     | 勾       | 绿   |
+| 出错       | 叉       | 红   |
+
+蓝色是一切实只读工作，紫色会改文件，玫红会动系统，橙色要用户动手。整窗只有这八个色相，不按动作逐个配色，否则 12px 下分不清。
+
+## 拿不到的信息
+
+- 不读对话正文，只有阶段、工具名、标题和时长
+- 会话标题有三个来源：当前会话快照、用户通知、等待确认事件。普通事件不带标题，所以从启动就闷头跑、既不弹等待也不出通知的会话，结束前右侧只能显示 id
+- 小程序自己创建的会话不出现在侧栏，也不带标题，看板上只能看到 id
+- 窗口画面无法被 Agent 读取，不要假装能看见里面的内容