daeshawnballard/dexthemes

DexThemes

通过受支持的 Codex 和 DeepSeek Harness 路径浏览、预览并安全应用开发者工具主题。

dexthemes.com · 主题合集 · 指南 · @DexThemes

功能简介

- 浏览 100+ 主题，涵盖动漫、电子游戏、电影、漫画、星座等
- 实时预览 —— 通过真实代码查看每个主题的效果，深色与浅色变体并排对比
- 主题详情 —— 将中央工作区从模拟聊天切换为完整的调色板、来源和导入视图
- 可索引的公开页面 —— 每个有效的主题变体都有一个规范详情页，包含渲染预览和相关主题
- Codex 交接 —— 复制导入字符串并为你打开 Codex 设置
- DeepSeek Harness 插件 —— 通过 Harness 的受保护主题服务浏览并一键应用配对调色板，或通过受限的公开 MCP 工具配置创建/搜索/验证它们
- 创建你自己的主题 —— 内置主题构建器让你设计和分享自定义主题
- 根据描述创建 —— 一个受限的服务器端 DexThemes AI 草稿会变成可编辑的浅色/深色主题，且未经单独的用户操作绝不会应用
- Harness 上下文 —— 为 Codex、DeepSeek Harness 以及已记录的未来适配器提供预览，而无需分叉规范主题库
- Color Me Lucky —— 随机主题生成器，包含 6 种色彩和谐方案和约 5000+ 种名称组合
- 社区主题 —— 使用 GitHub 登录并提交你的创作
- 排行榜 —— 每日、每周、每月和全时段创作者排名
- Codex 插件 —— 无需离开对话即可发现、创建、预览、应用、发布和收藏主题
- 语音友好创建 —— 将口头想法、同人圈、事件或个性提示转化为命名的深色/浅色主题
- GitHub 反馈 —— 准备一份尽力脱敏的 GitHub Issue 以供精确审查，而不会静默发布

快速开始

静态站点前端，带有生成的哈希应用外壳。

git clone https://github.com/daeshawnballard/dexthemes.git
cd dexthemes
npm install
npm run build
python3 -m http.server 4173

DeepSeek Harness 插件

将当前已发布的包安装到 Harness 的 web 配置中，然后打开 Settings → Plugins → DexThemes：

pnpm dsh plugin --profile web add @dexthemes/deepseek-harness-plugin@0.6.4
pnpm dsh web
npm 包是受支持的已发布分发路径。版本 0.6.4 已发布，并已在真实的 DeepSeek Harness 0.1.0-rc.5 中从其确切的注册表产物进行了验证，包括 Apply/Revert、重启恢复、离线回退、GitHub Device Flow、连接活动确认、有界 Statsig 投递以及 Creator 模式聊天 Apply/Stop。请参阅兼容性、重启、升级和移除指南、0.6.4 发布回执、变更日志、GitHub 发布和支持路径。

打开 http://127.0.0.1:4173/，你就进入了。

dist/ 由 npm run build 生成，并且有意不提交到仓库。像 manifest.json、robots.txt、sitemap.xml、llms*.txt 以及应用图标这样的根路径静态文件来源于 public/，并在构建期间输出到部署根目录。

先读这个

- 架构指南
- 贡献指南
- 开源就绪计划
- API 指南
- DeepSeek Harness 集成
- 跨环境主题同步设计
- 多 harness 架构与兼容性
- Harness 效果证据矩阵
- Codex 插件指南
- 内容创作指南
- 可索引页面设计概念
- 可复用设计提示词
- 实现提示词
- OpenAI Build Week 2026 笔记

项目结构

