pi 教程:极简终端 AI agent 实测——安装、接 Ollama、和 omp 对比

本文安装、命令部分已在 Ubuntu 26.04 服务器上实测;Ollama 接入与只读任务实测已在 o3(arm02,Ubuntu 26.04 aarch64,2 核,11G 内存)上补完,见第五节。2026 年 11 月 14 日更新:换 9B 模型再测,pi 调动了工具(但答案卡在 thinking 里),见第六节。2026 年 11 月 19 日更新:改用 LLM API(Gemini)再测,不用拉模型、不用 GPU,7 秒多就出了正确的表,见第七节。 昨天实测了 omp,今天轮到它的“原作”:pi。一个跑在终端里的 AI 编程 agent,作者是 Mario Zechner(libGDX 的作者),MIT 开源。omp 就是在 pi 基础上 fork 出来再大幅扩展的,所以把 pi 搞明白,omp 的很多设计选择也就看懂了。本文只写实测过的内容:安装、命令、配置目录、那个静默卡住的坑和 Ollama 接入都是亲手跑过的;1.5B 小模型那节没跑通就明说没跑通。 pi 的理念是“越薄越好”:内置只有 4 个工具——read、write、edit、bash,系统提示词不到 1000 token,没有子 agent、没有权限弹窗、没有 plan mode,其他功能都靠扩展。1.0 之后加了 MCP 和 codemode。换句话说,它故意不做“大而全”,把选择权留给用户:要什么自己装扩展,不要的它也不塞给你。这个项目迭代很快,10 月中旬文档里还是 1.2.0,我 11 月 11 日实测装到的已经是 1.5.2,pi update 可以随时跟进新版本。 ...

November 11, 2026 · 4 min · 

pip 26.3 安全策略变了:装 wheel 不再默认安全,实测哈希校验漏洞已修

pip 26.3 在 2026 年 11 月 2 日发布。这次没有新功能,是一次安全收紧,三个变化要放在一起读:安全政策改写、安装期的 import 拦截从警告变成报错、修了一个哈希校验漏洞。背景是 10 月份的 eMudhra 弱 CA 密钥事件,整个 Python 打包生态都在补证书和收紧信任链。下面是实测过程和结果,环境是 Python 3.15.2,两个虚拟环境分别装 pip 26.2.2 和 pip 26.3 做对照。 变化一:安全政策改写,“装 wheel 不跑代码”被删了 pip 26.2 的 SECURITY.md 里写过一句话:“Installing a wheel does not run code from it”(装 wheel 不会运行其中的代码)。这句话寿命很短:2026 年 7 月 11 日才随 PR #14164 进入主分支,7 月 29 日随 26.2 首次发布。26.3 把它删了,我拉了 26.3 标签上的 SECURITY.md 原文,现在写的是: Because Python’s import system is dynamic, pip cannot guarantee that installing a wheel will not execute third-party code. ...

November 10, 2026 · 4 min · 

用 omp 管理 Nginx + Python 应用 + MySQL + Redis:从安装到日常运维

最近很火的 omp.sh,本名 Oh My Pi(命令行叫 omp),是一个跑在终端里的 AI 编程 agent。它由 Can Bölük 在 Mario Zechner 的 Pi 基础上 fork 并大幅扩展,开源 MIT 协议,GitHub 仓库是 can1357/oh-my-pi。它火的原因很直接:不绑 IDE、不收订阅费,模型自己接,内置了 LSP、调试器、子 agent、计划模式等一整套工具。 但先把一句话说清楚:omp 不是宝塔、不是 1Panel、不是部署工具,它不会替你“管理服务器”。它真正能做的是:坐在你的管理机上,读你的服务器清单和规则,按你的话去 SSH 到各台机器上执行命令、改配置、看日志、做检查,然后把结果汇报给你。本文就是这套用法:先实测安装,再给一个能直接抄走的运维工程。 一、安装部署(实测) 先读脚本,再跑脚本 官网给的一键安装是: curl -fsSL https://omp.sh/install | sh 管道安装是方便,但直接往 sh 里灌之前,先把脚本下下来看一眼,这是个好习惯。我就这么干的: curl -fsSL https://omp.sh/install -o omp-install.sh wc -l omp-install.sh 脚本 389 行,关键信息都在头部注释里:仓库 can1357/oh-my-pi,包名 @oh-my-pi/pi-coding-agent,默认装到 ~/.local/bin,预编译二进制来自 https://build.stencil.so 且会做 sha256 校验。支持三个选项:--source(走 Bun 从源码装)、--binary(强制用预编译二进制)、--ref(指定版本或分支)。 我这台机器有 Bun 1.4.4,正好卡在脚本要求的最低版本 MIN_BUN_VERSION="1.4.4" 上,所以安装走了 Bun 路径。跑完脚本的输出是: installed @oh-my-pi/pi-coding-agent@18.18.6 with binaries: - omp 63 packages installed [24.82s] warn: To run "omp", add the global bin folder to $PATH: /home/hatch/.bun/bin ✓ Installed omp via bun Run 'omp' to get started! 注意那个 warn:装完第一时间 omp --version 会报 command not found,因为二进制在 ~/.bun/bin,不在默认 PATH 里。补上就行: ...

