dsh-funpack

一句话定位

一个面向 DSH Web 的"娱乐合集"插件：在聊天输入框上方挂一排一键快捷命令，提供夸夸、运势、战报、番茄钟、摸鱼提醒、AI 人设切换、养成桌宠、美化主题、Live2D、Boss 隐身和代码花园等十几项休闲功能，让对话间隙变成可玩的小游戏。

核心能力

• 提供 /praise /fortune /report /season /break /pet /feed /hug 等闲聊/统计命令，并把互动次数记入战报和赛季积分
• 提供 /pomodoro [分钟] 番茄钟，默认 25 分钟，支持 1-120 区间，结束时自动累计专注分钟数；可通过 /pomodoro-status 查看剩余、/pomodoro-stop 中止
• 提供 /persona [key] 切换 AI 说话风格（默认 / 大姐姐 / 小妹妹 / 抽象搞怪 / 良子 / 峰哥），底层通过 ctx.systemPrompt.section 注入人格提示段，切换时自动释放上一段
• 提供 /break-go 一键跳转到摸鱼目标（网址或本地程序路径），由服务端调用 cmd.exe start 打开
• 客户端在 Web 输入框上方渲染一排快捷按钮（夸我 / 运势 / 战报 / 番茄 25 / 人设 / 摸鱼），并附带 🕶 Boss 隐身、🎨 美化、桌宠开关等额外按钮
• 网页右下角悬浮一只可养成桌宠，支持自定义形象/台词/互动键/好感度，内置"塔菲 Taffy"和"仙狐 Senko"两种预设，可选 Live2D 模型

技术实现

• 语言: JavaScript (ESM)
• 关键依赖: 零运行时依赖；服务端仅使用 Node.js 内置 node:fs/promises / node:url / node:child_process，客户端通过 window.__ModuleLoader__.load 注入 React 组件
• 架构模式: 单文件 Cordis bundle 插件；cordis.patch.yml 声明 id: funpack 的注入，package.json#dsh.bundle.patch 指定挂载 patch；服务端 index.js 通过 ctx.commands.register 注册 13 个 slash 命令、通过 ctx.webServer.register 注册塔菲宠物资源路由、通过 ctx.systemPrompt.section 注入人设；客户端 client.js 走 DSH 浏览器插件运行时加载
• 入口文件: index.js（服务端）+ client.js（浏览器端，含美化面板、桌宠、代码花园等 UI）

适用场景

想在使用 DSH 时给聊天加点"小确幸"的人——比如开始工作前抽一张运势、专注写代码时开番茄钟顺便种棵树、被需求折磨时让桌宠撒个娇。适合需要把"摸鱼"做成可视化、可分享的休闲玩家；不适合追求极致简洁或只要纯对话功能的用户。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:lvyuchuiyi/dsh-funpack

配置项

所有上述设置都保存在浏览器 localStorage，插件无独立的配置文件、环境变量或 DSH 配置项。

常见问题

Q: 这个插件是干嘛的？

A: 在 DSH Web 输入框上方放一排一键按钮（夸夸、运势、战报、番茄钟、人设、摸鱼等），并附带可养成桌宠、美化主题、Live2D、Boss 隐身、代码花园等十几项休闲功能，让对话间隙不那么单调。

Q: 安装后还需要额外配置吗？

A: 不需要。安装命令即可使用，所有个性化设置（桌宠形象、美化主题、好感度、成就等）都通过浏览器面板在运行时调整，状态写入 localStorage，无需额外环境变量或配置文件。

Q: 在 macOS 或 Linux 上能用吗？

A: 客户端绝大多数功能跨平台可用，包括桌宠、美化、Live2D、代码花园、成就、赛季等。但 /break-go 命令在服务端直接调用 cmd.exe start 来打开链接，仅在 Windows 上有效；macOS/Linux 上该命令会执行失败，控制台会打印错误。

Q: 战报、赛季、成就的数据保存在哪里？刷新会丢吗？

A: 客户端的成就、桌宠好感、代码花园、桌宠配置保存在浏览器 localStorage，刷新后继续累计。但服务端 /praise /fortune /pomodoro /season 等命令产生的统计数据只保存在内存中的 Map 里，重启 DSH 服务后会清零。

Q: 怎么切换 AI 的说话风格？

A: 在对话里输入 /persona nee（大姐姐）、/persona imouto（小妹妹）、/persona abstract（抽象搞怪）、/persona liangzi（良子）、/persona fengge（峰哥）或 /persona default（恢复默认）。不带参数则列出当前人设和可选项。

Q: Live2D 模型需要联网吗？

A: 需要。Live2D 首次使用会从 CDN 拉取 PIXI + Live2D 运行时；模型文件则从你填写的 .model3.json 链接加载（仙狐 Senko 来自社区 Live2D model collection）。如果加载失败，桌宠会自动回退到原 GIF 形象并显示错误信息。

Q: 和官方 DeepSeek Harness 的功能冲突吗？

