Skip to content

About

No description, website, or topics provided.

Resources

Stars

41 stars

Watchers

0 watching

Forks

Repository files navigation

佬朋友 - LinuxDo Friends

佬朋友是一个面向 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:firefox

测试

npm 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.zip

zip 会输出到 packages/,并且 manifest.json 位于压缩包顶层。

npm run package-extension 保留为 Chrome 打包别名。

修改版本号

发版前需要保持这几个版本号一致:

  • package.json
  • package-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.0

GitHub CI 发包

CI 只会在推送三段式 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.0

tag 必须匹配 v1.6.0 这种格式。构建完成后,GitHub Actions 会创建对应的 GitHub Release,并只上传:

  • linuxdo-friends-v1.6.0-chrome.zip
  • linuxdo-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 许可。来源见 表情资源说明,权利反馈见 版权与处理方式。

About

No description, website, or topics provided.

Resources

Stars

41 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages