简悦的发布通道,简悦 - 让你瞬间进入沉浸式阅读的 Chrome 扩展,还原阅读的本质,提升你的阅读体验。地址 https://simpread.pro 讨论群地址 https://t.me/simpreadgroup
为什么说 Github Issues 是最好的 QA 平台

▎ 今天是周末,不谈简悦的功能,就聊聊 Github Issues 这个话题。 😄

🔗 竹白 | QQ 频道

我在 为什么不用客服 里面聊了聊 Github Issues 是最好的 QA 途径这个事情,今天「展开说说」。

希望给各位用户一些更快速解决你问题的渠道和方法。

📊 一组数据

从 11月24日 ~ 11月25日 11点,我共回复了 27 次 Issues,共计 10 用户提问。

我只是随便找了一个日常 QA 的时间段,基本上我每天都要做这个事情,27 次回复也属于平均水平,多的时候一天至少有 50+ 次。

如果这个事情放到 QQ 或微信,哪怕是 Telegram 都是没法完成的事情,基本上一天我什么都做不了,只能 QA 了。 😂

🕐 回复这些 Issues 花费多久?

我没有精确计算过,但以我经验来看,这些 QA 总共花费不到 30 分钟。

为什么 Github Issues 会比聊天快这么多?

1. 聊天是线性的,所有提问用户的问题都会穿插在一起,很难追述。

2. 在发 Issues 时,用户会不自觉的组织语言、提问逻辑,很多时候会自行解决问题。

3. 通过有意识的组织提问内容时更精准,我也更容易定为到问题,因此可以快速解决它。

4. Issues 可以长期追述,几个月甚至更长时间的提问都可以方便回复。

5. 拥有全 Markdown 语法支持,方便传图、视频、文件等操作。

6. 留存性,用户可以方便的通过搜索得到任意相似问题的解决方案。

7. 提醒性,你的每个 Issues 都会以 Email 形式通知你,在你有时间时回复它,而不是一直在盯着聊天内容。

🔎 最后

截至到 2022年11月26日,Issues 上已经积累了超过 4K+ 的 Issues,这个数字仍在增加中。

更精细化的同步助手增强导出

▎ 可以区分全文 or 标注的规则来啦。

🔗 知乎

📝 描述

这是随着 同步助手 1.1.3 一起发布的功能。

增加了一个属性 type 专门用来区分: 全文 or 标注,用法:

page → 全文 e.g. 1234-xxx.md

annote → 标注 e.g. 1234-xxx@annote.md

一般来说,这个功能需要跟 知识库 一起使用。

📖 能做什么

当使用导入到 Obsidain 时:

1️⃣ 将全文以 md + assets 方式导入到 A 文件夹。

2️⃣ 将标注导入到 B 文件夹。

从而解决:标注和全文分开,且全文包含本地图片的方案。

🔎 用法说明

{"extension":"assets", "path":"/Users/xxxx/Obsidian@simpread/Inbox", "type":"page"}

当使用 md + assets 方式时,并且是全文的话,导出到 Inbox 文件夹。

{"extension":"md", "path":"/Users/xxxx/Obsidian@simpread/SimpRead", "type":"annote"}

当生成 .md 时,导出到 SimpRead 文件夹。

{"extension":"html", "path":"/Users/xxxx/SimpRead/output"}

当生成 .html 包括全文以及标注,导出到 output 文件夹。

也就是说,当不加 type 类型时(也就是默认值),同时包含:全文和标注。

💡 引申

同步助手 1.1.3 的详细说明 /posts/494

定制化 md + assets 图片保存路径

▎ 是的,你们想要的定制化图片资源路径的功能来啦。

🔗 知乎 | 竹白 | QQ 频道 | 即刻 | 推特 | 简悦社群

📝 描述

这是随着 同步助手 1.1.3 一起发布的功能,无法直接使用,需要配合下面两个插件食用

导入到 Obsidian 1.4.0

导出 md + assets 1.1.0

▎ 以下是重点功能说明

1️⃣ 图片导出位置

与 Typora 保持一致,共支持四种方案

/${filename}/assets → 原方案

./${filename}.assets → 保存到 标题.assets 文件夹下

./assets → 无论是多少个文章,将图片统一全部都保持到 assets 文件夹下面

custom → 将图片保存本地的任意目录

2️⃣ 图片的导出类型

在某些页面是将图片成功保存 e.g. B站笔记无法将图片导出,这时可将图片导出类型改为 Base64 方案即可。

3️⃣ 绝对路径与相对路径

这个功能 仅在选择了图片导出位置为自定义时使用

如果你使用 Obsidian 的话,则不用了解这个功能,但使用了 Typora,需要开启这个选项。

📈 升级

