1. 项目概述：Claude Shorthand 是什么，以及它解决了什么问题

如果你和我一样，日常工作中深度依赖 Claude 这类大型语言模型（LLM）来辅助编程、文档撰写和头脑风暴，那你一定对重复输入那些冗长的提示词（Prompt）感到疲惫。每次开启一个新对话，都要重新粘贴一遍“你是一个资深的Python开发专家，请遵循PEP 8规范...”或者“请以技术文档的风格，帮我分析...”，不仅效率低下，还容易出错。 gladehq/claude-shorthand 这个项目，正是为了解决这个痛点而生的。

简单来说，Claude Shorthand 是一个浏览器扩展，它允许你为任何一段常用的文本（尤其是复杂的提示词）创建一个简短的“缩写”或“快捷指令”。之后，在任何支持 Claude 的网页界面（如 Claude.ai 官网或某些集成了 Claude API 的应用）中，你只需要输入这个缩写，它就会自动展开为你预设的完整文本。这就像给你的 Claude 对话装上了“代码片段”功能，或者理解为一种专为提示词设计的、本地化的文本扩展工具。

它的核心价值在于将提示词工程从“手动复制粘贴”的体力活，升级为“一键调用”的自动化流程。对于需要高频使用固定工作流（如代码审查、文章润色、数据分析指令）的开发者、写作者或研究人员，它能显著提升与 AI 协作的流畅度和专业性。我使用了一段时间后，感觉它不仅仅是省了几次粘贴操作，更重要的是它让我更愿意去设计和迭代我的高质量提示词，因为我知道一旦设计好，调用它的成本几乎为零。

2. 核心功能与设计思路拆解

2.1 功能全景：不止于文本替换

初看 Claude Shorthand，你可能认为它就是一个简单的文本扩展工具，类似 macOS 的 TextExpander 或 Windows 的 AutoHotkey。但它在设计上紧扣了与 Claude 这类 AI 助手交互的特定场景，因此具备一些贴心的特性。

首先， 它深度集成于浏览器环境 。这意味着它的触发和替换动作发生在网页输入框内，与网页本身无关，因此理论上可以在任何网站的文本输入框中使用，只要该网站没有刻意屏蔽这类扩展。当然，其主要优化场景是 Claude 的聊天界面。

其次， 它支持动态占位符 。这是它区别于普通文本替换工具的关键。你可以在定义的快捷指令中插入像 {{date}} 、 {{time}} 这样的变量，甚至支持自定义的输入提示。例如，你可以设置一个缩写 ::review ，其对应的展开文本是：“请以资深架构师的视角，评审以下 {{language}} 代码： {{code}} ”。当你输入 ::review 并按下触发键（如 Tab 或 Enter）后，扩展会先弹出一个简易表单，让你填写 language 和 code 这两个变量的值，然后再将填充后的完整提示词插入输入框。这个功能极大地增强了快捷指令的灵活性和复用性。

再者， 它具备简单的组织管理功能 。你可以将快捷指令分组，例如“编程助手”、“写作模板”、“日常办公”等，方便在指令数量增多后进行管理。所有数据都存储在浏览器的本地存储中，保证了隐私性，但也意味着换一台电脑或浏览器就需要重新配置。

2.2 设计哲学：降低提示词的使用摩擦

这个项目的设计思路非常清晰： 最大化提示词的复用价值，最小化其调用成本 。在 AI 协作工作流中，高质量的提示词本身就是一种宝贵的资产。一个经过精心调试、能稳定输出优秀结果的提示词，其价值不亚于一段脚本或一个函数。

然而，如果调用这个“函数”需要你每次都去翻找历史记录或文档，然后小心翼翼地复制粘贴，其使用频率和效用就会大打折扣。Claude Shorthand 所做的，就是为这些“提示词函数”建立一个本地的、快捷的调用系统。它通过几个关键设计实现了这一目标：

