30分钟掌握Hallmark设计技能

本章要解决的是如何在你的开发环境中安装并集成Hallmark，这样你就能开始使用它来生成独特的UI设计。

首先确保你已经安装了Node.js和npm，因为我们需要这些工具来管理依赖和运行脚本。

我们先安装Hallmark CLI工具。打开终端并输入以下命令：

npm install -g hallmark-cli

这会全局安装Hallmark CLI，让你可以在任何地方调用hallmark命令。

接着验证安装是否成功：

hallmark --version

如果一切正常，你应该能看到当前安装的Hallmark版本号。

如果你遇到权限问题，尝试加上sudo：

sudo npm install -g hallmark-cli

然后我们可以创建一个新的项目目录，并初始化一个新的npm项目：

mkdir my-hallmark-project && cd my-hallmark-project
npm init -y

这会在你的项目文件夹中创建一个基本的package.json文件。

最后，在你的项目中安装Hallmark作为本地依赖：

npm install hallmark

这会把Hallmark添加到项目的node_modules文件夹中，并更新package.json中的dependencies部分。

记住一点：每次使用Hallmark前都要确保你在正确的项目目录下，这样才能保证所有配置和资源都被正确加载。

通过以上步骤，你就完成了Hallmark的安装和集成。现在你可以开始探索它的各种功能了。

本章小结

• 全局安装了Hallmark CLI工具。
• 创建了一个新的Node.js项目。
• 将Hallmark作为本地依赖添加到了项目中。
• 验证了安装是否成功。

理解Hallmark的基本概念和工作流程

本章我们要熟悉Hallmark的核心理念以及它是如何工作的，这样你就能更好地利用这个工具来提升你的设计能力。

首先，确保你已经按照上一章的步骤完成了Hallmark的安装和集成。你需要有一个包含Hallmark作为本地依赖的Node.js项目。

我们先来看一下Hallmark的基本概念：

• Macrostructure: 这是指整体的设计框架或布局。
• Themes: Hallmark提供二十种不同的主题供选择。
• Slop-test Gates: 这些是一系列测试，用于评估生成的内容质量。
• Self-Critique: 生成内容后，会进行自我检查以优化结果。

接下来，我们通过几个具体的命令和操作来理解这些概念是如何结合在一起工作的。

查看可用的主题

hallmark themes

这条命令会列出所有可用的主题名称。记住一点：选择合适的主题可以显著影响最终的设计效果。

使用默认模式生成新的UI设计

hallmark generate "Create a landing page for an e-commerce website"

这条命令会根据你的描述生成一个新的UI设计。预期的结果是一个符合你要求的设计草案，并且应用了随机的一个主题。

执行代码审计以识别反模式

虽然本章主要介绍基本概念，但我们也可以简单了解一下如何执行代码审计：

hallmark audit "path/to/your/design/code"

这条命令会对指定路径下的设计代码进行审计，并指出潜在的问题或反模式。如果你遇到错误信息，请检查路径是否正确或者文件是否存在。

从优秀设计中提取DNA并应用到新项目

为了更好地理解这一点，我们可以使用study命令：

hallmark study "path/to/screenshot.png"

这条命令会让Hallmark分析给定的截图，并返回一份诊断报告以及提取出的设计元素（DNA）。注意：这里的输入应该是一个实际存在的图片路径。

通过以上几个简单的操作，你应该对Hallmark的基本概念有了初步的理解，并知道如何使用它来进行一些基础的操作。记住一点：实践是检验真理的唯一标准，多尝试几次才能真正掌握其中的精髓。

本章小结

• 学习了Hallmark的核心概念：Macrostructure、Themes、Slop-test Gates 和 Self-Critique。
• 使用generate命令创建了一个新的UI设计。
• 使用audit命令进行了简单的代码审计。
• 使用study命令从优秀设计中提取了DNA。

使用默认模式生成新的UI设计

在这章里，我们将学会如何使用Hallmark的默认模式来生成一个新的UI设计。完成这章后，你可以快速上手并生成符合要求的设计页面。

