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 や破損した 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")

# pure-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 プレビュー

FAQ (5)

同类型项目

hermes-agent

firecrawl

go

markitdown