用途：为 joel.dev 生成短链接和配套二维码资产，适用于舞台或演示用短链、joel.dev 跳转、手机相机界面中易读的链接标签，以及可复制的二维码文件。
主要能力：优先使用可用的 Pi 工具 shortlink_qr，传入 slug、url、title、push、background 等参数即可。工具会在短链服务的 _redirects 文件中新增或更新 /<slug> <target-url> 映射；从矢量源生成原生 HiDPI 二维码资产，而不是放大低分辨率 PNG；默认在 resources/qr/ 下生成 1500×1500 PNG 及同名 SVG；默认把 PNG 复制到 macOS 剪贴板（可设 clipboard: false 关闭）；push: true 时以 shitratgit[bot] 身份提交短链改动，并将短链检出抓取/重置到 origin/master；更新 .brain/resources/shortlinks.svx 作为本地 Brain 资源清单；返回短链接、目标 URL、二维码路径、提交 URL、Brain 文件路径，以及在可用时通过 portless/pi-notes 返回本地 Brain URL。
背景变体：background 可有意选择 transparent（默认，适合幻灯片与设计工具）、white（透明渲染不佳时的黑码白底）、black（深色幻灯片用的白码黑底）。
为什么用短链：手机相机界面通常显示编码后的 URL 或域名，而非自定义标签，因此编码友好的 https://joel.dev/<slug> 会让扫描显示更易读。
Brain 资源规则：每个生成的短链都应作为资源清单条目写入 .brain/resources/shortlinks.svx，便于在本地 pi-notes/portless 审查页中复制短 URL、目标 URL、PNG 路径、SVG 路径和背景样式。本地 Document Host 运行时，最终回答应包含可点击的 Brain URL；扩展会尝试 portless get pi-notes，并映射到 <pi-notes-url>/notes/resources/shortlinks。
回退与限制：若 Netlify 部署过期或短链路由存疑，应生成直接指向原始 URL 的二维码以确保舞台安全，并明确说明，不要悄悄交付依赖未验证跳转的二维码；若 ShitRat 无法访问短链仓库，不要以 Joel 身份推送，而应返回本地文件改动并请求缺失的 ShitRat 或授权步骤。其他功能、收费、价格、平台与效果资料暂未提供。