Firefly

导读：这份指南怎么读

Tue, 15 Sep 2026 00:00:00 GMT

从「API 是什么」一路走到「一个人怎么把它变成收入」。全书拆成 8 个部分、24 节，按顺序读是一本完整的书，按需跳读是一份决策手册。

这份指南怎么读#

它回答同一个问题的七个切面：我有一台 Mac，想用 AI 把重复劳动压掉，甚至变成一门生意。 七个部分按依赖顺序排列——前面没搞定的，后面会卡住。下面先选一条读法，再看全书目录。

① 完整通读（推荐）#

按 8 个部分从头读到尾。

顺序即下方「全书目录」的七行。

② 只做选型#

已经有明确任务，只想决定「用哪家、怎么配」。

8 维度动态对比图：一屏看完价格 / 能力 / 速度
按需求找平台：8 类需求各有首选与备选
订阅还是 API：逐平台算清楚
动手配置：两条路径二选一
常见问题速查：报错与排障

③ 直奔变现#

工具已经有基础，目标是搭出一条能跑通的钱路。

编排方式与数据口径#

为什么拆成多页#

原来的单页版把 19 节堆在同一屏里，目录长、滚动深、横向对比表散落各处。现在每个部分独立成页，页内把所有具备对比关系的内容（图表、表格、清单）统一改成维度切换：一次只呈现一个维度，切换即换内容，不再需要横向滚动或来回翻找。

页与页之间怎么衔接#

页尾有「接下来」与上一页 / 下一页的导航按钮。任何一页都可以单独打开，不会因为跳读而失去上下文。

数据口径#

所有平台的对比都统一到「该平台当前最新的旗舰模型」，核对日 2026-09-14。跨数量级的指标用对数刻度、其余用从 0 起的线性刻度，刻度口径直接标在图上；某个维度缺同口径数据的平台会被排除，并在图注里写明。

全书目录#

点任意一条直接进入对应章节。

打地基#

选模型#

本地部署#

动手配置#

智能体产品#

桌面智能体产品对比：8 款主流产品

开源能力库#

学习与教学#

一人公司#

数据口径与免责说明#

数据来源与核验

一是开源项目：存在性、星标数与仓库迁移情况已于 2026-09-14 通过 GitHub API 逐条核验，核验不通过或疑似虚构的仓库不予收录。二是API 价格与模型基准：来自各平台官方页面与第三方公开评测，核对日 2026-09-14；价格与档位会随时调整，请以厂商官网为准。三是硬件参数：来自 Apple 官方规格页，涵盖 M1–M5 全系已发布机型。

免责说明

第 7 部分「一人公司实战」中的成本与利润测算为行业参考区间，基于公开资料与合理假设推演，不构成任何收益承诺，也不构成投资、税务或法律建议。任何自动化链路都请遵守目标平台的用户协议与当地法规；支付、提现、店铺主账号等敏感凭证不要交给任何脚本或 Agent。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

打地基：API、Token、Skill、Agent 与自动化全景

Tue, 15 Sep 2026 00:00:00 GMT

打地基：先搞懂这四个词，再看它能干什么#

四个概念（API、Token、Skill、Agent）决定电脑为什么能自动干活，六类任务决定这些能力能用在哪儿。本页不涉及任何配置，只把后续讨论统一到同一套术语。

核心概念：API、Token、Skill、Agent#

这四个词决定了「电脑为什么能自动干活」。先看定义，再看生活化类比，最后看它们之间的关系。

API：服务商开给程序的「服务窗口」#

专业定义

API（Application Programming Interface，应用程序编程接口）是一套软件之间通信的标准规则。它是服务商对外开的「服务窗口」，程序可以通过它自动调用能力，无需人工操作网页。

🍔 生活化理解：API = 麦当劳的点餐柜台

后厨（服务器 / 大模型）不直接对你开放，你不能自己进去做汉堡
柜台（API）有固定菜单和规则，你按菜单报菜名（发请求）
后厨做好后通过柜台把汉堡递给你（返回结果）
你不用关心后厨怎么做、用什么原料，按规则点餐就能拿到东西

核心意义： 有了 API，程序就能自动调用大模型，不必再人工复制粘贴提问。

Token：身份凭证与计费单位#

专业定义

Token 是一串随机字符，既是调用 API 时的身份凭证，也是计费单位。每次发请求都要带上它，服务商据此识别「是谁在调用」并扣除对应费用。

🎢 生活化理解：Token = 游乐场手环

进门时检票员看手环（验证身份），证明你买过票
每个项目刷一次手环，扣对应次数（按调用量扣费）
手环丢了被别人捡到也能刷（Token 泄露 = 别人花你的钱）
可以随时去售票处注销旧手环、换新的（密钥轮换）

补充： 大语言模型里的「Token」也是计费单位，100 万 Token ≈ 70 万汉字。

⚠️ 注意保密#

Token 等同于密码，绝不能公开泄露，不要提交到代码仓库。

✅ 最佳实践#

使用客户端软件存储 Token，不要硬编码写在代码里。

🔄 定期轮换#

定期更换 Token；一旦泄露，立即吊销并重新生成。

Skill 与 Agent：真正让电脑干活的两个角色#

API 只是接口。真正让电脑自动干活的，是基于 API 构建的 Skill（技能） 和 Agent（智能体）。

Skill（技能）：单一功能模块#

专业定义

Skill 是封装好的、可被调用的单一功能模块，具备明确的输入输出和执行逻辑，专门用于完成某一类特定子任务。常见的 Skill 包括：文件读写、网页搜索、代码执行、数据计算、邮件发送等。

🏠 生活化理解：Skill = 家里的单件电器

洗衣机只会洗衣服，不会做饭
微波炉只会加热，不会扫地
每个电器只干一件事，需要人去按开关
对应到 AI：搜索 Skill 只会查资料，代码 Skill 只会跑程序

Agent（智能体）：自主决策的总指挥#

专业定义

Agent 是能够自主理解目标、拆解任务、规划步骤、主动调用各种 Skill / API / 工具，并根据执行结果反馈迭代调整，最终独立完成复杂目标的程序。核心是「自主决策」。

👔 生活化理解：Agent = 你的全职助理

你只说目标：「帮我办好出差手续」
它自己拆步骤：查机票 → 订酒店 → 填审批单 → 发邮件
自己挑工具：用订票 App、用邮箱、用 OA 系统
遇到问题自己调整，不需要你一步步指挥

三者的关系：API → Skill → Agent#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

层级	角色	说明
API	底层能力	大模型把自己的能力做成接口，对外提供
Skill	单个工具	基于 API 封装出一个个具体能用的功能
Agent	总指挥	拿着目标，自己调度各种 Skill 和 API，自动把事办完

这就是「配好 API 后电脑能自动工作」的原因

Agent 在后台运行，持续调用 API 和 Skill；只要电脑不关机，任务就不会停。

自动化能力全景：六类任务与推荐工具#

先明确「你想让电脑做什么」，再回头看需要配哪个 API、装哪个工具。

六类能力既可以单独使用，也可以叠加成一条流水线。下面用一张表横向对比每一类「能完成什么、适合什么场景、推荐哪些工具」：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

类型	能完成什么	适合场景	推荐工具
文件自动化	批量重命名、格式转换、整理分类、内容提取、数据汇总	科研文献整理、报表汇总、素材归档	Claude Code、Codex、GenericAgent
浏览器操控	自动查资料、填表单、发邮件、下载文献、抓取数据	文献检索、数据采集、信息监控	OpenManus、Browser Use、Codex
代码开发	生成代码、调试修复、重构优化、写测试、跑命令	全栈开发、脚本编写、项目工程化	Claude Code、Cursor、Windsurf
系统级操作	安装软件、修改配置、定时任务、备份同步、终端命令	环境搭建、运维自动化、批量处理	Claude Code、OpenManus、Dify
办公自动化	写报告、做 PPT、处理 Excel、生成会议纪要、排日程	行政办公、数据分析、学术写作	豆包专家模式、Microsoft 365 Copilot
手机远程操控	手机发指令 → 电脑执行 → 结果回传，支持微信 / 网页 / App 触发	外出时下发任务、远程监控进度	Codex + 手机端、Dify 工作流

接下来：第一个真正要做的决定是用谁家的模型。第 2 部分把 10 家平台放到同一张图上，用 8 个可切换的维度逐个比——价格、容量、能力、速度、总成本。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

Firefly 一款清新美观的 Astro 博客主题模板

Fri, 02 Jan 1970 00:00:00 GMT

🌟 项目概述#

Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

🖥️在线预览： Firefly - Demo site

📝Firefly使用文档： https://docs-firefly.cuteleaf.cn

⭐Firefly开源地址：https://github.com/CuteLeaf/Firefly

⭐Fuwari开源地址：https://github.com/saicaca/fuwari

CuteLeaf

Firefly

🍀Firefly, fresh and aesthetic Astro blog theme template.

✨A static blog template built with Astro.

—

MIT

Astro

Firefly

🚀 技术架构#

静态站点生成: 基于 Astro ，提供极快的加载速度和优秀的 SEO 优化
TypeScript 支持: 完整的类型安全，提升开发体验和代码质量
响应式设计: 使用 Tailwind CSS 构建，完美适配桌面端和移动端
组件化开发: 支持 Astro、Svelte 组件，灵活可扩展

📖 配置说明#

📚 详细配置文档: 查看 Firefly 使用文档获取完整的配置指南

Firefly 简单使用指南

Fri, 02 Jan 1970 00:00:00 GMT

这个博客模板是基于 Astro 构建的。对于本指南中未提及的内容，您可以在 Astro 文档中找到答案。

文章的 Front-matter#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

选模型：10 家平台全维度对比与选购指南

Tue, 15 Sep 2026 00:00:00 GMT

选模型：10 家平台，一张图比到底#

本页回答「用谁家的模型」：先做 8 个维度的横向对比，再按需求与预算落到具体一家，最后算清订阅与 API 哪种更划算。

主流 API 全维度对比：10 家平台最新旗舰#

对比口径统一为「各平台当前最新的旗舰模型」，逐个指标给出图表。价格为每百万 Token，美元按约 1 : 7.2 折算为人民币；核对日 2026-09-14。

十家平台最新旗舰一览#

来源：价格：各平台官网公开价 · 核对日 2026-09-14

平台	最新旗舰模型	输入 / 百万 Token	输出 / 百万 Token	上下文	最强项	订阅版月费
ChatGPT（OpenAI）	GPT-5.6 Sol	$4 / ¥28.8 缓存命中 $0.40	$20 / ¥144	1.05M	综合推理、生态最全	$20（约 ¥145）
Claude（Anthropic）	Claude Opus 5	$5 / ¥36 缓存命中 $0.50	$25 / ¥180	1M	长文本、代码工程	$20（约 ¥145）
Gemini（Google）	Gemini 3.1 Pro	$2 / ¥14.4 缓存命中 $0.20	$12 / ¥86.4	1M	多模态、谷歌生态	$19.99（约 ¥145）
DeepSeek	V4.1 Flash 2026-09-10 发布	$0.15 / ¥1.08 缓存命中 ¥0.02	$0.60 / ¥4.32	1M	超长上下文 + 超低缓存成本，跑 Agent 最划算	约 ¥49 起
Kimi（月之暗面）	Kimi K3	$3 / ¥21.6 缓存命中 $0.30	$15 / ¥108	1M	超长文档、图表识别	约 ¥699
豆包（字节跳动）	Doubao-Seed-2.1-Pro	$0.83 / ¥6 缓存命中约 ¥1.2	$4.17 / ¥30	256K	中文、多模态、国内速度	¥68 / ¥200 / ¥500
通义千问（阿里云）	Qwen3.8-Max	$2 / ¥14.4 缓存命中 $0.29	$6 / ¥43.2	1M	综合均衡、企业级稳定	¥19 / ¥49 / ¥128
智谱（GLM）	GLM-5.3	$1.40 / ¥10.1 缓存命中 $0.18	$4.40 / ¥31.7	1M	开源生态、数学推理	¥49 / ¥149 / ¥469
Grok（xAI）	Grok 4.6	$2 / ¥14.4 缓存命中 $0.30	$6 / ¥43.2	500K	实时信息、社交场景	$30（约 ¥216）
MiniMax	MiniMax M3	$0.30 / ¥2.16	$1.20 / ¥8.64	1M	极低价格、中文长文本	—

读表提示

一、价格只反映「单位成本」，实际账单还要看缓存命中率与输出长度；二、Gemini 与 OpenAI 对超长输入有加价档（Gemini 超过 20 万 Token 输入价升至 $4 / 输出 $18；OpenAI 超过 27.2 万 Token 输入翻倍）；三、API 费用随用量线性增长，订阅费是固定支出——取舍见本部分第 3 节；四、价格与档位会随时调整，请以厂商官网为准。

八维度动态对比图#

下面把「价格 → 容量 → 能力 → 速度 → 总成本」拆成 8 个可切换的维度，外加一张按月用量估算的成本曲线。切换维度时图表会实时重绘，绿色永远是当前维度的最优值。

两张图怎么读

一、刻度口径写在每张图的左上角：跨数量级的指标（价格、首 Token 延迟）用对数刻度，其余用从 0 起的线性刻度——线性刻度下的柱子长度可以直接按比例心算，不要横向比较两张不同刻度的图。二、参与排名的平台数在维度之间并不相同：某些维度只有部分平台公开了同口径数据（例如缓存命中价、编程基准），缺数据的平台会被排除在该维度之外，并在图注里写明，避免拿不同口径的数字硬凑。

输入价格（单位：$ / 百万 Token）#

未命中缓存时的标准输入价。最便宜与最贵相差约 33 倍，但实际账单还要看缓存命中率与输出长度。

平台	数值
DeepSeek V4.1 Flash	$0.15
MiniMax M3	$0.30
豆包 Seed-2.1-Pro	$0.83
GLM-5.3	$1.40
Gemini 3.1 Pro	$2.00
Qwen3.8-Max	$2.00
Grok 4.6	$2.00
Kimi K3	$3.00
GPT-5.6 Sol	$4.00
Claude Opus 5	$5.00

来源：取各平台官网公开价，核对日 2026-09-14；人民币按 1 : 7.2 折算为美元口径。

输出价格（单位：$ / 百万 Token）#

输出价决定「长回答」的账单。写代码、写长文这类输出密集型任务，输出价的权重远高于输入价。

平台	数值
DeepSeek V4.1 Flash	$0.60
MiniMax M3	$1.20
豆包 Seed-2.1-Pro	$4.17
GLM-5.3	$4.40
Qwen3.8-Max	$6.00
Grok 4.6	$6.00
Gemini 3.1 Pro	$12.00
Kimi K3	$15.00
GPT-5.6 Sol	$20.00
Claude Opus 5	$25.00

来源：同输入价格表，核对日 2026-09-14。

缓存命中价（单位：$ / 百万 Token（输入侧））#

这是跑 Agent 时最该看的数字：系统提示词、工具定义、代码库片段会被反复读取，命中的部分按此价计费。DeepSeek 与 Claude 在这一项相差约 167 倍。

平台	数值
DeepSeek V4.1 Flash	$0.003
豆包 Seed-2.1-Pro	$0.17
GLM-5.3	$0.18
Gemini 3.1 Pro	$0.20
Qwen3.8-Max	$0.29
Grok 4.6	$0.30
Kimi K3	$0.30
GPT-5.6 Sol	$0.40
Claude Opus 5	$0.50

来源：MiniMax M3 未公开缓存命中价，故不参与本项排名。其余为官网公开价，核对日 2026-09-14。

上下文窗口（单位：千 Token（K））#

一次能「装进去」的信息量。八家已进入百万 Token 量级；可容纳不等于能用好，超长上下文末端的召回质量仍要单独实测。

平台	数值
GPT-5.6 Sol	1050
Claude Opus 5	1000
Gemini 3.1 Pro	1000
DeepSeek V4.1 Flash	1000
Kimi K3	1000
Qwen3.8-Max	1000
GLM-5.3	1000
MiniMax M3	1000
Grok 4.6	500
豆包 Seed-2.1-Pro	256

来源：各平台官网规格，核对日 2026-09-14。

综合智能指数（单位：分（同口径快照））#

第三方模型库在同一口径下的质量分快照，用于快速判断「谁更聪明」。分差在 1 分以内基本可视为持平。

平台	数值
Claude Opus 5	50.7
GPT-5.6 Sol	47.1
Grok 4.6	44.4
Kimi K3	43.8
Qwen3.8-Max	40.3
DeepSeek V4.1 Flash	39.5
Gemini 3.1 Pro	30.4
MiniMax M3	29.6

来源：第三方模型库 2026-09-12 快照。豆包 Seed-2.1-Pro 与 GLM-5.3 未纳入该口径，故不在此项；Gemini 3.1 Pro 发布于 2026 年初，落后其余旗舰约半年，分数偏低不代表其多模态能力弱。

编程 Agent 能力（单位：DeepSWE v1.1 得分（%））#

面向真实仓库级编程任务的基准。三家头部的分差在 1.5 分以内，属误差范围；真正的差距出现在更难的 Terminal-Bench 4.0 与 HLE 上。

平台	数值
DeepSeek V4.1 Flash	74.2%
Claude Opus 5	73.7%
GPT-5.6 Sol	72.7%
Kimi K3	68.5%
Grok 4.6	67.5%
GLM-5.3	66.9%
Qwen3.8-Max	57.5%

来源：综合自公开技术报告与榜单，口径日 2026-09-11。豆包、Gemini、MiniMax 未列入同一榜单，故不在此项。

输出速度（单位：Token / 秒）#

取低推理档位的稳态输出速度。高频批量生成（文案、翻译、结构化抽取）时，这一项直接决定单位时间的产出量。

平台	数值
DeepSeek V4.1 Flash	261
Gemini 3.1 Pro	125
MiniMax M3	106
Grok 4.6	71
GPT-5.6 Sol	69
Claude Opus 5	61
Qwen3.8-Max	41
Kimi K3	37

来源：第三方实测，核对日 2026-09-14；速度为近似值，会随服务端负载波动。

首 Token 延迟（单位：秒（越低越好））#

从发出请求到看见第一个字的时间。该项取「最高推理档位」，即先想再答的思考时间都被计入；交互式场景请务必切到低推理档位，数字会下降一个数量级。

平台	数值
MiniMax M3	0.83
DeepSeek V4.1 Flash	0.92
Qwen3.8-Max	1.80
Kimi K3	2.99
Gemini 3.1 Pro	24.48
Claude Opus 5	36.03
Grok 4.6	38.01
GPT-5.6 Sol	124.83

来源：第三方实测，核对日 2026-09-14。

成本曲线月成本曲线（按 4 : 1 的输入 / 输出比例估算）#

用量越大，价差被放大的倍数越惊人：月用量 1000 万 Token 时，Claude Opus 5 约 $90、DeepSeek V4.1 Flash 约 $2.4；月用量涨到 10 亿 Token（规模化挂机跑 Agent 的量级），差距拉大到 $9000 对 $240。而缓存命中折扣会把这条绿线再压低一个数量级——这也是「跑 Agent 该选谁」的关键论据。

展开精确数值表（6 家 × 5 档用量，单位：美元 / 月）

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

月用量	DeepSeek V4.1 Flash	GLM-5.3	Qwen3.8-Max	Gemini 3.1 Pro	GPT-5.6 Sol	Claude Opus 5
10 百万	$2.4	$20.0	$28.0	$40.0	$72.0	$90.0
50 百万	$12.0	$100	$140	$200	$360	$450
100 百万	$24.0	$200	$280	$400	$720	$900
500 百万	$120	$1,000	$1,400	$2,000	$3,600	$4,500
1000 百万	$240	$2,000	$2,800	$4,000	$7,200	$9,000

图注：估算口径：输入占 80%、输出占 20%，未计入缓存命中折扣与批量折扣，故实际账单通常低于表中数值。x 轴与 y 轴均为对数刻度，刻度线与数据点使用同一套映射，两端各留出余量以便看清最低与最高两条线。

DeepSeek V4.1 Flash 专项对比#

它是 DeepSeek 的 Flash 系列新作，也是第一个采用因果编解码器（CED）架构的模型：把 40 层 Transformer 拆成 20 层编码器 + 20 层解码器，输入阶段激活 8B 参数、输出阶段激活 16B 参数，配合压缩稀疏注意力与 FP4 KV 缓存，把全局 KV 缓存压到每 Token 约 890 字节——约为上一代 V4-Flash 的四分之一。官方称其在性能、成本、速度与总耗时上全面超越 V4 Pro，并已开始有序下线 V4 Pro。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

规格项	参数	说明
总参数量	552B（MoE）	预填充阶段激活 8B、解码生成阶段激活 16B；另含约 196B 的稀疏条件记忆模块
架构	CED 因果编解码器	20 层编码 + 20 层解码；压缩稀疏注意力 2 + 分层稀疏索引 + FP4 KV 缓存
上下文	1,048,576 Token	约 78.6 万汉字；单次最大输出 384K Token
多模态	支持图像输入	同时支持思考 / 非思考模式、JSON 输出、工具调用、前缀续写与 FIM 补全
开放程度	MIT 许可、权重已开放	权重已在 Hugging Face 发布；但 552B 规模远超消费级 Mac 内存，本地跑不动，走 API 才是正确用法
API 模型名	`deepseek-flash`	旧名 `deepseek-v4-flash` 仍可用，请求会被路由到本模型并按 Flash 价格计费
V4 Pro 去向	2026-09-14 12<00> 起路由	北京时间 9 月 14 日中午起，`deepseek-v4-pro` 的请求全部转发到 V4.1 Flash，直至未来发布 V4.1 Pro

价格对比：与当前主流旗舰同一口径（每百万 Token，美元）#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

模型	输入	输出	缓存命中读取	定位
DeepSeek V4.1 Flash	$0.15	$0.60	$0.003	超长上下文 + 极低缓存成本，Agent 友好
GPT-5.6 Sol	$4	$20	$0.40	通用旗舰，生态最全
Claude Opus 5	$5	$25	$0.50	长文本与代码工程旗舰
Kimi K3	$3	$15	$0.30	超长文档与图表识别

为什么「缓存命中价」才是关键

跑 Agent 时，系统提示词、工具定义、代码库片段与会话历史会被反复读取。按官方举例：一个 50 万 Token 的可复用前缀被 100 次请求复用，即 5000 万缓存输入 Token——在 V4.1 Flash 上约 $0.15，而同等用量在 Kimi K3 约 $15、GPT-5.6 Sol 约 $20、Claude Opus 5 约 $25。差距接近两个数量级，这也是它适合长时间挂着跑 Agent 的原因。

基准成绩（官方公布）#

来源：基准测试：公开技术报告与第三方榜单 · 核对日 2026-09-14

基准	V4.1 Flash	对照
GPQA Diamond	90.9	研究生级科学问答，最高推理档位
Humanity’s Last Exam	36.8（纯文本） 63.9（可调用工具）	通用难题集，带工具后提升明显
DeepSWE v1.1	74.2	略高于 Claude Opus 5（74.0）与 GPT-5.6 Sol（73.0）

两点务必留意

一、高峰时段价格翻倍。 闲时价（上表）适用于非高峰时段；高峰时段为周一至周五 01<00>–04<00> 与 06<00>–10<00> UTC，对应北京时间 09<00>–12<00> 与 14<00>–18<00>——正好是国内工作时段，所以整段工作的成本要按 2 倍估算，而缓存命中价（高峰 $0.006）仍然是省钱的核心手段。二、新架构存在已知边界。 官方说明稀疏选择误差与近似状态重建可能在极端情况下影响能力，尤其在超长上下文的稀疏检索与缓存续传边界上，仍在补充压力测试。

读表提示

API 费用随用量线性增长，订阅费为固定支出——两者的取舍见本部分第 3 节。表中除 DeepSeek V4.1 Flash 为新近公开资料外，其余价格与档位沿用原文数据；全部条目以 2026-09-14 为准，会随时调整，请以厂商官网为准。

各平台适合谁、擅长什么#

按「谁适合用」与「最擅长什么」两条线，快速定位该选哪家。卡片中的模型名与本部分第 1 节保持同一口径（核对日 2026-09-14）。

按需求找平台#

先说你最常干的事，再落到具体平台。每个需求给出首选与备选，并同时写明「要留意」的部分——没有一家是全能选手。

读长文档 / 写论文#

这一需求下值得先试的平台，按推荐顺序排列：

来源：价格：各平台官网公开价 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 Kimi K3	超长文档阅读与总结，整本书、几十篇论文可一次丢入；PDF 图表与公式识别准。	1M 上下文，但输出价 $15 / 百万，长回答成本偏高
备选 Claude Opus 5	长文本严谨推理，合同、财报、法律文书分析稳。	单价最高，适合项目制而非日常刷量
备选 DeepSeek V4.1 Flash	1M 上下文 + 缓存命中价 $0.003，批量读同一批资料时最省。	极端长文末端的召回质量仍需自己实测

编程与代码工程#

这一需求下值得先试的平台，按推荐顺序排列：

来源：基准测试：公开技术报告与第三方榜单 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 Claude Opus 5	代码工程能力极强，配合 Claude Code 可端到端交付。	Claude Code 是独立产品，需单独装
备选 DeepSeek V4.1 Flash	DeepSWE v1.1 得分 74.2，当前公开榜单第一，且单价最低。	复杂重构仍建议人工复核
备选 GPT-5.6 Sol	生态最全，插件与 Agent 工具链最完善。	首 Token 延迟最高（124.83s，最高推理档）

中文写作与日常办公#

这一需求下值得先试的平台，按推荐顺序排列：

来源：价格：各平台官网公开价 · 核对日 2026-09-14

平台	为什么选它	要留意
首选豆包 Seed-2.1-Pro	中文理解与国内生活场景适配最好，国内访问速度快。	上下文 256K，是十家里最小的
备选 Qwen3.8-Max	综合均衡、企业级稳定，阿里云生态集成顺。	输出价 $6 / 百万，中档偏上
备选 DeepSeek V4.1 Flash	中文论文润色、数学推理强，成本极低。	高峰时段价格翻倍，注意错峰

多模态（图 / 视频 / 语音）#

这一需求下值得先试的平台，按推荐顺序排列：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 Gemini 3.1 Pro	原生多模态架构，视频理解领先，Workspace 深度集成。	发布较早，纯文本推理分数偏低
备选豆包 Seed-2.1-Pro	图片、视频、语音能力全面，国内速度好。	部分能力需走火山方舟特定接口
备选 MiniMax M3	同价位里语音与视频生成能力突出，单价极低。	文本推理不是它的强项

极致省成本#

这一需求下值得先试的平台，按推荐顺序排列：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 DeepSeek V4.1 Flash	输入 $0.15 / 输出 $0.60，缓存命中 $0.003，Agent 场景无人能敌。	高峰时段（北京时间 09–12、14–18）翻倍
备选 MiniMax M3	输入 $0.30 / 输出 $1.20，是主流旗舰的十分之一量级。	未公开缓存命中价
备选 GLM-5.3	开源生态完善，可本地部署进一步压掉边际成本。	自建要算电费与运维

实时信息与舆情#

这一需求下值得先试的平台，按推荐顺序排列：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 Grok 4.6	实时检索与热点追踪，与 X 平台生态深度联动。	上下文 500K，弱于头部
备选 GPT-5.6 Sol	综合推理最强兜底，可自行组合联网工具。	自带实时性弱于 Grok

私有化 / 本地部署#

这一需求下值得先试的平台，按推荐顺序排列：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 GLM-5.3	开源可微调，支持私有化部署，数据安全可控。	需要自己承担运维
备选 Qwen3.8-Max	开源模型生态完善，本地与云上可同一套代码。	本地小尺寸版本能力会下降

企业级稳定与生态#

这一需求下值得先试的平台，按推荐顺序排列：

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

平台	为什么选它	要留意
首选 Qwen3.8-Max	企业级 SLA 与阿里云服务深度集成，稳定性优先。	创新速度不如海外旗舰
备选 GPT-5.6 Sol	插件与 Agent 生态最丰富，工具链最完善。	国内直连需自备通道
备选 Claude Opus 5	长文本 + 代码工程双强，适合交付型团队。	价格最高一档

平台档案#

下面按平台逐一给出完整画像：适合谁、最擅长什么、控制台入口。

🌙 Kimi K3 #

月之暗面 · API 控制台

适合： 科研人员、研究生、文献工作者，以及需要批量处理长文档的人。

最擅长：