November 10, 2026 · 5 min · 

Python 3.15 上手实测:lazy imports 提速 + Tachyon 采样分析

Python 3.15.0 在 2026 年 10 月 9 日发布,比原计划晚了 8 天,原因是临发布前又出了一个意外的第三个候选版(rc3),修 lazy import 的 bug。这次发布一共 5,643 次提交、1,012 位贡献者。我装的是 3.15.2,用 uv 一条命令装好,两个最值得试的新东西都实测了一遍:PEP 810 的 lazy import 和 PEP 799 的 Tachyon 采样分析器。下面是真实过程和真实输出。 安装:一条命令拿到 3.15.2 系统自带的是 Python 3.12,用 uv 装新版最快: uv python install 3.15 实测下载 36.4 MiB,15.92 秒装完。验证: ~/.local/share/uv/python/cpython-3.15.2-linux-x86_64-gnu/bin/python3 --version Python 3.15.2 下面所有实测都用这个解释器跑,记为 python3.15。 lazy import:启动时间省在哪 Python 启动慢,很多时候不是代码慢,是 import 慢:解释器要找文件、读磁盘、编译成字节码,再执行模块顶层的代码。PEP 810 给的办法是显式延迟加载,在 import 前面加一个 lazy: lazy import json lazy from pathlib import Path lazy 是软关键字,只在 import 语句开头才有特殊含义,你原来代码里叫 lazy 的变量不受影响。模块不会在 import 那一行加载,而是等到代码第一次用到这个名字时才真正加载,之后就是一个完全普通的模块。 ...

November 9, 2026 · 3 min · 

Python 的 llm 0.37:一行命令接入大模型,默认模型还便宜了一半

如果你平时要在终端里快速问大模型一个问题,或者想在 Python 脚本里调模型,Simon Willison 写的 llm 是最顺手的工具之一:它既是一个命令行工具,也是一个 Python 库,模型和密钥都用一套配置管起来。2026 年 11 月 2 日它发布了 0.37 版(随后还有 0.37.1 修复版),攒了大约两个月的更新。这篇文章就是这次更新的上手记录,所有命令都在 Python 3.12.3 的环境里实际跑过。 0.37 更新了什么 先说结论,四个值得注意的变化: 新模型:OpenAI 插件里多了 gpt-6.1-sol 和 gpt-6.1-terra,装好就能用 llm -m 指定。 接第三方端点变简单了:新命令 llm openai endpoint add,可以把任何 OpenAI 兼容的 API(比如 OpenRouter、本地的 Ollama、llama.cpp 服务,或者公司的代理)注册进来,不用再手改配置文件。 默认模型换了,也便宜了:如果你之前没有自己设过默认模型,新装的默认模型从 gpt-5.6-luna 换成了 gpt-6-luna,价格大约是原来的一半。 向量(embeddings)支持多模态内容类型:库层面现在能声明二进制内容的类型,命令行里对应的是 llm embed --binary 配合 --attachment-type 指定 MIME 类型。这是 Gemini Embedding 2 这类模型需要的,因为它能同时处理文本、音频、图片和视频。 另外一个小花絮:这次的修复来自 12 位贡献者,作者说几乎全是 AI 辅助提交的 PR,评审负担比预想的轻。 安装和验证 推荐用 pipx 或者 pip 安装,装的是命令行工具本身: ...