如果没有使用同步助手的话,可直接安装这两个插件;反之,请使用 插件管理器 安装。

💡 引申

老用户来说直接升级插件即可,作为新用户的话,可以使用 配置库 方案。

简悦 · 同步助手 1.1.3

🔗 更新日志 | 知乎 | 竹白 | QQ 频道 | 即刻 | 推特 | 简悦社群

▎ 版本虽然前进一小步,但功能却一点都不少的 1.1.3 版来啦。

🖥 下载地址

http://ksria.com/simpread/docs/#/Sync?id=下载

💄 新增

1️⃣ 导出到 assets + md 增加自定义媒体图片的功能,类似 Typora 的方案,支持四种媒体图片资源方案。

此功能无法独立使用,需要配合以下两个插件使用:

· 导入到 Obsidian 1.4.0

· 导出 md + assets 格式 1.1.0

2️⃣ 读取本地文件

可将本地任何 .html .md 生成阅读模式,即可加入到简悦导出大礼包,非常适合本地已经存在一堆 HTML 文件的用户。

3️⃣ 新的 URL Scheme

· popup=window → 每个链接都会打开一个新窗口,反之只有一个窗口

simpread://open?type=unread&popup=window

· embed=logseq|rr → 显示 logseq or roam search 设置界面

simpread://open?type=unread&embed=logseq

注意:Linux 版暂时不支持 URL Scheme,后续版本会加入此功能。

4️⃣ 稍后读外部访问

通过生成 Token 的方式直接查看当前全部稍后读,方便将稍后读接入到第三方工具,进而实现各种联动效果。

5️⃣ 浅色主题自动暗色模式

在当前界面效果的基础上增加了一个浅色主题。

跟随系统的自动暗色模式,暂时无法手动切换,只能随系统改变而改变。

6️⃣ 同步助手的增强导出规则增加了两个新规则:`type` → 导出类型

· annote → 标注 e.g. 1234-xxx@annote.md

· page → 全文 e.g. 1234-xxx.md

🔨 优化 & 🚑 修复

· 切换 Font Awesome CDN

· 禁用打开稍后读的快捷键

· 当内部出错时,需要一个直接 Cancel 的功能

新用户建议:更好的玩转简悦文档 v2.0 版

🔗 教程 | 知乎 | QQ 频道 | 竹白

▎ 用好「官方指导」让你的更容易玩转简悦。

💡 求人不如求己

跟很多产品最大的不同在于:简悦的每个功能都有文档,你遇到的大部分问题都有前人帮你趟过了。

所以在遇到问题除了 QA 外还可以翻翻这些众多的文档。

▎简悦虽然功能众多,但划分为以下几的大类:

🗂 基础文档

• 功能说明(基础文档)

• 插件说明

• 问题清单


📦 教程类文档

• 配置教程

📚 进阶文档

• API 文档

• 使用技巧 / 与各种生产力的联动

📕 功能说明(基础文档)

扩展端与同步助手拥有的选项的全部说明,也就是某个「开关」的详细说明,当你熟悉简悦后,对简悦有更高的配置要求,则可以看此文档。

👉 https://simpread.pro/docs

📗 插件教程

简悦拥有丰富的大量的插件系统,可以将阅读模式武装到「基于网页的操作系统」

👉 插件说明

📔 配置教程

简悦官方推出了一系列的教程,新用户可以直接使用教程配置到你需要的功能。

最主要的两个教程:一站式教程系列配置库

👉 语雀手册

💡 问题清单

当遇到某些教程、原本应该存在但无法使用的问题,通过查看问题清单,一般都能解决

👉 重要通知

📘 API

API 是简悦的一大特点,具有丰富的导入 / 导出方法,甚至简悦官方的很多功能都是基于 API 开发的(阅读列表 · 收藏助手 · Telegram bot 等)

同时 API 也跟其它生产力工具联动的方案,无论是线上,还是线下。

👉 https://kb.simpread.pro

📙 进阶文档

如果基础文档无法满足你的需求,可以查看简悦各种功能的 进阶文档,如:

1️⃣ 适配 Notion 页面 · 各种科研类期刊 · 收藏各种社交媒体平台等阅读模式的奇技婬巧,可以看 站点适配使用技巧

2️⃣ 同步助手的疑难杂症和进阶用法 同步助手

3️⃣ API 的疑难杂症和进阶用法 开放平台API 联动

4️⃣ 高级账户的相关问题 高级账户

👉 https://github.com/kenshin/simpread/discussions

为什么不用客服以及当遇到问题后最好的 QA 方案

▎ 我非常喜欢跟用户交流,但通过群聊天的 QA 并不是一个好的解决方案。

💡 为什么不用客服

从产出性价比来说,目前找个客服确实可以解决很多问题,并且简悦的收入也完全支撑这个事情。