index.html                 → 应用外壳
templates/                 → 生成的外壳和 service worker 的源模板
index.template.html      → 生成的外壳的源模板
sw.template.js           → 生成的 service worker 的源模板
styles/                    → 按领域拆分的 CSS（tokens、layout、sidebar、preview、builder、mobile、overlays）
index.css                → 领域范围样式表的清单入口
public/                    → 构建期间输出到部署根目录的静态文件事实来源
manifest.json            → PWA manifest 源
robots.txt               → 搜索爬虫指令
sitemap.xml              → 生成的静态 sitemap 回退；/sitemap.xml 在运行时为实时
public-pages.css         → 服务端渲染的主题、指南和集合页面样式
llms.txt                 → 面向 agent 的摘要文档源
llms-full.txt            → 面向 agent 的完整文档源
favicon.svg              → 根 favicon 源
apple-touch-icon.png     → iOS 主屏幕图标源文件
icon-192.png             → PWA 图标源文件
content/                   → 公开指南、功能、文章和参考文档的 Markdown 源文件
guides/                  → 任务和故障排除指南
features/                → 已发布产品功能页面
articles/                → 对比和编辑方法论
reference/               → 稳定的技术契约
src/                       → 前端源码模块
main.js                  → 应用入口点
preview-shell.js         → 预览渲染、外壳和窗口控件
preview-actions.js       → 预览侧效果、解锁操作和外部交接
preview-chat.js          → 预览惊喜元素、交接卡片、系统提示
preview-attribution.js   → 主题归属和报告 UI
theme-details.js         → 应用内 Chat 预览 / 主题详情工作区切换
theme-contracts.js       → 纯主题形状辅助函数和导入字符串构建器
theme-attribution-model.js → 纯作者归属规则
api.js                   → 前端 API 客户端兼容性聚合模块
dist/assets/               → 生产环境中提供的生成哈希前端构建输出（不提交）
scripts/build.mjs          → 哈希资源 + 外壳生成的构建流水线
scripts/generate-content.mjs → 验证 Markdown 并构建共享内容目录
theme-data/dexthemes/      → 按类别组织的主题包
helpers.js               → createDexTheme() 和 registerDexThemesPack()
anime.js                 → 动漫风格主题（Bleach、Naruto、JJK 等）
games.js                 → 电子游戏主题
movies.js                → 电影风格主题
comics.js                → 漫画书主题
zodiacs.js               → 星座主题
lunar.js                 → 生肖动物主题
originals.js             → 原创 DexThemes 设计
liger-zero.js            → Liger Zero 包（Zoids）
supporter.js             → 可解锁主题
convex/                    → 后端（Convex）—— 认证、点赞、社区主题、IndexNow
schema.ts                → 数据库模式
users.ts                 → 用户管理和会话
likes.ts                 → 点赞/取消点赞系统
themes.ts                → 社区主题提交和发布调度
indexNow.ts              → IndexNow 发布通知操作
http.ts                  → HTTP 路由组合入口点
api/                       → Vercel 边缘/无服务器端点（目录、公开页面、OG、站点地图）
share.js                 → 服务端渲染的规范主题页面，带真实 404 处理
content-page.js          → 答案优先的编辑、参考和集合页面
sitemap.js               → 实时静态 + 社区目录站点地图
mcp.js                   → DexThemes 插件的无状态 MCP 端点
deepseek-mcp.js          → DeepSeek Harness 的受限匿名 MCP 配置文件
server/                    → MCP 工具、主题创建/验证、生成的应用资源
mcp-app/                   → 交互式 Apps SDK 主题卡片和预览
plugins/dexthemes/         → 可安装的 Codex 插件清单、MCP 配置、资源和技能
packages/deepseek-harness-plugin/ → 已安装的 Harness 包和 Settings → Plugins → DexThemes UI
docs/themes.schema.json    → 主题提交的 JSON schema
docs/theme-submission-example.json → 示例贡献负载

主题格式

Codex 主题使用以下导入字符串格式：

codex-theme-v1:{"codeThemeId":"codex","theme":{"accent":"#0169cc","contrast":60,"fonts":{"code":null,"ui":null},"ink":"#fcfcfc","opaqueWindows":true,"semanticColors":{"diffAdded":"#00a240","diffRemoved":"#e02e2a","skill":"#b06dff"},"surface":"#111111"},"variant":"dark"}

贡献

有关如何提交主题、报告 bug 以及在本地设置后端的信息，请参阅 CONTRIBUTING.md。

如果你想找一个小的入手点，请优先选择标记为 good first issue 或 help wanted 的 issue。预期的早期贡献者范围是主题包、文档、纯辅助函数和有针对性的 UI 打磨，而不是认证或部署管道。

后端

