Question 1

如何修复 GitHub API 错误处理中的 "NameError: name 'response' is not defined" 错误？

Accepted Answer

在 `github.py` 的 `fetch_all_github_repos` 中，`_fetch_github_api()` 返回的是 `(status_code, data)`，因此不要访问 `response.status_code` 或 `response.text`。请将错误处理代码块替换为：

```python
elif status_code == 404:
    print(f"GitHub user not found: {username}")
    return []
else:
    print(f"GitHub API error: {status_code} - {repos_data}")
    return []
```

这样可以防止应用程序在 GitHub 返回 404、速率限制、网络或其他 API 错误时因 `NameError` 而崩溃。

Question 2

如何修复在 Python 中处理多个 PDF 文件时出现的 PyMuPDF 内存泄漏问题？

Accepted Answer

显式关闭每个 PyMuPDF `Document`。在 `pdf.py` 中，更新 `extract_text_from_pdf()` 以使用上下文管理器：

```python
import fitz

def extract_text_from_pdf(path):
    with fitz.open(path) as doc:
        return "".join(page.get_text() for page in doc)
```

`with` 语句会在提取完成后自动关闭 PDF，从而释放内存。如果无法使用上下文管理器，请在 `finally` 块中调用 `doc.close()`。这可以防止在 Python 3.11 环境下使用 PyMuPDF 1.24.x 批量处理 50 个以上 PDF 时内存持续增长。

Question 3

如何修复在 Windows 上使用 Python 写入 JSON 缓存文件时出现的"UnicodeEncodeError: 'charmap' codec can't encode"错误？

Accepted Answer

在每个写入缓存文件的 `Path.write_text()` 调用中显式设置 UTF-8 编码。在 Windows 上，默认编码可能是 cp1252，它无法编码表情符号、带重音符号的姓名或其他 Unicode 字符。

将：
```python
Path(github_cache_filename).write_text(
    json.dumps(github_data, indent=2, ensure_ascii=False)
)
```

改为：
```python
Path(github_cache_filename).write_text(
    json.dumps(github_data, indent=2, ensure_ascii=False),
    encoding="utf-8"
)
```

将相同的 `encoding="utf-8"` 参数应用于 `github.py` 和 `score.py` 中的所有缓存写入调用，包括 `github.py` 第 49 行附近的 GitHub API 缓存。为了进一步增强健壮性，缓存读取可以通过重建缓存来处理空的或损坏的 JSON。该修复已在 Windows 11 上使用 Python 3.11 验证通过。

Question 4

如何修复运行 score.py 时出现的 Windows 控制台 UnicodeEncodeError 和 Python 3.14 Protobuf TypeError？

Accepted Answer

在导入 Protobuf 或 LLM 库之前，添加以下代码：

```python
import os
import sys

# 为 Windows 控制台输出使用 UTF-8
if hasattr(sys.stdout, "reconfigure"):
    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
if hasattr(sys.stderr, "reconfigure"):
    sys.stderr.reconfigure(encoding="utf-8", errors="replace")

# 强制使用纯 Python 的 Protobuf 实现
os.environ.setdefault("PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION", "python")
```

必须在导入 `protobuf` 之前设置该环境变量。或者，运行：

```powershell
$env:PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION="python"
python score.py
```

你也可以使用 `set PYTHONUTF8=1` 启用 UTF-8 模式，或在启动脚本前运行 `chcp 65001`。PR #340 中已提供修复。

Question 5

为什么在 Gemini 429 错误或 Ollama 超时之后，简历评分会失败并提示 'List should have at least 1 item'？

Accepted Answer

LLM 提取失败可能会将不完整的数据（例如空列表或 `null` 字段）写入 `cache/resumecache_<resume>.json`。在后续运行中，程序会加载这个损坏的缓存而不是重新处理 PDF，从而导致 Pydantic 的 `ValidationError`。

临时解决方法：

```bash
rm cache/resumecache_resume.json
python score.py data/resume.pdf
```

如果受影响的 PDF 文件名不同，请删除与之对应的缓存文件。你也可以临时将 `DEVELOPMENT_MODE = False` 设置为跳过缓存加载。

永久修复方案：在将提取出的 `JSONResume` 对象写入磁盘之前对其进行验证，绝不缓存失败的提取结果，并在加载时验证缓存数据。如果缓存验证失败，则删除或忽略该文件，并重新执行 PDF 提取。此问题已在 PR #198 中得到解决；如有包含该 PR 的版本，请升级到该版本。

hiring-agent

项目简介

README 预览

常见问题 (5)

同类型项目

hermes-agent

firecrawl

go

markitdown