Coze实操:1分钟自动抓取1万+条小红书评论,搭建你的爆款选题库
做自媒体的人都知道,评论区是洞察用户真实需求的重要窗口。可无论翻阅自己的笔记评论,还是挖掘对标博主的评论区,靠纯人工去一条条翻,效率实在太低,很多运营者只能眼睁睁看着那些藏在评论里的选题灵感、产品反馈慢慢流失,却根本没有精力深挖。
为了帮大家解决这个痛点,我们基于扣子(Coze)搭建了一套自动化工作流,只需一键,就能自动抓取小红书热门笔记的全部评论,并且同步写入飞书多维表格里。先来看下效果:
通过这个工作流,一次运行就能批量采集多篇笔记的评论,所有数据自动汇入飞书表格,再也不用逐页翻看。下面,我们就一步步来拆解整个搭建过程。
一、搭建自动采集小红书评论的工作流
1. 新建工作流
首先,登录扣子平台(复制链接进入):
https://www.coze.cn/space/7512405357499711528/library

进入后,点击左侧「资源库」,再选择「资源」→「工作流」,然后点击新建。

根据提示填写一个清晰的工作流名称,比如“小红书评论自动采集”。

2. 配置采集评论的核心流程
(1)设置「开始」节点
将开始节点按照下图配置即可,主要定义输入参数,后续我们会传入cookie、笔记链接列表等信息。

(2)添加「循环」节点
在开始节点之后拖入一个「循环」节点,它的作用是逐条处理我们提供的多个笔记链接,实现批量采集。
添加方式如下:

接着,设置循环节点的参数,让它遍历传入的笔记链接数组。

(3)在循环体内部依次添加4个子节点
节点1:「采集评论」插件
在循环体内插入一个“采集评论”插件节点。这一步负责调用小红书接口,根据单条笔记链接抓回对应评论数据。① 搜索并添加插件:

② 插件的参数设置如下图所示,主要是传入当前循环项的笔记链接和cookie。

节点2:「IF选择器」
在插件节点后接上一个「IF选择器」,用于过滤掉没有任何评论的笔记,避免空数据写入表格。左右滑动查看配置:


节点3:「代码」节点
在IF选择器的“否则”分支(即存在评论时)后面,添加一个「代码」节点。它的作用是对插件返回的原始数据进行清洗、格式化,整理成我们需要的字段结构。代码节点的参数如下:

节点4:「飞书多维表格」插件
最后,在代码节点之后放置一个飞书多维表格的“添加记录”插件,将处理好的评论数据逐条写入预设的表格。① 添加对应的飞书插件:

② 设置插入记录的参数,将代码节点输出的每个字段映射到飞书表格的对应列。

(4)连通结束节点
最后,将整个循环节点连接到「结束」节点,并简单设置结束的输出,比如返回“采集完成”。


这样,整套自动采集工作流就搭建完成了。接下来,我们需要准备好让它跑起来所必需的几个素材。
二、运行前的准备工作
运行工作流前,需要准备好以下四样东西:
- 小红书cookie(用于身份校验)
- 待采集的小红书笔记链接(可以是一条或多条)
- 飞书多维表格(用于存放采集结果)
- 飞书表格的链接(配置应用时使用)
1. 获取小红书cookie
用浏览器打开小红书并登录账号:https://www.xiaohongshu.com/
按F12进入开发者模式,然后按下图步骤在网络请求中找到cookie值并复制保存。

2. 准备笔记链接
直接将目标笔记的地址复制出来,可以是单条,也可以用换行或逗号分隔多条链接,在运行时会作为数组参数传入。

Hermes Agent 新手安装完全指南:永久记忆与自动技能生成,打造越用越懂你的AI助手
当许多人还在为 OpenClaw(龙虾)的 Token 消耗苦恼时,AI 圈又丢出一枚重磅炸弹——Hermes Agent 正式登场。名字和那个卖包的奢侈品牌一样,团队这样命名,似乎在暗示:龙虾界的爱马仕来了。
上线不到两个月 GitHub 星标突破 5 万,单日最高新增 6400 星,持续霸榜全球开源榜单第一。

