get-bijilisted
Install: claude install-skill suyuan2022/suyuan-skill
# Get 笔记
两件事,共用一个 biji.com 登录态:
- **同步**:账号里的笔记(录音、链接、文字)存成 `<笔记目录>` 下按日期分的 Markdown,增量更新
- **转逐字稿**:链接或本地音视频交给 Get 转写,取回文字后删掉 Get 里的临时笔记
下文 `<skill-dir>` 是本文件所在的目录;`<状态目录>` 是环境变量 `GET_BIJI_HOME` 的值,没设就是 `~/.config/get-biji/`。登录态、同步记录和 `<笔记目录>` 的位置都记在 `<状态目录>`,重装 skill 不受影响。
## 首次准备
需要 Node.js 18 及以上。
```bash
cd <skill-dir> && npm install && npx playwright install chromium
```
chromium 约 250MB,只用来登录。装好的标志:`node -e "require('playwright')"` 不报错。按需再装:ffmpeg(含 ffprobe,转本地音视频时用),yt-dlp(下载其他网站的音视频时用)。
## 登录
没有登录态或登录态过期(约 90 天一次)时,任何脚本都会打开一个 Chrome 窗口,等用户登录 biji.com,最多等 10 分钟:
1. 先告诉用户:电脑上会弹出浏览器,请在里面登录 Get 账号,登录后窗口会自己关
2. 命令放后台跑,盯着输出:出现 `Login successful` 就是登录好了,脚本接着干原来的活
3. 报 `Cannot open a browser` 是机器没有图形界面(远程服务器、云端环境):请用户在自己电脑上装好这个 skill 先跑一次,再把那台电脑的 `<状态目录>` 拷过来
## 同步
第一次同步先问用户笔记放哪,要绝对路径。录音转写是隐私,提醒他别放进会推到公开仓库的目录。
```bash
cd <skill-dir> && OUTPUT_DIR="<笔记目录>" node scripts/sync.js
```
之后不用再带 `OUTPUT_DIR`,脚本用记下的目录;想知道是��个,看 `<状态目录>/config.json` 的 `outputDir`。带上新的 `OUTPUT_DIR` 就是换目录,会把全部笔记重新同步到新目录。
- `TEST_LIMIT=3`:只同步最新的 3 条,第一次可以先试,看看格式
- `SINCE_DATE=YYYY-MM-DD`:只同步这天及以后的,默认全部
第一次全量同步每条 1 到 2 秒,笔记多就放后台跑。退出码 0、结尾是 `Sync Completed`,就是全部同步好了。退出码 1 时结尾会列出失败的笔记,直接重跑,只补没拉下来的。
## 查笔记
先读 [`references/检索.md`](references/检索.md):笔记文件长什么样,怎么由粗到细地搜。
搜之前先把新进 Get 的笔记补上,看 `<状态目录>/sync-state.json` 分两种:
- 有 `fullSyncAt`(本地是全的):不带 `SINCE_DATE` 跑一次同步。它只拉还没拉过的笔记,录音卡隔几天才传上来的录音也补得到,平时几十秒就完。按日期窗口同步会漏掉窗口外晚到的录音,所以这种情况一律完整同步
- 没有 `fullSyncAt`(本地只同步过一部分,比如用户只试跑过):完整同步会把所有没拉过的都拉下来,可能要很久,先