但我非常不喜欢「客服」这个概念,因为客服只是客服,从用户角度来说,当他发生问题时,最好的解决方案是找到我,而不是客服。

所以即便简悦拥有了目前的用户数量级,仍没有专职客服,而只有我以及 Telegram 群里面的热心大佬们。

为什么说群并不是一个很好的 QA 方案

Telegram 作为一个聊天群来说,除了中文搜索不怎么样外找不出一点「毛病」,非常完美。

但它并不适合作为一个 QA 渠道,原因很简单,因为及时性的缘故(IM 的特性)会导致:

• 线性对话,没办法实现 Thread 方式,人一多,基本上就被淹没在各个留言里面了,很难根据上下文解决。

• 即便有 Thread,打字的速度和信息的携带量要远低于说话,但因为及时性,所以会接近说话的频率,导致很多聊天内容反复导致信息冗余且无用居多。

最好的 QA 方案

请通过 Github Issues 讨论,这是我认为目前最好的 QA 方案,基本上每个问题都可以被反复追溯,甚至于时间跨度长达几个月也没一点问题。

Github Issues 支持完整意义的 Markdown 语法规则,可以贴图(从剪切板直接复制)、代码段、视频等手段。

具有提醒功能,在 Issues 上面的每次回复都会收到 Email。

▎ 截至到目前为止 Github Issues 上积累了近 5K 的讨论内容,我每天要处理 20+ 次的回复(忙的时候要 50+ 左右),仍游刃有余,并不会占用我太多时间,而通过 Issues 得到解决的也更彻底。

🆚 时效性的问题

Issues 并不具有时效性,所以很多用户都选择使用看似时效性更高的 Telegram 来讨论,因为感觉时效性可能得到的解决方案更快速,但原因刚才说了,所以总体时间并不如 Issues 来得更彻底。

📚 求人不如求己

除了 Github Issues 外,另外一个解决方案是看文档,简悦的每个功能都配有链接,会链接到这个文档中,甚至于还有配置库方案供用户免配置的设置。

简悦文档汇总一览

配置库一览

用于拆书的 Obsidian 模板

▎ 通过快速标注的方式,将阅读模式的长文标记出仅自己需要的内容(拆书)

🔗 地址

https://github.com/Kenshin/simpread/discussions/2153#discussioncomment-4154439

📝 特点

1️⃣ 包含题图、Favicon 等信息。

2️⃣ 丰富的链接形式,包括:内嵌标注 · 本地快照 · 永久外链 · 预览原文( Markdown 内的原文) · 原文

3️⃣ 仅包含标注内容

4️⃣ 支持 Block ID

5️⃣ 同时支持 Markdown 辅助增强引擎Obsidian SimpRead Sync

💡 如何使用

如果你使用了 Obsdian 配置库方案 或者 导入到 Obsidain 的话,直接复制粘贴模板即可。

将 稍后读 和 标注 的代码分别复制到 Markdown 辅助增强引擎Obsidian SimpRead Sync 即可。

Done!

🔌 灵活的 Block ID 方案

此模板的每条标注都会包含 Block ID 功能,可配合 Obsidian42 - Text Transporter 方便对标注的内容做引用以及笔记。

关于 Obsidian42 - Text Transporter 的更多用法可以看 简悦 + SimpRead Unread Sync + Obsidian 打造第二大脑「养成游戏」

🔎 引申

1️⃣ 配置库详细说明

2️⃣ Obsdian 配置库

3️⃣ 简悦 + Obsdian 联动案例

查看 #Obsidian此链接 得到更多简悦联动方案

同步助手的「那点事」 · 篇五

▎ 让你更好的了解使用同步助手的功能。

🔗 第一篇 | 第二篇 | 第三篇 | 第四篇 | 第五篇

💡 写在前面

近期新用户较多,准备写一写简悦的一些相关功能,希望可以帮助新用户更好的使用简悦的各种玩法。

这是同步助手介绍的第五篇,聊聊【本地快照系统】

💾 本地快照系统

在同步助手的加持下,可以将阅读模式的内容保存到本地任意位置,基于这个特性简悦拥有了本地快照系统。

支持本地快照系统是简悦区别其它同类产品最大的一个特点,同时也是简悦优于其它同类产品的原因。

💽 能做什么

• 通过阅读模式可将这篇文章(包括图片)保存到本地(同步助手导出)。

• 这篇快照可支持任意网盘系统,包括:各种网盘(坚果云 / Onedrive / 百度 / 阿里云盘)、NAS、Git 系统等,是多设备的自动同步数据(同步助手 · 自动同步)。

• 在稍后读中读取本地快照,同时可以在本地快照上进行标注(知识库)。

