Warp，专为多 AI 智能体编程而生
^{支持 macOS, Linux 和 Windows}

`fabric`

`fabric` 是一个使用 AI 来增强人类能力的开源框架。

English · 中文

更新日志 • 什么是 Fabric 及其原因 • 哲学理念 • 安装指南 • 使用方法 • REST API • 示例 • 直接使用 Patterns • 自定义 Patterns • 辅助应用 • 元数据

什么是 Fabric 及其原因

自 2022 年底现代 AI 兴起以来，我们看到了海量的用于完成任务的 AI 应用。有成千上万的网站、聊天机器人、移动应用和其他接口可供使用。

这一切都非常令人兴奋且强大，但是_将这些功能整合到我们的生活中并不容易_。

换句话说，AI 没有能力问题——它有的是整合问题。

Fabric 的诞生就是为了解决这个问题，通过创建和组织 AI 的基本单元——Prompt（提示词）本身！

Fabric 按照现实世界中的任务来组织 Prompt，允许人们在一个地方创建、收集和组织他们最重要的 AI 解决方案，以便在他们最喜欢的工具中使用。如果你喜欢命令行，你甚至可以直接把 Fabric 本身作为接口使用！

更新日志

若想深入了解 Fabric 及其内部机制，请阅读 docs 文件夹中的文档。这里还有一个极其有用且定期更新的 Fabric DeepWiki。

点击查看最近更新

亲爱的用户：

我们在 Fabric 做了很多激动人心的事情，我想在这里做一个简短的总结，让您感受一下我们的开发速度！

以下是我们添加的新功能和特性（最新在前）：

介绍视频

请注意，以下很多视频是在 Fabric 还是基于 Python 的时代录制的，所以请务必使用下方最新的安装指南。

变更记录

Fabric 正在快速演进。

请查阅 CHANGELOG 了解所有最新变更。

哲学理念

将问题拆解成组件

我们在日常工作和生活中经常遇到的问题是难以自动化完成一件大而复杂的事情。

以"写一篇文章"为例。这很难做到，即使对 AI 而言也是如此。为什么呢？因为你要写什么？谁是你的受众？写作基调是怎样的？一旦写完，你打算把它放在哪里？你需要配合图片吗？

解决复杂系统的最佳方法是将它们分解成单一职责的组件（模块）。

太多的 Prompt (提示词)

这就引出了我们对 Prompt 的处理方法。我们不仅需要将问题分解为组件，我们还需要让这些组件具有独立存在的价值。并且我们需要为这些组件命名，这样我们就能快速找到它们。

在 Fabric 之前，你可能有很多 Prompt 散落在你的笔记、桌面文件中，或者只存在于你的脑海里。

Note

Fabric 的核心是一个包含独立、针对特定问题的 Markdown 格式 Prompt 库，我们称之为 Patterns (模式)。

除了这套精心构建的 Prompt 之外，Fabric 还提供了一套原生于 Go 语言（过去是 Python）的命令行工具。

Fabric 拥有适用于各种生活和工作场景的 Patterns，包括：

提取 YouTube 视频和播客中最有趣的部分
仅凭一个想法，以你自己的写作风格写一篇文章
总结晦涩难懂的学术论文
为一段文字创作完美匹配的 AI 艺术提示词
评估内容质量，帮你决定是否值得阅读/观看全文
获取冗长无聊内容的摘要
向你解释代码
将糟糕的文档转化为可用的文档
从任意内容输入创建社交媒体帖子
以及更多……

安装指南

一键安装（推荐）

Unix/Linux/macOS：

curl -fsSL https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.sh | bash

Windows PowerShell：

iwr -useb https://raw.githubusercontent.com/danielmiessler/fabric/main/scripts/installer/install.ps1 | iex

请参阅 scripts/installer/README.md 了解自定义安装选项和故障排除。

手动下载二进制文件

最新发布的二进制存档及其 SHA256 哈希值可在 https://github.com/danielmiessler/fabric/releases/latest 找到。

使用包管理器

注意： 使用 Homebrew 或 Arch Linux 包管理器安装时，fabric 命令名称为 fabric-ai，请在 shell 配置文件中添加以下别名：

alias fabric='fabric-ai'

macOS (Homebrew)

brew install fabric-ai

Arch Linux (AUR)

yay -S fabric-ai

Windows

使用 Microsoft 官方支持的 Winget 工具：

winget install danielmiessler.Fabric

Windows (Scoop)

scoop install fabric-ai

从源码构建