前提是你已经按照前一章安装好了Hallmark，并且有一个可以用来存放生成文件的目录。

我们先跑起来：

hallmark "Build me a landing page for a local bakery — sell pastries and bread. Audience: locals who love baking. Tone: friendly and inviting."

这条命令会根据提供的描述生成一个新的UI设计页面。预期结果是在当前目录下生成一个包含HTML和CSS的文件夹，里面就是你的新设计页面。

如果你遇到错误信息，请确保你的描述清晰具体，并且Hallmark已正确安装。

接着，我们来看一个小例子：

假设你想为一家名为Sweet Treats的本地面包店创建一个网站。你可以这样输入：

hallmark "Design a website for Sweet Treats, a local bakery known for its delicious pastries and bread. The target audience is locals who enjoy baking. The tone should be friendly and welcoming."

运行上述命令后，你会得到一个符合描述的新网页设计。打开生成的HTML文件，就能看到效果了。

本章小结

• 使用hallmark命令根据描述生成新的UI设计。
• 描述应尽量详细具体，以便Hallmark能准确理解需求。
• 生成的结果是一组HTML和CSS文件，可以直接查看和使用。

本章要解决如何通过Hallmark对现有代码进行审计，识别其中的反模式。读完后你能快速检查代码质量，发现潜在问题。

前置条件：你需要已经安装并配置好了Hallmark，并且有一个待审核的代码文件或目录。

我们先从最简单的命令开始：

hallmark audit path/to/your/code

这行命令会扫描指定路径下的代码，并生成一份反模式报告。预期结果是一个详细的报告列表，指出代码中的潜在问题和改进建议。

如果你遇到错误信息，请确保路径正确并且Hallmark已正确安装。常见的错误包括路径不存在或者权限不足。

接着，我们来看一个小例子：

假设你有一个名为my_project的项目，你想检查它的代码质量。你可以这样输入：

hallmark audit my_project/

运行上述命令后，你会得到一个包含多个反模式的报告。这个报告可以帮助你更好地理解和改进你的代码。

本章小结

• 使用hallmark audit <target>命令来审计现有代码。
• 确保提供正确的文件或目录路径。
• 报告会列出代码中的反模式和改进建议。

本章要解决如何使用Hallmark重新设计现有代码以获得不同的视觉效果。读完后你能轻松地为项目生成全新的UI设计，提升用户体验。

前置条件：你需要已经安装并配置好了Hallmark，并且有一个待重新设计的代码文件或目录。

我们先从最简单的命令开始：

hallmark redesign path/to/your/code

这行命令会丢弃现有的结构，保留文本内容、信息架构和品牌元素，然后重建一个新的UI设计。预期结果是一个完全不同的UI设计方案。

如果你遇到错误信息，请确保路径正确并且Hallmark已正确安装。常见的错误包括路径不存在或者权限不足。

接着，我们来看一个小例子：

假设你有一个名为my_project的项目，你想为其生成一个新的UI设计。你可以这样输入：

hallmark redesign my_project/

运行上述命令后，你会得到一个全新的UI设计方案。这个新设计会有不同的颜色、布局和整体感觉，但仍然保留原有的文本内容和结构框架。

本章小结

• 使用hallmark redesign <target>命令来重新设计现有代码。
• 确保提供正确的文件或目录路径。
• 新的设计方案会保留原有内容但具有不同的视觉效果。

本章要解决如何从优秀设计中提取DNA并将其应用到新项目。读完后你能轻松地分析你喜欢的设计，并将其中的精髓应用到自己的项目中。

前置条件：你需要已经安装并配置好了Hallmark，并且有一个你欣赏的设计截图或URL地址。

我们先从最简单的命令开始：

hallmark study screenshot.png

这行命令会从screenshot.png中提取设计的核心元素，如宏观结构、字体搭配和色彩锚点。预期结果是一个包含这些元素的design.md文件。

如果你遇到错误信息，请确保文件路径正确并且图片格式受支持。常见的错误包括路径不存在或者文件类型不受支持。

接着，我们来看一个小例子：

假设你有一张名为awesome_design.png的设计图，你想从中提取设计DNA。你可以这样输入：