• 这篇稍后读会生成唯一的本地永久链接,方便在双链笔记中溯源(永久链接)。

• 这篇稍后读还可以直接在网络访问,也就是永久外链(资料库)。

• 在本地标注时,也会自动同步标注(按照你设定的标注模板格式)到 Obsidian、Logseq 等本地双链笔记中(Markdown 定制化)。

• 在 Obsidian、Logseq、Roam Research 中可以直接嵌入本地快照的标注模式(标注嵌入模式)。

💾 类别

1️⃣ 知识库 → 可以将阅读模式保存到本地,以及稍后读 / 标注读取本地数据。

2️⃣ 资料库 → 让本地永久链接具有永久外链功能

3️⃣ 永久链接 → 方便双链笔记用户回溯到本地快照

4️⃣ 标注嵌入模式 → 在双链笔记中直接嵌入简悦的标注模式

🆘 划重点

• 本地快照功能的基石 → 知识库 (链接中为一站式教程)

• 标注自动导入到双链笔记中可以根据 Markdown 模板来设置不同的方案,可以直接使用 Markdown 模板库 里面的现成内容。

• 针对新手用户来说,可以直接使用 配置库方案

更快更专注的开放平台文档 v2.0

▎ 这是建立在 Logseq 上面的一套关于 开放平台 的教程合辑,用双链笔记可以互相关联的特点来解决简悦新用户教程查阅问题。

🔗 地址

https://kb.simpread.pro

📖 新版说明

仅保留开放平台相关内容,与 语雀手册(的内容)彻底分离。

💡 为什么是 Logseq

1️⃣ 简悦的教程大部分不是孤立存在的,所以会发生「嵌套问题」,而双链笔记是解决此问题最好的方案。

2️⃣ 所见即所得,用 Logseq 桌面版与发布的 Web 版保持一直的视觉效果,避免了二次调整。

3️⃣ 可自建在任意地方(此教程建立在 Github Page 上)

4️⃣ 利用 Logseq Publish GitHub Action 自动化发布

📚 如何开始

如果你不熟悉 Logseq 的用法,可以看 如何开始

🔎 关联

• 更快的 简悦文档中心

• 如何无代码自动化发布你的 Logseq 请看这里

🎁 还有惊喜

一年一度的简悦 2022 年双十一来啦 👉 /posts/487

马上就到截至日期喽,没上车的用户赶快上车,如果你多于三台设备的话,年底前会上更多设备功能,请填写此 调查问卷

更快的简悦文档中心

▎ 更快速、分类更清晰的文档中心们。

🔗 主站(阿里云)

使用了 cdn.staticfile.org 作为 CDN 源

👉 https://simpread.pro/docs

🔗 镜像站( Github Page )

为保证用户可以正常访问,所以原文档中心仍存在

👉 http://ksria.com/simpread/docs

🔗 适合国外用户的镜像站

使用了 cdnjs.cloudflare.com 作为 CDN 源

👉 https://simpread.pro/docs2

🔗 更全面的语雀文档站

针对新用户的语雀手册,主要包含了:

1️⃣ 一站式教程

2️⃣ 配置库

👉 https://www.yuque.com/kenshin/simpread

🔗 专门用于 API 文档站

为了简化相关内容 kb.simpread.pro 仅作为 API (开放平台)文档站,其余内容转移到语雀文档站。

👉 https://kb.simpread.pro

📚 关联

1️⃣ 简悦聚合搜索

2️⃣ 几个重要的 RSS 订阅源与 Newsletter

🎉 一年一度的简悦 2022 年双十一来啦

🔗 竹白 | QQ 频道

▎ 这次折扣为今年最低。

📬 购买地址

1️⃣ 腾讯问卷方式 (此方式非实时发送 License)

2️⃣ 爱发电(此方式实时发送 License)

🕐 截止时间

2022年11月15日

🎁 购买的理由

1️⃣ 简悦每年不超过三次的折扣。(今年最后一次)

2️⃣ 虽然我知道现在是订阅制流行,但简悦仍是买断制,因为我跟你一样,都不喜欢订阅制。

3️⃣ 基于本地快照方案,简悦的用户拥有最大的数据所有权,未经用户的授权,哪怕是 1KB 的数据都拿不到。

4️⃣ 简悦可以完美的跟嵌入到各种双链笔记(Obsidian Logseq Roam Research)实现完美的自动化标注方案。

5️⃣ 简悦的标注系统拥有最完善 / 专业的标注形态。

6️⃣ 简悦的稍后读拥有最近乎双链笔记形态的稍后读。

👀 不爱动手用户看过来

简悦官方近期推出了适合这些用户的 👉 配置库方案

👨🏼‍💻 适合的用户

1️⃣ 不希望自己的数据被印象笔记等任何线上保存服务「绑架」,导致更换时一筹莫展的用户。

