starsstreaming/beautiCode
面向 AI 编程客户端的动态、可响应环境——视频背景、氛围场景与主题,适用于 DeepSeek Harness 与 Codex Desktop。
项目介绍Project Overview
beautiCode 是一款面向 DeepSeek Harness 与 Codex Desktop 的本地背景皮肤插件,可将图片、动态壁纸或 MP4 视频设为网页与桌面的背景,适合长时间编码或研究时希望把个人画面带入工作流的用户。核心能力是在不干扰代码、输入框与按钮使用的前提下,让画面安静地停留在对话与工作区后方,并支持侧栏「背景」、/bg 等命令与托盘控制。需注意它不安装也不启动 DSH,Windows 安装包尚未做商业代码签名。
beautiCode is a local background skin for DeepSeek Harness and Codex Desktop that sets images, dynamic wallpapers, or MP4 videos behind the coding or research interface, suited for long sessions where users want personal scenery during work. It renders visuals behind chats and workspaces without disrupting code, inputs, or buttons, and exposes control via the sidebar Background entry, /bg commands, and a tray. Note that it does not install or launch DSH itself, and the Windows installer lacks commercial code signing, so SmartScreen warnings may appear.
请帮我了解并安装插件:【beautiCode】【https://github.com/starsstreaming/beautiCode】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh
把 starsstreaming/beautiCode 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
beautiCode
把你喜欢的画面,放进 vibe coding 的每一分钟。
为 DeepSeek Harness 添加图片与视频背景,也支持 Codex Desktop。
可以是一张壁纸,也可以是一部番剧、一个壁纸,或者一段陪你度过漫长工作的风景。
它是什么?
beautiCode 是一个本地背景工具,主要面向 DeepSeek Harness和Codex。
它不包含、不安装、也不启动 DSH。请先自行安装 DeepSeek Harness 并运行 dsh web。插件装好后,DSH 侧栏「设置」上方会出现「背景」,不必再开托盘。Codex Desktop 仍走 beautiCode 托盘。可以把电脑里的:
- 图片
- 动态壁纸
- MP4 视频
- 番剧
直接设成 DeepSeek Harness 网页背后的背景。
它不会把工作窗口变成一个播放器,而是让画面安静地待在对话和工作区后面。
代码、输入框和按钮仍然可以正常使用。
使用方式
一键安装插件(推荐)
只要给 DeepSeek Harness 加背景,装插件即可,不必 fork 仓库、不必下 Windows 安装包,也不必开托盘。请先自己装好 DSH 和 Node.js。
npx beauticode-dsh
npx beauticode-dsh 会从 npm 下载插件并写入你的 DSH profile,不需要 pnpm,也不需要再执行 dsh plugin add。已把 dsh 装到 PATH 时,第二行也可以写成 dsh web。
打开网页后,侧栏「设置」上方有「背景」:可从文件夹选图片或 MP4、清除、开关声音、切换已保存主题。已保存主题里自带「画窗」。网页控制台没有摸鱼。外观浅色/深色仍用 DSH 自己的设置。下次启动会恢复上次背景。
也可以用 /bg、/bg-theme、/bg-clear,或直接跟 AI 说把本机图片/视频设成背景。
已有 pnpm 时,也可以让 DSH 自己装这个 npm 包:
npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh
npx @deepseek-ai/dsh web
卸载:
npx beauticode-dsh --remove
Windows 安装包
需要 Codex Desktop、系统托盘或懒得留源码时,再下 Windows 安装包。
然后自己启动:
dsh web
# 未把 dsh 装到 PATH 时:
npx @deepseek-ai/dsh web
安装包自带 Node.js,不需要另外安装 Node.js、npm 或 pnpm。安装结束时会自动写入 DSH 插件。若你改过安装目录,以安装文件夹里的 集成说明.txt 为准。
自己启动 dsh web 后,侧栏「背景」即可使用。Codex Desktop 仍要开 beautiCode 托盘:选 Codex Desktop 会按需拉起 Codex;选 DeepSeek Harness 只连接你已经启动的 DSH 网页,不会替你启动 DSH。
若自动写入失败,把路径换成实际安装目录(默认是 %LOCALAPPDATA%\Programs\beautiCode):
dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness
npx @deepseek-ai/dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness
之后在托盘里:
- 点「应用或重新应用」:DSH 路径只连接已启动的网页(网页关了会重新打开,DSH 没运行则提示你先
dsh web);Codex 路径与原来一样 - 更换图片或视频
- 清除背景、开关声音、摸鱼、保存和切换主题
退出托盘不会结束 DeepSeek Harness,避免打断正在进行的工作。
当前安装包尚未进行商业代码签名,Windows 可能显示 SmartScreen 提示。
用户导入的图片、视频和已保存主题位于
%LOCALAPPDATA%\beautiCode,卸载程序默认保留这些数据。
从源码运行
源码开发需要 Node.js 22 或更高版本。在项目目录执行:
npm install
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-dsh-plugin.ps1
npx @deepseek-ai/dsh web
# 托盘只在要用 Codex 或摸鱼热键时再开:
# npm run tray
或手动把本地插件目录加进 DSH(需要 pnpm):
npx @deepseek-ai/dsh plugin --profile web add file:%CD%/integrations/deepseek-harness
npx @deepseek-ai/dsh web
或打开宿主选择器:
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-beauticode.ps1
构建 Windows 安装包:
npm run installer:windows
输出位于:
artifacts\windows\installer\
通过托盘菜单可以:
- 更换图片
- 更换视频
- 清除背景
- 打开或关闭视频声音
- 进入摸鱼模式
- 保存当前主题
- 切换已保存主题
- 删除主题
当前支持情况
目前主要支持:
- Windows
- DeepSeek Harness(推荐)
- Codex Desktop
- JPG、JPEG、PNG、WebP 图片
- MP4 视频
关于本地视频
beautiCode 只读取你主动选择的本地图片和视频。
项目不会提供番剧、电影或其他受版权保护的内容。
请只导入你拥有或有权使用的媒体文件,并遵守当地法律与内容版权要求。
为什么叫 beautiCode?
因为代码工具不一定只能是冰冷、统一和毫无个性的。
有人喜欢极简黑色。
有人喜欢雨夜城市。
有人喜欢动漫。
有人喜欢在漫长的构建过程中,重新看一遍熟悉的电影。
工具应该帮助人完成工作。
但好的工具,也应该允许人把自己带进工作里。
我们每天花很多时间面对代码。 beautiCode 想做的,只是让这些时间更像生活,而不只是等待完成的任务。
致谢
beautiCode 的部分媒体处理思路与实现经验参考并改编自:
- Codex Dream Skin L站的支持: https://linux.do/ 画窗参考: https://github.com/Sui-IB/InternalBeyond 相关开源许可、代码来源和修改说明见:
THIRD_PARTY_NOTICES.md
beautiCode 是非官方项目,与 DeepSeek、OpenAI、Codex 或其他应用厂商没有隶属或合作关系。
DeepSeek Harness 的接入说明见 docs/deepseek-harness.md。
License
MIT
nexu-io/open-design
ruvnet/ruflo
esengine/DeepSeek-Reasonix
Molunerfinn/PicGo
titanwings/colleague-skill
Tencent/WeKnora
freestylefly/awesome-gpt-image-2