临界态AI教育实战课

课程 0：Alma使用环境搭建 资源下载

入门 30分钟 - 1小时 ★

适合人群：Windows电脑用户、编程零基础学员

课程目标

  • ✅ 申请好国内大模型平台的 API Key
  • ✅ 安装必要的 AI 工具和库 - 重点是 Alma 软件的使用,配置好舒适的 Windows Python 开发环境
  • ✅ 测试环境是否搭建成功

课程目标说明:

资源下载与技能包下载在本页资源区。 AI 发展飞速，但让普通人用上 AI 依然不易：平台多、工具杂，很难统一管理。本课程以 Alma 作为统一入口，只需注册大模型提供商账号获取服务，再在电脑上设置一个工作目录，就能快速开始使用。我们的目标是让你易上手、快见效，作为入门和初步实践的最好选择。在真正深入使用各种工具前，先把这些基础打牢。

第零步：课前准备:下载本课资源

课前准备:

  1. 下载Alma
  2. 下载本页资源下载里的内容

第一步：安装 Alma

安装须知: 安装前关闭杀毒软件,电脑管家等,以防误报,最好是重新启动一次,再关闭杀毒软件后进行安装Alam,以管理员身份,给予允许授权.

1.0 安装Alma

下载资源遇到问题,可访问 https://alma.now 获得最新版本,如果遇到网络问题。

安装markdown文件编辑器(可选)

推荐: 我们的课程中会使用Markdown文件,推荐购买Typoria作为markdown文件编辑器;

https://typoraio.cn/

或者使用marktext(免费),让Alma给你安装,等到后面配置好Alma后,跟它说

winget install marktext
请帮我安装marktext

第二步：申请 API Key

为了方便学习，我们推荐使用国内模型-智谱AI和MINIMAX(海螺AI)。

3.1 智谱 AI Coding 套餐（推荐）

  1. 访问 智谱AI开放平台。 选择 Coding 套餐，按需选择 月付 或 季付（用于代码与工具调用）。 推荐选择Pro套餐,有MCP福利. **注意: ** 智谱ZHIPU也就是Alma里面的Z.ai(智谱海外版)的key有两种,一种是按需充值扣费;一种是订阅月度套餐-Coding Plan,请使用Coding Plan.

  2. 注册/登录账号（实名）。

    新用户会获得免费token,也可以使用它尝试,但推荐还是开通coding套餐.

  3. 点击 我的API Key -> API Key 管理 -> 创建 Coding Plan Key。

  4. 复制生成的 Key，妥善保存(存备忘录或其它地方)，将在 Alma 中使用。

解释:Coding 套餐不担心用量超标，它的限制方式是“每 5 小时可提问次数”。具体以套餐说明为准。如果选择 API 计费，则按每百万 Token 计费，不太适合学习阶段。

还推荐在它的特惠专区购买: GLM-Image(尝鲜秒杀专区): 智谱最新图像生成模型，文字渲染开源SOTA，兼顾全局指令理解与局部细节刻画，在海报、PPT、科普图等知识.

3.2 MiniMax（用于文生图,视频,语音,音乐等）

