SWUFE 经管 AI 工具包

适用对象：通用 ｜ 状态：✅ 真机验证 ｜ 更新于：2026-06-01

这是什么（一句话）

SWUFE 经管 AI 工具包是一个一键安装器——跑一条命令，就把”读资料、改讲稿、做数据分析、生成课件、建资料库”所需的整套 AI 工具装到你自己的电脑上，并默认接好 DeepSeek。

本板块从这里开始

如果你只想装一套能用的环境、不想逐个工具研究，直接看这一页就够了。本板块其余各页（Claude Code、Codex、CC-Switch、NotebookLM）是对工具包里各个组件的展开说明，需要时再翻。

为什么 SWUFE 师生需要它

• 省去配置地狱：Node、Python、数据科学库、AI 入口、DeepSeek 接口……手动一个个装容易卡壳。工具包把这些顺序装好，装错了重跑一遍即可（脚本是幂等的，已装的自动跳过）。
• 默认接 DeepSeek，便宜：AI 的”大脑”用 DeepSeek，几块钱余额能用很久，适合自费的师生。
• 一套装齐：装完你同时拥有终端 AI 助手（Claude Code、Codex）、图形配置工具（CC-Switch）、资料库工具（NotebookLM），以及 25 个面向经管的 Skill（含计量、可视化、文献综述等专属技能）。

适合什么场景

• 第一次上手 AI、不想自己折腾安装的老师和学生
• 机房 / 无外网环境批量部署（有离线安装方式）
• 想要一个”读本地文件、动手帮你干活”的助手，而不是只能在网页里聊天的 AI

装了什么

类别	内容
三个 AI 入口	Claude Code（终端主力）、Codex（多一个选择）、CC-Switch（图形配置，不爱命令行的老师用）
大脑（API）	DeepSeek——Claude Code 与 Codex 默认指向它（Key 自备）
资料库工具	NotebookLM（建带引用的资料库、检索式问答、信息提取；用 Google 账号，与 DeepSeek 无关）
基础环境	Git、Node.js、Python3、Miniconda
数据科学包	pandas、numpy、matplotlib、scipy、openpyxl、jupyter、markitdown 等
推荐 Skills	25 个（含 NotebookLM + 5 个经管专属：计量 Stata、经管可视化、文献综述、问卷分析、教学案例）
其他工具	VSCode + 插件、pandoc、jq、ffmpeg 等

各入口的展开说明：Claude Code、Codex CLI、CC-Switch、NotebookLM。

下载入口

工具包有两个版本，都部署在校内服务器 192.168.78.89：

版本	大小	适合	下载
在线版	约 1 MB	有网络的电脑（安装时自动联网拉取各工具，永远是最新）	swufe-econ-aikit.zip
离线版	约 1 GB	机房 / 无外网的 Mac（已打包好全部安装文件，免联网）	swufe-econ-aikit-offline.zip

需在校园网内下载

下载服务在校内服务器 192.168.78.89，请在校园网环境下访问（校外 / 在家访问不到；需要时先连学校 VPN）。

选哪个？

绝大多数人用在线版——小、快，安装时自动从网上拉取最新工具。只有机房、无外网的 Mac 才用离线版：约 1 GB，已含 macOS 双架构（Apple Silicon + Intel）的全部安装文件。注意离线版不含 NotebookLM，且 Xcode 命令行工具仍需在目标机上单独装一次（系统会提示）。

下载后解压，会得到一个名为 swufe-econ-aikit 的文件夹。把它放到桌面（或任意你记得住的位置），然后按下面对应你系统的步骤安装。

直接下载安装脚本（单文件）

只想取某个安装脚本（查看内容、或在已有工具包文件夹里替换更新）时，可直接下载（校园网内）：

脚本	用途	下载
install_ai_tools.sh	macOS 安装入口（自动识别芯片架构）	下载
install_ai_tools_arm64.sh	macOS Apple Silicon 安装	下载
install_ai_tools_x86_64.sh	macOS Intel 安装	下载
install_ai_tools_windows.ps1	Windows 安装（PowerShell）	下载
download_tools.sh	自己生成 macOS 离线包（高级）	下载

单独脚本不含 Skills

正式安装请用上面的工具包压缩包。 安装脚本需要同目录下的 recommended_skills/ 文件夹才能装上 25 个 Skill；单独下载的脚本会跳过这一步（其余工具仍正常安装）。单文件适合查看内容或在已有工具包文件夹里替换更新。

安装

安装分三种情况，对号入座选一种即可。三种方式中途都会问你要不要现在填 DeepSeek Key——可以现在填，也可以直接回车跳过，装完再补（见下方”配置 / 补填 DeepSeek Key”）。

先准备一把 DeepSeek API Key：到 platform.deepseek.com 注册登录 → 在「API Keys」里创建一把 → 充一点点余额。Key 只在创建时完整显示一次，立刻复制保存好。官方文档：api-docs.deepseek.com/zh-cn。

macOS 在线安装（推荐）

1. 打开「终端」应用（启动台 → 其他 → 终端，或聚焦搜索 Terminal）。
2. 进入工具包目录：在终端输入 cd （cd 后面有个空格），把工具包文件夹拖进终端窗口，回车。
3. 运行安装脚本：

./install_ai_tools.sh

脚本会自动判断你的 Mac 是 Apple Silicon 还是 Intel，逐步安装。

不确定要不要装？先预览

先跑一次预览模式，只看会装什么、不真动手，心里有数再正式装：

./install_ai_tools.sh --dry-run

Windows 安装

1. 把工具包文件夹放到电脑上（如桌面）。
2. 确认有 winget（也叫「应用安装程序 / App Installer」，Win10/11 一般自带；没有就去 Microsoft Store 搜「应用安装程序」更新）。
3. 在工具包文件夹里右键 → 在终端中打开，运行：