1. 极简的触发方式 ：通常以双冒号 :: 开头（可配置），符合许多程序员对“指令”的直觉，且不易与正常输入冲突。
2. 上下文无关性 ：无论你在哪个对话中，只要输入缩写即可触发，打破了对话隔离的限制。
3. 即时反馈 ：输入缩写时，扩展通常会有一个下拉提示列表，显示匹配的快捷指令及其预览，让你能快速确认和选择。

这种设计使得从“想到要用某个提示词”到“提示词已就位”的路径变得极其短暂和顺畅，有效降低了心理和操作上的双重摩擦，鼓励用户积累和复用最佳实践。

注意 ：由于这是一个浏览器扩展，其功能受限于浏览器提供的 API 和网页的 DOM 结构。在某些高度动态或使用复杂框架（如某些单页面应用）的网页上，自动插入文本的功能可能会偶尔失效，需要手动点击输入框或刷新页面。

3. 安装、配置与核心操作详解

3.1 获取与安装

Claude Shorthand 是一个开源项目，源代码托管在 GitHub 上。对于普通用户，最方便的安装方式是通过浏览器的官方扩展商店。

对于 Chrome、Edge、Brave 等 Chromium 内核浏览器 ：

1. 打开 Chrome 网上应用店。
2. 搜索 “Claude Shorthand”。
3. 找到由 “gladehq” 发布的扩展，点击“添加到 Chrome”。

对于 Firefox 浏览器 ：

1. 打开 Firefox 附加组件商店（AMO）。
2. 搜索 “Claude Shorthand”。
3. 进行安装。

安装完成后，浏览器工具栏区域会出现 Claude Shorthand 的图标。首次点击，或者在任何网页中按下快捷键（默认可能是 Alt+Shift+S ，具体需在扩展管理页面查看），即可打开快捷指令的管理面板。

如果扩展商店没有，或者你想使用最新的开发版本，也可以从 GitHub 仓库的 Releases 页面下载打包好的 .crx (Chrome) 或 .xpi (Firefox) 文件，然后通过浏览器的“开发者模式”加载已解压的扩展程序。不过对于大多数用户，商店安装是推荐且最稳定的方式。

3.2 创建你的第一个快捷指令

安装好后，我们立刻来创建一个最实用的快捷指令：一个用于 Python 代码审查的提示词。

1. 打开管理面板 ：点击浏览器工具栏的 Claude Shorthand 图标。

2. 创建新指令 ：在管理面板中，找到“New Shorthand”或“添加”按钮。