November 8, 2026 · 2 min · 

Cloudflare Tunnel 在受限出网环境连不上的实测:7844 端口被挡住了

Cloudflare Tunnel 是很多人做内网穿透的第一选择:不用开公网端口,不用在路由器上做映射,装一个 cloudflared 就能把本地服务通过 Cloudflare 的边缘网络暴露出去。听起来很美好,但在我这台工作机上,它就是连不上。这篇文章把实测过程完整写下来,不是为了说 Cloudflare Tunnel 不好,而是为了说清楚:它在什么样的网络环境下会走不通,以及走不通的时候应该换什么方案。 先说结论 在这台工作机上,Cloudflare Tunnel 走不通。不是配错了,也不是 token 错了,而是网络环境本身有四道关卡,任何一道都足以把它挡住。最后我们换成了 SSH 反向隧道,几分钟就通了。 如果你也在类似的受限环境里,看到这篇文章可以少走很多弯路:先去确认出网策略和端口,再决定要不要继续折腾 Cloudflare Tunnel。 这台工作机的出网环境 在讲失败之前,先讲清楚环境,不然结论没法复用。 这台工作机的出网要经过一个 HTTP 代理,只放行 CONNECT 到 443 端口。也就是说,常规的 HTTPS 流量可以出去,但别的端口基本出不去。更关键的是,Cloudflare Tunnel 的边缘端口是 7844,不是 443,而 443 上并不提供隧道协议。 很多人第一次听到这里会想:那能不能让 cloudflared 走 443 呢?实测证明不行。下面四道关卡,就是一步一步验证出来的。 第一道关卡:边缘端口 7844 不通 Cloudflare Tunnel 的边缘只监听 7844 端口,443 上没有隧道协议。所以哪怕 443 是通的,隧道也连不上。 实测分两种协议都失败了: UDP QUIC 到 7844,报错是 sendmsg: operation not permitted,也就是沙箱层面就不允许发出这种 UDP 包。 TCP HTTP/2 到 7844,TLS 握手直接 EOF,还没开始说话连接就断了。 手动加 --protocol http2 强制走 HTTP/2 也一样失败,握手同样 EOF。这说明问题不在协议选择上,而在端口本身出不去。 ...

November 7, 2026 · 2 min · 

server1 防火墙加固实录:只放 22 / 80 / 443 / 8080,其余全部拒绝

很多人的服务器防火墙是“看起来有规则,实际上全开”的状态:规则列表里有几条放行,默认策略却是 ACCEPT,等于没拦任何东西。我这台 server1 服务器就是这样。直到这次把 SSH 反向隧道发到公网,才顺手把防火墙彻底收了一遍。这篇文章是那次加固的完整记录。 改之前:策略是 ACCEPT,等于没设防 改之前,server1 的防火墙状态是这样的: IPv4 的 INPUT 默认策略是 ACCEPT,也就是说,没有匹配到任何规则的流量,默认放行。 规则里还残留着 16564、13783、15620、12345 等端口的放行规则,上面并没有服务在监听,属于历史遗留的陈旧规则。 IPv6 的 INPUT 默认策略也是 ACCEPT,而且没有任何规则,等于完全敞开。 也就是说,当时 server1 的公网端口基本上是全开的,只不过很多端口上没有服务在监听,所以从外面看像是“没反应”,而不是“被挡住了”。这两种状态看起来差不多,安全性完全是两回事:前者是“门没锁,只是屋里没人”,后者是“门锁了,只有指定的人能进”。 目标:默认拒绝,只放必要的 加固的目标很明确: IPv4 和 IPv6 的 INPUT 默认策略都改成 DROP。 只放行 loopback、已经建立的连接、ICMP,以及 TCP 的 22、80、443、8080。 其余流量一律 DROP,不回应,直接丢掉。 规则要能持久保存,重启之后还在。 为什么是这四个端口?22 是 SSH 管理口,必须留;80 和 443 是 Web 服务;8080 是当时 SSH 反向隧道要用的公网口子。其他端口一律不放。 改动之前先做的事:10 分钟自动回滚 改防火墙最怕的是把自己锁在外面:一条规则写错,SSH 连不上,服务器就只能走控制台去救了。所以这次改动之前,先设了一个 10 分钟自动回滚的安全措施:10 分钟之后,自动把原来的防火墙规则恢复回去。 这个思路值得单独说一下:改远程防火墙的时候,一定要给自己留一条后路。可以是定时任务回滚,也可以是先在另一个终端保持一个已经建立好的 SSH 连接不动,再开一个新连接测试。确认新规则没问题之后,再把回滚任务删掉。 如果改完之后发现 SSH 连不上了,什么都不用做,等 10 分钟,规则就自己回去了。这比事后找控制台救机要省事得多。 ...