安装 Fabric 前，请先确保已安装 Go，然后运行：

go install github.com/danielmiessler/fabric/cmd/fabric@latest

Docker

使用预构建的 Docker 镜像运行 Fabric：

# 使用 Docker Hub 的最新镜像
docker run --rm -it kayvan/fabric:latest --version

# 使用 GHCR 的特定版本
docker run --rm -it ghcr.io/ksylvan/fabric:v1.4.305 --version

# 首次运行时进行配置
mkdir -p $HOME/.fabric-config
docker run --rm -it -v $HOME/.fabric-config:/home/appuser/.config/fabric kayvan/fabric:latest --setup

# 使用你的 patterns
docker run --rm -it -v $HOME/.fabric-config:/home/appuser/.config/fabric kayvan/fabric:latest -p summarize

# 运行 REST API 服务器
docker run --rm -it -p 8080:8080 -v $HOME/.fabric-config:/home/appuser/.config/fabric kayvan/fabric:latest --serve

镜像来源：

Docker Hub：kayvan/fabric
GHCR：ksylvan/fabric

请参阅 scripts/docker/README.md 了解自定义镜像构建和高级配置。

环境变量

在 Linux 上你可能需要在 ~/.bashrc，在 macOS 上需要在 ~/.zshrc 中设置环境变量，以便运行 fabric 命令。

Intel Mac 或 Linux：

# Golang 环境变量
export GOROOT=/usr/local/go
export GOPATH=$HOME/go

# 更新 PATH
export PATH=$GOPATH/bin:$GOROOT/bin:$HOME/.local/bin:$PATH

Apple Silicon Mac：

# Golang 环境变量
export GOROOT=$(brew --prefix go)/libexec
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$GOROOT/bin:$HOME/.local/bin:$PATH

Fabric 还支持通过环境变量配置语言和默认模型：

export FABRIC_LANG="zh"
export FABRIC_DEFAULT_MODEL="claude-sonnet-4-5-20251022"

配置设置 (Setup)

fabric --setup

支持的 AI 供应商

原生集成：

OpenAI（包括 O1 和 O3 序列）
OpenAI Codex
Anthropic (Claude)
Google Gemini
Ollama（本地模型）
Azure OpenAI
Amazon Bedrock
Vertex AI
LM Studio
Perplexity

OpenAI 兼容供应商：

Abacus、AIML、Cerebras、DeepSeek、DigitalOcean、GitHub Models、GrokAI、Groq、Langdock、LiteLLM、MiniMax、Mistral、Novita AI、OpenRouter、SiliconCloud、Together、Venice AI、Z AI

运行 fabric --setup 配置首选供应商，或使用 fabric --listvendors 查看所有可用供应商。

按 Pattern 指定模型

你可以使用环境变量为单个 pattern 配置特定模型，格式为 FABRIC_MODEL_PATTERN_NAME=vendor|model。可以在 shell 启动文件中维护这些按 pattern 的模型映射。

为所有 Pattern 添加别名

在 .zshrc 或 .bashrc 中添加以下内容，可以直接使用 pattern 名称作为命令（例如，用 summarize 代替 fabric --pattern summarize）：

