# Pitfall Log / 踩坑日志

项目：ollama/ollama

摘要：发现 23 个潜在踩坑项，其中 7 个为 high/blocking；最高优先级：安装坑 - 来源证据：0.23.1 : mlx runner failed。

## 1. 安装坑 · 来源证据：0.23.1 : mlx runner failed

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：0.23.1 : mlx runner failed
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16007 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

## 2. 安装坑 · 来源证据：Ollama Cloud: Frequent 503 errors making cloud models unreliable

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Ollama Cloud: Frequent 503 errors making cloud models unreliable
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/15419 | 来源讨论提到 docker 相关条件，需在安装/试用前复核。

## 3. 安装坑 · 来源证据：Support `ppc64le` architecture

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Support `ppc64le` architecture
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/796 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。

## 4. 配置坑 · 来源证据：Not compatible with Glaude code Cli when using local model

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Not compatible with Glaude code Cli when using local model
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16094 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

## 5. 配置坑 · 来源证据：Registering fine-tuned models

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Registering fine-tuned models
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16095 | 来源类型 github_issue 暴露的待验证使用条件。

## 6. 运行坑 · 来源证据：[Bug] 0.23.2 Image generation succeeds but no image saved to disk or returned via API"

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：[Bug] 0.23.2 Image generation succeeds but no image saved to disk or returned via API"
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16072 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

## 7. 安全/权限坑 · 来源证据：Feature Request: Expose account quota/usage details via Ollama Cloud API (headers and/or response body)

- 严重度：high
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Feature Request: Expose account quota/usage details via Ollama Cloud API (headers and/or response body)
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/15663 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

## 8. 安装坑 · 来源证据：VRAM Detection Issue on Radeon 780M (gfx1035) - Kernel Page Fault

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：VRAM Detection Issue on Radeon 780M (gfx1035) - Kernel Page Fault
- 对用户的影响：可能阻塞安装或首次运行。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16040 | 来源讨论提到 linux 相关条件，需在安装/试用前复核。

## 9. 配置坑 · 来源证据：mistral-medium-3.5 - Produces nonsense outputs

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：mistral-medium-3.5 - Produces nonsense outputs
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/15975 | 来源讨论提到 linux 相关条件，需在安装/试用前复核。

## 10. 能力坑 · 能力判断依赖假设

- 严重度：medium
- 证据强度：source_linked
- 发现：README/documentation is current enough for a first validation pass.
- 对用户的影响：假设不成立时，用户拿不到承诺的能力。
- 证据：capability.assumptions | github_repo:658928958 | https://github.com/ollama/ollama | README/documentation is current enough for a first validation pass.

## 11. 运行坑 · 来源证据：SIGSEGV in MLX VAE decode after diffusion steps complete on M4 Pro (macOS 26.4.1, Ollama 0.23.2)

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：SIGSEGV in MLX VAE decode after diffusion steps complete on M4 Pro (macOS 26.4.1, Ollama 0.23.2)
- 对用户的影响：可能阻塞安装或首次运行。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16093 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

## 12. 运行坑 · 来源证据：ollama run 交互模式无法拖拽/粘贴图片

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：ollama run 交互模式无法拖拽/粘贴图片
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16091 | 来源类型 github_issue 暴露的待验证使用条件。

## 13. 运行坑 · 来源证据：v0.23.0

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个运行相关的待验证问题：v0.23.0
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/releases/tag/v0.23.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。

## 14. 维护坑 · 来源证据：Featured your project on osalt.dev — README badge available if you'd like to use it

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Featured your project on osalt.dev — README badge available if you'd like to use it
- 对用户的影响：可能影响升级、迁移或版本选择。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/16092 | 来源类型 github_issue 暴露的待验证使用条件。

## 15. 维护坑 · 来源证据：Running qwen3.6:27b-bf16 on an AMD Ryzen AI Max leads to gibberish

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Running qwen3.6:27b-bf16 on an AMD Ryzen AI Max leads to gibberish
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/15879 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。

## 16. 维护坑 · 来源证据：Running qwen3.6:27b-q8_0 produces also gibberish on an AMD Ryzen AI Max+

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Running qwen3.6:27b-q8_0 produces also gibberish on an AMD Ryzen AI Max+
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 证据：community_evidence:github | https://github.com/ollama/ollama/issues/15903 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。

## 17. 维护坑 · 维护活跃度未知

- 严重度：medium
- 证据强度：source_linked
- 发现：未记录 last_activity_observed。
- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- 证据：evidence.maintainer_signals | github_repo:658928958 | https://github.com/ollama/ollama | last_activity_observed missing

- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 证据：downstream_validation.risk_items | github_repo:658928958 | https://github.com/ollama/ollama | no_demo; severity=medium

## 19. 安全/权限坑 · 存在安全注意事项

- 严重度：medium
- 证据强度：source_linked
- 发现：No sandbox install has been executed yet; downstream must verify before user use.
- 对用户的影响：用户安装前需要知道权限边界和敏感操作。
- 证据：risks.safety_notes | github_repo:658928958 | https://github.com/ollama/ollama | No sandbox install has been executed yet; downstream must verify before user use.

## 20. 安全/权限坑 · 存在评分风险

- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：风险会影响是否适合普通用户安装。
- 证据：risks.scoring_risks | github_repo:658928958 | https://github.com/ollama/ollama | no_demo; severity=medium

## 21. 安全/权限坑 · 来源证据：v0.23.1

- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v0.23.1
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 证据：community_evidence:github | https://github.com/ollama/ollama/releases/tag/v0.23.1 | 来源类型 github_release 暴露的待验证使用条件。

## 22. 维护坑 · issue/PR 响应质量未知

- 严重度：low
- 证据强度：source_linked
- 发现：issue_or_pr_quality=unknown。
- 对用户的影响：用户无法判断遇到问题后是否有人维护。
- 证据：evidence.maintainer_signals | github_repo:658928958 | https://github.com/ollama/ollama | issue_or_pr_quality=unknown

## 23. 维护坑 · 发布节奏不明确

- 严重度：low
- 证据强度：source_linked
- 发现：release_recency=unknown。
- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
- 证据：evidence.maintainer_signals | github_repo:658928958 | https://github.com/ollama/ollama | release_recency=unknown