虎鲸笔记插件：恐龙工具箱

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

虎鲸笔记入坑大礼包

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

刚入坑，从其它笔记软件导入数据？markdown 文件一键导入，其它笔记软件的数据库/多维表格通过 csv 导入。
插件安装？提供插件市集，精彩的插件等你发现，一键安装。
格式化？一键格式化，修正中英文标点符号，优化中英文混排空格，规范化全角/半角字符。
从网页剪藏的富文本内容统一为笔记内样式？一键清除样式，移除行内样式，移除链接，移除空格。
任务管理？一键对已完成/未完成任务进行排序。
博客发布？一键发布 Github Pages，自动上传图片，自动维护元数据。
Life Log？使用快捷键一键插入标签，为块打上时间戳。
快捷标签？一键打标签，自动附加属性，支持多选属性合并。
语音笔记？一键同步 voicenotes.com 的语音笔记，自动归档，支持增量同步和全量同步。
标题整理？一键根据标题层级重组文档结构，同级标题智能保持平级，告别阶梯式缩进。
网页助手？内置浏览器沉浸式阅读，智能提取网页元数据，右键一键剪藏内容到每日笔记。
脑图视图？一键将当前块渲染为可缩放、易读的可交互式思维导图。
镜像块支持块嵌入子项，即 Roam Research 中的 Block Embed Children。
随机漫步？基于标签的强大漫步工具，查询块、普通块自动分发，无聊时点一点获取知识惊喜。
剪贴板注入？一键将外部 JSON 数据解析为虎鲸原生块，轻松实现结构化数据的高效同步。
编辑扩展？增强原生编辑器能力，一键复制选中文字为当前块的引用，粘贴即双链。
块工具箱？大幅增强引用块操作，一键将子块归集到源块并原地留痕；一键在父节点下对块置顶/置底。
隐私保护？一键开启隐私块，底层隐身，有效防止 AI 辅助工具读取你的敏感日记。
块流转？告别繁琐拖拽，一键将块快速分发流转到今日日志、明日日志或专属收件箱。
侧边置顶？为高频核心笔记打上特定标签，即可在侧边栏面板一键固定并随时召回，工作流从不中断。

这使你充满了决心

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

使用

下载 Release 包，package.zip。
解压后，将文件夹复制到 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)

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

一键标记：为常用标签配置快捷键，在光标处秒速插入。
默认属性：插入时自动附加属性（如：状态、优先级），支持多选属性合并。

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 思维导图。
动态交互：支持自由拖拽、缩放，双击分支可折叠/展开子节点，理清复杂层级关系。
快速退出：悬浮按钮一键退出脑图模式，无缝切回经典文本大纲视图。
原生兼容：依托于虎鲸强大的原生渲染管线，脑图组件直接内嵌在文档流中，与前后文本无缝衔接。

13. 🪞 支持块嵌入子项 (Embed Children)

优化“镜像块”的展示体验：

子项穿透展示：允许带有特定标签的块，在作为镜像块嵌入到其他页面时，自动展示其子块内容。
灵活配置：可通过设置自定义触发这一特性的专属标签名。
样式无缝融合：优化了引用的树状块的缩进与列表样式，使其在当前文档排版中显得更为自然。

14. 🎲 随机漫步 (Random Walk)

基于标签的强大随机漫步工具，为你的知识库提供探索惊喜：

零配置侦测：为查询块或包含子节点的普通块打上“漫步标签”（如 #随机漫步），即被自动识别为独立的漫步频道。
双模式支持：
- 查询块：通过原生随机引擎自动发牌，无重复遍历。
- 普通块：自动获取其子节点并进行纯内存乱序洗牌。
自定义命名：支持为漫步标签配置 displayName 属性，在频道列表中显示规整的频道名称。
右键即刻漫步: 右键点击任意父块或查询块即可直接开启临时漫步，无需打标。
快捷键支持: 支持为“随机漫步”配置快捷键，一键继续未完的探索。
频道记忆：主按钮智能记忆上一次漫步的频道（包括临时漫步）。

