使用指南

使用与下载

下载与你当前系统匹配的桌面应用,选择适用主题,或单独安装 CLI;两条安装链互不依赖。

01

下载桌面应用

macOS · Windows

浏览器会在本地识别操作系统和可用的处理器信息,优先推荐正确版本;所有下载都来自同一 GitHub Release。

为此设备推荐

正在识别当前设备…

识别结果只用于推荐,不会自动开始下载。

识别结果只改变推荐项,不会自动下载。无法识别或使用兼容模式时,请手动选择对应版本。

02

独立安装 CLI

可选 · 不安装桌面应用

CLI 是给自动化、主题创作和 Agent 使用的独立工具。主题创作、检查、预览、打包和安装可跨平台使用;实时应用只支持 macOS/Windows,离线克隆只支持 macOS。安装 CLI 不会安装或修改桌面应用,安装桌面应用也不会写入 CLI。

Windows · Scoop

Scoop 会选择 x64、x86 或 ARM64 包,并把命令加入当前用户的 PATH。

安装 CLI
scoop install https://github.com/IchenDEV/doubao-skin/releases/latest/download/doubao-skin.json

macOS / Linux

安装脚本识别 macOS 通用版或 Linux x64/ARM64,并验证 SHA-256。

安装 CLI
curl -fsSL https://raw.githubusercontent.com/IchenDEV/doubao-skin/main/scripts/install-cli.sh | sh

Agent 可以先检查 `doubao-skin` 是否在 PATH;缺失时再按当前系统选择上述安装命令。

03

首次打开

  1. macOS:打开 DMG,把“豆皮”拖入“应用程序”;首次被拦截时前往「系统设置 → 隐私与安全性」选择“仍要打开”。
  2. Windows:解压 ZIP,保持 `doubao-skin.exe`、`themes` 与 `licenses` 位于同一目录,再运行桌面程序。
  3. 两边都不需要关闭系统安全功能;如果下载被阻止,请先确认文件来自本项目的 GitHub Release。

04

应用与恢复

  1. 先保存目标应用里正在进行的内容。
  2. 在“豆皮”中选择目标应用和喜欢的主题,确认预览。
  3. 点击“应用主题”;需要还原时,点击“恢复默认”。

应用过程中目标应用可能重新打开。恢复默认只清理正在运行的主题,不会删除已下载的主题包。

05

安装创作与应用 Skill

Codex · Claude Code

添加项目插件市场后,一次安装即可获得主题创作和应用两个 Skill。

Codex

在终端依次运行:

添加插件市场
codex plugin marketplace add IchenDEV/doubao-skin
安装插件
codex plugin add doubao-skin@doubao-skin

更新:codex plugin marketplace upgrade doubao-skin
移除:codex plugin remove doubao-skin@doubao-skin

Claude Code

在 Claude Code 中依次输入:

添加插件市场
/plugin marketplace add IchenDEV/doubao-skin
安装插件
/plugin install doubao-skin@doubao-skin

更新:/plugin marketplace update doubao-skin
移除:/plugin uninstall doubao-skin@doubao-skin

create-doubao-theme

根据自然语言需求创建、检查、重绘预览并打包主题。

$create-doubao-theme 做一个暖黄色、适合夜间阅读的主题

apply-doubao-theme

列出、安装、应用或恢复主题;执行有影响的操作前会先征得确认。

$apply-doubao-theme 列出本机可用主题

Skill 会优先发现 PATH 中的独立 CLI;桌面应用与 CLI 可以只安装其中一个。安装第三方插件前请先查看源码和权限。开发者可以从 GitHub 查看 Skill 源文件,也可以读取 Agent Skills Discovery Draft 0.2.0 索引。