2️⃣ 对页面布局 / 排版 / 阅读个性化有极致要求的用户。

3️⃣ 效率控 / 知识管理 / 双链笔记爱好者。

4️⃣ 对印象笔记 / Pocket 等线上「仓储」服务深恶痛绝的用户。

💡 一个彩蛋

如果你多于三台设备的话,年底前会上更多设备功能,请填写此 调查问卷

📺 欢迎关注简悦在B站上的官方账户

🔗 竹白 | QQ 频道

▎ 欢迎订阅简悦在小破站上面的官方账户。

🔗 地址

https://space.bilibili.com/1853727625

💡 起因

简悦的很多功能都有视频,如:插件使用,跟双链笔记的联动、Obsidian、Logseq、Notion,API 等等。

为了更方便的让用户了解这些事情,简悦在 2022 年年初就建立了 B 站账户,截至到目前为止已经积累了 54 个视频。

因为B站建立的时间比较晚,不如 知乎视频(80 篇视频),但 B 站毕竟是专门做视频的,在使用上还是要比知乎视频好很多。

经过 54 个视频的积累,准备正式对外宣布下 😄

欢迎大家关注 & 三连 🙏

📺 视频细节

虽然部分视频以操作为主且长度很短,但每篇视频都有对应的(知乎专栏)链接,通过这个链接就能找到这个视频对应的教程。

非常适合喜欢使用视频学习的用户。

▎ 以下介绍一些 B 站上的视频和合辑

📕 导入到 Notion 一站式有声视频教学

这是简悦官方推出的一个有声视频教程系列,感谢简悦资深用户 Yu jiale 的倾情献声。

👉 https://www.bilibili.com/video/BV1Ga411P75h/

📗 简悦与 Notion 联动合辑

👉 https://space.bilibili.com/1853727625/channel/collectiondetail?sid=807768

📘 简悦与 Obsidian 联动合辑

👉 https://space.bilibili.com/1853727625/channel/collectiondetail?sid=807741

📙 简悦与 Logseq 联动合辑

👉 https://space.bilibili.com/1853727625/channel/collectiondetail?sid=807757

🔌 简悦插件

👉 https://space.bilibili.com/1853727625/channel/collectiondetail?sid=807794

💬 欢迎加入简悦官方 QQ 频道

▎ 照顾国内用户的类 Discord + Telegram Channel 社区方案来啦 🎉

🔗 地址

https://pd.qq.com/s/5jp0meyfc (打开此链接使用 QQ 扫码即刻加入)

Telegram 的优势

我选择使用 Telegram 主要是因为它支持 Channel 这种形式(非常类似公众号),一个可以订阅的平台。

所以 Telegram Channel 一直是简悦的主要的推送渠道,从简悦 2.0 版本发布后,每周维持在 3 ~ 4 篇的推送内容。

迄今已经超过了 4.6K 的订阅量。

⛔️ Telegram 的问题

Telegram 是简悦首选的社区渠道,目前已经有 2K+ 的小伙伴在里面了,从一个 IM 工具看 Telegram 的话,它是无可挑剔的!

但作为社区来说,IM(并不是 Telegram 的锅)有着非常明显的缺陷,即:因为没有 Thread 功能,全部的聊天信息都是线性的,所以很多时候聊天信息一多,我就没法做 QA 了。

所以,简悦的 QA 渠道只有唯一的 Github Issues(已经积累了超过 4K 的讨论内容)

💡 为什么要有 QQ 频道这个社区?

我一直有个 Discord 情结,在很久之前我就希望使用 Discord 作为简悦的社区。

但相比 Telegram 来说,这个方案虽然好,但不太适合简悦的受众群体,虽然简悦早早的就有了 Discord 频道但一直没有对外。

前几天发现 QQ 频道这个功能,简单的使用了下,基本上就是国内版 Discord。不止如此,还兼具 Telegram Channel 的推送功能。

📣 正式「运营」QQ 频道

结合 Discord + Telegram Channel 的优势后,我决定正式对外运营它。 🎉

🔎 划重点

1️⃣ Telegram Group 仍是最重要的群

2️⃣ Telegram Channel 为优先级最高方案,每次发布后,会同时手动同步到 QQ 频道

3️⃣ 用户可同时加入 Telegram 和 QQ,并没有所谓

4️⃣ 实在无法使用 Telegram 的用户可以选择 QQ 频道

5️⃣ Github Issues 仍是首选的 QA 渠道,且优先级最高

简悦 · 配置库 剪藏版

▎ 针对新用户的一步到位的剪藏库。

🔗 文档 | 语雀 | 竹白 | 知乎 | 即刻 | 推特 | 简悦社群

🗂 配置库

