🌈 Woodfish Theme

中文 | English

一个具有发光效果、渐变色彩与彩虹光标效果的 VS Code 主题扩展。

✨ 特色功能

• 🌈 彩色光标：注入彩虹光标样式（可开关）
• ✨ 发光效果：关键字/行号发光视觉
• 🎨 渐变语法高亮：提升辨识度与舒适度
• 🧩 模块化 CSS：主题样式按模块组织，便于维护

🆕 新增功能说明

• 状态栏真值显示：状态栏会显示 Woodfish on/off/paused，并附带 A / G / C 特效标记。
• 进度提示：在执行开启、关闭、修复等操作时，会通过通知显示实时进度。
• 快速功能菜单：点击右下角 Woodfish ... 状态栏即可打开完整命令菜单。

🖼️ 预览

📦 安装

从 VS Code 扩展市场安装

1. 打开 VS Code
2. 按 Ctrl+Shift+X 打开扩展面板
3. 搜索 “Woodfish Theme”
4. 点击安装

手动安装（VSIX）

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

🔌 运行方式

Woodfish Theme 现在使用内置 runtime 直接注入 VS Code workbench，不再依赖第三方 CSS Loader 扩展。

运行时行为已经改为内部自动处理：

• 启用主题时会自动切到 Woodfish Dark 并写入最新 payload
• 启动时会自动检查当前主题和 payload 是否匹配
• 遇到已知旧版 Woodfish 注入残留时，会先接管旧片段，再写入新版 payload
• 未知第三方注入不会被自动改写，只会提示可能冲突

🚀 使用方法

启用主题（一体化 runtime 注入）

1. Ctrl+Shift+P 打开命令面板
2. 运行 Woodfish Theme: 开启 Woodfish 主题
3. 按提示重新加载窗口（Reload Window）

关闭主题（移除 runtime 注入）

1. Ctrl+Shift+P
2. 运行 Woodfish Theme: 关闭 Woodfish 主题
3. 按提示重新加载窗口

选择颜色主题

1. Ctrl+K Ctrl+T 打开主题选择器
2. 选择 “Woodfish Dark”

🌈 彩色光标

• 一键开启：运行 Woodfish Theme: 开启 Woodfish 彩色光标
• 一键开关：运行 Woodfish Theme: 开启/关闭彩色光标

📊 状态栏含义

• on：当前是 Woodfish Dark，并且已检测到 Woodfish payload
• paused：特效设置本身开着，但当前不是 Woodfish Dark，所以运行时已暂停
• off：当前没有检测到 Woodfish payload
• A：彩色字体
• G：发光字体
• C：彩色光标

🎛️ 主题命令

• Woodfish Theme: 开启 Woodfish 主题
• Woodfish Theme: 关闭 Woodfish 主题
• Woodfish Theme: 开启/关闭 Woodfish 发光
• Woodfish Theme: 开启 Woodfish 彩色光标
• Woodfish Theme: 开启/关闭彩色光标
• Woodfish Theme: 彻底停用 Woodfish 主题（清理旧残留，属于破坏性操作，执行前会二次确认）

❓ 故障排查 (Troubleshooting)

如果遇到问题，请先尝试以下步骤。更多详细内容请查看 完整故障排查指南。

• 问题：发光效果没有生效
  • 原因：workbench 注入已经写入，但窗口还没有重新加载。
  • 解决：运行开启命令后，务必点击弹窗右下角的 “重新加载窗口”。
• 问题：关闭功能后效果仍然存在
  • 原因：可能是旧版本注入残留或其他注入类扩展仍在修改同一份 workbench 文件。
  • 解决：运行 Woodfish Theme: 彻底停用 Woodfish 主题 命令清理残留。
• 问题：状态栏没有显示
  • 原因：扩展尚未激活。
  • 解决：运行任意 Woodfish Theme: 命令（如“开启 Woodfish 主题”）即可激活扩展。
• 问题：彩色光标不工作
  • 原因：当前窗口还没重新加载，或者当前不是 Woodfish Dark。
  • 解决：先切到 Woodfish Dark，再运行 Woodfish Theme: 开启 Woodfish 主题 或 Woodfish Theme: 开启 Woodfish 彩色光标，然后重新加载窗口。
• 问题：状态栏显示 paused
  • 原因：你启用了特效，但当前颜色主题不是 Woodfish Dark。
  • 解决：运行 Woodfish Theme: 开启 Woodfish 主题，或手动切回 Woodfish Dark 后重新加载窗口。

💬 常见问题 (FAQ)

• Q: 为什么每次切换功能都需要重新加载？
  • A: 因为 CSS 注入涉及到 VS Code 的底层渲染，需要通过重新加载窗口来使新的样式表生效。
• Q: 可以同时使用多个主题吗？
  • A: 不建议。Woodfish Theme 涉及到 CSS 注入，与其他同样具有注入功能的主题同时使用可能会导致样式冲突或显示异常。
• Q: 如何完全移除所有效果？
  • A: 使用 Woodfish Theme: 彻底停用 Woodfish 主题 命令，它会移除当前 payload，并在可能的情况下恢复被接管的旧 Woodfish 注入。
• Q: 状态栏里的 on / paused / off / A / G / C 代表什么？
  • A: on / paused / off 代表运行时真实状态；A = 彩色字体，G = 发光字体，C = 彩色光标。

⚙️ 配置说明

{
  "woodfishTheme.syntaxGradient.enabled": true,
  "woodfishTheme.glow.intensity": 0.8,
  "woodfishTheme.cursor.gradientStops": [
    "#ff2d95",
    "#ffd700",
    "#00ffff"
  ],
  "woodfishTheme.cursor.glowOpacity": 0.55,
  "woodfishTheme.cursor.customRules": [
    "div.cursor { width: 3px !important; }"
  ]
}

推荐理解方式

• woodfishTheme.syntaxGradient.enabled
  • 控制是否注入彩色语法层。适合只想保留 Woodfish Dark 界面、不想要彩色代码的人。
• woodfishTheme.syntaxGradient.customRules
  • 追加自定义 token CSS。适合微调个别语法颜色。
• woodfishTheme.glow.enabled
  • 控制是否注入发光层。适合怕“糊边”的场景。
• woodfishTheme.glow.intensity
  • 单位是倍率，范围 0.1 - 3。本质上是缩放默认 text-shadow 的模糊半径。
• woodfishTheme.cursor.animationDuration
  • 单位是秒。越小颜色流动越快，越大越平缓。
• woodfishTheme.cursor.gradientStops
  • 彩色光标的核心颜色带，每一项都是 CSS 颜色值。
• woodfishTheme.cursor.borderRadius
  • 单位是像素 px。控制光标圆角。
• woodfishTheme.cursor.glow
  • 是否保留光标尾迹发光。
• woodfishTheme.cursor.glowBlur
  • 单位是像素 px。控制尾迹模糊半径。
• woodfishTheme.cursor.glowOpacity
  • 范围 0 - 1。控制尾迹存在感。
• woodfishTheme.cursor.customRules
  • 给高级用户的最终覆盖出口，比如直接改光标宽度。

🛠️ 开发

npm install
npm run compile
npm run format
npm run format:check
npm run package

📝 更新日志

版本变更请查看 CHANGELOG.md。

📄 许可证

MIT License，见 LICENSE。