超长文档阅读与总结，整本书 / 几十篇论文可直接丢入
PDF 图表、公式、数据精准识别与提取
文献综述、对比分析、研究方法梳理

🔮 DeepSeek V4.1 Flash #

深度求索 · 2026-09-10 发布 · API 控制台｜ API 文档

适合： 学生、中文写作者、程序员、预算敏感的科研用户，以及需要超长上下文又在意成本的团队。

最擅长：

超长上下文：100 万 Token（约 78.6 万汉字），整本书或整套文档可一次丢入
成本极低：闲时输入 ¥1.08 / 百万 Token，缓存命中读取仅 ¥0.02 / 百万
中文论文润色、数学推理、代码生成，理工科友好，DeepSWE v1.1 得分 74.2
原生支持图像输入与工具调用，适合长时间跑 Agent 流水线

🤖 OpenAI / ChatGPT #

GPT-5.6 Sol · API 控制台

适合： 开发者、重度通用用户、需要插件生态、追求稳定性的人。

最擅长：

通用推理、多模态处理、复杂综合任务兜底
插件与 Agent 生态最丰富，工具链最完善
多语言、跨领域知识覆盖面最广

🧠 Anthropic Claude #

Claude Opus 5 / Claude Code · API 控制台

适合： 程序员、法律与金融从业者、长文本处理专业人士。

最擅长：

超长上下文严谨推理，代码工程能力极强
Claude Code 终端自主开发，端到端交付任务
合同、财报、法律文书等专业长文档分析

💎 Google Gemini #

Gemini 3.1 Pro · AI Studio

适合： 谷歌生态用户、有多模态需求者、科研工作者。

最擅长：

原生多模态架构，视频理解领先
Google Workspace 深度集成，办公协同顺畅
百万级超长上下文，适合大项目分析

🫘 字节跳动豆包 #

Doubao-Seed-2.1-Pro · 火山方舟控制台

适合： 国内普通用户、内容创作者、中文办公人群。

最擅长：

中文理解与生成，国内生活场景适配最好
多模态生成，图片、视频、语音能力全面
国内访问速度快，稳定不卡顿

🐑 阿里云通义千问 #

Qwen3.8-Max · 百炼控制台

适合： 企业用户、开发者、阿里云生态用户。

最擅长：

综合能力均衡，企业级稳定可靠
开源模型生态完善，可本地部署
阿里云服务深度集成

🌟 智谱 AI GLM #

GLM-5.3 · 开放平台

适合： 开源开发者，以及有本地化部署需求的企业 / 个人。

最擅长：

开源模型生态完善，可本地部署、微调
数学推理能力突出，理工科友好
支持私有化部署，数据安全可控

🚀 Grok（xAI）#

Grok 4.6 · xAI 平台

适合： 需要实时信息、社交舆情与口语化表达的人。

最擅长：

实时信息检索与热点追踪，时效性突出
社交场景与短文本创作，语气自然
与 X 平台生态深度联动

🧩 MiniMax #

MiniMax M3 · 开放平台

适合： 预算极紧、又需要长上下文与多模态输出的个人与小团队。

最擅长：

单价极低，输入价约为主流旗舰的 1/10
中文长文本处理，百万级上下文
语音与视频生成能力在同价位中突出

自己跑一遍再选型：A/B 测评模板#

前面所有维度都是别人测出来的。真正决定选谁，要用你自己的任务跑一遍——同一批输入、同一份 prompt，只换模型。下面是一份能直接改的最小模板。

要记录的字段	怎么取	为什么值得记
是否通过	用规则或人工给每条输出打 0 / 1（能自动校验的用断言，不能的抽样人工看）	这是唯一真正重要的指标：通过率决定这套流程能不能上线
首 Token 延迟	发起请求到收到第一个字的时间	交互式场景的体感上限；批量场景可以忽略
总耗时	从发起到收完	换算成「每小时能处理多少条」
输入 / 输出 token	响应里的 usage 字段	乘上单价就是单条成本，能直接对上成本曲线
失败与重试次数	记录错误码与重试轮数	稳定性差一个数量级，运维成本差一个数量级
人工接管次数	统计「你必须动手改才可用」的比例	这是隐形成本的大头，也是便宜模型最容易踩的坑

1
# ab_test.py：同一批任务打 3 家，输出一张可对比的 CSV
2
import csv, os, time
3
from providers import build_client          # 自己封一层，屏蔽各家 SDK 差异
4

5
CASES = [line.strip() for line in open("cases.txt", encoding="utf-8") if line.strip()]
6
MODELS = ["deepseek-v4.1-flash", "gpt-5.6-sol", "claude-opus-5"]
7
ROWS = []
8

9
for name in MODELS:
10
    client = build_client(name)
11
    for i, case in enumerate(CASES, 1):
12
        t0 = time.time(); first = None; usage = {}
13
        try:
14
            for chunk in client.stream(case):
15
                if first is None:
16
                    first = time.time() - t0
17
                usage = chunk.usage or usage
18
            ok = verify(case, chunk.text)          # 自动校验，返回 0/1
19
        except Exception as e:
20
            ok, first = 0, None
21
        ROWS.append({"model": name, "case": i, "pass": ok,
22
                     "ttft": first, "total": time.time() - t0,
23
                     "in": usage.get("in"), "out": usage.get("out")})
24

25
with open("result.csv", "w", newline="", encoding="utf-8") as f:
26
    w = csv.DictWriter(f, fieldnames=ROWS[0].keys()); w.writeheader(); w.writerows(ROWS)
27

28
# 汇总：通过率 / 平均耗时 / 单条成本
29
for name in MODELS:
30
    r = [x for x in ROWS if x["model"] == name]
31
    pass_rate = sum(x["pass"] for x in r) / len(r)