.\install_ai_tools_windows.ps1

如果提示脚本被禁止运行，先执行下面这条解锁（只对当前窗口有效），再跑一次安装命令：

Set-ExecutionPolicy -Scope Process Bypass

Windows 脚本待真机验证

Windows 安装脚本尚未在真实 Windows 机器上跑过完整安装。首次强烈建议先加 -DryRun 预览，确认无误再正式装：.\install_ai_tools_windows.ps1 -DryRun

macOS 离线安装（机房 / 无外网）

最省事：直接用上面的「离线版」。 下载 swufe-econ-aikit-offline.zip → 解压 → 把整个文件夹拷到目标机（U 盘 / AirDrop）→ 在目标机上运行：

# 在「目标机」上，进入工具包目录，运行离线安装（无需联网）
./apps/install_ai_tools_offline.sh

如果你想自己打离线包（比如要更新版本），也可以在一台能上网的 Mac 上自己生成，再拷到目标机：

./download_tools.sh          # 下载离线资源到 apps/（约 1 GB，双架构）
# 然后把整个文件夹拷到目标机，运行 ./apps/install_ai_tools_offline.sh

注意

离线版不含 NotebookLM 技能。如果目标机以后能短暂联网，补一句 pip install "notebooklm-py[browser]" 即可。

第一次怎么用

第一步：重开终端

安装会改一些配置。关掉刚才的终端窗口，重新开一个，配置才生效。这一步能解决九成”明明装了却说找不到命令”的问题。

第二步：启动主力助手

在新终端里输入：

claude

第一次会有引导界面，进去后就能用中文跟它对话了。想试第二个助手，输入 codex。

安全的第一句话

AI 助手能直接读写你电脑里的文件。第一次用、还不放心时，第一句话就先划界限：

请先只阅读和分析，不要修改或删除任何文件。先告诉我你看到了什么、打算怎么做，等我确认后再动手。

它会先汇报思路，等你点头再动手，安全又可控。

第三步（可选）：登录 NotebookLM

打算建资料库时才需要，用 Google 账号登录（与 DeepSeek 无关）：

notebooklm login

配置 / 补填 DeepSeek Key

安装时回车跳过了 Key，或想换一把新 Key，按这里补。两个助手走 DeepSeek 的两个不同入口，所以要配两处。

Claude Code（走 Anthropic 兼容端点）——编辑 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json），把 env 段改成：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek Key>",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash"
  }
}

Codex（走 OpenAI 兼容端点）——端点配置安装脚本已写好（~/.codex/config.toml 里的 deepseek provider，wire_api = "chat"，端点 https://api.deepseek.com，末尾不加 /v1），你只需补一个环境变量：

# macOS：加到 ~/.zshrc 末尾，保存后重开终端
export DEEPSEEK_API_KEY="sk-你的真实Key"

Windows 则在「设置 → 系统 → 关于 → 高级系统设置 → 环境变量」里新建用户变量 DEEPSEEK_API_KEY，值填你的 Key，重开 PowerShell 生效。

模型名以官方为准

deepseek-v4-pro / deepseek-v4-flash 的名称以 DeepSeek 官方文档为准，若报”模型不存在”请到 官方文档 查最新名称。

与其他工具的关系

工具包是容器，里面装的就是本板块其余各页讲的工具：

• 终端主力 → Claude Code
• 多一个选择 → Codex CLI
• 不爱命令行、想点鼠标配 Key → CC-Switch
• 建带引用的资料库、检索式问答 → NotebookLM

账号与费用

• DeepSeek：师生自行申请、自行充值。很便宜，几块钱够用很久。
• NotebookLM：用 Google 账号，免费额度通常够用，与 DeepSeek 互不相干、不花 DeepSeek 的钱。
• 工具包本身免费。

🔒 数据与合规提醒

联网的 AI 会把你给它的内容发到外部服务器。学生个人信息 / 成绩、未发表论文、基金本子、访谈隐私材料等，处理前先确认是否符合学校数据安全与科研伦理规定，拿不准就不放。 API Key 不截图、不群发、不进任何仓库。详见 伦理与检查点。

官方链接

工具包本身的来源（开源仓库）

• SWUFE 经管 AI 工具包（本包）：https://github.com/oMygpt/swufeaitools
• 上游项目：https://github.com/Xueheng-Li/ai-tools-installation

工具包内各组件的官方站 / 仓库

• Claude Code 官方文档：https://code.claude.com/docs （旧域名 docs.anthropic.com / docs.claude.com 会跳转至此，以官方为准）
• Codex（OpenAI 官方）：https://developers.openai.com/codex/ ；GitHub：https://github.com/openai/codex
• CC-Switch：https://github.com/farion1231/cc-switch
• NotebookLM 产品：https://notebooklm.google.com/ ；本包所用 CLI notebooklm-py：https://github.com/teng-lin/notebooklm-py ，PyPI：https://pypi.org/project/notebooklm-py/
• DeepSeek 官网：https://www.deepseek.com/ ；开放平台：https://platform.deepseek.com/ ；API 文档：https://api-docs.deepseek.com/zh-cn/
• Homebrew（macOS 包管理器）：https://brew.sh/
• VSCode：https://code.visualstudio.com/
• Miniconda：https://docs.anaconda.com/miniconda/
• uv（Python 包管理器）：https://github.com/astral-sh/uv
• winget（应用安装程序 / App Installer）：https://aka.ms/getwinget

状态徽标

✅ 真机验证（macOS 在线安装已验证；Windows 脚本 ⚠️ 待真机验证；模型名 ⚠️ 以官方为准）