November 7, 2026 · 1 min · 

SSH 反向隧道 + GatewayPorts:把内网服务发到公网

家里或者公司内网有一台机器,上面跑着一个服务,想让外面的人访问,一般会想到内网穿透、端口映射或者 Cloudflare Tunnel。但如果你手头已经有一台有公网 IP 的服务器,最简单、最可控的办法往往是一条 SSH 反向隧道。这篇文章就是这次实操的完整记录:从一条命令开始,到公网能访问,再到最后主动把口子关掉。 场景:想解决什么问题 我的工作机在内网环境里,没有公网 IP,上面跑着 Nginx,监听本机的 80 端口。我还有一台有公网 IP 的服务器,域名是 server1.example.com。目标是:让外面的人通过 http://server1.example.com:8080/ 访问到工作机上的 Nginx 页面。 这个场景很常见:演示一个本地页面、临时分享一个文件、让同事看一下本地跑起来的服务。要求是改动小、能快速验证、出问题能立刻收回。 原理:反向隧道在干什么 先把概念说清楚,不然命令背下来也没用。 SSH 反向隧道的核心是一句:让远端服务器监听一个端口,收到请求后,通过已经建立好的 SSH 连接,把流量转发回本地机器的某个端口。 工作机 --SSH--> server1.example.com server1 监听 8080 --> 转发回工作机 localhost:80 --> 工作机 Nginx 也就是说,SSH 连接是工作机主动向 server1 发起的,方向是从内网往外打,这在大多数受限网络里都是放行的;server1 收到公网请求后,再沿着这条已经建好的连接把流量送回来。内网机器不需要有公网 IP,也不需要在路由器上做端口映射。 第一步:在工作机上建立反向隧道 在工作机上执行: ssh -N -R 8080:localhost:80 user1@server1.example.com 这条命令拆开看: -N:不执行远端命令,只做端口转发。 -R 8080:localhost:80:让远端(server1)监听 8080 端口,流量转发到本地的 localhost:80,也就是工作机上的 Nginx。 user1@server1.example.com:登录 server1 的账号和主机,以实际环境为准。 执行之后,这条 SSH 连接要一直保持着,隧道才在。连接断了,转发就没了。所以生产上一般会给它加上保活参数,或者用 systemd、supervisor 之类的工具托管,断了自动重连;临时演示的话,放在一个终端里跑着就行。 这里还有一个细节:这条命令本身不会在终端输出什么“隧道建立成功”的提示。别等它打印东西,它不打印就是正常的。验证要靠下一步的 curl,而不是看命令输出。 第二步:server1 上打开 GatewayPorts 只做第一步,还不够。默认情况下,SSH 反向隧道在远端只监听 127.0.0.1:8080,也就是说只有 server1 本机能访问这个端口,从公网访问 server1.example.com:8080 是连不上的。 ...

November 7, 2026 · 2 min · 

Ubuntu 24.04 dist-upgrade 实录:升完之后,CVE-2026-98432 还是没修