32
    print(f"{name}: 通过率 {pass_rate:.0%}"

展开收起

口径：样本量建议至少 30 条真实任务，且要覆盖你日常的难点（不是挑最简单的例子）；低于 20 条时通过率的置信区间会宽到没有区分度。多跑一轮换一批输入的结论，比在同一批上反复调 prompt 更可靠。「最强」「最擅长」「最适合」这类判断都只是在这套测评下的相对结论，不构成对任何平台的绝对评价。

直接读取整个代码库，理解项目架构
自主执行多步开发任务，端到端交付
原生支持终端命令、Git 操作、运行测试
200K 上下文，可覆盖中型完整项目

价格与横向对比#

Max 订阅 $20 / 月，含额度，超量部分走 API 计费
也可以绑定自己的 API Key，按量付费
对比 Cursor：更擅长自主任务，定位偏「工程助理」
对比 Codex：纯终端形态，更极客，支持多模型

接下来：模型选完，还有一条完全不同的路线：把模型搬到本机跑。它换来的不是更强的能力，而是「数据不出门」与「零边际成本」——代价是硬件投入与运维时间。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

本地部署：Ollama 与 Mac 硬件配置全解

Tue, 15 Sep 2026 00:00:00 GMT

本地部署：什么时候值得，什么时候别折腾#

如果不想把数据发出去，或者想彻底免掉边际成本，Mac 上该怎么跑本地模型？本页给出三件事的判断依据：工具怎么选、硬件门槛在哪、参数档位怎么对。

本地大模型工具对比#

Mac 上最常用的 5 个本地模型运行工具，从零基础到极客向全覆盖。提示：本地部署不消耗 Token，但出字速度取决于电脑的内存带宽与内存容量；绝大多数人直接用 API 性价比更高。

一句话选型与工具规格#

先记住一件事：本地部署不消耗 Token

本地模型跑在你自己这台机器上，请求不经过厂商的 API，因此不产生任何 Token 计费——成本只剩已经买下的硬件与电费，用量再大也不会多花一分钱。代价从「单价」转移到「速度」：出字快不快取决于内存带宽（每秒能把模型权重搬进计算单元的次数，也就是 token/s 的上限），能跑多大的模型取决于内存容量；模型常驻内存之后，其余软件可用的内存也会相应减少。所以判断要不要本地部署，看的不是价钱表，而是这两项硬件指标与你的用量是否匹配——具体对照见下一节的硬件表格。

下面先给「一句话选型」，再按工具逐个看规格：星标反映关注度，真正该看的是「Mac 原生优化、是否需要图形界面、能不能对接 VS Code」这三项。

🏆 新手首选 LM Studio #

零门槛图形化

🏆 开发者首选 Ollama #

生态好、对接方便

🏆 极致性能 llama.cpp #

榨干全部性能

🏆 批量推理 vLLM #

需要 N 卡服务器

🏆 综合体验 Jan #

界面最好用

Ollama#

开箱即用，模型库最全；自动优化，生态最完善

来源：星标与仓库状态：GitHub API 实测 · 核对日 2026-09-14

GitHub 星标	★ 180.8k
Mac 原生优化	✅ 全系列 Metal 优化
图形界面	❌ 主命令行
命令行	✅
一键部署	✅ 一行命令启动
VS Code 对接	✅ 插件丰富
适合人群	开发者、日常使用

LM Studio#

纯图形化操作；搜索下载模型一键运行

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

GitHub 星标	闭源软件
Mac 原生优化	✅ Apple Silicon 专属
图形界面	✅ 非常直观
命令行	✅ 可选
一键部署	✅ 点点就用
VS Code 对接	✅ 内置对接
适合人群	普通用户、不想敲命令

llama.cpp#

性能天花板，所有参数可调；是绝大多数工具的底层引擎

来源：星标与仓库状态：GitHub API 实测 · 核对日 2026-09-14

GitHub 星标	★ 128.1k
Mac 原生优化	✅ 底层 Metal 优化
图形界面	❌ 纯命令行
命令行	✅
一键部署	❌ 全手动配置
VS Code 对接	✅ 自行对接
适合人群	极客、底层调参

vLLM#

高吞吐批量推理；主要面向 NVIDIA GPU，Mac 不推荐

来源：星标与仓库状态：GitHub API 实测 · 核对日 2026-09-14

GitHub 星标	★ 91.7k
Mac 原生优化	❌ Mac 支持差
图形界面	❌ 命令行
命令行	✅
一键部署	❌ 部署复杂
VS Code 对接	✅ 开发对接
适合人群	科研、批量推理

Jan#

本地 + 云端统一管理；插件生态好，界面最佳

来源：星标与仓库状态：GitHub API 实测 · 核对日 2026-09-14

GitHub 星标	★ 44.5k
Mac 原生优化	✅ 全平台适配
图形界面	✅ 美观现代
命令行	✅
一键部署	✅ 一键安装
VS Code 对接	✅ 支持扩展
适合人群	追求体验的用户

实操：用 Ollama 跑通第一个本地模型#

如果你确实想体验本地部署（离线可用、零边际成本、数据不出本机），Ollama 是 Mac 上最省事的路径：一行命令装好、一行命令拉模型，并在本地提供兼容 OpenAI 格式的接口，脚本几乎不用改代码就能在「本地免费」与「云端更强」之间切换。

第 1 步 · 安装#

1
# 方式一：Homebrew（推荐，便于后续升级）
2
brew install ollama
3

4
# 方式二：官网下载安装包后拖进「应用程序」
5
# https://ollama.com

第 2 步 · 拉取并运行模型#

8B 级别的指令模型（Hermes 3 8B、Qwen3-8B、Llama 3.1 8B 等）是 16GB 内存 Mac 的舒适区：量化后约 5GB，对话流畅，512GB 硬盘完全放得下。

1
ollama pull hermes3     # 拉取模型，首次约 5GB
2
ollama list             # 查看本机已有模型
3
ollama run hermes3      # 进入命令行对话，输入 /bye 退出

省内存要点

Apple Silicon 是统一内存架构，模型权重与系统共用同一块内存。16GB 机器建议同时只加载一个 7B–8B 模型；若同时开着 Docker 与几十个浏览器标签页，实际可用于模型的显存会被压缩到总内存的 70% 左右。

第 3 步 · 用 Python 调用（自动化脚本的核心）#

Ollama 在本地 11434 端口提供 HTTP 接口，格式与 OpenAI 兼容，因此只要替换 base_url 就能复用同一套脚本。

1
# 依赖：uv pip install requests
2
import requests
3

4
def ask_local(prompt: str, model: str = "hermes3") -> str:
5
    # 调用本地 Ollama 模型，返回纯文本结果
6
    r = requests.post(
7
        "http://localhost:11434/api/generate",
8
        json={"model": model, "prompt": prompt, "stream": False},
9
        timeout=300,
10
    )
11
    r.raise_for_status()
12
    return r.json()["response"]
13

14
if __name__ == "__main__":
15
    print(ask_local("用一句话解释什么是统一内存架构。"))

展开收起

第 4 步 · 函数调用：让模型自己决定动手#

Hermes 系列以指令跟随与函数调用见长，适合做「模型判断该调哪个工具」的流程：把工具清单以 JSON Schema 形式交给模型，由它决定是否需要抓网页、查表或执行脚本，再由你的代码真正执行。

1
# 把工具描述成 JSON Schema，交给模型判断何时调用
2
tools = [{
3
    "type": "function",
4
    "function": {
5
        "name": "fetch_webpage",
6
        "description": "抓取指定 URL 的网页正文",
7
        "parameters": {
8
            "type": "object",
9
            "properties": {"url": {"type": "string", "description": "网页地址"}},
10
            "required": ["url"],
11
        },
12
    },
13
}]

第 5 步 · 本地还是云端？按场景二选一#

Mac 硬件配置全解：Air 全系 + Pro 五系列#

核心原理

Apple Silicon 采用统一内存架构（UMA），内存与显存共享，不需要把模型从系统内存拷进显存。跑大模型的性能由两个指标决定：统一内存大小决定「能装下多大的模型」，内存带宽决定「生成有多快（token/s）」。同样 16GB 内存，Pro 芯片的生成速度可以是 Air 的 1.5~2 倍，差别就来自带宽。从 M5 起，Apple 在每个 GPU 核心内都集成了神经加速器（Neural Accelerator），提示词处理与端侧 AI 任务的速度提升明显；但它加速的是算力，不改变带宽决定生成速度这条规律。

MacBook Air 系列#

Air 全系无风扇，长时间满载会降频，更适合间歇使用。当前在售仅有 M5 一代，13 英寸 ¥9,999 起、15 英寸 ¥11,999 起。

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心（可选）	可选内存	内存带宽	可跑模型档位	实际表现
M1	8 核（4P+4E）	7 核 / 8 核	8GB / 16GB	68.2 GB/s	7B / 14B（低量化）	8GB 仅能跑 7B Q4，速度偏慢；16GB 可流畅跑 7B，14B 勉强能用
M2	8 核（4P+4E）	8 核 / 10 核	8GB / 16GB / 24GB	100 GB/s	7B / 14B / 32B（低量化）	8GB 入门体验；16GB 跑 14B 流畅；24GB 可跑 32B Q4，日常可用
M3	8 核（4P+4E）	8 核 / 10 核	8GB / 16GB / 24GB	100 GB/s	7B / 14B / 32B（低量化）	带宽与 M2 相同，靠架构改进让同内存下快 20% 左右；24GB 跑 32B 可满足轻度使用
M4	10 核（4P+6E）	8 核 / 10 核	16GB / 24GB / 32GB	120 GB/s	14B / 32B	10 核 CPU 首次下放 Air；16GB 跑 14B 满血，24GB 跑 32B Q6 流畅
M5 在售	10 核（4超级+6能效）	8 核 / 10 核	16GB / 24GB / 32GB	153 GB/s	14B / 32B	带宽较 M4 提升 28%，每个 GPU 核心内置神经加速器；32GB 跑 32B Q6 流畅，续航更长

注：Air 的 M1~M4 机型均已停产，列在此处仅供二手选购参考。

MacBook Pro 系列#

本地跑的模型不按 Token 计费，所以这里比的只有两件事：内存带宽决定生成速度，内存容量决定能跑多大的模型。下面按 M5 / M4 / M3 / M2 / M1 五个芯片系列分组，同一系列的标准版、Pro、Max 放在一张表里对照，而不是按代次把同档位拆散罗列。记法： P = 性能核心，E = 能效核心，超级 = 超级核心（M5 起新增）；如「8 核（4P+4E）」即 4 个性能核心加 4 个能效核心。换算口径：Q4 量化、约 8K 上下文；带宽条采用全表统一刻度（以 614 GB/s 为满格），可跨系列直接比较长短。

按芯片代际查看：M5 M4 M3 M2 M1

同一代芯片内部又分标准 / Pro / Max 三档，档位差异（带宽）往往比代际差异更影响跑模型的速度——所以先选档位，再挑代际。

M5 系列#

现役在售 2026 年 3 月发布 · 14 英寸（M5 / Pro / Max）· 16 英寸（Pro / Max）

M5 系列

现役在售 2026 年 3 月发布 · 14 英寸（M5 / Pro / Max）· 16 英寸（Pro / Max）

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心	统一内存	内存带宽	可跑模型档位	定位与实测表现
M5标准版14″	10 核（4超级+6能效）	10 核	16 / 24 / 32GB	153 GB/s	14B 满血 · 32B Q4	该系列入门款。带宽较 M4 提升约 28%，且每个 GPU 核心内置神经加速器，提示词处理与本地推理明显加快。
M5 ProPro14″ / 16″	15 核（5超级+10 性能） 18 核（6超级+12 性能）	16 / 20 核	24 / 48 / 64GB	307 GB/s	32B 满血 · 70B Q4	两档核心数均配 307GB/s。24GB 起步即可跑 32B 满血；升到 48GB 才能舒服地跑 70B Q4。
M5 MaxMax14″ / 16″	18 核（6超级+12 性能）	32 / 40 核	36 / 48 / 64 / 128GB	460 GB/s614 GB/s	70B 满血 · 120B Q4	32 核 GPU 版 460GB/s、40 核 GPU 版 614GB/s。注意：只有 36GB 机型配 32 核 GPU，选 48GB 以上会强制升到 40 核。

参考价：14 英寸 ¥15,999 起（M5），16 英寸 ¥24,999 起（M5 Pro）。M5 Pro / M5 Max 机型配三个雷雳 5、N1 无线芯片（Wi-Fi 7 + 蓝牙 6）；M5 机型为三个雷雳 4、Wi-Fi 6E + 蓝牙 5.3。

M4 系列#

已停产 2024 年 10 月发布 · 14 英寸（M4 / Pro / Max）· 16 英寸（Pro / Max）

M4 系列

已停产 2024 年 10 月发布 · 14 英寸（M4 / Pro / Max）· 16 英寸（Pro / Max）

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心	统一内存	内存带宽	可跑模型档位	定位与实测表现
M4标准版14″	10 核（4P+6E）	10 核	16 / 24 / 32GB	120 GB/s	14B 满血 · 32B Q4	首次把 10 核 CPU 下放到 Pro 的入门款，带宽比 M3 提升 20%。
M4 ProPro14″ / 16″	12 核（8P+4E） 14 核（10P+4E）	16 / 20 核	24 / 48GB	273 GB/s	32B 满血 · 70B Q4	本代最值得关注的一档：带宽从 M3 Pro 的 150GB/s 直接拉到 273GB/s，涨了近一倍，是跑大模型性价比的转折点。
M4 MaxMax14″ / 16″	14 核（10P+4E） 16 核（12P+4E）	32 / 40 核	36 / 48 / 64 / 128GB	410 GB/s546 GB/s	70B 满血 · 120B Q4	32 核 GPU 版 410GB/s、40 核 GPU 版 546GB/s。硬件规格上仍是可买到的第二强。

与 M5 系列同机身模具，接口同为三个雷雳 5。现已停产，主要在二手与渠道库存中流通；纸面带宽与 M5 系列差距不大，二手价差明显时可作为替代。

M3 系列#

已停产 2023 年 10 月发布 · 14 英寸（M3 / Pro / Max）· 16 英寸（Pro / Max）

M3 系列

已停产 2023 年 10 月发布 · 14 英寸（M3 / Pro / Max）· 16 英寸（Pro / Max）

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心	统一内存	内存带宽	可跑模型档位	定位与实测表现
M3标准版14″	8 核（4P+4E）	10 核	8 / 16 / 24GB	100 GB/s	7B 满血 · 14B Q4	首个 3 nm 世代。14 英寸机身首次提供基础款芯片，但带宽与 M2 持平、内存起步仍为 8GB，跑模型空间很紧。
M3 ProPro14″ / 16″	11 核（5P+6E） 12 核（6P+6E）	14 / 18 核	18 / 36GB	150 GB/s	32B Q4 · 70B 低量化	⚠ 这一档是全线唯一的“倒车”：带宽 150GB/s 反而低于上一代 M2 Pro 的 200GB/s，内存上限 36GB 也只比 M2 Pro 的 32GB 多 4GB。目的跑本地大模型，M3 Pro 不如 M2 Pro，甚至不如 M1 Pro（同为 200GB/s）。
M3 MaxMax14″ / 16″	14 核（10P+4E） 16 核（12P+4E）	30 / 40 核	36 / 48 / 64 / 96 / 128GB	300 GB/s400 GB/s	70B 满血 · 120B Q4	30 核 GPU 版 300GB/s、40 核 GPU 版 400GB/s。96GB 仅 14 核 CPU 版可选，128GB 仅 16 核 CPU 版可选，两者不能同时要。

同为三雷雳 4 接口。这一代全系带宽相对 M2 系列没有提升，选购二手时务必先看带宽而不是代次。

M2 系列#

已停产 14″/16″：2023 年 1 月 · 13″ 标准版：2022 年 6 月 · 14 英寸 / 16 英寸 · 标准版为 13.3 英寸

M2 系列

已停产 14″/16″：2023 年 1 月 · 13″ 标准版：2022 年 6 月 · 14 英寸 / 16 英寸 · 标准版为 13.3 英寸

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心	统一内存	内存带宽	可跑模型档位	定位与实测表现
M2标准版13.3″	8 核（4P+4E）	10 核	8 / 16 / 24GB	100 GB/s	7B 满血 · 14B Q4	13 英寸机型，2023 年 10 月停产。带宽 100GB/s 是 M1 的 1.47 倍，但内存仍从 8GB 起，实际跑模型体验与 M3 标准版接近。
M2 ProPro14″ / 16″	10 核（6P+4E） 12 核（8P+4E）	16 / 19 核	16 / 32GB	200 GB/s	32B Q4 · 14B 满血	带宽 200GB/s，与 M1 Pro 持平、高于次代 M3 Pro。二手市场里跑本地模型的“隐形性价比”选项。
M2 MaxMax14″ / 16″	12 核（8P+4E）	30 / 38 核	32 / 64 / 96GB	400 GB/s	70B Q4 · 32B 满血	两档 GPU 均为 400GB/s。96GB 内存仅 38 核 GPU 版可选，是当时笔记本内存的天花板。

首发价：14 英寸（M2 Pro）¥15,999 起、16 英寸（M2 Pro）¥19,999 起。接口为三个雷雳 4，HDMI 首次支持 8K 外接显示器。

M1 系列#

已停产 14″/16″：2021 年 10 月 · 13″ 标准版：2020 年 11 月 · 14 英寸 / 16 英寸 · 标准版为 13.3 英寸

M1 系列

已停产 14″/16″：2021 年 10 月 · 13″ 标准版：2020 年 11 月 · 14 英寸 / 16 英寸 · 标准版为 13.3 英寸

来源：硬件规格：Apple 官方规格页 · 核对日 2026-09-14

芯片	CPU 核心	GPU 核心	统一内存	内存带宽	可跑模型档位	定位与实测表现
M1标准版13.3″	8 核（4P+4E）	8 核	8 / 16GB	68.25 GB/s	7B Q4（勉强）	13 英寸机型，2020 年 11 月发布、2022 年 6 月停产。机身有风扇，可长时间满载不降频；但 68.25GB/s 是全线最低带宽，现在只适合跑 7B 级模型。
M1 ProPro14″ / 16″	8 核（6P+2E） 10 核（8P+2E）	14 / 16 核	16 / 32GB	200 GB/s	32B Q4 · 14B 满血	2021 年发布时就是 200GB/s，四年后仍高于 M3 Pro。32GB 版本跑 32B Q4 依然可用。
M1 MaxMax14″ / 16″	10 核（8P+2E）	24 / 32 核	32 / 64GB	400 GB/s	70B Q4 · 32B 满血	400GB/s 与 M2 Max、M3 Max 的 40 核版同档。二手价低时，是跑 70B Q4 的最低门槛方案。

接口为三个雷雳 4。这一代的带宽水平（Pro 200 / Max 400）在四年间被 M3 Pro 反超又落后、被 M4 Pro 拉开，是判断“代次不等于性能”的最佳例子。

两个容易踩的坑

① 标准版的 8GB 内存不要买来跑模型。 M1 / M2 / M3 标准版起步都是 8GB，装完系统后剩不下多少，7B 模型也只能勉强塞进 Q4。② 内存是焊死的，买时定终身。 统一内存不可后期升级，选配置时必须一次到位——想跑 70B 就至少 48GB，想跑 120B 就至少 64GB。③ Ultra 系列不在 MacBook Pro 上。 M1 Ultra / M2 Ultra / M3 Ultra 只用于 Mac Studio 与 Mac Pro，笔记本产品线从未搭载，选购时不要被混淆。

同档位跨代速查#

把三档芯片按代次拉通，纵向比同一档位四年的变化。带宽单位 GB/s，「上限」指该档位可选的最大统一内存。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

档位	M1 系列	M2 系列	M3 系列	M4 系列	M5 系列
标准版	68.25上限 16GB	100上限 24GB	100上限 24GB	120上限 32GB	153上限 32GB
Pro	200上限 32GB	200上限 32GB	150上限 36GB	273上限 48GB	307上限 64GB
Max	400上限 64GB	400上限 96GB	300 – 400上限 128GB	410 – 546上限 128GB	460 – 614上限 128GB

这张表最该记住的两件事

① 代次新 ≠ 带宽高。 M3 Pro 的 150GB/s 低于 M2 Pro 与 M1 Pro 的 200GB/s——整个 M3 世代在统一内存带宽上没有进步。买二手 Mac 跑本地模型，先看带宽数字，再看是第几代。② 档位跨度远大于代次跨度。 同为 M5 系列，Max 的 614GB/s 是标准版 153GB/s 的 4 倍；而标准版从 M1 到 M5 四年只涨了 2.2 倍。预算有限时，升档位比等新一代更划算。

内存带宽排行#

带宽直接决定生成速度（token/s），是跑本地大模型最硬的指标。下图把全部 18 种配置按带宽从高到低排列，颜色区分档位。

标准版 Pro Max 单位：GB/s

配置	带宽（GB/s）
M5 Max · 40 核 GPU	614
M4 Max · 40 核 GPU	546
M5 Max · 32 核 GPU	460
M4 Max · 32 核 GPU	410
M1 Max	400
M2 Max	400
M3 Max · 40 核 GPU	400
M5 Pro	307
M3 Max · 30 核 GPU	300
M4 Pro	273
M1 Pro	200
M2 Pro	200
M5	153
M3 Pro	150
M4	120
M2	100
M3	100
M1	68.25

怎么用这张图

先找到你的预算能碰到的档位，再看落点。32GB 内存 + 200GB/s 是“能舒服跑 32B”的起点（M1 Pro / M2 Pro 即可满足）；要到 400GB/s 才能跑 70B Q4（M1 Max 起）；想跑 120B 级则需要 460GB/s 以上加 64GB 内存，目前只有 M5 Max 能同时给到。

标注约定与选购建议#

核心标注： P = 性能核心，E = 能效核心，超级核心为 M5 起新增（性能最强的核心类型）。同一芯片提供多档核心数时，对应不同售价档位，核心数越高内存上限也越高。
可选范围： MacBook Air 全系 CPU 固定，仅 GPU 核心可选（如 8 核 → 10 核）；MacBook Pro 的 Pro / Max 芯片，CPU 与 GPU 均有多档核心数可选。
带宽联动： 带宽随 GPU 核心数变化。例如 M5 Max 的 32 核 GPU 版为 460GB/s、40 核 GPU 版为 614GB/s；选大内存往往会被绑定到高配 GPU。
跑大模型看什么： 先看内存容量（决定能装多大），再看内存带宽（决定多快）。CPU / GPU 核心数主要影响多任务、渲染、编译等通用负载，对纯文本生成的影响远小于带宽。
预算有限时的顺序： 内存容量 > 内存带宽（即档位）> 代次。宁可买上一代的 Max，也不要买当代的标准版——前者 400GB/s 对后者 153GB/s，跑模型的差距远大于两代之间的架构改进。
数据口径： 本节全部参数取自 Apple 官方技术规格页（M5 系列为 2026 年现行页面；M1~M4 系列为 Apple 支持文档与新闻稿中的历史规格），核对日期 2026-09-14。不含任何推测值；已停产机型的价格随行情波动，未在此列。

参数档位与开源模型清单#

知道自己机器的「可跑档位」后，用这张表反查该下载哪些模型——档位由内存容量决定，实际出字速度由内存带宽决定，两者缺一不可。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

参数档位	级别	对应开源模型	能做什么	适合人群
7B ~ 9B	入门级	Qwen3-8B、GLM-4.5-9B、Gemma 3-12B、Llama 3.1-8B	日常问答、邮件摘要、文档总结；简单脚本生成、代码补全、轻量 RAG	学生、普通办公、轻度 AI 使用者
14B ~ 16B	进阶级	Qwen3-14B、GLM-4.5-Air（激活 12B）、MiniMax M2.5、DeepSeek-R1-Distill-14B	中等复杂度代码编写与审查；本地知识库问答、数据处理、数学推理	开发者、科研人员、中度 AI 使用者
32B ~ 34B	专业级	Qwen3-32B、Qwen3-30B-A3B、DeepSeek-R1-Distill-32B、GLM-4.7-Thinking（355B / 激活 32B）	复杂代码重构、架构设计；深度科研推理、专业领域分析、高质量长文本	专业开发者、研究员、重度 AI 使用者
70B+	旗舰级	Qwen3-235B-A22B、DeepSeek-V4（671B / 激活 28B）、GLM-5（744B / 激活 40B）、Llama 4 Maverick（400B / 激活 17B）、Kimi K2.5（200B / 激活 20B）	接近云端 API 的推理质量；企业级私有化部署、超复杂多步推理	企业、团队、极致隐私需求用户

重要说明

以上为 Q4 量化版本的参考需求；量化越低速度越快，质量略有下降。
统一内存需预留系统占用，实际可用显存约为总内存的 70%~80%。
绝大多数普通用户不需要本地部署，直接用 API 性价比最高、效果最好。
闭源模型（GPT、Claude、Gemini、Kimi）不公开完整参数，表中为激活参数估算值。
DeepSeek V4.1 Flash 例外：它是开放权重的（552B MoE、MIT 许可），但规模远超消费级 Mac 的内存上限，本地跑不动——这类新模型的正确用法是走 API，而不是下载到本地。

接下来：路线判断完，接下来是纯操作：把密钥配好、把第一行代码跑通、把账单看住。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

动手配置：从注册到首次调用 API

Tue, 15 Sep 2026 00:00:00 GMT

动手配置：两条路径，从注册到第一次调用#

本页只有步骤，没有选型。路径一把各家 API 直接接进脚本，路径二用统一网关把多家模型收口到一个地址；配完再解决「怎么知道钱花在哪」。

Mac 上配置 API 的两条路径#

两条路径二选一：普通用户优先用图形化客户端，直观、不易出错；开发者或需要写脚本，再用终端环境变量方式。

方式一：图形化客户端#

Mac 上主流的 AI 客户端：Codex（App Store）、Cherry Studio、ChatBox、CC-Switch（菜单栏工具）。

从 App Store 或官网下载安装客户端（比如 Codex、Cherry Studio）。
打开软件，进入「设置」→「模型管理」。
选择你要用的 API 服务商（OpenAI / DeepSeek / Kimi 等）。
把申请到的 API Key 粘贴到对应输入框，保存。
选择默认模型，回到聊天界面即可直接使用。

💡 优点

不用敲命令，界面直观，支持多模型切换，还能管理历史对话。

方式二：终端环境变量#

如果你要自己写代码、跑 Agent 脚本，才需要配置环境变量。

打开终端，确认 Shell 类型： 新 Mac 一般是 zsh，旧版是 bash。 echo $SHELL
编辑配置文件：

zsh 用户#
nano ~/.zshrc

bash 用户#
nano ~/.bash_profile
在文件末尾添加环境变量： export DEEPSEEK_API_KEY=“sk-xxxxxx” export KIMI_API_KEY=“sk-xxxxxx”
保存并生效：

Ctrl+O 保存，Ctrl+X 退出#
source ~/.zshrc

实操：以 DeepSeek 为例跑通首次调用#

把上面两条路径落到一次真实操作上。DeepSeek 是门槛最低的入口之一：注册不需绑定信用卡、新用户有免费额度、接口与 OpenAI 格式完全兼容。

先看清价格：分时段计费（2026-09-10 12<00> 起生效）#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

计费项	空闲时段	高峰时段	说明
输入（缓存命中）	¥0.02 / 百万	¥0.04 / 百万	系统提示词、工具定义、上下文前缀被复用时按此价，最省的一档
输入（缓存未命中）	¥1 / 百万	¥2 / 百万	首次出现的全新内容按此价
输出	¥4 / 百万	¥8 / 百万	模型生成的回复内容

高峰时段正好压在国内上班时间

高峰定义为周一至周五 09<00>–12<00> 与 14<00>–18<00>（北京时间），价格为空闲时段的两倍。把批量任务排到夜间执行，成本直接减半 —— 这是最容易拿到的一笔折扣。

第 1 步 · 注册并取得 API Key#

打开开放平台 platform.deepseek.com，手机号注册并完成实名认证。
左侧菜单进入「API Keys」→「创建 API Key」。
复制生成的密钥（以 sk- 开头）。它只会完整显示一次，请立即存入密码管理器。
进入「财务中心」按需充值（支持支付宝 / 微信），并顺手把单日消费上限设好。

第 2 步 · 写入环境变量#

1
# 打开 zsh 配置（新 Mac 默认 zsh）
2
nano ~/.zshrc
3

4
# 在文件末尾追加（切勿把密钥提交进 Git）
5
export DEEPSEEK_API_KEY="sk-你的密钥"
6

7
# Ctrl+O 保存、Ctrl+X 退出，然后让它生效
8
source ~/.zshrc

第 3 步 · 跑通第一次调用#

1
# 依赖：uv pip install openai python-dotenv
2
import os
3
from openai import OpenAI
4
from dotenv import load_dotenv
5

6
load_dotenv()  # 从 .env 读密钥，避免写死在代码里
7

8
client = OpenAI(
9
    api_key=os.getenv("DEEPSEEK_API_KEY"),
10
    base_url="https://api.deepseek.com",   # 兼容 OpenAI 格式，只差这一行
11
)
12

13
def ask(prompt: str, system: str = "你是专业的中文内容助手") -> str:
14
    resp = client.chat.completions.create(
15
        model="deepseek-flash",            # 旧名 deepseek-v4-flash 仍可路由
16
        messages=[
17
            {"role": "system", "content": system},
18
            {"role": "user", "content": prompt},
19
        ],
20
        temperature=0.7,
21
        stream=False,
22
    )
23
    u = resp.usage
24
    print(f"本次用量 - 输入 {u.prompt_tokens} / 输出 {u.completion_tokens}")
25
    return resp.choices[0].message.content
26

27
if __name__ == "__main__":
28
    print(ask("用三句话说明什么是 API。"))

展开收起

就这么简单

换掉 base_url 与 model，同一段代码就能切到 OpenAI、Kimi、通义千问等任何兼容 OpenAI 格式的服务上 —— 这就是「兼容 OpenAI 格式」的实际价值。

用量核对与成本监控#

跑自动化最容易出的事故不是报错，而是账单暴涨：一个写错的循环、一次失败重试风暴，半夜就能烧掉几百元。上线前先把「看得见用量」这件事做掉。

来源：星标与仓库状态：GitHub API 实测 · 核对日 2026-09-14

方式	怎么做	适合
① 官方控制台「用量统计」	登录开放平台 → 用量统计，可按天 / 按模型 / 按 Key 查看消费明细与趋势（数据有数分钟延迟）	日常人工巡查
② 响应体 `usage` 字段	每次调用的返回都带 `prompt_tokens` / `completion_tokens`，落库即可按任务精确对账	自己写脚本记账
③ 平台的额度告警	在财务中心设置单日 / 单月消费上限与预警，超限直接停服	所有跑自动化的人（必做）
④ 开源自建看板	NewAPI Monitor（★8 · Docker 部署）可实时记录调用、费用趋势并推送超限告警，适合多 Key / 多项目中转统一治理	用量大、多 Key 场景

安全与成本红线

一、密钥绝不硬编码进代码再提交到公开仓库，被爬虫扫到会立刻盗刷；二、脚本要同时加最大重试次数与单日消费上限双保险；三、定期轮换密钥，怀疑泄露立刻吊销重建；四、授权 Agent 时不要给资金、账号密码、批量删除这类高权限操作。

关于第三方「省 Token」工具

网络上流传的 LLMeter、TokenGuard、codeburn 等自动省 Token / 代理优化工具，本次核验未能在公开代码托管平台找到对应项目，故不收录。需特别提醒：来路不明的代理型工具会把你的提示词、乃至密钥一并转发出去，收益远小于风险。

密钥与账号安全#

这一节是整份文档里唯一不能走捷径的部分：模型选错可以换，链路搭错可以重做，密钥泄露无法撤回。

凭证类型	正确做法	绝对不要
API Key	只放在本机环境变量或 `.env`（且 `.env` 写进 `.gitignore`）；给每个用途单独建一把 Key 并命名，便于按用途吊销。	写进代码、交给前端、贴进聊天记录或截图、提交到 Git（含私有仓库）。
账号密码 / 二次验证	用密码管理器生成并保存；二次验证码单独存放。	与 API Key 放在同一个纯文本文件里；用同一个密码注册「平台账号」与「支付账号」。
支付 / 提现凭证	只保留在人工操作环节，脚本只读订单状态，不持有扣款能力。	把银行卡、支付密码、验证码交给任何脚本或 Agent。
店铺 / 平台主账号	自动化一律使用子账号或只读 Token，权限最小化。	让 Agent 用主账号直接登录或改价、上下架。

落地到 Mac 上，最小可用做法是三步：

1
# 1. 只在本机保存，不进版本库
2
echo ".env" >> .gitignore
3
printf 'DEEPSEEK_API_KEY=sk-你的key\n' > .env
4
chmod 600 .env          # 仅本人可读
5

6
# 2. 脚本里只读环境变量，不硬编码
7
import os
8
KEY = os.environ.get("DEEPSEEK_API_KEY")
9
assert KEY, "未设置 DEEPSEEK_API_KEY"
10

11
# 3. 提交前自查（有输出就说明泄露了）
12
git grep -nE 'sk-[A-Za-z0-9]{16,}' || echo "未发现明文密钥"

泄露后的处置顺序

一、立刻在控制台吊销该 Key（不是改密码，改密码不失效已有 Key）；二、查用量与账单，确认异常消费区间；三、重建一把新 Key 并同步到本机环境变量；四、检查 .env 是否曾被提交过——只要进过 Git 历史，即使后来删除也要视为已泄露，因为历史提交可被克隆。

口径：以上为通用工程实践，不是任何平台的特有要求。各平台的 Key 管理入口与控制台位置见1.4 用量核对与成本监控；轮换周期建议 90 天一次，或团队人员变动时立即轮换。

预算熔断：把支出上限写进配置#

自动化最典型的翻车方式不是「模型太贵」，而是一个死循环把额度跑满——脚本重试、Agent 反复读同一批文件、定时任务叠加运行，都能在一夜之间把预算烧掉。熔断要在三个层次各做一道。

层次	在哪设	设什么	触发后的行为
平台侧	各平台控制台的「用量 / 计费 / 限额」页	月度消费上限、单日上限；部分平台支持按 Key 设限额	到达上限后拒绝新请求（返回 429 / 403），不会产生超额账单
调用侧	你自己的脚本里	单次任务 token 上限、最大重试次数、单日调用次数	抛异常并退出，写一条日志
任务侧	launchd / cron 配置	任务并发数 = 1（禁止叠加）；超时强杀	避免上一轮没跑完下一轮又启动，形成叠加消耗

平台侧是最后一道防线。上线任何自动化之前，先把这一步做完——它比事后看账单有效得多：

各平台的设置入口怎么找

一、先找「用量 / Usage / 计费 / Billing」，再看有没有「限额 / Limit / Budget / Quota」子项；
二、国内平台（DeepSeek、豆包、通义等）多为「账户余额 + 单日限额」模式，注意余额耗尽即停；
三、海外平台（OpenAI、Anthropic、Google）多为「预付额度 + 用量上限」模式，可分别对项目和 Key 设限；
四、找不到限额入口的平台，就用第二、三层兜住。入口页面与字段名会随改版变化，因此这里不给具体的按钮路径——请在控制台用上述关键词检索，不要照着半年前的截图操作。

1
# 调用侧：一份可直接粘贴的熔断装饰器
2
import json, time, pathlib
3

4
BUDGET = {"max_calls_per_day": 200, "max_retries": 3, "max_tokens": 8192}
5
LEDGER = pathlib.Path.home() / ".guide" / "usage.json"
6
LEDGER.parent.mkdir(exist_ok=True)
7

8
def _load():
9
    if LEDGER.exists():
10
        return json.loads(LEDGER.read_text())
11
    return {"date": time.strftime("%Y-%m-%d"), "calls": 0}
12

13
def guard(fn):
14
    def wrap(*a, **kw):
15
        led = _load()
16
        today = time.strftime("%Y-%m-%d")
17
        if led.get("date") != today:                 # 跨天归零
18
            led = {"date": today, "calls": 0}
19
        if led["calls"] >= BUDGET["max_calls_per_day"]:
20
            raise RuntimeError("已达当日调用上限，熔断退出")   # 不再重试
21
        led["calls"] += 1
22
        LEDGER.write_text(json.dumps(led))
23
        return fn(*a, **kw)
24
    return wrap

展开收起

口径：上限数值（200 次／天、8192 token）是示例，不是推荐值——请按1.4 里实测的单次成本 × 可接受月支出倒推。举例：若单次调用平均花费 $0.01、可接受月支出 $30，则单日上限约 100 次。

429、超时与降级：把失败写成流程#

批量跑任务时，失败是常态而不是异常。写死一次调用的脚本，跑 1000 条会因为其中 3 条报错而整体中断；写好重试与降级的脚本，同样的错误只会让这 3 条走备用路径。

现象	通常原因	处置方式	要不要重试
429 Too Many Requests	并发过高，或触及平台的速率/额度限制	指数退避重试（1s → 2s → 4s，带随机抖动），同时降低并发	要，但要限制次数
408 / 504 超时	服务端排队，或单次请求体过大	缩短 prompt、拆分请求，再退避重试	要
500 / 502 / 503	服务端临时故障	退避重试；连续失败则切到降级链	要，但超过阈值就降级
400 参数错误	参数、模型名或格式写错	修正代码，不要重试	不要（重试 100 次也一样失败）
401 / 403	Key 失效、余额耗尽、无权限	停止任务并告警（这类错误重试只会浪费额度）	不要
200 但内容为空 / 被截断	触达输出上限，或被安全策略拦截	按降级链重试，并记录原始返回以便复盘	视情况

1
# 退避重试 + 降级链：主模型失败就退到便宜模型，再失败就落盘人工处理
2
import random, time
3

4
CHAIN = ["claude-opus-5", "deepseek-v4.1-flash"]   # 主 → 备；按你的成本梯度排
5

6
RETRYABLE = (429, 408, 500, 502, 503)
7

8
def call_with_fallback(prompt, client):
9
    for model in CHAIN:
10
        for attempt in range(4):
11
            try:
12
                return client.chat(model=model, prompt=prompt, max_tokens=4096)
13
            except ApiError as e:
14
                if e.status not in RETRYABLE:
15
                    break                    # 不可重试：直接换下一个模型
16
                time.sleep((2 ** attempt) + random.random())   # 抖动，避免同时重试
17
    raise RuntimeError("降级链全部失败，转人工处理")

展开收起

两条容易忽略的规则

一、重试必须幂等：若一次调用可能有副作用（下订单、发消息、写文件），重试前先用请求 ID 查一次是否已成功，否则会出现「发了两次」。二、把失败落盘：失败的输入、错误码、原始返回都写到一个 failed.jsonl。批量任务里最贵的不是失败本身，而是失败后不知道失败在哪一条。

口径：错误码语义各家略有差异（例如有的平台用 402 表示余额不足），上表按通用约定整理；接入新平台时请以其官方错误码文档为准。

Mac 生产力环境搭建#

自动化任务通常要求「电脑长期不关、脚本按点自己跑」。本节把系统设置、包管理器、Python 与 Node 环境、效率软件、开机自启一次配好。适用机型：Mac Mini M4（16G + 512G 最合适，功耗低、可 7×24 挂机）与 M 系列的 MacBook Air / Pro。

系统基础设置#

允许安装第三方应用（部分自动化工具未上架 App Store）：随后在「系统设置 → 隐私与安全性」中确认已允许「任何来源」。
终端内执行，输入开机密码后回车#
sudo spctl —master-disable
关闭自动睡眠，保持挂机：系统设置 → 电池 → 选项，开启「防止自动睡眠」，并开启「唤醒以供网络访问」。
安装 Rosetta 2（个别旧工具只提供 Intel 版本）： softwareupdate —install-rosetta —agree-to-license

安装 Homebrew（Mac 的包管理器）#

后面几乎所有工具都通过 Homebrew 安装，所以它是第一件要装的东西。

1
# 官方安装脚本
2
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3

4
# Apple Silicon 机器：安装后把 brew 加进 PATH
5
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
6
eval "$(/opt/homebrew/bin/brew shellenv)"
7

8
# 验证
9
brew --version

国内网络提示

raw.githubusercontent.com 在国内常被阻断，导致安装脚本拉不下来。两个可行做法：一、先配置终端代理，再执行上面的脚本；二、改用国内镜像源，并写入环境变量加速后续下载：

1
# 中科大镜像（写入 ~/.zshrc 后对新终端生效）
2
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
3
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

Python 环境（自动化脚本的主力语言）#

推荐用 uv 管理环境：比 conda 更快更轻，对 Apple Silicon 支持好。

1
# 安装 uv
2
brew install uv
3

4
# 给一人公司项目单独建工作区与虚拟环境
5
mkdir -p ~/opc && cd ~/opc
6
uv venv
7
source .venv/bin/activate
8

9
# 装上常用的基础库
10
uv pip install requests openai python-dotenv pandas schedule

为什么一定要用虚拟环境

每个项目一个 .venv，依赖互不污染；换机器时用 uv pip freeze > requirements.txt 就能复现环境。不要把包装进系统 Python —— 后期版本冲突时很难收拾。

Node.js 环境（前端工具与自动化插件）#

1
brew install node
2

3
# 验证
4
node -v
5
npm -v

常用效率软件#

1
brew install --cask google-chrome      # 浏览器：自动化脚本最主要的操作对象
2
brew install --cask iterm2             # 终端增强
3
brew install --cask rectangle          # 窗口管理，多窗口看数据必备
4
brew install --cask keka               # 压缩解压
5
brew install --cask maccy              # 剪贴板历史（开源，可替代付费的 Paste）

做视频自动化还需要 FFmpeg（brew install ffmpeg）；跑本地大模型按第三部分「本地部署」装 Ollama 或 LM Studio。

让脚本按时自己跑#

Mac 上最稳的定时方案是系统自带的 launchd，不需要额外软件。

1
# 1. 新建 LaunchAgent 配置（一个任务一个文件）
2
nano ~/Library/LaunchAgents/com.opc.daily.plist
3
# 关键字段：
4
#   Label                 唯一标识，如 com.opc.daily
5
#   ProgramArguments      要执行的命令，路径必须写绝对路径
6
#   StartCalendarInterval  定时规则（Hour / Minute）
7
#   StandardOutPath / StandardErrorPath   日志文件，出问题先看这里
8

9
# 2. 加载并立即生效
10
launchctl load ~/Library/LaunchAgents/com.opc.daily.plist
11

12
# 3. 确认已注册
13
launchctl list | grep opc
14

15
# 4. 改了配置后重新加载
16
launchctl unload ~/Library/LaunchAgents/com.opc.daily.plist
17
launchctl load ~/Library/LaunchAgents/com.opc.daily.plist

展开收起

挂机三条底线

一、日志一定要落到文件（StandardErrorPath），否则早上只会看到「昨晚没跑」却不知为何；二、脚本要能防重入 —— 上一次没跑完时这一次不要叠加启动；三、涉及自动发布、自动下单这类外部动作时，先设成只生成不发送的草稿模式，跑一周确认稳定再放开。

常见问题速查#

把配置与使用中最常见的疑问集中在这里：前两条对应配置环节，后四条涉及选型与日常使用。

可用性与合规前提#

动手之前有三件事要先确认，它们决定「这套方案在你这里能不能用」，与技术选型无关。

场景	通常可行的做法	要注意的地方
国内直接访问	优先选国内平台（DeepSeek、豆包、通义、智谱、Kimi、MiniMax 等）的官方 API，网络与支付链路最短。	部分海外平台的 API 在境内无法直连，需要自行解决网络问题；能否连通请先用自己的网络实测一次，不要照抄别人的结论。
代理与网络工具	企业用途走公司统一的网络出口与合规审批流程。	代理的使用方式需符合当地法规与所在单位的网络管理规定；不要为绕过限制而使用来源不明的工具。
数据出境	涉及个人信息、客户资料、合同文本时，先用国内平台处理，或做脱敏（去标识化）后再调用。	把真实客户名单、身份证号、银行信息提交给境外服务，可能触及数据出境的合规要求；做法是脱敏而不是「应该没事」。
内容与平台规则	搬运、抓取、批量发布前先读目标平台的用户协议与 robots 规则。	高频抓取、自动关注、批量私信等行为通常被明令禁止，账号可能被限流或封禁；被封的是你的主账号，代价远大于省下的时间。
商用与版权	确认模型输出、训练数据来源与素材授权，尤其是要对外销售的内容。	不同平台对「输出物能否商用」的条款不同，请以官方条款为准。

本节不是法律意见

以上是工程侧的检查清单，帮助你在动手前意识到风险点；涉及具体业务的合规判断，请咨询专业人士。这条与总目录的「数据口径与免责说明」是一致的。

口径：本表按「大多数个人开发者与小微企业会遇到的情形」归纳，不覆盖行业特殊监管要求（金融、医疗、教育等regulated行业另有规定）。

配置后不生效怎么办？

客户端内：检查 API Key 是否粘贴正确、模型名称是否选对。终端内：执行 source 命令，或直接重启终端。

API 和网页版会员有什么区别？

网页版是给人手动用的，API 是给程序自动调用的；API 按量付费——用量少时更便宜，用量大时订阅更划算。

Agent 需要自己写代码吗？

不用。现在有很多现成的 Agent 软件（如 OpenManus、Dify），配置好 API 就能直接用，也支持手机远程触发。

省 Token 工具会影响回答质量吗？

正规优化工具只去掉冗余和废话，核心信息保留。主流测试中准确率下降在 5% 以内，日常使用几乎感知不到。

本地部署和 API 哪个好？

99% 的人选 API：效果更好、速度更快、不用折腾硬件。只有极致隐私需求、离线使用或特殊定制，才需要本地部署。

Skill 怎么安装到客户端里？

Claude Code、Codex 等支持 MCP 协议的客户端，直接在设置里添加 Skill 仓库地址或本地路径即可启用。

接下来：能力已经可调用，但「谁去调用它」还没解决。第 5 部分先挑一个桌面智能体当主力，再到第 6 部分的开源库里给它装具体能力。

================= 12 桌面智能体产品对比 =================

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

智能体产品：8 款主流桌面 Agent 对比

Tue, 15 Sep 2026 00:00:00 GMT

智能体产品：先选一个主力，再谈能力#

API 是水电，智能体产品是电器。本页横向对比 8 款主流桌面智能体，回答一个问题：日常工作该交给谁。

前面的部分讲的是「配哪家的 API」。如果你想要的是打开就能干活——直接操作本机文件、浏览器与 Office，还能用手机远程下指令——那要选的是桌面智能体产品：它们把模型、技能与执行环境打包好了。本节把国内主流产品与开源方案放在一起对比：WorkBuddy（含同门的编程工具 CodeBuddy）、豆包工作、千问办公、QClaw、OpenClaw，以及智谱、Kimi、MiniMax 三家的桌面 Agent。

一句话速览与核心差异#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

产品	厂商	一句话定位	最大差异点	最适合谁
WorkBuddy	腾讯	全场景职场 AI 智能体工作台	跨应用自动化最成熟（Excel → PPT 一条龙），微信远程控制是独门	企业微信用户、需要跨软件批量处理办公文件的人
豆包工作	字节跳动	长在飞书里的企业级 Agent	本地 + 云电脑双轨执行，关机也能在云端跑长任务	飞书重度用户、需要定时跑任务的团队
千问办公	阿里	本地文件直读 + 钉钉生态的办公 Agent	不用上传，直接读本机磁盘文件并写回原路径	钉钉用户、做表与读写 PDF 多的人
QClaw	腾讯电脑管家	微信直连的本地 Agent，基于 OpenClaw 打造	零配置一键装、微信扫码即用，5000+ 技能市场	不想折腾配置、只想微信发指令就能干活的人
OpenClaw	开源社区	本地优先的开源个人 Agent 框架	完全开源、任意聊天软件当入口，可接本地模型做到全离线	重视数据主权、愿意自己配置的开发者与极客
智谱清言 / AutoClaw	智谱 AI	免费额度最大的通用助手 + 视觉操作电脑的 AutoClaw	每日免费 Token 额度最高，可零代码定制专属 Agent	学生、预算有限的个人用户
Kimi Work	月之暗面	子 Agent 并行能力最激进的一款	最多 300 个子 Agent 并行 + 最高 100 万 Token 上下文	处理超大型项目、超长文档与深度研究的人
MiniMax Agent	MiniMax	Agent 团队协作 + 多模态生成	视频、语音生成是传统强项，办公文档处理较弱	内容创作者、自媒体、多模态工作者

逐款详解#

8 款产品的完整档案：能力边界、价格、平台支持与适用场景。

WorkBuddy（腾讯）#

桌面智能体工作台 · 2026-03-09 公测 · Mac / Windows

核心能力： 提供 Craft（直接执行）/ Plan（先出方案再执行）/ Ask（只问答不操作） 三种模式，把执行权限交到你手里；跨应用自动化是八款里最成熟的，能模拟人工在多个办公软件间切换，也能批量读写、合并、转换 Word / Excel / PPT / PDF。微信远程下发指令是它的独门功能——人在外面用手机说一句，家里或公司电脑就开始干活。

生态与规模： 兼容 OpenClaw 技能体系与 MCP 协议，与企业微信、腾讯文档、腾讯会议原生联动；据易观分析，2026 年 6 月以 2097 万次桌面端月访问量居国内同类产品首位，2026 年 9 月开放平台上线、首批引入超百家生态伙伴。

同门产品： 与腾讯云 CodeBuddy（AI 编程工具，含 IDE / 插件 / CLI 三种形态与 Agent SDK）同源共底座——两者是并行的「办公线」与「编程线」，不是迭代关系：写代码用 CodeBuddy，办公自动化用 WorkBuddy，共享同一套模型与技能生态。

价格： 体验版免费（500 积分 / 月）、标准版 70 元 / 月、高级版 140 元 / 月、旗舰版 700 元 / 月。官网与文档：workbuddy.cn ｜使用文档

豆包工作（字节跳动）#

企业级 Agent 生产力平台 · 2026-08-25 发布 · 电脑版

核心能力： 主打「指令进、成果出」的完整闭环。执行上采用本地 + 云电脑双轨——本地任务直接操作你的电脑，长周期任务（定时采集、竞品监控）交给云端挂机跑，关掉电脑也不影响。交付上支持全栈多模态：除文档表格外，能直接生成图片、视频、网页与轻应用；还支持框选文档 / PPT / 表格任意区域做定点修改，不必整篇重写。

生态与规模： 与飞书深度打通，用飞书账号登录即可在权限内继承企业知识、文档、会议纪要、日程与聊天记录，产出也会沉淀回飞书形成可复用资产；内置 200+ 官方技能、10+ 主流平台连接器与多 Agent「工作伙伴」。

价格： 个人版三级阶梯（标准 68 元 / 月、加强 200 元 / 月、高级 500 元 / 月），企业版按席位起售；新用户可领 30 天专业版试用。官网：doubao.com/work

千问办公（阿里）#

桌面 Agent + 云端 Agent + 企业协同 · 2026-08-03 公测

核心能力： 业内首款同时支持桌面端、云端与企业协同三种形态的产品。最实用的差异点是本地磁盘文件直读：不用上传、不用下载，AI 直接读你磁盘里的文档、表格、图片，处理完存回原路径，体验最接近本地软件。Excel Agent、Word / PDF Agent 是它的专业强项，做表、读 PDF、润色文档都很扎实。

生态与规模： 由 QoderWork、MuleRun、悟空三款产品整合而来，深度融入钉钉生态，可把常用流程保存为「组织级 Skill」供团队复用。

价格： 免费版可用，标准版 78 元 / 月（连续包月）、高级版 158 元 / 月；公测期注册送 2000 积分、每日登录再送。官网：qianwen.com

QClaw（腾讯电脑管家）#

基于 OpenClaw 的本地 Agent · Mac / Windows

核心能力： 把开源框架 OpenClaw 做成了「打开即用」的消费级产品：一键安装、无需配置环境，微信扫码绑定后，直接用微信发消息就能远程操控电脑——整理文件、改文档、查数据、设提醒。全程本地运行，任务执行与数据存储不出设备，带原生安全沙箱。

生态： 内置 Kimi、MiniMax、GLM、DeepSeek 等多款国产大模型并可自由切换；接入 ClawHub、GitHub 等 Skills 市场（官方称 5000+ 技能）；还支持一键关联你已安装的 OpenClaw。相比原版 OpenClaw，它把「配环境」这一步彻底省掉了。

价格： 免费为主，以官网公示为准。官网与文档：qclaw.qq.com ｜产品文档

OpenClaw（开源）#

本地优先的开源个人 Agent 框架 · macOS / Windows / Linux

核心能力： 它把「聊天软件」变成指挥台：WhatsApp、Telegram、Discord、Slack、Teams、iMessage 里都能对话，然后用 Browser、Exec、Web 等工具把「说」变成「做」——清空收件箱、发邮件、更新日历、跑脚本。内置 Gateway 安全边界，配合审批与隔离策略控制风险；支持 Cron、Hooks、Webhooks 等触发方式，可以把重复流程做成定时任务。

生态与规模： 2026 年增长最快的开源项目之一，GitHub 星标已超 38.9 万（本指南收录项目中最高）。技能、插件、记忆体系开放，本指南第六部分「开源能力库」里多个技能都基于它开发（小红书运营、多智能体编排等都直接标明支持 OpenClaw）。

价格： 开源免费，模型可接云端 API Key，也可接本地 Ollama 做到完全离线。官网与仓库：openclaw.ai ｜ github.com/openclaw/openclaw

智谱清言 / AutoClaw（智谱 AI）#

通用助手 + 视觉操作电脑 · 全平台

核心能力： 免费额度是同类里最大方的：每日 200 万 Token 对话额度，写论文、读文献、学知识基本够用。支持零代码创建个性化 Agent——上传行业资料就能训练专属助手（HR 面试官、跨境客服等）；长文档分析支持 20 万字。AutoClaw 走的是另一条路线：基于 GLM-PC 视觉模型直接「看屏幕操作电脑」，技术路线先进但场景覆盖仍在完善中。

生态与合规： 国内首批通过备案，数据安全合规，支持私有化部署；但不绑定任何办公生态，协同能力相对弱。

价格： 通用对话免费，专业版 39 元 / 月起。官网：chatglm.cn ｜ AutoClaw：autoclaw.z.ai

Kimi Work（月之暗面）#

多 Agent 并行 + 超长上下文 · 桌面端

核心能力： 多 Agent 并行能力最激进：支持最多 300 个子 Agent 同时工作，你给一个大目标，它自动拆成大量子任务分派给不同角色并行推进。超长上下文是传统强项，最高档支持 100 万 Token，整本代码库或整套文档可以一次性喂进去。通过 WebBridge 控制你的真实浏览器，网页抓取、填表、发帖都能做；Widgets 与 Dashboard 能把对话结果沉淀成可交互的持久视图。

适合与局限： 适合超大型复杂项目与深度研究；但本地文件操作与跨应用能力不如办公型产品，也没有原生办公套件集成。

价格： 免费版每月约 6 次 Agent 任务；49 / 99 / 199 / 699 元 / 月四档。官网：kimi.com

MiniMax Agent #

Agent 团队协作 + 多模态生成 · 桌面端

核心能力： 特色是 Agent Teams：可以创建不同角色的 Agent 组成团队，分工完成又长又复杂的任务。具备 Computer Use 能力，能像人一样识别屏幕上的软件界面并操作；Pocket 功能打通了飞书与微信，可跨应用操作。视频生成与语音生成是它的传统强项，做自媒体内容的人会明显受益；MCP 生态开放，插件可定制性强。

适合与局限： 适合内容创作者与多模态工作者；办公文档处理（Excel / PPT）的专业度不如千问办公与 WorkBuddy，也没有绑定办公生态。

价格： Plus 49 元 / 月、Max 119 元 / 月、Ultra 469 元 / 月；视频生成需另购 Media Plan。官网：agent.minimax.io

怎么选：先看公司用什么办公软件#

一句话结论

飞书选豆包工作，钉钉选千问办公，企业微信选 WorkBuddy，想微信一句话就干活选 QClaw，重视数据主权选 OpenClaw，预算有限选智谱清言，做视频选 MiniMax，处理超长文档选 Kimi Work。

生态绑定比模型能力更重要。 实际使用中，能不能无缝打通你每天都在用的办公软件，比底层模型多几千亿参数影响大得多——因为你省下的不是「推理时间」，而是「复制粘贴与来回切换的时间」。
桌面 Agent 与开源 Agent 不是二选一。 常见组合是：一个开箱即用的产品处理日常办公，再装 OpenClaw 之类把特殊流程自动化，两者可以共存（QClaw 甚至支持一键关联已装的 OpenClaw）。
权限只给最小范围。 所有这类产品都需要授权本地文件访问，建议只授权指定工作文件夹，不要一上来就给整个磁盘。
现在还不适合买年付。 这 8 款产品大多在 2026 年才发布或重大更新，迭代速度极快，今天的短板可能下个月就补上了。先用免费额度或月付观察两三个月再决定长期方案。

数据说明

本节的价格、用户规模与功能描述来自各厂商公开资料与 2026 年公开报道（其中 WorkBuddy 月访问量引自易观分析），可能随时调整；功能细节请以各产品官网与客户端内的实际说明为准。

接下来：主力定下来，接下来给它装能力。开源能力库收录 172 个已核验的 Skill 与 Agent 项目、25 个分类，每个分类都能一键切换查看。

本节口径：一、8 款产品的「一句话定位」「最强项」「最适合」「要留意」为编辑归纳，依据各产品官方文档与公开评测，核对日 2026-09-14，属主观判断，不构成对各产品的绝对评价。二、产品迭代很快，功能与定价请以官网为准。三、「怎么选」一节给的是决策顺序，不是结论——先看公司办公软件、再看任务类型、最后比价格。

================= 13 开源能力库 =================

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

开源能力库：Skill 技能库与 Agent 智能体库

Tue, 15 Sep 2026 00:00:00 GMT

开源能力库：给手里的 Agent 装能力#

开源能力库：总览与入口#

手里这个 Agent 能装哪些能力、又能换成哪些更专门的 Agent？全库按 Skill 与 Agent 两大部分组织。

Skill 技能库#

给手里的 Agent 装上单点能力——读文件、抓网页、写文档、出图表；你点名，它执行。

进入 Skill 技能库 →

Agent 智能体库#

换一个能自己推进任务的执行者——理解目标、拆解步骤、调用工具、交付结果；你给目标，它推进。

进入 Agent 智能体库 →

接下来：两部分各有侧重：Skill 补单点能力，Agent 换执行者。先逛哪个都行——下一页先看 Skill 技能库。

Skill 技能库：给 Agent 装上具体能力#

← 返回开源能力库

S1 · 省 Token 与上下文工程#

决定 API 账单高低的一层。原理分三类：输入侧压缩（把工具输出、日志、文件内容瘦身后再发给模型）、输出侧精简（让模型少说废话）、上下文工程（该记的记住、该忘的忘掉）。选择标准：改动越靠近提示词层，兼容性越好、上手越快；带监控面板的项目适合「先量化，再优化」。

Headroom #

headroomlabs-ai/headroom · Python★ 71.8k

在内容进入模型之前先做压缩的中间件：工具输出、日志文件、代码 diff、RAG 片段都会在这一层被瘦身，不活跃的上下文下沉到分层记忆里。官方给出的数据是编码类 Agent 可减少约 20% 的 Token 消耗，并附带消耗监控与开销报表。适合上下文里长期堆着大量命令回显、编译日志的场景；如果你只是偶尔聊天，收益不明显。

Caveman #

JuliusBrussee/caveman · Go★ 105.3k

一个把「省字」做到极致的 Claude Code 技能：让模型用原始人式的短句回答，砍掉客套话、重复确认和解释性铺垫，官方称可削减约 65% 的输出 Token。适合你已经完全看懂答案、只想要结论的场景（批量改写、脚本生成、数据清洗）；需要详细讲解的教学任务不适合用。

Caveman Compression #

wilpel/caveman-compression · Python★ 1.1k

把「原始人语」背后的思路提炼成通用方法：删掉可预测的语法成分，只保留信息密度高的部分。它是一个语义压缩方案与工程实现，不是即插即用的技能包，适合想自己改造提示词、把压缩逻辑嵌进自己系统的开发者。

Ponytail #

DietrichGebert/ponytail · JavaScript★ 136.8k

让 AI 像「办公室里最懒的资深工程师」那样写代码：能复用标准库就绝不自造，能不写代码就不写。官方称平均减少约 54% 的代码行数。适合反感 AI 过度工程化、每次生成都甩出几百行冗余代码的人；对需要完整脚手架的新项目帮助有限。

token-optimizer-mcp #

ooples/token-optimizer-mcp · JavaScript★ 522

以 MCP 形式接入的度量工具：能统计每个编码 Agent 到底省下多少 Token、优化了多少上下文，并在 16 个以上 Agent 之间共享一个本地知识图谱。适合已经装了多个 Agent、想把「省了多少」这件事量化出来再做取舍的人。

Context-Engine #

Context-Engine-AI/Context-Engine · Python★ 400

走 MCP 协议的上下文压缩套件，把压缩、检索与记忆合并成一整套服务，由 Agent 自主调用。适合想把上下文管理做成团队基础设施、而不是零散提示词技巧的工程团队。

OpenCE #

sci-m-wang/OpenCE · Python★ 331

Open Context Engineering 社区工具箱：提供上下文策略的实现、评估与组合对比框架。偏研究取向，适合想系统比较不同压缩与记忆策略效果、而不是直接拿来用的开发者或研究者。

S2 · 技能合集与配置框架#

解决「装什么、怎么配」的问题。合集类项目可以一次性补齐几十到上千个技能；框架类项目统一你的工作流与行为准则；管理类项目帮你同时驾驭多个 Agent。选择标准：刚上手从「单文件配置」开始，成本最低；已经上手再考虑大合集，按需挑选而不是全量安装。这些技能大多源自 Claude Code 生态，但遵循统一的 Agent Skills 规范，Claude Code、Codex、Cursor 等支持该规范的客户端都能加载。

Superpowers #

obra/superpowers · Shell★ 285.9k

目前最完整的 Agent 技能框架之一，把软件开发的整套方法论固化成技能：需求对齐 → 测试驱动开发 → 代码审查 → 架构优化。装进 Claude Code 后，Agent 会按既定工程流程推进，而不是随手开始写代码。适合想要「工程纪律」的个人与团队，也是理解 Skill 体系怎么设计的最佳样本。

ECC 性能优化全家桶 #

affaan-m/ECC · JavaScript★ 257.3k

体量最大的技能合集之一，包含数十个 Agent 与上百个 Skill，覆盖前端、后端、测试、运维、安全与研究。适合一次性补齐能力版图的开发者；因为体量大，建议先看目录再按需安装，避免把上下文挤满。

andrej-karpathy-skills #

multica-ai/andrej-karpathy-skills★ 212.7k

只有一份 CLAUDE.md 配置文件，内容基于 Andrej Karpathy 对大模型编程行为的观察整理，专门用来纠正 Claude Code 常见的坏习惯（过度抽象、乱改无关代码、不做验证就宣布完成）。是所有项目里上手成本最低的一个——不改代码、不装依赖，覆盖文件即可生效。

Anthropic Official Skills #

anthropics/skills · Python★ 176.0k

Anthropic 官方发布的 Agent Skills 仓库，定义了技能的标准结构、写法与官方示例。它是判断第三方技能是否规范的参照物；想自己写 Skill 的话，从这里开始最不容易走弯路。

awesome-claude-skills #

ComposioHQ/awesome-claude-skills · Python★ 74.9k

社区精选的 Claude 技能、资源与工具清单，带分类与一句话说明。适合先整体逛一圈、建立「有哪些能力可用」的认知，再决定装哪一个。

awesome-claude-code #

hesreallyhim/awesome-claude-code · Python★ 54.0k

手工筛选的 Claude Code 资源合集，偏工具、工作流与实战技巧，比纯清单多了使用场景说明。适合已经用了一段时间、想找进阶玩法的人。

awesome-agent-skills #

VoltAgent/awesome-agent-skills★ 34.2k

1000+ 技能索引，来源既有官方团队也有社区贡献，兼容 Claude Code 生态。覆盖面最广，适合按关键词检索特定能力的技能。

awesome-claude-code-subagents #

VoltAgent/awesome-claude-code-subagents · Shell★ 25.0k

100+ 个专用子代理，按角色划分：前端、后端、测试、安全、文档等。可以直接把「团队分工」搬进 Claude Code，让不同角色各管一摊。

claude-modular #

oxygen-fragment/claude-modular★ 283

模块化的 Claude Code 框架，提供 30+ 命令并自带 Token 优化与 MCP 服务器集成。适合想把 Claude Code 配置成一套标准化工作环境（而不是东一个技能西一个插件）的人。

CC-Switch #

farion1231/cc-switch · Rust★ 132.6k

跨平台桌面客户端，统一管理 Claude Code、Codex、OpenCode、OpenClaw、Grok Build、Hermes 等多个工具与模型切换。适合同时使用多个 Agent、不想反复手改配置文件的人。

CCPM 项目管理 #

automazeio/ccpm · Shell★ 8.4k

基于 GitHub Issues 与 Git Worktree 的项目管理技能系统，让多个 Agent 并行开工而互不抢占同一份代码。适合用 GitHub 做研发管理、想让 Agent 真正参与协作流程而非单打独斗的团队。

S3 · 浏览器与联网操控技能#

让 Agent 能「看见并操作」网页。这一类要区分两件事：联网取信息（读取、抓取、检索）与浏览器操控（点击、输入、提交流程）。选择标准：只需要读内容选联网型；要跑完整网页流程选操控型；被反爬拦截时优先选能复用你已登录浏览器状态的那种。

Web Access #

eze-is/web-access · JavaScript★ 8.9k

给 Claude Code 补上完整联网能力的技能：三层通道调度（接口 / 渲染 / 兜底）+ 浏览器 CDP + 并行分治，既能读网页也能并发抓多源数据。适合需要 Agent 自己上网查资料、监控信息、批量收集素材的场景。

Dev Browser #

SawyerHood/dev-browser · TypeScript★ 6.6k

Claude 技能形态的浏览器控制，偏前端调试方向：查看页面元素、分析网络请求、复现页面问题。适合前端工程师让 Agent 自己开浏览器排查而不是靠人肉描述。

agent-browser #

vercel-labs/agent-browser · Rust★ 42.5k

Vercel 出品的浏览器自动化命令行工具，用 Rust 编写，为 Agent 提供统一的 CLI 接口。适合把浏览器操作接进已有脚本、CI 流水线或自定义 Agent 项目中。

mcp-chrome #

hangwin/mcp-chrome · TypeScript★ 12.4k

以 Chrome 扩展形式实现的 MCP Server，直接把你自己已登录的浏览器暴露给 Agent 使用。相比新开一个没有登录态的浏览器，它的优势是能直接复用你的账号、Cookie 与浏览状态，省掉反复登录与验证码。

S4 · 办公文档与文件解析#

出报告、做汇报、把文件变成数据。要分清两个方向：生成（写 Word、做 PPT、套模板）与解析（把 PDF、扫描件读成结构化数据），两者通常不通用。选择标准：对格式要求严格选模板引擎；要 AI 直接产出选办公套件；要做知识库入库选解析器；版式复杂、扫描件优先选视觉大模型方案。

OfficeCLI #

iOfficeAI/OfficeCLI · C#★ 30.5k

专为 AI Agent 打造的 Office 套件，用命令行读写 Word、Excel、PowerPoint。适合批量生成与批量改写文档，或把 Office 文件处理接进自动化流水线——它面向的是「程序调用」而不是「人点界面」。

megaparse #

The-Vibe-Company/megaparse · Python★ 7.4k

面向 LLM 的无损文件解析器，把 PDF、Docx、PPTx 一次性转成适合模型消化的结构化格式，尽量不丢表格与层级。适合做知识库入库、批量文献处理这类「先解析再喂模型」的流水线。

GenOffice #

genspark-ai/genoffice · TypeScript★ 6.6k

开源 AI 办公套件：Docs、Sheets、Slides、PDF、Markdown、HTML 编辑器一站齐全，内置 AI Agent。适合想自建一套办公工具、让文档数据完全留在自己环境里的人。

docxtemplater #

open-xml-templating/docxtemplater · JavaScript★ 3.6k

老牌模板引擎，用「文档模板 + JSON 数据」批量生成 docx、pptx、xlsx。需要严格格式的合同、报表、投标文件时，它比让 AI 从零写文档稳定得多，也是把 AI 输出落进固定版式的常见做法。

text-extract-api #

CatchTheTornado/text-extract-api · Python★ 3.2k

文档解析 API 服务，支持 PDF、Word、PPTX，结合现代 OCR 与本地 Ollama 模型，可完全私有化部署。适合要自建文档入库服务、又不想把资料传到第三方的团队。

vision-parse #

iamarunbrahma/vision-parse · Python★ 482

用视觉大模型把 PDF 解析成 Markdown，对多栏排版、扫描件、图表混排的文档效果明显好于规则解析。适合处理论文、扫描合同、旧版报告这类「版式不听话」的文件。

claude-code-polished-documents-skills #

promptadvisers/claude-code-polished-documents-skills · Python★ 15

Claude Code 的文档生成与排版技能合集，把「文档写成什么样才算好看」固化成可复用技能。项目偏小众、星标不多，但方向明确，适合对文档观感有要求的人自行取用。

S5 · 内容创作与新媒体运营#

国内外平台差异很大：国内以小红书、公众号为主，海外以亚马逊、独立站为主。内容侧管选题到发布，视觉侧管图与版式，增长侧管 SEO 与流量。选择标准：做号选内容运营类；做店选店铺与选品类；要做站外流量选增长类。多数项目依赖账号权限，使用前先确认平台规则。

guizang-social-card-skill #

op7418/guizang-social-card-skill · HTML★ 7.0k

生成小红书图集与公众号头图配对的技能，支持 21<9> 封面 + 1<1> 方图成套输出，内置编辑风、瑞士风等多套版式。适合需要稳定视觉风格、又不想每次都手动排版的日更账号。

XiaohongshuSkills #

white0dew/XiaohongshuSkills · Python★ 3.4k

支持小红书自动发布、自动评论与自动检索的 Skill，兼容 OpenClaw、Codex、Claude Code 等客户端。适合把账号日常维护（发帖、互动、找选题）交给 Agent 的人。

xiaohongshu-ops-skill #

Xiangyu-CAS/xiaohongshu-ops-skill★ 2.3k

把 OpenClaw 变成小红书运营助手：覆盖账号分析、选题、内容创作、数据复盘、爆款复刻，甚至支持全托管运营。适合想把整个账号运营流程交给 Agent 的重度用户。

xiaohongshu-skills #

autoclaw-cc/xiaohongshu-skills · Python★ 1.9k

小红书技能集合，轻量脚本向，功能比上面两个更基础，胜在简单直接。适合只想补一两个具体动作（比如批量下载、批量检索）的人。

电商视觉文案 Skill #

feichanggege/ecommerce-visual-copywriting-skill · Python★ 748

把资深电商设计师的商品图方法论固化成 SOP 技能，让新手也能一键产出有设计感的商品主图与卖点文案。兼容 Claude、Codex、Cursor、WorkBuddy 等 SKILL.md 规范客户端。

wechat-article-skills #

aiworkskills/wechat-article-skills · Python★ 597

微信公众号 AI 运营助手的全流程技能：选题、写稿、审稿、排版、配图、发布一条链走完。支持 OpenClaw、Claude Code、Cursor、Codex 等客户端，适合公众号日更或周更的运营者。

eCommerce-Skills #

nexscope-ai/eCommerce-Skills · Python★ 919

电商通用技能包，覆盖选品调研、营销自动化、供应链优化与客服支持。适合做独立站或跨境业务的运营者，先搭起整套流程再按需细化。

Amazon-Skills #

nexscope-ai/Amazon-Skills · Python★ 664

亚马逊卖家专用技能：关键词研究、竞品分析、Listing 体检等。免费开源、即装即用，适合刚做亚马逊、需要快速补齐基础运营动作的卖家。

claude-seo #

AgriciDaniel/claude-seo · Python★ 16.8k

通用 SEO 技能，包含 25 个子技能与 18 个子代理，覆盖技术 SEO、E-E-A-T、结构化数据、内链优化等。适合做站点流量、需要系统化审计而不是零散建议的人。

qiaomu-anything-to-notebooklm #

joeseesun/qiaomu-anything-to-notebooklm · Python★ 6.0k

Claude 技能：把微信公众号文章、网页、YouTube 视频、PDF 等多源内容统一转成 NotebookLM 可用素材。适合做研究工作流、需要把散落资料汇总成一份可问答知识库的人。

CapCut Mate（剪映助手）#

Hommy-master/capcut-mate · Python★ 1.8k

开源剪映助手，通过剪映 API 生成并下载草稿文件，可配合扣子（Coze）插件使用。适合用固定模板批量出片的团队——先做好模板，再让程序批量填内容。

video-podcast-maker #

Agents365-ai/video-podcast-maker · Python★ 1.6k

给编码 Agent 用的视频技能：给一个主题直接产出 4K 配音视频，配音可走本地 edge-tts（免费）或 Azure 语音，也支持清单化批量制作。适合做口播视频、播客视频化的创作者。

S6 · 科研与学术写作#

覆盖「读文献 → 想选题 → 写论文 → 出图表 → 投稿」的链路上游环节。文献检索与管理是刚需，成稿润色是提效，配图与传播是加分项。选择标准：先解决「AI 能不能读到真论文」，再解决「写得像不像人」。

arxiv-mcp-server #

blazickjp/arxiv-mcp-server · Python★ 3.1k

本地 MCP 服务器，面向文献工作：可以直接读 arXiv 论文的原始 LaTeX 分节内容（而不是读二手摘要），并从元数据生成 BibTeX。装好之后 Agent 才算真正「读过论文」，这是科研场景最值得先配的一环。

medical-research-skills #

aipoch/medical-research-skills · Python★ 1.9k

数百个医学研究技能，覆盖试验方案设计、数据分析、证据综述等。医学方向专用，非医学场景不必安装，否则只会占用上下文。

qinyan-academic-skills #

LeonChaoX/qinyan-academic-skills · Python★ 886

包含 182 个可安装学术技能的多语言技能库，覆盖文献检索到成稿写作的全链路。适合希望一次性把科研工作流搭起来的硕博研究者。

sepia #

Nanako0129/sepia · Python★ 2.6k

「去 AI 味」写作技能：让 AI 写出的文字不再有明显机器痕迹，适用于任何兼容 Agent Skills 规范的客户端。写论文、投稿、正式文稿时特别有用，审稿人对 AI 腔调很敏感。

paper2anything #

QuZhan51496/paper2anything · Python★ 428

把论文 PDF 一键转成幻灯片、海报、网页或小红书图文。适合论文发表之后的传播环节——同一份内容，快速适配不同平台的分发格式。

S7 · 安全与测试#

上线前的自查与他查。防御向是审计自己的代码、扫描漏洞；攻防向是模拟渗透以验证防护；合规向是把技能映射到安全框架。请在获得授权的前提下使用攻防类工具。

reverse-skill #

zhaoxuya520/reverse-skill · PowerShell★ 35.7k

逆向工程、授权渗透测试与安全研究的技能路由包，会用 AI 自动把任务分派到对应的专项技能上。威力较大，务必只在自有系统或已获书面授权的范围内使用。

Anthropic Cybersecurity Skills #

mukul975/Anthropic-Cybersecurity-Skills · Python★ 32.7k

817 个结构化网络安全技能，映射到 MITRE ATT&CK、NIST CSF 2.0 等 6 大安全框架。适合企业安全团队做体系化自查，也方便把技术动作对应到合规条款上。

pentest-ai-agents #

0xSteph/pentest-ai-agents · Shell★ 2.2k

把 Claude Code 改造成攻防研究助手，附带多个专职子代理（侦察、利用、报告等）。适合授权范围内的渗透测试与研究性工作。

Mantis #

google/mantis · Python★ 1.5k

谷歌开源的模块化安全审查技能包，与技术栈无关，让编码 Agent 能自主发现并修复漏洞。适合接进日常开发流程做「写完就查」的一道关。

Bandit #

PyCQA/bandit · Python★ 8.3k

Python 代码静态安全扫描工具，老牌、稳定、误报可控。它本身不是 AI 技能，但非常适合接进 CI 作为基础检查层，与 AI 审查互补。

S8 · 设计与图表#

把想法变成可视化产物。图表是架构图、流程图；UI 是界面稿；规范是让所有产出风格统一的视觉体系。选择标准：技术文档配图选「图表即代码」；要做产品界面选 UI 生成；要品牌一致选规范类；团队协作选能和现有编辑器共存的。

Fireworks Tech Graph #

yizhiyanhua-ai/fireworks-tech-graph · Python★ 11.4k

Claude Code 技能：从自然语言生成生产级 SVG + PNG 技术图表，支持 7 种风格与 UML，输出可直接进文档或论文。适合需要频繁画架构图、流程图的工程师与技术写作者。

Stitch Skills #

google-labs-code/stitch-skills · TypeScript★ 8.3k

配合 Stitch MCP 服务器使用的 UI 生成技能库，每个技能都遵循 Agent Skills 规范。适合从文字描述生成界面稿、再快速迭代产品的场景。

DESIGN.md #

google-labs-code/design.md · TypeScript★ 27.9k

一种描述视觉识别体系的格式规范：把品牌色、字体、间距、组件规则写进 DESIGN.md，让编码 Agent 始终按同一套视觉语言产出页面。适合需要多个页面风格统一的产品团队。

diagram-as-code #

awslabs/diagram-as-code · Go★ 1.6k

AWS 官方维护的架构图即代码工具，用代码描述 AWS 架构并生成图。适合已经在写基础设施即代码的人顺手出架构图，图与配置不会脱节。

html-anything #

nexu-io/html-anything · HTML★ 8.8k

Agentic HTML 编辑器：75 个技能 × 9 种输出形态（杂志、落地页、海报等），让本地 Agent 直接写 HTML 并交付成品页面。适合需要快速产出网页物料、又不想每次手写样式的人。

oxdraw #

RohanAdwankar/oxdraw · Rust★ 2.3k

Rust 编写的「图即代码」工具，特色是支持拖拽编辑——代码生成与手动微调可以共存，改完还能回到代码。适合既要版本管理又要精细调整的绘图需求。

Diagrams #

mingrammer/diagrams · Python★ 42.6k

用 Python 代码画云架构图的开创性项目，覆盖主流云厂商图标库。适合把架构图纳入版本管理、跟着代码一起演进的技术团队。

vscode-drawio #

hediet/vscode-drawio · TypeScript★ 9.5k

把 draw.io 集成进 VS Code 的扩展，人和 Agent 可以修改同一份图文件。适合习惯在编辑器里完成一切、不想来回切工具的开发者。

S9 · 金融分析#

让 AI 帮忙读财报、做投研。这一类的核心价值是把分析流程结构化，而不是预测涨跌——请把输出当作研究辅助而非投资建议。选择标准：个人投研选分析技能；要建策略体系先看资源清单建立认知，再挑框架。

InvestSkill #

yennanliu/InvestSkill · JavaScript★ 209

面向美股的分析技能，适配 Claude Code、Gemini 等客户端，把基本面梳理、财报解读等动作固化成可复用技能。适合个人投资者让 AI 先做一轮资料整理与要点提炼。

awesome-quant-ai #

leoncuhk/awesome-quant-ai · Jupyter Notebook★ 604

量化投资与交易策略的精选资源清单，按主题归类。适合在选工具之前先建立整体认知——先看全景，再决定投入哪个方向。

S10 · MCP 与自动化集成#

这一层决定「AI 能碰什么」。MCP 是给 Agent 装手的标准协议；工作流平台是把 AI 接进已有业务系统；IM 接入是让它在微信、群里出现。选择标准：要给 Agent 加工具能力看官方 MCP 目录；要打通业务系统看 n8n 系；要做远程指挥看 IM 接入类。

MCP Servers #

modelcontextprotocol/servers · TypeScript★ 90.3k

官方 MCP 服务器合集，包含文件系统、数据库、搜索等基础能力，是给 Agent 装「手」的起点。想扩展 Agent 能触碰的范围，一般从这里开始找官方实现。

n8n-mcp #

czlonkowski/n8n-mcp · TypeScript★ 22.9k

让 Claude Desktop、Claude Code、Cursor、Windsurf 直接构建 n8n 工作流的 MCP 服务。适合已经用 n8n 做自动化、想让 AI 帮忙搭流程而不是自己拖拽的人。

XcodeBuildMCP #

getsentry/XcodeBuildMCP · TypeScript★ 6.4k

为 Agent 提供 Xcode 构建工具的 MCP 服务器与 CLI，让 Agent 能编译、跑测试、读日志，常用于 iOS 与 macOS 开发。

mobile-mcp #

mobile-next/mobile-mcp · TypeScript★ 6.7k

面向移动端自动化与抓取的 MCP 服务器，支持 iOS、Android、模拟器与真机。适合做移动端测试自动化，或把手机操作接进编码 Agent 与 CI。

wechat-claude-code #

Wechat-ggGitHub/wechat-claude-code · TypeScript★ 682

一个让 Claude Code 能在微信里对话的技能，相当于把微信变成远程指挥台。适合人不在电脑前、但想随时下发任务的场景。

n8n-workflows #

Zie619/n8n-workflows · Python★ 56.6k

目前能收集到的 n8n 工作流大合集（含官方站点上的公开流程）。适合需要现成流程直接改造、不想从头拖拽的人。

awesome-n8n-templates #

enescingoz/awesome-n8n-templates★ 25.3k

280+ 免费 n8n 模板，覆盖 Gmail、Telegram、Slack、Discord、WhatsApp、Google 全家桶等。适合按场景搜模板，改一改就能用。

self-hosted-ai-starter-kit #

n8n-io/self-hosted-ai-starter-kit★ 15.2k

n8n 官方的一键自托管 AI 环境模板（n8n + Ollama + Qdrant），几条命令就能把本地 AI 工作流跑起来。适合想完全掌控数据、不愿依赖云端服务的人。

S11 · 短视频生产与多平台分发#

这一类的目标只有一个：把「做内容」的重复劳动压到接近零。选型看两点——生产端是「从主题到成片」还是「已有素材只做混剪」；分发端是否需要多平台矩阵与定时排期。提醒：批量发布最容易踩平台风控，务必先小规模验证频率与账号隔离策略。

Pixelle-Video #

ATH-MaaS/Pixelle-Video · Python★ 28.1k

AI 全自动短视频引擎：输入一个主题，自动完成文案、配音、配图、剪辑与字幕并直接输出成片。适合知识科普、口播矩阵号，把「做一条视频」压缩成一次调用。

MoneyPrinterPlus #

ddean2009/MoneyPrinterPlus · Python★ 7.1k

一键批量生成 + 自动混剪短视频，并可直接发布到抖音、快手、小红书、视频号；支持接入本地语音模型做配音。适合已有稳定选题、要冲量的账号矩阵。

social-auto-upload #

dreammis/social-auto-upload · Python★ 14.9k

用 Playwright 模拟真人操作浏览器上传，把成片自动分发到抖音、小红书、视频号、B 站、TikTok、YouTube。适合「只差发布这一步」的团队。

MultiPublish #

whut09/MultiPublish · JavaScript★ 9

一次上传、多平台同步的桌面客户端，支持定时发布与矩阵账号统一管理。思路对标商业工具（易媒助手 / 蚁小二），适合想自建发布链路的人。

PostFlow #

jefftko/PostFlow · Python★ 3

多账号排期发布工具：内容排好队到点自动发，并把播放与互动数据回流成表，用来复盘选题方向。

xhs-matrix #

zuowangyan/xhs-matrix · TypeScript★ 4

小红书 AI 矩阵运营系统：采集选题 → 按人设与知识库生成原创图文 → 多账号拟人化自动发布。桌面端运行，支持局域网共享。

S12 · 跨境电商与选品运营#

跨境场景的自动化集中在四件事：选品（找需求）、上架（写文案做图）、流量（达人分销与素材）、情报（盯竞品与政策）。选型看你的平台：亚马逊系优先看前两条；TikTok Shop 看达人邀约与商品视频两条；多平台铺货看全流程平台型工具。注意星标极少的项目属于尝鲜性质，请先小规模验证。

Awesome Amazon EC Skills #

hikari0511/awesome-amazon-ec-skills · Shell★ 160

亚马逊运营技能全集：覆盖选品、Listing 优化、视觉素材、广告投放、评论处理与售后客服的全流程技能包，可直接接入支持 Skill 机制的 Agent 客户端。

Atlas Mercator #

hhdhh/atlas-mercator · Python★ 4

跨境全流程 Agent：Listing 本地化改写、基于知识库的 RAG 智能客服、营销文案生成与竞品情报挖掘，面向亚马逊 / eBay / 独立站。

CrossPulse 跨境脉搏 #

hooper-lee/crosspulse · Python★ 16

每日自动抓取亚马逊、TikTok Shop、Temu 等平台的市场情报，做结构化日报推送到飞书或微信，用来捕捉爆款趋势、政策变化与竞品动态。

EcomAgent 选品分析 #

yoligehude14753/ecom-agent · Python★ 12

抓取各站点畅销榜做三维评分（竞争度 / 利润 / 趋势），并从评论中批量提取痛点，输出可执行的选品建议。纯 Python，可对接本地模型。

TradeMind 贸灵 #

lien0219/trademind-ai · Python★ 26

从商品采集、文案优化、图片处理到多平台刊登与订单库存协同的全流程工具，支持私有化部署，数据留在本机。

eCan.ai #

scszcoder/eCan.ai · TypeScript★ 20

基于 LangGraph 的电商多 Agent 系统，覆盖采购选品、营销内容生成与智能客服三大板块，工作流可自定义，适合二次开发。

妙手自动化工作台 #

XManner/Miaoshou-Auto-Tool · JavaScript★ 22

TikTok Shop 东南亚场景的自动化工作台：1688 / Shopee 采集选品、商品信息批量优化、自动发布与秒杀价格同步。

TikTok Shop 联盟邀约 Bot #

younkiflattxzt31/tiktok-shop-bot · Python★ 0

批量导入达人名单 → 生成个性化邀约话术 → 自动私信 → CRM 式跟踪回复状态，用于卖家联盟分销扩量。星标极少，属尝鲜项目，请先小规模验证。

TikTok 商品视频自动化 #

haykguy/tiktok-automation · Python★ 0

商品视频流水线：抓取商品信息 → 生成商品图 → 转成短视频 → 加字幕配音 → 批量导出待发布。星标极少，同属尝鲜项目。

TradePilot 外贸工作台 #

feifei9126/tradepilot · TypeScript★ 44

开源的外贸 CRM 与订单履约工作台：客户、询盘、报价、出货全流程管理，支持 Firecrawl 采集与 Ollama 多模型接入，Docker 一键部署。

S13 · 内容创作技能集#

与 S5 的单点技能不同，这一类的价值在于 「成套的技能包」：一次装好一整套写作流程，而不是自己一个个拼装。适合把长文写作、公众号运营做成固定产线的人。

Skill 技能合集 #

anbeime/skill · Python★ 6.6k

通用技能合集：内容创作、视频制作、文案生成、资料整理等垂直场景的技能大全，可作为搭建自建技能库的素材来源。

文曲内容创作技能集 #

gogoingai/wenqu-skills · Markdown★ 6

面向「写文章」这一件事的技能集：覆盖资料积累、结构设计、文章撰写、审查优化到发布的全流程。星标不多，但流程拆得细，值得写作场景参考。

接下来：Skill 是「你点名它才动」；要能自己推进任务的执行者，翻到下一页的 Agent 智能体库。

Agent 智能体库：能自己推进任务的执行者#

← 返回开源能力库

A1 · 编程开发 Agent#

替代或增强 IDE 的编码主力。终端型适合自主跑任务、批量改代码；IDE 型适合边写边看、逐行确认；舰队型适合同时推进多个任务。选择标准：要「端到端交付」选终端型；要「可控、逐步确认」选 IDE 型；已有多套订阅想并行跑选舰队型。

Claude Code #

anthropics/claude-code · Python★ 144.9k

Anthropic 官方终端编码 Agent：能读整个代码库、理解项目结构、执行多步开发任务、跑命令与测试，端到端交付。它是目前自主性最强、生态最全的编码 Agent，也是 Skill / Subagent 体系的事实标准。适合愿意把完整工程流程交给 AI 的人。

OpenAI Codex #

openai/codex · Rust★ 123.7k

OpenAI 的轻量终端编码 Agent，Rust 编写，启动快、资源占用低，与 ChatGPT 生态打通。适合已经有 ChatGPT 订阅、想直接在终端里干活的用户。

OpenCode #

anomalyco/opencode · Go★ 207.0k已迁移

开源终端编码 Agent，支持多会话并行与沙盒终端，常被称作「开源版 Claude Code」。注意仓库迁移：原 opencode-ai/opencode 已归档（最后一个提交停在 2025 年 9 月），项目现由 anomalyco/opencode 维护，官网 opencode.ai。

DeepSeek Harness #

deepseek-ai/deepseek-harness · TypeScript★ 221.9k

DeepSeek 官方的 Agent 框架，设计理念是「一切皆插件」，对自家模型做了深度适配，成本极低。适合想用 DeepSeek 模型跑 Agent 工作流、又要高度可定制的开发者。

Orca #

stablyai/orca · TypeScript★ 67.4k

面向「一支 Agent 舰队」的 ADE（Agent 开发环境）：可以并行运行多个编码 Agent，各自使用自己的订阅额度。适合同时推进多个任务、或需要多模型交叉验证的开发者。

Codewhale #

Hmbown/Codewhale · Rust★ 41.0k

Rust 编写的开源终端编码 Agent，轻量单二进制，社区持续改进中。适合追求启动速度与低资源占用、不想要重型运行时的用户。

herdr #

herdrdev/herdr · Rust★ 38.1k

为编码 Agent 提供运行时底座，负责进程、终端与会话管理。它本身不写代码，而是让别的 Agent 跑得更稳，属于基础设施层。适合自建 Agent 平台的团队参考。

DeepSeek-Reasonix #

esengine/DeepSeek-Reasonix · Go★ 35.5k

DeepSeek 原生的终端编码 Agent，围绕前缀缓存的稳定性做优化，适合长时间挂着跑、反复读取同一代码库的场景——缓存命中率高，成本与延迟都会明显下降。

oh-my-pi #

can1357/oh-my-pi · TypeScript★ 30.9k

把 IDE 直接接进 Agent 的编码工具，让你既能享受 IDE 的浏览与补全，又能让 Agent 自主执行任务。适合习惯 IDE 工作流、又不想完全切到终端的开发者。

DeepCode #

HKUDS/DeepCode · Python★ 16.5k

香港大学数据智能实验室出品，研究 Agent Harness、循环工程与多智能体编排。偏研究向，适合想理解 Agent 系统怎么设计、而不是只想要个能用的工具的人。

A2 · 多智能体编排与团队协同#

把一个大任务拆给多个角色并行做，常见分工是「规划 - 执行 - 复核」。要开箱角色选专家目录类；要自己定义流程选编排框架类；要跑在 Claude Code / OpenClaw 里选工程化编排类。注意：多智能体不是越多越好，协作开销与调试难度会同步上升。

Hermes Agent #

NousResearch/hermes-agent · Python★ 245.0k

Nous Research 出品的 Agent，主打「随你成长」：通过持续学习与记忆积累越来越贴合你的习惯。适合愿意长期培养一个固定 Agent、而不是每次重新开始的人。

ruflo #

ruvnet/ruflo · TypeScript★ 72.3k

号称「原始 Agent Harness」，可以部署多智能体集群（swarm）、协调自主工作流，并为每个 Agent 提供独立运行环境。适合需要大规模并行 Agent 的工程场景。

MetaGPT #

FoundationAgents/MetaGPT · Python★ 70.3k

模拟一家软件公司的多智能体框架：产品经理、架构师、项目经理、开发、测试各司其职，把一句话需求逐步变成设计文档与可运行代码。适合想体验「全流程 AI 团队」的人，也是多智能体协作的经典参考实现。

AutoGPT #

Significant-Gravitas/AutoGPT · Python★ 187.3k

自主 Agent 的开创性项目：让模型自己拆解目标、调用工具、循环推进直到完成。今天的很多 Agent 设计思路都能追溯到它，适合作为理解自主循环的样本。

LangGraph #

langchain-ai/langgraph · Python★ 41.5k

LangChain 出品的图式编排框架，用「节点 + 边 + 状态」描述流程，天然支持循环、分支、重试与人工介入。适合需要精细控制、流程会反复迭代的项目。

oh-my-claudecode #

Yeachan-Heo/oh-my-claudecode · TypeScript★ 39.1k

面向 Claude Code 的「团队优先」多智能体编排，把角色分工与协作流程直接做进 Claude Code 工作流。适合已经在用 Claude Code、想升级成多人协作模式的人。

OpenAI Agents SDK #

openai/openai-agents-python · Python★ 29.4k

OpenAI 官方的轻量多智能体框架，支持任务交接（handoff）、工具调用与执行追踪。适合想用官方标准搭建 Agent 流水线、又不想引入重型依赖的开发者。

Swarm #

openai/swarm · Python★ 22.0k

OpenAI 早期的教学向轻量编排框架，用来理解 handoff 机制与多智能体协作的基本模型。官方明确定位为教育用途，不建议用于生产。

agency-agents-zh #

jnMetaCode/agency-agents-zh · Shell★ 20.6k

277 个即插即用的中文 AI 专家角色，覆盖工程、设计、营销、金融等 20 个部门，含 64 个中国市场原创角色（小红书、抖音、微信生态等）。支持 Claude Code、Cursor、Copilot 等 20 种工具。

edict（三省六部制）#

cft0808/edict · Python★ 16.9k

基于 OpenClaw 的中文多智能体编排系统，用「三省六部制」组织 9 个专职 Agent，配实时看板展示任务流转。适合喜欢结构化角色分工、希望流程一目了然的团队。

Microsoft Agent Framework #

microsoft/agent-framework · Python★ 13.5k

微软官方框架，用于构建、编排与部署 Agent 及多智能体工作流，支持 Python 与 .NET。适合已有 .NET 技术栈、需要企业级支持与长期维护承诺的团队。

A3 · Agent 框架与可视化平台#

自己搭 Agent 或自动化流程。代码框架灵活但要写代码；可视化平台拖拽即可，适合交给非技术同事。选择标准：要接进自己的业务系统选代码框架；要做内部工具、审批流选可视化平台；要群机器人选 IM 接入型；要桌上助理选桌面级。

LangChain #

langchain-ai/langchain · Python★ 146.2k

LLM 应用开发的事实标准：链式调用、工具绑定、记忆管理、检索集成一应俱全，生态与文档最完善。要把 AI 能力接进自己的业务系统，通常从它开始。

Dify #

langgenius/dify · TypeScript★ 155.6k

可视化 Agentic 工作流 + RAG 流水线平台，拖拽即可搭建，支持多模型与工具，提供企业版部署方案。适合不想写代码就把流程跑起来、或者要交给同事维护的场景。

n8n #

n8n-io/n8n · TypeScript★ 204.1k

开源工作流自动化平台，400+ 集成加上原生 AI 节点，把 AI 接进已有业务系统（CRM、工单、邮件、表格）的首选。可视化的同时仍可写自定义代码。

nanobot #

HKUDS/nanobot · Python★ 48.1k

超轻量自托管个人 Agent 框架，自带 WebUI、工具系统、记忆与 MCP 支持，纯 Python 实现、代码量小。适合看得懂代码、想自己改造的学习者与开发者。

AstrBot #

AstrBotDevs/AstrBot · Python★ 40.4k

支持多 IM 平台接入的 Agent 框架，插件生态丰富，适合做群机器人（QQ、微信等）与社区运营助手。

CowAgent #

zhayujie/CowAgent · Python★ 46.9k

开源超级 AI 助手与 Agent Harness：能规划任务、调用工具与技能、靠记忆自我进化，并含微信生态接入。适合想自建一个「什么都能干一点」的私人助手的人。

Haystack #

deepset-ai/haystack · Python★ 26.5k

面向生产环境的 AI 编排框架，强项在检索与管道化设计，组件可替换、可测试。适合做企业级文档问答与知识系统。

Sim #

simstudioai/sim · TypeScript★ 29.6k

团队协作式的 Agent 构建、部署与监控工作台：流程可视化，多人可共同维护，带运行监控。适合业务团队自己维护自动化流程。

LobsterAI #

netease-youdao/LobsterAI · TypeScript★ 6.0k

网易有道开源的桌面级 Agent，主打真实工作任务：数据分析、幻灯片、文档、视频与网络调研。适合想要一个开箱即用的桌面助理、又希望数据可自控的用户。

GenericAgent #

lsdefine/GenericAgent · Python★ 14.2k

自进化 Agent：从一个几千行的种子实现出发，靠任务沉淀不断长出技能树，官方称用约 1/6 的 Token 实现完整系统控制。适合对「Agent 如何自我进化」这一方向感兴趣的开发者。

Everywhere #

Sylinko/Everywhere · C#★ 6.3k

桌面感知型 AI 助手：能读取你当前正在用的应用与屏幕内容，配合多个模型与 MCP 工具就地帮你处理问题，不用复制粘贴。适合需要「看懂我在干什么」的即时辅助场景。

Medusa #

medusajs/medusa · TypeScript★ 36.3k

面向 Agent 与开发者的开源电商中台，模块化程度高，可自建商城并把 AI 能力接进商品、订单、营销流程。适合做电商自建站的技术团队。

A4 · 浏览器与电脑操控 Agent#

让 AI 像人一样点网页、开软件。核心差异在两个维度：反检测能力与操控层级（只操作浏览器，还是操作整个桌面）。选择标准：普通采集选基础型；被反爬拦截选隐身型或复用已登录状态的；要动本地软件、文件、终端选桌面操控型。注意这类工具权限很高，建议只在虚拟机或受控环境中运行未知代码。

OpenClaw #

openclaw/openclaw · TypeScript★ 389.5k

目前星标最高的开源个人 Agent 框架，本地运行、跨平台，通过 WhatsApp、Telegram、Discord、Slack、Teams、iMessage 等聊天入口指挥它干活，自带 Gateway 安全边界、技能与插件体系、Cron 与 Webhook 触发。适合想让 AI 真正接管日常事务（整理收件箱、发邮件、管日历）的人。它也衍生出了大量生态项目，本清单中多个技能都基于它开发。

Browser Use #

browser-use/browser-use · Python★ 114.4k

目前最主流的浏览器 Agent 库，基于 Playwright，能点击、输入、滚动、截图，用自然语言完成任务。适合做数据采集、表单填写、流程验证，以及作为自建浏览器 Agent 的基础库。

OpenManus #

FoundationAgents/OpenManus · Python★ 58.3k

操控整台电脑的开放 Agent：浏览器、文件、终端、办公软件都能动，支持手机远程下发任务。适合需要跨应用自动化、又不满足于只操作网页的场景。

AIHawk #

feder-cr/AIHawk · Python★ 30.4k

自带反检测能力的浏览器 Agent，能绕过常见反爬与自动化识别系统。适合普通采集工具频繁被拦截的场景（请遵守目标网站的服务条款）。

cua #

trycua/cua · HTML★ 22.6k

Computer-Use 驱动与跨系统机群方案，附带训练、评估与基准测试工具。适合要搭建多台机器统一操控、或做 Computer-Use 方向研究评估的团队。

ego-lite #

citrolabs/ego-lite · JavaScript★ 15.8k

主打速度与「共享会话」的 Agent 专用浏览器：直接使用你已经登录的浏览器状态，省去反复登录与验证码，启动与响应都更快。适合高频次、需要登录态的网页自动化。

Nanobrowser #

nanobrowser/nanobrowser · TypeScript★ 13.8k

Chrome 扩展形态的浏览器 Agent，可以在浏览器里跑多智能体工作流，使用你自己的 API Key。适合不想装本地运行环境、又想在浏览器里做自动化的用户。

Agent-S #

simular-ai/Agent-S · Python★ 12.3k

学术背景较强的开源 Agent 框架，目标是让模型像人一样使用电脑：理解屏幕、规划动作、执行点击与输入。适合关注 Computer-Use 前沿实现的研究者与开发者。

Fara #

microsoft/fara · Python★ 6.2k

微软的 Computer-Use 模型家族，属于模型层而非工具。适合想自己搭建控制层、需要可直接调用的屏幕理解与操作能力的团队。

A5 · 数据分析与 BI#

从「看数据」到「问数据」。分两路：Text-to-SQL（自然语言直接查数据库）与对话式分析（自动出图、出结论）。选择标准：有数据库、要求 SQL 准确可查可选前者；只想要业务结论选后者；中文字段与业务术语多的话，优先考虑对中文优化的项目。

WrenAI #

Canner/WrenAI · Python★ 17.6k

面向 Agent 的 GenBI 平台，提供带治理能力的 Text-to-SQL：用开放语义层统一指标口径，再让 AI 生成可审计的 SQL。适合企业里既要自然语言问数、又要控制权限与口径一致性的场景。

Vanna #

vanna-ai/vanna · Python★ 23.8k已归档

用 RAG 提升准确率的 Text-to-SQL 框架，可以用你自己的 SQL 与文档训练，越用越准。不过要留意：该仓库目前已归档，代码仍可使用与阅读，但更新停滞；需要活跃维护的同类可看 WrenAI 或 SQLBot。

SQLBot #

dataease/SQLBot · JavaScript★ 6.8k

基于大模型 + RAG 的智能问数系统，中文场景友好，可搭配数据看板使用。适合国内团队直接用自然语言查业务数据、并把结果沉淀成报表。

Data-Analysis-Agent #

Zafer-Liu/Data-Analysis-Agent · JavaScript★ 2.5k

对话式数据分析助手：上传数据后直接提问，自动生成可视化图表与商业洞察。适合不懂 SQL、只想要结论的业务人员。

DB-GPT-Hub #

eosphoros-ai/DB-GPT-Hub · Python★ 2.0k

Text-to-SQL 方向的模型、数据集与微调方案集合。偏研究，适合要自己训练或微调专用模型的团队。

Agentar-Scale-SQL #

antgroup/Agentar-Scale-SQL · Python★ 473

蚂蚁集团开源，通过可扩展计算（多路生成 + 验证筛选）显著提升 SQL 生成的准确率。学术向，适合研究准确率提升方案的工程师。

A6 · 知识库、RAG 与记忆#

让 AI 用你的私有资料回答问题。RAG 解决「检索外部知识」，记忆层解决「跨会话记住上下文」，上下文压缩解决「塞得下多少」。选择标准：开箱即用的知识库选引擎类；需要关系推理选图结构类；要当服务部署选工程化程度高的；做研究看压缩与量化方向。

RAGFlow #

infiniflow/ragflow · Go★ 90.6k

深度文档理解的 RAG 引擎，对中文与复杂版式（表格、扫描件、多栏）表现好，带可视化切片与引用溯源。适合把一堆合同、论文、扫描件变成可问答的知识库。

LightRAG #

HKUDS/LightRAG · Python★ 39.6k

轻量快速的图增强 RAG：在普通检索的基础上叠加实体与关系，实现简单、启动成本低。适合想尝试图增强检索、但不想背 LangChain 全套依赖的项目。

GraphRAG #

microsoft/graphrag · Python★ 36.0k

微软的图结构 RAG 系统，先用模型抽取实体与关系构建知识图谱，再基于图做问答。适合需要跨文档关系推理的场景——「谁和谁有关」「这件事牵连了哪些主体」。

R2R #

SciPhi-AI/R2R · Python★ 8.0k

生产就绪的检索系统，支持 Agentic RAG 与 RESTful API，可直接当服务部署。适合要快速上线一个检索问答服务、而不是自己拼装组件的团队。

AutoRAG #

Marker-Inc-Korea/AutoRAG · TypeScript★ 5.1k

自动为你的数据寻找最优 RAG 组合（切片方式、嵌入模型、重排策略自动试），还能检索你本机的文件，用得越勤越准。适合不想手工调参、只要效果的实用派。

Verba #

weaviate/Verba · Python★ 7.7k已归档

基于 Weaviate 的 RAG 问答机器人，开箱即用、界面完整。需要注意：该项目目前已归档，可继续作为参考实现或自建起点，但不再跟进新版本。

KVQuant #

SqueezeAILab/KVQuant · Python★ 434

NeurIPS 2024 论文的实现：通过 KV 缓存量化把上下文推进到千万级长度。学术研究向，适合关注长上下文推理与显存优化的研究者。

A7 · 内容创作与音视频#

从素材到成片。三条线分开看：生成（文生图 / 文生视频）、剪辑（自动剪、加字幕、提高光）、配音（TTS 语音合成）。选择标准：批量出片选自动化工作流；要精修选剪辑型；只要声音选 TTS；做口播视频优先看支持本地 TTS 的方案。

MoneyPrinterTurbo #

harry0703/MoneyPrinterTurbo · Python★ 123.0k

输入主题或关键词，自动产出高清短视频：文案、素材、配音、字幕全流程自动化。国内用户量最大的短视频批量生成项目之一，适合做矩阵号、批量产出内容。

OpenMontage #

calesthio/OpenMontage · Python★ 58.0k

开源的 Agentic 视频制作系统，内置 12 条制作流水线、100+ 工具、700+ Agent 技能，从脚本到成片全链路覆盖。适合把视频生产做成标准产线的团队。

Video Use #

browser-use/video-use · Python★ 24.8k

用对话方式剪视频：把素材丢进文件夹，用自然语言告诉 AI 剪成什么样，Agent 自己完成裁剪、拼接与导出。适合不想学剪辑软件、只想说清楚要什么的人。

OpenCreator #

krillinai/OpenCreator · TypeScript★ 11.4k

面向创作者的 AI 工作台（前身 KrillinAI），基于 Codex，覆盖视频、图像、语音、虚拟形象等，含视频翻译与配音流程。适合做多语种内容分发的创作者。

AutoClip #

zhouxiaoka/autoclip · Python★ 7.3k

长视频自动提取高光片段的二创工具：自动识别精彩段落、切成短视频并生成封面。适合做直播切片、长内容二次分发。

FireRed-OpenStoryline #

FireRedTeam/FireRed-OpenStoryline · Python★ 3.4k

把手工剪辑流程变成「意图驱动」的 AI 剪辑 Agent：你描述想要的效果，它来完成剪辑决策。小红书团队开源，适合研究 AI 剪辑范式的团队。

TTS（Coqui）#

coqui-ai/TTS · Python★ 46.0k

经典深度学习语音合成工具包，研究与生产都在用，模型种类丰富、支持声音克隆。适合需要本地部署、对合成质量有要求的开发者。

index-tts #

index-tts/index-tts · Python★ 23.9k

工业级零样本语音合成系统：给一段参考音频即可复刻音色，中文表现好、可控性强。适合要做固定音色口播内容的创作者。

edge-tts #

rany2/edge-tts · Python★ 11.9k

调用微软 Edge 的在线语音合成服务，免费、无需 API Key、支持大量中文音色。适合快速给视频配音，也是各类自动化视频项目默认的配音方案。

Piper #

OHF-Voice/piper1-gpl · C++★ 5.6k已迁移

快速本地神经语音合成引擎，完全离线、资源占用低，适合嵌入到本地应用或自动化流程中。注意仓库迁移：原 rhasspy/piper 已归档，维护版本迁至 OHF-Voice/piper1-gpl。

CogVideo #

zai-org/CogVideo · Python★ 13.0k

智谱开源的文生视频与图生视频模型（CogVideoX 系列），可本地部署。适合想自建视频生成能力、而不是调用第三方接口的团队。

Diffusers #

huggingface/diffusers · Python★ 34.5k

图像、视频、音频扩散模型的标准库，几乎所有开源生成模型的官方实现都在这里。适合作为本地生成能力的地基，也方便横向比较不同模型。

A8 · 科研与学术 Agent#

从读文献到成稿的「会自己推进」的那一类。和技能类的区别是：它们会自主拆解研究任务、规划步骤、循环迭代。选择标准：要写长篇成稿选多 Agent 写作型；要做实验与工程规划选研究助手型；要看前沿方向选研究内核型。

MLE-Agent #

MLSysOps/MLE-agent · Python★ 1.6k

面向 AI 工程与科研的智能助手：能做实验规划、接入 arXiv 与论文库、辅助代码实现。适合做机器学习研究、需要有人帮忙梳理实验路线的同学。

opendraft #

federicodeponte/opendraft · Python★ 413

免费开源的论文写作 Agent：19 个 Agent 分工协作，约 10 分钟起草两万字学术论文并带引用整理。适合需要快速产出初稿、后续再精修的写作者。

CognitiveKernel-Pro #

Tencent/CognitiveKernel-Pro · Python★ 530

腾讯 AI Lab 开源的深度研究 Agent 内核，配套论文说明方法设计。适合研究长程研究任务如何规划与执行的技术团队。

PaperDebugger #

PaperDebugger/paperdebugger · TypeScript★ 1.5k

插件式的多 Agent 学术写作、评审与修订系统，直接工作在编辑器内。适合边写边改、希望 AI 充当审稿人角色的研究者。

A9 · 金融与量化#

投研分析与策略回测。分析类做多角色研报与行情解读；框架类做回测与交易执行。选择标准：只想让 AI 帮忙读财报、理逻辑选分析类；要跑策略回测、接实盘选框架类。所有输出都应视为研究辅助，不构成投资建议。

TradingAgents #

TauricResearch/TradingAgents · Python★ 104.9k

多智能体金融交易框架：模拟一个投研团队，分析师、研究员、交易员、风控各司其职并互相辩论后给出决策。适合研究「多角色协作如何提升金融分析质量」的人。

FinRL-Trading #

AI4Finance-Foundation/FinRL-Trading · Python★ 3.7k

AI 原生的模块化量化交易基础设施（FinRL-X），覆盖数据处理、策略训练到回测执行。适合有一定编程能力、想搭建完整量化链路的开发者。

QuantMuse #

0xemmkty/QuantMuse · Python★ 2.9k

完整量化系统实现，含 AI 分析、实时数据处理与交易执行。适合想参考端到端量化系统架构的开发者。

Financial-Analysis Multi-Agent #

imanoop7/Financial-Analysis—Multi-Agent-Open-Source-LLM · Python★ 147

开源的多智能体财报分析项目：多个 Agent 分工读取财报不同部分并汇总结论。适合想低成本试跑「AI 读财报」流程的人。

stock-analyst #

Agentic-Analyst/stock-analyst · Python★ 125

独立的金融分析 Agent 执行系统，可编排多个基于 LLM 的分析步骤形成流水线。适合把它作为自建金融分析系统的骨架。

A10 · 安全渗透 Agent#

会自主规划路径的攻防 Agent，比技能类威力更大、也需要更严格的使用边界。请在自有系统或已获书面授权的前提下使用，并优先在隔离环境中运行。

Strix #

usestrix/strix · Python★ 62.1k

开源 AI 渗透测试工具：自动扫描、发现并尝试修复应用漏洞，面向开发团队做上线前自查。适合有授权、想在 CI 前加一道自动化安全检查的场景。

PentAGI #

vxcontrol/pentagi · Go★ 23.6k

全自主多 Agent 渗透测试系统：多个 Agent 分工完成侦察、利用与报告，可容器化部署。适合专业红队与安全研究团队。

PentestGPT #

GreyDGL/PentestGPT · Python★ 15.4k

首个由 LLM 驱动的自动化渗透测试框架，学术引用量大。适合研究自动化渗透方法论的人。

A11 · 移动端与远程操控#

把手机也变成被 Agent 驱动的设备。MCP 型给编码 Agent 提供手机工具接口，可接进 CI；独立型是手机上的 Agent 应用，自己规划执行。选择标准：做移动端测试自动化选 MCP 型；想让手机自己跑任务选独立型；注意 Android 端多数依赖无障碍服务，权限较高。

opendroid #

yashab-cyber/opendroid · Kotlin★ 1.0k

自主 Android Agent：能自我规划并执行手机任务，支持本地模型或远程 LLM，生产可用。适合做手机端自动化与个人助理场景。

android-agent #

ghost-in-the-droid/android-agent · Python★ 350

通过 ADB 用 AI 驱动真机的开源框架，提供 60+ 工具；iPhone 侧走 WebDriverAgent。适合需要跨 iOS / Android 统一操控的开发与测试团队。

Zafiro #

niki914/zafiro · Kotlin★ 163

开源安卓 BYOK Agent：自带你自己的模型 Key，支持 MCP 与 Skills，通过原生 Shell、Python 3 与无障碍服务实现完整手机控制。适合愿意折腾的 Android 高级用户。

skales #

skalesapp/skales · TypeScript★ 1.9k

全平台个人桌面 + 移动 Agent：设定一个目标，它自己推进；支持团队（帕累托）协作模式。适合想让手机和电脑都被同一个 Agent 调度的人。

A12 · 多智能体框架与自托管平台#

前者解决 「怎么让多个角色协作干活」，后者解决 「怎么把知识库与客服能力搬回自己机器上」。这两件事是「一人公司」与中小企业自建 AI 能力时最常缺的两块拼图。

CrewAI #

crewAIInc/crewAI · Python★ 58.5k

多智能体协作框架：把「选题、撰稿、审校、发布」定义成不同角色的 Agent，自动分工协作跑完一条完整工作流。是「一个人模拟一个团队」最直接的工具，也支持接入 DeepSeek 等国产模型。

FastGPT #

labring/FastGPT · TypeScript★ 29.6k

可自托管的知识库问答与 Agent 平台：导入文档即建知识库，支持多轮对话、意图识别与复杂问题转人工，常用来做电商客服或企业内部问答。Docker 部署，数据不出内网。

选用提醒

同类项目不必都装：一个分类通常只需要 1~2 个，先装一个用一周，发现缺什么再补第二个。星标高不等于适合你——描述里出现「研究、基准、论文、实验」的项目装起来成本高、收益周期长，非开发者可直接跳过。另外，凡是能操作电脑、文件或浏览器的 Agent，请只授权指定工作目录，不要一上来就给整个磁盘权限。

接下来：能力与执行者都备齐了，还差教程和同伴——下一页进入学习资源与社区。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

学习资源与社区：课程、清单、官方文档

Tue, 15 Sep 2026 00:00:00 GMT

学习资源与社区#

课程、官方频道、社区与清单仓库四类入口，全部可公开访问；收录标准与开源库一致——核验通过才收录。

资源库给了「工具」，这一章给「怎么学会」。视频课打底、官方文档兜底、社区答疑、清单仓库定期扫新。

资源库看完了，真正上手还差「教程」和「同伴」。下面按系统课程 → 社区渠道 → 清单仓库三层给出入口，全部为可公开访问的地址。

系统课程（视频）#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

课程 / 频道	讲什么	适合	入口
吴恩达《用 CrewAI 开发 Agent》	多智能体设计、开发与部署全流程，配中英字幕与代码	想系统学 Agent 协作	B 站
CrewAI 一站式速通	从零搭多 Agent 工作流，含股票分析、行程规划等实战示例	想快速跑通第一个案例	B 站
LangChain 入门到精通	RAG、Tool、Agent、Memory 全模块，附完整代码库	开发者打地基	B 站
LangChain 课程配套笔记	体系化课件与笔记，查漏补缺比看视频快	边看边查	在线笔记
AI 跨境自动化实战	选品全流程、多语言主图与详情页自动生成	做跨境电商的运营	B 站
DeepLearning.AI 官方频道	吴恩达团队的 Agent、CrewAI、LangChain 系列短课	看框架底层原理	YouTube
CrewAI / LangChain 官方频道	版本更新、功能演示与最佳实践	跟进新版本	CrewAI ｜ LangChain
Anthropic 官方频道与 Academy	Claude / Agent Skills / MCP 的第一手教程与官方课程	用 Claude 系工具的人	YouTube ｜ Academy
OpenAI 官方频道与 Academy	Codex、GPT 系模型与 Agent SDK 的官方演示课	用 OpenAI 系工具的人	YouTube ｜ Academy
Hugging Face Learn	从 Transformers 到 Agents 的免费短课，配练习	想补底层原理	huggingface.co/learn
B 站官方机构号	在 B 站搜「Agent 实战」「LangChain 教程」，按播放量与更新时间筛	中文入门	搜索直达
Greg Isenberg	一人公司、数字创业与 AI 工具变现的真实案例	找商业模式灵感	YouTube

社区与交流渠道#

框架官方社区：CrewAI Discord——开发者交流、插件分享与问题排查。
桌面 Agent 社区：openclaw/openclaw（★389.6k）与 NousResearch/hermes-agent（★245.2k）的仓库 Issue 与 Discussions，是当前最活跃的自进化 Agent 讨论区。
国内技术社区：思否 SegmentFault（大量 Agent 落地实战与踩坑记录）、火山引擎开发者社区（豆包 API 官方教程与企业级案例）。
发现新项目：GitHub Trending 中文榜，每日更新国内热门开源项目。
平台侧开源：扣子 Coze 开源项目（★5.7k），字节跳动的 Agent 运维平台，配有官方交流群。

值得收藏的清单类仓库#

LangchainV1-in-action（★72）：从 0 到 1 的实战案例集，含智能翻译、文本分类、多功能助手等项目。
awesome-ai-agents（★30.0k）：精选的 Agent 框架、工具、论文与教程大全，适合定期扫一遍找新东西。

官方文档入口（遇到问题先查这里）#

Anthropic Docs：docs.claude.com——Claude API、Agent Skills 规范与 Claude Code 的权威文档。
OpenAI Docs：platform.openai.com/docs——API 参考、Cookbook 与 Agents 指引。
Model Context Protocol：modelcontextprotocol.io——MCP 协议规范，接工具前先读。

关于社区地址的核验说明

来源材料中提到的部分社区站点（如 Hermes Agent 中文站、OpenClaw 中文 Discord 等）本次核验无法确认其可访问性与归属，为避免指向仿冒站点，未予收录；请优先使用上表中项目官方仓库内的链接。

接下来：看完别人的教程，接下来动手做自己的：下一页是创建 Skill / Agent 的分步教学。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

动手教学：创建并使用 Skill 与 Agent

Tue, 15 Sep 2026 00:00:00 GMT

动手教学：创建并使用 Skill 与 Agent#

四节实操：创建自己的 Skill、创建自己的 Agent、两者的使用方法，以及在 OpenClaw、QClaw、WorkBuddy 等客户端中导入。

创建自己的 Skill#

Skill 的本体只是一个文件夹：一份 SKILL.md 说明文件，加上可选的脚本与模板。规范来自 anthropics/skills，所有支持 Agent Skills 规范的客户端都认这个结构。

建文件夹：名字用小写连字符（如 weekly-report），一个技能一个文件夹。
写 SKILL.md：顶部 YAML 写 name 与 description——description 决定客户端「什么时候想起用它」，要写成触发条件（做什么、何时用），而不是功能介绍。
正文写做法：步骤、输入输出、注意事项；可附脚本（如 build.py）并在正文里说明何时执行。
放进技能目录：各客户端的技能目录或「导入本地文件夹 / 仓库地址」入口（见本章第 4 节）。
验证：重开会话后说一句触发语（如「帮我出周报」），确认客户端命中并按步骤执行。

两个常见坑

description 写成广告词导致不触发；一个技能塞多个职责导致匹配混乱——一个技能只解决一类事。

创建自己的 Agent#

Agent = 系统提示 + 工具权限 + 触发场景。两种主流做法：客户端内置的 Subagent 机制（Markdown 定义，零代码），或框架编排（CrewAI / LangChain，Python 代码）。

Subagent 方式：在客户端的 agents 目录建一个 .md，frontmatter 写 name、description（何时委派给它）与允许的工具白名单；正文就是它的系统提示——职责、边界、输出格式。
框架方式：用 CrewAI 定义角色（role / goal / backstory）与工具集，跑通单 Agent 再加协作。
权限最小化：先只给只读工具（读文件、搜索），验证稳定后再放开写入与执行。
验证：给它三类任务——典型、边界（该拒绝的）、超范围（确认它不越权）。

Skill 与 Agent 怎么选

固定流程交给 Skill（你来指挥）；需要自主决策多步推进的，才做成 Agent——能力越大，越要管好权限。

Skill 与 Agent 的使用方法#

装好之后，日常就是三件事：触发、组合、验收。

触发：描述任务而不是报指令名——「把这篇 PDF 的要点整理成中文摘要」会自动命中解析类 Skill；也可以显式点名「用 weekly-report 出周报」。
组合：常见流水线 = 抓取类 Skill → 处理类 Skill → 输出类 Skill；需要自动串起来时交给 Agent 排程（如 cron + 桌面 Agent）。
验收：要求 Agent 给出「做了什么、改了哪些文件、结果在哪」，关键产出人工抽查——自动化跑得越顺，越要保留抽检习惯。
迭代：Skill 不命中就改 description 的触发词；Agent 输出不稳就收紧系统提示与工具白名单。

在主流工具中导入：OpenClaw、QClaw、WorkBuddy#

支持 Agent Skills 规范的客户端，导入方式基本是两条路：本地文件夹或仓库地址。各客户端的入口名称可能不同，以各自官方文档为准。

OpenClaw（openclaw/openclaw）：把技能文件夹放进其 skills 目录，或在配置中登记 Skill 仓库地址；重载后即可被调用。
QClaw：在客户端的技能 / 插件管理中选择「导入本地技能文件夹」，或粘贴仓库地址；导入后用一条触发语验证是否生效。
WorkBuddy（workbuddy.cn）：通过技能中心安装在线技能，或导入本地技能文件夹；企业内可统一维护一份技能仓库再分发给团队。
通用排查：导入后不触发，先查三处——文件夹名与 SKILL.md 的 name 是否一致、description 是否写了触发条件、客户端是否需要重开会话。

建议

先在一台客户端跑通最小技能（如 weekly-report），再把同一文件夹复制到其他客户端——规范一致，基本零改动。

接下来：能力会装、Agent 会建、流程会跑——最后一步：把它们变成收入。进入下一页的一人公司实战。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

一人公司：把能力接进商业链路

Tue, 15 Sep 2026 00:00:00 GMT

一人公司：把能力接进商业链路#

前六个部分讲怎么把工具装好，这一部分开始算钱：选模式、搭流程、估利润、控风险。全部测算为行业参考区间，不构成任何收益承诺。

一人公司：定义与五大盈利模式#

前六个部分解决的是「工具怎么配」，从本部分起解决「配好之后干什么」。一人公司是最适合个人用 AI 放大产能的商业形态，也是把前面所有能力变现的最短路径。

什么才是真正的「一人公司」#

定义

网上说的「一人公司」（One Person Company, OPC），不是法律意义上的一人有限责任公司，而是一种单人数字创业模式：一个人独立跑通「流量获取 → 转化成交 → 产品交付」的完整商业闭环，不雇全职员工、不租实体办公室，靠 AI 与自动化工具放大个人产能，收入全部归自己，边际成本极低。

三条本质#

用互联网放大个人技能或信息差，打破「收入与时间成线性关系」的天花板。
用工具替代重复劳动，人只做决策、创意和优化 —— 这三件事恰恰是 AI 最不擅长的。
法律载体可以后置：起步用个人账号即可，跑通并有稳定收入后再注册个体工商户或个人独资企业。

两个最常见的误区

一、它不是「躺赚」。 自动化只替代重复劳动；选品、选题、方向调整仍然需要人来决策，前期搭建流程非常耗时，只有跑通闭环之后才会逐步省心。二、工具不是核心竞争力。 同一套工具，有人赚大钱有人亏时间，差别在流量、转化与行业的认知。工具只是放大器 —— 没有赚钱逻辑，再强的工具也放大不出收入。

五大盈利模式总览#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

模式	赚钱逻辑	自动化程度	起步门槛	利润特征	适合人群
虚拟产品 / 知识付费	一次制作、无限复制，边际成本趋近于零	极高	中（需专业积累）	高毛利、可规模化	有领域积累、擅长总结
短视频带货 / CPS	挂链接赚佣金，不囤货不售后	高	低	低毛利、靠量级	时间充裕、无专业技能
平台广告分成	内容播放量换平台补贴	高	低	单价低、极稳定	执行力强、能持续产出
无货源 / 跨境电商	跨平台信息差赚差价	中高	中高（要懂规则）	爆发力强、波动大	数据敏感、愿研究规则
垂直企业服务	为企业提供标准化服务	中	高（需行业资源）	高客单、可复购	有行业经验、擅沟通

逐个拆解与细分方向#

每种模式的赚钱逻辑、完整链路、自动化核心与细分方向差别很大，逐个切换查看：

模式 1 · 虚拟产品 / 知识付费#

赚钱逻辑： 一次制作、无限复制，边际成本趋近于零｜ 自动化程度： 极高｜ 起步门槛： 中（需专业积累）｜ 利润特征： 高毛利、可规模化

赚钱逻辑： 一次制作、无限次复制售卖，边际成本趋近于零。完整链路： 选极小垂直赛道 → AI 生成或整理产品 → 短视频 / 小红书引流 → 私域或小程序成交 → 自动发货。自动化核心： 产品可无限复制、自动发卡发货、关键词自动回复、被动成交。适合人群： 在某个领域有专业积累、擅长总结提炼的人。

① 行业资料包类#

考研考证资料、职场模板、行业研究报告、政策汇总、爆款拆解合集。生产门槛最低、标准化程度最高，最适合新手切入。

② 技能教程类#

软件操作教程、副业方法论、考证通关课、职场技能课。客单价更高，需要一定专业积累，复购率强。

③ 工具模板类#

Excel 高级模板、PPT 模板、剪辑预设、Prompt 合集、自动化脚本、设计素材。可持续更新，用户粘性高。

④ 垂直社群类#

打卡社群、资源交流群、行业人脉群、答疑社群。按年或按月收费，有持续现金流，但需要一定运营能力。

模式 2 · 短视频带货 / CPS 佣金#

赚钱逻辑： 挂链接赚佣金，不囤货不售后｜ 自动化程度： 高｜ 起步门槛： 低｜ 利润特征： 低毛利、靠量级

赚钱逻辑： 短视频挂小黄车或团购链接，用户下单后赚取商品佣金，不囤货、不发货、不做售后，平台自动结算。完整链路： 选高佣金标品 → AI 批量生成脚本 → 批量剪辑 → 矩阵账号定时分发 → 平台自动结算。自动化核心： AI 批量生产内容、多账号自动发布、订单自动结算。适合人群： 时间充裕、愿意批量做内容、无特殊专业技能的人。

① 居家好物带货#

日用品、家居收纳、小家电。高复购、高转化，佣金比例 20%~30%，最适合矩阵批量操作。

② 图书文教带货#

书籍、文具、课程。用户决策成本低、转化率高，佣金 15%~25%，内容容易量产。

③ 本地生活团购#

餐饮、休闲、丽人。到店核销、无需物流，佣金 10%~20%，本地流量精准。

④ 影视剪辑带货#

影视解说、综艺切片挂商品链接。流量大、起号快，单条佣金低但靠量级取胜。

模式 3 · 平台广告分成 / 流量补贴#

赚钱逻辑： 内容播放量换平台补贴｜ 自动化程度： 高｜ 起步门槛： 低｜ 利润特征： 单价低、极稳定

赚钱逻辑： 靠内容播放量或阅读量赚平台补贴，无需对接商家、无需售后。完整链路： 锁定垂直领域 → 运营多个账号 → AI 批量生产内容 → 一键分发多平台 → 自动结算收益。自动化核心： 内容批量生成、多账号统一管理、收益自动到账。适合人群： 执行力强、能持续产内容、追求稳定低风险的人。

① 图文号广告分成#

头条号、百家号、企鹅号。单价最低、量产最容易，适合「搬运 + 二次创作」的矩阵打法。

② 短视频中视频计划#

抖音中视频、快手光合计划。万次播放收益约 10~30 元，横屏视频为主，量产难度中等。

③ 长视频创作激励#

B 站创作激励、西瓜视频。万次播放收益约 30~80 元，单价最高，制作成本也更高。

模式 4 · 无货源 / 跨境电商#

赚钱逻辑： 跨平台信息差赚差价｜ 自动化程度： 中高｜ 起步门槛： 中高（要懂规则）｜ 利润特征： 爆发力强、波动大

赚钱逻辑： 利用跨平台信息差赚差价，不囤货、一件代发。完整链路： AI 选品 → AI 生成多语言文案与主图 → 自动上架 → 用户下单后自动同步供货商发货 → AI 客服。自动化核心： AI 翻译与选品、商品自动上架、订单自动同步、智能客服。适合人群： 对数据敏感、愿意花时间研究平台规则的人。

① 国内无货源店群#

抖店、拼多多、淘宝。利用平台信息差一件代发，上手快，但竞争激烈。

② 跨境 TikTok Shop#

东南亚与欧美市场。差价大、增长快，适合轻小件商品。

③ 亚马逊 FBM 无货源#

客单价高、利润空间大，但规则严格、封号风险高，适合有经验者。

模式 5 · 垂直企业服务#

赚钱逻辑： 为企业提供标准化服务｜ 自动化程度： 中｜ 起步门槛： 高（需行业资源）｜ 利润特征： 高客单、可复购

赚钱逻辑： 为中小企业提供标准化服务，靠专业能力变现，交付物可模板化。完整链路： 短视频发布行业干货 → 吸引精准企业客户 → 标准化模板 + AI 交付 → 自动跟进复购。自动化核心： 获客内容标准化、交付模板化、客户跟进自动化。适合人群： 有行业经验、擅长沟通对接的人。

① 短视频 / 账号代运营#

按月收费、标准化交付，客单价约 1000~5000 元 / 月，可同时服务多家。

② AI 智能体搭建#

企业客服机器人、内部知识库、自动化工作流。客单价高，一次开发可持续收费。

③ 财税 / 资质咨询#

④ 数字化工具部署#

OA、CRM、自动化流程搭建。按项目收费，交付物可标准化复制。

怎么选：三个提问

① 你手里已有的资源是什么？ 有专业积累选模式 1 或 5；只有时间选模式 2 或 3；对数据敏感选模式 4。② 你能接受多久没有收入？ 模式 3 起量最慢但最稳，模式 2 与 4 反馈最快但波动大。③ 哪一环能被自动化替代？ 如果一条链路里全是「必须人做的判断」，那它就不适合做一人公司 —— 先改造链路，再动手。

自动化全链路工具栈#

按「内容生产 → 流量分发 → 转化交付 → 数据复盘」四段拆开，每段说明该用什么，以及该把哪一档模型放在这一段。

内容生产#

大模型的分工：本地管量，云端管质#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

任务类型	推荐档位	理由
批量洗稿、分类、打标签、简单抽取	本地 8B 模型	量大、质量要求中等，本地零边际成本
文案初稿、脚本批量生成、多语言翻译	云端低价档（如 DeepSeek V4.1 Flash）	质量足够且单价低，适合每天上千次调用
关键页文案、长文、复杂推理、写代码	云端旗舰档	直接决定转化率或交付质量，这一档不能省
夜间批量任务	任意档位 + 排到空闲时段	DeepSeek 类平台分时段计价，夜间执行成本减半
敏感数据处理	本地模型	数据不出本机，合规压力最小

视频批量生产#

剪映专业版（Mac 版）：批量导入素材、自动字幕、AI 配音、模板批量导出，对 Apple Silicon 有原生优化。
FFmpeg（brew install ffmpeg）：命令行批量转码、拼接、压字幕，是几乎所有自动化剪辑工具的地基。
开源一体化方案：见Skill 技能库 S11 的 Pixelle-Video（主题 → 成片）、MoneyPrinterPlus（批量混剪）、autoclip（长视频切高光）。

设计素材#

Canva 可画：网页端、模板多，适合批量做封面与主图。
图像生成 API：按张计费，适合产品图与插画批量出图。
本地 Stable Diffusion：M 系列芯片可本地运行，无次数限制，适合需要极大量出图的场景。

流量分发#

商业工具：易媒助手、蚁小二一类，一次上传同步到抖音、快手、视频号、小红书等十几个平台，支持定时发布与矩阵账号管理。省事但要付月费。
开源替代：Skill 技能库 S11 的 social-auto-upload（模拟真人浏览器上传）、PostFlow（排期 + 数据回流）、xhs-matrix（小红书矩阵）。
平台自带定时：公众号、小红书等自带定时发布，提前排好内容即可，零成本。

矩阵运营的风控红线

同一设备登录过多账号、同一时间批量发布相似内容、素材完全重复，都是最常见的触发风控原因。做法：账号隔离（独立环境与独立 IP）、发布错峰、内容做二次创作。宁可慢一点，也不要一次封掉整批号。

转化与交付#

自动发卡：虚拟产品上传至发卡类平台，用户付款后自动发放网盘链接或提取码，实现无人值守成交。
AI 客服：企业微信设关键词自动回复可解决大部分常见问题；需要基于知识库的问答时，用Agent 智能体库 A12 的 FastGPT 自建，可对接公众号与企业微信。
课程与社群交付：交付物尽量做成「自动化可发」的形态（网盘、兑换码、自动入群），避免人工逐个私聊。

数据与复盘#

Python + Pandas：抓取各平台数据并汇总成日报，成本最低的方案（配合第四部分「动手配置」2.6 让脚本按时自己跑的 launchd 定时执行）。
飞书多维表格 / Notion：脚本写入后自动生成看板，手机也能随时看。
API 用量对账：见第四部分「动手配置」1.4 用量核对与成本监控 —— 成本失控往往比收入不足更致命。

分层调用策略#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

段落	本地模型负责	云端 API 负责
内容生产	批量初稿、洗稿、分类、打标签	关键文案、长文、脚本终稿
分发	—（不涉及模型）	标题与话题标签的批量生成
交付	常见问题的一级过滤	复杂咨询与售后话术
复盘	原始数据清洗与归类	周报结论与选题建议

分模式盈利测算模型#

以低价云端模型（如 DeepSeek 空闲时段价格）配合 Mac 挂机的产能为基准，给出各模式的投入产出参考。不含硬件折旧与个人时间成本，也不是收益承诺。

成本基准#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

成本项	月投入	说明
AI API 费用	50 ~ 200 元	批量生成内容，约每月 1000 万 ~ 5000 万 Token 量级；排到空闲时段可显著降低
工具会员	100 ~ 300 元	剪辑、分发、发卡等商业工具
其他杂费	50 ~ 100 元	域名、网盘、短信等
月度固定总成本	200 ~ 600 元	不含人力与硬件成本；若全部改用开源方案，可压到 200 元以内

五种模式的测算#

五种模式的成本结构、收入曲线与风险点完全不同。上面是共同的成本基准，下面逐个切换看每一种的测算过程。

模式 A · 虚拟产品 / 知识付费#

一次性生产、可反复售卖的数字商品：资料包、教程、模板、社群。边际成本趋近于零，是自动化程度最高、也最适合先跑通的一条路——下表按细分方向给出定价与三级月利润区间。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

细分方向	典型定价	入门级月利润	稳定级月利润	成熟级月利润
行业资料包	19.9 ~ 49.9 元	400 ~ 1000 元	3000 ~ 6000 元	2 万 ~ 5 万元
技能教程	69 ~ 199 元	600 ~ 1500 元	6000 ~ 12000 元	4 万 ~ 10 万元
工具模板	29.9 ~ 99 元	500 ~ 1200 元	4000 ~ 8000 元	3 万 ~ 8 万元
垂直社群	99 ~ 299 元 / 年	300 ~ 800 元	5000 ~ 10000 元	5 万 ~ 15 万元

为什么这是首选

边际成本几乎为零，销量越高利润率越高；自动化程度最高，跑顺之后每天只需处理少量客服与售后。

模式 B · 短视频带货 / CPS 佣金#

用批量账号矩阵做带货分佣：不囤货、不售后、不碰供应链，收益取决于账号数量 × 选品命中率。启动最快，但平台规则变化会直接影响存活率。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

细分方向	平均佣金率	5 账号矩阵	15 账号矩阵	30 账号矩阵
居家好物	20% ~ 30%	300 ~ 1000 元	2000 ~ 6000 元	1 万 ~ 3 万元
图书文教	15% ~ 25%	200 ~ 800 元	1500 ~ 5000 元	8000 ~ 2.5 万元
本地生活	10% ~ 20%	400 ~ 1200 元	2500 ~ 7000 元	1.2 万 ~ 3.5 万元
影视剪辑	10% ~ 20%	100 ~ 600 元	1000 ~ 4000 元	5000 ~ 2 万元

模式 C · 平台广告分成#

靠内容播放量拿平台分成。单价最低，但完全被动——内容发出去就持续结算，适合当作其他模式的流量副产品，不建议单独作为主力。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

细分方向	万次播放收益	入门级月利润	稳定级月利润	成熟级月利润
图文号分成	3 ~ 8 元	200 ~ 500 元	1000 ~ 3000 元	5000 ~ 1.5 万元
中视频计划	10 ~ 30 元	300 ~ 800 元	2000 ~ 5000 元	1 万 ~ 3 万元
长视频激励	30 ~ 80 元	500 ~ 1500 元	3000 ~ 8000 元	1.5 万 ~ 4 万元

模式 D · 无货源 / 跨境电商#

不自建库存，靠信息差与选品能力赚差价。利润率受平台规则、物流时效与汇率影响，爆发力强但波动最大，必须先小规模验证再放大。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

细分方向	平均利润率	入门级月利润	稳定级月利润	成熟级月利润
国内无货源店群	20% ~ 30%	500 ~ 1500 元	3000 ~ 8000 元	1.5 万 ~ 4 万元
TikTok Shop	30% ~ 50%	1000 ~ 2500 元	6000 ~ 15000 元	3 万 ~ 8 万元
亚马逊 FBM	40% ~ 60%	2000 ~ 4000 元	1 万 ~ 2 万元	5 万 ~ 12 万元

模式 E · 垂直企业服务#

把自动化能力打包成对企业的服务：代运营、内容外包、AI 应用交付。客单价最高、交付最重，需要用前面几部分的工具链把交付成本压下来才成立。

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

细分方向	典型客单价	入门级月利润	稳定级月利润	成熟级月利润
短视频 / 账号代运营	1500 ~ 4000 元 / 月	1000 ~ 2500 元	6000 ~ 12000 元	2 万 ~ 5 万元
AI 智能体搭建	3000 ~ 10000 元 / 单	2000 ~ 5000 元	1 万 ~ 2 万元	4 万 ~ 10 万元
财税 / 资质咨询	2000 ~ 8000 元 / 单	1500 ~ 4000 元	8000 ~ 15000 元	3 万 ~ 8 万元
数字化工具部署	5000 ~ 20000 元 / 单	3000 ~ 6000 元	1.2 万 ~ 2.5 万元	5 万 ~ 15 万元

测算说明（务必读完再看数字）

一、上表是行业普遍水平的参考区间，实际结果取决于赛道选择、执行能力与运营水平，不构成任何收益承诺；二、「入门级 / 稳定级 / 成熟级」不是时间刻度，而是运营水平刻度 —— 有人半年做到稳定级，也有人两年停在入门级；三、建议先以副业形式试水，验证模式跑通、收入连续三个月为正之后，再逐步放大投入；四、真实成本还应加上你投入的时间 —— 如果按市场价给自己的工作时间定价，前三个月的「时薪」大概率低于打工，这属于正常的学习成本。

落地步骤与风险规避#

把前面所有工具串成一条时间线：什么阶段做什么、到哪个阶段才该上自动化。核心原则是先手动跑通，再自动化替代。

四个阶段#

阶段 1 · 准备期（第 1 周）#

选赛道：从自己熟悉的领域切入，越小越垂直越好。
竞品调研：找出 10 个同赛道账号，分析他们的产品、定价与引流方式。
环境搭建：按第四部分「动手配置」第 2 节把 Mac 环境配好；需要本地模型时按第三部分「本地部署」装好 Ollama。
注册账号：主力平台各注册 2~3 个账号，先养号一周。
API 准备：按第四部分「动手配置」注册并取得密钥，先跑通一次调用。

阶段 2 · 最小闭环期（第 2~3 周）#

做出第一个产品：用 AI 辅助整理出第一份虚拟产品，或第一个视频系列。
跑通成交链路：用户怎么看到你、怎么付款、怎么收货，完整走一遍 —— 这一步不能省。
手动发布内容：每天发 2~3 条，测试哪种内容数据更好。
收到第一笔钱：先验证模式成立，再谈放大。

阶段 3 · 自动化放大期（第 4 周起）#

内容生产自动化：脚本批量生成文案，剪辑工具批量出片（2.1 内容生产）。
分发自动化：接入分发工具，定时多平台发布（2.2 流量分发）。
交付自动化：自动发卡 + 关键词回复，实现无人值守成交（2.3 转化与交付）。
数据自动化：每日自动统计数据，用数据反推选题方向（2.4 数据与复盘）。
成本监控：部署用量监控与消费上限（第四部分「动手配置」1.4 用量核对与成本监控）。

阶段 4 · Agent 智能化期（第 8 周起）#

用 CrewAI / Dify / LangChain 搭一条专属业务工作流（Agent 智能体库 Part B）。
把重复决策交给 Agent，人只负责战略与异常处理。
增加账号数量，复制已验证的内容模板。
拓展产品线，提升客单价。
优化流程，把每日必需工作时间压缩到 1 小时以内。

七类风险与对策#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

风险	具体表现	对策
合规风险	内容搬运侵权、虚假宣传、无资质经营，轻则封号重则罚款	虚拟产品注意版权，不搬运他人课程；广告文案不做绝对化承诺
被割韭菜	大量「躺赚教程」本质是卖课卖工具，案例过度包装	先看对方是否公开真实的收益路径；要求先交大额费用的项目直接跳过
平台规则风险	矩阵运营与批量内容容易触发风控	账号隔离、发布错峰、内容二次创作；单账号单设备，避免同 IP 批量操作
API 成本风险	脚本循环调用或异常重试导致账单飙升	设单日消费上限 + 最大重试次数；部署用量监控；跑批排到夜间空闲时段
Agent 失控风险	自动化 Agent 获得过高权限后误操作	只授权指定工作目录；资金、账号密码、批量删除类操作必须人工确认
跨境专属风险	侵权、违规上架、虚假宣传导致封店冻结资金	先从小平台、低客单价品类试水，熟悉规则后再放大
时间与精力透支	同时铺太多模式，每条链路都半途而废	一次只跑一个模式，跑通再复制；每周固定时间复盘而不是随缘更新

心态建议

先从副业起步、不要贸然裸辞；先跑通最小闭环，再谈放大与自动化；先手动跑通全流程，再用工具替代其中的重复劳动。顺序颠倒，是绝大多数「自动化项目」失败的根本原因。

跨境电商自动化选型#

跨境是模式 4 的落地场景，链路最长、环节最多，也最需要用工具把重复劳动压掉。本节只讲「怎么组队」，各项目的详细说明与仓库地址见 Skill 技能库的 S12 分类，此处不重复收录。

按环节选工具#

来源：见本页文末「数据来源」说明 · 核对日 2026-09-14

环节	要解决的事	推荐项目（详见Skill 技能库 S12）
选品	找需求：从榜单与评论里发现机会	EcomAgent（三维评分 + 痛点提取）、Awesome Amazon EC Skills
上架	写文案、做图、多平台刊登	TradeMind（全流程）、eCan.ai（多 Agent 工作流）
流量	达人分销、商品视频、素材量产	TikTok Shop 联盟邀约 Bot、TikTok 商品视频自动化
情报	盯竞品、盯政策、盯趋势	CrossPulse 跨境脉搏（日报推送）、Atlas Mercator
履约与客户	订单协同、询盘报价、智能客服	TradePilot 外贸工作台、FastGPT（知识库客服，见 A12）

两套起步组合#

入门组合（低成本、部署简单）

妙手自动化工作台 + DeepSeek V4.1 Flash + CrossPulse覆盖 TikTok Shop 的选品、上架与市场监控全流程，部署难度低，每月 API 成本可控制在 50 元以内，适合从东南亚市场切入的新手。数据获取用云端 API 即可，不需要本地算力。

进阶组合（全流程、数据自主）

TradeMind + 本地模型（Ollama）+ EcomAgent 选品分析选品与选品分析本地跑（零边际成本），文案与客服用云端低价档；核心数据不出本机、不依赖第三方 SaaS，长期成本极低，适合已跑通单店、要复制放大的店群。

跨境场景的三条硬约束#

多语言不是「翻译一遍」：商品文案要按目标市场的搜索习惯重写，而不是直译。建议先用云端旗舰档跑一批，把优质结果沉淀成提示词模板，再交给低价档批量套用。
合规优先于效率：图片水印、品牌词、认证标识是最常见的侵权来源，自动化上架前一定要过一遍黑名单过滤 —— 宁可少上架，也不要被封店。
资金与账号信息不进自动化链路：支付、提现、店铺主账号密码不交给任何脚本或 Agent；自动化只做「读数据、生成内容、写草稿」三件事。

关于本条链路的链接收录说明

来源材料中列出的跨境类项目，凡本次在公开代码托管平台核验通过的已全部收录进Skill 技能库 S12；未能核验到对应仓库的条目（如 DropForge、Wimoor ERP 及部分自称「AI 跨境平台」的项目）未予收录，以免指向无效或仿冒地址。其中星标极少的项目已在 S12 中单独标注为尝鲜性质，请先小规模验证。

接下来：全书画上句号：回到目录挑一节重读，或直接把第八部分的第一条落地步骤跑起来。

版权与免责声明

本文档仅供个人学习与研究使用，不得用于商业用途，亦不构成任何收益承诺。

Firefly 代码块示例

Sat, 03 Jan 1970 00:00:00 GMT

在这里，我们将探索如何使用 Expressive Code 展示代码块。提供的示例基于官方文档，您可以参考以获取更多详细信息。

表达性代码#

语法高亮#

语法高亮

常规语法高亮#

1
console.log('此代码有语法高亮!')

渲染 ANSI 转义序列#

Terminal window展开收起

1
Standard ANSI colors:
2
- Dimmed:      Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
3
- Foreground:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
4
- Background:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
5
- Reversed:    Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
6

7
8-bit colors (showing colors 160-171 as an example):
8
- Dimmed:      160  161  162  163  164  165  166  167  168  169  170  171 
9
- Foreground:  160  161  162  163  164  165  166  167  168  169  170  171 
10
- Background:  160  161  162  163  164  165  166  167  168  169  170  171 
11
- Reversed:    160  161  162  163  164  165  166  167  168  169  170  171 
12

13
24-bit colors (full RGB):
14
- Dimmed:      ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
15
- Foreground:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
16
- Background:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
17
- Reversed:    ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
18

19
Font styles:
20
- Default
21
- Bold
22
- Dimmed
23
- Italic
24
- Underline
25
- Reversed
26
- Strikethrough

展开收起

编辑器和终端框架#

编辑器和终端框架

代码编辑器框架#

my-test-file.js

1
console.log('标题属性示例')

src/content/index.html

1
<div>文件名注释示例</div>

终端框架#

Terminal window

1
echo "此终端框架没有标题"

PowerShell 终端示例

1
Write-Output "这个有标题!"

覆盖框架类型#

1
echo "看，没有框架!"

PowerShell Profile.ps1

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

标记整行和行范围#

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

选择行标记类型 (mark, ins, del)#

line-markers.js

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

为行标记添加标签#

labeled-line-markers.jsx

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

在单独行上添加长标签#

labeled-line-markers.jsx展开收起

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

展开收起

使用类似 diff 的语法#

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

结合语法高亮和类似 diff 的语法#

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

标记行内的单独文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

Terminal window

1
echo "Test" > /home/test.txt

选择内联标记类型 (mark, ins, del)#

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

为每个块配置自动换行#

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行的缩进#

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 直到块末尾的所有代码将再次被折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

展开收起

行号#

行号

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

Tab 代码块#

由 rehype-code-group 提供，语法与 VitePress 代码组一致：用 ::: code-group labels=[...] 包裹多个代码块，即可合并成一组标签页。

Note

labels=[...] 中的标签按顺序对应组内的代码块，用英文逗号分隔；::: 与 code-group 之间的空格不能省略。

基本用法#

1
::: code-group labels=[code.js, code.py, code.html]
2

3
```js
4
export function greet(name) {
5
  return `Hello, ${name}!`;
6
}
7
```
8

9
```py
10
def greet(name):
11
    return f"Hello, {name}!"
12
```
13

14
```html
15
<p>Hello, world!</p>
16
```
17

18
:::

展开收起

渲染效果：

code.jscode.pycode.html

1
export function greet(name) {
2
  return `Hello, ${name}!`;
3
}

1
def greet(name):
2
    return f"Hello, {name}!"

1
<p>Hello, world!</p>

标签中使用 Emoji#

标签支持 emoji 短代码，构建时会自动转换成 emoji：

1
::: code-group labels=[:package: npm, :package: pnpm, :yarn: yarn]

📦 npm📦 pnpm🧶 yarn

Terminal window

1
npm create astro@latest

Terminal window

1
pnpm create astro@latest

Terminal window

1
yarn create astro

与其他代码块特性组合#

组内仍是普通的 Expressive Code 代码块，标题、行号、行标记、折叠、终端框架等特性都可以照常使用。

配置文件终端折叠

astro.config.mjs

1
export default {
2
  theme: "firefly",
3
  codeGroup: true,
4
};

部署

1
pnpm build && pnpm preview


3 collapsed lines
1
// 这三行默认折叠
2
import { a } from "a";
3
import { b } from "b";
4

5
console.log(a, b);

不止是代码块#

标签页内可以放任意内容，例如文字、列表或图片：

说明列表

这是一段普通的段落内容。

列表项一
列表项二

Tip

标签栏在构建期生成，默认展开第一项；支持鼠标点击与键盘 ← / → / Home / End 切换。

在提醒框内使用（MDX 组件）#

::: code-group 和 ::: tip 等 Docusaurus 风格提醒框都使用 ::: 容器语法，而 micromark-directive 规定父子容器的冒号数必须不同，因此 ::: code-group 无法嵌套在 ::: tip 等提醒框内（整块会失效）。

这种情况改用 MDX 组件 TabGroup：MDX 组件不经过 ::: 指令解析，在提醒框内外都能正常使用，也方便日后扩展更多 UI 组件。把文章后缀改为 .mdx，从统一入口 @/components/firefly-mdx 引入（可一次引入多个组件）：

1
import { TabGroup } from "@/components/firefly-mdx";
2

3
:::tip
4

5
<TabGroup labels={["test.js", "test.py"]} client:load>
6
  ```js
7
  console.log(1)
8
  ```
9

10
  ```py
11
  print("hello world")
12
  ```
13
</TabGroup>
14

15
:::

展开收起

Tip

labels 数组给每个代码块声明标签，顺序一一对应
组件用 client:load 激活标签切换

Firefly 布局系统详解

Sat, 03 Jan 1970 00:00:00 GMT

📖 概述#

Firefly 提供了灵活的布局系统，允许您根据内容需求和个人喜好自定义博客的视觉呈现方式。布局系统主要包括侧边栏布局和文章列表布局两个维度，它们相互配合，共同决定了页面的整体结构。

本文将详细介绍 Firefly 的各种布局模式、它们的特点、使用场景，以及不同布局组合的效果。

左侧边栏+列表布局

右侧边栏+网格布局

左侧边栏+三列网格布局

双侧边栏+列表布局

双侧边栏+网格布局

双侧边栏+网格瀑布流布局

一、侧边栏布局系统#

侧边栏是博客页面的重要组成部分，用于展示导航、分类、标签、统计信息等辅助内容。Firefly 支持两种侧边栏布局模式。

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

左侧边栏布局

右侧边栏 (position: “right”)#

右侧边栏布局

特点#

侧边栏固定在页面其中一侧
文章阅读区域体验更佳，更宽敞
更加简约，没有那么紧凑

适用场景#

传统博客风格
强调导航和分类的博客
需要突出用户资料的个人博客
内容为主，辅助信息次之的场景

Tip

文章详情页显示哪几侧，由**各组件的 showOnPostPage（以及 hideOnNonPostPage）**决定：某一侧在当前页型下没有任何可见组件时，该列会自动收起，把空间让给内容栏。

如果想在文章页同时显示双侧边栏，把 position 设为 "both"，并给两侧组件配好 showOnPostPage 即可。

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
};