3. 填写核心信息 ：

   • Name (名称) ： py-code-review 。这是一个内部标识，便于你自己管理。
   • Abbreviation (缩写) ： ::reviewpy 。这是你在输入时要触发的短命令。我习惯用 :: 开头，后跟描述性单词。
   • Description (描述) ： Python代码审查（PEP8， 错误处理， 性能） 。可选，但有助于日后回忆。
   • Snippet (片段) ：这里就是粘贴或编写完整提示词的地方。例如：

     请你扮演一位资深 Python 开发专家，对以下代码进行严格的审查。请重点关注：
     1.  **PEP 8 规范符合性**：检查缩进、命名约定、空格使用等。
     2.  **潜在错误与边界情况**：指出可能引发运行时错误、逻辑错误或未处理的异常情况。
     3.  **代码结构与可读性**：函数/类是否职责单一？注释是否清晰？复杂度是否过高？
     4.  **性能优化建议**：是否存在低效的循环、重复计算或不必要的数据结构？
     5.  **安全性考虑**：是否有注入风险、不安全的反序列化等？
     
     请按以下格式回复：
     - **总体评价**：[简要总结]
     - **详细问题**：以列表形式列出发现的问题，每个问题注明行号（如果可能）和建议修改。
     - **优化建议**：[可选的性能或结构优化建议]
     - **修改后代码**：[如果问题简单，直接给出修改后的代码片段]
     
     待审查的代码：
     ```python
     {{code}}
     

   注意，我在提示词中预留了一个 {{code}} 占位符。这意味着当我触发这个指令时，扩展会要求我先输入具体的代码内容。

4. 设置变量（可选但推荐） ：在 Snippet 编辑器下方，你应该能看到一个“Variables”或“变量”区域。因为我们在片段中使用了 {{code}} ，系统会自动识别它为一个变量。你可以点击它进行配置：

   • Label (标签) ： 待审查的 Python 代码
   • Type (类型) ：选择 Textarea （多行文本框），因为代码通常是多行的。
   • Default Value (默认值) ：可以留空。

5. 分组 ：你可以将它分配到已有的分组（如“Programming”）或新建一个分组。

6. 保存 ：点击“Save”或“保存”。

3.3 实战调用：体验行云流水的操作

现在，打开 claude.ai 或任何你常用的 Claude 界面，新建一个对话。

1. 在聊天输入框中，键入你刚才设置的缩写 ::reviewpy 。
2. 此时，Claude Shorthand 扩展会检测到你的输入。通常会有两种交互方式：
   • 方式一（自动提示） ：输入 ::rev 时，可能就会出现下拉提示，你可以用方向键选择 ::reviewpy 然后按 Tab 键触发。
   • 方式二（完整输入后触发） ：输入完整的 ::reviewpy 后，直接按你设置的“展开快捷键”（默认为 Tab 键）。
3. 按下触发键后，一个弹出窗口会出现，里面是你为 {{code}} 变量设置的文本框，标签是“待审查的 Python 代码”。
4. 将你想要审查的代码粘贴进这个文本框，点击“插入”或“确定”。
5. 奇迹发生了：完整的、包含了你刚刚粘贴的代码的提示词，瞬间被插入到了 Claude 的输入框中，格式完好，等待你的最终确认或直接发送。

这个过程比“打开一个文档 -> 找到提示词 -> 复制 -> 切换回浏览器 -> 粘贴”要快得多，也优雅得多。一旦习惯，你就再也回不去了。

4. 高级用法与效率提升技巧

4.1 巧用变量构建动态提示词

变量是 Claude Shorthand 的超级武器。除了简单的文本替换，你可以利用变量创建高度定制化的提示词模板。

场景一：日报/周报生成器 缩写： ::dailyreport 片段：

请根据以下信息，帮我生成一份专业的工作日报。

**日期**：{{date:YYYY-MM-DD}}
**今日主要工作**：
{{work_items}}
**遇到的问题及解决方案**：
{{problems}}
**明日计划**：
{{plans}}
**其他备注**：
{{notes}}

变量设置：

• {{date}} ：类型选择“Date”，可以设置默认值为当前日期。
• {{work_items}} , {{problems}} , {{plans}} , {{notes}} ：均设为“Textarea”类型，方便输入多行内容。

每天早上，输入 ::dailyreport ，按 Tab，一个结构清晰的表单弹出，填好后一键生成格式完美的日报草稿，直接发给 Claude 润色或补充细节。

场景二：多语言代码转换助手 缩写： ::convertcode 片段：

请将以下 `{{source_lang}}` 代码转换为 `{{target_lang}}` 代码。要求：
1. 保持核心逻辑和算法完全一致。
2. 遵循目标语言 `{{target_lang}}` 的最佳实践和惯用语法。
3. 对转换过程中可能存在的语言特性差异进行简要说明。

**源代码（{{source_lang}}）**：
```{{source_lang}}
{{source_code}}

请输出转换后的 {{target_lang}} 代码及说明 。

变量设置：
- `{{source_lang}}` 和 `{{target_lang}}`：类型设为“Text”，可以预设一些选项如 Python, JavaScript, Go, Java。
- `{{source_code}}`：类型设为“Textarea”。

这个模板将原本需要多次修改的提示词固化，你只需要关心核心的源代码和语言选择。

### 4.2 分组与搜索：管理你的提示词库

当快捷指令积累到几十个时，有效的管理就变得至关重要。

