附录 A · 环境配置速查（macOS / Windows）

手册：AI 辅助金融研究学生自学手册

本附录是第 1 章「AI 研究工具就绪」的完整速查版。日常装机、自检、排错时直接对照本表，无需翻正文。双平台口径：macOS 主线（教师机实测）+ Windows 学生机分支（源 14 讲义口径，Windows 11 中文版 25H2+）。

A.1 macOS 主线配置（教师机实测）

A.1.1 基础工具

软件	版本要求	安装方式	验证命令
Homebrew	latest	`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`	`brew --version`
Python	≥ 3.12	`brew install python@3.12`	`python3 --version`
Node.js	≥ 20 LTS	`brew install node`	`node --version`
Git	≥ 2.40	`brew install git`	`git --version`
Stata	18 MP/SE	学校正版安装包 + 命令行链接	`stata-mp --version`
Zotero	10	官网下载（zotero.org）	启动验证
Qoder / Trae	latest	官网下载	启动验证
MacTeX	2024+	`brew install --cask mactex-no-gui`	`xelatex --version`

A.1.2 学术工具链

工具	用途	安装	验证	对应章节
officecli	Word/Excel/PPT 全能操作	`pip install officecli`	`officecli --version`	第 1/8/11 章
cli-anything-zotero	Zotero CLI Bridge	`pip install cli-anything` + 插件安装	`cli-anything-zotero app doctor`	第 3 章
edge-tts	语音合成（公众号/视频）	`pip install edge-tts`	`edge-tts --list-voices`	课外
pandoc	文档格式互转	`brew install pandoc`	`pandoc --version`	第 11 章
quarto	.ipynb → PDF/HTML/Word	`brew install --cask quarto`	`quarto --version`	课外发布
uv	Python 包管理器（快）	`brew install uv`	`uv --version`	第 1 章
gh	GitHub CLI	`brew install gh`	`gh --version`	第 1 章

A.1.3 macOS 一键自检脚本

bash

#!/bin/bash
# check_ai_stata_env.sh —— 第 1 章 macOS 自检 cell 配套
echo "=== AI 研究环境检查（macOS） ==="
for cmd in python3 node git stata-mp pandoc xelatex quarto uv gh \
           officecli cli-anything-zotero edge-tts; do
  if command -v $cmd &>/dev/null; then
    echo "✅ $cmd: $(command -v $cmd)"
  else
    echo "❌ $cmd: 未安装"
  fi
done

# Zotero 桌面端检查
if [ -d "/Applications/Zotero.app" ]; then
  echo "✅ Zotero.app: /Applications/Zotero.app"
else
  echo "❌ Zotero.app: 未安装"
fi

# Qoder MCP 配置目录
if [ -d "$HOME/Library/Application Support/Qoder/SharedClientCache/projects" ]; then
  echo "✅ Qoder MCP 配置目录存在"
else
  echo "⚠️ Qoder MCP 配置目录不存在（首次启动 Qoder 后自动创建）"
fi

A.2 Windows 学生机配置（源 14 讲义口径）

适用：研究生自备 Windows 11 中文版（25H2+）机器；与 macOS 主线等效，路径/包管理器/终端有差异。

A.2.1 基础工具

软件	版本要求	安装方式	验证命令（PowerShell 7）
PowerShell 7	latest	Microsoft Store 搜「PowerShell」	`$PSVersionTable.PSVersion`
Python	3.12	python.org 下载，务必勾选 Add to PATH	`python --version`
Node.js	LTS（⚠️ 勿选 Current）	nodejs.org 下载 .msi	`node --version`
Git	≥ 2.40	git-scm.com 下载	`git --version`
Stata	18 MP/SE	学校正版安装包；安装后手动加 PATH	`stata-mp /e version`
Zotero	10	zotero.org 下载	启动验证
Qoder	latest	官网下载 `Qoder-Setup.exe`	启动验证
MiKTeX	latest（Basic Installer 约 230 MB）	miktex.org 下载，无需管理员权限	`xelatex --version`

A.2.2 与 macOS 的关键差异