15. 📋 智能剪贴板注入 (Smart Clipboard Injection)

赋予剪贴板解析 JSON 结构的能力，一键将外部格式化数据转化为虎鲸原生笔记节点：

标准格式支持：支持 { type: "orca-tags", tags: [...], content: ... } 格式直接解析并插入笔记。
快捷键触发：支持配置独立的快捷键，实现秒速转换剪贴板内容。
富文本内容：支持在打标签的同时插入带格式或链接的 ContentFragment。
数据去重机制：支持通过 primaryKey（字符串或 Tag 映射）配置去重规则，智能避免重复插入。
远程图片转存：支持 downloadImages: true 配置，自动下载并转存远程图片到本地笔记资源中。

{
  "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" }
        }
      ]
    }
  ]
}

16. ⌨️ 编辑器扩展命令 (Editor Commands)

提供原生编辑器以外的增强型命令集合：

复制为块引用 (JSON)：选中一段文本，可直接调用命令（支持配置快捷键）将其转化为指向当前块的引用（别名为该选中文本），并以 JSON 格式写入剪贴板。
协同增强：高度契合 智能剪贴板注入 插件，将上述生成的 JSON 在任意位置快捷粘贴，即可实现跨页面的光速块引用插入。

17. 🛠️ 块工具箱 (Block Tools)

增强块右键菜单的操作能力，特别针对“引用块（Reference Blocks）”的深度流转：

归集子块到引用源：将当前引用块下的子块移动到其指向的源块中，保留当前引用关系。
归集子块并删除：将子块归集到源块后，直接删除当前的引用块（用于临时中转页面的清理）。
归集子块并留痕：将子块移动到源块，同时将当前块 A 转换为纯文本（保留别名），并在其下方生成指向已移动子块的新引用，实现“数据入库，原地留踪”。
在父块下置顶/置底：快速将选中的块移动到其父块的开头或末尾，方便进行版面整理。
灵活开关：支持在设置面板中为上述功能提供独立开关。
批量操作：支持多选块后一键批量执行。

18. 🔒 隐私块 (Privacy Block)

一个极简但有效的隐私保护工具，通过底层转换器机制向 AI 隐藏敏感内容：

拦截 AI 读取：当 AI 请求当前笔记上下文、搜索或总结时，只会读取到 [🔒 隐私内容已隐藏]。
原生编辑体验：隐私块保留了原生的富文本编辑器功能，支持加粗、高亮、子块嵌套，不影响日常书写。
免密无感干扰：无需繁琐的密码弹窗和加解密等待时间，一键设为隐私块。
视觉提示：隐私块左侧会出现明显的红色指示条及锁形图标，状态一目了然。

19. 🌊 块流转 (Block Flow)

快速将块发送到指定的目标位置，告别繁琐的拖拽和剪切粘贴：

发送至 (Send to…)：右键菜单中提供干净的折叠式子菜单，点击即刻弹出独立的流转选项浮层。
智能目标识别：支持一键将块移动或引用至「今日日志」、「明日日志」或预设的「收件箱（Inbox）」。
防呆设计：自动检测选中的块是否包含日志（Journal）块（使用官方 getRepr API），若有则自动隐藏流转菜单，防止误操作破坏核心日志页。

20. 📌 置顶块 (Pinned Blocks)

基于标签的侧边栏置顶面板，快速访问你的常用核心笔记：

一键置顶：为任何块添加配置的标签（默认为 #置顶）即可将其加入置顶列表。
快捷交互：
- 左键点击：一键在右侧边栏重新打开上一次打开的置顶块，适合快速切回核心工作区。
- 右键点击：弹出所有置顶块的完整列表，供自由选择。
自定义命名：支持通过在标签上添加 displayName 属性来自定义该块在面板中的显示名称，保持列表整洁。

开发说明

本项目采用模块化架构：

src/lets-*：每个目录对应一个子插件。
BasePlugin：所有插件继承自基类，统一管理加载、卸载和日志。
main.tsx：负责动态加载所有子插件。