用途：把任意文件发布为 GitHub Gist，方便公开或私下分享代码、笔记与 Markdown。默认使用 gh CLI，需先确认已认证：gh auth status；若未认证则运行 gh auth login。也可通过设置带 gist 权限的 GITHUB_GIST_TOKEN 环境变量作为备选方案。
主要能力：发布单个文件；默认私密（未列出），可用 --public 创建公开 Gist；可设置描述、覆盖文件名；支持从标准输入读取内容；可只输出 URL 或在浏览器中打开；可强制使用 API 而非 gh CLI。
使用方式：python3 scripts/publish_gist.py /path/to/file.md 发布为私密；加 --public 公开；-d "描述" 设置描述；-f "readme.md" 覆盖文件名；echo "Hello" | python3 scripts/publish_gist.py - -f "hello.txt" 从 stdin 发布；--url-only 仅输出 URL；--open 创建并打开浏览器。输出为含 url、id、public、filename 的 JSON。
适用场景：分享代码片段、发布 Markdown 笔记或 Obsidian 笔记、快速生成可分享链接。
限制：需预先完成 GitHub 认证或配置 token；资料未说明批量处理、更新已有 Gist、其他平台或收费信息。