主流 Agent 入门教程 / MiniMax Code

2. 贯穿项目-habitlog

本篇目录 · 11 节

来源：MiniMax Code

这一章不写一行命令，只回答两个问题：贯穿整套教程的项目是什么、为什么选它、以及你需要提前准备好什么工具。
学完这一章，你会知道接下来 12 章要一步步搭出来的 habitlog 长什么样。

2.1 项目是什么

我们要做的项目叫 habitlog：一个命令行下的个人习惯打卡工具。

想象一下：你最近想坚持"每天读书 30 分钟"和"每周跑步 3 次"。你不想装一个臃肿的手机 App，只想在终端里敲两行命令就能：

数据全部存在本地的 JSON 文件里，不需要联网。

到教程结束时，habitlog 会提供四个子命令：

存储位置：~/.habitlog/data.json，一个普通文本文件，你可以随时打开看。

测试框架：pytest（Python 最常用的测试工具）。

挑项目有讲究，它要满足这些条件：

habitlog 满足全部条件，而且它的功能边界刚好能把 CLI 的核心能力一条线串完：

教程过程中会用到的工具，越早装好越省事。这一节只列出"是什么"和"在哪装"，具体怎么装等第 3 章讲 MiniMax Code CLI 时一起处理。

habitlog 用 Python 写。你需要：

macOS：brew install python@3.11（如果你装了 Homebrew），或去 python.org 下安装包
Linux：通常系统自带；版本低于 3.10 时用包管理器装新版
Windows WSL2：在 Ubuntu 里 sudo apt update && sudo apt install python3 python3-pip
Windows PowerShell：去 python.org 下安装包，安装时勾选 "Add Python to PATH"

装好后验证：

python3 --version

预期看到 Python 3.10.x 或更高版本。

habitlog 是个本地项目，但我们会从头到尾用 git 管理版本。

装好后配置一下身份（这是每台机器只需要做一次的全局配置）：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

CLI 部分不需要编辑器，但阅读 AGENTS.md、看 diff（差异对比）、提交代码时有个编辑器更舒服。VS Code、Sublime Text、JetBrains 任意一个都行。

安装 CLI 需要访问 filecdn.minimax.chat。如果你的网络有限制，先确认能打开这个域名。

教程默认你把项目放在家目录下的 projects/habitlog：

如果你想放别的地方也可以，只要后续章节里的命令里把路径替换掉就行。

下面这些功能 habitlog 不会做，避免你怀疑教程是不是漏了什么：

这些功能等你自己熟悉了之后可以再扩展。教程的重点是用 habitlog 把 CLI 能力练一遍。

下一章我们正式装 MiniMax Code CLI，并且区分 macOS / Linux / Windows WSL2 / Windows PowerShell 四种环境给出完整命令。