**分组策略**：我建议按**使用场景**而非技术领域进行一级分组。例如：
- `Workflow`：包含日报、周报、邮件起草、会议纪要整理等通用工作流。
- `Dev/Code`：包含代码审查、解释、调试、生成测试等所有编程相关指令。
- `Dev/API`：专门用于生成 API 文档、分析 curl 命令等。
- `Writing`：包含文章大纲、段落润色、风格模仿、翻译等指令。
- `Analysis`：用于数据分析、图表描述、总结长文本等指令。

这样，当我在编程时，我主要待在 `Dev/` 分组下；当我在写文档时，则切换到 `Writing` 分组。你可以在管理面板中通过拖拽轻松调整分组。

**善用搜索**：管理面板顶部的搜索框是实时过滤的。如果你模糊记得一个指令的缩写或描述中的某个词，直接搜索比滚动查找快得多。例如，输入“review”可以找到所有包含代码审查的指令。

### 4.3 快捷键与触发方式的个性化

默认的触发方式（`::` 缩写 + `Tab`）可能不适合所有人。你可以在扩展的设置选项中进行调整。

- **触发前缀**：你可以将 `::` 改为 `!!`、`^^` 或其他任何你喜欢的、不易在正常输入中出现的组合。
- **展开快捷键**：`Tab` 键是常见选择，但有时在代码编辑环境中会冲突。你可以改为 `Enter`（需小心，容易误触发）或 `Ctrl+Space` 这类组合键。我个人的习惯是保持 `Tab`，因为它在输入缩写后按下非常自然，类似于代码补全。
- **激活/停用**：在某些不需要它的网站上，你可以通过点击扩展图标临时停用，避免干扰。

## 5. 常见问题与故障排查实录

即使工具设计得再精良，在实际使用中也会遇到一些“坑”。以下是我和社区中遇到的一些典型问题及解决方法。

### 5.1 指令不触发或无法插入文本

这是最常见的问题，通常与网页的加载状态或输入框焦点有关。

1.  **页面未完全加载**：有些单页面应用（SPA）动态加载内容。如果页面一打开就急着输入缩写，可能扩展还未“捕获”到输入框。**解决方法**：稍等一两秒，或者先点击一下输入框让其获得焦点，再输入缩写。
2.  **输入框不是标准元素**：一些网站使用自定义的、非标准的 `<textarea>` 或 `<div contenteditable>` 来实现输入框，扩展的脚本可能无法正确识别。**解决方法**：尝试在输入框内右键，如果能看到扩展的上下文菜单选项（如“插入快捷指令”），可以尝试从这里手动选择。如果不行，可能该网站兼容性不佳，可以到项目的 GitHub Issues 页面反馈。
3.  **快捷键冲突**：如果你自定义了展开快捷键（如 `Tab`），而当前网页或某个浏览器插件也绑定了相同的快捷键，就会冲突。**解决方法**：在扩展设置中更换一个不常用的快捷键，例如 `Ctrl+Shift+Space`。
4.  **扩展未启用**：检查浏览器工具栏上的 Claude Shorthand 图标是否呈灰色（禁用状态）。如果是，点击它尝试启用，或者去浏览器的扩展管理页面检查是否被意外禁用。

### 5.2 变量表单弹出位置异常或显示不全

弹出表单的样式和位置由扩展的 CSS 控制，可能会与某些网站的全局样式发生冲突。

- **现象**：表单出现在屏幕角落、被遮挡、或者样式错乱。
- **解决方法**：这通常是 CSS 特异性冲突。可以尝试刷新页面。如果问题持续，一个临时的变通方法是：在触发缩写后，不要填写表单，而是先关闭它。然后通过点击浏览器工具栏的扩展图标，打开管理面板，在对应的快捷指令上通常会有“编辑并预览”的选项，在那里你可以更稳定地填写变量并插入。

### 5.3 数据同步与备份问题

Claude Shorthand 的数据默认存储在本地。这意味着：
- **换电脑/重装系统后，指令会丢失**。
- **在不同浏览器（Chrome/Firefox）之间无法同步**。

