主题工坊 daeshawnballard/dexthemes

DexThemes

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

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

能做什么

- 浏览 100+ 主题，涵盖动漫、电子游戏、电影、漫画、星座等
- 实时预览 —— 用真实代码看每个主题的效果，深色和浅色变体并排对比
- 主题详情 —— 把中间工作区从模拟聊天切换到完整调色板、来源和导入视图
- 可被索引的公开页面 —— 每个有效主题变体都有规范详情页，带渲染预览和相关主题
- Codex 交接 —— 复制导入字符串，并为你打开 Codex 设置
- DeepSeek Harness 插件 —— 通过 Harness 受保护的主题服务浏览并一键应用成对调色板，或通过受限的公开 MCP 工具配置档创建、搜索、校验它们
- 自己动手做 —— 内置主题构建器让你设计和分享自定义主题
- 用描述创建 —— 服务端 DexThemes AI 草稿有边界限制，生成可编辑的浅色/深色主题，未经单独用户操作绝不应用
- Harness 上下文 —— 为 Codex、DeepSeek Harness 和文档中提到的未来适配器预览，无需 fork 规范主题库
- 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 中，用其精确的 registry 产物完整跑通，包括 Apply/Revert、重启恢复、离线回退、GitHub Device Flow、连接活动确认、有界 Statsig 投递，以及 Creator 模式聊天 Apply/Stop。参见兼容性、重启、升级与卸载指南、0.6.4 发布回执、更新日志、GitHub releases 和支持渠道。

打开 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 → App shell
templates/ → Source templates for the generated shell and service worker
index.template.html → Source template for the generated shell
sw.template.js → Source template for the generated service worker
styles/ → CSS split by domain (tokens, layout, sidebar, preview, builder, mobile, overlays)
index.css → Manifest entry for domain-scoped stylesheets
public/ → Source-of-truth static files emitted to the deploy root during build
manifest.json → PWA manifest source
robots.txt → Search crawler directives
sitemap.xml → Generated static sitemap fallback; /sitemap.xml is live at runtime
public-pages.css → Server-rendered theme, guide, and collection page styles
llms.txt → Agent-facing summary docs source
llms-full.txt → Full agent-facing docs source
favicon.svg → Root favicon source
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 → 数据库 schema users.ts → 用户管理与会话 likes.ts → 点赞/取消点赞系统 themes.ts → 社区主题提交与发布排期 indexNow.ts → IndexNow 发布通知 action 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 上，负责：

- GitHub OAuth，带一次性、绑定浏览器的 state 与 PKCE S256
- 签发经 GitHub 认证的智能体/API key，落库时只存 SHA-256 哈希
- 为插件提供 OAuth 2.1 资源服务器支持，上游登录走 GitHub
- 可选的已安装集成账号授权，走 DexThemes Connect GitHub Device Flow，由 Convex 代理；GitHub token 留在服务端，短时效的 DexThemes 会话留在插件内存里
- 浏览器会话管理（生产环境用 HttpOnly 同站 cookie，token 交接只用于 localhost/dev）
- 社区主题提交与审核
- 社区主题发布后发送 IndexNow 通知
- 点赞/取消点赞，带规范主题解析与乐观 UI
- 应用追踪
- Color Me Lucky API 端点
- 插件维度的统计、解锁，以及已确认的社区提交

把 .env.example 复制成 .env.local 就能开始。所有密钥都放在 Convex 环境变量里——仓库里不提交任何密钥。

依赖说明

DexThemes 建立在 Codex 主题导入与设置行为之上，而这两者不受本仓库控制。这是项目有意做出的取舍：代码库可以按自己的节奏维护，但 Codex 兼容性仍可能独立于 DexThemes 发生变化。

安全

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

验证

在提交 PR 之前，请使用贡献者安全的验证路径： sh
DEXTHEMES_SKIP_CLEAN=1 npm run validate

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

插件安装请参阅 Codex 插件指南。

仓库网站和 MCP 源码的依赖预检： sh
npm audit

MCP 契约测试会验证每个对外暴露的工具都有 outputSchema，以及显式的 readOnlyHint、openWorldHint 和 destructiveHint 值。

如需覆盖可见流程的浏览器测试，请运行： sh
npm run smoke:browser

应用会将主题页推荐、Theme 详情页浏览、权威分享和导入交接分别记录为独立的分析事件，这样就能把发现与转化分开衡量。

支持

如需产品帮助、缺陷报告、DeepSeek Harness 插件问题、功能请求以及账号/隐私相关分流，请使用 DexThemes 支持 或 提交 GitHub issue。切勿包含凭据、token、提示词、工作区内容、Cookie 或私有账号数据。

资助

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

- 请我喝杯咖啡 —— 支持者可获得专属主题和徽章
- 在 GitHub 上赞助
- 给仓库点个 Star —— 这能帮更多人发现它
- 在 X 上分享主题 —— 每次分享都能帮助社区成长

许可证

MIT —— 由 @Daeshawn 用爱打造。

社区构建。与 OpenAI 无关联。