V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
loginv2
V2EX  ›  分享创造

做了一个给自己 star 的 repo 写备注的工具

  •  1
     
  •   loginv2 · 21 天前 · 1075 次点击

    stars

    给自己 star 的项目写备注 https://github.com/longxiao7/stars

    原理

    1. 利用 github pages 做展示 不需要自己搭服务器,也不需要安装浏览器扩展,走哪儿都能用
    2. star 数据通过 github workflow 从 API 拉取 (默认一天拉一次)
    3. 备注数据保存使用浏览器的 IndexedDB 也可以导出到本地 json 文件
    4. 除了从本地 json 文件导入备注,还可以网络远程载入(导出 json 文件上传到 repo 里 /data/notes.json 文件)

    部署方法

    1. clone 此项目!!!!不要使用 fork ,否则我每天更新自己的数据(主要是 data 目录)会影响你用。
    2. 打开 https://github.com/settings/personal-access-tokens 选择 Generate new token ,随便起一个名称,Expiration 选择 No Expiration ,Repository access 选择 Only select repositories ,然后 选择自己刚刚第 1 步 建立的 项目; Permissions 设置一下 Repository permissions 里面全设置成 Read and write ;Account permissions 里面只需要开 Starring ,最后生成的 token 保存一下 ,如果没保存之后就再也找不到了
    3. 打开第 1 步的项目 选择 Settings - Secrets and variables - Actions , 新建两个 Repository secrets
      • GH_TOKEN 这个值是第 2 步创建的 token
      • GH_UNAME 这个值是你的 github 用户名(不是邮箱)
    4. 回到你新建的项目 打开 Actions 选 左侧列表里的 “获取 star 的项目” - Run workflow - 创建一个任务,看看能不能执行成功 (这一步是拉取你的 star 项目列表,默认是我的,只有执行成功才会变成你的)
    5. 打开项目的 Settings - Pages 给项目开启 github pages

    使用

    打开项目的 pages 地址即可使用,导出数据到文件后 可以上传到项目的 /data/notes.json 覆盖文件 ,就可以使用 从 repo 载入数据 按钮,注意 导入数据和载入数据都会先清空浏览器已经有的数据。

    2 条回复    2025-07-15 09:08:48 +08:00
    kid1412621
        1
    kid1412621  
       18 天前 via iPhone
    不应该用 github app token 么
    loginv2
        2
    loginv2  
    OP
       18 天前
    @kid1412621 为什么 ?我不太熟悉这些 也是一边学一边做
    关于   ·   帮助文档   ·   自助推广系统   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2683 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 21ms · UTC 13:38 · PVG 21:38 · LAX 06:38 · JFK 09:38
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.