Question 1

使用 tools 或 outputSchema 时，如何修复 Magnitude 错误“grammar binding failed: Too many items (limit 50000; mask)”？

Accepted Answer

将 Magnitude 升级到 v0.2.6 或更高版本；该 grammar-binding 回归已在该版本中修复。在 Magnitude 0.2.5 上，解决方法是移除工具定义中嵌套的 outputSchema，或减少/简化已注册的工具 schema。该故障发生在生成之前，并非由 RAM 不足引起。

Question 2

为什么在 Apple M4 上，对于相同的 GGUF 模型，Magnitude 推理比 llama.cpp 慢 5–6 倍，以及如何修复？

Accepted Answer

这是 Magnitude 旧版基于 llama.cpp 的推理引擎/后台服务中的一个 macOS 性能回归问题。将 Magnitude CLI 更新到 0.0.13 或更高版本；该问题也可通过 v0.2.0+ 中的新推理引擎解决。

1. 停止已加载的模型/服务：
magnitude models stop
2. 更新 Magnitude：
npm install -g @magnitudedev/cli@latest
3. 确认版本：
magnitude --version
4. 重新加载模型并验证 Metal 加速：
magnitude models load gemma-4-e2b-it-qat:gguf:q4
magnitude hardware

更新后，在相同 GGUF 和硬件上，生成吞吐量应与 llama-server -ngl 99 相当。

Question 3

如何在使用 react-markdown 渲染的 markdown 链接中拦截 `javascript:` 和 `data:` URL？

Accepted Answer

升级到 `react-markdown@9`；其 `defaultUrlTransform` 已经会将 `javascript:`、`data:` 和 `file:` 等危险协议重写为空字符串。如需显式仅允许 `http:`、`https:` 和 `mailto:` 的白名单，请传入自定义的 `urlTransform`，并将被拒绝的链接渲染为纯文本： ```tsx import ReactMarkdown, { defaultUrlTransform } from 'react-markdown'; const ALLOWED_PROTOCOLS = new Set(['http:', 'https:', 'mailto:']); function safeUrlTransform(url: string) { const transformed = defaultUrlTransform(url); if (!transformed) return ''; const base = globalThis.location?.origin ?? 'http://localhost'; const { protocol } = new URL(transformed, base); return ALLOWED_PROTOCOLS.has(protocol) ? transformed : ''; } href ? {children} : <>{children}, }} > {markdown} ``` 为 `javascript:alert(1)`、`data:text/html,...` 和 `file:` URL 添加回归测试。不要仅依赖 Electron CSP，因为 Web UI 可能在没有它的普通浏览器中运行。

Question 4

运行 magnitude setup 时，如何修复“release request failed”？

Accepted Answer

将 Node.js 升级到 18 或更高版本，因为 Magnitude 启动器需要内置的 fetch API。使用 node -v 检查当前版本，然后安装 Node.js 18+ 并再次运行 magnitude setup。如果错误仍然存在，请确认你的网络可以访问 release assets，并禁用或重新配置任何可能阻止下载的 VPN/proxy。

Question 5

How do I fix the Ctrl+R Recent Conversations selection moving off-screen and not loading more pages when using arrow keys in the CLI?

Accepted Answer

The bug occurs because the overlay checks scroll position during React rendering and pagination depends on scroll events; keyboard navigation changes the selected index without scrolling the container.

The fix (PR #86) is to:
1. Replace render-time scroll polling with the existing `useInfiniteScroll` lifecycle.
2. Assign stable IDs to conversation rows.
3. Call OpenTUI's `scrollChildIntoView` after every Up/Down navigation so the selected `>` row stays visible.
4. Clamp the selection when refreshed results become shorter.
5. Continue loading pages until the viewport has a usable scroll range, then request one page when the bottom threshold is reached.

Update to a CLI build containing PR #86. On older builds, use the mouse or trackpad to scroll inside the Ctrl+R overlay and trigger pagination; arrow keys alone will not load the next page. Note that the affected built-in agent was later removed, so current builds may not include this overlay.

Magnitude

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