Hermes Agent 为什么会这么火?一句话总结:它并非一次性对话助手,而是一个越用越像你、越用越懂你的 Agent。
它就像是进化版的龙虾,主打永久记忆和自动成长——不会忘记你教过它的任何东西,还能自己学会你的使用习惯,时间越久,契合度越高。
它能自动总结技能(skill):当你交给它一个复杂任务,执行完成后会自动沉淀提炼,生成可复用的 skill 文件。下次遇到类似问题,不必重新分析,直接调用,瞬间搞定。
Hermes 还原生支持个人微信:私聊群聊都能用,信息全覆蓋。当然,飞书、钉钉、企微这些主流平台也同样支持。
接下来,我将一次性为你讲清楚:Hermes Agent 凭什么火、怎么安装、适合哪些场景。
01
Hermes Agent 为何突然爆火?三大核心功能揭秘
用过 OpenClaw(俗称龙虾)的朋友都知道,这玩意真的很烧 Token,成本并不低,直接劝退了一波用户。
从我自己的亲身体验来看,完成相同任务,Hermes Agent 的 token 消耗大约只有 OpenClaw 的二十分之一。
不过这里要说明一点,任务的 token 消耗因人而异。有些人给 Hermes 的任务过于复杂,导致它实际也没比 OpenClaw 便宜多少。但无论具体能省多少,OpenClaw 的高成本始终是用户的痛点,毕竟不是人人都预算宽裕。
那为什么 Hermes 的 token 消耗会比 OpenClaw 低那么多呢?
关键就在于它的三个核心能力:
第一,Skill 自己长
这也是 Hermes 最值钱的地方。
整个闭环只有四步:执行任务 → 自动复盘 → 生成 Skill → 下次直接调用。
md2wechat:2100+ Star的Markdown转公众号排版利器,一键告别繁琐编辑

▌ 核心要点
md2wechat 是一款基于 Go 语言开发的命令行工具,能够将 Markdown 直接转换为符合微信公众号规范的排版样式,并自动上传到草稿箱。该项目在 GitHub 上已获得 2100+ 星标,内置 40 余种主题、43 个结构化排版模块,且可对接 Claude Code、Codex、OpenClaw 等 AI 写作助手。免费模式即可覆盖大部分需求,API 模式则提供更完整的专业能力。
初识 md2wechat:它到底解决了什么问题
如果你正在运营公众号,一定对这样的场景不陌生:在微信编辑器中反复调整两小时,换个手机预览却发现样式完全错乱。又或者,你早已习惯用 Typora / Obsidian 等工具在 Markdown 中写作,发布时却不得不把内容粘贴到编辑器里,再逐项调整格式。
md2wechat 正是为终结这类痛点而生。你只需继续保持 Markdown 写作的习惯,剩下的排版、转换、上传草稿箱全部由它接管。全过程在命令行中完成,根本无需打开浏览器。
这样一来,写作与发布之间的断层被彻底打通,创作者得以把精力重新聚焦在内容本身。
哪些人最适合它?
长期维护公众号的创作者、技术团队里负责内容输出的运营人员,以及借助 AI 辅助撰稿却被排版问题拖慢节奏的朋友,都是这款工具的理想用户。反过来,如果你只在手机上写作,或对排版完全没有个性化要求,可能并不需要专门安装一个命令行工具。
一个命令行工具,接管公众号发布全流程
安装过程非常轻量。对于 macOS 用户,一行命令即可完成:
brew install geekjourneyx/tap/md2wechat
其他平台则提供了 npm、go install、install.sh 等其他便捷安装方式。
基本工作流十分简洁:用 Markdown 写完文章,运行 md2wechat 触发转换,精美排版即刻生成,最后自动上传至微信草稿箱。全程都在终端内完成,公众号后台的编辑器无需打开。
相较于市面上其他 Markdown 转换工具,md2wechat 有一个显著优势:在 API 模式下,同一份 Markdown 总是产生完全相同的排版(确定性输出),而不是每次都依赖 AI 重新生成。这对于需要批量发布、团队协作的场景来说,显得格外关键。
43 个排版模块:像搭积木一样营造视觉层次
项目中提供了 43 个高度结构化的排版模块,你可以通过类似 :::block hero、:::block callout、:::block timeline 的语法,在 Markdown 中直接调用。想插入一个醒目的引用块?只要写一行 :::block callout,不用手动调整任何样式。
NanoBanana2 五大创新玩法实测:超宽比例生图、微缩模型、实时搜索与翻译上色全解析
就在上周,谷歌低调发布了旗下最新模型 NanoBanana 2。它一上线便登顶 Arena 文生图排行榜首。