维度	macOS	Windows
路径分隔符	`/`	`\`（PowerShell 中可用 `/`）
终端	Terminal / iTerm2 + zsh	PowerShell 7 / Windows Terminal
包管理器	Homebrew（`brew install`）	winget / choco（`winget install`）
Stata 路径	`/Applications/Stata/StataMP.app`	`C:\Program Files\Stata18\`
Qoder MCP 配置	`~/Library/Application Support/Qoder/SharedClientCache/projects/<项目>/mcps`	`%APPDATA%\Qoder\SharedClientCache\extension\local\mcp.json`
LaTeX 发行版	MacTeX（约 4 GB，全）	MiKTeX（Basic 约 230 MB，按需下载宏包）
中文字体	系统自带（PingFang/STHeiti）	SimSun / SimHei / KaiTi / FangSong / 微软雅黑（五件套）

A.2.3 PowerShell 7 常用命令对照

任务	macOS（zsh）	Windows（PowerShell 7）
列目录	`ls -la`	`Get-ChildItem -Force` 或 `ls`（PowerShell 别名）
进目录	`cd path`	`cd path`（同）
查命令路径	`which cmd`	`Get-Command cmd`
设环境变量	`export VAR=val`	`$env:VAR = "val"`
永久环境变量	写入 `~/.zshrc`	`[Environment]::SetEnvironmentVariable("VAR","val","User")`
包安装	`brew install pkg`	`winget install pkg`
Python 包	`pip install pkg`	`pip install pkg`（同；建议先 `python -m pip install -U pip`）
查端口占用	`lsof -i :PORT`	`Get-NetTCPConnection -LocalPort PORT`

A.2.4 MiKTeX 中文 LaTeX 配置要点

安装时选「Install missing packages on-the-fly」= Always（避免编译卡住）

编译中文文档必须用 XeLaTeX（不是 pdfLaTeX），导言区加：

latex

\usepackage[UTF8]{ctex}   % 或 \usepackage{xeCJK}
\setCJKmainfont{SimSun}
\setCJKsansfont{SimHei}
\setCJKmonofont{KaiTi}

第一次编译会下载宏包，不要中断——等 MiKTeX Console 自动装完
推荐编辑器：VS Code + LaTeX Workshop 扩展，或 TeXstudio

A.2.5 Windows 一键自检脚本（PowerShell 7）

powershell

# check_ai_stata_env.ps1 —— 第 1 章 Windows 自检 cell 配套
Write-Host "=== AI 研究环境检查（Windows） ===" -ForegroundColor Cyan
$cmds = @("python","node","git","stata-mp","pandoc","xelatex","quarto","uv","gh",
          "officecli","cli-anything-zotero","edge-tts")
foreach ($c in $cmds) {
  $cmd = Get-Command $c -ErrorAction SilentlyContinue
  if ($cmd) { Write-Host "✅ $c : $($cmd.Source)" -ForegroundColor Green }
  else      { Write-Host "❌ $c : 未安装" -ForegroundColor Red }
}
# Qoder MCP 配置文件检查
$mcp = "$env:APPDATA\Qoder\SharedClientCache\extension\local\mcp.json"
if (Test-Path $mcp) { Write-Host "✅ Qoder mcp.json: $mcp" -ForegroundColor Green }
else                { Write-Host "⚠️ Qoder mcp.json 不存在（首次启动 Qoder 后自动创建）" }

A.2.6 Windows 排错速查（源 14 第十二部分精选 8 条）

现象	原因	解法
`xelatex` 中文报错「cannot find font」	未装中文字体或未用 `\setCJKmainfont`	用 Windows 自带 SimSun/SimHei；导言区显式指定字体
MiKTeX 首次编译卡住	在按需下载宏包	等 MiKTeX Console 自动完成；勿强制结束
`fancyhdr` 警告「headheight too small」	模板默认值偏小	导言区加 `\setlength{\headheight}{15pt}`
`npm install -g` 权限失败	PowerShell 执行策略限制	`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
`pip install` 慢/超时	默认源在国外	`pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple`
`python` 命令找不到	安装时未勾选 Add to PATH	重装并勾选；或手动加 `C:\Users\<你>\AppData\Local\Programs\Python\Python312` 到 PATH
OpenCLI 扩展未连接	Chrome 扩展未启用	运行 `opencli setup` 重新配对，再 `opencli doctor` 自检
`pnpm install` 失败	Node 版本太老 / 镜像问题	升 Node LTS；`pnpm config set registry https://registry.npmmirror.com`

A.3 标准研究文件夹结构（第 1.5/2.6 节配套）

my_research_project/
├── README.md                  # 一页项目说明
├── data/
│   ├── raw/                   # 原始数据（只读，永不修改）
│   ├── clean/                 # 清洗后数据（do 文件生成）
│   └── derived/               # 中间产物（合并表/子样本）
├── do/                        # Stata do 文件（按章节命名）
│   ├── 01_clean.do
│   ├── 02_descriptive.do
│   ├── 03_baseline.do
│   └── 04_robust.do
├── output/
│   ├── tables/                # 三线表（.rtf / .docx）
│   ├── figures/               # 图（.png / .pdf）
│   └── logs/                  # Stata log（带时间戳）
├── docs/
│   ├── research_question.md   # 第 2 章产出
│   ├── research_design.md     # 第 4 章产出
│   ├── one_page_proposal.md   # 第 3 章产出
│   └── my_paper_final.docx    # 第 11 章产出
└── references/
    ├── rural_finance_30papers.bib
    └── pdfs/