hallmark study awesome_design.png

运行上述命令后，你会得到一个名为design.md的文件。打开这个文件，你会发现里面包含了原始设计的一些核心要素。

如果你想直接从URL获取设计DNA，可以这样做：

hallmark study https://example.com/design.jpg

同样，你会得到一个design.md文件，其中包含了从指定URL提取的设计要素。

本章小结

• 使用hallmark study <screenshot|URL>命令来提取优秀设计中的DNA。
• 提取的结果会保存在一个名为design.md的文件中。
• 可以通过本地图片或网络URL进行提取。

本章要解决的问题是如何使用Hallmark来自定义主题，让你的生成设计更加多样化和个性化。读完之后，你就能根据需求选择不同的主题，并应用到你的设计中。

前置条件：确保你已经安装了Hallmark并且能够运行基本命令。你需要有一个之前生成的design.md文件作为基础。

我们先来看看如何列出所有可用的主题：

hallmark themes

这条命令会显示Hallmark支持的所有主题列表。

接着，我们来看一下如何为现有的设计应用一个新的主题。假设我们要给之前的design.md文件应用名为sunset的主题：

hallmark apply sunset design.md -o new_design.md

这条命令会将sunset主题应用到design.md文件中，并将结果保存为new_design.md。

如果你遇到错误信息，请检查主题名称是否拼写正确以及输入文件是否存在。常见的错误包括主题名不存在或者源文件路径不对。

现在我们来看一个小例子：

假设你有一个名为modern_ui.md的设计文件，你想将其转换为一个名为forest的主题样式。你可以这样做：

hallmark apply forest modern_ui.md -o forest_modern_ui.md

运行上述命令后，你会得到一个名为forest_modern_ui.md的新文件。打开这个文件，你会发现原始设计已经被应用上了森林主题的风格。

本章小结

• 使用hallmark themes命令查看所有可用的主题。
• 使用hallmark apply <theme> <input_file> -o <output_file>命令将特定主题应用于现有设计。
• 注意检查主题名称和输入文件路径的准确性以避免常见错误。

问题：安装时报错“command not found: npx”

解答：确保你已经全局安装了 Node.js 和 npm。你可以通过运行 node -v 和 npm -v 来检查是否已正确安装。如果未安装，请访问 Node.js 官网 下载并安装最新版本。

问题：如何在不同的编辑器中使用 Hallmark？

解答：根据你使用的编辑器不同，Hallmark 的安装路径也有所不同：

• Claude Code: 将文件复制到 ~/.claude/skills/hallmark/
• Cursor: 创建一个名为 hallmark.mdc 的文件，并将 SKILL.md 文件的内容（不包括前言部分）粘贴进去，然后放置于 .cursor/rules/ 目录下。
• Codex: 将文件复制到个人目录下的 ~/.codex/skills/hallmark/ 或者项目范围内的 .codex/skills/hallmark/

问题：什么是 "Custom" 模式？它和普通模式有什么区别？

解答："Custom" 模式是当输入的简述没有合适的预设主题时，Hallmark 会从头开始设计页面，而不仅仅是在现有模板上做修改。这种模式允许更独特的创意表达，但需要更多的计算资源和时间来完成。

问题：如何更新 Hallmark 到最新版本？

解答：只需重新运行安装命令即可更新到最新版本：

npx skills add nutlope/hallmark

问题：Hallmark 是否支持对现有的网页进行评分或重设计？

解答：是的，Hallmark 提供了两个相关命令：

• 使用 hallmark audit <target> 可以评估现有代码的质量，返回一个改进建议列表而不做任何修改。
• 使用 hallmark redesign <target> 可以丢弃当前的设计结构，仅保留内容、信息架构和品牌元素，并使用不同的风格重建页面。

问题：与其他类似工具相比，Hallmark 的优势是什么？

解答：Hallmark 的主要优点在于其独特的反 AI 设计理念，能够避免生成看起来像由 AI 自动生成的内容。此外，它提供了多种主题选择以及自定义选项，使得生成的结果更加多样化且符合特定需求。