Skip to content

NUTBOOK 1.0.0 — Local Library for AI Outputs / AI 产物的本地资料库

Choose a tag to compare

View all tags
@Ericonquer Ericonquer released this 15 Sep 16:22
· 21 commits to main since this release
v1.0.0
486665f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

NUTBOOK 1.0.0

中文 | English

中文

NUTBOOK 是一款面向 AI 生成内容的本地阅读、管理与展示工具。它将分散在项目目录、Agent 任务、Skill 输出和下载文件夹中的研究报告、课程讲义、竞品分析、客户方案、Markdown 文档与交互式 HTML 演示页，沉淀为可阅读、可管理、可继续修改并可直接展示的本地资料库。

所有内容和索引均保留在本机。NUTBOOK 不替代 Agent，也不管理 Agent 的执行过程；它承接的是生成完成后值得再次阅读、编辑与复用的成果。

核心能力

  • 多来源接入：添加本地文件夹、单个 Markdown 或 HTML 文件；发现并接入 Codex、Claude Code、OpenClaw、Hermes、WorkBuddy 等 Agent 的项目与任务成果；扫描内容型 Skill 输出；也可通过 Nutbook CLI 接入或移除文件、文件夹和项目。
  • Markdown 阅读与轻编辑：文档大纲、格式工具、表格、图片插入与对齐、撤销/重做、保存和未保存退出保护；系统双击打开 Markdown 时先进入临时会话，需要时再明确加入资料库。
  • 交互式 HTML 运行与轻编辑：保留原页面 JavaScript 交互，支持窗口级全屏；对受支持页面可修改文本和富文本，并替换、裁切、移动或新增图片。普通 HTML 会生成同目录的可编辑副本，保护原始文件。
  • 本地资料库：为 Markdown 与 HTML 生成缩略图，支持收藏、自定义标签、Skill 标签、类型筛选与最近使用；文件系统是真实状态源，外部新增、修改和删除会同步反映到资料库。
  • Agent 集成与本地 CLI：可检测、启用、修复或移除经过确认的 Agent 集成；不修改 PATH，不静默覆盖无法确认归属的文件；CLI 不会删除源文件。

适合谁使用

  • 用 Agent 生成课程资料、讲义、案例或演示页的教师
  • 累积论文解读、研究笔记与阶段报告的学生和研究人员
  • 整理竞品分析、市场调研、客户方案与提案的商业、咨询与策划人员
  • 同时使用多个 Agent、Skill 或本地内容生成工具，希望长期沉淀成果的人

当前支持与边界

  • 支持：Markdown 和 HTML 文件。
  • NUTBOOK 专注于 AI 产物的阅读、轻编辑、管理与展示，不是通用文件管理器或重型创作工具。
  • HTML 原生编辑能力取决于页面是否具备相应支持；不承诺重构任意网页的布局或脚本。
  • 当前不提供云同步、在线协作或 RAG 知识库。

安装说明

  • macOS：请选择与芯片架构对应的安装包：Apple Silicon（M1/M2/M3/M4 等）或 Intel。
  • Windows：下载并运行 Windows 安装程序。
  • macOS 首次启动时，如系统提示无法验证开发者，请前往“系统设置 → 隐私与安全性”，选择“仍要打开”或“允许打开”。

感谢你使用 NUTBOOK。欢迎通过 Issues 反馈使用中的问题、兼容性情况与产品建议。

English

NUTBOOK is a local reader, library manager, and presentation tool for AI-generated work. It turns research reports, lesson materials, competitive analyses, client proposals, Markdown documents, and interactive HTML presentations scattered across project folders, Agent tasks, Skill outputs, and downloads into a local library you can read, organize, lightly edit, and present.

All content and indexes stay on your machine. NUTBOOK does not replace an Agent or manage its execution. It takes over after generation, when an output is worth reading, editing, and reusing again.

Core capabilities

  • Multi-source intake: add local folders and individual Markdown or HTML files; discover outputs from Codex, Claude Code, OpenClaw, Hermes, WorkBuddy, and other Agent projects or tasks; scan content Skill outputs; and add or remove files, folders, and projects through the Nutbook CLI.
  • Markdown reading and light editing: document outline, formatting tools, tables, image insertion and alignment, undo/redo, save, and unsaved-change protection. Markdown files opened from the system first enter a temporary session and can be explicitly added to the library when needed.
  • Interactive HTML runtime and light editing: preserves original page JavaScript interactions and supports window-level fullscreen. Supported pages allow text and rich-text edits plus image replacement, cropping, moving, and insertion. Ordinary HTML receives an editable sibling copy so the original remains protected.
  • Local library management: generates thumbnails for Markdown and HTML; supports favorites, custom tags, Skill tags, type filters, and recent items. The file system is the source of truth, so external additions, edits, and deletions are reflected in the library.
  • Agent integration and local CLI: detects, enables, repairs, or removes confirmed Agent integrations. It does not change PATH or silently overwrite files with uncertain ownership, and CLI operations never delete source files.

Who it is for

  • Teachers creating course materials, handouts, cases, or presentations with Agents
  • Students and researchers collecting paper notes, research logs, and phased reports
  • Business, consulting, and strategy professionals organizing competitive analyses, market research, proposals, and client materials
  • Anyone using several Agents, Skills, or local content-generation tools and wanting to preserve useful outputs over time

Current scope

  • Supported formats: Markdown and HTML.
  • NUTBOOK focuses on reading, light editing, organizing, and presenting AI outputs. It is not a general file manager or a heavyweight authoring tool.
  • Native HTML editing depends on page support and does not promise to rebuild the layout or scripts of arbitrary web pages.
  • Cloud sync, online collaboration, and RAG knowledge bases are not currently included.

Installation

  • macOS: choose the installer for your chip architecture: Apple Silicon (M1/M2/M3/M4 and later) or Intel.
  • Windows: download and run the Windows installer.
  • On first launch in macOS, if the system cannot verify the developer, open System Settings → Privacy & Security and select Open Anyway or Allow.

Thank you for using NUTBOOK. Please use Issues to share bugs, compatibility results, and product suggestions.

Assets 8
Loading