黄金原则：data/raw/ 只读 + do/ 完整可复现 + output/logs/ 带时间戳——三件套齐备才能通过 S8.1 / S9.3 诚信检查。

A.4 MCP / Skill / CLI 三层范式速查（第 1.3c 节配套）

装机前先建认知框架——三类工具各管什么，再决定装什么。

A.4.1 三范式五维对比

维度	MCP（连接层）	Skill（知识层）	CLI（执行层）
本质	连接协议	领域知识文件	Shell 命令
类比	USB-C 接口	操作手册	万能遥控器
形态	JSON-RPC Server	Markdown 文件（SKILL.md）	Shell 命令
开发成本	高（需写 Server）	低（写 Markdown）	零（直接用）
适合场景	企业 SaaS / 数据库 / 远程执行	知识复用 / SOP 沉淀	本地自动化 / 文件批处理

💡 黄金组合：CLI（执行层）+ Skill（知识层）+ MCP（连接层）= 完整的 AI 工具链。例：跑回归 = stata-mcp（MCP 连 Stata）+ stata Skill（回归 SOP）+ officecli（CLI 输出 Word）。

A.4.2 Qoder mcp.json 配置双平台路径

平台	配置文件路径
Windows	`%APPDATA%\Qoder\SharedClientCache\extension\local\mcp.json`
macOS	`~/Library/Application Support/Qoder/SharedClientCache/projects/<项目>/mcps/`

⚠️ 新增 MCP 服务器后必须重启 Qoder 客户端才能加载（实测陷阱）。

A.4.3 mcp.json 三种启动方式

jsonc

{
  "mcpServers": {
    // 方式 1：npx（Node 包）
    "stata-mcp": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/stata-mcp"]
    },
    // 方式 2：uvx（Python 包，需先 pip install uv）
    "faostat-mcp-server": {
      "command": "uvx",
      "args": ["faostat-mcp-server"]
    },
    // 方式 3：本地 exe / 脚本
    "officecli-mcp": {
      "command": "/Users/yourname/.local/bin/officecli",
      "args": ["mcp"]
    }
  }
}

CNKI 边界提醒（手册 v1.4 锁定）：本手册不展开 cnki-mcp 配置；中文文献请用知网网页自行检索，配合 Zotero jasminum 插件抓取元数据（见第 3 章 §3.5）。

农村金融业务及监管 2026 秋季 | AI 辅助金融研究学生自学手册

← 第 11 章 · 论文写作：学术风格与 AI 披露附录 B · S.X.Y 学术诚信检查点速查表（23 个） →

A.1 macOS 主线配置（教师机实测） ​

A.1.1 基础工具 ​

A.1.2 学术工具链 ​

A.1.3 macOS 一键自检脚本 ​

A.2 Windows 学生机配置（源 14 讲义口径） ​

A.2.1 基础工具 ​

A.2.2 与 macOS 的关键差异 ​

A.2.3 PowerShell 7 常用命令对照 ​

A.2.4 MiKTeX 中文 LaTeX 配置要点 ​

A.2.5 Windows 一键自检脚本（PowerShell 7） ​

A.2.6 Windows 排错速查（源 14 第十二部分精选 8 条） ​

A.3 标准研究文件夹结构（第 1.5/2.6 节配套） ​

A.4 MCP / Skill / CLI 三层范式速查（第 1.3c 节配套） ​

A.4.1 三范式五维对比 ​

A.4.2 Qoder mcp.json 配置双平台路径 ​

A.4.3 mcp.json 三种启动方式 ​

A.1 macOS 主线配置（教师机实测）

A.1.1 基础工具

A.1.2 学术工具链

A.1.3 macOS 一键自检脚本

A.2 Windows 学生机配置（源 14 讲义口径）

A.2.1 基础工具

A.2.2 与 macOS 的关键差异

A.2.3 PowerShell 7 常用命令对照

A.2.4 MiKTeX 中文 LaTeX 配置要点

A.2.5 Windows 一键自检脚本（PowerShell 7）

A.2.6 Windows 排错速查（源 14 第十二部分精选 8 条）

A.3 标准研究文件夹结构（第 1.5/2.6 节配套）

A.4 MCP / Skill / CLI 三层范式速查（第 1.3c 节配套）

A.4.1 三范式五维对比

A.4.2 Qoder mcp.json 配置双平台路径

A.4.3 mcp.json 三种启动方式