52,397
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
CSS
语言
创建时间
最近更新
项目能做什么
面向 Claude Code、Cursor 等工具的设计 Skill,旨在消除千篇一律的“AI 模板感”,生成更自然的页面设计。
来源:AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
# Hallmark 中文使用指南
## 项目简介
Hallmark 是由 Together AI 打造、专为 Claude Code、Cursor、Codex 以及 OpenCode 设计的「反 AI 廉价感(Anti-AI-slop)」设计技能插件。它旨在彻底消除 AI 生成网页时常见的套路化痕迹(例如:每个标题上方生硬的 eyebrow 小标签、全大写加宽间距的标签、标题中突兀单色高亮、空洞的占位框架、毫无交互的死表单等),帮助开发者生成具有专业质感、拒绝“一眼 AI”的真实网页。
官网:[usehallmark.com](https://www.usehallmark.com)
---
## 核心功能
- **内置 50 套主题体系**:包含纸质感、排版、配色、表面材质及独立组件纹理,主题仅作为质感基础(material),页面骨架完全根据实际场景动态布局。
- **以任务为核心的架构(Built from the job)**:预约页就聚焦预约、商店页就专注销售,根据页面功能定义视觉重心,杜绝模板化。
- **自定义模式(Custom)**:输入 **custom** 即可跳出预设主题,直接根据提示词和基础门禁规则设计出具备独特概念的页面。
- **支持接入真实产品**:可以直接指向目标 URL、本地 dev server 或应用程序,自动截取真实屏幕截图。
- **自带真实摄影素材**:内置 755 张开源授权摄影图片,根据页面主题自动匹配并附带署名。
- **重构与审计命令**:
- `/hallmark redesign <path>`:在保留原页面内容与业务逻辑(wiring)的前提下重新设计界面。
- `/hallmark audit <path>`:仅对目标页面进行质感与体验门禁审查并输出报告。
- **多层质量门禁机制**:
- **Floor(底线)**:涉及对比度、焦点态、减弱动画设置、杜绝虚构事实、移动端适配崩溃等,未达标绝不上线。
- **Reflex(习惯门禁)**:拦截大模型的常见套路默认行为,有明确设计理由时方可覆盖。
- **Finish(润色校验)**:工艺细节层面的检查,不阻断发布。
- **构建工作流**:
1. 预检项目环境(字体、配色、框架及 `design.md`),收集真实素材与数据;
2. 运行 `scripts/theme.mjs deal` 推荐 3 款合适主题,并由 `draw` 根据任务生成页面骨架;
3. 独立构建首屏(Hero),经过无上下文干扰的纯视觉评审通过后,再展开完整页面开发;
4. 最终在真实浏览器中进行针对 AI 破绽的系统性检查(Lint)。
---
## 适合谁用
- 正在使用 Claude Code、Cursor、Codex 或 OpenCode 进行前端/网页开发的工程师。
- 厌倦了大模型默认生成的“AI 风/通用模板感”网页,需要高品质、真实商业级界面的独立开发者与设计工程师。
---
## 安装步骤
此部分原文未说明,请查看原仓库。
---
## 配置说明
- **主题文件存放位置**:位于 `references/themes/` 目录下(单文件大小不超过 8 KB)。
- **自定义设计规范**:详见 `direction.md` 文件。
- **锁定设计规范**:构建时会读取项目内已锁定的 `design.md` 文件。
- *更多具体的配置文件及环境要求,原文未说明,请查看原仓库。*
---
## 常见问题
- **Q: 使用同一个主题生成的页面会千篇一律吗?**
- **A**: 不会。Hallmark 的主题仅定义材质、字体和调色板,不锁定内容与模块顺序。即使针对同一主题输入不同提示词,也会生成截然不同的页面。
- **Q: 为什么生成的表单不会自动发送假数据?**
- **A**: Hallmark 设有严格的 Floor 门禁,禁止假表单、虚构数据和假交互,构建阶段仅接受并呈现真实材料。
原始 README 摘录(英文原文,节选前 3000 字符)
# Hallmark
**A design skill for Claude Code, Codex, Cursor and OpenCode that refuses to look AI-generated.**
[usehallmark.com](https://www.usehallmark.com) · fifty themes · custom on request · redesign and audit by name
Made by Together AI.
<p align="center">
<img src="site/OG-hallmark.png" alt="Hallmark, the design skill that ends AI slop" />
</p>
Hallmark holds a hard floor and then gets out of the way. It deals three themes from a catalog of fifty materials, builds the page around what the visitor came to do, and lints the result in a real browser against the tells that read as machine-made: the eyebrow above every heading, tracked-capital labels, one coloured word in a headline, a page of empty frames or nothing but photographs, a hero that misses its screen, an email sign-up at the end of every page, a form that says thanks without sending anything. A fresh-context reviewer gets the last word.
The gates come in tiers. The **Floor** never ships (contrast, focus, reduced motion, invented facts, a broken phone layout). **Reflex** gates are the defaults a model falls into; a build with a reason may overrule one on the record. **Finish** checks are craft detail that never blocks a ship.
## New in v2
- **Fifty themes.** Each is a material (paper, type, colour, surfaces, its own components and texture) with a picture of a finished page, and the build lays out its own page in it.
- **Built from the job.** A booking page books, a shop sells, a newsletter subscribes: the action sits where the category puts it, and the page ends on it.
- **Custom.** Ask for a custom page and Hallmark designs from your prompt alone, under the same rules and checks.
- **Your real product.** Point it at a URL, a dev server or an app and it captures the screenshots itself.
- **Real photographs.** 755 openly licensed photos, picked per subject and credited on the page.
- **Redesign and audit.** `/hallmark redesign <path>` rebuilds a page and keeps its content and wiring; `/hallmark audit <path>` only reports.
## Themes
<table>
<tr>
<td width="20%"><a href="https://www.usehallmark.com/themes/dusk/"><img src="docs/screenshots/dusk.jpg" alt="Dusk theme: Closewise, bank reconciliation" /></a></td>
<td width="20%"><a href="https://www.usehallmark.com/themes/cobalt/"><img src="docs/screenshots/cobalt.jpg" alt="Cobalt theme: Relay, a webhook API" /></a></td>
<td width="20%"><a href="https://www.usehallmark.com/themes/studio/"><img src="docs/screenshots/studio.jpg" alt="Studio theme: Field Office, an identity studio" /></a></td>
<td width="20%"><a href="https://www.usehallmark.com/themes/atelier/"><img src="docs/screenshots/atelier.jpg" alt="Atelier theme: Maison Orla, a fragrance atelier" /></a></td>
<td width="20%"><a href="https://www.usehallmark.com/themes/ribbon/"><img src="docs/screenshots/ribbon.jpg" alt="Ribbon theme: Lull, a sleep sounds app" /></a></td>
</tr>
<tr>
<td><b>Dusk</b><br/><sub>Closew
阅读完整原文
商业机会分析 AI 生成
高级商业主题与设计资产订阅库 (Pro Themes & Components)
| 产品构想 | 在开源 50 套基础主题之上,构建面向高转化率场景(SaaS 官网、D2C 电商、Web3、创作者主页等)的高级主题包,附带精心调校的配套组件、自适应交互和免版税商业摄影资源。 |
| 核心功能 | 定期更新的独占主题材料(Material)、开箱即用的前端交互组件、配套的 Claude Code/Cursor 专属 Prompt 与规则注入文件、商业授权资源包。 |
| 目标用户 | 独立出海开发者、AI 编程工具深度用户、无专业 UI 设计师的中小型项目团队。 |
| 难度/周期 | 中等 · 2-4 周 · 成本:极低(主要为设计资产制作与网站搭建成本) |
| 收费模式 | 买断制(如 $49-$99)或会员订阅制(如 $19/月) |
| 竞争风险 | 设计风格易被复制或扒取,需依赖持续的风格上新和配套工作流粘性来维持壁垒。 |
| 依据 | 数据支持的判断 |
CI/CD 自动化“防 AI-slop”设计质量检测网关 (Design Linter Cloud)
| 产品构想 | 将项目中的 `/hallmark audit` 规则和无头浏览器(Headless Browser)审查逻辑封装为 GitHub Action / CLI 工具云服务,在代码提交或 PR 阶段拦截具有“AI 味道”或可用性硬伤的页面。 |
| 核心功能 | GitHub Actions / GitLab CI 深度集成、视觉与 DOM 规范自动检测(对比度、排版规整度、AI 特征语法分析)、PR 自动生成红线报告与修复建议、多端截图合规性验证。 |
| 目标用户 | 大量依赖 AI 辅助写代码的前端团队、工程效能负责人、数字营销与增长工程团队。 |
| 难度/周期 | 较高 · 1-2 个月 · 成本:中等(无头浏览器截图渲染及计算资源费用) |
| 收费模式 | 按仓库/检查次数的 Freemium SaaS 订阅制(免费层 + $29/月起商业版) |
| 竞争风险 | 审核标准主观性较强,误报可能影响开发流程,需要极佳的配置自由度。 |
| 依据 | 已验证事实 |
AI 网页一键克隆与重设计 SaaS 平台 (Instant Redesign Webapp)
| 产品构想 | 基于项目 `/hallmark redesign <url>` 核心能力,封装为纯网页端 SaaS。用户输入任意现存 URL 或本地 HTML 代码,系统自动保留业务逻辑与文本结构,换皮生成具备高质感现代设计的新版前端代码。 |
| 核心功能 | 在线 URL 抓取与分析、多主题实时一键预览、视觉代码差异比对、保持原有路由与表单逻辑的代码打包导出(React/Tailwind/HTML)。 |
| 目标用户 | 老旧网站站长、外包接单团队、缺乏设计能力的非技术型创业者。 |
| 难度/周期 | 中等 · 3-6 周 · 成本:低到中等(API Token 与服务器成本) |
| 收费模式 | 免费试用 1 次 + 按次付费($9/次)或额度包($49/10次) |
| 竞争风险 | 复杂交互的前端动态应用抓取和代码解构难度大,对纯静态和轻动态页面效果最好。 |
| 依据 | AI推测 |
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| tiroshlab/3ca | 用于复现肿瘤内异质性转录特征相关论文数据分析的研究代码。 | 142 | R |
| mtisza1/Cenote-Taker2 | 用于发现和注释高度分歧病毒重叠群的分析工具。 | 56 | Shell |
| vweevers/hallmark | 附带 linter 检查与自动修复功能的 Markdown 风格指南。 | 52 | JavaScript |
| Agoengwew/wew | 收集印尼各大电视频道直播源的 IPTV M3U 播放列表。 | 36 | - |
| sb895/Hallmarks-of-Cancer | 经专家标注的癌症特征(Hallmarks of Cancer)语料库。 | 22 | - |
| georgeguimaraes/hallmark | 基于 Vectara HHEM 模型的 Elixir 幻觉检测工具。 | 19 | Elixir |
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 |
| 社区活跃 | Star 52,397 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
快速开始(以仓库 README 为准)
git clone https://github.com/Nutlope/hallmark.git cd hallmark # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。