1.2 双侧边栏模式 (position: “both”)#

特点#

左右两侧同时存在侧边栏
主内容区域位于中间
最大化利用屏幕空间
可以展示更多辅助信息
适合宽屏显示器

布局结构#

双侧边栏+列表布局

双侧边栏+网格布局

适用场景#

宽屏桌面端浏览
信息密集型博客
需要展示大量辅助内容
专业性强的技术博客

配置示例#

src/config/sidebarConfig.ts

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

二、文章列表布局系统#

文章列表是博客首页和归档页的核心内容，Firefly 提供两种展示方式，并支持多种网格配置。

2.1 列表模式 (defaultMode: “list”)#

特点#

单列纵向排列
显示文章封面图，可配置在左侧或右侧
展示更多文章摘要
适合深度阅读

列表布局结构#

列表模式布局

封面位置#

列表模式的封面图默认在卡片右侧，可以通过 coverPosition 改到左侧。改到左侧后，标题前的主题色竖线会自动隐藏（它是贴着卡片左边缘的设计），腾出的间距留给正文。

网格模式的封面固定在卡片顶部，不受这项配置影响。

优点#

✅ 视觉冲击力强，封面图吸引眼球
✅ 可以展示更多文章信息（摘要、标签等）
✅ 适合图片内容丰富的博客
✅ 移动端友好，单列更易阅读
✅ 兼容所有侧边栏配置（单侧、双侧）

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list",    // 列表模式
4
    coverPosition: "right", // 封面图位置："right" 右侧，"left" 左侧
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