说实话,AI 生图领域迭代太快,多数时候我已经很难再感到兴奋。但 NB2 的确有些不同——它的基座模型从 Gemini 3 Pro 换成了 Gemini 3.1 Flash,推理速度更快、成本更低,画质却几乎没有下降,而且最关键的一点是:基本不再需要反复“抽卡”。
那么,新晋生图王者到底带来了哪些改变?我简单整理了一下:

作为普通用户,NB2 又能为我们的日常创作提供哪些便利?下面我将总结出五个最新玩法,并附上提示词,同时也会介绍在没有特殊网络环境下使用 NB2 的方法。
五种全新创作玩法,一次看懂
1、一键生成极宽幅图像
此次 NB2 新增了 4:1、1:4、8:1、1:8 等超宽或超窄画面比例,再加上原有的 1:1、16:9、9:16、4:3、3:4、3:2、2:3 等比例,设计场景的灵活度大幅提升。
特别是 8:1 和 1:8 这类极宽画幅,非常适合制作电商详情页 Banner、装修全景图、商场围挡、户外广告和游戏侧边背景,能带来强烈的沉浸感。
比如我生成一张太阳系主题的图片:

提示词:太阳系,比例:8:1
还能模仿《清明上河图》的画风来创作现代城市风俗图:

提示词:模仿清明上河图的风格,画一张现代的【城市】的风俗画,8:1比例,2K。
1:8 的超窄比例同样震撼。

提示词:万米深潜。画面构想:这是一场向海洋极深处的坠落。最上方是波光粼粼的海面和一艘小船;往下是游动着巨大蓝鲸;继续往下光线急剧变暗,出现沉船和发光水母;到了画面的最底部,是一个几乎占据整个屏幕宽度的、潜伏在海沟里的不可名状的克苏鲁巨兽张开的深渊巨口,而上方正有一个极小的潜水员在缓缓下落。比例1:8
2、生成微缩模型
NB2 只需简单的提示词就能生成细节丰富的微缩模型效果。比如我用广州地标做一个建筑模型:

提示词:一张广州的街景地图放置在木质桌面上,地图上浮现出广州的逼真微缩模型,以及广州塔(小蛮腰)、石室圣心大教堂、陈家祠、白云山与绿植、熙熙攘攘的街头集市、复古有轨电车和天空中漂浮的彩色灯笼。
再用上海外滩做一座 3D 微缩城市:

提示词:上海外滩 3D 等距微缩城市景观,采用微缩移轴摄影风格,高度还原东方明珠塔等建筑细节,运用柔和的影棚灯光、黏土和树脂材料,并在城市中心融入大型 3D 风格化汉字“外滩”。
3、实时搜索生图
NB2 新加入了搜索功能,可以实时从互联网获取知识和参考图来生成图像。比如我让它根据未来五天广州的天气帮我搭配衣服:

提示词:根据未来五日广州的天气给我搭配衣服,生成一张图片。
还可以直接输入:介绍一下 Nano Banana 2 图像生成模型的核心亮点
NAS 自建音乐服务器终极方案:GoMusicDL 多平台一键部署与批量下载指南
想要搭建属于自己的 NAS 音乐服务器,第一步往往就让人头疼——音乐资源从哪里来?即使开通了 QQ 音乐、网易云等会员,下载歌曲仍有每月数量上限,或者下载到的文件是加密格式,难以自由管理。如果你也卡在这一关,那么本期介绍的 GoMusicDL 很可能成为你的完美解法。它支持 Docker Web 部署、桌面应用、TUI 终端三种模式,定位远不止是“资源获取工具”,简单配置后,还可以直接当作一个轻量级 Web 播放器使用。

桌面应用目前覆盖 Windows (x64/x86/arm64)、macOS (x64/arm64)、Linux (x64),大家可以直接前往项目发布页面获取对应版本。

项目概述
完整项目名称为 guohuiyuan/go-music-dl,可以在 GitHub 上直接搜索。GoMusicDL 是一款集搜索与下载于一体的音乐工具,同时提供 Web 界面、TUI 终端和桌面应用三种使用形态。除了常规的单曲搜索与下载外,它还支持歌单解析、专辑解析、整单/整专曲目查看与批量处理。你可以通过浏览器在线试听,也能在终端里批量下载,或者直接启动原生桌面应用,获取最佳体验。
核心亮点
- · 三种使用形态:不止于命令行,支持 Web、TUI 和桌面应用,按需选择。
- · 不止单曲:支持单曲、歌单、专辑的搜索、解析和批量下载,且下载文件已内嵌元数据。
- · 多平台聚合:聚合多平台搜索能力,支持试听、歌词、封面以及灵活换源。
- · Web 端功能齐全:包含本地收藏夹、自建歌单、批量下载/换源、全局播放栏,完全可以当作日常播放器使用。

