THU CyberCraze代理
由THU实验室代理(OpenAI-compatible API)提供支持的交互式终端编码代理。它在当前终端中运行,在当前目录中工作,可以检查文件,提出shell命令,并在运行之前等待您的批准。
1.安装
1.1获取API密钥
在此处创建密钥:
https://lab.cs.tsinghua.edu.cn/ai-platform/c/new基本URL:
https://lab.cs.tsinghua.edu.cn/ai-platform/api/v1设置环境变量:
export THU_LAB_PROXY_API_KEY='your_proxy_key_here'
export THU_LAB_PROXY_BASE_URL='https://lab.cs.tsinghua.edu.cn/ai-platform/api/v1'Windows PowerShell:
$env:THU_LAB_PROXY_API_KEY='your_proxy_key_here'
$env:THU_LAB_PROXY_BASE_URL='https://lab.cs.tsinghua.edu.cn/ai-platform/api/v1'您还可以启动代理并在提示时粘贴密钥。代理将其保存到每个用户的全局配置文件中:
- Linux和macOS:
~/.thu-cybercraze-agent/.env - 窗户:
%USERPROFILE%\.thu-cybercraze-agent\.env
1.2运行代理
Linux(内置二进制):
./dist/thu-agentWindows(基于Windows构建):
.\dist\thu-agent.exemacOS(直接运行Python):
python3 agent.py1.3构建二进制文件(如果需要)
Linux版本:
bash build_agent.sh结果:
dist/thu-agentWindows内部版本(在Windows上运行,而不是在WSL中运行):
py -3 -m pip install pyinstaller
powershell -ExecutionPolicy Bypass -File .\build_agent_windows.ps1结果:
dist\thu-agent.exe1.4可选:全局运行
Linux:
sudo install -m 755 dist/thu-agent /usr/local/bin/thu-agentWindows:添加仓库 dist 目录到 PATH,或复制 .exe 已进入某个目录 PATH.
示例(PowerShell):
[Environment]::SetEnvironmentVariable(
"Path",
$env:Path + ";C:\Users\USER\Downloads\THU-deepseek-glm-api-mcp-server\dist",
"User"
)打开一个新终端并运行:
thu-agent.exe2.使用方法
启动代理:
./dist/thu-agent或者用Python运行:
python3 agent.py如果你愿意,可以直接传递模型和密钥:
python3 agent.py --model deepseek-v3.2 --api-key "$THU_LAB_PROXY_API_KEY"默认型号:
deepseek-v3.2当前型号:
qwen3-max-thinkingqwen3-maxglm-5glm-5-thinkingglm-4.7-thinkingkimi-k2.5kimi-k2.5-thinkingminimax-m2.5minimax-m2.5-thinkingqwen3.5-plusqwen3.5-plus-thinkingqwen3.5-minideepseek-v3.2-thinkingdeepseek-v3.2
当代理正在思考或运行命令时,按 Ctrl+C 打断。它将要求后续指示。类型 /stop 在那里放弃中断的转弯或键入新的指令继续。
3.功能列表
可用的Slash命令:
/help/save [name]/autosave/context/compact [keep]/clear/status- `/attach
[instruction]`
/stop/sessions/load/fork [new-name]/new [name]/delete/update/model/key/pwd/alwaysRun/exit
4.功能说明
会话和内存:
/save [name]将当前会话保存到磁盘。默认情况下,会话是手动保存的。/autosave切换此会话的自动保存。/sessions列出已保存的会话,包括ID、摘要和上次使用时间。/load加载已保存的会话。/fork [new-name]从已保存的会话创建新会话。/new [name]以新的上下文开始新的会话。/delete删除已保存的会话。
上下文管理:
/context刷新并显示启动上下文快照(日期、git状态、附近的内存文件,如AGENTS.md或CLAUDE.md)./compact [keep]总结旧消息并保留最近的消息以减少上下文大小。/clear清除内存中的对话,同时保留当前的项目上下文。/status显示版本、型号、会话名称、自动保存状态、消息计数和上下文大小。
命令和执行:
/alwaysRun切换shell命令的自动批准。/stop仅在中断提示后使用,以放弃中断的转弯。
附件:
/attach path/to/file.txt explain this file将小文本/代码文件内联到下一个模型中。- 非文本文件作为文件引用传递,供代理使用命令进行检查。
- 只有当所选模型/代理支持时,图像文件才能作为多模式内容发送,并且
THU_AGENT_MULTIMODAL=1已设置。否则,它们将被视为文件引用。
型号和按键:
/model重新选择模型(这将重置对话上下文)。/key更新API密钥并将其保存到全局.env.
更新:
- 在启动时,代理将其嵌入式版本与GitHub进行比较
VERSION文件,如果它落后了,会提醒你。 /update将GitHub仓库克隆到临时目录,重建二进制文件,将其安装到当前可执行路径(或/usr/local/bin/thu-agent在Linux上),然后删除临时克隆。在Windows上,它会在退出后替换正在运行的.exe.
其他:
/pwd打印当前工作目录。/help显示命令列表。/exit退出代理。
笔记:
- MCP服务器
server.py与中的交互代理分开agent.py.
