3.1 工具套装总览

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

本教材的实践环节围绕 Opencode 展开。Opencode 是一个在终端中运行的 AI 助手，能读写文件、执行命令、联网查询，用自然语言即可控制。

但光装 Opencode 本身还不够。AI 在工作时需要调用一系列底层工具——版本控制、文档转换、Python 数据分析。缺少任何一个，某些功能就无法正常运行。

这一节列出完整的安装清单，帮你一次配齐全套工具。

A. 安装清单

安装完成后，你将拥有以下工具：

软件	作用	macOS 安装方式	Windows 安装方式
Xcode 命令行工具	macOS 基础开发工具包，其他软件的前置依赖	`xcode-select --install`	不需要
Homebrew	macOS 命令行软件管理器	官方脚本	不需要
Git	版本控制工具，记录文件每次修改	`brew install git`	官网下载 .exe
Node.js + npm	JavaScript 运行环境，Opencode 的运行基础	`brew install node`	官网下载 .msi
Opencode	核心 AI 助手，在终端中运行	`brew install anomalyco/tap/opencode`	`npm install -g opencode-ai`
VS Code	代码和文本编辑器	`brew install --cask visual-studio-code`	官网下载 .exe
Miniconda	Python 环境管理工具	`brew install --cask miniconda`	官网下载 .exe
Pandoc	文档格式转换工具	`brew install pandoc`	官网下载 .msi
Skills 扩展包	15 个实用技能（幻灯片制作、PDF 处理等）	通用安装	通用安装

安装时间

macOS 用户全程约 30 分钟（Homebrew 安装后一键完成）。Windows 用户需逐个下载安装，约 60 分钟。

B. 每个工具的作用

Git — 版本控制工具。它记录文件的每次修改，出了问题可以随时回到之前的状态。Opencode 在工作时用 Git 管理文件变更，AI 改了什么、改错了想回退，全靠它。

Node.js — JavaScript 运行环境。Opencode 基于 JavaScript 开发，需要 Node.js 才能运行。安装 Node.js 时会同时装上 npm（Node Package Manager），后续安装扩展会用到。

Opencode — 整套工具的核心。它在终端中运行，能读写文件、执行命令、联网查询，用自然语言就能控制。和网页版 AI 聊天不同，Opencode 直接在你的电脑上工作，可以处理本地文件。

VS Code — 目前最流行的代码和文本编辑器。配合 Opencode 使用，可以在同一个窗口里查看文件和跟 AI 对话。上半部分编辑文件，下半部分运行 Opencode，效率很高。

Miniconda — Python 环境管理工具。安装后即可使用 Python，用于数据分析、自动化脚本等任务。比完整版 Anaconda 小很多，但功能够用。

Pandoc — 文档格式转换工具，能把 Markdown 文件转成 Word、PDF 等格式。配合 Opencode 的 Skills 扩展包，可以把 AI 生成的内容转成 Word 文档。

知识卡片

macOS 用户额外需要两个前置工具：Xcode 命令行工具提供编译器等基础组件；Homebrew 是命令行软件管理器，装好它之后，Git、Node.js、Opencode、VS Code、Miniconda、Pandoc 全部一行命令安装。

C. Skills 扩展包

Skills 是 Opencode 的技能扩展。安装后，Opencode 获得处理特定任务的能力。本教材推荐的扩展包包含 15 个实用技能：

技能	功能
arxiv	学术论文检索
cc-insights	代码分析洞察
chinese-quote-converter	中文引号转换
command-development	命令行工具开发
docx	Word 文档处理
fetch4ai	网页内容抓取
frontend-design	前端界面设计
markitdown	Markdown 格式转换
marp-slides-creator	幻灯片制作
md-to-docx	Markdown 转 Word
pdf	PDF 文件处理
pptx	PowerPoint 处理
skill-creator	自定义技能开发
web-research	网络信息搜集
xlsx	电子表格处理

Skills 扩展包的安装步骤在 macOS 和 Windows 上完全相同，将在通用配置部分统一完成。

