Skip to content

docs: 開発版のビルド手順を実態に合わせて修正#314

Merged
ensan-hcl merged 1 commit intomainfrom
docs/fix-build-guide
Apr 18, 2026
Merged

docs: 開発版のビルド手順を実態に合わせて修正#314
ensan-hcl merged 1 commit intomainfrom
docs/fix-build-guide

Conversation

@nyanko3141592
Copy link
Copy Markdown
Collaborator

Summary

  • Git LFS を「推奨」から「必須」に昇格。brew install git-lfsgit lfs install を明示
  • submodule (Hugging Face上のzenz gguf / base_n5_lm) が LFS を使っている旨と、git -C <submodule> lfs pull の手順を追加
  • install.sh の前段に「署名の設定(初回のみ)」セクションを新設。Personal Team への変更とバンドルID置換を必須手順として明示(従来はトラブルシューティングに埋もれていた)
  • トラブルシューティング内の重複を整理、stale path (zenz-v3-small-ggufzenz-v3.1-small-gguf) を修正

Motivation

READMEの手順通り git clone --recursive./install.sh を実行しても、

  • Git LFS 未導入だと submodule は LFS ポインタ(134B)のままで取得できず、モデル重みがローカルに落ちてこない
  • Apple Developer Program 未加入の場合、install.sh が署名エラーで失敗する

という問題があり、初見のコントリビュータが詰まりやすかったため、実態に合わせて必須手順を整理しました。

Test plan

  • READMEのレンダリングがGitHub上で崩れていないこと
  • 記載のコマンドがそのまま実行できること(git lfs install / git lfs pull / ls -lh ...gguf

🤖 Generated with Claude Code

Git LFSの導入とsubmoduleのLFS取得、および署名設定の変更を
install.sh実行前の必須手順として明示。トラブルシューティング
側の重複とstaleなパスも整理。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Member

@ensan-hcl ensan-hcl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@ensan-hcl ensan-hcl merged commit 980410e into main Apr 18, 2026
8 checks passed
@ensan-hcl ensan-hcl deleted the docs/fix-build-guide branch April 18, 2026 06:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants