安全提醒：
Agent 会把经过处理的用户请求和必要的工具结果发送到配置的模型服务。请使用你自己的 API Key，并不要输入未脱敏的密码、私钥或业务机密。
一、准备环境
Python
安装 Python 3.11 或更高版本，并在安装时勾选 Add Python to PATH。
Git
用于从 GitHub 获取项目代码。也可以下载 ZIP 压缩包，但 Git 更方便升级。
模型 API
准备一个兼容的模型服务 API Key，例如 DeepSeek 或其他 OpenAI 兼容服务。
二、安装 Agent
1
安装 pipx
pipx 会为命令行工具创建独立环境，不会污染系统 Python。
python -m pip install --user pipx
python -m pipx ensurepath
2
重新打开 PowerShell
让刚加入 PATH 的 pipx 命令生效。
3
从 GitHub 安装
pipx install https://github.com/zhaoge-99/liuzhengzheng-agent.git三、配置模型服务
下面以 DeepSeek 为例。请把 API Key 替换成你自己的值，不要把 Key 提交到 GitHub。
MODEL_PROVIDER 可选值：
openai-compatible 用于 DeepSeek、OpenAI 以及其他兼容 OpenAI API 的服务；
anthropic 用于 Anthropic Claude；
gemini 用于 Google Gemini。
选择的 Provider 必须与对应的 API 地址和模型名称匹配。
[Environment]::SetEnvironmentVariable("MODEL_PROVIDER", "openai-compatible", "User")[Environment]::SetEnvironmentVariable("MODEL_API_KEY", "你的API Key", "User")[Environment]::SetEnvironmentVariable("MODEL_NAME", "deepseek-chat", "User")[Environment]::SetEnvironmentVariable("MODEL_BASE_URL", "https://api.deepseek.com", "User")配置完成后请关闭并重新打开终端。也可以把配置写入项目的 .env 文件，但真实的 .env 不应提交到 Git。
四、启动和第一次对话
aiden看到启动提示后，直接输入问题，例如：
你好，请介绍一下 Python 的环境变量退出程序：输入 /q、/quit 或按 Ctrl+C。
五、常用命令
/help显示帮助信息。
/workspace查看当前工作区。
/status查看 Agent 状态。
/tasks查看未完成任务。
/clear清空当前对话。
/q退出 Agent。
六、让 Agent 修改代码
- 描述要修改的文件和目标。
- Agent 先生成补丁并预览变更。
- Agent 校验补丁，等待你在终端确认。
- 确认后才会应用修改。
- 应用后自动进行语法检查和质量验证。
- 验证失败时会报告原因，并尝试回滚补丁。
不要把工具参数中的 confirm=true 当作用户授权；真正的写操作必须经过终端确认。
七、升级、卸载和故障排查
升级到 GitHub 最新版本
pipx upgrade aiden-agent卸载
pipx uninstall aiden-agent常见问题
- 提示未配置 API Key：关闭终端后重新打开，确认变量名是
MODEL_API_KEY。 - 网络连接失败：检查
MODEL_BASE_URL、代理和模型服务是否可访问。 - 模型不存在：把
MODEL_NAME改为服务商账户实际支持的模型名称。 - 命令找不到：重新运行
python -m pipx ensurepath并重启终端。
项目地址
源码、更新说明和安全审查文档都在仓库中。