**备份策略**：
1.  **手动导出**：在扩展的管理面板中，寻找“Settings”、“Options”或齿轮图标，里面通常有“Export”或“备份”功能。你可以将全部指令导出为一个 JSON 文件，妥善保存。
2.  **定期备份**：建议在积累了一批有价值的指令后，立即进行导出备份。可以将这个 JSON 文件保存在云盘或代码仓库中。
3.  **导入恢复**：在新环境安装扩展后，通过同一设置页面的“Import”功能，上传之前备份的 JSON 文件即可恢复所有指令和分组。

> **重要心得**：不要把所有鸡蛋放在一个篮子里。我曾因为浏览器崩溃导致本地数据损坏，丢失了精心调试的几十个指令。自那以后，我养成了每周手动备份一次的习惯，并将 JSON 文件保存在 Git 仓库里，用提交信息记录每次重要的提示词更新。

### 5.4 性能与资源占用

对于拥有上百条快捷指令的用户，可能会担心扩展的性能。

- **实测感受**：在我的日常使用中（约50条指令），扩展的弹出和搜索速度几乎没有延迟，对浏览器性能的影响微乎其微。
- **优化建议**：如果感觉卡顿，首先检查是否是指令中包含了极其冗长的片段（比如上万字的模板）。其次，可以清理不再使用的旧指令。浏览器的扩展管理页面也可以查看每个扩展的资源占用情况，Claude Shorthand 通常属于非常轻量级的。

## 6. 安全与隐私考量

作为一个处理你频繁使用的提示词的工具，安全隐私问题值得关注。

1.  **数据存储位置**：如前所述，所有数据（缩写、完整片段、变量定义）默认都存储在**你的浏览器本地**（通常是 IndexedDB 或 LocalStorage）。这意味着数据没有离开你的电脑，项目作者或任何第三方服务器都无法访问。这是最大的隐私保障。
2.  **网络请求**：该扩展的核心功能是文本替换，理论上不需要向外部服务器发送你的指令内容。你可以通过浏览器的“开发者工具” -> “网络”选项卡进行监控，确认其在常规使用中没有发起意外的网络请求。
3.  **权限审查**：安装时，注意它要求的权限。通常需要“在所有网站上读取和更改网站数据”这类权限，这是为了能在任意网页的输入框内工作。这是此类文本扩展工具的通用权限要求，但用户应有知情权。
4.  **开源审计**：由于项目是开源的，其代码透明，任何有能力的开发者都可以审查其代码，确认没有后门或数据收集行为。对于注重隐私的用户，这是一个重要优势。

**个人建议**：避免在快捷指令中存储极其敏感的信息，如密码、密钥、个人身份信息等。虽然数据在本地，但以防万一。对于涉及公司核心代码或数据的提示词，请遵循你所在组织的安全规定。

## 7. 同类工具对比与选型思考

Claude Shorthand 并非市场上唯一的选择。了解同类工具，能帮助你做出更适合自己的选择。

| 工具名称 | 类型 | 核心特点 | 适用场景 | 与 Claude Shorthand 对比 |
| :--- | :--- | :--- | :--- | :--- |
| **Claude Shorthand** | 浏览器扩展 | 轻量、专注 Claude/网页输入、支持变量、开源免费 | 主要在网页端与 Claude 等 AI 对话，需要动态提示词 | **本项目**，优势是场景聚焦、简单直接、隐私性好。 |
| **TextExpander** | 桌面/云应用 | 功能极其强大、跨设备同步、支持富文本/图片、脚本 | 全平台、全应用的文本扩展，需求复杂，预算充足 | 功能更全面，但更重、更贵。Claude Shorthand 是它在 AI 提示词领域的轻量级替代。 |
| **Espanso** | 开源跨平台文本扩展器 | 免费、开源、跨平台、功能强大、可编程 | 程序员、极客用户，需要在系统级进行文本扩展 | 比 Claude Shorthand 更底层、更强大，但配置更复杂（需写 YAML）。Claude Shorthand 开箱即用。 |
| **Alfred (macOS)** | 生产力应用 | macOS 神器，其 Snippets 功能可做文本扩展 | macOS 用户，已在使用 Alfred 作为启动器 | 集成在 Alfred 生态内，方便。但仅限于 macOS，且非专门为 AI 提示词优化。 |
| **浏览器书签** | 土办法 | 将提示词保存为书签，通过 JavaScript 注入 | 极度简单、零成本的需求 | 功能单一，无法支持变量、分组和便捷管理，是“能用但难用”的方案。 |