特点#

自适应列数，根据浏览器宽度自动调整
紧凑布局，信息密度高
适合快速浏览

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

网格布局

配置示例#

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    grid: {
5
      masonry: true,      // 开启瀑布流
6
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
7
    },
8
  },
9
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

瀑布流布局

智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

三、布局组合指南#

Firefly 允许您自由组合侧边栏和文章列表布局。以下是各种组合的效果说明。

侧边栏模式	文章列表模式	推荐度	适用场景
单侧边栏	列表模式	⭐⭐⭐⭐⭐	摄影、设计、生活类博客，强调图片和沉浸感
单侧边栏	网格模式	⭐⭐⭐⭐⭐	技术、笔记类博客，平衡阅读与检索效率
双侧边栏	列表模式	⭐⭐⭐⭐⭐	需要展示大量侧边栏信息的站点
双侧边栏	网格模式	⭐⭐⭐⭐⭐	极客风格，追求最高信息密度

四、响应式布局行为#

Firefly 的布局系统具有智能的响应式设计，会根据屏幕尺寸自动调整。

为了保证最佳阅读体验，系统会在屏幕变窄时自动调整布局：

网格列数自动减少：网格模式的列数由 columnWidth 和容器宽度自动决定，屏幕越窄列数越少。
列表模式 -> 网格模式：当屏幕宽度小于 380px（超小屏设备）时，列表模式会自动切换为网格模式，以保证卡片内容的可读性。
双侧边栏 -> 单侧边栏：当屏幕宽度小于 1280px 时，会根据tabletSidebar配置显示单侧边栏，隐藏其中一个侧边栏，文章目录导航会切换成浮动目录导航。