简悦 · 配置库 是简悦官方推出的一套针对新用户的极简配置方案,方便新用户用最快的方式使用简悦的各种高级服务,配置库内置了常用的双链笔记用法,如:Notion、Obsidian、Logseq、Roam Research,同时包含了简悦在阅读模式上的一些常规插件:Live Editor、题图、Safari 阅读模式等。

💡 特点

用户仅需要下载对应的配置库,修改里面的 UID 为自己的高级账户 UID,即可实现简悦的各种高级操作。

💁‍♂️ 受众

新用户或者不想使用手动配置的用户。

📝 如何使用

1️⃣ 下载

2️⃣ 修改为自己的 UID

3️⃣ 将必要的文件夹复制粘贴到相应位置

Done!

📦 剪藏版

如果想要把网页的内容完全保存,最好的做法是本地化保存,通过简悦导出到本地的文件更具可读性(仅包含正文)与更小的 size。

简悦众多的导出服务(剪藏功能),所以如果是喜欢将正文收藏到本地的用户,简悦官方为此适配了一组剪藏相关的配置包。

🔌 导出格式

1️⃣ HTML(含本地化图片)

2️⃣ PDF

3️⃣ Markdown(含本地化图片)

上述方案均没有设置标注的自动化,可以看作完全是为了剪藏服务的配置包。

📘 本地快照

🔗 Github | 语雀

需要同步助手,几乎无任何配置,当加入稍后读时,会自动导出离线 HTML(含离线图片)

📙 PDF

🔗 Github | 语雀

需要同步助手,支持本地快照,自动同步标注,使用 wkhtmltopdf 作为 PDF 生成方案,并支持多种 PDF 定制化。

📕 md + assets

🔗 Github | 语雀

需要同步助手,支持本地快照,自动同步标注,使用 md + assets 作为永久化保存页面的方案,此方案会将图片下载到本地并保存到 assets 文件夹,可在 Typora、Obsidian 中查看。

🔎 引申

1️⃣ 配置库详细说明

2️⃣ Obsidian 配置库

3️⃣ Notion 配置库

4️⃣ Logseq 配置库

同步助手的「那点事」 · 篇四

▎ 让你更好的了解使用同步助手的功能。

🔗 第一篇 | 第二篇 | 第三篇 | 第四篇

💡 写在前面

近期新用户较多,准备写一写简悦的一些相关功能,希望可以帮助新用户更好的使用简悦的各种玩法。

这是同步助手介绍的第四篇,聊聊 simpread_config.json 的事情。

💡 配置文件

作为本地化的服务,配置文件是个人知识库的大脑,简悦最重要的东西,即: simpread_config.json

你在使用简悦过程中产生的一切数据都在配置文件中,包括你的配置信息、高级账户、标注、稍后读文章、所加载的简悦插件等等。

因此,掌控好配置文件就对自己的所有数据有了全面掌控,同样,一旦配置文件落于他手,也就意味着你的个人信息的泄露。

💾 备份

只要保存好这个数据,就当于保存了你的账户数据。(包括高级账户数据)

👤 导入 = 登录高级账户

在新安装完简悦后导入(选项页 → 共通 → 从本地导入配置文件)这个配置文件后,如果这个文件包含了高级账户信息,简悦会自动授权这台设备为高级账户。

🗃 多设备同步

跟所有的基于本地文件系统的产品一样,简悦支持无数种同步方案:任意网盘、iCloud、Git、NAS、私有云盘等。实现同步的逻辑也很简单:

A 设备 → 通过浏览器加入稍后读 → 通过同步助手保存到某网盘目录 → 某网盘同步 → B 设备 → 某网盘同步 → 通过同步助手读取某网盘目录 → 浏览器简悦读取这个数据。

原理就是这么简单。

⛔️ 为什么会发生数据丢失问题?

无论什么情况下,数据丢失都只有一个原因:旧数据覆盖了新数据。例如:

• B设备同步了新配置文件后,但B的浏览器未关闭,这时直接加新的稍后读,导致B浏览器的数据直接覆盖了新数据。

• B设备忘记开网盘,但还是继续操作B浏览器,导致再开网盘时,发现B的数据覆盖了网盘上新数据。

一般来说网盘产品都会包含一定时间的历史记录,如果发生丢失,可通过历史记录还原

🆘 划重点

simpread_config.json 就是你的账户、数据和稍后读,导入它就意味着导入你的全部信息

• 多设备同步,确保 B 设备的同步盘和同步助手先开启,再使用浏览器的简悦

• 当发生了旧数据覆盖问题,可通过网盘的历史记录还原

简悦 + Logseq 联动的几个案例

▎ 一些基于简悦 + Logseq 的真实使用场景

📦 Logseq 配置库

