Woodfish Theme

中文 · English · 安装扩展 · 故障排查

Woodfish Theme 是一套面向 VS Code 的深色主题与运行时视觉效果：保留清晰的编辑器层级，同时让渐变语法、文字发光和彩虹光标按需开启。

效果预览

Woodfish Dracula 使用与 Dracula 调色一致的语法渐变、较短的分层光晕、低透明度主题光标和慢速标签色带；注释与普通正文保持平整，避免整行雾化。

它提供什么

• 双主题底座：内置 Woodfish Dark 与 Woodfish Dracula，共享同一套运行时效果。
• 渐变语法：为不同 token 类型应用独立的渐变色带，可整体关闭或追加自定义规则。
• 可调发光：发光层可独立开关，并通过强度倍率适配不同字体和显示器。
• 彩虹光标：颜色、循环速度、圆角、模糊与透明度均可配置。
• 安全恢复：写入前保存并校验当前工作台备份，失败时自动回滚；修复与彻底停用只使用匹配当前 VS Code 安装的可信备份。
• 动效降级：尊重系统的“减少动态效果”偏好，自动停用持续动画与过渡。
• 真实运行状态：状态栏显示 on / paused / off，并用 A / G / C 标记当前开启的效果层。

三步开始

1. 从 VS Code Marketplace 安装 Woodfish Theme。
2. 按 Ctrl+Shift+P，运行 Woodfish Theme: 开启 Woodfish 主题。
3. 点击提示中的 重新加载窗口，让运行时样式生效。

扩展会恢复最近一次选择的内置 Woodfish 主题；首次启用时使用 Woodfish Dark。之后点击右下角的 Woodfish ... 状态栏入口，即可快速开关各效果。

code --install-extension woodfish-theme-5.2.0.vsix

效果层与状态

Woodfish Theme 将基础颜色主题与三个效果层分开管理：

Woodfish Dark / Woodfish Dracula
    └── runtime payload
        ├── A  syntax gradient
        ├── G  text glow
        └── C  rainbow cursor

启用主题时会恢复最近一次选择的内置主题，并写入与该主题匹配的最新 payload。

[!IMPORTANT] 效果层会修改 VS Code 的 workbench.html，切换效果后需要重新加载窗口。扩展使用同目录临时文件完成校验后的原子替换，并保存带哈希、路径和 VS Code 版本信息的备份。VS Code 更新可能替换该文件；遇到效果消失时可运行 Woodfish Theme: 修复 Woodfish 注入。

常用命令

在命令面板中搜索 Woodfish Theme：

彻底停用 Woodfish 主题 会先要求二次确认。未知的第三方注入不会被 Woodfish 自动改写或清理。

切换内置主题

1. 按 Ctrl+K Ctrl+T 打开主题选择器。
2. 选择 Woodfish Dark 或 Woodfish Dracula。
3. 之后再次运行 Woodfish Theme: 开启 Woodfish 主题 时，扩展会优先恢复这次选择。

未自定义光标参数时，Woodfish Dracula 会使用 12 秒的粉紫青绿主题色循环、1px 圆角与 0.45 尾迹透明度；任何显式的 woodfishTheme.cursor.* 设置都会优先生效。

配置示例

所有设置都以 woodfishTheme.* 开头。下面是一组偏克制的配置：

{
  "woodfishTheme.syntaxGradient.enabled": true,
  "woodfishTheme.glow.enabled": true,
  "woodfishTheme.glow.intensity": 0.8,
  "woodfishTheme.cursor.enabled": true,
  "woodfishTheme.cursor.animationDuration": 8,
  "woodfishTheme.cursor.gradientStops": [
    "#ff2d95",
    "#ffd700",
    "#00ffff"
  ],
  "woodfishTheme.cursor.glowBlur": 0,
  "woodfishTheme.cursor.glowOpacity": 0.55
}

• syntaxGradient.enabled（true / false）：开关渐变语法层。
• syntaxGradient.customRules（CSS 字符串数组）：在默认 token 样式后追加覆盖。
• glow.enabled（true / false）：开关文字发光层。
• glow.intensity（0.1 - 3 倍）：缩放默认发光模糊半径。
• glow.customRules（CSS 字符串数组）：在默认发光样式后追加覆盖。
• cursor.enabled（true / false）：开关光标主体与尾迹。
• cursor.animationDuration（1 - 60 秒）：调整颜色循环速度。
• cursor.gradientStops（CSS 颜色数组）：定义彩虹光标色带。
• cursor.borderRadius（0 - 24 px）：调整光标圆角。
• cursor.glow（true / false）：保留彩色光标主体时，单独开关尾迹发光。
• cursor.glowBlur（0 - 24 px）：默认 0 关闭 GPU blur；大于 0 时按需启用。
• cursor.glowOpacity（0 - 1）：调整尾迹可见度。
• cursor.customRules（CSS 字符串数组）：追加最终光标 CSS 覆盖。

自定义规则最多 32 条，每条最多 4096 个字符，总计最多 16384 个字符。为避免突破样式边界或加载外部资源，包含 </style、<script、@import 或 url(...) 的规则会被忽略。在不受信任的工作区中，VS Code 会限制自定义规则与渐变色配置；其余安全设置仍可使用。

完整说明也可直接在 VS Code 设置页中查看。

排查问题

效果没有出现

确认当前主题是 Woodfish Dark 或 Woodfish Dracula，并在运行命令后重新加载窗口。

状态栏显示 paused

效果设置仍然保留，但当前主题不是内置 Woodfish 主题。切回任一内置主题或再次运行开启命令。

更新 VS Code 后效果消失

运行 Woodfish Theme: 修复 Woodfish 注入，然后重新加载窗口。

需要完整移除

卸载扩展前先运行 Woodfish Theme: 彻底停用 Woodfish 主题。若仍有样式残留，请检查其他会修改同一 workbench.html 的扩展。

更多诊断步骤、输出日志位置和高级清理方法见 故障排查指南。

本地开发

npm install
npm run compile
npm test
npm run test:integration
npm run lint
npm run format:check
npm run verify
npm run package

npm run test:integration 会启动隔离的 VS Code 扩展宿主并验证开启、关闭与工作台恢复链路。扩展入口位于 src/extension.ts；主题资源位于 themes/bearded/、themes/dracula/ 与 themes/shared/。

项目信息

• 更新日志
• 参与贡献
• 提交问题
• MIT License