五、常见问题#

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

六、总结#

Firefly 的布局系统给予了您更大的自由度，您都可以通过简单的配置实现。

我们建议您根据自己的内容类型和目标读者的设备偏好，尝试不同的组合，找到最适合您的博客形态。

Firefly Wiki Link 内部链接示例

Sat, 03 Jan 1970 00:00:00 GMT

Firefly 支持在 Markdown、MDX 文章中使用 Obsidian 风格的 Wiki Link 内部链接。链接目标填写文章的 slug 或文件路径，都不需要包含扩展名，具体匹配规则见下文「链接目标的三种写法」。

文章链接卡片#

[[slug]] 单独成段时，会自动读取目标文章的标题、描述、发布时间、分类、标签和封面，渲染为链接卡片：

1
[[firefly]]
2

3
[[guide/index]]
4

5
[[markdown-extended]]

Firefly 一款清新美观的 Astro 博客主题模板

Firefly 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题模板，专为技术爱好者和内容创作者设计。该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

1970-01-02文章示例#Markdown#Firefly#博客#主题#模板

Firefly 简单使用指南

如何使用 Firefly 博客模板。

1970-01-02博客指南#Firefly#博客#Markdown#指南

Markdown 扩展功能

了解 Firefly 中的 Markdown 功能

1970-01-01文章示例#演示#示例#Markdown#Firefly

