gkd 中文文档 下载 App

gkd 上传快照教程:Github Cookie 的获取与配置

快照要分享给他人,需要一个公开可访问的链接。GKD 的方案是把快照文件上传到 GitHub(借助 GitHub 的文件托管能力),生成分享链接。本页讲上传机制与两端的 Cookie 配置方法。

上传的原理

在审查工具或 GKD 内生成分享链接时,应用实际做的事等同于:

  1. 把快照 zip 下载到本地;
  2. 用你的 GitHub 账号把文件上传到某个公开页面(评论附件等位置);
  3. 拿到生成的公开文件链接作为分享链接。

网页版审查工具通过油猴脚本自动获取上传凭证,而 GKD 应用内需要你手动填入 GitHub Cookie 作为上传凭证。这就是「上传快照要先配 Cookie」的原因。

注意:上传即公开。快照会变成任何人可查看的内容,上传前务必完成隐私清理(见去除快照里的隐私信息)。

在电脑上获取 Cookie

  1. 在浏览器打开 GitHub 并登录账号;
  2. 按 F12 打开调试面板,选中「网络(Network)→ 文档(Doc)」,按 F5 刷新页面;
  3. 请求列表里会出现一条 github.com 记录,点击它;
  4. 在「标头 → 请求标头 → Cookie」右侧的长串文字上全选复制;
  5. 回到 GKD:高级设置 → 快照 → Github Cookie,粘贴保存。
在电脑浏览器调试面板中复制 Cookie 的截图
电脑端获取 Github Cookie

在手机上获取 Cookie

手机端官方推荐用 Via 浏览器:

  1. 下载安装 Via 浏览器,打开 GitHub 并登录;
  2. 点击地址栏左侧图标,在菜单里选「查看 Cookies」;
  3. 弹窗里点「复制文本」;
  4. 同样到 GKD 的 Github Cookie 编辑处粘贴保存。
Via 浏览器查看 Cookies 的菜单截图
手机端:Via 浏览器查看 Cookies
Via 浏览器复制 Cookie 文本的弹窗截图
手机端:复制 Cookie 文本

配好之后

回到快照记录或审查工具,重新执行「生成分享链接」,上传成功即得一个 i.gkd.li 域名下的分享链接(链接的正确用法见分享快照)。

Cookie 属于账号敏感凭证:不要把复制到的 Cookie 发给任何人、贴到公开场合。若怀疑泄露,在 GitHub 上退出全部登录会话即可使其失效。