猫咪主题工坊luoyan96/dsh-catnap-studio

猫咪主题工坊 · Catnap Studio

面向 DeepSeek Harness Web UI 的猫咪工作台插件。它保留成熟 DSH Web UI 的任务、仓库、文件、统计与设置能力，再用一套原创猫咪视觉层统一界面；一个安装包内置三套完整外观和一只可互动的桌面猫咪。

社区项目，基于 DeepSeek Harness 构建，不是 DeepSeek 官方产品，也不代表其背书。

当前发布线：Catnap Studio v0.3.3。Windows 用户若希望免除 Node 与 DSH CLI 配置，可使用配套的 Catnap Desktop（发布后可用）。

| 暖纸猫窝 | 月夜守护 | 猫咪工坊 |
| --- | --- | --- |
| 暖纸猫窝 | 月夜守护 | 猫咪工坊 |

三套主题

- 暖纸猫窝：奶油纸张、杏橙控件和趴在输入框旁的橘猫。
- 月夜守护：深靛夜色、金色星点、守夜黑猫和提灯睡猫。
- 猫咪工坊：再生纸、蓝红标记、协作便笺和探头的奶牛猫。

所有猫咪插画与纸张纹理均打包进浏览器 bundle，插件运行时不会请求外部图片。主题本身不触及模型请求。

工作台能力

- 设置内主题切换：在「设置 → 通用设置 → 外观」里使用三张大卡片切换主题；设置打开时桌面猫咪会自动收起，关闭后恢复。
- 猫窝中心：管理猫咪伙伴并查看已启用能力。
- 猫咪伙伴：支持拖动位置、摸猫、喂小鱼干、改名、隐藏/召回；好感度和位置保存在浏览器本地。
- 任务看板：按状态组织任务、打开详情并支持定时执行。
- Git 图谱与文件面板（回退）：未安装 Better Sidebar 时，保留 Catnap 内嵌的旧工作台模块。
- Better Sidebar 工作台（可选）：安装后提供文件树、编辑器、真实终端、Git diff、可拆分右栏/底栏与按会话布局；Catnap 自动停用旧 Aion 文件面板和旧 Git 图谱客户端，避免双侧栏。
- 实时统计：查看 TPS、上下文、缓存和令牌用量。
- 插件设置：在 DSH 设置中心统一管理工作台功能。

任务、回退工作台、实时统计和设置能力由 @linxin666/dsh-web-ui 系列公开包的 0.1.12 编译代码组合而成；Catnap Studio 不复制原项目的人物或背景素材。Better Sidebar 是独立的 MIT 许可插件，Catnap 仅通过 DSH 模块系统检测和适配其 token，不包含其终端、文件系统、WebSocket 或 node-pty 代码。第三方声明见 THIRD_PARTY_NOTICES.md。

环境要求

- Node.js ^22.19.0 或 >=24
- pnpm 11.21.0
- DeepSeek Harness Web UI

如果 PowerShell 提示“无法将 dsh 识别为 cmdlet”，先安装 CLI，再重开一个 PowerShell 窗口：

npm.cmd install -g @deepseek-ai/dsh
dsh --version

一行安装

DSH 会自动下载插件和内置的猫咪素材：

dsh plugin --profile web add dsh-catnap-plugins@latest
dsh web

安装或升级后都需要重启 dsh web。

可选：Better Sidebar 工作台

dsh plugin --profile web add dsh-better-sidebar@latest

安装后硬刷新浏览器；Catnap 会自动避免双侧栏，并将三套主题 token 应用于 Better Sidebar。它是独立插件，终端等宿主能力由 Better Sidebar 自行提供。

GitHub Release 安装（当前可用）

1. 从 Releases 下载与版本匹配的 .tgz。
2. 在 PowerShell 中安装插件：

dsh plugin --profile web add "C:\path\to\dsh-catnap-plugins-0.3.2.tgz"

3. 启动或重启 DSH Web UI：

dsh web

卸载：

dsh plugin --profile web remove dsh-catnap-plugins

从源码安装

git clone https://github.com/luoyan96/dsh-catnap-studio.git
cd dsh-catnap-studio
pnpm install
pnpm run ci
dsh plugin --profile web add link:$(pwd)
dsh web

Windows PowerShell 可将最后两步改为：

dsh plugin --profile web add "link:$($PWD.Path)"
dsh web

如果之前装过整合包，建议先移除它，避免同一批功能插件被重复注册：

dsh plugin --profile web remove @linxin666/dsh-web-ui-all

发布到 npm

发布流程、npm Trusted Publishing 设置和首次包名认领见 docs/NPM_PUBLISHING.md。只有后续创建与 package.json 版本匹配的新 tag 时，GitHub Actions 才会同时发布 npm 包和 GitHub Release。

使用 Release 安装包

推送与 package.json 匹配的标签（例如 v0.3.2）后，Release 工作流会运行验证并上传 dsh-catnap-plugins-0.3.2.tgz 与 CHECKSUMS.txt。请在安装前核对 SHA-256。

开发

sh
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run pack:check

打开本地预览：
sh
python -m http.server 4173

然后访问 http://127.0.0.1:4173/preview/index.html?theme=warm。查询参数 theme 支持 warm、moonlit、atelier；猫咪工坊的活跃会话示例可追加 &state=active。

仓库结构
text
.github/workflows/   持续集成与标签发布
design/              参考稿、可复现素材母版和运行时图片
design-qa/           同尺寸视觉对照证据
preview/             可直接打开的主题预览与仓库截图
scripts/             素材压缩、嵌入和视觉对照脚本
src/                 DSH 插件源码
tests/               生命周期与主题切换测试

真实 DSH 页面验收截图位于 docs/qa/；主题和组件约束见 DESIGN.md，视觉验收记录见 design-qa.md，参与开发见 CONTRIBUTING.md，安全问题请遵循 SECURITY.md。

许可证

Catnap Studio 自有代码与素材采用 BSD-3-Clause。内嵌 UI 模块的 npm 清单声明 Apache-2.0，其 tarball 同时携带 BSD-3-Clause 文本；本仓库保留两者，详见 THIRD_PARTY_NOTICES.md。