行内链接#

[[slug]] 出现在正文中间时，渲染为普通链接，链接文字自动使用目标文章的标题

1
请参阅 [[firefly]] 了解主题特性。

请参阅 Firefly 一款清新美观的 Astro 博客主题模板了解主题特性。

自定义显示标题#

在 | 后填写链接的显示文字。行内链接会用它替换文章标题；单独成段时依然渲染为卡片，卡片标题使用自定义文字，描述、时间、分类、标签和封面仍然读取目标文章：

1
请参阅 [[firefly|主题介绍]] 了解主题特性。
2

3
[[firefly|Firefly 主题介绍]]

请参阅主题介绍了解主题特性。

Firefly 主题介绍

1970-01-02文章示例#Markdown#Firefly#博客#主题#模板

一个例外：如果 | 后的文字只是把链接目标又抄了一遍（[[guide/index|index]]），会被当作无效别名忽略，仍然显示文章标题。Obsidian 在插入的链接时会自动补上这样的别名，避免笔记里显示一长串路径，这个例外就是为它准备的。

链接目标的三种写法#

用 Obsidian 管理文章时，把 src/content/posts 目录本身作为 Obsidian 仓库（vault）打开。下文提到的「仓库根目录」都指这个目录，它正好也是 Firefly 解析链接路径的起点。

链接目标按以下顺序匹配：

写法	示例	在 Obsidian 中
frontmatter 的 `slug`	`[[firefly-wiki-link]]`	✗ 不支持
文件路径（相对仓库根目录）	`[[guide/firefly-layout-system]]`	✓ 需改设置（推荐）
裸文件名（仓库内唯一时）	`[[firefly-layout-system]]`	✓ 默认即是

第一种：slug#

slug 写法在 Obsidian 中不支持，slug 是 Firefly 自己的概念，Obsidian 不读取 frontmatter 里的 slug，所以按 slug 写的链接在 Obsidian 里既不会自动补全，也点不动，只有构建出的站点上能正常跳转。如果你主要在 Obsidian 里写作，用下面两种写法。

第二种：文件路径（推荐）#

文件路径写法需要改 Obsidian 设置，在 设置 → 文件与链接 → 链接 → 内部链接类型 中选择基于仓库根目录的绝对路径，Obsidian 插入的链接才会带上目录：

1
[[guide/firefly-layout-system|firefly-layout-system]]

Firefly 布局系统详解

深入了解 Firefly 的布局系统，包括侧边栏布局（左侧/双侧）和文章列表布局（列表/网格），以及自适应网格列数。

1970-01-03博客指南#Firefly#布局#博客#指南

因为仓库根目录就是 src/content/posts，Obsidian 写出的这个路径和 Firefly 需要的路径完全一致，不需要任何额外转换。

上面这行末尾的 |firefly-layout-system 是 Obsidian 自动补的别名，Firefly 会忽略它，卡片标题仍然取文章的 title，除非你把它修改和文件名不一致，才会变成你修改后的别名。

内部链接类型下拉框里的基于当前笔记的相对路径只在同目录内可用：它给同目录文章生成的是裸文件名，能正常匹配；但跨目录时会生成 ../ 前缀，Firefly 无法解析，链接会按原文显示。

第三种：裸文件名#

「内部链接类型」的默认值就是尽可能简短的形式：只要文件名在整个仓库里唯一，Obsidian 插入的链接就只有文件名，不带目录。这种写法不需要改任何设置，效果和写完整路径完全一致：

1
[[firefly-layout-system]]

Firefly 布局系统详解

深入了解 Firefly 的布局系统，包括侧边栏布局（左侧/双侧）和文章列表布局（列表/网格），以及自适应网格列数。

1970-01-03博客指南#Firefly#布局#博客#指南

文件名重名时这种写法会失效，构建日志里会给出提示，改用完整文件路径即可，所以推荐直接修改 Obsidian 内部链接类型设置为基于仓库根目录的绝对路径，使用第二种文件路径写法，一劳永逸

链接到其他文章的标题#

在文章 slug 后添加 #标题。带标题锚点的链接始终渲染为普通链接：

查看代码块语法高亮

Firefly 布局系统详解#相关链接