--- title: "3.1 工具套装总览" --- 本教材的实践环节围绕 Opencode 展开。Opencode 是一个在终端中运行的 AI 助手，能读写文件、执行命令、联网查询，用自然语言即可控制。但光装 Opencode 本身还不够。AI 在工作时需要调用一系列底层工具——版本控制、文档转换、Python 数据分析。缺少任何一个，某些功能就无法正常运行。这一节列出完整的安装清单，帮你一次配齐全套工具。 ### A. 安装清单安装完成后，你将拥有以下工具： | 软件 | 作用 | macOS 安装方式 | Windows 安装方式 | |------|------|----------------|------------------| | Xcode 命令行工具 | macOS 基础开发工具包，其他软件的前置依赖 | `xcode-select --install` | 不需要 | | Homebrew | macOS 命令行软件管理器 | 官方脚本 | 不需要 | | Git | 版本控制工具，记录文件每次修改 | `brew install git` | 官网下载 .exe | | Node.js + npm | JavaScript 运行环境，Opencode 的运行基础 | `brew install node` | 官网下载 .msi | | Opencode | 核心 AI 助手，在终端中运行 | `brew install anomalyco/tap/opencode` | `npm install -g opencode-ai` | | VS Code | 代码和文本编辑器 | `brew install --cask visual-studio-code` | 官网下载 .exe | | Miniconda | Python 环境管理工具 | `brew install --cask miniconda` | 官网下载 .exe | | Pandoc | 文档格式转换工具 | `brew install pandoc` | 官网下载 .msi | | Skills 扩展包 | 15 个实用技能（幻灯片制作、PDF 处理等） | 通用安装 | 通用安装 | ::: {.callout-tip} ## 安装时间 macOS 用户全程约 30 分钟（Homebrew 安装后一键完成）。Windows 用户需逐个下载安装，约 60 分钟。 ::: ### B. 每个工具的作用 **Git** — 版本控制工具。它记录文件的每次修改，出了问题可以随时回到之前的状态。Opencode 在工作时用 Git 管理文件变更，AI 改了什么、改错了想回退，全靠它。 **Node.js** — JavaScript 运行环境。Opencode 基于 JavaScript 开发，需要 Node.js 才能运行。安装 Node.js 时会同时装上 npm（Node Package Manager），后续安装扩展会用到。 **Opencode** — 整套工具的核心。它在终端中运行，能读写文件、执行命令、联网查询，用自然语言就能控制。和网页版 AI 聊天不同，Opencode 直接在你的电脑上工作，可以处理本地文件。 ![Opencode 官网（opencode.ai）](images/opencode-homepage.png) **VS Code** — 目前最流行的代码和文本编辑器。配合 Opencode 使用，可以在同一个窗口里查看文件和跟 AI 对话。上半部分编辑文件，下半部分运行 Opencode，效率很高。 **Miniconda** — Python 环境管理工具。安装后即可使用 Python，用于数据分析、自动化脚本等任务。比完整版 Anaconda 小很多，但功能够用。 **Pandoc** — 文档格式转换工具，能把 Markdown 文件转成 Word、PDF 等格式。配合 Opencode 的 Skills 扩展包，可以把 AI 生成的内容转成 Word 文档。 ::: {.callout-note} ## 知识卡片 macOS 用户额外需要两个前置工具：Xcode 命令行工具提供编译器等基础组件；Homebrew 是命令行软件管理器，装好它之后，Git、Node.js、Opencode、VS Code、Miniconda、Pandoc 全部一行命令安装。 ::: ### C. Skills 扩展包 Skills 是 Opencode 的技能扩展。安装后，Opencode 获得处理特定任务的能力。本教材推荐的扩展包包含 15 个实用技能： | 技能 | 功能 | |------|------| | arxiv | 学术论文检索 | | cc-insights | 代码分析洞察 | | chinese-quote-converter | 中文引号转换 | | command-development | 命令行工具开发 | | docx | Word 文档处理 | | fetch4ai | 网页内容抓取 | | frontend-design | 前端界面设计 | | markitdown | Markdown 格式转换 | | marp-slides-creator | 幻灯片制作 | | md-to-docx | Markdown 转 Word | | pdf | PDF 文件处理 | | pptx | PowerPoint 处理 | | skill-creator | 自定义技能开发 | | web-research | 网络信息搜集 | | xlsx | 电子表格处理 | Skills 扩展包的安装步骤在 macOS 和 Windows 上完全相同，将在通用配置部分统一完成。