共计 4487 个字符,预计需要花费 12 分钟才能阅读完成。
10 月 26 日凌晨 0 点 27 分(北京时间),Hacker News 上出现一条「JetBrains Thinkrail」的帖子。我写这篇的时候它已经 240 分、174 条评论。前一天还有一条同题帖,57 分、84 条评论。很多人在吵 README 像不像 AI 写的,有人说「我不离开 oh-my-pi」,也有人直接骂「怎么敢不把 agent 放进容器」。
我去查了一下第三方在 10 月 25 日留下的快照:当时仓库大约 1,274 星。今天下午 3 点 06 分,GitHub API 返回的数字是 4,349。同一天的 GitHub Trending 日榜上,它今日新增写着 +1,204。三天多了三千颗星,比我过去几个月盯过的很多「工具」都猛。
所以我没有先写「它是什么、怎么装」。我想先看 issue 区在吵什么——尤其是中文用户会不会踩坑,以及有没有已经写明、还没修的安全问题。中间我在一台 Debian 13 的机器上把 CLI 空跑了一遍,只为核对一条 issue 里写的复现步骤。
它是 pi 的外壳,只跑这一个 agent
ThinkRail 是 JetBrains 的孵化项目,许可证 Apache-2.0,主语言 TypeScript。README 自己的说法很直接:它是「a thin host that runs pi in-process」——在进程里跑 pi 编码 agent,外面套一层真正的 IDE 壳。
分工写得很清楚:pi 管模型、skills、上下文压缩、费用和会话;ThinkRail 管 workspace、Monaco 编辑器、前后端通信。它不另开账号。你可以登录 JetBrains AI,也可以用你本来就配好的 pi 凭据。官网 thinkrail.ai。
它主打的工作方式是「一个任务切一个 git worktree」:开仓库当项目,切出带独立分支和工作目录的 workspace,agent 可以并行干活,改完再合并。也支持直接在项目目录里干——界面会标明 no isolation。
仓库现在有 30 位贡献者(contributors 接口,含匿名)。全部 issue 302 个,PR 652 个。稳定版是 10 月 19 日发布的 v0.2.0。今天 14:52(北京)又出了 v0.3.0-nightly.8。下面的数字,如果没有另写时间,都是北京时间 2026-10-28 15:04 到 15:12 之间从 GitHub API、gh 和日榜页抓的。
我先把 CLI 空跑了一遍

环境是 Debian 13,glibc 2.41,x86_64。我没有接任何模型,只验证「二进制能不能起来、起了之后听什么端口」。
gh release download v0.3.0-nightly.8 -R JetBrains/thinkrail \
-p thinkrail-linux-x64 -p SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing
# thinkrail-linux-x64: OK
# 哈希 1e79612d41b1f2fb3e97cf6eb4a3a260b3c406154b8a851a6e7a60c9fd6a247d
./thinkrail-linux-x64 --version
# 0.3.0-nightly.8
文件大约 234 MB。--help 里写得很清楚:默认端口 24242,被占用就换空闲端口;默认绑定 localhost;--no-open 不弹浏览器;--no-analytics 关掉「附加」使用数据。
我把 HOME 指到空目录,再给它一个只有一次空提交的 git 仓库:
HOME=/tmp/trhome ./thinkrail-linux-x64 \
--no-open --no-analytics --port 24242 /tmp/trdemo
# [2026-10-28T07:05:46.123Z] INFO: [log] logging initialized ...
# [2026-10-28T07:05:46.172Z] INFO: [host] listening on port 24242
# thinkrail → http://localhost:24242
从初始化到监听,日志时间差 49 毫秒。ss 显示它只听 [::1]:24242。curl http://localhost:24242/ 返回 200,页面 title 是 ThinkRail。
首次启动会在 ~/.thinkrail/ 写下日志、installation.json、projects.json、主题和语言目录;在 ~/.pi/agent/ 写下 auth.json(我这边是空对象 {},因为没接模型)和 models-store.json;还会在 ~/.cache/thinkrail/ 落 runtime / skills / web。整棵树大约 35 MB。projects.json 里这个演示项目的 piResourceTrust 是 "untrusted"。
有一处和 README 的开发要求不完全一样:README 说开发需要 Node ≥ 22.19,我这台系统 Node 是 20.19.2,CLI 照样跑起来了。CLI 是自带运行时的单文件,Node 版本主要卡开发,不卡直接下载的二进制。
跑完我用 pkill 结束了进程。后面那条安全 issue,我只做了握手验证,没有真正往终端里写命令。
任意网页都能连上本机的 /ws