服务器升级最怕两件事:一是升完起不来,二是升完发现想修的漏洞还是没修。这次 server1 的 dist-upgrade,两件事里只遇到了一件好的:升级本身很顺利,服务都正常;但 CVE-2026-98432 在升级之后依然没修。这篇文章就是那次升级的完整记录,包括升级前后的状态、CVE 的跟进方法,以及顺带要提醒的两个 PHP 高危漏洞。 决定:留在 24.04,不升 26.04 升级之前先定方向:这次是留在 Ubuntu 24.04 做 dist-upgrade,不做发行版升级到 26.04。 这个决定是有原因的:24.04 是 LTS,支持周期长,生产环境求稳;26.04 当时还太新,周边的软件和配置不一定都跟得上。dist-upgrade 和 release upgrade 是两回事,前者是在同一个发行版里把软件包升到最新,后者是换一个发行版。做之前一定要分清楚,别把命令搞混了。 升级过程:顺利,但也要一步一步来 升级之前,先确认备份和回滚方案,再开始操作。具体的备份方式以实际环境为准,重要的是:升级之前一定要有能回去的办法。 升级本身的步骤是常规的:更新软件包列表、做 dist-upgrade、检查有没有需要重启的提示、验证服务状态。升级过程中如果有配置文件冲突的提示,不要无脑选覆盖,先看清楚改的是什么,再决定保留还是替换。 升级完成之后的状态是: 系统版本:Ubuntu 24.04.5 LTS 内核版本:6.8.0-147-generic Nginx 版本:1.31.8,服务正常,HTTPS 能返回 200 可升级包:0 个 是否需要重启:无需重启 也就是说,这次升级把系统升到了当时的最新状态,服务也没有受影响。验证的时候不要只看版本号,要逐个确认关键服务:SSH 能不能连、Nginx 能不能访问、网站返回是不是 200。 CVE-2026-98432:升完还是没修 升级之后,第一件事就是去查 CVE-2026-98432 修了没有。结果是:还是没修。 在 6.8.0-147 这个内核版本上,CVE-2026-98432 依然是未修复状态。目标修复版本是 6.8.0-149.149,也就是说,要等到内核升到 6.8.0-149.149,这个漏洞才算修掉。 同一时期,其他版本的状态是不一样的:26.10 已经在 7.3.0-10.10 里修复了,但 26.04、24.04、22.04 都还是未修复或者修复进行中的状态。不同发行版的修复进度不一样,不能拿一个版本的结论去套另一个版本。 所以这次升级的结论是:系统是最新了,但这个 CVE 还没修,还要继续跟进。 怎么跟进一个 CVE:每天去看官方页面 跟进 CVE 的办法很简单,但要坚持:每天去官方页面查一次状态。 ...

November 7, 2026 · 1 min · 

如何开通 Muse 的 terminal 登录:在浏览器里开一台工作机终端

用 Muse 管理服务器的时候,最常遇到的一个需求是:能不能在浏览器里直接开一个终端,敲命令、看日志、改配置,而不用另外开一个 SSH 客户端?答案是可以。这篇文章就是这次实操的完整记录:用 ttyd 把工作机的终端搬到浏览器里,再用 Nginx 和 https 把它安全地暴露出来。 先说清楚,这篇讲的是“开通 terminal 登录”的具体做法,不是 Muse 本身的账号登录。Muse 的账号怎么开、权限怎么给,以实际环境为准;这里只讲终端这一段。 方案选型:ttyd + Nginx + https 方案分三层,每一层只做一件事: ttyd:把终端变成一个 Web 服务,浏览器打开就能用。 Nginx:在本机做反代,把 ttyd 藏在后面,只暴露一个 /tty/ 路径。 server1 的 Nginx + https:通过 SSH 反向隧道和 terminal.example.com 的 https,把这个路径安全地发到公网。 这样做的好处是:ttyd 本身只监听本机,不直接暴露到公网;认证和加密都由前面的层来负责;每一层出问题,都可以单独排障。 第一步:装 ttyd,只监听本机 我们用的 ttyd 是 1.7.4 版本,通过系统包安装,版本号和安装方式以实际环境为准。装好之后,启动时要明确指定只监听本机: ttyd -p 7681 -i 127.0.0.1 /bin/bash -l 拆开看: -p 7681:监听 7681 端口。 -i 127.0.0.1:只监听本机回环地址,不监听公网地址。这是关键的一步,ttyd 本身不直接对公网开放。 /bin/bash -l:打开一个登录 shell。 除此之外,我们还启用了可写模式和 Basic Auth。可写模式的意思是浏览器里的终端真的能输入命令,而不是只能看;Basic Auth 的意思是访问之前要先输入用户名和密码,没有密码进不去。 ...

November 7, 2026 · 2 min ·