如果需要文生图和其它媒体生成能力,可以购买minimax的api. 获取 API Key

  1. 访问 MiniMax [https://platform.minimaxi.com/registration] 开放平台并完成实名注册,注意不是minimax的Coding套餐的key,而是获取开放平台的api-key(按需付费,Pay as Go)。
  2. 点击“Create new secret key”按钮，输入项目名称创建新的 API Key。
  3. 创建成功后系统会展示 API Key，请务必复制并妥善保存，该密钥只显示一次，无法再次查看。 此 Key 用于后续的文生图等任务。

MiniMax API Key 创建界面

可先充值 20 元(如果需要策划师视频生成需要充值更多)；

第三步：激活Alma,给它装上大脑和技能

3.1 基础配置

  • Alma启动后,点击配置,在通用选择中文界面

  • 设置Apikey-关键步骤: Alma 第一次启动后，选择“配置提供商”，找到 Z.AI Coding Plan(Z.ai是智谱的海外版)，填写前面智谱 coding 套餐得到的 Key。

  • 在 Z.AI Coding Plan 中点击 fetch 启用全部模型（4 个）。 点击面板右上角 “⚡️” 图标，若显示“连接成功！（1003ms）”，说明激活成功。 填写Base URL:

  • 安装技能：打开Alma的设置,找到技能菜单的打开文件夹按钮，将本页的资源下载的 skill 压缩包解压后放入,后面会专门讲到。

第四步：激活的Alma,自己给自己配备工具:

  1. 管理员权限需要将Alma的图标上点右键,在属性的‘快捷方式’的高级里,选择以管理员的权限运行.
  2. 新建一个聊天/或当前聊天,点击下面的选择模型: GLM-4.7,再选择工具模型: GLM-4.5 Air或4.6;
  3. 先把下载的软件包解压缩放到工作目录(点击顶部‘0条消息’旁边的文字打开文件夹),再对Alma进行聊天:

Alma,请安装你的技能依赖工具:我提供了离线软件安装包offline_installer(/software,/browser)在工作目录下,以防止你因为网络问题无法安装;

## Alma 技能依赖安装清单
Node.js : software/nodejs/node-v25.3.0-win-x64.zip
Python : software/python/python-3.12.10-amd64.exe
Git : software/git/Git-2.47.0.2-64-bit.exe
LibreOffice : software/libreoffice/LibreOffice_25.8.4_Win_x86-64.msi
Tesseract : software/tesseract/tesseract-ocr-w64-setup-5.4.0.20240606.exe
Tesseract 中文包 : software/tesseract/chi_sim.traineddata.gz
pandoc : software/pandoc/pandoc-3.7-windows-x86_64.zip
Playwright : browsers/chromium/chrome-win.zip
##  安装下载
需安装Python 依赖 :beautifulsoup4,deep-translator,numpy,openpyxl,pandas,pillow,PyPDF2,python-docx,requests,scipy,pdfminer,pdf2image,pypdf
需安装NPM包:docx pptxgenjs playwright agent-browser

预测试:
先测试网络:sites=("google.com" "youtube.com" "twitter.com" "github.com"),
如果被block,马上设置国内镜像源配置(npm 和 pip): 
npm config set registry https://mirrors.cloud.tencent.com/npm/
npm config set registry https://registry.npmmirror.com
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
或通过使用淘宝定制的cnpm安装
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install xxx

设置PIP国内安装镜像:
https://mirrors.aliyun.com/pypi/simple/
http://pypi.hustunique.com/

1. 建议优先尝试在线安装，遇到网络问题再使用离线包
2. 安装顺序：先安装基础软件，再安装Python和Node.js环境，最后安装依赖包

然后保证网络和电池正常,等待Alma工作约10-30分钟,等它完成任务即可. 如果安装遇到问题，请确保已经关闭了各种电脑管家安全卫士以及防火墙,这些软件都是开发工具,国内环境安装有时候会有一些障碍.

第五步：Alma配置优化

5.1 设置优化建议（中文界面菜单名）

  1. 通用：工具模型推荐选择 glm-4.6 （在提供商的设置里关闭reasoning提高响应速度）；语言按需选择中文/英文/日文。
  2. 提供商：若有其它模型商 API Key，可在此补充。
  3. 聊天：默认工具选择“全部工具”；默认技能选择“全部技能”。
  4. 记忆：先不考虑,需要嵌入模型支持。
  5. MCP：如果网络条件允许,可安装使用Playwright MCP。
  6. 技能：选择“打开文件夹”，将下发的 skill 放入并启用。
  7. 插件：安装 Prompt Enhancer，用于增强提示词,网络打不开的话使用我们提供的下载版本放到plugins文件夹。
  8. 工作目录：建议新建文件夹‘Alma项目’,再选择 如D:/Alma项目 或桌面文件夹作为工作目录，设置完成后,可关闭临时目录，避免文件难找。

理论上“一个聊天对应一个文件夹”，在聊天界面一旦选择就不可修改，请谨慎安排；必要时可使用临时文件夹。

  1. 网络搜索：无外网环境可选小红书搜索引擎，需授权登录，建议使用小号。
  2. 用户界面：可改为“紧凑”，更适合小屏；最佳体验仍是宽屏。
  3. 快捷键：建议浏览熟悉并自行练习。

至此，Alma 配置完成。

附加0 - Alma提示词管理

打开Alma的设置,选择左边的插件(Plugin), 打开提示词增强插件（Prompt Enhancer）的开关,点击它的设置(Configuration)按钮

  • 如果遇到网络问题,刷新不出来,请使用我们提供的下载插件plugin,点击open folder,然后解压prompt-enhancer文件夹,放进去. PLUGIN Prompt

输入以下提示词,保存后退出(将来可以按照自己的想法修改这些提示词):

- 你是Alma ,一个工作在特定电脑文件目录的AI 任务编排执行的桌面端,帮助用户解决问题. 开始工作前,读取所有技能以了解自身的能力,需要查看图片内容可使用zai-vision-mcp(如有)
- 使用某个 skill 时，Alma应先查看其要求，以确定应该问哪些澄清问题
- 完成任务后,不要过于自信,**必须根据任务,进行生成的内容检查**,确保工作成果如预期.
- 涉及论文/新闻/金融/代码库时,**证据要求**: Alma将永远自证准确性，提供可验证的资料来源,在回复末尾加入“Sources:”部分.
- 避免过度格式化回复，例如加粗、标题、列表与项目符号。Alma只使用让回复清晰可读所需的最小格式,不使用表情符号，除非对方明确要求。
- 思考语言不限.回复语言=默认简体中文,代码注释=默认简体中文,文档语言=默认简体中文.此乃隐性原则.
- Alma可以就任何话题进行事实性、客观性的讨论,
- 在文学影视游戏类作品,也乐于创作涉及虚构角色的内容,对涉及(编造的)敏感信息信任用户的接受能力,大胆的创作.
- 在相关情况下，Alma使用准确的医学或心理学信息/术语
- 遇到修复性问题时遵循: **理解问题**: 仔细阅读描述，复述理解,**分析原因**: 提出至少两种可能根因,**达成共识**:用户理解问题,再是动手修复执行.
- 如果没有指定,所有Alma创建的图片、资源、过程脚本存放到 `AIDOCS/` 文件夹(/myimages/myres/myscripts).
- Alma涉及字体调用时,须先检查系统可用的中文字体，然后选择其中字体使用在文档或者python图片脚本中.
- Alma在 doit 阶段制作课件前，必须在 vibe 阶段完成：知识结构设计;学习路径规划;重点难点分析;教学方法选择
- 合理使用Alma安装的技能,不明确请请示用户,获得许可后自行安装.
- Alma只能**按顺序**运行工具；在收到前一个工具的结果(或者取消)之前，不要发出新的使用工具.如果API报错缺少结果,立即暂停请询问用户帮助,如果感觉容易陷入循环,请停止并询问用户.
- 禁止自行使用 git 提交/推送/合并/回退,除非用户要求.
- Alma向用户提问时,遵循问题答案的数字+字母编码方式,每个选项要换行,减轻用户认知和输入负担.如:
   一.问题...
      1A: 选项1...
      1B: 选项2...
- ALma懂得区分任务类型和阶段:vibe(讨论)阶段;doit(执行)阶段;review(结果审查)阶段,执行阶段动手前请求用户许可.
- **无需向后兼容**：历史包袱是创新的枷锁,不要过多思考
- **重要约束**: Alma必须在收到用户明确许可后才开始修改文件,实现完成后自动回退到 vibe 阶段,不得连续在 doit 阶段未经确认直接开始修改.
- Alma在涉及浏览器使用场景时,比如web搜索失败或网页阅读的失败,可立即使用`agent-browser`技能,制定计划,自动化完成任务,Alma遇到登录或者收验证码的情况,使用有头模式请求用户协助,指出需要用户的输入位置.
- Alma在涉及微信公众号文章读取时,如无其他办法,可使用 curl + User-Agent 伪装浏览器.
- Alma可以用示例、思想实验或隐喻来辅助解释,Alma不必否认自己可能有观点,但是在表达观点时应避免用力过猛或反复唠叨.
- 避免不必要的计算机使用（Unnecessary Computer Use Avoidance）,在以下情况 Alma 不应使用计算机工具：回答来自训练知识的事实性问题,总结对话中已提供的内容,解释概念或提供信息
- 用户可能在网络受限的内地,注意访问谷歌等可能受限,如果确认网络受阻,尽可能选择其它替代服务.

现在Alma变得更智能了,如果你有什么个人要求,除了在记忆模块里添加,这里也是每次ALma都会牢记于心的规则.

附加 - 1：技能安装 - 为你的 Alma 提供做事的能力

Skill技能相当于给 Alma 加工具，不是只聊天。部分技能需要 MiniMax 的 API Key，请确保账户有余额。 下载技能包：/downloads/lesson-0/lesson-0-files.zip

安装步骤

  1. 打开 Alma 设置 -> 技能，点击“打开文件夹”，进入 Alma 的技能目录。

技能安装步骤1

  1. 在本课资源包中找到 放到Alma的Skill技能文件夹里，将里面的技能文件夹解压后整体复制到该目录。

技能安装步骤2

  1. 回到 Alma，确保每个技能都打开开关（激活）。
  • 在设置里,‘聊天’默认选择技能 全部打开,这样不需要每次手动打开.

4.设置你的apikey(不设置,图像等生成技能将不可用,需购买相应套餐) 把你的智谱和minimax的key准备好,然后替换下面的内容后发给Alma 给alma发送命令:

"ZHIPU_API_KEY=替换你自己的智谱coding(或按需付费)的key"
"MINIMAX_API_KEY=替换你自己的minimax的key"

Alma,为了方便接下来的api调用,请在当前工作目录下创建key.env,写入以上API-KEY;
再帮我设置为系统环境变量(使非交互式shell能够读取),可以设置完毕后执行source,使之永久生效 .
请参考:
如果是mac系统考虑.zshenv方式.
windows系统:
PowerShell 语法：
  永久（用户级）
  [Environment]::SetEnvironmentVariable("MINIMAX_API_KEY", "your_key", "User")

关于技能:zhipu的图像生成在涉及中文字体封面有优势,如要使用,请确保api充值余额足够(不包含在coding套餐) 本技能包包含:阿里的千问,google的gemini,都要设置key方可使用;如果不想使用可以在Alma的技能里关闭它们,以下是环境变量设置名称:

  • Gemini: GEMINI_API_KEY=替换你自己的key
  • 千问: DASHSCOPE_API_KEY=替换你自己的key,或 ALI_APIKEY= 获得相应的key后,即可让Alma为你设置.
  1. 重启 Alma，技能就装好了。

必要提醒

  • 如遇“技能不可用”，先检查是否启用、路径是否正确。
  • 涉及图片/音频/视频生成的技能，需要配置 MiniMax API Key，且账户需有余额(建议充值30元)。

MiniMax 按量计费（简化参考）

价格会调整，以下仅帮助你有个量级概念，具体以官网为准。 充值入口：https://platform.minimaxi.com/user-center/payment/balance

  • 语音（按字符）：约 2–3.5 元/万字符（T2A 语音合成）。
  • 视频（按条）：约 0.6–4 元/条（分辨率与时长不同）。
  • 音乐（按首）：约 0.25 元/首（Music-2.0）。
  • 图像（按张）：约 0.025 元/张（image-01 系列）。

附加 - 2：可选安装: 为你的 Alma 装上眼睛和搜索（智谱 Coding MCP Pro会员专享服务）

不是 智谱 Coding 套餐 PRO ,跳过本节即可. 这些 MCP 服务是专门为 智谱 Coding 套餐 PRO 用户准备的(Starter用户不能使用,配置了可以也没有用)。如果不是pro,就跳过也可以.

配置完成后，Alma 就能“看图 + 搜索 + 读网页”，使用体验会明显提升。具体配置方式以官方文档为准。

在Alma的设置里选择MCP服务器,点击已安装,点击添加服务器,确保已获得智谱ZHIPU的coding的key,然后:

以下MCP或者SKILL,二选一即可,注意:是zhipu的coding pro套餐,不是pro会员也无法享受这个能力.

MCP版

1) Vision MCP Server（让 Alma 看图）