Docker 部署指南(以威联通 NAS 为例)
这里以威联通 NAS 环境为例,采用 Docker Compose 的方式进行部署,操作简单且易于维护。
部署参考代码:
services:
music-dl:
image: guohuiyuan/go-music-dl:latest
container_name: music-dl
restart: always
user: "0:0"
ports:
- "9981:8080" # 左侧端口可按需修改
volumes:
- /share/Container/musicdl/data:/home/appuser/data # 配置目录,左侧映射路径可自行调整
- /share/Music:/app/downloads # 音乐存储目录,左侧路径可自行调整
environment:
- TZ=Asia/Shanghai
command: [ "./music-dl", "web", "--port", "8080", "--no-browser" ]
在威联通的 Container Station 中,直接创建新的应用程序并粘贴以上配置即可。
NAS一键部署AI狼人杀:纯前端智能桌游,与9名AI角色烧脑对决
临近五一假期,为你推荐一款能独自解闷、也可与亲友同乐的趣味项目——AI狼人杀。每个角色背后都由不同的大语言模型驱动,拥有专属的性格和策略,能够根据场上局势推理、发言、投票,甚至编织谎言,让每一局都充满戏剧性。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀1.webp)
项目简介
完整项目名为onebai123/wolfcha-web,可在GitHub上搜索获取。
该项目是Wolfcha(猹杀)的二开版本,基于oil-oil/wolfcha改造而来,是一套纯前端实现的AI狼人杀游戏。它支持自定义API端点,仅需一个网页,所有人都能直接参与。
你将作为全场唯一的人类玩家,与其他9名AI角色共同经历一局完整的狼人杀。不同的AI不仅性格各异,其背后的博弈策略也千姿百态:它们会依据当前局势展开推理、发表言论、互投选票,甚至故意说谎。
作者在项目页面透露,未来会推出v2.0版本的无后台联机模式,基于Redis或对象存储实现房间同步,让多人远程对战成为可能,且依旧无须自建后端服务器。
产品亮点
- 🌐 纯前端运行:不依赖后端,一个网页即开即用
- 💾 本地存储:API Key仅保存在你的浏览器中,保障数据安全
- 🎮 零门槛开玩:无需注册账号,打开页面直接开始对局
- ✅ 灵活接入API:支持DeepSeek、硅基流动、OpenAI等任意兼容接口
- 📱 多设备适配:电脑、平板、手机均可流畅游玩
- 🔏 隐私至上:所有数据只存放在你本地的浏览器内
部署方式
以威联通NAS为例,使用Docker Compose来快速部署。由于原项目未提供现成镜像,我已自行构建并发布到了Docker Hub。
你可以使用下面的配置进行部署:
services:
wolfcha-web:
image: ydxian/wolfcha-web:v1
container_name: wolfcha-web
ports:
- "7860:7860"
restart: always
进入威联通的Container Station,创建一个新的应用程序,将上述内容粘贴保存即可。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀2.webp)
游戏初体验
部署完成后,在浏览器访问NAS_IP:7860,就能见到极具仪式感的主页:“签署名字后才可生效”。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀3.webp)
点击右上角的「设置」,你可以调整难度、玩家人数以及声音效果等参数。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀4.webp)
不同人数配置下的角色组成也各不相同,策略空间随之变化。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀5.webp)
以硅基流动为例,在设置页面填入你的API Key与模型名称,保存即可。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀6.webp)
保存后刷新页面,轻触指纹处的签名区域,游戏便正式开始。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀7.webp)
接着会进入等待其他“玩家”入场的环节。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀8.webp)
看,我抽到了女巫!
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀9.webp)
游戏还贴心地为新手准备了一些引导提示。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀10.webp)
即使使用的是免费的公开API,响应速度也丝毫不拖沓,节奏紧凑。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀11.webp) https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀12.webp)
另一个有趣的细节是,每位参与者的性格标签和背后调用的AI大模型都不完全相同,这极大增强了对局的多样性和娱乐性。
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀13.webp)
https://watermelonwater.tech/insights_imgs/NAS一键部署AI狼人杀14.webp)
结语
如果你也对这款纯前端的AI狼人杀感兴趣,不妨先部署体验起来,同时期待作者早日带来支持多人联机的v2.0版本。
OmniGet开源下载神器:免费免登录无广告,一键保存全网视频音频文档
你是否曾为无法永久保存喜爱的短视频而遗憾?是否希望离线学习在线课程,彻底摆脱网络依赖?是否想高效收集优质文档和媒体资源,却苦于工具繁杂?这些看似分散的需求,在OmniGet的帮助下都能一站式解决。
OmniGet是一款免费开源的桌面下载工具,以“全能兼容、轻量高效、纯净无广告”为核心理念,将多种资源获取能力聚合在一个简洁的界面里。它在GitHub上已收获超过2000颗星,受到众多开发者的认可。
与传统下载工具相比,OmniGet体积小巧、启动飞快,兼容arm等多种架构,电脑与平板都能轻松适配。代码完全公开,没有任何弹窗广告或捆绑软件,依靠社区力量持续迭代,即使低配机器也能流畅运行,同时支持Windows、macOS、Linux三大系统。