得益于 Logseq 配置库,可以让任何无基础用户,在几分钟之内实现:在 Logseq 中标注这一「小目标」。

在 Logseq 中标注或者在网页中标注,自动导入到 Logseq 只是知识管理的第一步。

如果你的 Logseq 新用户,可以看看以下这些技巧,都是来自简悦群各种 Logseq 大佬正在使用的方案的总结。

📚 Logseq 使用案例

下面这些案例均属于 Logseq 的高阶用法,但得益于 Logseq 配置库,所以这些用户也非常使用新手用户。

📘 我是如何使用 Logseq + 简悦来做笔记的

总计 80 多个 RSS 源里,每日抓取的文章中需进一步整理的大约是 2 至 4 篇,使用:Logseq 和简悦,让我找到兼具「收藏链接」和「阅读笔记」的方法。

📙 使用计划任务将简悦导入到 Logseq 的文件汇总到当天日记

当导出时,复制文件到 Logseq 的文件夹中,然后追加标题信息到当天日记中去。若当天日记不存在,就新建一个再追加。

📗 简悦 + Logseq + Github Page 无代码全自动化知识管理发布方案

在简悦标注,自动生成符合 Logseq 的标注文件,然后发布到 Github Page 的无代码化全自动方案。

🗂 配置库

简悦官方推出的一套针对新用户的极简配置方案,方便新用户用最快的方式使用简悦的各种高级服务,配置库内置了常用的双链笔记用法,如:Notion、Logseq、Logseq、Roam Research,同时包含了简悦在阅读模式上的一些常规插件:Live Editor、题图、Safari 阅读模式等。

🔎 关联

查看 #Logseq此链接 得到更多简悦联动方案。

简悦 · 配置库 Logseq 版

▎ 针对新用户的一步到位的 Logseq 配置库。

🔗 文档 | 语雀 | 竹白 | 知乎 | 即刻 | 推特 | 简悦社群 | 知乎视频 | B

🗂 配置库

简悦 · 配置库 是简悦官方推出的一套针对新用户的极简配置方案,方便新用户用最快的方式使用简悦的各种高级服务,配置库内置了常用的双链笔记用法,如:Notion、Obsidian、Logseq、Roam Research,同时包含了简悦在阅读模式上的一些常规插件:Live Editor、题图、Safari 阅读模式等。

💡 特点

用户仅需要下载对应的配置库,修改里面的 UID 为自己的高级账户 UID,即可实现简悦的各种高级操作。

💁‍♂️ 受众

新用户或者不想使用手动配置的用户。

📝 如何使用

1️⃣ 下载

2️⃣ 修改为自己的 UID

3️⃣ 将必要的文件夹复制粘贴到相应位置

Done!

📦 Logseq 配置库

因为 Logseq 与 Obsidian 在插件 API 的支持度有限,所以并没有轻量级使用方案,根据 Logseq 支持的文件格式区别两种方案。

这两种方案均需要同步助手,几乎无任何配置,支持本地快照,自动同步标注,可在 Logseq 中标注,适合 Logseq + 简悦的重度用户。

🔌 功能

1️⃣ 支持在 Logseq 中标注

2️⃣ 加入稍后读,自动保存本地快照

3️⃣ 加入标注时,自动将标注内容导入本地快照和 Logseq

4️⃣ 改变稍后读或标注的元数据时,自动将改动的内容保存到本地快照和 Logseq

📙 Org Mode 版

🔗 Github | 语雀

📗 Markdown 版

🔗 Github | 语雀

🔎 引申

1️⃣ 配置库详细说明

2️⃣ Obsidian 配置库

3️⃣ Notion 配置库

搜索 #Logseq此链接 得到更多简悦与 Logseq 联动方案

为导入到 Obsidian 的稍后读做类似 Notion database 卡片布局的索引页

▎ 如果你喜欢使用 Notion 卡片布局的话,可以试试下面的方式。

🔗 教程 | 知乎 | 推特 | 即刻 | 简悦社群

💡 写在前面

此功能并不是针对新用户的方案,如果你已经配置了导入到 Obsidian,则可以很容易实现此方式。

如果对这方面不了解且新用户的话,可以直接使用 Obsidan 资源库 方案后再继续下面的步骤。

📝 如何配置

1️⃣ 确保已经安装 Obsidain 插件 Dataview & Hove Editor

2️⃣ 解压缩 此文件夹,并放到 Obsidan 根目录下

3️⃣ 直接下载 此文件 后改后缀名为 .md ,并放到 Obsidan 根目录下

Done!

🔎 引申

Obsdian 配置库

• 查看 #Obsidian此链接 得到更多简悦联动方案

来自 简悦社区 用户 稻米鼠 的分享。

同步助手的「那点事」 · 篇三

