中文 · English · VS Code 安装 · Cursor / Kiro / Trae 安装 · 故障排查
Woodfish Theme 给代码文字加上渐变和发光,再加上彩虹光标和毛玻璃。自带 5 套 Woodfish 主题(每套都有手工调好的渐变),另附 10 套热门主题;换成别的颜色主题也能用,渐变会照着同样的规律自动算出来。VS Code、Cursor、Kiro、Windsurf、Trae、VSCodium 都能用。
本页图片都由扩展实际的渲染代码生成:代码图来自 render-readme-images.js,「效果一览」和热门主题来自 render-readme-effects.js(和宣传片同一套逐帧渲染,动图是 WebP);只有 Codex 设置页那张是真机截图。
效果预览
五套内置主题
Woodfish Dark:Bearded Theme Arc 的配色,渐变是 5.x 时手写的那一套。
Woodfish Dracula:Dracula 官方配色,关键字是粉到紫的渐变。
Woodfish Black:纯黑背景,适合 OLED 屏。
Woodfish Neon:深紫底的霓虹配色。
Woodfish Light:暖白底的浅色主题,渐变往深处走,发光是同色相的亮色。
十套热门主题
扩展还原样收录了 10 套热门的 MIT 许可主题,名字前加了 Woodfish,渐变和发光顺着各自的配色自动生成,效果开关同样适用(关掉就是纯配色):
![]() Woodfish One Dark Pro |
![]() Woodfish Tokyo Night |
![]() Woodfish Catppuccin Mocha |
![]() Woodfish Catppuccin Latte |
![]() Woodfish Nord |
![]() Woodfish GitHub Dark |
![]() Woodfish GitHub Light |
![]() Woodfish Night Owl |
![]() Woodfish Ayu Mirage |
![]() Woodfish Gruvbox Dark |
来源与许可见 THIRD_PARTY_NOTICES。
按 Ctrl+K Ctrl+T(macOS 为 Cmd+K Cmd+T)切换主题。
叠在任意主题上
不用内置主题也行。下面是 VS Code 自带的 Dark Modern,左边是原样,右边开了 Woodfish:渐变从每个词原来的颜色出发,沿色环转到更鲜艳的颜色,读起来不比原色费劲。
![]() |
![]() |
| Dark Modern 原样 | 开启 Woodfish |
效果一览
每个效果一张聚焦的图,会动的效果是动图。Codex 桌面版装好 Woodfish 后这些效果默认就开着(装法见下面的 Codex 桌面端,一句话就能让 AI 帮你装),在 Codex 的 设置 → 外观 → Woodfish 外观 里能逐个开关、调参数;只想改颜色、大小、速度,在效果文件夹(%APPDATA%\Woodfish\effects)的 user.css 里写一行变量就行,变量清单在同一文件夹的 README.md。
![]() |
彩虹回复字 · Codex 助手回复的正文是一条按当前主题调好的彩虹渐变。纯 CSS,流式输出和很长的对话都不多花一帧。 效果 rainbow-text;浓淡和方向:--woodfish-rainbow-text-strength、--woodfish-rainbow-text-angle |
![]() |
吐字光标、拖尾和淡入 · Codex AI 吐字时,末尾跟着一根彩虹光标,身后拖一段带子,新字轻轻淡入,还会迸出一点粒子。你打字和 AI 吐字触发的是同一套效果。 效果 stream-cursor、caret-trail、text-reveal;例如 --woodfish-caret-trail-color: #ff4d4f;、--woodfish-text-reveal-style: blur; |
![]() |
选中会话的光环 · Codex 侧栏里选中的会话外圈是一道慢慢转的七色光谱环,外面一圈柔光;正在运行的会话亮一圈弱一些的光。 效果 thread-ring;转一圈的秒数和光晕:--woodfish-thread-ring-turn-seconds、--woodfish-thread-ring-halo |
![]() |
毛玻璃浮层 · Codex 菜单、 / 命令、弹窗都是磨砂玻璃,弹出时淡入,后面的内容隐约透出来。VS Code 里的毛玻璃见下面的「毛玻璃」一节。效果 glass;模糊和不透明度:--woodfish-glass-blur、--woodfish-glass-opacity |
![]() ![]() |
窗口背景《彩云》 · Codex 与 VS Code 窗口底下铺一张图,侧栏和输入框是磨砂玻璃,文字照样清楚(上:关,下:开)。默认是《彩云》,也能换成你自己的图。 Codex:设置 → 外观 → Woodfish 里「上传图片」,或 woodfish codex background set <图片>;VS Code:运行「设置背景图片」。浓淡:--woodfish-background-opacity |
![]() |
输入框光标和光标拖尾 · Codex 输入框里是和 VS Code 一样的 6px 彩虹光标;光标一跳(Home、End、点击)就拖出一段带子,画法照 VS Code Animations 插件。 效果 caret、caret-trail;粗细、长度、颜色:--woodfish-caret-width、--woodfish-caret-trail-length、--woodfish-caret-trail-color |
![]() |
打字粒子 · Codex 与 VS Code 打字和 AI 吐字时,从光标处迸出一簇主题色的光点,没有震动和连击计数;吐字很快时自动限流。 效果 typing-particles;数量、大小、配色:--woodfish-typing-particles-count、--woodfish-typing-particles-size、--woodfish-typing-particles-colors: rainbow;(VS Code 里是 woodfishTheme.typingParticles.*) |
![]() |
一句话让 Codex 改效果 效果文件夹里有一份写给 AI 的 AGENTS.md:对 Codex 或 Claude 说“把打字粒子改成金色,再大一点”,它会找到对应的效果,先在 user.css 里改变量,必要时才改参数或代码,改完自动刷新。说明文件: %APPDATA%\Woodfish\effects\AGENTS.md |
![]() |
user.css 一行改样子每个效果参数都是一个 CSS 变量 --woodfish-<效果>-<参数>。写进效果文件夹的 user.css,保存一两秒就生效,升级不覆盖;画布上的拖尾和粒子也跟着变。图里是上一行那三行变量的结果。Codex 设置页有「打开 user.css」「恢复默认」;变量清单见效果文件夹的 README.md |
![]() |
Codex 设置页「Woodfish 外观」 设置 → 外观 里多出一节:深色、浅色各选一套主题(15 套,点一下整个界面就换色),每个效果一行开关,「参数」展开全部滑块和取色器,顶上有「刷新效果」「全部恢复默认」。 这一张是真机截图(Codex 26.1013,2026-11-14) |
![]() |
VS Code 里的同款 光标拖尾和打字粒子在 VS Code 里也有,默认关闭;和 Codex 共用同一个效果文件夹,改一次两边都变。 设置里打开 woodfishTheme.caretTrail.enabled、woodfishTheme.typingParticles.enabled |
7.2 有什么新东西
- 特调渐变回来了:
Woodfish Dark恢复 5.x 手写的那套颜色,Dracula、Black、Neon、Light也按同样的手法调了一遍。 - 其他主题的渐变更好看:自动计算改成照着特调的规律来,终点更鲜艳,普通文字是一条淡彩虹。
- 长名字、长段落不再断色:VS Code 会把超过 50 个字符的词拆成几段显示,以前每段各算一次渐变,所以每隔 50 个字颜色就从头开始(Markdown 里最明显)。现在整段是一条渐变:
and 那里又从粉色开始了一遍:
7.2,从头到尾是一条:
- 浅色主题的发光换成亮色:以前用文字本身的深色发光,看起来像一圈阴影。
7.0 的新功能
- 支持 Cursor、Kiro、Windsurf、Trae、VSCodium:同一个扩展,从各自的扩展面板(Open VSX)直接安装。
- 毛玻璃回来了:菜单、悬浮提示、补全列表、命令面板、通知等 12 类浮层,可选普通模糊或亚克力质感,带 Reveal 光效和入场动画;VS Code 1.143 起与原生毛玻璃协同。
- 系统级透明窗口(实验):macOS vibrancy、Windows 11 亚克力 / 云母。
- 三套新主题:
Woodfish Black(纯黑)、Woodfish Neon(霓虹)、Woodfish Light(浅色)。 - 效果预设和光标配色:6 套内置预设,可以保存自己的组合;8 套光标配色,也能自定义颜色。
- 卸载即还原:卸载扩展后自动清理所有注入,不会再出现“卸载了光标还在”。
- 出错时说人话:写入失败会按系统给出中文的处理办法;新增一键生成诊断信息,方便提 issue。
- 新手引导:首次安装后在“欢迎”页里一步步带你开启效果。
它提供什么
- 渐变语法:内置主题用特调,其他主题自动计算。运行时读取每个词的实际颜色,不依赖固定的
mtk编号。 - 发光:独立开关,强弱可调。深色主题用文字本身的颜色发光,浅色主题用同色相的亮色。
- 彩虹光标:颜色、循环速度、圆角、尾迹模糊和透明度都能调,8 套配色可选。
- 毛玻璃:12 类浮层,底色取自当前主题,不用改
workbench.colorCustomizations。 - 系统级透明窗口(实验):macOS vibrancy、Windows 11 亚克力 / 云母。
- 效果预设:6 套内置组合,也能把自己调好的参数存成预设。
- 安全恢复:写入前保存并校验备份,失败自动回滚;卸载后自动还原。
- 动效降级:遵循系统的“减少动态效果”“降低透明度”和
workbench.reduceMotion。 - 状态栏:显示
on / paused / off,用A / G / C / F标出正在生效的效果层。
发光
![]() |
![]() |
| 只开渐变 | 渐变 + 发光(默认强度) |
彩虹光标
光标的颜色会循环变化。下图是同一个光标在一个循环里的 6 个时刻:
三步开始
- 安装 Woodfish Theme:
Woodfish Theme(来自 Open VSX)。
- 让 AI 装:把这句话发给你的 AI:“运行 code --install-extension zhongjun.woodfish-theme 帮我装上 Woodfish Theme。”(Cursor 把 code 换成 cursor,其他编辑器同理)
- 选一个你喜欢的颜色主题,想要特调效果就选 Woodfish Dark / Dracula / Black / Neon / Light 这五套。
- 点右下角弹出的 重新加载窗口。
Woodfish ... 打开功能菜单,可以开关各项效果、选预设、开毛玻璃。
手动安装 VSIX
从 GitHub Release 8.2.2 下载 .vsix 后运行(Cursor 把 code 换成 cursor,其他编辑器同理):
code --install-extension woodfish-theme-8.2.2.vsix
支持的编辑器 / 工具
| 编辑器 | 基于 VS Code | 从哪里安装 | 实测 |
|---|---|---|---|
| VS Code | 1.74+ | VS Code Marketplace | ✅ 1.143 |
| Cursor | 1.128 | 扩展面板(Open VSX) | ✅ 3.27 |
| VSCodium | 1.143 | 扩展面板(Open VSX) | ✅ 1.143 |
| Kiro | 1.131 | 扩展面板(Open VSX) | 结构已核对 |
| Windsurf / Devin | 1.126 | 扩展面板(Open VSX) | 结构已核对 |
| Trae / Trae CN | 1.107 | 扩展面板(Open VSX) | 结构已核对 |
| Ghostty、Windows Terminal、bat、Yazi、Starship、lsd、zsh-syntax-highlighting | 不依赖 VS Code | 终端配色与安装说明 | 静态配色 |
| Neovim 0.12 | 不依赖 VS Code | woodfish.nvim(说明) | 15 套配色,无头加载 + 与 VS Code 逐字符比对 |
| JetBrains 系列 IDE(IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion 等,2024.2 起) | 不依赖 VS Code | 审核通过后(插件页,通过前不公开):设置 → 插件 → 市场,搜索 Woodfish Theme 安装。现在可用:从 GitHub Release 下载 woodfish-theme-jetbrains-8.2.2.zip,设置 → 插件 → 齿轮 → 从磁盘安装插件,选这个 zip。装好后到设置 → 外观与行为 → 外观里选 Woodfish 主题(说明) | 15 套配色,加可选的渐变与发光;IntelliJ IDEA 和 PyCharm 里与 VS Code 逐 token 比对(对照表) |
“结构已核对”表示已逐项检查过该编辑器安装包里的 workbench 路径、安全策略(CSP)、校验和与主进程格式,与实测通过的编辑器一致。提示信息会显示你正在用的编辑器名字,比如“请重新加载 Cursor”。Remote SSH、WSL 和开发容器里同样有效:Woodfish 始终运行在本地界面这一侧。
毛玻璃
运行 Woodfish Theme: 开启/关闭 Woodfish 毛玻璃,或在功能菜单里打开。
补全列表,毛玻璃透明度 0.5、模糊 14px
- 两种质感:
blur是普通模糊加噪点,开销最低;acrylic是 SVG 亚克力滤镜,质感更好。 - 作用范围:菜单、悬浮提示、补全列表、命令面板、通知、查找框、下拉框、面包屑、调试工具栏、粘性滚动、面板标题、对话框,可以在
woodfishTheme.glass.targets里逐项取舍。 - Reveal 光效:鼠标划过列表、按钮、标签页时跟随指针的柔光。
- 系统级透明窗口(实验):运行
开启/关闭系统级透明窗口(实验),让整个窗口透出桌面。它会在编辑器的out/main.js开头加一行受保护的加载语句,需要完全退出编辑器才会生效,编辑器更新后要重新开启。目前只支持 macOS 和 Windows 11。
窗口背景
运行 Woodfish Theme: 设置背景图片,选一张自己的图片(JPG、PNG 或 WebP),或者用默认背景《彩云》、彩云渐变。图片铺在窗口底下,编辑器直接透出背景,侧边栏和面板用毛玻璃叠在上面,文字始终清楚。
- 默认观感:背景图透出 15%,铺满居中;侧边栏和面板按 35% 的主题色叠在上面,模糊 10px、饱和度 150%,外加 10% 的亮度层。深色主题被压暗,浅色主题被提亮,颜色都跟着当前主题走。
- 可调项:
woodfishTheme.background.opacity(透明度)、woodfishTheme.background.blur(模糊)、woodfishTheme.background.mask(遮罩,越大越不透明),woodfishTheme.background.enabled开关。改完重新加载窗口。 - 图片放在哪:选中的图片会复制到 Woodfish 自己的存储目录,原图之后可以删除或移动。长边超过 2560 像素或体积超过 3 MB 的图片会先缩小并转成 WebP。
- 背景是窗口底下的一张静态图,滚动和输入时不做额外计算。
效果插件
光标拖尾、打字粒子是可插拔的效果插件,在设置的「效果插件」一节里打开(默认关闭):
- 光标拖尾
woodfishTheme.caretTrail.*:照抄 VS Code Animations 插件的画法,文字光标身后拖一条单色带子(默认白色,长度 12,可改成跟随主题)。 - 打字粒子
woodfishTheme.typingParticles.*:打字时从光标处迸出一簇主题色的光点,像 Power Mode,没有震动和连击计数。 - 每个效果是
%APPDATA%\Woodfish\effects(macOS 在~/Library/Application Support/Woodfish/effects)里的一个文件夹,effect.js就是实现,可以直接改,也可以让 AI 照文件夹里的AGENTS.md帮你改,或者新建一个效果。改了文件或设置会自动刷新,也可以运行Woodfish Theme: 刷新效果(Ctrl+Alt+R),不用重新加载窗口。同一个文件夹也给 Codex 用,改一次两边都变。只想换颜色、粗细、长度:在同一文件夹的user.css里写一行 CSS 变量,例如:root { --woodfish-caret-trail-color: #ff4d4f; },它最后加载、优先级最高,升级不覆盖;全部变量见文件夹里的README.md。 - 只在有效果要画时才逐帧绘制,窗口在后台或开了“减少动态效果”时暂停。
效果预设
运行 Woodfish Theme: 选择效果预设:
| 预设 | 说明 | |---|---| | Woodfish 默认 | 渐变 + 发光 + 彩色光标,所有参数恢复默认 | | 柔和护眼 | 更小的色相偏移、更弱的发光,适合长时间写代码 | | 霓虹全开 | 加粗、1.6 倍的大光晕、更快的光标,加上毛玻璃和 Reveal | | 怀旧(5.x) | 回到 5.x 的样子:代码加粗、和文字同色的大光晕(也可以在设置里把“代码效果风格”选成“怀旧”) | | 毛玻璃 | 默认代码效果 + 亚克力毛玻璃 | | 专注模式 | 只保留彩色光标,代码颜色交给主题 | | 性能优先 | 保留渐变,关掉发光、光标尾迹和毛玻璃 |
调好一套自己喜欢的参数后,运行 将当前效果保存为预设 就能随时切回来。光标颜色可以用 选择彩色光标配色 单独换:跟随主题、彩虹、Dracula、赛博朋克、极光、日落、樱花、单色白,或者输入自己的颜色。
效果层与状态
任意颜色主题
└── Woodfish 通用叠层
├── A 渐变语法
├── G 文字发光
├── C 彩虹光标
└── F 毛玻璃
| 状态栏 | 含义 |
| --- | --- |
| on | 叠层已开启,并检测到当前的注入内容 |
| paused | 效果开着,但注入内容缺失,通常运行一次“修复 Woodfish 注入”即可 |
| off | 叠层总开关关闭,或所有效果都关闭 |
| A / G / C / F | 渐变语法 / 文字发光 / 彩虹光标 / 毛玻璃已开启 |
[!IMPORTANT]
效果是通过修改编辑器自带的workbench.html实现的,切换效果后需要重新加载窗口。写入前会做校验后的原子替换,并保存带哈希、路径和版本信息的备份。编辑器更新会覆盖这个文件,效果消失时运行Woodfish Theme: 修复 Woodfish 注入。
常用命令
在命令面板(Ctrl+Shift+P)里搜索 Woodfish:
| 命令 | 用途 |
| --- | --- |
| 打开 Woodfish 功能菜单 | 按分组列出所有开关,状态栏入口也是它 |
| 开启 / 关闭 Woodfish 通用叠层 | 整体开关,关闭后保留参数 |
| 开启/关闭 Woodfish 彩色字体 | 切换渐变语法 |
| 开启/关闭 Woodfish 发光字体 | 切换文字发光 |
| 开启 Woodfish 彩色光标 / 开启/关闭彩色光标 | 启用并配置 / 快速切换彩虹光标 |
| 选择彩色光标配色 | 换光标颜色 |
| 开启/关闭 Woodfish 毛玻璃 | 切换浮层毛玻璃 |
| 开启/关闭系统级透明窗口(实验) | 让整个窗口透出桌面 |
| 选择效果预设 / 将当前效果保存为预设 | 一键切换 / 保存参数组合 |
| 打开 Woodfish 设置 | 跳到设置页 |
| 刷新效果(Ctrl+Alt+R) / 打开效果文件夹 | 重新加载效果插件(不重载窗口) / 打开效果文件夹 |
| 修复 Woodfish 注入 | 编辑器更新后效果消失时使用 |
| 生成 Woodfish 诊断信息 | 复制一份环境报告,提 issue 时直接粘贴 |
| 彻底停用 Woodfish 叠层 | 移除全部注入、备份和系统级窗口钩子 |
配置示例
所有设置都以 woodfishTheme. 开头,也可以运行 打开 Woodfish 设置 在图形界面里调:设置页分成“开关、彩色字体、发光字体、彩色光标、毛玻璃、透明窗口(实验)、高级”几组,所有效果开关都在最上面。下面是一组偏克制、带毛玻璃的配置:
{
"woodfishTheme.overlay.hueShift": 24,
"woodfishTheme.overlay.lightnessDelta": 0.08,
"woodfishTheme.glow.intensity": 0.8,
"woodfishTheme.cursor.animationDuration": 8,
"woodfishTheme.cursor.gradientStops": ["#ff2d95", "#ffd700", "#00ffff"],
"woodfishTheme.cursor.glowOpacity": 0.55,
"woodfishTheme.glass.enabled": true,
"woodfishTheme.glass.mode": "acrylic",
"woodfishTheme.glass.opacity": 0.75,
"woodfishTheme.glass.reveal": true
}
| 设置 | 范围 | 默认 | 作用 |
|---|---|---|---|
| overlay.hueShift | 0 - 180 度 | 32 | 渐变从原色沿色环转到终点的角度 |
| overlay.lightnessDelta | 0 - 0.5 | 0.12 | 渐变终点最多变亮或变暗多少 |
| overlay.neutralChroma | 0 - 0.4 | 0.075 | 普通文字上那条彩虹的浓淡 |
| overlay.angle | 0 - 360 度 | 45 | 渐变方向,45 是从左下到右上 |
| glow.intensity | 0.1 - 3 | 1 | 发光强度倍率 |
| cursor.animationDuration | 1 - 60 秒 | 8 | 光标颜色循环一圈的时间 |
overlay.*这四项只影响自动计算的渐变;内置主题的特调渐变自带颜色和方向。glass.blur/glass.saturate/glass.opacity/glass.noise:毛玻璃的模糊半径、饱和度、底色不透明度和颗粒强度。syntaxGradient.customRules、glow.customRules、cursor.customRules:在对应效果层之后追加自己的 CSS。
卸载与恢复
- 直接卸载就行:卸载扩展后,下次完全重启编辑器时会自动还原
workbench.html、校验和与系统级窗口钩子。 - 想立刻恢复原样:先运行
彻底停用 Woodfish 叠层再卸载。 - 用这个扩展给 Codex 开过 Woodfish:卸载扩展时一并撤下 Codex 里的效果、登录任务和开始菜单的“Woodfish Codex”,和
从 Codex 卸载 Woodfish一样。 - 效果文件夹:Woodfish 放进
%APPDATA%\Woodfish\effects的文件卸载时删掉,你自己写过或改过的留下(还装着woodfish命令行时整个保留)。Codex 的外观设置和上传的背景图也留在%APPDATA%\Woodfish,不需要的话直接删掉这个文件夹。 - 你的
settings.json不会被改动。 - Woodfish 只清理自己写入的内容,其他扩展的注入不会被改动。
排查问题
效果没有出现
确认右下角状态栏显示 Woodfish on,并且重新加载过窗口。显示 paused 时运行 修复 Woodfish 注入。
编辑器更新后效果消失
编辑器更新会覆盖 workbench.html,运行 修复 Woodfish 注入 后重新加载窗口。
提示“没有权限写入”
- macOS:如果是在终端里用
code .、cursor .启动的,macOS 会把写入算到终端头上。请完全退出编辑器,改从程序坞打开后运行修复 Woodfish 注入。仍然不行的话,到“系统设置 → 隐私与安全性 → App 管理”里允许这个编辑器。 - Windows:安装在
Program Files时,以管理员身份运行一次编辑器再修复,或者改用“用户安装版”。 - Linux:Snap、Flatpak 版的安装目录是只读的,无法注入,请改用官方
.deb、.rpm或.tar.gz。
提示“安装似乎损坏”
开启、修改或移除效果后,在完全退出编辑器之前这条提示会一直出现,重新加载窗口不会消失。完全退出再打开就好,这是编辑器只在启动时读取校验和导致的。
提 issue 前运行 生成 Woodfish 诊断信息,内容会复制到剪贴板,直接粘贴到 issue 里。更多排查步骤见 故障排查指南。
已知限制
- 小地图(minimap)没有渐变:小地图是 canvas 绘制的,CSS 改不了。
- 网页版和 Remote 服务器端:效果只能注入到桌面版编辑器的本地界面。
- JetBrains 系列(如 CLion):仓库里的 JetBrains 插件带 15 套配色和渐变与发光,审核通过后可在 IDE 的插件市场搜索 Woodfish Theme 安装,现在从 GitHub Release 下载 zip 安装(见上面的表);它是单独的 zip,不包含在 VSIX 中。另见 @yyyyolo7a79-sketch 的社区项目 Woodfish for JetBrains。
- Visual Studio:不是基于 VS Code 的,Woodfish 无法支持。
- 截图类扩展(如 CodeSnap):截图里不会带上 Woodfish 的效果。
Codex 桌面端
Woodfish 也能给 OpenAI Codex 桌面版换上同样的配色和效果:彩虹回复字、吐字光标和拖尾、选中会话的光环、毛玻璃、《彩云》背景(见上面的效果一览)。
支持 Windows 10 / 11 上的官方 ChatGPT(含 Codex):从 Microsoft Store、官网 Windows 安装器、winget install 9PLM9XGG6VKS -s msstore 或 官方离线 MSIX 安装均可。不支持 ChatGPT Classic、浏览器/PWA、Codex CLI 或未注册的解包版。
让 AI 帮你装:把这句话发给你正在用的 AI(Codex、Claude Code、Cursor……都行),它会装好 Woodfish,让效果在 Codex 重启、更新、重新开机之后一直都在;要你拍板的地方(同意调试端口的风险说明、重启 Codex)会停下来问你。
读 https://github.com/woodfishhhh/Woodfish-Theme/blob/main/docs/agent-install.md ,照里面的步骤帮我给 Codex 装上 Woodfish。
AI 打不开 GitHub 的话,把地址换成 https://cdn.jsdelivr.net/gh/woodfishhhh/Woodfish-Theme@main/docs/agent-install.md。
自己装,三步:
- 二选一:
Ctrl+Shift+P,运行 Woodfish Theme: 为 Codex 启用 Woodfish。
- 不用 VS Code:从 GitHub Release 下载 woodfish.exe,双击。它没有代码签名,Windows 提示“Windows 已保护你的电脑”时,点“更多信息”,再点“仍要运行”。
- 读一遍调试端口的风险说明,同意(exe 里输入
yes)。Codex 正开着的话,会先问你能不能重启它。 - Codex 带着效果重新打开。exe 最后问“登录 Windows 后自动恢复效果吗”时输入
y(VS Code 的启用命令会自己开好),以后 Codex 重启、更新、重新开机,效果都会自己回来。
- 换主题、开关效果:Codex 的 设置 → 外观 → Woodfish 外观。15 套主题点一下就换,每个效果一行开关,「参数」里有它的全部滑块和取色。
- 让 AI 改效果:对 Codex 或 Claude 说“把打字粒子改成金色,效果文件夹在 %APPDATA%\Woodfish\effects”,它会照文件夹里写给 AI 的
AGENTS.md改好并刷新。 - 停用和卸载:VS Code 里运行 为 Codex 停用 Woodfish 或 从 Codex 卸载 Woodfish。用 exe 的话,在
woodfish.exe所在的文件夹打开终端:停用是.\woodfish.exe codex autostart off再.\woodfish.exe codex stop-inject,全部撤销是.\woodfish.exe codex uninstall。之后重启一次 Codex,调试端口就关了。 - 不碰你的 Codex:Woodfish 不修改 Codex 的安装文件,也不修改、替换或删除你开始菜单、桌面、任务栏上的 Codex 快捷方式。用原来的快捷方式打开 Codex 时,它会在窗口出现前被带效果重启一次,所以比平时晚两三秒出窗口;想省掉这一步,
woodfish codex shortcut(VS Code 启用成功的提示上也有这个按钮)在开始菜单另加一个直接带效果启动的“Woodfish Codex”。
DeepSeek Harness(dsh)Web 版
dsh 的 Web 版(dsh web,本机 127.0.0.1:3080)可以通过油猴用户脚本换上同样的主题和效果:woodfish dsh userscript 输出脚本路径,装进 Tampermonkey / Violentmonkey 即可。详见 dsh 适配说明。
本地开发
pnpm install
pnpm compile
pnpm test
pnpm test:integration
pnpm lint
pnpm format:check
pnpm verify
pnpm package
仓库是 pnpm workspace monorepo,以上命令都在根目录运行。VS Code 扩展位于 apps/vscode-extension/,与宿主无关的颜色算法、渐变计算、特调表和调色板位于 packages/theme-core/,结构与边界见 仓库结构。
项目结构
apps/vscode-extension/:VS Code 扩展。apps/chatgpt-app/:ChatGPT/Codex 桌面端适配。apps/dsh-web/:DeepSeek Harness Web 版适配。apps/cli/:woodfish命令行、渲染脚本构建和发布产物。packages/theme-core/、packages/renderer-runtime/、packages/effects/:与具体宿主无关的共享代码。- 新宿主放在
apps/<宿主>/,适配器与宿主入口保持在同一个目录。
pnpm test:integration 会启动隔离的 VS Code 扩展宿主,验证开启、关闭和工作台恢复。扩展入口是 apps/vscode-extension/src/extension.ts;主题由 apps/vscode-extension/scripts/generate-themes.js 生成(pnpm themes:generate),渲染端脚本源码在 apps/vscode-extension/browser/(pnpm runtime:build),注入用 CSS 在 apps/vscode-extension/themes/shared/。README 里的图片由 apps/vscode-extension/scripts/render-readme-images.js 生成,改了渐变或效果后重跑一次。发布到 Open VSX 需要先设置环境变量 OVSX_PAT。
参与共建
随时欢迎共建,会看每一个 PR,每一位贡献者都会出现在下面这张图里。怎么提交见参与贡献。
用 Claude Code、Codex 这类 AI 写代码的话,推荐顺手装上 讣告 · AI 的回收站(GitHub):AI 留下的调试脚本、日志、截图到期自己走,AI 删掉的东西七天内都能找回,提 PR 前工作区也干净。最省事的装法是把这句话发给你的 agent:“读 https://obituary.woodfish.site/agent-install.md ,照里面的步骤帮我安装讣告并接入你自己。”想自己装:Windows 用 Scoop(scoop bucket add obituary https://github.com/woodfishhhh/scoop-bucket,再 scoop install obituary),macOS 用 Homebrew(brew install --cask woodfishhhh/tap/obituary),其他方式见讣告的安装文档。
