它原生支持50多个主流平台,并通过整合yt-dlp工具,将可解析的网站扩展到1000多个。无论是短视频、长视频、图片、音频还是文档,只需复制链接并粘贴到OmniGet中,软件就会自动识别可留存的资源,真正做到一键下载。

功能细节不再赘述,下面直接看安装步骤。首先前往GitHub获取安装包,项目地址如下:
https://github.com/tonhowtf/omniget
下载页面提供了多个系统版本,请根据你的操作系统选择对应文件。

下载完成后运行安装程序,按照向导设置语言、界面主题以及下载保存路径等偏好。

安装过程中会提示必须安装yt-dlp和FFmpeg两个组件。你可以尝试点击“全部安装”自动部署,若自动安装失败则需要手动配置。

先看yt-dlp的手动安装。从GitHub下载其程序,链接在此:
https://github.com/yt-dlp/yt-dlp
把下载好的文件放到你打算安装的目录,然后在文件夹空白处右键选择“在终端打开”。

在打开的终端窗口中输入 winget install yt-dlp 并回车(可直接复制命令),系统会自动下载并安装,耐心等待进度条走完。


当界面停止滚动且不再显示蓝色的下载进度条时,表示安装完毕,可以关闭终端窗口。

FFmpeg的安装流程类似,下载安装包地址为:
网上也有详细教程,遇到困难可以自行搜索。yt-dlp和FFmpeg既可以提前装好,也可以在OmniGet安装过程中跳过,稍后补装。注意首次运行OmniGet时可以选择需要启用的功能模块,建议全部勾选;如果跳过了,之后也能随时在插件市场安装。

进入主界面后,你可以在输入框中粘贴链接或直接搜索资源。

点击左侧的“插件市场”可以随时安装或卸载所需要的插件,灵活扩展功能。

在设置页中,你可以自由切换主题颜色、修改下载保存路径、选择视频质量,还可以启用字幕下载。软件还支持按平台整理文件,自动生成独立文件夹,让资源管理井井有条。

在“设置→工具”中,可以检查yt-dlp和FFmpeg是否成功安装。成功则会显示版本号,右侧按钮为“更新”;未安装则显示“安装”。其余参数保持默认即可。

OmniGet还能借助FFmpeg实现视频格式转换,转换速度依赖本地显卡性能,显卡越好速度越快。

软件还内置了一些课程下载平台的支持,不过这些平台通常需要配置代理并登录才能正常下载,否则会显示连接失败,有需要的话可以自行设置。

