Files

T

mesalogo 17186b0c11 feat: add file-backed canvas notes

Magic Notes previously supported rich-text records without a paged drawing or
PDF annotation workflow. Add the integrated PeopleLib Fabric and Quill editor
with flowing text, pen/highlighter, object transforms, images, paper templates,
PDF backgrounds with native text extraction, and raster PDF export. Saves are
manual; undo/redo remains scoped to an annotation page or Quill mode.

Analyze drafts, saved canvases and canvas-source todos with page images and
text when the default model supports images, or an explicitly labelled
text-only fallback. Keep successful saves when automatic analysis fails and
prevent MCP plain-text replacement of canvas records.

Move entry bodies and binary assets into local note files with schema 38
migration and verified readback. SQLite retains metadata, indexes, revisions,
todos and comments. Backups must coordinate SQLite and the adjacent notes
directory while writes are paused or the app is closed; no one-click backup
action is included.

Show a continuous record stream with independent collapsible record index and
AI pane, real first-page thumbnails, and scroll-only record navigation. Open a
blank text/canvas composer by default and reset it after creation. Protect
unsaved drafts and establish normalized editor baselines after saving so clean
records do not prompt again when leaving.

Validation: latest recorded focused run passed 149 tests across five files;
typecheck, lint and git diff --check passed. The prior user-reported full run
passed 4,713 tests before later corrections and UI changes; it is not a full
validation of this final snapshot. Tests were not rerun for this commit, as
requested; independent systematic review follows the commit.

Release note: Create paged notes with handwriting, flowing text and PDF
annotations, browse records through thumbnails, and request AI comments with
an explicit text-only fallback. Existing notes migrate to local file storage;
backups now need both the database and notes directory.

2026-09-19 11:54:23 +08:00

6.6 KiB

Raw Blame History

GoodBuddy

模型对话、编程 Agent、本地知识库和定时任务的桌面入口

English | 简体中文

产品官网 · 下载 · 功能矩阵 · 构建说明

GoodBuddy 是用于模型对话、编程 Agent、知识检索、笔记和定时任务的桌面应用。使用 GoodBuddy 无需注册账号，工作数据默认保存在本机。模型服务可以运行在本机、组织内网或用户选择的云端服务。

产品亮点

本地优先：无需注册 GoodBuddy 账号，工作数据默认保存在本机，模型服务由用户选择。
统一 Agent Runtime：在一个桌面界面中使用直连模型、OpenCode、Continue 和预览版 DeepSeek Harness。
执行边界明确：Ask 保持只读，Execute 使用当前账号权限，工具调用、取消、超时和 Token 用量均有记录。
支持信创软硬件：正式 Linux 版本覆盖国产 x64 与 arm64 架构，可用于统信 UOS、银河麒麟及海光、兆芯、鲲鹏、飞腾等兼容环境；龙芯 LoongArch 提供独立 loong64 实验预览版。
知识与长期工作一体化：知识库、知识图谱、魔法笔记、任务和智能心跳共享同一个桌面工作空间。

信创支持按操作系统、指令集和安装包兼容性描述，不代表已完成所有厂商、整机和系统版本的兼容认证。龙芯版本尚未进入正式发布矩阵，具体限制见龙芯预览版说明。

主要能力

范围	GoodBuddy 提供的能力
Agent Runtime	直连模型、OpenCode、Continue 和预览版 DeepSeek Harness
数据与执行	本地 SQLite 与笔记文件存储、只读 `Ask`、使用当前账号完整权限的 `Execute`、工具调用记录
知识库	导入文件、目录和网页，通过全文、中文词组、向量和知识图谱检索
桌面版本	Windows、macOS、Linux 的 `x64` 与 `arm64` 正式版本，以及龙芯 LoongArch 实验预览版
外部连接	本机或内网模型服务、自定义 MCP、微信 ClawBot、企业微信和钉钉

产品界面

知识库与知识图谱

魔法笔记与智能心跳

魔法笔记连续展示全部记录，左侧窄栏索引与右侧 AI 评论可独立收起，点击缩略图滚动定位并保留草稿。支持富文本记录和分页画布，可混排跨页正文、手写笔迹、高亮、图片与 PDF 底版，导入 PDF 时提取原生文字，并将批注页面导出为栅格 PDF。画布由用户手动保存；AI 评论按默认模型的图像输入能力分析，不支持图像时明确提示仅文字降级。具体行为与最终验证状态见魔法笔记文档。

Agent Runtime

Runtime	适用场景	配置来源
直连模型	对话、知识检索、图片生成和内置工具	GoodBuddy 模型连接
OpenCode	编程 Agent、原生 Commands、Tools 和 Skills	GoodBuddy 管理或 OpenCode 自有配置
Continue	Rules、Prompt 预设和编程任务	GoodBuddy 管理或 Continue 自有配置
DeepSeek Harness（预览）	固定 Host 与可选插件能力	GoodBuddy 管理的 OpenAI 兼容连接

每次运行都会记录取消、超时、Token 用量、工具调用和执行历史。各 Runtime 的原生能力与配置仍分别管理。

下载

从 GitHub Releases 下载：

系统	架构	格式
Windows	`x64`、`arm64`	NSIS、便携 ZIP
macOS	`x64`、`arm64`	DMG、ZIP
Linux	`x64`、`arm64`	AppImage、DEB、RPM

龙芯 LoongArch 使用独立的 loong64 实验预览通道，可在产品官网选择下载。

桌面安装包不包含远端 Agent payload。本地项目无需 Agent 包；托管 SSH 用户可在设置中单独下载或导入。

当前未配置代码签名和 macOS notarization，操作系统可能显示安全提示。

从源码运行

需要 Node.js 24 和 npm：

git clone https://github.com/mesalogo/goodbuddy.git
cd goodbuddy
npm ci
npm run dev

构建与打包说明见 BUILD.md。

文档

隐私与执行边界

模型请求只发送到用户选择的服务。
本地数据默认保存在系统应用数据目录，API Key 由系统安全存储加密。
Renderer 不接触原始 Electron API 或模型凭据。
DeepSeek Harness 插件市场默认关闭。第三方插件安装脚本、初始化代码和 Execute 工具以当前用户权限运行。
远程委派只在用户配置端点和令牌后启用。
内网兼容模式允许应用内 HTTP 和非标准 HTTPS 证书；微信凭据和媒体端点仍执行严格校验。

参与贡献

欢迎提交 Issue 和 Pull Request。请先阅读 AGENTS.md，提交前运行：

npm test
npm run typecheck
npm run lint

社区交流

扫描二维码加入 GoodBuddy 微信群：

开源许可

GoodBuddy 原创代码采用 0BSD License，可自由使用、修改、分发和商用。第三方组件和资源遵循各自许可证。

6.6 KiB Raw Blame History Unescape Escape