<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>I am LAZY bones?</title>
	<atom:link href="https://luy.li/feed/" rel="self" type="application/rss+xml" />
	<link>https://luy.li</link>
	<description>AN ancient AND boring SITE</description>
	<lastBuildDate>Sat, 14 Nov 2026 05:41:23 +0000</lastBuildDate>
	<language>zh-Hans</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	
	<item>
		<title>用 Tailscale 远程登录家里的 Mac mini</title>
		<link>https://luy.li/2026/11/14/remote-mac/</link>
					<comments>https://luy.li/2026/11/14/remote-mac/#respond</comments>
		
		<dc:creator><![CDATA[bones7456]]></dc:creator>
		<pubDate>Sat, 14 Nov 2026 05:38:09 +0000</pubDate>
				<category><![CDATA[流水帐]]></category>
		<category><![CDATA[经验技巧]]></category>
		<guid isPermaLink="false">https://luy.li/?p=2666</guid>

					<description><![CDATA[<p>今天要去深圳出差，下周日才回新加坡。出门前我顺手在手机上问了 Claude 一句：我去深圳这几天，你不会封我号 [&#8230;]</p>
<p>The post <a href="https://luy.li/2026/11/14/remote-mac/">用 Tailscale 远程登录家里的 Mac mini</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></description>
										<content:encoded><![CDATA[<p>今天要去深圳出差，下周日才回新加坡。出门前我顺手在手机上问了 Claude 一句：我去深圳这几天，你不会封我号吧？结果它搜了一圈，很认真地告诉我：新政策两天前刚生效，中国大陆、香港、澳门都不在支持地区名单上，出差、旅游都不能用，连机场转机都算；判断标准是人实际在哪里，用新加坡号码漫游或者境外 eSIM 也不行，“最稳妥的做法是这几天别用”。<br />
<span id="more-2666"></span></p>
<p><img fetchpriority="high" decoding="async" src="https://luy.li/wp-content/uploads/2026/11/tailscale_macmini_remote_blog_header.webp" alt="" width="1500" height="844" class="alignnone size-large wp-image-2669" /></p>
<p>我意识到，不妙，这一周的活儿可怎么干。。。</p>
<p>好在家里还有一台常年开机的 Mac mini，上面本来就连着 <a href="https://tailscale.com/">Tailscale</a>。那就远程登回去，在那台机器上干活嘛！（先说清楚：政策是按人在哪算的，这么干并不等于合规，风险自负，这篇只聊技术。）本以为十分钟的事，结果从“为什么显示离线”一路折腾到“为什么这么卡”，踩了一串坑，值得写一篇，分享给有需要的朋友。</p>
<h2>明明连着，为什么“离线”？</h2>
<p>第一步就卡住了。Mac mini 明明开着、Tailscale 也连着，MacBook 这边 ping 不通、ssh 超时，<code>tailscale status</code> 里它那一行是这样的：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">100.117.x.y   。。。。
100.117.x.y   macmini         macOS    -
100.101.x.y   titan-2-elite   android  offline, last seen 5d ago</pre><p></p>
<p>我一看最后一列是个 <code>-</code>，就以为是离线。其实不是：<code>-</code> 只表示当前没有活跃连接，真离线的会像下面那行一样明明白白写 <code>offline, last seen ...</code>。</p>
<p>那为什么连不上？看一眼路由就明白了：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">$ route -n get 100.117.x.y
destination: default
    gateway: 192.168.0.1
  interface: en0</pre><p></p>
<p>去 100.x 的流量走的是 en0 的默认网关，直接发到公网去了，当然不通。再看进程：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">/opt/homebrew/bin/tailscaled --tun=userspace-networking --socks5-server=localhost:1055 --outbound-http-proxy-listen=localhost:1056</pre><p></p>
<p>破案了。我的 MacBook 上跑的是 Homebrew 装的 tailscaled，用的是 <a href="https://tailscale.com/kb/1112/userspace-networking">userspace networking</a> 模式（当初这么装，就是因为不想让它动我的路由表，公司 VPN 已经够乱了）。这个模式的特点是：</p>
<p>1. 不创建虚拟网卡，系统里没有 100.x 的地址，路由表里一条相关路由都没有。<br />
2. 不改 DNS。<br />
3. 只在本机开两个代理端口：SOCKS5 的 1055 和 HTTP 的 1056，想访问 tailnet 里的机器，必须自己把流量送进代理。</p>
<p>所以 <code>tailscale ping</code> 能通（它走的是 tailscaled 进程自己），系统的 ping 和 ssh 却全部超时。这个现象特别有迷惑性。至于为什么用这个模式，其实是因为tailscale和我公司的部分内网服务冲突（都是100.x.x.x段的），我故意设置的。</p>
<h2>ssh：让它走 SOCKS5</h2>
<p>知道原因就好办了，在 <code>~/.ssh/config</code> 里加一段：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">Host macmini
    HostName 100.117.x.y
    User zs
    ProxyCommand nc -X 5 -x localhost:1055 %h %p
    LocalForward 5901 localhost:5900</pre><p></p>
<p><code>ProxyCommand</code> 那行让 ssh 通过 nc 走 SOCKS5 代理；<code>LocalForward</code> 那行是给后面的图形界面准备的。配完 <code>ssh macmini</code> 直接就进去了。</p>
<h2>图形界面：屏幕共享 + SSH 隧道</h2>
<p>我要用Claude，虽然也可以用CLI，但有图形界面其实更好。对面是台 Mac，图形界面用系统自带的“屏幕共享”就行，不用装任何东西。在 Mac mini 上打开：系统设置 → 通用 → 共享 → 屏幕共享。</p>
<p>问题是 MacBook 上的“屏幕共享”App 不会走 SOCKS5 代理，没法直接填 100.x 的地址。这就是上面那行 <code>LocalForward</code> 的用处：ssh 连上之后，本机的 5901 端口就被转发到了 Mac mini 的 5900（VNC 端口）。于是：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">ssh -fN macmini                   # 后台建隧道
open vnc://zs@localhost:5901      # 或者 Finder 里 ⌘K</pre><p></p>
<p>登录窗口就出来了，还真挺顺。</p>
<h2>能不能不占用真机的桌面？</h2>
<p>家里的 Mac mini 不止我一个人用。我远程登上去的时候，如果正好有人坐在它前面，两个人抢一个桌面就很尴尬了。</p>
<p>macOS 的屏幕共享其实自带“后台会话”：连接的时候会弹一个选择，“请求共享显示器”还是“以本人身份登录”，选后者就进入自己账户的虚拟显示器，真机屏幕上的人完全不受影响，只会在菜单栏看到一个小图标。</p>
<p>但是这个选择<b>不是每次都弹</b>，规则是这样的：</p>
<p>1. 真机前台是<b>别的账户</b>在用：弹选择，可以进后台会话。这是理想情况。<br />
2. 真机停在<b>登录窗口</b>，前台没人：不弹，直接把物理屏幕给你。右上角会有一行 “Your screen is being observed”，这时候输密码登录，真机显示器上会同步显示你的桌面。<br />
3. 真机前台就是<b>你自己的账户</b>：看到的就是真机上那个桌面，同一个会话。</p>
<p>（第 2 条是我实际连上去看到物理屏幕的登录界面才搞明白的，一开始还以为登录窗口状态下进去也是后台会话。）</p>
<p>想知道真机前台现在是谁，ssh 上去一条命令：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">stat -f %Su /dev/console  # 其实就是看这个设备文件的属主</pre><p></p>
<p>输出是用户名就是那个人在前台，输出 <code>root</code> 就是停在登录窗口。</p>
<p>另外同一个账户同一时间只有一个桌面会话。所以实际用法是：没人用真机时我直接登；有人要用，就让他用自己的账户登录，我的会话会退到后台不会丢，我这边断开重连一次，选“以本人身份登录”就回来了。</p>
<h2>为什么这么卡？中继和直连</h2>
<p>连是连上了，但画面有点卡。<code>tailscale ping</code> 一看：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">pong from macmini (100.117.x.y) via DERP(sin) in 19ms
direct connection not established</pre><p></p>
<p>流量走的是 <a href="https://tailscale.com/kb/1232/derp-servers">DERP</a> 中继（新加坡节点），没有建立直连。DERP 是 Tailscale 在打洞失败时的兜底，能通，但是限速，延迟也不稳。</p>
<p>而 <code>tailscale status</code> 的最下面其实一直挂着一条告警，我之前压根没在意：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag"># Health check:
#     - The MagicSock function ReceiveIPv4 is not running. You might experience connectivity issues.</pre><p></p>
<p>意思是 tailscaled 里负责收 IPv4 UDP 包的那部分停了。直连靠的就是 UDP，收不到包只能退回中继。这个进程已经连续跑了好几天，而且本机到<b>所有</b>节点都是中继，说明问题在我这边，不在 Mac mini 那边。</p>
<p>解决办法朴实无华，重启：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo launchctl kickstart -k system/com.tailscale.tailscaled</pre><p></p>
<p>它按原来的 plist 把进程再拉起来一次，参数不变，所以依然不碰路由和 DNS，登录状态也不用重新搞。副作用是代理端口会断几秒，已有的 ssh 隧道和屏幕共享会掉线，重连即可。</p>
<p>重启前后各测了一组：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">重启前（中继）        重启后（直连）
路径        DERP(sin)             192.168.x.y:41641
延迟        平均 18ms，波动大     平均 11ms（8～17ms）
上传        18.1 Mbit/s           117.1 Mbit/s
下载        21.2 Mbit/s           78.2 Mbit/s</pre><p></p>
<p>吞吐是原来的四到六倍，屏幕共享一下子就顺滑了。</p>
<p>这里有个很尴尬的细节：直连地址是 192.168.x.y，也就是说，我人还在家里，两台机器就在同一个局域网，之前的流量居然一直在绕新加坡的中继。。。到了深圳肯定跑不出这个数字，能不能直连还要看两边的 NAT，到时候再测。</p>
<h2>一条命令搞定</h2>
<p>出差在外，不想每次都手敲这一串，于是让 Claude Code 帮我写了个脚本 <code>macmini</code>，放在 <code>~/.local/bin</code> 里：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">macmini               检查环境，然后打开屏幕共享
macmini ssh           检查环境，然后进 SSH
macmini up   路径&hellip;    上传文件或目录
macmini down 路径&hellip;    下载文件或目录
macmini sync 路径&hellip;    双向同步，谁的修改时间新就听谁的
macmini bench         测路径（直连/中继）、延迟、吞吐
macmini stop          关掉后台隧道</pre><p></p>
<p>“检查环境”是依次做这几件事，哪步不过就停下来说人话：</p>
<p>1. tailscaled 进程在不在，不在就用 launchctl 拉起来。<br />
2. Tailscale 是不是已连接状态，不是就 <code>tailscale up</code>。<br />
3. SOCKS5 代理端口有没有在监听。<br />
4. Mac mini 在线不在线、ping 不 ping 得通。<br />
5. 隧道已经有了就复用，没有就新建；确认对面 5900 开着，最后 <code>open vnc://...</code>。</p>
<p>bench 的核心就三条命令，嫌麻烦的话不写脚本直接手敲也行：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag"># 路径和延迟
tailscale ping --c 10 --until-direct=false macmini

# 上传
dd if=/dev/zero bs=1m count=10 | ssh macmini 'cat &gt;/dev/null'

# 下载
ssh macmini 'dd if=/dev/zero bs=1m count=10' &gt;/dev/null</pre><p></p>
<p>用 <code>time</code> 掐一下，10MB 除以秒数就是吞吐（记得扣掉 ssh 握手的一两秒）。屏幕共享 App 自己没有帧率、延迟之类的统计面板，但卡不卡基本就看这三个数。</p>
<h2>顺手把传文件也解决了</h2>
<p>我实测过，远程桌面状态下，系统剪贴板是能双向互通的，这其实很好了，但文件的话还是要两头倒腾，屏幕共享的拖拽走中继的时候慢得感人。ssh 既然通了，就给脚本加了 <code>up</code> / <code>down</code> / <code>sync</code> 三个子命令，底下就是 rsync，文件和目录都行。</p>
<p>唯一值得说的是路径。两台机器上我的用户名不一样，比如一边是 <code>/Users/zhangsan</code>，另一边是 <code>/Users/zs</code>，每次手敲两遍路径实在是烦。所以脚本会自动换算：两边保持同一个位置，只把家目录前缀互换，路径按哪边的写法给都行，相对路径也行。</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">$ cd ~/dev
$ macmini up foo
==&gt; up  本机 /Users/zhangsan/dev/foo  &lt;-&gt;  macmini /Users/zs/dev/foo</pre><p></p>
<p><code>sync</code> 是用 rsync 的 <code>-u</code>（接收方的文件更新就跳过）来回各跑一遍实现的：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">rsync -azu ~/dev/foo/ macmini:/Users/zs/dev/foo/
rsync -azu macmini:/Users/zs/dev/foo/ ~/dev/foo/</pre><p></p>
<p>两遍跑完，每个文件都是两边里较新的那一份。简单是简单，但它不会同步删除（一边删掉的文件，下次会从另一边拷回来），两边都改了同一个文件也不会合并，新的那份直接赢。真要两边同时改，还是老老实实用 git 吧。</p>
<h2>几个坑</h2>
<p>1. <code>tailscale status</code> 最后一列的 <code>-</code> 不是离线，离线会写 <code>offline</code>。<br />
2. userspace networking 模式下，系统的 ping、ssh、浏览器访问 100.x 全部超时，只有 <code>tailscale ping</code> 能通。别怀疑对面，先 <code>route get</code> 看一眼流量去了哪。<br />
3. <code>tailscale ping</code> 有两个反直觉的行为：只拿到中继回应时，退出码是非 0（哪怕 pong 都收到了），写脚本不能靠退出码判断通不通；一旦拿到直连回应，它就提前结束，想测满 10 次要加 <code>--until-direct=false</code>。<br />
4. 屏幕共享也可以 ssh 上去用 launchctl 命令行开启，但新版 macOS 这么开可能只能看、不能控制，完整控制还是得在系统设置里点一下。出门前务必先点好！<br />
5. 真机停在登录窗口时连上去，拿到的是物理屏幕，不是后台会话。家里有人的话，你的桌面会直接出现在显示器上。<br />
6. <code>status</code> 末尾的 Health check 告警别无视。直连全挂、只剩中继，很可能就是它。<br />
7. 新版 macOS 自带的 rsync 其实是 openrsync（<code>rsync --version</code> 第一行就写着），跟平时在 Linux 上用的不完全一样：没有 <code>--protect-args</code>，远端路径里有空格得自己转义；<code>-v</code> 打印中文文件名时会冒出一堆 <code>\#202</code> 这样的转义。别慌，只是显示问题，文件本身是好的。</p>
<p>不说了，我得马上把本机的claude都退出，然后收拾行李赶飞机去。到了深圳第一件事就是跑一遍 <code>macmini bench</code>，看看隔着这么远还能不能打洞成功。要是只剩中继那十几兆，这一周怕是要对着幻灯片一样的远程桌面干活了。。。<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f62d.png" alt="😭" class="wp-smiley" style="height: 1em; max-height: 1em;" /></p><p>The post <a href="https://luy.li/2026/11/14/remote-mac/">用 Tailscale 远程登录家里的 Mac mini</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></content:encoded>
					
					<wfw:commentRss>https://luy.li/2026/11/14/remote-mac/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>TelemetryLite 的 AI 集成玩法</title>
		<link>https://luy.li/2026/11/09/telemetrylite-ai/</link>
					<comments>https://luy.li/2026/11/09/telemetrylite-ai/#respond</comments>
		
		<dc:creator><![CDATA[bones7456]]></dc:creator>
		<pubDate>Mon, 09 Nov 2026 12:12:15 +0000</pubDate>
				<category><![CDATA[AI]]></category>
		<category><![CDATA[经验技巧]]></category>
		<guid isPermaLink="false">https://luy.li/?p=2656</guid>

					<description><![CDATA[<p>昨天那篇里，我顺嘴提了一句：后台有个「让 AI agent 完成接入」，复制提示词丢给 Claude Code [&#8230;]</p>
<p>The post <a href="https://luy.li/2026/11/09/telemetrylite-ai/">TelemetryLite 的 AI 集成玩法</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></description>
										<content:encoded><![CDATA[<p><a href="https://luy.li/2026/11/08/telemetrylite/">昨天那篇</a>里，我顺嘴提了一句：后台有个「让 AI agent 完成接入」，复制提示词丢给 Claude Code 就行。写完我越想越不对劲——这才解决了一半啊！</p>
<p>数据接进来了，然后呢？我想知道“这周哪个版本的用户最多”“安卓和 iOS 的购买有啥差别”，还得打开页面，选范围、切平台、一张图一张图地看。可我一天到晚泡在 Claude Code 里，凭什么这点事不能直接问它？</p>
<p>于是我把另一半补上了：让 AI 不光能帮你<b>接</b>统计，还能直接<b>读</b>你的统计。这一版（0.2.0）已经发布，值得单独写一篇，分享给有需要的朋友。<br />
<span id="more-2656"></span></p>
<h2>接入这半边：提示词里到底写了什么？</h2>
<p>在设置页签发一把写入 key，下面的提示词就会自动把<b>服务器地址、App ID 和刚签发的 key</b> 填进去（key 只显示这一次，所以是先签发、后填充）。点「复制提示词」，到 App 的仓库根目录丢给 Claude Code、Codex 或者 Cursor 就行。</p>
<p><img decoding="async" src="https://luy.li/wp-content/uploads/2026/11/telemetrylite-ai-integrate.webp" alt="设置页里的“让 AI agent 完成接入”，地址、App ID 和 key 都已填好" /></p>
<p>这段提示词我写得很啰嗦，因为 agent 最怕的就是自作聪明。它大概要求 agent 做这几件事：</p>
<p>1. 先识别平台和构建系统，<b>改文件之前</b>先说清楚打算走哪条路；<br />
2. 在 App 启动时初始化一次：Swift 就加官方的 TelemetryDeck Swift SDK，把 baseURL 指向 <code>服务器/k/key/</code>；别的平台优先用官方 SDK 改 baseURL，没有这个选项就退到纯 HTTP，已经在用 OpenTelemetry 的就走 OTLP；<br />
3. 编译项目，再用一条 curl 发个测试事件，期望返回 200（401 是 key 错了，503 是服务器忙）；<br />
4. 改动要最小，别顺手加别的埋点、别重构。</p>
<p>第 3 条的检查命令长这样：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">curl -i -X POST &quot;&lt;SERVER_URL&gt;/k/&lt;WRITE_KEY&gt;/v2/&quot; -H 'content-type: application/json' \
  -d '[{&quot;type&quot;:&quot;Integration.test&quot;,&quot;clientUser&quot;:&quot;agent-test&quot;,&quot;sessionID&quot;:&quot;s1&quot;,&quot;isTestMode&quot;:&quot;true&quot;,&quot;payload&quot;:{}}]'</pre><p></p>
<p>第 4 条是故意写的，不写的话，agent 很容易手痒，把你别的代码也“优化”一遍。<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f605.png" alt="😅" class="wp-smiley" style="height: 1em; max-height: 1em;" /></p>
<p>说实话，我只拿 Swift SDK 实打实验证过；其他平台服务端说的是同一套 v2 协议，实在不行还有纯 HTTP 和 OTLP 兜底。调试包发的是测试事件，在界面的「测试数据」下面能看到。</p>
<h2>读取这半边：给 AI 一把只读的钥匙</h2>
<p>这半边是这次新加的。设置页「读取 API key」下面可以签发一把<b>读取 key</b>，前缀是 <code>tlr_</code>（写入 key 是 <code>tl_</code>，一眼能分清）。它有几个特点：</p>
<p>1. 只绑定一个 App，key 在哪个 App 下签发，就只能读哪个 App，连 app id 都不用传；<br />
2. 只读：拿它去上报事件，服务器直接回 403；反过来拿写入 key 去读，也是 403；<br />
3. 进不了管理接口，也不能增删 key；<br />
4. 随时可以吊销，立即生效。</p>
<p>签发之后，下面的「让 AI agent 分析数据」会把服务器地址和这把 key 填好，你只需要在框里把问题写完（这个框是能编辑的），再复制出去。</p>
<p><img decoding="async" src="https://luy.li/wp-content/uploads/2026/11/telemetrylite-ai-analyze.webp" alt="签发读取 key 后，分析提示词自动填好，问题写在最后一行" /></p>
<p>提示词就这么几行：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">用我自托管的 TelemetryLite 只读 API 分析我的 App 的使用数据。

- 服务器: &lt;SERVER_URL&gt;
- 读取 key: &lt;READ_KEY&gt;  (放在请求头 &quot;Authorization: Bearer &lt;READ_KEY&gt;&quot; 里发送)
先从这里开始,并按它返回的说明操作:
  curl -s -H &quot;Authorization: Bearer &lt;READ_KEY&gt;&quot; &lt;SERVER_URL&gt;/r/v1/

我的问题: &lt;在这里写你的问题&gt;</pre><p></p>
<h2>提示词为什么能这么短？</h2>
<p>因为该说的话，都让接口自己说了。agent 请求 <code>/r/v1/</code>，拿到的是一份“使用说明书”，顶层字段是这些：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">['service', 'version', 'app', 'data', 'platforms', 'event_types', 'custom_parameters', 'guide_for_agents', 'examples', 'fields', 'endpoints', 'conventions']</pre><p></p>
<p>里面有这个 App 的数据起止时间、平台、近 30 天出现过的事件类型、事件里带的自定义参数名，每个接口都有哪些参数，还有两块是专门写给 agent 看的：</p>
<p><code>guide_for_agents</code> 是 4 条做事指引：先看 overview 再往下钻；出错了读 hint 自己修；结论要附上数字和时间范围，数据太少就直说别猜；别把 key 写进文件或提交到仓库。</p>
<p><code>examples</code> 是 9 条现成的查询，比如“每日活跃用户”“各版本用户数”“某个事件按自定义参数拆分”“最近的原始事件”。agent 照着改两个名字就能跑。</p>
<p>这样做的好处是：以后想调整指引，改服务端就行，不用让大家重新复制提示词。</p>
<p>还有一点我挺在意的：参数拼错了，不能悄悄忽略。静默忽略的话，agent 会拿着一份错的结果一本正经地分析，那才吓人！所以现在是直接报错，而且告诉你该怎么改：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">$ curl -s -H &quot;Authorization: Bearer $KEY&quot; &quot;http://127.0.0.1:8899/r/v1/query?metirc=users&quot;
{&quot;error&quot;:&quot;unknown_parameter&quot;,&quot;message&quot;:&quot;unknown parameter \&quot;metirc\&quot;&quot;,&quot;hint&quot;:&quot;valid parameters here: days, since, until, test, platform, tz, format, type, where, metric, group_by, interval, order, limit&quot;}</pre><p></p>
<h2>真问一个问题试试</h2>
<p>就拿截图里那个问题：“最近 7 天哪个 App 版本的用户最多？iOS 和 Android 的购买情况有什么差别？”agent 会去调 <code>/r/v1/query</code>，加上 <code>format=md</code> 让它直接返回 Markdown 表格（比 JSON 省 token）：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">$ curl -s -H &quot;Authorization: Bearer $KEY&quot; &quot;$B/r/v1/query?metric=users&amp;group_by=app_version&amp;days=7&amp;format=md&quot;
| app_version | users |
| --- | --- |
| 1.1 | 60 |
| 1.2 | 49 |
| 1.0 | 48 |

$ curl -s -H &quot;Authorization: Bearer $KEY&quot; &quot;$B/r/v1/query?type=Purchase.completed&amp;metric=events,users&amp;group_by=platform,payload.plan&amp;days=7&amp;format=md&quot;
| platform | payload.plan | events | users |
| --- | --- | --- | --- |
| iOS | monthly | 28 | 22 |
| iOS | yearly | 24 | 19 |
| Android | yearly | 13 | 13 |
| Android | monthly | 11 | 11 |</pre><p></p>
<p>（数据是我灌的随机示例数据，别太认真哈哈。）注意第二条里的 <code>payload.plan</code>——它是我在事件里自己加的一个参数，<code>query</code> 可以直接按它分组，不用事先在后台配置什么。拿到这两张表，剩下的归纳总结就是 agent 的活儿了。</p>
<h2>几个取舍和注意事项</h2>
<p>1. <b>读取 key 只放请求头，不放 URL。</b>写入 key 放在路径里，是因为 TelemetryDeck 的 SDK 不发鉴权头，没办法；读取没有这个限制，就别让它进 nginx 的访问日志了。<br />
2. <b>读取 key 能看到事件里全部的自定义参数。</b>统计事件里别塞手机号、邮箱这类个人信息。这跟用不用 AI 无关，但现在多了一把能读的钥匙，更要注意。<br />
3. <b>没做原始 SQL 接口。</b>聚合都走 <code>query</code>：指标、最多 3 个分组字段、时间粒度，字段走白名单，自定义参数也能分组。SQL 等以后真不够用了再说。<br />
4. <b>有限流和超时。</b>每把 key 每分钟 120 次请求，单个查询 5 秒没跑完就直接取消，免得 agent 手滑写个大范围查询，把写入给拖慢了。<br />
5. <b>暂时没做 MCP。</b>现在就是 curl，任何能跑命令的 agent 都能用，什么都不用装。TelemetryDeck 官方前阵子出了 <a href="https://telemetrydeck.com/blog/mcp/">MCP 服务器</a>，思路是一样的：让 AI 直接读你的统计。我先把 HTTP 这层做扎实，以后要包一层 MCP 也容易。</p>
<h2>怎么升级</h2>
<p>已有的服务器，重新跑一遍安装命令就能升到 0.2.0，原来的写入 key 照常可用，SDK 那边不用动。唯一要提醒的是：0.2.0 会把数据库升到新版本，这一步不可逆，升级前最好备份一下（SQLite 是 WAL 模式，别直接 cp）：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">sudo -u telemetrylite sqlite3 /var/lib/telemetrylite/telemetrylite.db &quot;.backup '/var/lib/telemetrylite/backup.db'&quot;
curl -fsSL https://github.com/bones7456/telemetrylite/releases/latest/download/install.sh | sh</pre><p></p>
<p>更详细的说明在 GitHub 上的 <a href="https://github.com/bones7456/telemetrylite">TelemetryLite</a> 仓库，读取 API 的完整参数见 <a href="https://github.com/bones7456/telemetrylite/blob/main/docs/READ_API.zh-CN.md">docs/READ_API.zh-CN.md</a>，有问题欢迎提 issue～</p>
<h2>最后</h2>
<p>不说了，我去把手头几个 App 的读取 key 都发一下。想想也挺有意思的：App 是 AI 写的，统计是 AI 接的，现在连看统计也交给 AI，这下是真闭环了哈哈！以后想看数据，直接问 Claude 就行，省下来的页面不用再一个个点，大概又够我 vibe 出一个新 App 了。。。<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f605.png" alt="😅" class="wp-smiley" style="height: 1em; max-height: 1em;" /></p><p>The post <a href="https://luy.li/2026/11/09/telemetrylite-ai/">TelemetryLite 的 AI 集成玩法</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></content:encoded>
					
					<wfw:commentRss>https://luy.li/2026/11/09/telemetrylite-ai/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>TelemetryDeck 平替：TelemetryLite</title>
		<link>https://luy.li/2026/11/08/telemetrylite/</link>
					<comments>https://luy.li/2026/11/08/telemetrylite/#respond</comments>
		
		<dc:creator><![CDATA[bones7456]]></dc:creator>
		<pubDate>Sun, 08 Nov 2026 00:02:54 +0000</pubDate>
				<category><![CDATA[精华]]></category>
		<category><![CDATA[经验技巧]]></category>
		<category><![CDATA[编程相关]]></category>
		<guid isPermaLink="false">https://luy.li/?p=2649</guid>

					<description><![CDATA[<p>我一直拿 TelemetryDeck 给自己的 App 做使用统计，隐私友好，SDK 也省心，用着一直挺舒服。 [&#8230;]</p>
<p>The post <a href="https://luy.li/2026/11/08/telemetrylite/">TelemetryDeck 平替：TelemetryLite</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></description>
										<content:encoded><![CDATA[<p>我一直拿 <a href="https://telemetrydeck.com/">TelemetryDeck</a> 给自己的 App 做使用统计，隐私友好，SDK 也省心，用着一直挺舒服。直到最近，我发现自己好像把它的免费额度快用&#8221;超标&#8221;了。。。</p>
<p>原因也简单：vibe coding 玩多了以后，App 的产出速度完全失控——今天一个小工具、明天一个小 App，不知不觉手上的 App 越来越多，免费额度就肉眼可见地不够用了。</p>
<p>掏钱升级吧，又觉得为一堆还没几个用户的小 App 付费有点肉疼；那自己搭一个？我在网上找了一圈，没找到合适的。我要的其实不多：轻、能自己部署、最好能直接用 TelemetryDeck 的 SDK（App 里的埋点代码我是一点都不想动）。</p>
<p>行吧，那就自己 vibe coding 一个。折腾了一阵，成品就是今天要介绍的 <a href="https://github.com/bones7456/telemetrylite">TelemetryLite</a>：一个 Rust 单二进制 + SQLite 的极简 App 统计服务，已经开源了。（基本是我和 Claude Code 一起聊出来的，我负责提需求、拍板和嫌弃<img src="https://s.w.org/images/core/emoji/17.0.2/72x72/1f604.png" alt="😄" class="wp-smiley" style="height: 1em; max-height: 1em;" />）分享给一样爱vibe coding的朋友。<br />
<span id="more-2649"></span></p>
<h2>它到底是个什么东西？</h2>
<p>一句话：<b>一个能直接吃 TelemetryDeck SDK 数据的、自己部署的极简统计后台。</b>几个特点：</p>
<p><b>轻。</b>就一个静态编译的二进制，五兆多，数据就是一个 SQLite 文件，空载内存十来 MB。没有数据库服务、没有消息队列，丢到服务器上就能跑。</p>
<p><b>不用改埋点。</b>SDK 里只要把服务器地址（baseURL）指过来就行，埋点代码基本不用动。顺带也兼容 OpenTelemetry 的 OTLP/HTTP Logs。</p>
<p><b>隐私友好。</b>不存 IP。国家和城市是用 <a href="https://db-ip.com">DB-IP</a> 的免费库在内存里现查的，查完 IP 就扔，库里只留国家和城市。</p>
<p><b>界面够用。</b>活跃用户、事件趋势、按周留存、各版本占比随时间的变化、新老用户、错误、设备/系统/语言/国家城市分布，该有的都有。鼠标悬停时那种带日期和百分比的小卡片，是我对着 TelemetryDeck 的页面抄的哈哈。界面有中英文；同一个 App 的 iOS 和安卓版本也可以共用，用一个下拉框按平台筛选。</p>
<p><b>自己发 key。</b>在后台给每个 App 签发只有写入权限的 key，泄露了吊销重发就行。</p>
<p><b>省心的运维。</b>一行命令安装，更新也是同一条命令（用 systemd 的话，新版本起不来还会自动回滚）。发布前还有一套回归测试在 CI 里挡着，毕竟代码是 AI 写的，我心里没底，就让它多测测。。。</p>
<h2>最简单的用法是什么？</h2>
<p>就三步。</p>
<p>第一步，装到服务器上。因为这个脚本是用 root 权限改系统的，我建议先下载下来看一眼，再 &#8211;dry-run 预演一下，没问题再装（README 里我特意标了 USE ON YOUR OWN RISK，别嫌我啰嗦）：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">curl -fsSL https://github.com/bones7456/telemetrylite/releases/latest/download/install.sh -o install.sh
less install.sh          # 先看一眼
sh install.sh --dry-run  # 只预演，不改任何东西
sh install.sh</pre><p></p>
<p>装完会打印一个管理员密码，<b>只显示一次</b>，记得存好。服务默认只监听本机的 8888 端口，要挂域名和 HTTPS 的话，前面放个 nginx 就行（脚本也可以帮你配），这块细节去看文档。</p>
<p>第二步，登录后台，新建一个 App，到「设置」里签发一个 key。名称默认填的是当前时间，你也可以改成 ios-prod 这种一眼能认出来的。</p>
<p>第三步，改 SDK 的地址。以 Swift 为例，只改初始化那一处：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">let config = TelemetryDeck.Config(
    appID: &quot;你的 App ID&quot;,
    baseURL: URL(string: &quot;https://你的域名/k/你的key/&quot;)!)
TelemetryDeck.initialize(config: config)</pre><p></p>
<p>这里有个小细节：key 是放在地址路径里的，因为 <a href="https://github.com/TelemetryDeck/SwiftSDK">TelemetryDeck 的 Swift SDK</a> 发请求时不带任何鉴权头，只能这么玩（claude说它确认过）。</p>
<p>嫌麻烦的话，还有个偷懒的办法：后台「设置」页里有一块「让 AI agent 完成接入」，里面是一段已经把你的服务器地址、App ID 和 key 都填好的提示词，点一下复制，丢给 Claude Code 或者 Codex，让它去帮你接。毕竟 vibe coding 出来的 App，接统计这种事也交给 AI，才顺理成章嘛～</p>
<h2>有什么短板？</h2>
<p>坦白一下：</p>
<p>1. 只有一个管理员账号，没有多用户和角色；<br />
2. 单机 SQLite，设计目标是每天十万以内的事件，再大就别指望了；<br />
3. 没有 TelemetryDeck 那种自己拼查询的 Playground，也不能跨 App 汇总。</p>
<p>我自己用，这些都够了。</p>
<p>不说了，我先去把手头几个 App 的 baseURL 改过来试试水。想想也挺有意思的：vibe coding 带来的&#8221;额度焦虑&#8221;，最后还是靠 vibe coding 解决了，闭环了哈哈。项目在 <a href="https://github.com/bones7456/telemetrylite">GitHub</a> 上，更详细的安装、nginx 配置和各种选项，都在 README 和 docs 里，有问题欢迎提 issue～</p><p>The post <a href="https://luy.li/2026/11/08/telemetrylite/">TelemetryDeck 平替：TelemetryLite</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></content:encoded>
					
					<wfw:commentRss>https://luy.li/2026/11/08/telemetrylite/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>端里的链接那些事：从 OSC 到 OSC 8</title>
		<link>https://luy.li/2026/11/05/osc-8-2/</link>
					<comments>https://luy.li/2026/11/05/osc-8-2/#respond</comments>
		
		<dc:creator><![CDATA[bones7456]]></dc:creator>
		<pubDate>Thu, 05 Nov 2026 12:45:54 +0000</pubDate>
				<category><![CDATA[经验技巧]]></category>
		<category><![CDATA[编程相关]]></category>
		<guid isPermaLink="false">https://luy.li/?p=2643</guid>

					<description><![CDATA[<p>前两天在自己维护的 Notchy（一个藏在 MacBook 刘 海里的终端）里跑 Claude Code，它回 [&#8230;]</p>
<p>The post <a href="https://luy.li/2026/11/05/osc-8-2/">端里的链接那些事：从 OSC 到 OSC 8</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></description>
										<content:encoded><![CDATA[<p>前两天在自己维护的 <a href="https://github.com/bones7456/notchy">Notchy</a>（一个藏在 MacBook 刘 海里的终端）里跑 Claude Code，它回复里带了个 GitHub 链接。同样一条消息，在 iTerm2 里链接是蓝色的 ，下面还有一条虚线，一眼就知道能点；到了 Notchy 里却是白花花的普通文字，非得按住 Cmd、把鼠标挪上 去，下划线才肯冒出来。<br />
<span id="more-2643"></span></p>
<p><img decoding="async" src="https://luy.li/wp-content/uploads/2026/11/osc8_terminal_links_compare.webp" alt="同一条 Claude Code 消息，iTerm2 里链接是蓝色带虚 线，Notchy 里是普通文字" width="1500" height="507" class="alignnone size-full wp-image-2645" /></p>
<p>我第一反应是：iTerm2 的链接识别比 SwiftTerm 聪明？结果一路查下去发现，根本不是&#8221;识别&#8221;的问题，而是 Claude Code 压根就给两个终端发了不一样的东西。这里面牵扯到 OSC、OSC 8、终端能力探测，挺有意思的，值得写一篇，分享给有需要的朋友。</p>
<h2>OSC 是什么？</h2>
<p>终端本质上就是在显示一串字节流，程序想让它做点&#8221;显示文字以外&#8221;的事，比如改颜色、挪光标、改窗口标题 ，就得在字节流里夹带转义序列（escape sequence）。这些序列按开头分成几大类，大家最熟的是 <code>ESC [</code> 开头的 CSI，像 <code>\e[31m</code> 变红色就是它。</p>
<p>OSC 是另一类，全称 Operating System Command，格式是：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">ESC ] 编号 ; 参数 ST</pre><p></p>
<p>结尾的 ST（String Terminator）是 <code>ESC \</code>，很多终端也接受一个 BEL 字符（<code>\a</code>）。中间的编号决定干什么，常见的有这么几个：</p>
<p>1. OSC 0 / 2：设置窗口或标签的标题<br />
2. OSC 7：告诉终端当前所在目录（新开标签能继承目录就靠它）<br />
3. OSC 8：超链接，今天的主角<br />
4. OSC 52：读写系统剪贴板（ssh 到远端也能复制到本机，就是它）<br />
5. OSC 133：标记提示符和命令输出的边界，&#8221;跳到上一条命令&#8221;这类功能靠它</p>
<p>说起来 OSC 0 我早就用过，只是当时不知道它叫这名字。2009 年我写过一篇<a href="https://luy.li/2009/03/06/gt_title_ansi_con/">修改 gnome-terminal 的 title 的办法和杂七杂八的 ANSI 控制码记录</a>，为了区分连着不同服务器的一堆终端窗口，从 Portage 的源码里抄了一句 <code>echo -ne "\e]0;test\a"</code> 来改标题，那正是一个以 BEL 结尾的 OSC 0。文章后半截记的颜色、光标那些，则大多是 CSI。十七年过 去了，还在跟这些转义序列打交道，哈哈。</p>
<p>不认识某个 OSC 的终端会直接把它吞掉，不会显示乱码，这也是 OSC 能一直往上加新功能的原因。</p>
<h2>OSC 8：终端里的 &lt;a href&gt;</h2>
<p>OSC 8 干的事，就跟网页里的 <code>&lt;a href&gt;</code> 一模一样：把一段文字和一个 URL 绑在一起。</p>
<p>它其实很年轻，2017 年才由 GNOME VTE 的维护者 Egmont Koblinger 提出，规范就是<a href="https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda">他的这篇 gist</a>。没走什么标准组织，全靠各家终端自觉跟进，当年最早支持的是 GNOME Terminal（VTE 0.50）和 iTerm2 3.1。也就是说，我 2009 年 折腾 OSC 0 的时候，OSC 8 还得再等八年才出生（那会儿终端里的链接，全靠终端自己猜）。格式长这样：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">ESC ] 8 ; 参数 ; URL ST   显示的文字   ESC ] 8 ; ; ST</pre><p></p>
<p>前面一段打开链接，后面一个 URL 为空的 OSC 8 把链接关上，夹在中间的文字就是可点击的部分。参数一般 留空，也可以写 <code>id=xxx</code>，让终端把被换行拆开的同一个链接当成一个整体。</p>
<p>想自己试试的话，在终端里执行：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">printf '\e]8;;https://github.com\e\\点我去 GitHub\e]8;;\e\\\n'</pre><p></p>
<p>屏幕上只会出现&#8221;点我去 GitHub&#8221;几个字，URL 是藏在后面的。我在 iTerm2 和 Notchy 里都跑了一下，两边按住 Cmd 点都能打开 github.com；区别是不按 Cmd 的时候，iTerm2 下面有一条虚线，Notchy 啥也没有（这个后面细说）。</p>
<h2>终端里的链接其实有两种</h2>
<p>搞明白 OSC 8 之后，就能理解终端里的链接其实分两种来源：</p>
<p><b>显式链接</b>：程序用 OSC 8 明确告诉终端&#8221;这几个字是链接，指向哪&#8221;。终端在存每个字符格子的时候， 顺手把链接信息记在格子属性里，所以随时都知道哪里能点，想一直画个下划线也毫无压力。显示的文字也可 以是任意内容，比如 Markdown 里的 <code>[docs](https://...)</code>，屏幕上就只显示 docs。</p>
<p><b>隐式链接</b>：程序就是输出了一串普通文字，终端自己拿正则去扫，猜哪段长得像 URL 或文件路径。这 种只能显示 URL 本身，边界还容易猜错（结尾的标点、括号、紧挨着的中文，都可能被多吃或少吃）。更关键的是正则不便宜，要一直画下划线，就得每次屏幕变化都把整屏扫一遍。所以很多终端（包括 Notchy 用的 <a href="https://github.com/migueldeicaza/SwiftTerm">SwiftTerm</a>）都只在你按住 Cmd 悬停的时候，才对鼠标底下那一行临时算一次。</p>
<p>所以开头那个现象，原因其实是：<b>在 iTerm2 里，Claude Code 发的是显式链接；在 Notchy 里，发的是普通文字。</b>那条蓝色和虚线，都是显式链接才有的待遇。</p>
<h2>程序怎么知道终端支不支持 OSC 8？</h2>
<p>问题来了，终端吞掉不认识的 OSC 不会乱码，那程序为啥不干脆一律发 OSC 8？</p>
<p>因为没法问。终端没有一个标准的方式告诉程序&#8221;我支持超链接&#8221;，程序只能看环境变量去猜。我把 Claude Code（2.1.312）的可执行文件扒了一下，它的判断分两层。</p>
<p>第一层是 Node 生态里常用的 <a href="https://github.com/jamestalmage/supports-hyperlinks">supports-hyperlinks</a> 库，按 <code>TERM_PROGRAM</code> 和版本号判断，前提是标准输出得是个终端：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">iTerm.app   版本 &gt;= 3.1
WezTerm     版本 &gt;= 20200620
vscode      版本 &gt;= 1.72
ghostty     不限</pre><p></p>
<p>眼熟吧？iTerm2 的门槛 3.1，正是它开始支持 OSC 8 的版本。</p>
<p>第二层是 Claude Code 自己补的一个名单，不看版本：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">ghostty, Hyper, kitty, alacritty, iTerm.app, iTerm2, WarpTerminal</pre><p></p>
<p>另外还有一些零碎的条件：<code>LC_TERMINAL</code> 在上面名单里（iTerm2 会设 <code>LC_TERMINAL=iTerm2</code>，这样 ssh 出去也能带上）、Windows Terminal 的 <code>WT_SESSION</code>、JetBrains 的 <code>TERMINAL_EMULATOR=JetBrains-JediTerm</code>、tmux 3.4 以上、基于 VTE 的终端（GNOME Terminal 之类）等等。</p>
<p>Notchy 设置的是 <code>TERM_PROGRAM=Notchy.app</code>，哪个名单都不在，所以 Claude Code 老老实实输出了普通文字。白名单这种东西，小众终端天然就吃亏。。。</p>
<h2>FORCE_HYPERLINK：自己声明一下</h2>
<p>好在所有判断之前，还有一个优先级最高的开关：环境变量 <code>FORCE_HYPERLINK</code>。设成 1 就直接 当作支持，设成 0 就当作不支持，后面的名单统统不看。</p>
<p>在 Notchy 里这么启动一下：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">FORCE_HYPERLINK=1 claude</pre><p></p>
<p>同一条消息里的链接立马变蓝了，按住 Cmd 一点就开，跟 iTerm2 的效果基本一致。</p>
<p>有人可能会想：那把 <code>TERM_PROGRAM</code> 改成 <code>iTerm.app</code> 不也行？千万别。。。冒充别的终端，其他程序会按 iTerm2 的能力来跟你说话，什么专有转义序列、图片协议都可能发过来，那就是给 自己找麻烦了。<code>FORCE_HYPERLINK</code> 本来就是设计给&#8221;不在名单里、但确实支持&#8221;的终端用来自报家门的，用它才是正路。</p>
<h2>需要注意的几点</h2>
<p>1. <b>FORCE_HYPERLINK 会跳过&#8221;是不是终端&#8221;的检查。</b>supports-hyperlinks 一看到这个变量就直接返回 ，不再检查输出是不是 tty。所以在设了它的 shell 里，用这个库的 Node 命令行工具，把输出重定向到文件时可能会夹带 OSC 8 序列。Claude Code 自己倒没这个问题，我试了 <code>FORCE_HYPERLINK=1 claude -p ... &gt; out.txt</code>，文件里干干净净。</p>
<p>2. <b>显式链接不等于一直有下划线。</b>程序发了 OSC 8，终端怎么画是终端自己的事。iTerm2 默认给显式链接一直画虚线；SwiftTerm 默认是 <code>.hoverWithModifier</code>，不管显式隐式，都要按住 Cmd 悬停才画。SwiftTerm 其实还有个 <code>.always</code> 模式，可它有两个副作用：不按 Cmd 单击就会打开链接，而且正则识别的隐式链接直接不能点了。对一个经常要 Cmd+点击文件路径的终端来说，这代价太大。</p>
<p>3. <b>环境变量是启动时定死的。</b>给终端加了 <code>FORCE_HYPERLINK</code> 之后，已经开着的标签不 会生效，得新开一个。</p>
<p>好吧，如果你也用 <a href="https://github.com/bones7456/notchy">Notchy</a> 可以先自己把 <code>FORCE_HYPERLINK</code> 加上，或者我下个版本加个配置项，默认注入这个环境变量吧；至于&#8221;不按 Cmd 也有下划线&#8221;，还得去给 SwiftTerm 提个 PR，加一个跟 iTerm2 一样的模式。偏偏上游正在憋 2.0 的大重 构，1.x 已经不发版了，这个 PR 就算合了，估计也还要点时间。。。但我觉得，在APP没有输出 OSC 8 的情况下，Notchy识别链接其实是比 iTerm2 准的，不信的话，你用下就知道了！</p><p>The post <a href="https://luy.li/2026/11/05/osc-8-2/">端里的链接那些事：从 OSC 到 OSC 8</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></content:encoded>
					
					<wfw:commentRss>https://luy.li/2026/11/05/osc-8-2/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
		<item>
		<title>网页定位踩坑记</title>
		<link>https://luy.li/2026/11/02/web_geo/</link>
					<comments>https://luy.li/2026/11/02/web_geo/#respond</comments>
		
		<dc:creator><![CDATA[bones7456]]></dc:creator>
		<pubDate>Mon, 02 Nov 2026 12:50:14 +0000</pubDate>
				<category><![CDATA[流水帐]]></category>
		<guid isPermaLink="false">https://luy.li/?p=2638</guid>

					<description><![CDATA[<p>之前我写过一个新加坡天气云图的小页面，照着官方网站糊的，补上了官方没有的&#8221;你所在的位置&#8221 [&#8230;]</p>
<p>The post <a href="https://luy.li/2026/11/02/web_geo/">网页定位踩坑记</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></description>
										<content:encoded><![CDATA[<p>之前我写过一个<a href="https://luy.li/2025/11/20/sg_weather/">新加坡天气云图</a>的小页面，照着官方网站糊的，补上了官方没有的&#8221;你所在的位置&#8221;，还能看历史。自己天天在用，挺顺手。</p>
<p>直到前两天，我在 Unihertz Titan 2 的 Chrome 上打开它，面板底部赫然一行红字：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">获取位置信息失败，请参考这里。</pre><p></p>
<p>奇怪的是，同一部手机上 Google Maps 定位好好的，Chrome 的位置权限我也手动给了，Mac 和 iPhone 上的 Safari 打开同一个页面也都正常。我意识到，不妙，又来活儿了～<br />
<span id="more-2638"></span><br />
<img decoding="async" src="https://luy.li/wp-content/uploads/2026/11/web_geo.webp" alt="" width="1000" height="563" class="alignnone size-full wp-image-2640" /></p>
<p>这篇就把这次排查的结果记下来：一个把定位&#8221;悄悄&#8221;拦掉的响应头，一个 nginx 里关于 <code>add_header</code> 的老坑，还有后来发现的定位慢的问题。值得写一篇，分享给有需要的朋友。</p>
<h2>权限明明给了，为什么还是失败？</h2>
<p>先排除手机本身。系统定位是开的，Chrome 的定位权限也确实是已授予。连上电脑用 adb 确认：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">adb shell dumpsys package com.android.chrome | grep ACCESS_FINE_LOCATION
  android.permission.ACCESS_FINE_LOCATION: granted=true, flags=[ ... ]</pre><p></p>
<p>那问题就在页面这边。看了一眼页面代码，取位置失败的回调里只有一句 <code>console.log</code> 加一个红字提示，没有任何有用的信息。于是我换个思路，直接看服务器给了什么响应头：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">curl -sI https://luy.li/data/w/ | grep -i permissions
permissions-policy: camera=(), microphone=(), geolocation=(), payment=()</pre><p></p>
<p>就是它！<code>geolocation=()</code> 的意思是：<b>本站任何页面都不许使用定位</b>。这是 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy">Permissions-Policy</a> 响应头，浏览器会在权限检查之前就把请求拒掉，所以不管你在浏览器里给了多少权限，页面里的 <code>navigator.geolocation</code> 都只会走到错误回调，也不会弹授权框。</p>
<p>那为什么 Safari 正常？据我所知，WebKit 对这个响应头基本不执行（它对 iframe 的 allow 属性支持得比较好），所以头里写了禁止，Safari 照样能弹框、能定位。Google Maps 是原生 App，更不走网页策略，当然更没事。</p>
<p>说起来，这个头还真不是什么神秘的东西，是我自己加的。九月底那阵子，博客的安全插件一直提示我不安全，扫描器里六个安全头全是 Not Found，我就照着<a href="https://luy.li/2026/09/26/https_headers/">博客安全头踩坑记</a>里写的，在 nginx 里一口气补齐了。其中 Permissions-Policy 这一行的想法特别朴素：摄像头、麦克风、定位这些用不上的浏览器能力全关了。但没想到我之前偷懒挂在博客域名下的这个天气页面受到了影响。哈哈！</p>
<h2>只放开一个路径：nginx 的 add_header 继承坑</h2>
<p>当然不能整站都改成允许定位，我只想放开 <code>/data/w/</code>。第一反应是给它单独写个 location，再加一行 add_header。但是 nginx 有个很经典的坑（上面那篇里我也踩过一次）：<b>某个 location 里只要写了自己的 add_header，就不会再继承外层（server 级）的所有 add_header</b>。这意味着我得把 HSTS、CSP 那一堆安全头在新 location 里全抄一遍，以后改一处要同步两处，迟早漏。</p>
<p>更省事的办法是用 <code>map</code>，让同一个头的值随路径变化。<a href="https://nginx.org/en/docs/http/ngx_http_headers_module.html#add_header">add_header</a> 只保留 server 级那一行，其他什么都不用动：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">map $uri $permissions_policy {
    default        &quot;camera=(), microphone=(), geolocation=(), payment=()&quot;;
    ~^/data/w/     &quot;camera=(), microphone=(), geolocation=(self), payment=()&quot;;
}

server {
    ...
    add_header Permissions-Policy $permissions_policy always;
}</pre><p></p>
<p><code>map</code> 必须放在 server 块外面、http 上下文里（我的配置文件第一个就是 server 块，说明它是被 http 块 include 进来的，放文件开头就行）。reload 之后验证一下，只有目标路径放开了：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">curl -sI https://luy.li/data/w/ | grep -i permissions
permissions-policy: camera=(), microphone=(), geolocation=(self), payment=()

curl -sI https://luy.li/ | grep -i permissions
permissions-policy: camera=(), microphone=(), geolocation=(), payment=()</pre><p></p>
<p>手机上刷新，Chrome 弹出授权框，点允许，蓝点出现了～</p>
<h2>蓝点出现得好慢？</h2>
<p>问题解决了吗？没有，因为我发现蓝点要过好几秒才出来。我一开始的判断很干脆：页面里写的是 <code>enableHighAccuracy: true</code>，这会强制走 GPS，室内搜星慢，改成 false 用 Wi-Fi / 基站定位应该秒出。</p>
<p>但是光猜不行，得量。Chrome 在安卓上可以通过 adb 转发出 DevTools 端口：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">adb forward tcp:9223 localabstract:chrome_devtools_remote
curl -s localhost:9223/json   # 列出当前所有标签页</pre><p></p>
<p>然后通过 <a href="https://chromedevtools.github.io/devtools-protocol/">CDP</a> 的 <code>Page.addScriptToEvaluateOnNewDocument</code> 在页面脚本之前注入一小段代码，包装 <code>navigator.geolocation</code> 的回调，记录每次定位什么时候返回、蓝点什么时候显示。这样量出来的是真实耗时，不靠肉眼。</p>
<p>先是普通刷新三次，蓝点 0.86 到 1.36 秒出现，其实不算慢，也没复现我肉眼看到的&#8221;好几秒&#8221;。后来我直接用 <code>screenrecord</code> 录下自己手动操作的过程，再用 ffmpeg 拆成每秒 10 帧、逐帧检测蓝点的颜色，终于抓到了：连续点三次刷新，蓝点出现的时间是 1.4 秒、2.1 秒、3.0 秒，<b>一次比一次慢</b>。</p>
<p>我用脚本模拟同样的快速刷新（间隔约 4 秒），也复现了：1.3 → 1.6 → 2.5 → 2.8 秒。间隔拉开到 8 秒以上就没有这个现象。开不开录屏结果都一样。</p>
<p>那是不是 <code>enableHighAccuracy</code> 的问题？我把三种写法放在同样的条件下对比（快速刷新 5 次，每组之间等 25 秒）：</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">现行(低精度+GPS监听)  0.67s  2.14s  未出现  0.55s  2.04s
仅低精度              1.27s  2.74s  未出现  1.37s  2.86s
原版(仅高精度)        1.34s  2.83s  未出现  1.46s  2.98s</pre><p></p>
<p>三种写法的波动规律完全一致。结论很清楚：<b>慢不是页面参数造成的，是安卓系统和 Chrome 的定位层在短时间内连续请求时本身就时快时慢</b>，页面这边改什么参数都没用。我最开始那个&#8221;改成低精度就秒出&#8221;的判断，被数据直接打脸了。。。</p>
<h2>页面层能做的：缓存一个短时间的位置</h2>
<p>系统定位快慢我控制不了，那就让蓝点不依赖它。思路很简单：把上一次拿到的位置连同时间戳存进 <code>localStorage</code>，打开页面先拿缓存画蓝点，同时照常发起真正的定位，成功后再更新。</p>
<p>有两个细节我是想清楚了才加的：</p>
<p>1. 缓存只认 3 分钟内的。位置过期了就不显示，免得定位一直失败的时候，蓝点永远停在旧地方。<br />
2. 只有真正定位成功才更新缓存，失败了缓存不动。</p>
<p></p><pre class="urvanov-syntax-highlighter-plain-tag">const CACHE_KEY = 'weather.lastPosition';
const CACHE_TTL = 3 * 60 * 1000;
try {
    const cached = JSON.parse(localStorage.getItem(CACHE_KEY));
    if (cached &amp;&amp; Date.now() - cached.time &lt;= CACHE_TTL) {
        this.userPosition = { lat: cached.lat, lng: cached.lng };
        this.updateUserLocationPosition();
    }
} catch (e) { /* 缓存不可用或已损坏，忽略 */ }

navigator.geolocation.getCurrentPosition(
    (position) =&gt; {
        this.userPosition = { lat: position.coords.latitude, lng: position.coords.longitude };
        this.updateUserLocationPosition();
        try {
            localStorage.setItem(CACHE_KEY, JSON.stringify({ ...this.userPosition, time: Date.now() }));
        } catch (e) {}
    },
    (error) =&gt; {
        // 没有可显示的缓存位置时才提示失败
        if (!this.userPosition) this.locationErrorMessage.style.display = 'block';
    },
    { enableHighAccuracy: true, timeout: 10000, maximumAge: 300000 }
);</pre><p></p>
<p>我通过 DevTools 把线上页面临时换成本地新文件，在手机上连续刷新四次：蓝点出现的时间都是 0.01 秒。当然，缓存是空的时候（第一次打开，或者隔了三分钟以上），还是得老老实实等系统定位，这点没法改。</p>
<h2>总结一下几个坑</h2>
<p>1. <b>Permissions-Policy 拦截在权限弹窗之前。</b>浏览器里权限给了也没用，页面也不会弹框，只会静悄悄地走错误回调。遇到&#8221;权限明明给了却定位失败&#8221;，先 <code>curl -I</code> 看一眼响应头，比反复折腾手机设置快得多。<br />
2. <b>Safari 正常不代表没问题。</b>这个响应头在不同浏览器上的执行力度不一样，测定位功能，Chrome 一定要测。<br />
3. <b>测速要把刷新间隔拉开。</b>连续快速刷新时，系统定位会越来越慢，拿这个当基线会得出错误结论。<br />
4. <b>别光靠猜。</b>&#8220;高精度会强制 GPS 所以慢&#8221;听起来天经地义，实际一量就不是那么回事。</p>
<p>全文完。</p><p>The post <a href="https://luy.li/2026/11/02/web_geo/">网页定位踩坑记</a> first appeared on <a href="https://luy.li">I am LAZY bones?</a>.</p>]]></content:encoded>
					
					<wfw:commentRss>https://luy.li/2026/11/02/web_geo/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
			</item>
	</channel>
</rss>