总的来说,OmniGet作为一款下载工具,功能强大人性化,完全没有广告弹窗,也无需登录或付费,相比许多同类付费产品,体验堪称“碾压级”存在。
OpenCode MCP深度实战:十款必备服务器打通全栈开发工具链
🔥 GitHub、数据库、Slack、浏览器……想象一下,一个 AI 工具就能把这些全部串起来。
从 10 个必装 MCP 服务器到按代理角色精细化权限控制,再到自定义开发入门——本文带你把 OpenCode 从“能写代码”升级成“能操控一切”。
📌 MCP 核心理念与架构解析
一句话说明
MCP(Model Context Protocol) 是一套开放协议,让 AI 编程代理可以对接外部工具和数据源。如果把 OpenCode 比作大脑,那么 MCP 就是它的手和眼睛——不仅能读写代码,还让它有能力查数据库、管 Issue、搜文档、操作云服务。
OpenCode 能力体系
内置工具层14 个基础工具
MCP 扩展层无限外部工具
文件读写 / Bash / 搜索
Sentry 错误追踪
Context7 文档查询
数据库操作
GitHub / Jira 集成
Slack 通知
自定义 API
MCP 在架构中的位置
回顾 OpenCode 的三层架构:
你的指令 → 代理层(怎么思考) → 工具层(能做什么) → 代码库
↑
MCP 扩展层(能连什么)
- 内置工具:文件读写、Bash 执行、代码搜索等 14 个工具,开箱即用
- MCP 工具:连接外部世界的桥梁,按需安装,扩展性几乎没有上限
一旦添加 MCP,其工具会自动与内置工具一起提供给 LLM 调用,无需额外配置。
OpenCode 模型配置终极攻略:75+ 提供商随心换,免费到顶尖全搞定
🔥 同样的代码,有人烧钱请人写,有人零成本轻松搞定——关键全在模型配置。
不绑定任何一家 AI 厂商——OpenCode 让你像换手机壳一样切换大模型。从零成本的免费模型,到最强的 GPT 5.4 Pro,完全由你说了算。
OpenCode 模型架构的核心概念
为什么模型选择至关重要?
AI 编程工具的灵魂是大模型。模型直接决定:
- 代码质量:产出的代码能不能拿来即用
- 理解能力:能否读懂整个项目的上下文
- 响应速度:要等多久才能拿到答案
- 使用成本:每月需要花多少钱
现实问题:绝大多数 AI 编程工具只能使用自家模型。Cursor 仅限自家模型,Copilot 仅限 OpenAI,Claude Code 仅限 Claude。
OpenCode 打破了这道围墙——75+ 家模型提供商,选择权在你手中。
三层模型架构
OpenCode 的模型体系分成三层:云端模型、本地模型、OpenCode Zen 精选网关。
OpenCode 模型体系
云端模型
本地模型
OpenCode Zen精选网关
国际大厂OpenAI / Anthropic / Google
国内厂商智谱GLM / 通义Qwen / Kimi
聚合平台OpenRouter / Together AI
垂直平台Groq / Cerebras / xAI
Ollama
llama.cpp
LM Studio
免费模型Big Pickle / GPT 5 Nano
OpenCode 项目上下文实战:AGENTS.md 与 Skills 让 AI 读懂你的代码库
一条 /init 命令,AI 就能完整掌握你的项目语境。这并非魔法,而是靠 AGENTS.md 体系实现。
通用 AI 不知道你们团队的工作约定、代码风格、目录结构——AGENTS.md 就是你为 AI 编写的「项目操作手册」,Skills 则是提供「专项技能包」。两者结合,把 OpenCode 从「通用助手」升级为「项目专家」。
核心思路:为什么必须使用 AGENTS.md
通用 AI 的真正短板
想象你刚招募了一位技术很强但对项目零了解的开发者。他产出的代码功能也许没问题,但大概率会出现:
- 变量命名风格随意,与 camelCase / snake_case 不符
- 无视
packages/core/是共享逻辑区的约束 - 部署前忘记执行
pnpm lint - Git 提交信息与团队规范冲突
OpenCode 同样面临这个问题。 默认状态下它只是能力出众的 AI 编程助手——技术扎实,却对你的项目上下文一无所知。
AGENTS.md 就是项目的「上下文说明书」
AGENTS.md 是面向整个项目的 AI 配置文件,可以这样类比:
.editorconfig → 指导编辑器如何格式化代码
.gitignore → 告知 Git 忽略哪些文件
AGENTS.md → 让 AI 懂得项目的运行规则
类比:
.editorconfig供编辑器阅读,AGENTS.md供 AI 理解。两者均为项目级配置,理应纳入 Git 版本控制。
AGENTS.md 如何改变 AI 的行为
OpenCode 启动时,会把 AGENTS.md 的内容作为系统提示(System Prompt)的一部分注入每次对话。也就是说,无论你给 AI 分配何种任务,它都会自动遵循这里面定义的各项规则。
