Nuancera 是一个本地优先的桌面配色工具，面向科研图表、期刊论文插图和学术幻灯片。它把出版级配色、色盲安全检查、PDF 配色提取、调色板管理和多格式导出放在同一个本地应用里。
Nuancera is a local-first desktop palette tool for scientific figures, journal graphics, and academic slides. It brings publication-grade palettes, colorblind-safety checks, PDF color extraction, palette management, and multi-format exports into one local app.
Current version / 当前版本: 0.0.8
Nuancera 专为需要严谨视觉表达的科研作者、研究生、编辑和幻灯片制作者设计。它不依赖云端服务，不上传文件，也没有遥测；除启动时可读取 GitHub Releases 检查新版本外，颜色计算、PDF 渲染、期刊识别、配色保存与导出都在本机完成。
它适合这些场景：
- 为论文图、GraphPad/Illustrator/R/Python 图表和答辩幻灯片快速建立统一配色。
- 从已发表 PDF 中提取主要颜色，沉淀为自己的期刊配色库。
- 检查调色板在常见色觉缺陷下是否仍可区分。
- 将配色导出为 HEX、JSON、GIMP
.gpl、Adobe.ase或 PNG 色卡。 - 在中文、英文、法文界面之间切换，保持本地优先工作流一致。
- 本地优先：核心功能无云端依赖、无遥测、无远程字体；启动时仅允许访问 GitHub Releases 检查新版本。
index.html使用严格 CSP，main.js拦截其它非本地请求。 - 颜色输入与转换：HEX / RGB / HSL / CMYK 实时互转，点按任意数值即可复制。
- 配色构建：组合 2-16 个颜色，拖拽排序、锁定、删除；整套配色给出色盲判定。每个色块可一键收藏到「颜色库」。
- 应用预览：把配色套到柱状图、折线图、幻灯片标题块，文字自动选取高对比色。
- 预设库：33 套精选配色，支持按类型、风格、色盲安全筛选。包含 viridis、cividis、mako、rocket、crest、flare、magma，ColorBrewer，全套 Okabe-Ito，以及低饱和编辑风配色。
- 配色建议：基于一个颜色生成二元互补、三元互补、邻近色、分裂互补、单色系方案，并可查找「包含此颜色的期刊配色」。
- 期刊配色库：内置出版级推荐配色，并可按期刊保存从 PDF 提取的配色，支持分区、影响因子、简写标签等元数据。
- PDF 配色提取：本地 pdf.js 渲染前 N 页，去除白底、黑字和低饱和灰，再在 CIE Lab 空间聚类，得到主色、辅色和点缀色。
- 期刊识别：导入 PDF 时可离线识别期刊名称、简写、ISSN、影响因子、类别、JCR 分区和 DOI。内置 1008 本期刊数据，识别优先级为 ISSN > 全名 > 简写；无法识别时留空，不臆测。
- 本地颜色库：不限数量保存个人常用单色和配色。
- 多格式导出：HEX
.txt、.json、GIMP.gpl、Adobe.ase、PNG 色卡。 - 多语言：中文 / English / Français，默认中文。
Nuancera 的隐私政策见 PRIVACY.md。Microsoft Partner Center 的隐私政策 URL 可使用：
https://github.com/Chase-DC/nuancera/blob/main/PRIVACY.md
如果仓库 Releases 页面已经发布安装包：
- macOS Apple Silicon：下载
.dmg，打开后把 Nuancera 拖入「应用程序」。 - Windows x64：下载
.exe安装器，双击安装。
若没有可下载成品，可从源码运行：
1. 安装 Node.js（一次性，需要联网）
到 nodejs.org 下载当前系统对应的 LTS 安装包并安装。终端验证：
node -v2. 克隆并安装依赖（一次性，需要联网）
git clone https://github.com/Chase-DC/nuancera.git
cd nuancera
npm installnpm install 会下载 Electron 和 pdf.js；postinstall 会把 pdf.js 拷到 renderer/vendor/pdfjs/。安装完成后，核心工作流不需要联网；若联网，启动时会检查是否存在新版本。
3. 启动开发版
npm start窗口弹出后即可关掉 Wi-Fi，核心功能仍应照常工作。
4. 打包成可双击应用
npm run distmacOS Apple Silicon：
npm run dist:mac完成后在 dist/ 中打开 .dmg 并把 App 拖入「应用程序」，或直接运行 dist/mac-arm64/Nuancera.app。未签名 App 首次打开时，右键选择「打开」，再确认「打开」（只需一次）。
Windows x64：
npm run dist:win完成后在 dist/ 中找到 Nuancera-<version>-win-x64.exe 安装器。未签名安装器可能触发 Windows SmartScreen 或 Unknown Publisher 提示。
启动 Nuancera 后断开所有网络，确认以下功能都可用：
- 颜色输入与格式转换
- 预设与配色建议
- PDF 配色提取
- 颜色库保存与读取
- HEX / JSON / GPL / ASE / PNG 导出
- 内置 pdf.js 将 PDF 前 N 页渲染到离屏画布。
- 读取像素并去噪：去除近白页底、近黑文字、低饱和灰、坐标轴、网格和抗锯齿噪声。
- 保留的彩色像素按出现频率加权，在 CIE Lab 空间进行 k-means 聚类。
- 根据面积和分布给出主色、辅色、点缀色角色。
- 结果以可编辑色块展示，可载入构建区或存入期刊配色库。
已用已知配色的图做过端到端验证：源色可被准确还原，黑白底能被正确剔除。
Nuancera 的用户数据保存在本机：
~/Library/Application Support/Nuancera/palette-library.json
这是一个可读的本地 JSON 文件，同时保存「已存配色」和「颜色库」。数据不会上传。
源码仓库的 Release 只在明确发布新版时更新。若要向用户提供安装包：
- 在项目根目录运行
npm run dist:mac和npm run dist:win。 - 找到
dist/Nuancera-<version>-mac-arm64.dmg和dist/Nuancera-<version>-win-x64.exe。 - 打开 GitHub 仓库页面，进入 Releases。
- 点击 Draft a new release，填写 tag，例如
v0.0.8。 - 将
.dmg和.exe拖到 Attach binaries 区域并发布。
Windows Store 版本使用 Partner Center 提供的应用身份：
Package/Identity/Name: DuoCAI.Nuancera
Package/Identity/Publisher: CN=1F00B5D8-C2D3-4FC9-B4D3-1CF7B10D4104
PublisherDisplayName: Duo CAI
Reserved app name: Nuancera
在 Windows 环境中运行：
npm run dist:storemacOS 本机无法直接生成 AppX；可使用 GitHub Actions 中的 Build Microsoft Store AppX 手动 workflow，在 windows-latest runner 上生成 dist/Nuancera-<version>-store-x64.appx，再上传到 Partner Center。
推荐流程：
- 在 macOS 本机继续日常开发和本地验证。
- 满意后只把源码同步到 GitHub，不更新 GitHub Release、不打 tag。
- 在 GitHub Actions 手动运行 Build Microsoft Store AppX。
- 下载 workflow artifact 中的 Store 包。
- 将 Store 包上传到 Microsoft Partner Center。
这个 workflow 只是把 GitHub Actions 当作 Windows 构建机，不负责发布 GitHub Release。
Store 包要求数字版本号。workflow 会先运行 scripts/prepare-store-version.js，把本地迭代版本临时映射为三段包版本，例如 0.0.7-local.1 会映射为 0.0.7；electron-builder 会在 AppX manifest 中写入 Store 兼容的 0.0.7.0。这个映射只发生在 GitHub Actions 构建环境中，不改变本地迭代版本。
Store 包还会通过 scripts/patch-appx-manifest.js 将 manifest 的 Windows MinVersion 和 MaxVersionTested 设置为 10.0.17763.0，避免 Partner Center 拒收 MinVersion <= 10.0.17134.0 的 MSIX 包。Electron 桌面应用会声明 runFullTrust，提交 Microsoft Store 时需要在 Submission options 中说明该能力用于运行 Nuancera 的桌面应用主体。
本项目使用两条版本轨道：
- 公开 Release 使用
0.0.n，例如0.0.7、0.0.8。 - 本地未发布迭代使用当前 Release 的 SemVer 预发布后缀，例如
0.0.7-local.1、0.0.7-local.2。 - 不在
package.json中使用四段版本号，例如0.0.7.1，因为 electron-builder 会拒绝这类版本。 - 当明确发布新版时，将最新本地迭代提升到下一个公开版本，例如
0.0.7-local.3发布为0.0.8。
本地迭代和公开发布都要同步更新：
package.json中的versionpackage-lock.json中的版本renderer/js/i18n.js中的APP_VERSION- README 顶部的当前版本
CHANGELOG.md
公开 Release 的更新日志应汇总上一个 Release 之后所有本地迭代版本的功能和修复。
Nuancera is built for researchers, graduate students, editors, and slide makers who need careful visual language for scientific work. It does not depend on cloud services, upload files, or send telemetry. Apart from reading GitHub Releases at startup to check for updates, color computation, PDF rendering, journal detection, palette storage, and exports happen locally.
Use it to:
- Build consistent palettes for papers, GraphPad/Illustrator/R/Python figures, and defense slides.
- Extract dominant colors from published PDFs and save them into a personal journal-palette library.
- Check whether a palette remains distinguishable under common color-vision deficiencies.
- Export palettes as HEX, JSON, GIMP
.gpl, Adobe.ase, or PNG swatch sheets. - Work in Chinese, English, or French within a local-first workflow.
- Local-first: core features have no cloud dependency, telemetry, remote fonts, or remote APIs. Startup may read GitHub Releases to check for updates; the CSP and network blocker prevent other non-local requests.
- Color conversion: live HEX / RGB / HSL / CMYK conversion; click any value to copy.
- Palette builder: combine 2-16 colors, reorder by drag, lock/delete swatches, and get palette-level colorblind-safety feedback. Star any swatch to save it to the Color Library.
- Applied previews: preview palettes on bar charts, line charts, and slide title blocks with automatic high-contrast text.
- Curated presets: 33 palette sets, filterable by type, mood, and colorblind safety. Includes viridis, cividis, mako, rocket, crest, flare, magma, ColorBrewer, Okabe-Ito, and low-saturation editorial palettes.
- Suggestion engine: generate complementary, triadic, analogous, split-complementary, and monochromatic palettes from a base color, or find journal palettes containing a similar color.
- Journal palettes: publication-grade defaults plus PDF-imported palettes grouped by journal, with quartile, impact factor, abbreviation, and category metadata.
- PDF color extraction: bundled pdf.js renders pages locally, removes background/text/noise pixels, clusters remaining colors in CIE Lab, and labels primary/secondary/accent roles.
- Offline journal detection: PDF import can identify journal name, abbreviation, ISSN, impact factor, category, JCR quartile, and DOI. The bundled table covers 1008 journals. Matching priority: ISSN > full name > abbreviation; unknown journals are left blank rather than guessed.
- Local libraries: save unlimited colors and palettes on your own machine.
- Exports: HEX
.txt,.json, GIMP.gpl, Adobe.ase, and PNG swatch sheets. - Languages: 中文 / English / Français; Chinese is the default.
Nuancera's privacy policy is available in PRIVACY.md. For Microsoft Partner Center, use this privacy policy URL:
https://github.com/Chase-DC/nuancera/blob/main/PRIVACY.md
If installers are available on the Releases page:
- macOS Apple Silicon: download the
.dmg, open it, and drag Nuancera into Applications. - Windows x64: download the
.exeinstaller and run it.
Otherwise run from source:
1. Install Node.js once
Download the LTS installer for your operating system from nodejs.org, then verify:
node -v2. Clone and install dependencies
git clone https://github.com/Chase-DC/nuancera.git
cd nuancera
npm installnpm install downloads Electron and pdf.js. The postinstall script copies pdf.js into renderer/vendor/pdfjs/. After installation, the core workflow works offline; when online, startup checks whether a newer release exists.
3. Start the development app
npm startOnce the window opens, you can turn Wi-Fi off and the core workflow should continue working.
4. Build a double-clickable app
npm run distmacOS Apple Silicon:
npm run dist:macOpen the .dmg in dist/ and drag Nuancera to Applications, or run dist/mac-arm64/Nuancera.app directly. For the first launch of an unsigned build, right-click the app, choose Open, then confirm Open.
Windows x64:
npm run dist:winThe installer is written to dist/Nuancera-<version>-win-x64.exe. Unsigned installers may trigger Windows SmartScreen or Unknown Publisher prompts.
Launch Nuancera, disconnect networking, and confirm these still work:
- color input and conversion
- presets and suggestions
- PDF color extraction
- saving and loading the color library
- HEX / JSON / GPL / ASE / PNG exports
- Bundled pdf.js renders the first N pages to an offscreen canvas.
- Pixel cleanup removes near-white page backgrounds, near-black text, low-saturation grays, axes, gridlines, and antialiasing noise.
- Remaining colored pixels are weighted by frequency and clustered in CIE Lab using k-means.
- Lightweight heuristics assign primary, secondary, and accent roles.
- Results appear as editable swatches and can be loaded into the builder or saved to the journal-palette library.
The extraction flow has been validated with known-color figures: source colors are recovered accurately while black/white backgrounds are removed.
Nuancera stores user data locally at:
~/Library/Application Support/Nuancera/palette-library.json
This readable JSON file holds saved palettes and the color library. It is never uploaded.
Releases are updated only when an explicit new version is published. To publish installers:
- Run
npm run dist:macandnpm run dist:winfrom the project root. - Locate
dist/Nuancera-<version>-mac-arm64.dmganddist/Nuancera-<version>-win-x64.exe. - Open the GitHub repository page and go to Releases.
- Click Draft a new release and create a tag such as
v0.0.8. - Attach the
.dmgand.exe, then publish the release.
The Windows Store build uses the app identity from Partner Center:
Package/Identity/Name: DuoCAI.Nuancera
Package/Identity/Publisher: CN=1F00B5D8-C2D3-4FC9-B4D3-1CF7B10D4104
PublisherDisplayName: Duo CAI
Reserved app name: Nuancera
On Windows, run:
npm run dist:storemacOS cannot build AppX directly. Use the manual Build Microsoft Store AppX GitHub Actions workflow on windows-latest to produce dist/Nuancera-<version>-store-x64.appx, then upload that package to Partner Center.
Recommended flow:
- Keep daily development and local validation on macOS.
- When satisfied, sync source code to GitHub only; do not update GitHub Releases and do not create a version tag.
- Manually run Build Microsoft Store AppX in GitHub Actions.
- Download the Store package from the workflow artifact.
- Upload the Store package to Microsoft Partner Center.
This workflow treats GitHub Actions as the Windows build machine. It does not publish a GitHub Release.
Store packages require numeric package versions. The workflow first runs scripts/prepare-store-version.js, temporarily mapping local iteration versions to three-part package versions, for example 0.0.7-local.1 to 0.0.7; electron-builder then writes the Store-compatible 0.0.7.0 into the AppX manifest. This mapping happens only inside the GitHub Actions build environment and does not change the local iteration version.
Store builds also run scripts/patch-appx-manifest.js through the electron-builder appxManifestCreated hook to set the Windows MinVersion and MaxVersionTested to 10.0.17763.0, avoiding Partner Center rejection for MSIX packages targeting MinVersion <= 10.0.17134.0. Electron desktop packages declare runFullTrust; explain in Submission options that this capability is used to run the Nuancera desktop application process.
This project uses two version tracks:
- Public releases use
0.0.n, such as0.0.7and0.0.8. - Local unreleased iterations use SemVer prerelease suffixes based on the current release, such as
0.0.7-local.1and0.0.7-local.2. - Do not use four-part versions such as
0.0.7.1inpackage.json, because electron-builder rejects them. - When publishing a new release, promote the latest local iteration to the next public version, such as publishing
0.0.7-local.3as0.0.8.
For both local iterations and public releases, keep these in sync:
versioninpackage.json- version entries in
package-lock.json APP_VERSIONinrenderer/js/i18n.js- the current version shown at the top of this README
CHANGELOG.md
The public release changelog should summarize all local iteration features and fixes since the previous public release.
nuancera/
├── package.json
├── main.js
├── preload.js
├── LICENSE
├── README.md
├── build/icon.png
├── scripts/
│ ├── copy-vendor.js
│ └── build-presets.js
└── renderer/
├── index.html
├── styles.css
├── data/
│ ├── presets.json
│ └── presets.js
├── vendor/pdfjs/
└── js/
├── i18n.js
├── color-utils.js
├── vision.js
├── cluster.js
├── exporters.js
├── pdf-extract.js
└── app.js
MIT licensed.