SKI 桌面宠物

Spark Kinetic Interface - Claude 会话监控与桌面伴侣

简介

SKI（Spark Kinetic Interface）是星海 Spark 的桌面宠物插件，通过监控 Claude 会话活动，实时显示 AI 工作状态。

核心特性

• 会话监控 - 实时监控 Claude sessions.jsonl 文件
• 状态反馈 - 显示 WORKING / IDLE 状态
• 多角色支持 - 可切换不同的宠物精灵
• 桌面常驻 - 始终置顶，不影响其他操作
• 轻量设计 - 极简资源占用

安装

Spark 插件市场安装

1. 打开 Spark (Alt/Cmd + R)
2. 输入 "SKI" 或 "桌面宠物"
3. 回车进入插件页面
4. 点击安装

命令行安装

spark install spark-plugin-system--ski

快速开始

启动 SKI

安装后，使用命令唤起：

ski
# 或
SKI

宠物状态

状态	说明
IDLE	Claude 空闲，待命中
WORKING	Claude 正在思考/执行任务

角色切换

SKI 支持多个宠物角色：

可用角色

# 切换到小白
ski switch xiaoba

# 切换到海皇
ski switch haihuang

自定义角色

你可以添加自己的宠物角色：

1. 准备宠物精灵图（PNG 格式，透明背景）
2. 创建角色目录：

   ~/.spark/ski/sprites/your-pet/

3. 添加 sprite.png 到目录
4. 重启 SKI

会话监控配置

默认监控路径

SKI 会监控以下路径的会话文件：

# macOS
~/Library/Application Support/Claude/sessions.jsonl

# Windows
%APPDATA%/Claude/sessions.jsonl

# Linux
~/.config/Claude/sessions.jsonl

自定义监控路径

ski config add path /custom/path/to/sessions.jsonl

快捷键

快捷键	功能
Cmd/Ctrl + Shift + S	显示/隐藏 SKI
Cmd/Ctrl + Shift + D	切换显示模式
ESC	隐藏 SKI

配置文件

SKI 配置文件位置：~/.spark/ski/config.json

{
  "activePet": "xiaoba",
  "monitorPaths": [
    "~/Library/Application Support/Claude/sessions.jsonl"
  ],
  "refreshInterval": 1000,
  "window": {
    "alwaysOnTop": true,
    "transparent": true,
    "resizable": false
  }
}

常见问题

SKI 支持其他 AI 工具吗？

目前 SKI 专门为 Claude 设计，支持 Claude Desktop 和 Claude Agent SDK 的会话监控。未来版本可能会添加对其他 AI 工具的支持。

如何自定义宠物动画？

在角色目录中添加多个帧：

~/.spark/ski/sprites/your-pet/
├── frame-1.png
├── frame-2.png
├── frame-3.png
└── config.json

config.json 示例：

{
  "frames": ["frame-1.png", "frame-2.png", "frame-3.png"],
  "fps": 2,
  "idle": ["frame-1.png"],
  "working": ["frame-2.png", "frame-3.png"]
}

宠物窗口可以拖动吗？

可以。按住宠物任意位置即可拖动窗口。位置会自动保存。

相关资源

• SKI GitHub
• Claude Agent SDK 文档
• 更多宠物角色