1
[[code-examples#语法高亮|查看代码块语法高亮]]
2

3
[[guide/firefly-layout-system#相关链接|firefly-layout-system]]

标题锚点使用与页面标题相同的 slug 规则，因此中文、空格和大小写都会按页面实际生成的 ID 处理。

链接到本页标题#

省略文章 slug，只填写标题即可链接到当前文章：

跳转到本页目标

1
[[#本页目标|跳转到本页目标]]

本页目标#

这是本页 Wiki Link 指向的标题。

不支持附件嵌入#

附件嵌入语法目前不会被转换，会按原文显示：

![[image.png]]

行内代码和代码块中的 [[firefly]] 也不会被转换。

Firefly 文章加密

Fri, 02 Jan 1970 00:00:00 GMT

这是一篇密码保护的示例文章，用于演示文章加密功能。

KaTeX 数学公式示例

Fri, 02 Jan 1970 00:00:00 GMT

本文展示了 Firefly 主题对 KaTeX 数学公式的渲染支持。

行内公式 (Inline)#

行内公式使用单个 $ 符号包裹。

例如：欧拉公式 eiπ+1=0e^{i\pi} + 1 = 0eiπ+1=0 是数学中最优美的公式之一。

质能方程 E=mc2E = mc^2E=mc2 也是家喻户晓。

块级公式 (Block)#

块级公式使用两个 $$ 符号包裹，会居中显示。

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=πx=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}x=2a−b±b2−4ac

复杂示例#

矩阵 (Matrices)#

(abcd)(αβγδ)=(aα+bγaβ+bδcα+dγcβ+dδ)\begin{pmatrix} a & b \\ c & d \end{pmatrix} \begin{pmatrix} \alpha & \beta \\ \gamma & \delta \end{pmatrix} = \begin{pmatrix} a\alpha + b\gamma & a\beta + b\delta \\ c\alpha + d\gamma & c\beta + d\delta \end{pmatrix}(acbd)(αγβδ)=(aα+bγcα+dγaβ+bδcβ+dδ)

极限与求和 (Limits and Sums)#

∑n=1∞1n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}n=1∑∞n21=6π2lim⁡x→0sin⁡xx=1\lim_{x \to 0} \frac{\sin x}{x} = 1x→0limxsinx=1

麦克斯韦方程组 (Maxwell’s Equations)#

∇⋅E=ρε0∇⋅B=0∇×E=−∂B∂t∇×B=μ0J+μ0ε0∂E∂t\begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \\ \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\ \nabla \times \mathbf{B} &= \mu_0\mathbf{J} + \mu_0\varepsilon_0\frac{\partial \mathbf{E}}{\partial t} \end{aligned}∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E

化学方程式 (Chemical Equations)#

\ceCH4+2O2−>CO2+2H2O\ce{CH4 + 2O2 -> CO2 + 2H2O}\ceCH4+2O2−>CO2+2H2O

MDX 格式文章示例

Fri, 02 Jan 1970 00:00:00 GMT

Tip

Firefly 支持 MDX 和 Markdown 两种类型的文章，你可以在文章中混合使用两种格式，如果没有特别复杂内容和需求，推荐使用 Markdown 格式就够了。

Markdown 和 MDX 的区别#

Markdown (MD) 是一种轻量级标记语言，允许用户使用纯文本格式编写文档，然后将其转换为格式化的HTML。它因其简洁易用的语法而广受欢迎，特别适合编写文档和博客文章。
MDX 是一种扩展了 Markdown 语法的格式，允许在 Markdown 文档中无缝地插入 JSX 代码。通过 MDX，用户可以在文档中嵌入 React 组件，从而实现更丰富的交互性和动态性。

特性	Markdown	MDX
基础语法	支持 (CommonMark)	支持 (CommonMark)
HTML 标签	支持	支持 (作为 JSX)
组件导入	不支持	支持 (import)
动态数据	不支持	支持 (JS 表达式)
样式定制	有限 (class/style)	灵活 (className/CSS-in-JS)

Firefly 内置的专属 MDX UI 组件#

这里列出 Firefly 内置的 MDX UI 组件，方便在 MDX 文章中直接使用。

Tab分组：`TabGroup`#

用于创建可切换的标签页，方便在文章中展示不同语言或不同版本的代码等等。

1
<TabGroup labels={["test.js", "test.py"]} client:load>
2
  ```js
3
  console.log(1)
4
  ```
5

6
  ```py
7
  print("hello world")
8
  ```
9
</TabGroup>

test.jstest.py

1
console.log(1)

1
print("hello world")

时间线：`Timeline` / `TimelineItem`#

属性	必填	说明
`date`	否	时间标签，如 “2024-03-10”
`title`	否	条目标题
`type`	否	节点颜色，default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）
`icon`	否	内置图标名，显示在圆点内：star / rocket / git / flag / book / heart / zap / bug / tag / calendar / code / edit
正文	否	`<TimelineItem>` 标签内的内容，支持 Markdown

1
<Timeline>
2
  <TimelineItem date="2026-08-16" title="新版本发布" icon="rocket">
3
    发布了全新版本，带来以下更新：
4

5
    - 新增时间线组件
6
    - 改进暗色主题
7

8
    正文里支持 **Markdown** 内容。
9
  </TimelineItem>
10
  <TimelineItem date="2025-11-02" title="站点上线" type="tip" icon="flag">
11
    欢迎来到我的博客。
12
  </TimelineItem>
13
  <TimelineItem date="2025-06-15" title="项目立项" type="note">
14
    开始规划 Firefly 主题。
15
  </TimelineItem>
16
</Timeline>

展开收起

2026-08-16
新版本发布
发布了全新版本，带来以下更新：
- 新增时间线组件
- 改进暗色主题
正文里支持 Markdown 内容。
2025-11-02
站点上线
欢迎来到我的博客。
2025-06-15
项目立项
开始规划 Firefly 主题。

步骤条：`Steps` / `StepItem`#

编号步骤条，适合教程、部署流程。编号自动生成，无需手动传序号。

属性	必填	说明
`title`	否	步骤标题
`type`	否	编号圆颜色，default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）
`icon`	否	内置图标名，有图标时显示图标而非数字（star / rocket / git / flag / book / heart / zap / bug / tag / calendar / code / edit）
正文	否	`<StepItem>` 标签内的内容，支持 Markdown

1
<Steps>
2
  <StepItem title="安装依赖">
3
    运行 `pnpm install`。
4
  </StepItem>
5
  <StepItem title="启动开发服务器" type="tip" icon="rocket">
6
    运行 `pnpm dev`，打开 `localhost:4321`。
7
  </StepItem>
8
  <StepItem title="编写文章">
9
    在 `src/content/posts/` 新建 `.mdx` 文章。
10
  </StepItem>
11
</Steps>

安装依赖
运行 pnpm install。
启动开发服务器
运行 pnpm dev，打开 localhost:4321。
编写文章
在 src/content/posts/ 新建 .mdx 文章。

徽章：`Badge`#

内联彩色小徽章，可嵌在段落或标题里。

属性	必填	说明
`type`	否	default 为主题色，其余对应提示框色板（tip / note / important / warning / caution）

1
<Badge type="tip">提示</Badge> <Badge type="warning">注意</Badge>

新功能提示笔记重要注意危险

更多信息，请查看 MDX 文档

Markdown 扩展功能

Thu, 01 Jan 1970 00:00:00 GMT

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，在页面加载时，仓库信息会从 GitHub API 获取。

CuteLeaf

Firefly

🍀Firefly, fresh and aesthetic Astro blog theme template.

—

MIT

Astro

使用代码 ::github{repo="CuteLeaf/Firefly"} 创建 GitHub 仓库卡片。

1
::github{repo="CuteLeaf/Firefly"}

提醒框(Admonitions)配置#

Firefly 采用了 rehype-callouts 插件，支持了四种风格的提醒框主题：GitHub、Obsidian、VitePress 和 Docusaurus。您可以在 src/config/siteConfig.ts 中进行配置：

src/config/siteConfig.ts

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // 选项: "github" | "obsidian" | "vitepress" | "docusaurus"
5
    theme: "github",
6
  },
7
  // ...
8
};

注意：更改配置后需要重启开发服务器才能生效。

以下是各个主题支持的类型列表，每个主题风格和语法不同，可根据喜好选择。

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

GitHub

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

展开收起

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

点击展开 Obsidian 语法列表

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。

展开收起

Obsidian

3. VitePress 主题风格#

VitePress 风格提供了一套现代化的、扁平的默认样式。目前仅包含与 GitHub 一致的 5 种 基础类型。

点击展开 VitePress 语法列表

1
> [!NOTE] NOTE
2
> 对应 GitHub 的 Note。
3

4
> [!TIP] TIP
5
> 对应 GitHub 的 Tip。
6

7
> [!IMPORTANT] IMPORTANT
8
> 对应 GitHub 的 Important。
9

10
> [!WARNING] WARNING
11
> 对应 GitHub 的 Warning。
12

13
> [!CAUTION] CAUTION
14
> 对应 GitHub 的 Caution。
15

16
> [!TIP] 自定义标题
17
> VitePress 风格同样支持自定义标题。

展开收起

VitePress

4. Docusaurus 主题风格#

Docusaurus 风格提供了一套现代化的提醒框样式，支持 5 种类型。

点击展开 Docusaurus 语法列表

支持以下类型的提醒框：note tip info warning danger

1
:::note
2
突出显示用户应该考虑的信息，即使在快速浏览时也是如此。
3
:::
4

5
:::tip
6
可选信息，帮助用户更成功。
7
:::
8

9
:::info
10
一般信息。
11
:::
12

13
:::warning
14
由于潜在风险需要用户立即注意的关键内容。
15
:::
16

17
:::danger
18
行动的负面潜在后果。
19
:::
20

21
:::tip[自定义标题]
22
可选信息，帮助用户更成功。
23
:::

展开收起

Docusaurus

剧透#

您可以为文本添加剧透。文本也支持 Markdown 语法。

内容被隐藏了哈哈！

1
内容 :spoiler[被隐藏了 **哈哈**]！

图片画廊网格 (Image Grid)#

您可以使用 [grid] 和 [/grid] 标签将多张图片纵向并排展示。这对于展示照片画廊或对比图非常有用。系统会自动根据包裹在其中的图片数量（最多支持并排展示4张）以响应式网格进行布局。

自动补齐图片高度： 同一排中如果有高度、大小或者比例不一的图片，会像「九宫格画廊相册」一样自动撑满。较短或不协调的图片会自动使用 object-cover 进行完美中心裁剪补充视野。图片边框水平彻底对齐无缝隙，但被裁剪后，只有点击图片通过灯箱才能查看完整图片，所以建议尽量避免使用长宽比例不一致的图片在同一排中。

图注恒定底端对齐： 不论上面的图片长宽如何变化，在同一行的所有图像解释文字（图注）都会对标到一条完美的水平基线上了。

示例图片一

示例图片二

基本语法

1
[grid]
2
![示例图片一](./images/firefly1.avif)
3
![示例图片二](./images/firefly2.avif)
4
![示例图片二](./images/firefly3.avif)
5
[/grid]

Markdown Mermaid 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 Mermaid 图表完整指南#

本文演示如何在 Markdown 文档中使用 Mermaid 创建各种复杂图表，包括流程图、时序图、ER 图、类图、状态图、XY 图、甘特图、思维导图等。

Mermaid 图表由 Merman 实现。Firefly 在 Astro 构建阶段生成亮色和深色两套静态 SVG，无需在浏览器中加载 Mermaid 渲染运行时。可以前往 Merman Playground 实时编辑语法并预览渲染结果。

流程图示例#

流程图非常适合表示流程或算法步骤。

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

是

否

选项 1

选项 2

选项 3

子过程详情

子步骤 1

子步骤 2

子步骤 3

开始

条件检查

处理步骤 1

处理步骤 2

另一个决策

结果 1

结果 2

结果 3

结束

时序图示例#

时序图显示对象之间随时间的交互。

数据库服务器网页应用用户数据库服务器网页应用用户alt[认证成功][认证失败]提交登录请求发送认证请求查询用户凭据返回用户数据返回认证结果显示欢迎页面请求用户数据获取用户偏好返回偏好设置返回用户数据加载个性化界面显示错误消息提示重新输入

ER 图示例#

ER 图（实体关系图）非常适合表示数据库结构。

writes

posts

has

belongs to

USER

int

string

username

string

datetime

created_at

ARTICLE

int

string

title

text

content

datetime

published

int

author_id

COMMENT

int

text

content

datetime

created_at

int

user_id

int

article_id

类图示例#

类图显示系统的静态结构，包括类、属性、方法及其关系。

写作

发表

拥有

属于

User

+String username

+String password

+String email

+Boolean active

+login()

+logout()

+updateProfile()

Article

+String title

+String content

+Date publishDate

+Boolean published

+publish()

+edit()

+delete()

Comment

+String content

+Date commentDate

+addComment()

+deleteComment()

状态图示例#

状态图显示对象在其生命周期中经历的状态序列。

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

提交

拒绝

批准

发布

归档

撤回

草稿

审核中

已批准

已归档

已发布

临时隐藏

恢复

活跃

隐藏

XY 图示例#

XY 图表非常适合展示趋势和对比数据。

月度访问量趋势1月2月3月4月5月6月5000450040003500300025002000150010005000访问量

饼图示例#

饼图适合直观展示各部分在整体中的占比。

45%30%15%10%内容类型占比技术文章 [45]项目记录 [30]生活随笔 [15]其他 [10]

甘特图示例#

甘特图可以按时间轴展示项目阶段、任务依赖和当前进度。

07/0107/0307/0507/0707/0907/1107/1307/1507/17需求整理视觉设计功能实现内容迁移构建检查正式上线准备开发发布博客版本发布计划

思维导图示例#

思维导图适合梳理主题层级和知识结构。

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

Firefly

内容

技术文章

生活记录

体验

搜索

深色模式

图表

工程

Astro

Svelte

Merman

时间线示例#

时间线用于按年份或阶段呈现项目的重要事件。

2024建立博客完成基础主题2025加入搜索与图库完善内容系统2026升级 Astro 7使用 Merman 渲染图表Firefly 演进时间线

用户旅程图示例#

用户旅程图能够描述用户在不同阶段的行为和体验评分。

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

读者

发现内容

发现内容读者

打开首页

打开首页读者

搜索主题

阅读文章

阅读文章读者

浏览正文

浏览正文读者

查看图表

继续探索

继续探索读者

查看相关文章

查看相关文章读者

分享文章

分享文章读者浏览文章的旅程

Git 图示例#

Git 图可以清晰展示分支、提交和合并历史。

mainfeatureinitadd-diagramspolish-themesmerge-featurerelease

看板示例#

看板适合展示任务在不同工作阶段之间的分布。

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

待办

进行中

已完成

整理需求

准备示例

接入 Merman

服务端渲染

亮暗主题

Sankey 图示例#

Sankey 图通过连线宽度展示流量在不同节点之间的流向。

Home 1650Post list 1200Search 450Post detail 1220Related posts 260External shares 180

总结#

Mermaid 是在 Markdown 文档中创建各种类型图表的强大工具。本文演示了流程图、时序图、ER 图、类图、状态图、XY 图、饼图、甘特图、思维导图、时间线、用户旅程图、Git 图、看板和 Sankey 图。这些图表可以帮助您更清晰地表达复杂的概念、流程和数据结构。

要使用 Mermaid，只需在代码块中指定 mermaid 语言，并使用简洁的文本语法描述图表。图表会在构建时自动渲染为 SVG，无需客户端 JavaScript 加载。

可以前往 Merman Playground 尝试更多语法，再将图表代码粘贴到文章中。

Markdown PlantUML 图表

Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 PlantUML 图表指南#

PlantUML 是一种使用纯文本描述图表的工具。你只需要写一段结构化语法，就可以生成时序图、类图、用例图、活动图等常见工程图。

它特别适合写在技术博客和项目文档里：

图表和正文一起版本管理，便于协作与审阅
修改图只需要改文本，适合频繁迭代
能和 Markdown 无缝结合，保持文档统一

在 Firefly 中，plantuml 代码块会在构建阶段编码并生成服务器 SVG 地址，页面端再根据亮暗主题自动切换图源，并支持缩放、拖拽和全屏交互。

如果你想快速上手，可以记住这个最小模板：

活动图示例#

状态图示例#

用例图示例#

组件图示例#

部署图示例#

ER 图示例#

时序图示例（登录与刷新令牌）#

C4 风格容器图示例#

Markdown 教程

Thu, 01 Jan 1970 00:00:00 GMT

这是一个展示如何编写 Markdown 文件的示例。本文档汇总了核心语法与常见扩展（GFM）。

块级元素
- 段落与换行
- 标题
- 引用
- 列表
- 代码块
- 分割线
- 表格
内联元素
- 链接
- 强调
- 行内代码
- 图片
- 删除线
杂项
- 自动链接
- 反斜杠转义
内联 HTML

块级元素#

段落与换行#

段落#

HTML 标签：<p>

使用一个或多个空行分隔段落。（仅包含空格或制表符的行也视为空行。）

代码：

1
This will be
2
inline.
3

4
This is second paragraph.

预览：

This will be inline.

This is second paragraph.

换行#

HTML 标签：<br />

在行末添加两个或更多空格来产生换行。

代码：

1
This will be not
2
inline.

预览：

This will be not
inline.

标题#

Markdown 支持两种标题样式：Setext 与 atx。

Setext#

HTML 标签：<h1>，<h2>

使用等号 (=) 表示 <h1>、使用短横线 (-) 表示 <h2>，数量不限，作为“下划线”。

代码：

1
This is an H1
2
=============
3
This is an H2
4
-------------

预览：

This is an H1#

This is an H2#

atx#

HTML 标签：<h1>，<h2>，<h3>，<h4>，<h5>，<h6>

在行首使用 1-6 个井号 (#)，对应 <h1> 至 <h6>。

代码：

1
# This is an H1
2
## This is an H2
3
###### This is an H6

预览：

This is an H1#

This is an H2#

This is an H6#

可选：你可以在行尾“闭合” atx 标题。末尾的井号数量不必与开头一致。

代码：

1
# This is an H1 #
2
## This is an H2 ##
3
### This is an H3 ######

预览：

This is an H1#

This is an H2#

This is an H3#

引用#

HTML 标签：<blockquote>

Markdown 使用邮件风格的 > 作为引用符号。若手动换行并在每行前加 >，显示效果最佳。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4
>
5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
> id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

Markdown 允许“偷懒”：在一个硬换行段落中，只在第一行前加 > 即可。

代码：

1
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
2
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
3
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
6
id sem consectetuer libero luctus adipiscing.

预览：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

引用可以嵌套（引用中的引用），通过增加 > 层级实现。

代码：

1
> This is the first level of quoting.
2
>
3
> > This is nested blockquote.
4
>
5
> Back to the first level.

预览：

This is the first level of quoting.
This is nested blockquote.
Back to the first level.

引用内可包含其他 Markdown 元素，包括标题、列表与代码块。

代码：

1
> ## This is a header.
2
>
3
> 1.   This is the first list item.
4
> 2.   This is the second list item.
5
>
6
> Here's some example code:
7
>
8
>     return shell_exec("echo $input | $markdown_script");

预览：

This is a header.#

This is the first list item.

This is the second list item.

Here’s some example code:
1
return shell_exec("echo $input | $markdown_script");

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

代码：

1
*   Red
2
*   Green
3
*   Blue

预览：

Red
Green
Blue

等价于：

代码：

1
+   Red
2
+   Green
3
+   Blue

或者：

代码：

1
-   Red
2
-   Green
3
-   Blue

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

代码：

1
1.  Bird
2
2.  McHale
3
3.  Parish

预览：

Bird
McHale
Parish

注意：像下面这样可能会“意外触发”有序列表：

代码：

1
1986. What a great season.

预览：

What a great season.

你可以用反斜杠转义 (\) 句点：

代码：

1
1986\. What a great season.

预览：

1986. What a great season.

列表中的缩进内容#

列表项里的引用#

在列表项内放置引用，需要将 > 符号整体缩进：

代码：

1
*   A list item with a blockquote:
2

3
    > This is a blockquote
4
    > inside a list item.

预览：

A list item with a blockquote:

This is a blockquote inside a list item.

列表项里的代码块#

在列表项内放置代码块，需要缩进两层——8 个空格或两个 Tab：

代码：

1
*   A list item with a code block:
2

3
        <code goes here>

预览：

A list item with a code block:
```
1
<code goes here>
```

嵌套列表#

代码：

1
* A
2
  * A1
3
  * A2
4
* B
5
* C

预览：

A
- A1
- A2
B
C

代码块#

HTML 标签：<pre>

将代码块中的每行缩进至少4 个空格或1 个制表符。

代码：

1
This is a normal paragraph:
2

3
    This is a code block.

预览：

This is a normal paragraph:

1
This is a code block.

代码块会一直持续，直到遇到未缩进的行（或文末）。

在代码块内，与号 (&) 和尖括号 (< >) 会自动转为 HTML 实体。

代码：

1
    <div class="footer">
2
        &copy; 2004 Foo Corporation
3
    </div>

预览：

1
<div class="footer">
2
    &copy; 2004 Foo Corporation
3
</div>

下文的“围栏代码块”和“语法高亮”属于扩展语法，你也可以用它们来书写代码块。

围栏代码块#

使用成对的反引号围起来（如下所示），就不需要四空格缩进了。

代码：

1
Here's an example:
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```

预览：

Here’s an example:

1
function test() {
2
  console.log("notice the blank line before this function?");
3
}

语法高亮#

在围栏代码块后添加可选的语言标识，即可启用语法高亮（参见支持语言列表）。

代码：

1
```ruby
2
require 'redcarpet'
3
markdown = Redcarpet.new("Hello World!")
4
puts markdown.to_html
5
```

预览：

1
require 'redcarpet'
2
markdown = Redcarpet.new("Hello World!")
3
puts markdown.to_html

分割线（水平线）#

HTML 标签：<hr /> 一行中放置三个或以上的短横线 (-)、星号 (*) 或下划线 (_)。符号之间允许有空格。

代码：

1
* * *
2
***
3
*****
4
- - -
5
---------------------------------------
6
___

预览：

表格#

HTML 标签：<table>

这是扩展语法。

用竖线 (|) 分隔列，用短横线 (-) 分隔表头，使用冒号 (:) 指定对齐方式。

两侧的竖线 (|) 与对齐可选。用于表头分隔时，每列至少需要 3 个短横线。

代码：

1
| Left | Center | Right |
2
|:-----|:------:|------:|
3
|aaa   |bbb     |ccc    |
4
|ddd   |eee     |fff    |
5

6
 A | B
7
---|---
8
123|456
9

10

11
A |B
12
--|--
13
12|45

预览：

Left	Center	Right
aaa	bbb	ccc
ddd	eee	fff

A	B
123	456

A	B
12	45

内联元素#

链接#

HTML 标签：<a>

Markdown 支持两种链接样式：行内链接与引用式链接。

行内链接#

行内链接格式：[文本](URL "标题")

标题可选。

代码：

1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

预览：

This is an example inline link.

This link has no title attribute.

如果引用同一站点的本地资源，可以使用相对路径：

代码：

1
See my [About](/about/) page for details.

预览：

See my About page for details.

引用式链接#

可以预定义链接引用。定义格式：[id]: URL "标题"

标题同样可选。引用时使用：[文本][id]

代码：

1
[id]: http://example.com/  "Optional Title Here"
2
This is [an example][id] reference-style link.

预览：

This is an example reference-style link.

说明：

方括号中包含链接标识（不区分大小写，可在左侧缩进最多三格空格）；
随后是冒号；
再跟一个或多个空格（或 tab）；
然后是链接 URL；
URL 可选地用尖括号包裹；
可选地跟随标题属性，用引号或圆括号包裹。

以下三种定义等价：

代码：

1
[foo]: http://example.com/  "Optional Title Here"
2
[foo]: http://example.com/  'Optional Title Here'
3
[foo]: http://example.com/  (Optional Title Here)
4
[foo]: <http://example.com/>  "Optional Title Here"

如果使用空的方括号，则链接文本本身会作为名称。

代码：

1
[Google]: http://google.com/
2
[Google][]

预览：

Google

强调#

HTML 标签：<em>，<strong>

Markdown 使用 星号 (*) 或 下划线 (_) 表示强调。一个分隔符对应 <em>；两个分隔符对应 <strong>。

代码：

1
*single asterisks*
2

3
_single underscores_
4

5
**double asterisks**
6

7
__double underscores__

预览：

single asterisks

single underscores

double asterisks

double underscores

但如果两侧有空格，则会被视作普通字符而非强调语法。

你可以使用反斜杠进行转义：

代码：

1
\*this text is surrounded by literal asterisks\*

预览：

*this text is surrounded by literal asterisks*

行内代码#

HTML 标签：<code>

用反引号 (`) 包裹。

代码：

1
Use the `printf()` function.

预览：

Use the printf() function.

若行内代码中需要包含反引号字符，可使用多重反引号作为定界符：

代码：

1
``There is a literal backtick (`) here.``

预览：

There is a literal backtick (`) here.

行内代码两侧的定界符允许包含空格（开头一个、结尾一个），方便在代码起始或结尾放置反引号字符：

代码：

1
A single backtick in a code span: `` ` ``
2

3
A backtick-delimited string in a code span: `` `foo` ``

预览：

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

图片#

HTML 标签：<img />

Markdown 的图片语法与链接类似，支持行内与引用两种方式。

行内图片#

行内图片语法：![替代文本](URL "标题")

标题可选。

代码：

1
![Alt text](/path/to/img.jpg)
2

3
![Alt text](/path/to/img.jpg "Optional title")

预览：

Alt text

说明：

一个感叹号 !；
后接方括号，放置图片的替代文本；
再接圆括号，内含图片 URL/路径，及可选的标题（引号包裹）。

引用式图片#

引用式图片语法：![替代文本][id]

代码：

1
[img id]: https://s2.loli.net/2024/08/20/5fszgXeOxmL3Wdv.webp  "Optional title attribute"
2
![Alt text][img id]

预览：

Alt text

删除线#

HTML 标签：<del>

这是扩展语法。

GFM 增加了删除线语法。

代码：

1
~~Mistaken text.~~

预览：

Mistaken text.

杂项#

自动链接#

Markdown 支持一种便捷写法来创建“自动链接”（URL 与邮箱地址）：只需用尖括号将其包住即可。

代码：

1
<http://example.com/>
2

3
<address@example.com>

预览：

http://example.com/

address@example.com

GFM 会自动识别标准 URL 并转换为链接。

代码：

1
https://github.com/emn178/markdown

预览：

https://github.com/emn178/markdown

反斜杠转义#

Markdown 允许使用反斜杠来转义那些本用于 Markdown 语法的特殊字符，使其按字面显示。

代码：

1
\*literal asterisks\*

预览：

*literal asterisks*

以下字符可通过反斜杠转义以按字面量输出：

Code:

1
\   backslash
2
`   backtick
3
*   asterisk
4
_   underscore
5
{}  curly braces
6
[]  square brackets
7
()  parentheses
8
#   hash mark
9
+   plus sign
10
-   minus sign (hyphen)
11
.   dot
12
!   exclamation mark

内联 HTML#

对于 Markdown 语法未覆盖的标记，直接使用原生 HTML 即可。无需特别声明从 Markdown 切换到 HTML，直接写标签就行。

代码：

1
This is a regular paragraph.
2

3
<table>
4
    <tr>
5
        <td>Foo</td>
6
    </tr>
7
</table>
8

9
This is another regular paragraph.

预览：

This is a regular paragraph.

Foo

This is another regular paragraph.

请注意：在块级 HTML 标签内不会处理 Markdown 语法。

与块级标签不同，在行内级标签内会处理 Markdown 语法。

代码：

1
<span>**Work**</span>
2

3
<div>
4
    **No Work**
5
</div>

预览：

Work

**No Work**

***

在文章中嵌入视频

Thu, 01 Jan 1970 00:00:00 GMT

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

1
---
2
title: 在文章中嵌入视频
3
published: 2023-10-19
4
// ...
5
---
6

7
<iframe width="100%" height="468" src="https://www.youtube.com/embed/5gIf0_xpFPI?si=N1WTorLKL0uwLsU_" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

符号	代码	渲染结果
Alpha	`\alpha`	α\alphaα
Beta	`\beta`	β\betaβ
Gamma	`\Gamma`	Γ\GammaΓ
Pi	`\pi`	π\piπ
Infinity	`\infty`	∞\infty∞
Right Arrow	`\rightarrow`	→\rightarrow→
Partial	`\partial`	∂\partial∂

Firefly

导读：这份指南怎么读

这份指南怎么读#

① 完整通读（推荐）#

② 只做选型#

③ 直奔变现#

编排方式与数据口径#

为什么拆成多页#

页与页之间怎么衔接#

数据口径#

全书目录#

打地基#

选模型#

本地部署#

动手配置#

智能体产品#

开源能力库#

学习与教学#

一人公司#

数据口径与免责说明#

打地基：API、Token、Skill、Agent 与自动化全景

打地基：先搞懂这四个词，再看它能干什么#

核心概念：API、Token、Skill、Agent#

API：服务商开给程序的「服务窗口」#

Token：身份凭证与计费单位#

⚠️ 注意保密#

✅ 最佳实践#

🔄 定期轮换#

Skill 与 Agent：真正让电脑干活的两个角色#

Skill（技能）：单一功能模块#

Agent（智能体）：自主决策的总指挥#

三者的关系：API → Skill → Agent#

自动化能力全景：六类任务与推荐工具#

Firefly 一款清新美观的 Astro 博客主题模板

🌟 项目概述#

🚀 技术架构#

📖 配置说明#

Firefly 简单使用指南

文章的 Front-matter#

文章文件的放置位置#

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 使用示例#

示例 1：使用文件名作为 URL#

示例 2：自定义 Slug#

示例 3：其他语言文件名使用Slug#

Slug 使用建议#

注意事项#

选模型：10 家平台全维度对比与选购指南

选模型：10 家平台，一张图比到底#

主流 API 全维度对比：10 家平台最新旗舰#

十家平台最新旗舰一览#

八维度动态对比图#

输入价格（单位：$ / 百万 Token）#

输出价格（单位：$ / 百万 Token）#

缓存命中价（单位：$ / 百万 Token（输入侧））#

上下文窗口（单位：千 Token（K））#

综合智能指数（单位：分（同口径快照））#

编程 Agent 能力（单位：DeepSWE v1.1 得分（%））#

输出速度（单位：Token / 秒）#

首 Token 延迟（单位：秒（越低越好））#

成本曲线 月成本曲线（按 4 : 1 的输入 / 输出比例估算）#

DeepSeek V4.1 Flash 专项对比#

价格对比：与当前主流旗舰同一口径（每百万 Token，美元）#

基准成绩（官方公布）#

各平台适合谁、擅长什么#

按需求找平台#

读长文档 / 写论文#

编程与代码工程#

中文写作与日常办公#

多模态（图 / 视频 / 语音）#

极致省成本#

实时信息与舆情#

私有化 / 本地部署#

企业级稳定与生态#

平台档案#

🌙 Kimi K3#

🔮 DeepSeek V4.1 Flash#

🤖 OpenAI / ChatGPT#

🧠 Anthropic Claude#

成本曲线月成本曲线（按 4 : 1 的输入 / 输出比例估算）#

🌙 Kimi K3 #

🔮 DeepSeek V4.1 Flash #

🤖 OpenAI / ChatGPT #

🧠 Anthropic Claude #

💎 Google Gemini #

🫘 字节跳动豆包 #

🐑 阿里云通义千问 #

🌟 智谱 AI GLM #

🧩 MiniMax #

🏆 新手首选 LM Studio #

🏆 开发者首选 Ollama #

🏆 极致性能 llama.cpp #

🏆 批量推理 vLLM #

🏆 综合体验 Jan #