今天早上 8:54(北京)有人开了 #969:标题是「Unauthenticated WebSocket host lets any webpage run commands」。作者 CommanderTvis 写得很具体——
The host’s
/wsendpoint upgrades every request without checking theOriginheader or any credential. Browsers do not apply the same-origin policy to WebSockets, so any webpage the user visits can openws://localhost:<port>/wsagainst a running ThinkRail host and call the same RPCs the UI does, includingterminal.reserve,terminal.attachandterminal.write.
意思是:你本机开着 ThinkRail,再去逛任意一个网页,那个网页上的脚本可以连到 ws://localhost:24242/ws,调用和界面一模一样的 RPC,包括往终端里写命令。作者注明自己是读了 packages/server/src/host/server.ts 和 handlers.ts 推出来的,没有对着活实例复现完整攻击链。
我对着自己刚起的实例做了最小一步验证:用 curl 带上假的 Origin: https://evil.example 去请求 /ws 升级。返回是:
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
握手成功了。我没有继续发 terminal.write。本机已经证明「Origin 检查不存在」这一条;「能任意执行命令」那条,我按作者的代码阅读结论写在这里,没有自己再跑一遍。
同一类问题在 #920 里也有人提过修复 PR,标题写着 CSWSH RCE。我写这篇时这个 PR 还是 OPEN。#969 正文明确说,那个 PR 当前的修法没有真正解决 Origin / 凭证问题。
在 #969 合并且我能核对到 Origin 或 token 检查之前,CLI 默认端口 24242 太好猜了。本机开着 ThinkRail 的时候,我不会在同一台机器上随便点网页。桌面版我还没装。
中文路径会乱码,系统语言是 zh 时会掉回英文
两条跟中文用户直接相关。
#880「中文路径不支持的问题」,Liruitao1993 在 10 月 26 日开的。另一个人 zelo789 在 Windows 11(build 26300)+ 稳定版 0.2.0 上确认:文件夹选择器对含非 ASCII 字符的目录会返回乱码,接着 project.open 报 NOT_GIT。根因写在评论里——packages/server/src/dialog/dialog.ts 用 PowerShell 的 -EncodedCommand 跑选目录,脚本本身能扛 Unicode,但读回 stdout 时按 UTF-8 解码,而 Windows PowerShell 5.1 往重定向管道里写的是系统代码页。我没在 Windows 上复现,只转述 issue 里已经写死的环境和根因。
#872 更偏语言匹配:Settings → Language 选「System」时,只有系统精确报告 zh-CN 才会选中内置的简体中文;zh、zh-SG、zh-Hans 都会掉回英文。繁体那边也有同样的精确匹配问题。好消息是 #882 已经合并(10 月 26 日 17:31 北京),按脚本标签匹配语言。有人在 Debian 13 上测了解析函数,33/33 通过。如果你装的是 10 月 26 日之前的包,系统语言又不是精确的 zh-CN,界面还是会英文;装到合并之后的 nightly,这条应该已经好了——我没有在 GUI 里再验一遍,只核对了 PR 状态和那条测试评论。
平台边界和 HN 上吵的那些

#907 标题很冲:「Not supporting LSP is a very aggressive approach.」维护者一侧的回复是:pi 已经有 LSP 扩展(比如 samfoy/pi-lsp-extension),但不会进 ThinkRail 自带的 Monaco;界面也不帮你装自定义扩展。另一个评论写得更直——用户得自己管 pi 的配置文件,「the value of ThinkRail versus any other IDE comes into question」。
#901 求支持 Ubuntu 22.04。回复也很干脆:Electrobun 的 Linux 预编译是在 ubuntu-24.04 上打的,要 glibc 2.38;22.04 自带 2.35,改 CI 的 runs-on 不够。这和 README 写的「Ubuntu 24.04 or newer」一致。我这台 Debian 13 是 2.41,CLI 没问题;如果你还在 22.04,别指望桌面包能直接跑。
Windows 桌面版自己还有一条反复出现的坑:#962、#972 都报「桌面版起不了 WebSocket server,CLI 可以」。我没碰 Windows,只把编号留在这里。
回到 HN 那帖。有人吐槽 README 的 bullet 全是「claudese」,有人说「不跑容器就敢跑 agent 太疯了」,也有人感慨「我刚习惯 jj,全世界又开始迷 git worktree」。光谱SpectrAI 在掘金写过一篇更细的实测,专门拆了 worktree 隔住了文件、没隔住 stash——那篇实验我没有重做,有兴趣直接去看 原帖。
我接下来会盯着 #969 和 #920。在我能核对到 Origin 或实例级凭证之前,本机开着 ThinkRail 的时候,我会少在同一台机器上逛别的网页。仓库、Release、issue 都在这里:github.com/JetBrains/thinkrail。