后端运行在 Convex 上，并处理：

- 带有一次性浏览器绑定 state 和 PKCE S256 的 GitHub OAuth
- 经 GitHub 认证的 agent/API key 签发，静态存储时使用 SHA-256 哈希
- 为插件提供 OAuth 2.1 资源服务器支持，并以 GitHub 作为上游登录
- 通过由 Convex 代理的 DexThemes Connect GitHub Device Flow 进行可选的已安装集成账户授权；GitHub token 保留在服务端，短期 DexThemes 会话保留在插件内存中
- 浏览器会话管理（生产环境中使用 HttpOnly 同站 cookie，仅在 localhost/dev 中进行 token 交接）
- 社区主题提交和审核
- 社区主题发布后的 IndexNow 通知
- 使用规范主题解析和乐观 UI 的点赞/取消点赞
- 应用跟踪
- Color Me Lucky API 端点
- 插件绑定的统计信息、解锁内容和已确认的社区提交

将 .env.example 复制为 .env.local 即可开始。所有密钥都存放在 Convex 环境变量中——不会提交到仓库中。

依赖说明

DexThemes 构建在本仓库无法控制的 Codex 主题导入和设置行为之上。这对项目来说是有意为之的权衡：代码库可以按自身标准维护，但 Codex 兼容性仍可能独立于 DexThemes 发生变化。

安全

- OAuth state 值是加密随机的、一次性使用的、有时间限制的、绑定到发起浏览器，并绑定到 PKCE S256 验证器
- 会话 token 是 256 位加密随机十六进制字符串
- 新的 agent/API key 仅以 SHA-256 摘要形式存储，并且只显示一次
- MCP 身份派生自经过验证的 JWT；工具从不接受用户或所有者 ID
- MCP JWT 需要有效的签名、签发者、受众、作用域和过期时间；身份和网络配额独立执行
- 主题 ID 和调色板会对照规范静态目录进行检查，每种颜色在存储、预览或应用之前都会经过验证
- 月度排名成就需要唯一的已登录非作者采用；仅凭原始复制分析无法解锁它们
- 每日和每周 #1 结果在已关闭的 UTC 周期内最终确定。重复获胜者会在其统计数据中保留每一次胜利，而 Golden Hour 和 Headliner 奖励主题每个账户仅解锁一次。
- 支持者墙列表是明确选择加入的，并且独立于 Patron 访问权限
- 公开成就声明仅限于客户端可观察的操作；账户、主题、排行榜、插件和员工解锁均在服务端派生
- 基于 Cookie 的账户 CORS 受来源限制；仅限 bearer 的已安装插件路由使用无凭据的通配符 CORS，并且仍然需要验证签发者、受众、签名、作用域、过期时间和身份
- HTML 模板中用户控制的字符串会被转义，而 MCP 应用通过 DOM textContent 渲染工具数据
- 代码库中无密钥——仅使用环境变量

验证

在打开 PR 之前，请使用贡献者安全的验证路径：
sh
npm run validate

这会运行轻量级契约测试、文档检查和生产构建。

插件特定的预检：
sh
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/dexthemes
npm audit

MCP 契约测试会验证每个公开的工具都具有 outputSchema 以及显式的 readOnlyHint、openWorldHint 和 destructiveHint 值。

对于可见流程的浏览器覆盖，请运行：
sh
npm run smoke:browser

该应用会将主题页面推荐、主题详情查看、规范分享和导入交接记录为单独的分析事件，以便可以将发现与转化分开衡量。

支持

如需产品帮助、错误报告、DeepSeek Harness 插件问题、功能请求以及账户/隐私路由，请使用 DexThemes 支持 或 打开 GitHub issue。切勿包含凭据、令牌、提示、工作区内容、Cookie 或私人账户数据。

资助

DexThemes 是免费且开源的。如果它对你有用：

- 请我喝杯咖啡 — 支持者可获得专属主题和徽章
- 在 GitHub 上赞助
- 给仓库加星 — 这有助于其他人发现它
- 在 X 上分享主题 — 每次分享都有助于社区成长

许可证

MIT — 由 @Daeshawn 用爱构建。

社区构建。与 OpenAI 无关联。