Skip to content

dsh-thanks-carl

Verified

dsh-thanks-carl · v0.3.0 · MIT · Web UI

Local Carl companion for DSH: 12 AI sprite actions, pat reactions, focus timer, quick menu and reminders

Install

dsh plugin add dsh-thanks-carl

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

谢谢卡尔 · Thanks Carl

谢谢卡尔插件图标

npm license dsh

让卡尔陪你工作:会招手、被摸摸会害羞,有 12 种多帧动作;陪你专注 25 / 45 分钟,偶尔沿屏幕边缘挪一挪,也保留任务完成彩蛋和喝水、吃饭、休息提醒。

动作在本地播放,不用配置模型。AI 动作来自用户提供并审核的精灵表,不是原照片连拍;可在设置里关闭,恢复内置 Carl 原图。

卡尔 0.3.0 的摸摸回应、快捷菜单、专注计时和回小窝真实操作

7 秒真实操作演示:摸摸、招手、翻滚、动作菜单、开始专注、回小窝。使用隔离 DSH 实例录制,不是模拟界面。

功能

  • 12 种多帧动作:待机、招手、摸摸、害羞、瞌睡、庆祝、走路、翻滚、受惊、兴奋、炸毛、肚皮朝上。日常互动与提醒会联动常用动作;「动作彩蛋」里可以逐个手动播放,夸张动作不会无故打扰。
  • 摸摸卡尔:点一下或按 Enter/空格,它会回一句随机短话并做动作;快速连点四下会害羞,歇一会儿再摸。
  • 陪你专注:25 / 45 分钟,支持暂停、继续、结束;刷新页面或切会话不会重置,同一浏览器的标签页共用一个计时。到期邀请休息,不自动开始下一轮。
  • 就地小菜单:点击卡尔旁的「···」、右键或长按照片,可以标记「我喝过水了」、安静一小时、今天先休息或唤醒卡尔。喝水会从现在重新计时;今天休息到本地午夜。
  • 任务完成的彩蛋:一轮真的做完了,卡尔才有机会探头;默认 15% 概率、间隔至少 30 分钟。失败、取消、中断的轮次不会来道谢。
  • 两种模式:事件彩蛋(偶尔出现)或常驻桌宠(一直陪着你)。常驻模式可以关掉「完成彩蛋」只留桌宠。
  • 随时恢复原图:关闭「AI 多帧动作」后使用原版包浆图或同图清晰版。上传自己的照片会自动停用 AI 替换;恢复 Carl 原图后,才重新使用已开启的动作。系统要求减少动态效果时也只显示原图。
  • 本地提醒:喝水默认每 60 分钟,吃饭默认 12:00、18:00,工作间歇默认关;可以「稍后 10 分钟」。默认 00:00–08:00 勿扰。
  • 完全本地:不联网、不读聊天内容、不发消息、不调用模型;提示音默认关闭。

卡尔快捷菜单:专注、喝水、休息、活动方式与回小窝

收起、睡觉和活动

  • 关菜单不等于收起:菜单右上角 ×、点空白或 Esc 只关菜单,手动唤出的卡尔继续陪着你;气泡的 × 只关闭提示。
  • 回小窝:菜单里的「回小窝」让卡尔缩回边缘,只留一个小头像,点它再出来。不会停止专注计时或清除免扰;下一次正常到期的提醒仍可叫它出来。不想显示任何入口,关闭「启用卡尔」。手动召唤/回窝只作用于当前标签页,刷新后回到所选出现模式。
  • 可选边缘闲逛:菜单或设置里把「活动方式」从默认的「乖乖待着」切到「自己逛逛」。每隔 20–40 秒在停靠位置上下 48px 内慢慢挪几步,仅真正移动时播放走路动作;拖动时跟手,松手回边缘轻轻停稳。关闭 AI 动作后仍可用原照片轻移。

菜单、提示气泡打开,鼠标/键盘正在操作卡尔,专注、睡觉、勿扰时段、页面后台或系统要求减少动态效果时,都暂停闲逛。免扰只抑制自动提醒和完成彩蛋,手动互动仍可用。专注结束后若已离开超过两分钟,只保留完成状态,不补弹气泡;关闭页面期间不会发系统通知。

安装与更新

在 DSH 的插件市场里安装「谢谢卡尔」,或用命令行安装 / 更新到当前正式版本:

dsh plugin --profile web add [email protected]

装好后重启一次 dsh web,再刷新页面。已有安装也可以在插件市场里更新;插件列表里的名字会跟随界面语言显示为「谢谢卡尔」或「Thanks Carl」。本地链接开发安装与市场安装不同,不需要覆盖你的开发链接。

这里的 0.3.0 是卡尔插件版本;支持的 DSH 仍为 >=0.2.1-0 <0.3.0-0(Web GUI),不是 DSH 0.3。页面需在 https 或 localhost 下打开;浏览器过旧或被禁用本地存储时会自动停用,不影响 DSH 本身。

使用

侧边栏「插件」→「已安装插件」→ dsh-thanks-carl → 页面底部的「插件设置」。设置改完立即生效,只存在你当前浏览器里。

插件设置