**选型总结**：
- 如果你的**核心场景就是与网页版的 Claude/ChatGPT 等 AI 对话**，并且希望一个**免费、轻量、专注**的工具，那么 **Claude Shorthand 几乎是当前最佳选择**。
- 如果你需要**在全系统任何地方（包括桌面应用）** 进行文本扩展，且不介意付费，那么 **TextExpander** 是行业标杆。
- 如果你是**技术爱好者，喜欢折腾，追求跨平台和可编程性**，**Espanso** 值得深入研究。
- 如果你只是**偶尔使用一两个固定提示词**，用**浏览器书签**凑合一下也行，但长期来看效率损失很大。

我个人选择 Claude Shorthand，正是因为它完美匹配了我“90%的 AI 对话在浏览器中完成”的工作流，它的简洁和专注反而成了最大的优点，没有不必要的功能干扰。

## 8. 打造个人高效的提示词工作流

工具本身是死的，融入工作流才能产生价值。经过几个月的使用，我总结出了一套与 Claude Shorthand 配合的高效工作流。

**第一步：收集与识别高频模式**
不要一开始就想着创建几十个指令。在最初的一两周，正常使用 Claude。每当你在不同对话中**第三次复制粘贴同一段或类似提示词**时，这就是一个明确的信号——它应该被做成快捷指令。例如，我发现自己经常要求 Claude “用中文，以要点形式总结以下文本”，这就是 `::sumzh` 指令的由来。

**第二步：迭代与优化提示词**
将一段文本保存为快捷指令后，你获得了快速试验和迭代的能力。在下次使用时，如果觉得输出结果不理想，你可以立刻打开 Claude Shorthand 的管理面板，修改那个指令的片段内容，然后再次触发测试。这个“修改-测试”的循环变得非常快，鼓励你不断打磨出效果最佳的“超级提示词”。

**第三步：建立分类与命名规范**
随着指令增多，一套自洽的命名和分类体系至关重要。我的命名规范是：
- `::` 开头。
- 主要功能词在前，如 `sum`（总结）、`rev`（审查）、`write`（写作）、`ask`（提问）。
- 后接语言或领域限定，如 `zh`（中文）、`py`（Python）、`sql`（SQL）。
例如：`::sumzh`, `::revpy`, `::asksql`。
分类则如前所述，按场景划分。

**第四步：定期回顾与清理**
每个月底，花10分钟浏览一遍你的指令库。你会发现有些指令创建后从未使用，有些指令的功能可以被另一个更通用的指令覆盖。果断删除那些冗余的指令，保持库的整洁和高效。同时，这也是一个回顾和优化现有指令的好时机。

**一个进阶技巧：指令组合**
有时，一个复杂任务可以分解为几个步骤，每个步骤对应一个快捷指令。例如，分析一个复杂问题：
1.  先用 `::sumzh` 总结问题背景。
2.  将总结和具体问题用 `::ask` （一个精心设计的、引导深度思考的提问模板）组合成新的提问。
3.  得到的答案如果需要代码，再用 `::revpy` 审查。
这种“流水线”式的用法，能将 AI 的能力更系统化地为你所用。

Claude Shorthand 就是这样一款工具，它本身不直接生产内容，但它通过极大地降低高质量提示词的调用成本，让你更愿意去创造和使用高质量提示词，从而间接地提升了 AI 作为你协作者的整体产出质量和你的工作效率。它解决的，正是从“拥有好工具”到“流畅使用好工具”之间最后的那一点摩擦。