▎ 让你更好的了解使用同步助手的功能。

🔗 第一篇 | 第二篇 | 第三篇

💡 写在前面

近期新用户较多,所以趁着休息时间,写一写简悦的一些相关功能,希望可以帮助新用户更好的使用简悦的各种玩法。

⛔️ 线上稍后读的「问题」

稍后读功能之一:Capture,永久收藏,防止 404

线上稍后读只是将图片从服务器(A)放到了自己的服务器(B)上,依就在网络上,并没有改变这个图片不会 404 的命运。

💡 简悦的做法

将阅读模式的全部资源(包括图片)保存到本地,用户可以使用任意网盘来同步这些快照。

💽 知识库与资料库(基于本地快照的永久链接方案)

▎ 本地快照是简悦区别其它线上稍后读最大的一个特色,也是双链笔记玩法的基础。

💾 知识库方案(更方便的本地快照)

除了可以导出到本地外,简悦还可以在稍后读中直接查看这个本地快照,同时也支持在浏览器查看当前序号对应的本地快照 http://localhost:7026/reading/<稍后读序号>

此方式让本地快照拥有了内部永久链接,可用于双链笔记使用时的溯源,这部份功能叫做【知识库】,这是一切基于本地玩法(双链笔记)的基石。

👉 一站式配置

🗃资料库方案(支持 API)

同步文件和同步文件夹(快照文件夹),可分别指定两个完全不同的目录,比如:用坚果云同步 simpread_config.json 用 Onedrive 快照文件夹。

一旦这两个路径符合下面的方案就可以使用 API 了,支持更多玩法。

同步文件夹叫做 SimpRead,快照文件夹放在 SimpRead 下面并叫做 output,同时这个 SimpRead 处于坚果云的根目录下,即: <坚果云根目录>/SimpRead/output

当支持 API 后,就可以使用 https://simpread.pro/@kenshin/reading/<稍后读序号> 进而实现永久外链,这种方式叫做 资料库

关于 API 的功能后续会专门介绍~

🆘 划重点

• 设置了本地快照路径后,可将网页永久保存到本地(含图片),防止 404

• 同步文件和同步(快照)文件夹,可分别指定两个完全不同的路径

• 当这两个路径设置为 <坚果云根目录>/SimpRead/output 就可以支持 API

同步助手的「那点事」 · 篇二

▎ 让你更好的了解使用同步助手的功能。

🔗 第一篇 | 第二篇 | 第三篇

💡 写在前面

近期新用户较多,所以趁着休息时间,写一写简悦的一些相关功能,希望可以帮助新用户更好的使用简悦的各种玩法。

这是同步助手介绍的第二篇~

🔄 展开说说同步盘与同步方案

▎ 自动同步是同步助手最重要的功能,简悦大部分高级功能都基于自动同步。

为什么不用 Chrome 自己的同步方案

Chrome 扩展 API 支持将数据保存到 Chrome 实现同步功能。是的,我也觉得很好,简悦 1.0.x 的某个版本就加入了这个功能。

但是... 跟 iCloud 的问题一样,你没法控制它什么时候同步,同步时如何覆盖数据 😂 所以 1.0.x + 1 版之后就放弃了这个方案。

🗃 内置坚果云与 Dropbox 同步盘

坚果云是国内少数几个支持 WebDAV 方案的同步盘产品,不考虑大文件的话,只同步数据文件足够了。

Dropbox 原本的地位跟坚果云一样,但后来它做了一些事情,导致简悦暂时不支持它了,等 API 篇时我会专门介绍的。

📗 手动同步

1.x 版因为只有简悦的配置文件需要同步,而配置文件也不需要经常修改,所以仅支持手动同步方案。

📘 自动同步

2.x 版本之后增加了稍后读和标注功能,所以数据的产生就需要保持实时同步方式,而 Chrome 对扩展的限制,也没办法将数据保存到 Chrome 以外的地方,所以同步助手(看名字就知道)出现了,它具有:【将数据保存到任意目录】的功能。

如果这个目录恰好是某个网盘所在的目录,就自然而然的具有【自动同步】功能。

基于这个功能,简悦的自动同步支持:任意网盘、iCloud、Git、NAS、私有云盘等方案。

💾 更完美的坚果云方案

如果用户恰好使用了坚果云作为同步盘的话,就可以使用 API 的功能了。

注意:不选择坚果云也无所谓,只是单纯的无法使用 API 功能而已。

🆘 划重点

• 自动同步支持:任意网盘、iCloud、Git、NAS、私有云盘等方案

• 如果使用了坚果云,则支持 API 功能

• 开启了自动同步后,会导致个别用户无法安装插件,目前可以使用 插件管理器 2.0 完美解决。

Back to Top