恐龙工具箱（虎鲸笔记版）

发表于

这是一个为 Orca Note (虎鲸笔记) 开发的增强插件集合，提供了一系列实用的工具来提升笔记体验。

虎鲸笔记入坑大礼包

从数据导入到发布，从格式化到排序，从样式清除到快捷标签，应有尽有。

  1. 刚入坑，从其它笔记软件导入数据？markdown 文件一键导入，其它笔记软件的数据库/多维表格通过 csv 导入。

  2. 插件安装？提供插件市集，精彩的插件等你发现，一键安装。

  3. 格式化？一键格式化，修正中英文标点符号，优化中英文混排空格，规范化全角/半角字符。

  4. 从网页剪藏的富文本内容统一为笔记内样式？一键清除样式，移除行内样式，移除链接，移除空格。

  5. 任务管理？一键对已完成/未完成任务进行排序。

  6. 博客发布？一键发布 Github Pages，自动上传图片，自动维护元数据。

  7. Life Log？使用快捷键一键插入标签，为块打上时间戳。

  8. 快捷标签？一键打标签，自动附加属性，支持多选属性合并。

  9. 语音笔记？一键同步 voicenotes.com 的语音笔记，自动归档，支持增量同步和全量同步。

  10. 标题整理？一键根据标题层级重组文档结构，同级标题智能保持平级，告别阶梯式缩进。

  11. 网页助手？内置浏览器沉浸式阅读，智能提取网页元数据，右键一键剪藏内容到每日笔记。

  12. 脑图视图？一键将当前块渲染为可缩放、易读的可交互式思维导图。

这使你充满了决心

这是一只恐龙，路过的人必须夸它可爱。

使用

  1. 下载 Release 包，package.zip。

  2. 解压后，将文件夹复制到 Orca Note 的插件目录。

功能列表

此插件集包含以下子插件，均可在设置中单独开启或是使用：

1. 📝 一键格式化 (Format Block)

标准化当前块及其子块的文本格式：

  • 自动修正中英文标点符号。

  • 优化中英文混排空格。

  • 规范化全角/半角字符。

2. 🎙️ VoiceNotes 同步

将 VoiceNotes 的录音笔记同步到虎鲸笔记中：

  • 支持增量同步和全量同步。

  • 自动归档到指定的 “VoiceNotes Inbox”。

3. 📂 导入工具 (Import)

  • 文件夹导入：支持批量导入文件夹中的 Markdown 文件。

  • CSV 导入：

    • 多模板映射：支持为同一个 CSV 文件配置多个标签模板。
    • 智能解析：自动处理日期（DateTime）、多选（TextChoices）等复杂属性。
    • 灵活性：支持导入为无父节点的根块（Root Blocks）或指定父块。
    • 双向插入：既可以插入到指定页面，也可以直接导入到“每日笔记”。

4. 🧹 样式清除 (Remove Style)

快速清理笔记内容的格式：

  • 移除行内样式：清除加粗、高亮等富文本样式。

  • 移除链接：将链接转换为纯文本。

  • 移除空格：将空行（且无子节点）删除。

5. 🔃 块排序 (Sort Blocks)

对选中的多个块进行智能排序：

  • 可配置顺序：支持自定义排序规则（默认：空块 -> 普通块 -> 已完成任务 -> 未完成任务）。

  • 字典序排列：同类块内部按文本内容字典序排列。

  • 多选触发：仅当选中 2 个及以上块时才显示菜单。

6. 📤 发布到 GitHub (Publish)

将 Orca 笔记一键发布为 Markdown 博客文章：

  • 图床集成：自动提取文中图片并上传到指定的 GitHub 仓库（支持去重复用）。

  • 博客部署：将 Markdown 内容推送到博客仓库（适配 Hexo/Jekyll/Hugo 等）。

  • 智能元数据：

    • 自动生成 Frontmatter。
    • 记录 github_url 和 blog_url（可点击）。
    • 自动维护 publish_date 创建时间。
    • 仅对页面块（Page Block）生效。

  • 诗歌模式：

    • 紧凑排版：通过标签触发，自动压缩双换行为单换行。
    • 强制换行：自动在行尾添加空格，支持标准 Markdown 换行渲染。

7. 🏪 插件市集 (Bazaar)

Orca 的社区插件市场，发现更多可能：

  • 浏览与安装：直接在应用内浏览并一键安装社区插件。

  • 自动管理：支持插件的更新与卸载。

  • 自定义源：支持在插件设置中自定义 plugins.json 列表的网络源地址（配置项：插件源 URL）。

  • 贡献生态：欢迎开发者提交自己的插件到市集。

8. 🏷️ 快捷标签 (Quick Tag)