A: 不冲突。插件以 Cordis bundle 形式挂在 web profile 下，只新增命令、systemPrompt 段和静态资源路由，不修改 DSH 核心代码。/persona 通过 ctx.systemPrompt.section 注入人格提示词，每次切换会先释放上一段，因此可以反复切换而不会累积。

Q: 怎么卸载？

A: 通过 DSH 自身的插件移除命令即可（具体命令随 DSH 版本而定）。插件无独立外部进程、无后台服务、无配置文件，卸载后浏览器 localStorage 里以 dsh-funpack- 开头的键可以手动清理。

上手难度

入门 — 一条安装命令即可使用，最常用的功能都是"点按钮"或"输入一行命令"，所有个性化都走图形面板，无需阅读文档或编辑配置。

已知问题与限制

• /break-go 命令硬编码 Windows 的 cmd.exe /c start 来打开链接（index.js:292），在 macOS/Linux 上调用 execFile 会失败，控制台只打印 [break-go error]，UI 上看不到原因
• 服务端 /praise /fortune /pomodoro /report /season 等命令的统计数据全部保存在内存 Map（index.js:108），重启 DSH 服务进程后清零，不会跨会话累积
• 番茄钟默认上限 120 分钟（index.js:191 的 Math.min(120, ...)），无法跨日切分；中途停止不会计入完成数（index.js:163-166 仅在定时器到期时累计）
• 桌宠、成就、代码花园等客户端数据依赖浏览器 localStorage，换浏览器或清缓存会丢失，且不支持跨设备同步
• Live2D 模型首次加载依赖外网 CDN（PIXI + Live2D runtime）与 .model3.json 链接，离线环境只能使用 GIF 桌宠

一个把夸夸、运势、战报、番茄钟、摸鱼提醒、沉浸氛围、成就赛季、桌宠语音、Live2D、Boss 隐身和代码花园集成在一起的轻量 DeepSeek Harness 插件。

仓库：https://github.com/lvyuchuiyi/dsh-funpack

特点：

• 单文件 index.js，零依赖、零构建
• Web UI 输入框上方提供一键命令按钮，点击直接执行
• 网页右下角有一只 DeepSeek 娘风格的鲸鱼娘桌宠，支持完全自定义形象、台词和互动键
• Web Audio 实时合成环境音，不需要任何音频文件
• 成就 / 赛季 / 赛季卡，把摸鱼玩成养成游戏
• Fun 资产市场，支持内置资产包与 dsh-plugin 社区仓库扫描
• 桌宠语音、Live2D 模型、Boss 隐身、番茄种树
• 安装不需要任何构建授权
• 所有统计按会话记录，/report 生成一张摸鱼战报

安装

从 GitHub 安装：

dsh plugin --profile web add github:lvyuchuiyi/dsh-funpack

本地目录安装：

dsh plugin --profile web add ./dsh-funpack

不安装、直接调试单个文件时，可以用 --patch 挂载一个临时 overlay：

- insert:
    - id: funpack-local
      name: 'file:///绝对路径/dsh-funpack/index.js'

命令

人设

/persona 可以切换 AI 的说话风格：

桌宠自定义

点击桌宠旁的 ⚙ 打开设置面板：

• 形象：上传 GIF/PNG/WebP，或使用默认鲸鱼娘；支持动态和静态图片
• 宠物包：上传 pet.json + spritesheet.webp/png，直接加载 HatchPet/Codex 宠物包生态的现成动态宠物
• 内置预设：一键加载社区 Codex 宠物“塔菲 / Taffy”，或热门狐娘 Live2D“仙狐 / Senko”
• 设置面板按「形象 / 台词 / 语音 / 好感」分页，切换快捷、不再一长串挤在一起
• 空闲台词：每行一条，用户空闲时由桌宠随机轮播
• 思考台词：每行一条，DeepSeek 思考时切换
• 互动键：每行一个 名称,命令，点击直接执行
• 显示开关：快捷按钮行里的 桌宠开 / 桌宠关 可以随时隐藏或唤回桌宠

位置和大小通过拖拽/-/+ 调整，所有设置都会保存在浏览器本地。

内置塔菲预设

桌宠设置面板里点 预设：塔菲 / Taffy，就会加载社区 Codex 宠物 Taffy / 塔菲 的完整图集动画。资源随插件打包， 离线也能用；切换时会顺带换成塔菲风格的空闲/思考台词，之后仍可继续自定义。

内置仙狐预设

桌宠设置面板或资产市场点 预设：仙狐 / Senko，会从社区 Live2D model collection 直连加载热门狐娘模型，并自动切换成仙狐风格的空闲/思考台词。模型需要联网加载。

桌宠养成

桌宠现在有真实好感度了：

• 摸头、喂食、抱抱和完成任务都会增加好感
• 好感达到 Lv.2 会解锁“抱抱”互动，更高等级会解锁专属台词
• 任务完成时桌宠会弹出庆祝气泡并奖励好感
• 设置面板可以查看摸头/喂食/抱抱/任务统计，也可以一键重置好感

