Folio

Name: Folio
Author: jakubro

本地服务

jakubro.github.io记忆与知识0今天更新

代码仓库访问官网

关于 Folio

Folio 为 Markdown 和数据文件夹提供实时浏览器视图，并提供理解整个文件夹的工具。它面向处理文档集合的用户和 Agent，结合变更追踪、数据视图与一致性检查，同时保留纯 Markdown 文件。

主要功能

01渲染含数学、代码和图表的 Markdown
02按页面区块追踪变更
03查看 CSV、JSON、Parquet 和 SQLite 数据
04嵌入实时表格、图表和 SQL 结果
05核对文档数字与源数据
06查找失效链接和规则错误

适用场景

01查看笔记自上次阅读后的变化
02浏览数据文件并筛选记录
03确保文档中的数字与数据一致
04在 CI 中检查文件夹链接和约定

MCP 相关

Folio 提供 MCP 服务，让 Agent 访问与浏览器视图相同的文件夹模型。其 Agent skill 也会指导 Agent 编写能使用该模型的文档。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "jakubro-folio": {
      "command": "npx",
      "args": [
        "-y",
        "@jakubro/folio"
      ]
    }
  }
}

启动命令npx -y @jakubro/folio

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@jakubro/folio0.5.1stdio

工具

收录的工具列表 · 更新于 4 天前

参数	类型	必填	说明
folder	string	否	相对于所提供文件夹的路径，或该文件夹下的绝对路径，例如 notes/；省略表示整个文件夹

详细介绍

Folio

实时查看 Markdown 和数据文件夹。 将 Folio 指向一个文件夹，就能在浏览器中阅读：每个页面都会以 GitHub 风格的 Markdown 呈现，并支持数学公式、代码高亮和图表；保存后，每个页面都会立即更新；整个文件夹也会作为整体呈现——你还有哪些内容没读过、哪些图表已与数据不符、链接指向何处，以及哪些链接已失效。

安装和运行

npx @jakubro/folio ~/notes

打开它显示的地址：http://localhost:8640/；如果该端口已被占用，则使用下一个可用端口。Folio 需要 Node.js 22.18 或更高版本；运行 npm install --global @jakubro/folio 可将其安装为 folio。

在 Claude Code 中，只需运行两个命令，就能将 Folio 的 MCP 服务及其 Agent 技能作为插件安装：

claude plugin marketplace add jakubro/folio
claude plugin install folio@folio

插件工具会读取 Claude Code 当前打开的文件夹所对应的 Folio 服务；插件在 /config 中的 Folio 设置可以通过地址（例如 localhost:8641）或套接字指定另一个服务。

Folio 的功能

Folio 会为整个文件夹建立一个模型：

了解哪些内容对你来说是新的。 Folio 会记住你读过的内容。重新打开页面时，自上次阅读后新增、修改或删除的所有内容都会被标记——表格按行标记，列表按条目标记，代码按行标记；点击即可查看旧文本，文件树也会指出每个移动过的文档。
数据文件和文档中的数据。 CSV、JSON、Parquet、SQLite 等数据文件会以表格和树形结构打开，每列的分布信息显示在列标题下方；对于任何筛选器，还能看到哪些特征使其中的记录有别于其他记录。文档可以嵌入这些数据的表格、图表或单个值，也可以嵌入跨数据源的 SQL 查询；数据变更时，每个嵌入内容都会重新绘制。
可排序和筛选的表格。 页面中编写的表格、从数据中嵌入的表格以及从数据文件打开的表格，都支持按多个列排序，也可按文本、完整值、模式或多个值同时筛选；多个筛选条件可通过 and 或 or 组合。这些操作都不会修改文件，而且视图会保存在页面地址中。
根据数据检查图表。 将正文中的数字与其引用的数据关联起来；一旦数据不符，Folio 就会立即标记。
文件夹约定和健康状况。 在 FOLIO.md 中将文档类型和规则声明为查询。一个健康状况视图（以及 CI 中的 folio check）会列出所有失效链接、缺失的包含内容、失败的查询和不符合要求的规则。
历史记录。 合并 Git 保存的每个版本与 Folio 记录的保存内容，逐块比较，并生成任意日期或周的摘要。
Agent 和编辑器。 MCP 服务、JSON API 和语言服务为它们提供与你阅读时相同的模型；Agent 技能则教会 Agent 如何编写可使用该模型的文档。