提升标签录入效率的专属工具：

  • 一键标记：为常用标签配置快捷键，在光标处秒速插入。

  • 默认属性：插入时自动附加属性（如：状态、优先级），支持多选属性合并。

  • 剪贴板粘贴：

    • 支持 { type: "orca-tags", tags: [...], content: ... } 标准格式。
    • 富文本内容：支持在打标签的同时插入带格式或链接的 ContentFragment。
    • 数据去重：支持通过 primaryKey（字符串或 Tag 映射）配置去重规则，避免重复插入。
    • 远程图片转存：支持 downloadImages: true 配置，自动下载并转存远程图片到本地资源。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
  "type": "orca-tags",
  "content": [
    { "t": "t", "v": "Check our " },
    { "t": "l", "v": "Orca Documentation", "l": "https://orca.so/docs" }
  ],
  "primaryKey": {
    "任务标签": "参考链接"
  },
  "downloadImages": true,
  "tags": [
    {
      "任务标签": [
        {
          "name": "状态",
          "type": 6,
          "value": ["进行中", "高优先级"]
        },
        {
          "name": "进度",
          "type": 3,
          "value": 75
        },
        {
          "name": "已归档",
          "type": 4,
          "value": false
        },
        {
          "name": "参考链接",
          "type": 1,
          "value": "https://leay.net",
          "typeArgs": { "subType": "link" }
        },
        {
          "name": "封面",
          "type": 1,
          "value": "https://raw.githubusercontent.com/hqweay/picbed/master/img/avatar/avatar.png",
          "typeArgs": { "subType": "image" }
        }
      ]
    }
  ]
}

9. 🌳 标题层级整理 (Heading Tree) 🥰 SaXz2

根据标题层级智能重组文档结构：

  • 自动层级识别：智能识别 H1-H4 标题层级关系。

  • 同级保持平级：同级标题不会错误地形成阶梯式缩进，保持正确的兄弟关系。

  • 智能移动：只移动需要调整的块，已在正确位置的块保持不动。

  • 文本归属：普通文本块自动成为最近标题的子块。

  • 层级断层处理：支持缺失中间层级的情况（如 H1 → H3）。

10. 🌐 网页助手 (Web Assistant)

集 元数据提取、内置浏览、内容剪藏 于一体的网页增强工具：

  • 智能提取 (Smart Extraction)：

    • 自动模式：一键提取链接的标题、封面、简介等元数据，生成精美卡片。
    • 规则引擎：内置豆瓣等常用规则，支持编写 JavaScript 脚本自定义提取逻辑。

  • 沉浸式浏览 (Internal Browser)：

    • 内置浏览器：直接在笔记内打开网页，查阅资料无需切换窗口。
    • 强力导航：自动处理 target="_blank" 跳转，保持在当前窗口浏览。
    • 快速访问：自定义常用网站（如 Google、豆瓣、Wiki）的快速入口。

  • 内容剪藏 (Web Clipper)：

    • 所选即所得：在浏览器中选中文字，右键一键 “保存到每日笔记”。
    • Markdown 引擎：自动将 HTML 转换为 Markdown（保留标题、链接、加粗等格式）。
    • 结构化剪藏：自动创建"书签块"（包含标题、链接、封面、标签），并将正文作为子块嵌套插入，保持笔记整洁。
    • 交互式提取：解决需要登录或动态加载的页面提取难题。

  • 移动端模拟 (Mobile Simulation)：

    • 一键切换至移动端 UA，获得适合小窗口阅读的清爽排版（特别适配豆瓣等移动端优化站点）。

  • 图片处理优化 (Image Enhancement)：

    • 跨域复制 (Copy Image)：采用 “超采样像素提取 (Super-sampling Capture)” 策略，解决 Webview 无法直接复制 Pixiv/豆瓣 等站点的防盗链图片到剪贴板的问题。

  • 灵活配置：

    • 支持顶部栏入口（独立按钮或聚合菜单）。
    • 支持将提取的数据插入当前块或新建块。

11. 🧠 记忆复习 (SRS)

基于 FSRS 算法的高效记忆与知识探索工具：

  • FSRS 算法集成：集成 ts-fsrs，根据遗忘曲线智能调度复习任务。

  • 漫游模式 (Roaming Mode)：

    • 智能关联漫游：对单块启动漫游时，自动收集其子树内容、出链（Outgoing Refs）及反链（Backlinks），在复习的同时探索关联知识。
    • 动态查询漫游：直接将 Query 块的实时搜索结果（如“#书签”）转化为漫游任务流。

  • 无感转换与持久化：

    • 自动转化：在漫游时通过“标记已读”或“打分”即可自动将普通块转为闪卡（附加 #Card 标签），无需预先手动转换。
    • 全方位记录：支持保存备注（Remark）、标记（Flag）及状态切换（归档/暂停）。

  • 交互优化：

    • 多形态支持：支持问答模式（Item）与沉浸式阅读模式（Topic）。
    • 操作手感：支持快捷键（空格、数字 1-4）、一键撤销（Z 键）、撤销复习进度等。

  • 完全国际化：全界面中英文适配，包括时间间隔（如“1天”、“2.5月”）的本地化展示。

12. 🗺️ 脑图视图 (Mind Map)

将任意笔记结构一键转化为直观的思维导图：

  • 节点可视化：在任意块所在菜单点击 View as Mind Map，即可原地将其及子孙节点渲染为 SVG 思维导图。

  • 动态交互：支持自由拖拽、缩放，双击分支可折叠/展开子节点，理清复杂层级关系。

  • 快速退出：悬浮按钮一键退出脑图模式，无缝切回经典文本大纲视图。

  • 原生兼容：依托于虎鲸强大的原生渲染管线，脑图组件直接内嵌在文档流中，与前后文本无缝衔接。

开发说明

本项目采用模块化架构：

  • src/lets-*：每个目录对应一个子插件。

  • BasePlugin：所有插件继承自基类，统一管理加载、卸载和日志。

  • main.tsx：负责动态加载所有子插件。