SPPet 是一个由 Super Productivity 驱动的学习养成与桌宠系统。它不修改 SP Core，通过官方 Plugin API 读取任务和专注变化，再把委托、成长、回合制冒险和桌宠状态交给独立游戏引擎处理。
SP 插件采用温馨、高饱和的像素冒险界面；排行榜与开发者网站保留深浅档案区、编号轨道和蓝色信号线构成的战术终端信息层级。项目不包含商业游戏的角色、Logo、字体或美术资源。
sppet/
├─ packages/
│ ├─ core/
│ │ └─ src/
│ │ ├─ types.ts # 状态、战斗、道具和内容结构
│ │ ├─ catalog.ts # 内置技能、装备、敌人和章节
│ │ ├─ engine.ts # 委托、签到、养成与回合制规则
│ │ └─ index.ts # 公共导出
│ ├─ sp-plugin/
│ │ ├─ src/ # SP hooks、存储、桌宠桥接、网站连接
│ │ └─ static/ # 独立 HTML / CSS / JS 面板
│ ├─ desktop-pet/ # Electron 透明桌宠与 localhost 服务
│ └─ website/ # 排行榜、编辑器、SQLite 登录与本地启动脚本
├─ CHANGELOG.md
└─ README.md
网站与 Nginx 配置从 v0.3.1 起纳入仓库，同时同步交付到 D:\temp\SPPet\deploy\website。
pnpm install
pnpm package:plugin生成：
packages\sp-plugin\release\SPPet-SP-v0.14.0.zip
在 Super Productivity“设置 → 插件 → 选择插件文件”中导入。最低支持 SP 18.21.2。
插件内部仍使用旧 ID sp-gamification 和旧状态键，这是升级兼容措施，不是当前产品名称。修改它们会让 SP 将插件识别成全新插件，并失去对旧同步状态的直接访问。
开发启动：
pnpm dev:pet便携版：
pnpm package:pet解压 SPPet-v0.14.0-win-x64.zip，运行 SPPet.exe。桌宠默认只显示角色：
- 悬停：显示 Lv、XP、状态值、streak、金币。
- 左键：播放用户设置的互动台词。
- 长时间未互动：间歇播放闲置台词。
- 右键：显示菜单，再进入连接、皮肤、大小和置顶设置。
- 按住角色左键：拖动桌宠；松手后可按重力落到底部并吸附屏幕边缘，多显示器按鼠标所在屏幕约束。
- 右键设置可启用间歇行走，并导入、预览、切换或删除独立
manifest.json角色包。 - 每个角色拥有独立的状态、好感、情绪和 AI Prompt 数据；作息与主动行为默认不抢焦点，主动气泡默认关闭。
- 角色资源支持基础角色、服装、挂件、特效和天气五层组合，也可直接导入
.sppetpack。
自定义皮肤格式见 packages/desktop-pet/CUSTOM_SKINS.md。
- 右键桌宠可打开“AI 聊天”和“历史记录”；AI 默认关闭。
- 在桌宠设置的“AI 与御主档案”中配置 OpenAI-compatible HTTPS 接口、模型、角色性格/说话方式/世界观/关系，以及
profile.json档案字段。 - API Key 只保留在桌宠当前进程内，也可通过
SPPET_AI_API_KEY环境变量提供；不会写入配置文件。 - 修改角色 Prompt 会立即清空短期对话上下文，但保留本地历史；历史页删除会同步修改
%APPDATA%\SPPet\chat-history.json。 - “当前窗口读取”和“主动屏幕分析”是两项独立权限，均默认关闭。前者只在用户点击时读取进程名/标题；后者只在点击“看看我的屏幕”时截取并压缩当前显示器一次，分析后不保存图片。
- 右键“专注计时”可设置 5–120 分钟，以及用户自己的工作/娱乐/游戏关键词。启用窗口读取权限后，专注期间每 10 秒只在本地分类并提醒偏离；完成奖励每日最多 4 次，同一 session 只结算一次。
- 右键“个人计划”可分别启用课程表、日记、长期目标和重要日子。四个模块默认关闭且不影响桌宠基础运行；日记只有在单独授权并主动点击后才会交给 AI。
- “历史与记忆”可独立开启长期记忆；对话摘要和本地 embedding 保存在
%APPDATA%\SPPet\memories.db，新对话只检索相关记忆。关闭不会删除数据，逐条删除和清空会真实修改 SQLite。 - “观察日记”保留最近 30 天的六类结构化本地事件，只有点击“生成今日观察日记”才会把当天摘要交给 AI。
- TTS 默认 disabled，可切换 localhost 的 local Provider 或 HTTPS remote Provider。朗读时根据音频振幅驱动开/闭嘴两态；TTS API Key 只保留在当前进程内。
- SP 任务和专注只推进每日委托；完成委托获得经验。
- 签到、升级和战斗获得金币；连续签到奖励逐日提高，7 天封顶。
- 升级提高最大 HP、攻击和防御。
- 桌宠每连续断连一段可配置时间会降低状态值；每漏登 1 天额外降低 10 状态，状态不足时剩余惩罚按 1:1 扣 HP；同一天不会重复扣除。
- 初始解锁战术打击、防御架势、火花射击和潮汐斩，可在非战斗状态自行组合最多 4 个已学习技能。每回合有固定 5 点资源，可连续使用多个技能；点击“结束回合”后才结算灼烧与敌方行动，下一回合资源恢复至 5。
- 技能包含物理、火、水、冰、电伤害，并可提供护盾、治疗、灼烧和削弱。
- 火克冰、冰克电、电克水、水克火：命中克制目标为
×1.5；同属性元素护盾为×0.5，其他情况为×1。物理固定为×1，不参与元素交互。 - 抗性字段仅为旧存档兼容保留，不参与战斗。界面只向玩家展示“技能伤害 × 属性效果 − 防御；护盾先抵扣伤害”，并直接在技能上给出本次伤害数值。
- 武器、护甲、饰品提供属性与元素加成；同套装备可触发额外效果。
- 每章使用简化分叉路线：普通层在战斗与补给之间二选一，选择后另一节点失效；末层必须挑战 Boss。敌方下一行动以“意图”显示。
- 每场战斗包含可跳过的战前/战后剧情；战后奖励只结算一次，剧情结束才推进关卡。
- 招募券来自五日周委托、每七日签到、Boss 和长期目标；无付费入口，十次内必得稀有收藏，奖池不以纯数值装备为主。
底栏固定为三项：
- 概览：等级、委托、签到和汇总状态。
- 冒险：在“养成 / 战斗”子页中管理宠物、商店和台词，或通过章节小地图领取补给、进入剧情与回合制战斗。
- 设置：语言、提醒、委托数值、断连衰减、连接测试、导入导出和网站链接。
排行榜不在插件中渲染；同步默认关闭，用户可在设置中主动启用，再通过超链接打开网站。
在线服务集中在 https://sppet.scsldr.cn/api/v1。启用排行榜后只上传公开昵称、等级、XP、连续天数、专注分钟、委托分和战斗分；任务名称、日记、对话、屏幕内容和真实姓名不会上传。在线内容会缓存到插件同步存储，断网时继续使用最近成功版本。设置页可检查更新、查看日志并下载 ZIP，再在本地完成 SHA-256 校验；安装仍按 SP 官方流程由用户手动选择 ZIP。
SP Plugin → ws://127.0.0.1:47821 → SPPet → JSON
数据位置：
%APPDATA%\SPPet\state.json
%APPDATA%\SPPet\events.json
%APPDATA%\SPPet\pet-cursor.json
%APPDATA%\SPPet\pet-settings.json
%APPDATA%\SPPet\pet-profile.json
首次启动会从旧 %APPDATA%\sp-gamification 复制尚未存在的兼容文件。任务 ID、专注累计值和桌宠事件游标继续防止重复奖励/重复播报。
源码位于 packages\website，可双击 start-local.bat 启动；同步部署包位于 D:\temp\SPPet\deploy\website，包括：
/：公开排行榜。/tools.html：状态 JSON 本地导入/导出、战前/战后剧情编辑。/developer.html：道具、技能、怪物、Buff / Debuff、行动意图和奖励数值编辑。/login.html：SQLite 本地账号注册、登录和会话管理。server.mjs：无第三方依赖的 Node 服务；需要 Node.js 22.5 或更高版本。start-local.bat：配置本地注册环境并打开登录页。nginx-sppet.conf/nginx-location-snippet.conf：反向代理配置。
本地首次注册的账号自动成为管理员；公网部署也可以用 SPPET_ADMIN_USER、SPPET_ADMIN_PASSWORD 预置管理员。账号和会话存入 data\sppet.db。旧的 SPPET_ADMIN_KEY 发布方式仍兼容。插件从 https://sppet.scsldr.cn/api/content 获取内容，离线时继续使用内置目录。
pnpm test
pnpm build
pnpm package:all完整版本变化见 CHANGELOG.md。