README.zh.md
<h>Warp，专为多 AI 智能体编程而生</b>
<sup>支持 macOS, Linux 和 Windows</sup>
</a>
fabric更新日志 • 什么是 Fabric 及其原因 • 哲学理念 • 安装指南 • 使用方法 • REST API • 示例 • 直接使用 Patterns • 自定义 Patterns • 辅助应用 • 元数据
自 2022 年底现代 AI 兴起以来，我们看到了海量的用于完成任务的 AI 应用。有成千上万的网站、聊天机器人、移动应用和其他接口可供使用。
这一切都非常令人兴奋且强大，但是_将这些功能整合到我们的生活中并不容易_。
<div class="align center"> <h4>换句话说，AI 没有能力问题——它有的是<em>整合</em>问题。</h4> </div>Fabric 的诞生就是为了解决这个问题，通过创建和组织 AI 的基本单元——Prompt（提示词）本身！
Fabric 按照现实世界中的任务来组织 Prompt，允许人们在一个地方创建、收集和组织他们最重要的 AI 解决方案，以便在他们最喜欢的工具中使用。如果你喜欢命令行，你甚至可以直接把 Fabric 本身作为接口使用！
若想深入了解 Fabric 及其内部机制，请阅读 docs 文件夹 中的文档。这里还有一个极其有用且定期更新的 Fabric DeepWiki。
<details> <summary>点击查看最近更新</summary>亲爱的用户：
我们在 Fabric 做了很多激动人心的事情，我想在这里做一个简短的总结，让您感受一下我们的开发速度！
以下是我们添加的新功能和特性（最新在前）：
azurecommon 包中。/swagger/index.html 添加了 Swagger/OpenAPI UI。openai-go/azure SDK。--transcribe-file、--transcribe-model 和 --split-media-file 标志。这些功能代表了我们致力于使 Fabric 成为最强大、最灵活的 AI 增强框架的承诺！
</details>请注意，以下很多视频是在 Fabric 还是基于 Python 的时代录制的，所以请务必使用下方最新的安装指南。
fabric
Fabric 正在快速演进。
请查阅 CHANGELOG 了解所有最新变更。
我们在日常工作和生活中经常遇到的问题是难以自动化完成一件大而复杂的事情。
以"写一篇文章"为例。这很难做到，即使对 AI 而言也是如此。为什么呢？因为你要写什么？谁是你的受众？写作基调是怎样的？一旦写完，你打算把它放在哪里？你需要配合图片吗？
解决复杂系统的最佳方法是将它们分解成单一职责的组件（模块）。
这就引出了我们对 Prompt 的处理方法。我们不仅需要将问题分解为组件，我们还需要让这些组件具有独立存在的价值。并且我们需要为这些组件命名，这样我们就能快速找到它们。
在 Fabric 之前，你可能有很多 Prompt 散落在你的笔记、桌面文件中，或者只存在于你的脑海里。
[!NOTE] Fabric 的核心是一个包含独立、针对特定问题的 Markdown 格式 Prompt 库，我们称之为
Patterns(模式)。
除了这套精心构建的 Prompt 之外，Fabric 还提供了一套原生于 Go 语言（过去是 Python）的命令行工具。
Fabric 拥有适用于各种生活和工作场景的 Patterns，包括：
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'
brew install fabric-ai
yay -S fabric-ai
使用 Microsoft 官方支持的 Winget 工具：
winget install danielmiessler.Fabric
scoop install fabric-ai
安装 Fabric 前，请先确保已安装 Go，然后运行：
go install github.com/danielmiessler/fabric/cmd/fabric@latest
使用预构建的 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
镜像来源：
请参阅 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"
fabric --setup
原生集成：
OpenAI 兼容供应商：
运行 fabric --setup 配置首选供应商，或使用 fabric --listvendors 查看所有可用供应商。
你可以使用环境变量为单个 pattern 配置特定模型，格式为 FABRIC_MODEL_PATTERN_NAME=vendor|model。可以在 shell 启动文件中维护这些按 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
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 使用。
Fabric 内置了 REST API 服务器，通过 HTTP 暴露所有核心功能。启动服务器：
fabric --serve
服务器提供以下端点：
有关完整的端点文档、身份验证设置和使用示例，请参阅 REST API 文档。
Fabric 可以通过暴露 Ollama 兼容的 API 端点，作为 Ollama 的直接替代品：
fabric --serve --serveOllama
这将启用以下 Ollama 兼容端点：
GET /api/tags — 将可用 patterns 列为模型POST /api/chat — 聊天补全GET /api/version — 服务器版本配置为使用 Ollama API 的应用程序可以指向你的 Fabric 服务器，Patterns 将显示为模型（例如 summarize:latest）。
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 目录！
你可以在任何 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
你可能希望使用 Fabric 创建自己的自定义 Patterns，但不与他人分享。没问题！
Fabric 支持专用的自定义 patterns 目录，将你的个人 patterns 与内置的分开保存。这意味着当你更新 Fabric 的内置 patterns 时，你的自定义 patterns 不会被覆盖。
运行 Fabric 配置：
fabric --setup
从工具菜单中选择"Custom Patterns"选项，输入你想要的目录路径（例如 ~/my-custom-patterns）。
如果目录不存在，Fabric 会自动创建。
创建自定义 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 "分析这段文本"
fabric --listpatterns 中fabric --updatepatterns 影响Fabric 还提供了一些核心辅助工具，便于与各种工作流集成。
to_pdfto_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 在系统路径中可用。
code2contextcode2context 与 create_coding_feature pattern 配合使用。它生成代码目录的 json 表示，可以与指令一起输入 AI 模型，用于创建新功能或编辑代码。
详情请参阅 create_coding_feature Pattern README。
go install github.com/danielmiessler/fabric/cmd/code2context@latest
generate_changeloggenerate_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。
示例部分使用了 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 现在包含一个内置的网页界面，提供命令行界面的 GUI 替代方案。请参阅 Web App README 了解安装说明和功能概览。
[!NOTE] 特别感谢以下人员的灵感和贡献！
-c 上下文标志的想法。<a href="https://github.com/danielmiessler"></a> <a href="https://github.com/xssdoctor"></a> <a href="https://github.com/sbehrens"></a> <a href="https://github.com/agu3rra"></a>
Made with contrib.rocks.
fabric 由 <a href="https://danielmiessler.com/subscribe" target="_blank">Daniel Miessler</a> 于 2024 年 1 月创建。
<a href="https://twitter.com/intent/user?screen_name=danielmiessler"></a>
我每年在开源上花费数百小时。如果你想支持这个项目，可以在这里赞助我。🙏🏼
</div>MIT
本文档由 @JasonYeYuhe 翻译并维护。如果您发现任何翻译问题或需要增加新特性说明，欢迎提交 Issue 或与我联系。