datasette-auth-github 1.0 发布：修复会话过期问题

Simon Willison 近日将其维护多年的 Datasette 插件 datasette-auth-github 正式升级到 1.0 版本。这个插件为 Datasette 提供了基于 GitHub 的登录认证能力，此次版本更新的核心是修复了一个影响用户登录体验的 Cookie 过期问题。

从一个真实的登录 Bug 说起

作者在其演示站点 agent.datasette.io 上运行这个 GitHub 登录插件时，注意到自己的认证会话（session）持续时间异常短暂——刚登录不久就需要重新认证。

经过排查，问题根源在于插件在设置 Cookie 时没有携带 Max-Age 参数。缺少这个参数意味着浏览器会将其视为「会话 Cookie」，一旦浏览器会话结束，Cookie 就会被清除。作者特别指出，在 Mobile Safari 上这种会话结束会相当频繁地发生，且与用户实际的使用方式无关。这就导致移动端用户频繁掉线，体验大打折扣。

这个案例也提醒开发者：在实现认证逻辑时，Cookie 的生命周期设置是一个容易被忽视却直接影响用户体验的细节。设置合理的 Max-Age 或 Expires，才能让认证状态在预期时间内保持稳定。

Cookie 的生命周期由两个属性控制：Max-Age（相对秒数，优先级更高）和 Expires（绝对时间戳）。若两者均缺失，浏览器会将该 Cookie 视为「会话 Cookie」，仅在当前浏览器会话期间保留，关闭标签页、重启浏览器或系统休眠唤醒后均可能触发清除。Mobile Safari 的激进内存管理策略会频繁终止后台标签页进程，使得这一问题在 iOS 设备上尤为突出——即便用户只是切换了一次应用，再回来时会话 Cookie 就可能已经消失，被迫重新登录。这与桌面浏览器「长期驻留标签页」的使用习惯截然不同，也是移动端 Web 应用认证实现中常见的兼容性陷阱。

修复方案与版本升级逻辑

针对这一问题，作者在 issue #80 中完成了修复，为 Cookie 补上了 Max-Age 参数，从而让认证会话能够在浏览器会话结束后依然保持有效。

值得一提的是升级到 1.0 的决策逻辑。作者提到，这个插件已经存在相当长的时间，并且同时针对 Datasette 0.65.x 和 Datasette 1.0ax 两个版本进行了测试。基于插件的成熟度和稳定性，他决定借这次修复的机会将其正式提升到 1.0 版本。

作者还坦言，他正在努力养成一个习惯：把那些已经足够稳定的插件正式标记为 1.0。这背后反映的是一种版本管理理念——1.0 不仅是一个数字，更是对使用者作出的稳定性承诺。

对 Datasette 生态的意义

Datasette 是一个用于探索和发布数据的开源工具，而围绕它的插件生态是其扩展能力的重要组成部分。datasette-auth-github 作为认证类插件，让开发者可以方便地通过 GitHub 账号来保护自己的 Datasette 实例，适用于内部数据工具、演示站点等需要访问控制的场景。

此次同时兼容 Datasette 0.65.x 稳定版和 1.0 alpha 版的测试策略，也说明了插件在 Datasette 主体走向 1.0 的过渡期中，仍能为不同版本的用户提供可靠支持。对于依赖该插件的用户来说，直接升级到 1.0 即可获得更稳定的登录会话体验。

Datasette 由 Simon Willison 开发，基于 Python 与 SQLite 构建，核心理念是「任何 SQLite 数据库都可以一键发布为可交互的 Web API 与数据浏览界面」。其插件系统通过 Python 包的入口点（entry points）机制实现，安装插件后 Datasette 会自动加载，无需修改核心代码。目前 Datasette 处于从 0.x 系列向 1.0 正式版过渡的阶段，两者在插件 API 上存在一定差异，因此同时兼容两个版本对插件维护者而言需要额外的适配工作。datasette-auth-github 能同时支持 0.65.x 和 1.0 alpha，体现了该插件在过渡期的维护投入。

小结

这次更新虽然改动不大，却是一个典型的「小修复带来大体验提升」的例子。一个缺失的 Cookie 参数在移动端造成了明显的可用性问题，修复后配合成熟度评估顺势推出 1.0，既解决了实际痛点，也为插件的长期维护打下了更清晰的版本基调。对于开源工具的维护者而言，及时将稳定项目标记为 1.0，同样是一种负责任的做法。