for pattern_file in $HOME/.config/fabric/patterns/*; do
    pattern_name="$(basename "$pattern_file")"
    alias_name="${FABRIC_ALIAS_PREFIX:-}${pattern_name}"
    alias_command="alias $alias_name='fabric --pattern $pattern_name'"
    eval "$alias_command"
done

yt() {
    if [ "$#" -eq 0 ] || [ "$#" -gt 2 ]; then
        echo "Usage: yt [-t | --timestamps] youtube-link"
        return 1
    fi
    transcript_flag="--transcript"
    if [ "$1" = "-t" ] || [ "$1" = "--timestamps" ]; then
        transcript_flag="--transcript-with-timestamps"
        shift
    fi
    local video_link="$1"
    fabric -y "$video_link" $transcript_flag
}

迁移

如果你已安装旧版（Python 版），以下是迁移到 Go 版本的步骤：

# 卸载旧版 Fabric
pipx uninstall fabric

# 清理旧的 Fabric 别名（检查 .bashrc、.zshrc 等）

# 安装 Go 版本
go install github.com/danielmiessler/fabric/cmd/fabric@latest

# 运行新版配置
fabric --setup

然后按照上方说明设置环境变量。

升级

得益于 Go 的特性，升级非常简单，只需运行安装时相同的命令即可获取最新版本：

go install github.com/danielmiessler/fabric/cmd/fabric@latest

Shell 补全

Fabric 提供了 Zsh、Bash 和 Fish 的 shell 补全脚本，让 CLI 使用更加便捷。

快速安装（无需克隆仓库）：

curl -fsSL https://raw.githubusercontent.com/danielmiessler/Fabric/refs/heads/main/completions/setup-completions.sh | sh

Zsh 补全：

mkdir -p ~/.zsh/completions
cp completions/_fabric ~/.zsh/completions/
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

Bash 补全：

echo 'source /path/to/fabric/completions/fabric.bash' >> ~/.bashrc

Fish 补全：

mkdir -p ~/.config/fish/completions
cp completions/fabric.fish ~/.config/fish/completions/

使用方法

配置完成后，运行以下命令查看帮助：

fabric -h

处理 YouTube 视频时，还可以使用以下视觉提取选项：

--visual：使用 OCR 和 FFmpeg 从视频中提取视觉信息
--visual-sensitivity：设置 FFmpeg 场景检测的容差（0.0 - 1.0）
--visual-fps：按固定每秒帧数提取画面，而不是使用场景检测

将你复制的任何文本流式输入到 fabric 并选择你想应用的 Pattern：

pbpaste | fabric --pattern extract_wisdom

调试级别

使用 --debug 标志控制运行时日志：

0：关闭（默认）
1：基本调试信息
2：详细调试
3：追踪级别

演习模式

使用 --dry-run 预览将发送给 AI 模型的内容，而不实际发送请求：

echo "test input" | fabric --dry-run -p summarize

这对于调试 pattern、检查提示词构建以及在使用 API 配额之前验证输入格式非常有用。

扩展

Fabric 支持可在 pattern 中调用的扩展。请参阅 Extension Guide 获取完整文档。

重要提示： 扩展只能在 pattern 文件中使用，不能通过直接 stdin 使用。

REST API 服务器

Fabric 内置了 REST API 服务器，通过 HTTP 暴露所有核心功能。启动服务器：

fabric --serve

服务器提供以下端点：

带流式响应的聊天补全
Pattern 管理（创建、读取、更新、删除）
上下文和会话管理
模型和供应商列表
YouTube 字幕提取
配置管理

有关完整的端点文档、身份验证设置和使用示例，请参阅 REST API 文档。

Ollama 兼容模式

Fabric 可以通过暴露 Ollama 兼容的 API 端点，作为 Ollama 的直接替代品：

fabric --serve --serveOllama

这将启用以下 Ollama 兼容端点：

GET /api/tags — 将可用 patterns 列为模型
POST /api/chat — 聊天补全
GET /api/version — 服务器版本

配置为使用 Ollama API 的应用程序可以指向你的 Fabric 服务器，Patterns 将显示为模型（例如 summarize:latest）。

我们的 Prompting 方法

Fabric 的 Patterns 与你见过的大多数提示词有所不同。

首先，我们使用 Markdown 以确保最大的可读性和可编辑性。这不仅帮助创建者写出好的 pattern，也方便任何想深入理解它的人——重要的是，这也包括你发送给它的 AI！
其次，我们的指令极为清晰，并使用 Markdown 结构来强调我们希望 AI 做什么以及按什么顺序做。
最后，我们几乎只使用提示词的 System 部分。经过一年多的深入研究，我们发现这种方式效果更好。

示例

以下示例使用 macOS 的 pbpaste 从剪贴板粘贴内容。Windows 和 Linux 的替代方案请参阅下方的 pbpaste 部分。

基于 stdin 输入运行 summarize Pattern（例如文章正文）：
```
pbpaste | fabric --pattern summarize
```
使用 --stream 选项运行 analyze_claims Pattern，获取即时流式结果：
```
pbpaste | fabric --stream --pattern analyze_claims
```

对任意 YouTube 视频运行 extract_wisdom Pattern 并流式输出结果：

fabric -y "https://youtube.com/watch?v=uXs-zPc63kM" --stream --pattern extract_wisdom

创建 pattern：在 ~/.config/fabric/patterns/[yourpatternname] 中创建一个 .md 文件即可。
对网站运行 analyze_claims pattern（Fabric 使用 Jina AI 将 URL 抓取为 Markdown 格式）：
```
fabric -u https://github.com/danielmiessler/fabric/ -p analyze_claims
```

直接使用 Patterns

如果你不想做任何复杂的事情，只是想要大量优质的提示词，可以直接浏览 /patterns 目录！

你可以在任何 AI 应用中使用这些 Patterns，无论是 ChatGPT 还是其他应用或网站。

提示词策略

Fabric 还实现了"思维链"或"草稿链"等提示词策略，可以与基本 patterns 结合使用。

每个策略都是 /strategies 目录中的一个小型 json 文件。

使用 fabric -S 并选择安装策略选项，将策略安装到 ~/.config/fabric 目录。

可用策略

cot — 思维链：逐步推理
cod — 草稿链：迭代起草，每步最多 5 个词
tot — 思维树：生成多条推理路径并选择最佳
aot — 思维原子：将问题分解为最小的独立子问题
ltm — 由易到难：从最简单到最难的子问题依次解决
self-consistent — 自洽性：多条推理路径取共识
self-refine — 自我精炼：回答、批判、精炼
reflexion — 反思：回答、简短批判、提供精炼答案
standard — 标准：直接回答，不作解释

使用 --strategy 标志应用策略：

echo "分析这段代码" | fabric --strategy cot -p analyze_code

自定义 Patterns

你可能希望使用 Fabric 创建自己的自定义 Patterns，但不与他人分享。没问题！

Fabric 支持专用的自定义 patterns 目录，将你的个人 patterns 与内置的分开保存。这意味着当你更新 Fabric 的内置 patterns 时，你的自定义 patterns 不会被覆盖。

设置自定义 Patterns

运行 Fabric 配置：
```
fabric --setup
```
从工具菜单中选择"Custom Patterns"选项，输入你想要的目录路径（例如 ~/my-custom-patterns）。
如果目录不存在，Fabric 会自动创建。

使用自定义 Patterns

创建自定义 pattern 目录结构：

mkdir -p ~/my-custom-patterns/my-analyzer

创建 pattern 文件：

echo "You are an expert analyzer of ..." > ~/my-custom-patterns/my-analyzer/system.md

使用你的自定义 pattern：

fabric --pattern my-analyzer "分析这段文本"

工作原理

优先级系统：自定义 patterns 优先于同名的内置 patterns
无缝集成：自定义 patterns 与内置 patterns 一起出现在 fabric --listpatterns 中
更新安全：你的自定义 patterns 不会被 fabric --updatepatterns 影响
默认私密：自定义 patterns 保持私密，除非你主动分享

辅助应用 (Helper Apps)

Fabric 还提供了一些核心辅助工具，便于与各种工作流集成。

`to_pdf`

to_pdf 是一个将 LaTeX 文件转换为 PDF 格式的辅助命令：

to_pdf input.tex

也可以与 write_latex pattern 结合使用 stdin：

echo "ai security primer" | fabric --pattern write_latex | to_pdf

`to_pdf` 安装

go install github.com/danielmiessler/fabric/cmd/to_pdf@latest

请确保系统已安装 LaTeX 发行版（如 TeX Live 或 MiKTeX），因为 to_pdf 需要 pdflatex 在系统路径中可用。

`code2context`

code2context 与 create_coding_feature pattern 配合使用。它生成代码目录的 json 表示，可以与指令一起输入 AI 模型，用于创建新功能或编辑代码。

详情请参阅 create_coding_feature Pattern README。

go install github.com/danielmiessler/fabric/cmd/code2context@latest

`generate_changelog`

generate_changelog 从 git 提交历史和 GitHub Pull Request 生成变更日志。它遍历仓库的 git 历史，提取 PR 信息，生成格式良好的 Markdown 变更日志。

功能包括：SQLite 缓存（快速增量更新）、GitHub GraphQL API 集成（高效获取 PR）以及使用 Fabric 的可选 AI 增强摘要。

go install github.com/danielmiessler/fabric/cmd/generate_changelog@latest

详细使用说明和选项请参阅 generate_changelog README。

pbpaste

示例部分使用了 macOS 程序 pbpaste，将剪贴板内容通过管道输入到 fabric。pbpaste 在 Windows 或 Linux 上不可用，但有替代方案。

Windows： 使用 PowerShell 命令 Get-Clipboard，或在 PowerShell 配置文件中添加别名：

Set-Alias pbpaste Get-Clipboard

Linux： 使用 xclip -selection clipboard -o。首先安装 xclip：

sudo apt update
sudo apt install xclip -y

然后在 ~/.bashrc 或 ~/.zshrc 中添加别名：

alias pbpaste='xclip -selection clipboard -o'

网页界面（Fabric Web App）

Fabric 现在包含一个内置的网页界面，提供命令行界面的 GUI 替代方案。请参阅 Web App README 了解安装说明和功能概览。

元数据 (Meta)