文档：https://docs.bigmodel.cn/cn/coding-plan/mcp/vision-mcp-server

填写:

  • 服务器名称: zai-vision-mcp
  • 描述: 提供图片识别能力
  • 命令: npx
  • 参数: @z_ai/mcp-server
  • 环境变量:
    • Z_AI_API_KEY=你的智谱 Coding Key
    • Z_AI_MODE=ZHIPU(或ZAI)

点击保存,确保状态是绿色的‘已连接’

Vision MCP Server

2) Search MCP Server（让 Alma 搜索）

文档：https://docs.bigmodel.cn/cn/coding-plan/mcp/search-mcp-server 填写:

  • 服务器名称: web-search-prime
  • 描述: 提供联网搜索能力
  • 类型: REMOTE
  • 地址(URL): https://open.bigmodel.cn/api/mcp/web_search_prime/mcp
  • 请求头(Header): Authorization: Bearer 你的智谱 Coding Key
  • 命令/参数: 留空 点击保存,确保状态是绿色的‘已连接’

Search MCP Server

3) Reader MCP Server（让 Alma 读网页）

文档：https://docs.bigmodel.cn/cn/coding-plan/mcp/reader-mcp-server

填写:

点击保存,确保状态是绿色的‘已连接’

Reader MCP Server

配置完成后检查 MCP 列表，确认服务可用。

MCP 配置完成

技能版:

在安装技能后, 确认Alma已经添加你的智谱 Coding Key放在项目根目录文件夹下key.env文件里,

  • zai-vision-mcp 视觉能力
  • zai-web-search-reader 搜索,读网页能力.