好感数据保存在浏览器本地，刷新后继续累积。

美化面板

快捷按钮行末尾的 🎨 美化 会打开一个类似 Dev-C++ 美化器的实时预览面板：

• 主题：深空 / 樱花 / 薄荷 / 终端 / 纸白
• 背景图片：上传 GIF / PNG / WebP，支持拉伸、填充、居中、平铺
• 背景透明度与暗色蒙层：让图片融入界面而不是盖住文字
• 背景模糊、输入区毛玻璃、聊天区/全屏范围：让背景更像一层氛围壁纸
• 动态特效：星空 / 雨滴 / 樱花 / 极光
• 弹幕：夸我 / 运势以弹幕展示，可换样式、速度、大小、透明度，支持一键试看
• 按钮缩放与对齐：快捷按钮可以放大缩小，也可靠左 / 居中 / 靠右
• 快捷按钮模块：每个按钮可单独开关，用 ↑ / ↓ 调整顺序
• 摸鱼按钮：自定义跳转网址或启动本地程序，网址直接在浏览器打开，留空则显示普通摸鱼提醒
• 配置分享：一键导出美化与桌宠配置 JSON，别人导入后即可复用

所有美化设置会保存在浏览器本地，刷新后继续生效。

沉浸氛围

美化面板里的「沉浸氛围」可以用 Web Audio 实时合成环境音，不下载任何音频文件：

• 咖啡雨声：雨声 + 咖啡店暖噪 + 低音垫
• 机房白噪：风扇噪音 + 低频轰鸣
• 赛博脉冲：合成器脉冲 + 数字底噪
• Lo-Fi 节拍：慢速鼓点 + 温暖贝斯
• 音量可调；开启「番茄钟切雨声，摸鱼切 Lo-Fi」后，快捷按钮会自动联动

成就 / 赛季

🧩 Fun 中心里的 成就 / 赛季 会打开成就墙：

• 夸我、运势、战报、番茄钟、摸鱼、桌宠好感、完成任务、连续使用都会记入成就
• 赛季按季度结算积分，从「摸鱼青铜」一路升到「摸鱼王者」
• 解锁成就时会有弹幕庆祝
• 一键生成 SVG 赛季卡，可以直接分享给同样在摸鱼的朋友

成就数据保存在浏览器本地，刷新后继续累积。

Fun 资产市场

🧩 Fun 中心里的 资产市场 会打开资产市场：

• 内置宠物包：蓝鱼娘、塔菲
• 内置 Live2D 包：Haru 官方测试模型、仙狐 Senko（社区热门狐娘）
• 内置主题：深空、樱花、薄荷、终端、纸白
• 内置人设包：大姐姐、小妹妹、抽象搞怪
• 数据源：Oh-My-DSH 聚合目录（399+ 插件）或 GitHub dsh-plugin 主题
• 聚合目录可一键复制 dsh plugin --profile web add github:... 安装命令
• GitHub 数据源自动探测 dsh-assets.json / assets/dsh-assets.json
• 社区资产 manifest 支持 type: pet / theme / persona / live2d，探测到后可直接安装

桌宠语音

桌宠设置面板里可以开启语音：

• 默认使用浏览器 speechSynthesis，支持选择本机声线、语速和音调
• 也可以填本地 TTS API 地址，接口约定：POST JSON { text, voice }，返回音频流
• 点击桌宠、摸头 / 喂食 / 抱抱、解锁成就、代码树长大时都会开口

Live2D 娘化

桌宠设置面板支持填写 .model3.json 链接，或从资产市场一键安装 Haru / 仙狐 Senko：

• 首次使用会从 CDN 加载 PIXI + Live2D 运行库
• 支持 Cubism 2 和 Cubism 4 模型
• 加载失败不会影响原 GIF 桌宠，会显示错误信息并保留原形象

Boss 来了

快捷按钮行里的 🕶 Boss 会一键进入隐身模式：

• 隐藏桌宠、弹幕和 Fun 按钮，切换到终端主题
• 右下角出现一个假的「编译中 87%」面板，点击「恢复摸鱼」退出
• 美化面板可以填 Boss-Key 程序路径，开启时自动启动

代码花园

🧩 Fun 中心里的 代码花园 会打开花园：

• 完成番茄钟会种下一棵树，从 🌰 一路长到 🌳
• 中途停止番茄钟不会种树
• 花园会记录累计专注分钟数、今日种植次数和种植记录
• 种下第 1 棵和第 10 棵树会解锁对应成就

许可

MIT

素材致谢

桌宠 GIF 素材来自 @linxin666/dsh-pet（BSD-3-Clause，Copyright (c) 2026 zhu1090093659）。

塔菲 / Taffy 宠物包由 shengwen 创作，来自 codex-pet.org，仅作个人/爱好者用途随插件分发。

宠物包播放格式参照 HatchPet 的 Codex V2 Pet Contract（8 列 × 9/11 行图集）。