设置 说明
模式 事件彩蛋 / 常驻桌宠
活动方式 默认乖乖待着,可选自己逛逛
AI 多帧动作 默认开;关闭恢复原图,自定义照片或减少动态效果时不播放
本轮完成彩蛋 任务完成后允许卡尔出现
任务完成必出现 勾上则每轮都来;不勾按概率和间隔出现
出现概率 / 彩蛋间隔 默认 0.15 / 30 分钟
画质 包浆版本 / 同图相对清晰版本
大小、停靠边缘 76–128 px,贴左或贴右
轻提示音 默认关
喝水提醒 / 每隔多少分钟 默认开,60 分钟
吃饭提醒 / 吃饭时刻 默认 12:00、18:00
工作间歇提醒 / 工作间歇 默认关
勿扰时段 默认 00:00–08:00

「召唤卡尔」立即让卡尔出现;下方的预览按钮可以分别看完成彩蛋、喝水、吃饭、休息长什么样。气泡上的「稍后 10 分钟」只对提醒有效。

专注计时:卡尔安静陪伴,支持暂停和结束

把卡尔拖到屏幕另一侧就会换边停靠;手机上可长按打开菜单,菜单限高,保持在屏幕内。

隐私

  • 不联网、无遥测、不读对话正文,只判断「这一轮是否正常结束」。
  • 设置和上传的图片都保存在你当前浏览器里(localStorage),不跨设备同步。
  • 不申请系统通知权限,不采集任何统计。

兼容性与限制

  • DeepSeek Harness >=0.2.1-0 <0.3.0-0(Web GUI),Node.js >=22.12。
  • 需要支持 Web Locks 的现代浏览器(Chrome / Edge / Firefox / Safari 近期版本)。
  • 页面要开着才可能提醒;关掉浏览器就不会响,也不会弹系统通知。
  • 后台标签页或电脑睡眠期间错过的提醒不会补发。
  • 同一浏览器多标签页会去重,只出现一次;换浏览器或换端口就是另一份设置。
  • 只在当前会话视图里生效,切换会话或刷新不补播。

卸载

pwsh -File scripts/uninstall.ps1 -Profile web

也可以先到设置里关掉「启用卡尔」临时隐藏。卸载只移除本地链接和挂载,不删你的源码;设置项可以在浏览器开发者工具里删掉本站的 thanks-carl.* 记录。

开发

npm ci
npm run check        # 构建 + 单测 + 包边界
pwsh -File scripts/test-install.ps1

想跑真实浏览器里的完整验收,见验收记录里的隔离实例步骤(测试端口 3345,不碰正在用的 3333)。

相关插件

同样是本地小工具,做完这一只之后顺手写的:

致谢与声明

内置照片是公开流传的 Carl the Hedgehog 梗图(原始照片为 Pixabay 用户 amayaeguizabal 于 2014 年上传),按原样随插件提供,仅用于这个插件的个人、非商业用途;如权利人提出异议会移除。出处与核实记录见技术决策与素材出处。

License

代码为 MIT。内置照片及基于它制作的 AI 动作不因此获得额外肖像或素材授权,仅随本插件用于个人、非商业用途;AI 动作来源与处理方式见动作素材说明。


English

A quiet, local Carl companion for DeepSeek Harness: pat reactions, a shared 25/45-minute focus timer, a quick menu, optional edge wandering, completion easter eggs and water/meal/break reminders.

  • Twelve user-approved AI sprite actions: idle, wave, petted, shy, sleepy, celebrate, walk, roll, fear, excited, bristle and belly-up. Common actions follow local events; dramatic ones are manual menu easter eggs. These are AI-derived frames, not a photographic sequence.
  • Pat with a click, Enter or Space; four rapid pats make Carl shy. Turn off AI actions to restore the original photo; custom photos and reduced motion always use the original/static image.
  • Focus supports pause/resume/end and persists across reloads and tabs. No automatic next round.
  • Close only the menu with ×, outside click or Escape; “回小窝” leaves a small avatar without ending focus or quiet time.
  • Wandering is off by default and pauses during interaction, focus, quiet hours, background use or reduced motion. Drag follows the pointer and docks gently. The walking sprite plays only during movement; AI-off mode retains gentle original-photo movement.
  • Completion easter eggs default to 15% with a 30-minute cooldown; failed/cancelled/interrupted turns are never congratulated.
  • Local reminders: water every 60 minutes, meals at 12:00/18:00, breaks off, quiet hours 00:00–08:00, snooze 10 minutes.
  • No network, telemetry, chat reading or model calls. Closed pages do not send system notifications.
dsh plugin --profile web add [email protected]

Restart dsh web once, then reload. Settings: Plugins → Installed → dsh-thanks-carl → Plugin settings. Plugin 0.3.0 still requires DSH 0.2.1+ (<0.3) and Node 22.12+. The 7-second GIF shows actual 0.3.0 interactions in an isolated DSH instance. MIT for code; the Carl photo is provided for personal, non-commercial use with this plugin only.

Related local plugins: dsh-cost-voice (per-turn spend voice announcements) and dsh-novel-fish (read local novels under the chat without sending them to the model).