中文 · English
魏碑是一个原生 macOS 阅读与笔记工作台。资料在本地，AI 按需接入。
开发中，暂无正式安装包 · 支持 Apple 芯片与 Intel · 可从源码运行
阅读、对话和笔记可并排显示，也可单独打开。
| 场景 | 在魏碑里 |
|---|---|
| 阅读 | 导入文件夹作为课程，阅读 PDF、HTML、Markdown 和纯文本，搜索课程资料。 |
| 提问 | 选中文字提问，点击回答里的引用查看原文；点击原文下划线可重开对应对话。 |
| 笔记 | 编辑 Markdown，插入图片、公式和代码块。AI 修改笔记前会显示提案，确认后才写入。 |
| 回看 | 查看笔记关联的资料，通过学习记忆查询之前的进度和问题。 |
长时间阅读、摘抄、亲手记笔记，就算完全离开 AI，本身就是有意义的事。
选中文字后，可在浮窗中提问或摘记。
纸面、宣纸、墨石、石碑，另有晴璃、夜璃、雾璃、玄璃四款毛玻璃主题。阅读、对话、写作都可以独立展开；用 ⌘ + + / − 调整全局字号。
纸面 · 沉浸对话 |
墨石 · 沉浸对话 |
晴璃 · 沉浸阅读 |
夜璃 · 沉浸阅读 |
四款主题实景，点击图片查看大图。截图中的资料用于展示，应用不内置这些内容。
| 事项 | 具体方式 |
|---|---|
| 保存 | 课程、笔记、全文索引和学习记忆在本地保存。阅读本地资料和写笔记不需要模型。 |
| 联网 | 在线模型会收到完成请求所需的相关摘录；资料中的远程图片、网页内容也会联网加载。 |
| 写入 | 正式笔记和出处关系的修改先显示提案，由你确认。学习记忆自动记录，并有轻提示说明存了什么。 |
| 访问 | AI 通过魏碑提供的限定工具读取资料，没有终端或任意文件系统访问权。 |
模型由你选择：OpenAI、Anthropic、Google、DeepSeek、Kimi、OpenRouter 等内置预设，也支持订阅登录、本地 llama.cpp 和自定义 OpenAI 兼容接口。完整的数据流向见隐私说明。
目前请从源码运行。需要 macOS 14 及以上和 完整 Xcode 26、Node.js 22 及以上，首次构建需要联网获取依赖。
git clone https://github.com/WroughtMind/weibei.git
cd weibei
npm ci
./script/build_and_run.sh脚本通过唯一的 Catalyst 工程构建并打开魏碑。本机默认使用已有的 Apple Development 签名；无开发身份时可用 WEIBEI_SIGNING_IDENTITY=- 生成未公证候选。详见应用构建说明。
- 导入自己的资料文件夹，作为一门课程打开。
- 选一份资料阅读，在旁边写笔记，试试全文搜索。
- 需要 AI 时，在设置中连接模型，再选中文字提问、点击引用回看原文，或审阅一份笔记提案。
大文件和扫描件会按实际情况显示部分索引状态。目前没有正式发布计划，下一个正式版本号为 0.0.1，详见发布说明。
魏碑诞生于 OpenAI Build Week 2026 教育赛道，此后持续开发。贡献指南介绍协作方式，安全说明介绍安全问题的反馈方式。
构建命令与检查
根目录 Makefile 是薄入口，转发到底层构建脚本（make help 可看同一份列表）：
| 目标 | 实际执行 |
|---|---|
make build |
./script/build_and_run.sh package |
make run |
./script/build_and_run.sh |
make check |
./script/build_and_run.sh check |
make package |
./script/build_and_run.sh package |
make verify |
./script/build_and_run.sh verify（仅 CI 独立桌面自动启动；本机使用画中画验收） |
make editor-build |
npm run build:editor |
make genui-build |
npm run build:genui |
make perf-p95 |
./script/perf_p95.sh $(LOG) $(METRIC)（用法：make perf-p95 LOG=<perf日志> METRIC=<指标名>） |
make release |
./script/build_release_dmg.sh（构建当前架构未公证的正式 DMG） |
make clean |
swift package clean && rm -rf dist（保留 node_modules 与用户数据） |
Node 工具链：在仓库根目录运行 npm ci，按唯一的 package-lock.json 安装依赖。script/ 和 DesignSystem/scripts/ 下的 TypeScript 工具用 tsx 运行，npm run typecheck:tools 做类型检查。
Apple 芯片与 Intel 安装包分别在对应芯片的 Mac 上原生构建。发布资产与验证要求见双架构发布流程。
需要 Node.js 22 及以上：
npm ci
./script/build_and_run.sh check也可以单独运行：
swift build
swift run WeiBeiSelfCheck
swift run WeiBeiWebEditorCheck
swift run WeiBeiNativeCheck --authentication-status真实供应商检查需要本地有效凭据，不会悄悄换成模拟答案。
技术架构
SwiftUI 与 Mac Catalyst 承载工作区，UIKit 会话复用列表和原生富文本排版。PDFKit 读取 PDF，WebKit 渲染 HTML 和 Milkdown 编辑器，Vision 处理扫描页 OCR，SQLite FTS5 提供本地全文索引。会话公式使用 SwiftMath，网页公式使用 KaTeX，图表使用 Mermaid；现有 AppKit 桥接负责窗口材质和 Sparkle 更新。
Swift 原生 Agent 运行时负责工具循环、供应商连接、凭据与会话账本。魏碑在展示或写入前校验引用、学习记忆更新、笔记提案和富答案；visualize 交互片段在无网络、无本地文件访问的沙箱中执行。长 PDF 和扫描件通过资源受限的辅助进程抽取文本，仅无原生文本的页面使用 OCR。
继续阅读
- Build Week 提交记录：OpenAI Build Week 2026 提交记录与评委走查
- 笔记编辑说明：笔记编辑器斜杠命令、图片插入与代码块行为
- 课程库与存储架构：课程库与存储架构
- 原生 Agent 落地记录：Swift 原生 Agent 运行时的验证与落地记录
- 生成式界面设计：生成式界面基础与
visualize决策
- 代码与开发者文档：MIT License。
WeiBeiStele与WeiBeiSteleMono字体：SIL Open Font License 1.1。修改版必须改名，除非另行获得保留名的书面许可。- “魏碑 / WeiBei” 名称、logo、视觉识别、截图与发布媒体：不在 MIT 与 OFL 之内。第三方软件与参考素材保留其原始条款。
- 再分发 fork 或打包应用之前，先读 完整许可说明。贡献流程见 贡献指南，安全问题见 安全说明。