小企鹅主题商店

贡献指南

欢迎为小企鹅主题商店提交主题或改进代码。以下是参与方式。

1 提交主题

通过 GitHub Issue 提交 fcitx5-android（支持原版和靓企鹅版）配色方案，审核通过后自动部署到画廊。

  1. 前往 GitHub Issues 选择模板 页面
  2. 选择 「提交主题」（submit-theme）模板
  3. 填写主题名称、作者、配色 JSON
  4. 提交 Issue，等待自动验证与人工审核
  5. 审核通过后自动合并，主题出现在画廊
零代码参与 — 无需 Fork / PR，只需填写 Issue 模板。适合只想分享配色的用户。

2 主题 JSON 格式规范

主题使用 JSON 文件描述，包含元数据和 21 个颜色 token。以下是完整示例：

theme-example.json
{
  "name": "My Theme",
  "isDark": false,
  "backgroundImage": null,
  "version": "2.1",
  "backgroundColor": -657931,
  "barColor": -1513240,
  "keyboardColor": -1052689,
  "keyBackgroundColor": -1,
  "keyTextColor": -1250068,
  "candidateTextColor": -1250068,
  "candidateLabelColor": -6710887,
  "candidateCommentColor": -5592406,
  "altKeyBackgroundColor": -2039584,
  "altKeyTextColor": -6710887,
  "accentKeyBackgroundColor": -11751600,
  "accentKeyTextColor": -1,
  "keyPressHighlightColor": 1090519039,
  "keyShadowColor": 268435455,
  "popupBackgroundColor": -1,
  "popupTextColor": -1250068,
  "spaceBarColor": -1513240,
  "dividerColor": -2039584,
  "clipboardEntryColor": -1513240,
  "genericActiveBackgroundColor": -11751600,
  "genericActiveForegroundColor": -1
}

颜色 Token 说明

共 21 个颜色字段，涵盖键盘各个视觉区域：

Token 说明
backgroundColor键盘整体背景色
barColor工具栏颜色
keyboardColor键盘底部背景色
keyBackgroundColor普通按键背景色
keyTextColor普通按键文字颜色
candidateTextColor候选词文字颜色
candidateLabelColor候选词标签颜色
candidateCommentColor候选词注释/拼音颜色
altKeyBackgroundColor功能键（Shift、回退等）背景色
altKeyTextColor功能键文字颜色
accentKeyBackgroundColor强调键（回车等）背景色
accentKeyTextColor强调键文字颜色
keyPressHighlightColor按键按下时的高亮颜色
keyShadowColor按键阴影/边框颜色
popupBackgroundColor弹出菜单背景色
popupTextColor弹出菜单文字颜色
spaceBarColor空格键背景色
dividerColor分隔线颜色
clipboardEntryColor剪贴板条目背景色
genericActiveBackgroundColor通用激活态背景色
genericActiveForegroundColor通用激活态文字颜色
关于颜色格式 — 主题使用 fcitx5-android（支持原版和靓企鹅版）原生格式，颜色值为 signed int32（如 -16777216 为黑色，-1 为白色）。提交 Issue 时请直接使用 int32 值，无需转换。

3 审核流程

①
自动验证

提交 Issue 后，GitHub Actions 自动检查 JSON 结构是否合法（字段完整、颜色格式正确）。

②
人工审核

管理员审核配色质量，通过后为 Issue 添加 approved 标签。

③
自动合并

检测到 approved 标签后，主题 JSON 自动入库并触发构建。

④
部署上线

GitHub Pages 自动部署新版本。Issue 自动关闭，附带成功提示评论。

4 开发贡献

如果你想改进代码、修复 Bug 或添加功能，欢迎提交 Pull Request。

环境搭建

Terminal
# 1. Fork 并克隆仓库
git clone https://github.com/<your-user>/f5a-gallery.git
cd f5a-gallery  # 仓库名不变

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev

# 4. 构建生产版本
npm run build

提交 PR

  1. 从 main 创建功能分支：git checkout -b feat/your-feature
  2. 提交变更，写清 commit message
  3. 推送分支并创建 Pull Request
  4. 等待 CI 检查通过与代码审核
有疑问？ 在 GitHub Discussions 或 Issue 中提问，维护者会尽快回复。
← 返回首页