佬朋友是一个面向 linux.do 的浏览器插件,用来在本地优先地管理关注对象,并主动刷新好友状态和公开动态。
项目目标是克制地把“关注”升级成更好用的“朋友”视图:列表里看最近状态,佬友圈里看公开活动。插件不绕过 Cloudflare,不读取或导出 Cookie,不使用远程服务器代请求 linux.do。
佬朋友是 local-first,而不是 local-only。默认数据优先保存在浏览器扩展存储中;用户可以按需启用云存档和 Telegram 通知等可选集成。扩展界面打开时会检查 GitHub Release 更新,并使用 12 小时缓存。
已上架 Chrome 和 Firefox 官方扩展商店,可直接安装:
- 管理佬朋友列表,支持手动添加、从已关注列表快速添加,以及为已有佬朋友维护本地优先备注。
- 查看好友最近状态,例如最后发帖和最后活动。
- 查看佬友圈动态,支持按用户和活动类型筛选。
- 按话题、回复、Boost、回应、点赞组织打捞条件组,支持可视化/代码编辑、拖拽排序和本地规则验证。
- 佬友圈与佬有料使用虚拟列表,切换页面时保留当前会话的阅读位置。
- 内置表情图片供离线浏览,目录更新后只补充缺失版本;头像更新按完整来源地址匹配,并对失败请求限速与冷却。
- 在 linux.do 页面内集成入口,并支持浏览器侧栏视图。
- 数据优先保存在本地浏览器扩展存储中。
- 可选云存档会把可迁移配置备份到
linuxdo-cloud-save.lafish.workers.dev,包括佬朋友及其备注、打捞规则、请求统计、设置,以及已配置的 Telegram Bot Token / Chat ID。 - 可选 Telegram 通知会在启用通知或发送测试时请求 Telegram API。
- GitHub Release 更新检查会在扩展界面打开时使用 12 小时缓存并按需请求 GitHub API;Firefox 会先取得对应的可选数据授权。失败时可回退到
github-api.lafish.workers.dev镜像。
更多发布和隐私披露见 隐私政策、Chrome Web Store 提交说明 与 Firefox AMO 提交说明。
本次版本变更见 v1.6.0 发布说明。
需要 Node.js 22 和 npm。
npm install
npm run dev开发模式会持续构建 Chrome 插件文件。浏览器里加载 dist-chrome/ 目录即可调试。
npm run build构建产物会输出到:
dist-chrome/dist-firefox/
只构建单一目标时可以使用:
npm run build:chrome
npm run build:firefoxnpm test
npm run typecheck先构建,再打包 zip:
npm run build
npm run package:chrome -- --name linuxdo-friends-v1.6.0-chrome.zip
npm run package:firefox -- --name linuxdo-friends-v1.6.0-firefox.zipzip 会输出到 packages/,并且 manifest.json 位于压缩包顶层。
npm run package-extension 保留为 Chrome 打包别名。
发版前需要保持这几个版本号一致:
package.jsonpackage-lock.json
Chrome 和 Firefox 的最终 manifest.json 会在构建时由 package.json 版本自动生成。
可以用脚本统一修改:
npm run set-version -- 1.6.0脚本也接受带 v 的写法:
npm run set-version -- v1.6.0校验 tag、包版本和生成 manifest 版本:
node scripts/verify-version.mjs --tag=v1.6.0CI 只会在推送三段式 tag 时构建插件包:
npm run set-version -- 1.6.0
npm test
npm run build
npm run check:bundles
git add package.json package-lock.json
git commit -m "release v1.6.0"
git tag v1.6.0
git push origin main
git push origin v1.6.0tag 必须匹配 v1.6.0 这种格式。构建完成后,GitHub Actions 会创建对应的 GitHub Release,并只上传:
linuxdo-friends-v1.6.0-chrome.ziplinuxdo-friends-v1.6.0-firefox.zip
发布维护事项见 发版核对记录。提交 docs/releases/vX.Y.Z.md 后,CI 使用对应文件作为 Release 说明。
AMO 仍然手工提交;同一 tag 页面里 GitHub 自动生成的 Source code (zip) 可作为源码包上传。
本项目代码采用 MIT;第三方依赖许可随包提供于 THIRD_PARTY_NOTICES.txt。Twemoji 图片采用 CC BY 4.0;自定义图片版权归各自权利人,不适用项目 MIT 或 Twemoji 许可。来源见 表情资源说明,权利反馈见 版权与处理方式。