From 47d65a4515cb98c42f6e5d364f8c01a09613a5da Mon Sep 17 00:00:00 2001 From: felix Date: Mon, 27 Jul 2026 20:34:55 +0800 Subject: [PATCH] docs: clarify theme and pet entry points --- README.md | 27 ++++++++++++++++++++++----- README.zh-CN.md | 27 +++++++++++++++++++++++++-- tests/repository-identity.test.mjs | 11 ++++++++++- 3 files changed, 57 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ca0d32e..6bb233d 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# CC Theme +# CC Theme — Ready-made custom themes and Codex pets for Mac [简体中文](README.zh-CN.md) @@ -6,16 +6,25 @@ Official website: [cc-theme.app](https://cc-theme.app) [![CI](https://github.com/quanzhankeji/cc-theme/actions/workflows/ci.yml/badge.svg)](https://github.com/quanzhankeji/cc-theme/actions/workflows/ci.yml) -CC Theme is an open-source macOS app for installing ready-made Codex themes in ChatGPT Desktop. It provides reproducible theme packages and unified theme management for supported macOS AI desktop clients. Import a versioned `.cctheme`, apply it through a verified host Adapter, and restore the native appearance—without asking an AI model to generate the theme, rewriting prompts, or spending generation tokens. +CC Theme is an open-source macOS app for installing ready-made custom themes in ChatGPT Desktop and supported AI desktop clients. It provides reproducible, versioned `.cctheme` packages and a verified Codex pet path for compatible Mac clients. Import a package, apply it through a verified host Adapter, and restore the native appearance—without asking an AI model to generate the theme, rewriting prompts, or spending generation tokens. It is an independent, unofficial, open-source project—not a prompt library, concept gallery, or general-purpose AI theme generator. This repository contains the CC Theme app, host-specific Adapters, shared contracts, and release metadata. Production theme packages are maintained in the separate [CC Theme Themes](https://github.com/quanzhankeji/cc-theme-themes) registry and published as Release assets; theme media does not enter this Git source tree. -## Official guides +## Explore CC Theme -- [Browse ready-made and custom ChatGPT Desktop themes](https://cc-theme.app/en/chatgpt-desktop/themes) -- [Improve Codex dark mode readability](https://cc-theme.app/en/guides/fix-unreadable-codex-dark-mode) +### Ready-made custom themes + +- [Browse custom themes for ChatGPT Desktop on Mac](https://cc-theme.app/en/chatgpt-desktop/themes) +- [Fix unreadable text in Codex dark mode](https://cc-theme.app/en/guides/fix-unreadable-codex-dark-mode) - [Add an image or video background to ChatGPT Desktop](https://cc-theme.app/en/guides/safe-image-background-codex-mac) +### Codex pets + +- [Browse animated Codex pets for Mac](https://cc-theme.app/en/codex-pets) +- [View Xiaogou's animated Codex pet state map](https://cc-theme.app/en/codex-pets/xiaogou) + +Xiaogou is available through the signed CC Theme pet catalog for compatible `mac-codex` releases. CC Theme verifies and installs the pet without modifying the Codex app bundle; you choose it manually in Codex Appearance settings. Usagi and Tiko are authorized preview profiles only. They are not downloadable `.ccpet` packages and cannot be presented as installable pets. + ## Demo https://github.com/user-attachments/assets/5877f113-c50f-4457-84e1-89fb7c195df8 @@ -43,6 +52,14 @@ CC Theme distributes the actual declarative package—prepared assets, semantic “Apply directly” is deliberately narrow: it means applying a validated package through a compatible CC Theme Adapter. It does not mean unconditional injection into arbitrary third-party applications. +## Get started + +1. [Download the current CC Theme release](https://github.com/quanzhankeji/cc-theme/releases/latest) for Apple Silicon Mac. +2. Choose a ready-made custom theme from the guide above, then import its versioned `.cctheme` package in CC Theme. +3. If your supported `mac-codex` release offers Xiaogou in the signed catalog, inspect its motion states in the Codex pets section above, download and verify it in CC Theme, then select it manually in Codex Appearance settings. + +Themes and pets have separate compatibility and release boundaries. A pet profile or a theme preview never implies that every client version is supported; check the linked page and the in-app compatibility result before applying it. + ## System requirements **CC Theme 0.2.1 currently supports Apple Silicon only.** diff --git a/README.zh-CN.md b/README.zh-CN.md index 5341772..fd8c168 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,4 +1,4 @@ -# CC Theme +# CC Theme：Mac 上可直接使用的自定义主题与 Codex 宠物 [English](README.md) @@ -6,10 +6,25 @@ [![CI](https://github.com/quanzhankeji/cc-theme/actions/workflows/ci.yml/badge.svg)](https://github.com/quanzhankeji/cc-theme/actions/workflows/ci.yml) -CC Theme 为已支持的 macOS 桌面 AI 客户端提供开箱即用、可复现的主题包和统一主题管理。用户导入有版本的 `.cctheme`，即可通过经过验证的宿主 Adapter 应用主题并恢复原生外观，不需要再让 AI 生成主题、反复修改提示词或消耗生成 Token。 +CC Theme 为 ChatGPT Desktop 和已支持的 macOS 桌面 AI 客户端提供可直接使用的自定义主题、统一主题管理，以及兼容 Mac 客户端的已验证 Codex 宠物路径。用户导入有版本的 `.cctheme`，即可通过经过验证的宿主 Adapter 应用主题并恢复原生外观，不需要再让 AI 生成主题、反复修改提示词或消耗生成 Token。 这是一个独立、非官方、开源的项目，不是提示词库、概念图库或通用 AI 主题生成器。本仓库保存 CC Theme 应用、各宿主 Adapter、共享契约和发布元数据；生产主题包由独立的 [CC Theme Themes](https://github.com/quanzhankeji/cc-theme-themes) 仓库维护并作为 Release 资产发布，主题媒体不进入本 Git 源码树。 +## 探索 CC Theme + +### 成品自定义主题 + +- [浏览 Mac 上的 ChatGPT Desktop 自定义主题](https://cc-theme.app/zh-CN/chatgpt-desktop/themes) +- [修复 Codex 深色模式中的文字可读性](https://cc-theme.app/zh-CN/guides/fix-unreadable-codex-dark-mode) +- [为 ChatGPT Desktop 使用图片和视频背景](https://cc-theme.app/zh-CN/guides/safe-image-background-codex-mac) + +### Codex 宠物 + +- [浏览 Mac 上的动态 Codex 宠物](https://cc-theme.app/zh-CN/codex-pets) +- [查看 Xiaogou 的动态 Codex 宠物状态图](https://cc-theme.app/zh-CN/codex-pets/xiaogou) + +对于兼容的 `mac-codex` 版本，Xiaogou 可通过已签名的 CC Theme 宠物目录获取。CC Theme 会校验并安装宠物，不会修改 Codex 应用包；完成后仍需在 Codex 的外观设置中手动选择。Usagi 与 Tiko 仅是已获授权的预览资料，不是可下载的 `.ccpet` 包，也不能被宣传为可安装宠物。 + ## 演示视频 https://github.com/user-attachments/assets/7549701d-924d-4a12-a977-06a48b08ba43 @@ -37,6 +52,14 @@ CC Theme 发布的是实际可用的声明式主题包，包括已经制作的 这里的“直接应用”有严格边界：它只表示通过兼容的 CC Theme Adapter 应用经过校验的主题包，不代表可以无条件注入任意第三方应用。 +## 开始使用 + +1. 在 Apple Silicon Mac 上[下载当前 CC Theme 正式版](https://github.com/quanzhankeji/cc-theme/releases/latest)。 +2. 从上方的成品自定义主题入口选择主题，再在 CC Theme 中导入对应的有版本 `.cctheme` 包。 +3. 若已支持的 `mac-codex` 版本在已签名目录中提供 Xiaogou，可先在上方 Codex 宠物区域查看其动作状态，在 CC Theme 中下载并校验后，再于 Codex 外观设置内手动选择。 + +主题与宠物各自具有独立的兼容性和发布边界。宠物资料或主题预览不代表所有客户端版本均已支持；应用前请查看对应页面和应用内的兼容性结果。 + ## 系统要求 **CC Theme 0.2.1 当前仅支持 Apple Silicon。** diff --git a/tests/repository-identity.test.mjs b/tests/repository-identity.test.mjs index 746f7ed..b5e0e15 100644 --- a/tests/repository-identity.test.mjs +++ b/tests/repository-identity.test.mjs @@ -12,6 +12,15 @@ const officialGuideUrls = [ "https://cc-theme.app/en/chatgpt-desktop/themes", "https://cc-theme.app/en/guides/fix-unreadable-codex-dark-mode", "https://cc-theme.app/en/guides/safe-image-background-codex-mac", + "https://cc-theme.app/en/codex-pets", + "https://cc-theme.app/en/codex-pets/xiaogou", +]; +const officialChineseGuideUrls = [ + "https://cc-theme.app/zh-CN/chatgpt-desktop/themes", + "https://cc-theme.app/zh-CN/guides/fix-unreadable-codex-dark-mode", + "https://cc-theme.app/zh-CN/guides/safe-image-background-codex-mac", + "https://cc-theme.app/zh-CN/codex-pets", + "https://cc-theme.app/zh-CN/codex-pets/xiaogou", ]; const allowedReadmeHosts = new Set(["cc-theme.app", "docs.github.com", "github.com"]); @@ -135,7 +144,7 @@ test("repository metadata points to the new repository and controlled official w } const readmes = [ ["README.md", `Official website: [cc-theme.app](${officialWebsite})`, [officialWebsite, ...officialGuideUrls]], - ["README.zh-CN.md", `官方网站：[cc-theme.app](${officialWebsite})`, [officialWebsite]], + ["README.zh-CN.md", `官方网站：[cc-theme.app](${officialWebsite})`, [officialWebsite, ...officialChineseGuideUrls]], ]; for (const [relative, expectedWebsiteLine, expectedOfficialUrls] of readmes) { const readme = await fs.readFile(path.join(root, relative), "utf8");