用了大半个月的 AgentDock 让 GPT 帮我干活,记录一下实际体验。
先说结论:AgentDock 好用,但网页版 GPT 是真的只能算入门水平。
为什么想用 AgentDock
一直以来我都是直接开网页版 ChatGPT 写代码、改配置、查问题。用着用着就烦了:
- 每次都要把项目背景重新讲一遍
- 改一个文件,要手动复制粘贴来回倒腾
- 让它读文件,得自己贴内容,贴多了它说超长
- 关掉页面,上下文全没了
AgentDock 解决的就是这批问题——它给我一个能真正「动手」的入口,而不是只会在对话框里说「你可以这样改」。
安装方式
AgentDock 是开源的(Apache-2.0),地址在 uvwt/agentdock。它本质是一个 MCP 工具运行层——装在你要控制的那台机器上,然后由 ChatGPT / Claude / Codex 这类支持 MCP 的客户端连过来。
四种安装方式,按平台选:
| 平台 | 方式 |
|---|---|
| macOS | 官方图形安装包 |
| Windows | 图形安装程序 |
| Linux / VPS | 一键脚本(自动配 systemd) |
| 任意平台 | Docker Compose |
Linux 一键安装(我用的这个)
curl -fsSL https://download.nexusdock.co/latest/install.sh \
-o /tmp/install-agentdock.sh
sudo sh /tmp/install-agentdock.sh
脚本会自己做完这些事:检测 systemd 还是 OpenRC、创建低权限运行用户、生成 Bearer Token、启动服务、跑健康检查。
验证:
sudo systemctl status agentdock --no-pager
curl -fsS http://127.0.0.1:8765/healthz
返回里有 "ok": true 就成了。
取 Token(后面连接客户端要用):
sudo awk -F= '/^AGENTDOCK_AUTH_TOKEN=/{print $2}' \
/etc/agentdock/agentdock.env
这个 Token 存到密码管理器里,别贴到截图、Issue 或公开对话里。
Docker 安装
mkdir -p agentdock && cd agentdock
curl -fL https://raw.githubusercontent.com/uvwt/agentdock/main/docker-compose.yml \
-o docker-compose.yml
printf 'AGENTDOCK_AUTH_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose ps
等到状态显示 healthy 就行(首次会先拉镜像)。
Docker 跑不了 macOS 桌面自动化,需要控制桌面的话得用原生安装包。
连接客户端
装完之后,在客户端的 MCP / Tools / Connectors 设置里加一条连接:
Transport Streamable HTTP
URL http://127.0.0.1:8765/mcp
Headers Authorization: Bearer <你的 token>
JSON 写法大致是这样:
{
"mcpServers": {
"agentdock": {
"url": "http://127.0.0.1:8765/mcp",
"headers": {
"Authorization": "Bearer <AGENTDOCK_AUTH_TOKEN>"
}
}
}
}
要让网页版 ChatGPT 连过来
本地 127.0.0.1 只能本机访问。ChatGPT 在云端,够不到你的 localhost,所以得有个公网地址。两种办法:
临时地址(测试用)
docker compose --profile cloudflare-quick up -d
docker compose logs -f cloudflared-quick
日志里会出一个 https://xxx.trycloudflare.com,在客户端里填这个地址加 /mcp。这个地址重启就变,只适合临时测试。
固定域名(长期用)
需要在 Cloudflare 里配好域名和 Tunnel,然后重新跑一次交互式安装:
sudo sh /tmp/install-agentdock.sh
脚本会问有没有 Cloudflare 域名,填进去就行。
公网访问必须开认证。 别把没鉴权的 MCP 服务暴露在公网上——那等于把你的机器交给任何人。
升级
Linux:
sudo /opt/agentdock/bin/agentdock update --check
sudo /opt/agentdock/bin/agentdock update
Docker:
docker compose pull
docker compose up -d --force-recreate
任务、Skills、配置、工作目录都会保留。
实际怎么用的
我的场景比较典型:一个 SvelteKit 博客 + Cloudflare Worker 后端,本地有完整仓库。
场景一:让它读代码再动手
以前:
我把
vite.config.ts整个贴进去,说「帮我加个配置」
现在:
「看一下 sveltekit/vite.config.ts,把 prerender 的 handleUnseenRoutes 加上」
它会自己读文件、找到位置、改完给我看 diff。不用我复制,也不会改错地方。
场景二:批量排查
博客的 SEO 标签要逐个核对。手动做得开十几个文件对照。
我直接说:「检查所有页面的 canonical 是不是都带尾斜杠」,它跑一遍给出结论和问题清单。
这类需要遍历、需要对照的活儿,人做很累,AgentDock 干得又快又准。
场景三:部署和验证
改完代码要部署。以前是我自己敲命令、看输出、再去浏览器刷新验证。
现在一句「部署到 Pages 然后验证首页和文章页」,它从构建、部署到用无头浏览器截图验证,一条龙走完。
这是我觉得最值的地方——不是它多聪明,而是它把「改完到确认生效」这段繁琐流程自动化了。
好用在哪
1. 不用重复交代背景
它能自己读仓库。项目结构、技术栈、命名习惯,看一眼就明白,不用我每次重讲。
2. 能真正执行
网页版 GPT 最大的问题是只能输出文本。它说「你可以在终端运行这条命令」,然后呢?我还是得自己复制到终端。
AgentDock 能直接跑命令、看结果、根据结果调整。这个差别很大。
3. 上下文不会断
关掉再回来,项目状态还在。不用从头解释「我们刚才说到哪了」。
4. 复杂任务能拆解
像「重构文章页布局」这种事,涉及模板、样式、组件多个文件。它能自己拆成步骤,一步步做完再汇报。
但网页版 GPT 是真的区
用了 AgentDock 之后,我反而更清楚地看到网页版 GPT 的天花板在哪。
它只是「够用」的水平
网页版能干什么?
- 回答一般性问题
- 写几十行的独立代码片段
- 解释概念
- 改一小段文本
这些它做得不错。但一旦进入真实项目:
| 场景 | 网页版 GPT | AgentDock |
|---|---|---|
| 读 20 个文件找问题 | ❌ 只能一个个贴 | ✅ 自己遍历 |
| 改完代码跑测试 | ❌ 做不到 | ✅ 直接执行 |
| 部署后验证 | ❌ 做不到 | ✅ 一条龙 |
| 记住上次的改动 | ❌ 关页面就忘 | ✅ 上下文连续 |
| 多步骤任务 | ⚠️ 需要我盯着催 | ✅ 自己拆解推进 |
网页版就是一个能聊天的文本框,它的能力上限被「只能输出文本」死死卡住。
最典型的差距
我让它改代码,网页版会说:
请将第 42 行的
foo改成bar,然后运行npm run build验证。
AgentDock 会说:
已修改
src/index.js第 42 行,构建通过,部署完成,首页返回 200。
前者我还要干活,后者我只需要确认。
这不是模型能力的差距,是「能不能动手」的差距。
几个踩过的坑
坑一:它会自己加戏
有次我说「优化一下布局」,它顺手改了三个不相关的文件。回滚重来。
经验:指令要具体,「只改 X 文件里的 Y 逻辑」比「优化布局」好得多。
坑二:看起来对但其实是错的
它改完说「已修复」,我一测还是不行。这种情况通常是它验证方式不对——比如只看了 HTTP 状态码 200,没看响应正文内容。
经验:让它验证时必须明确「看正文,不只看状态码」。
坑三:容易过度自信
遇到不确定的事,它有时候会编一个听起来合理的答案,而不是说「我不确定」。
经验:关键结论要它给证据,比如「贴出实际的请求和响应」。
值不值得用
看你干什么活。
如果你只是偶尔问问问题、写个小脚本,网页版够用,不用折腾。
但如果是维护一个真实项目——多文件、要部署、要验证——AgentDock 这类工具的价值会立刻显现。它把你从「复制粘贴 + 手动执行 + 反复确认」里解放出来。
我的实际感受:它不能替你想清楚要做什么,但能把你已经想清楚的事快速做完。 这个定位很准确地反映了当前 AI 工具的真实水平。
最后
网页版 GPT 不是废物,它是入门级的产品形态——够用、好上手、零配置,但天花板很明显。
AgentDock 这类工具做的事情,本质上是给模型装上了手脚。模型本身的智力没变多少,但能干的活完全不是一个量级。
如果你也在维护个人项目,又觉得网页版来回粘贴太累,值得试试。
