PapaTramp/openclaude-LLM-local
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: prerequisites and Ollama setup in §4, RAG primer in §8, gh/Cursor troubleshooting

Browse Source 
Made-with: Cursor
This commit is contained in:
PTah
2026-04-21 15:32:34 +10:00
parent 73e65c23d5
commit 25de357982
3 changed files with 107 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/openclaude-with-repositories.md
+12
View File
@@ -106,6 +106,18 @@ git remote set-url origin git@github.com:OWNER/REPO.git
- Смешивание нескольких аккаунтов в одном credential helper.
- Отсутствуют локальные зависимости проекта (тесты не запускаются).
### GitHub CLI: `Could not resolve to a Repository` или `Repository not found`
На **вашей машине** `gh repo view OWNER/REPO` может работать (например, после `gh auth login` или с корректным классическим token), а в **другой среде** (CI, удалённый агент, «облачная» сессия без вашего локального credential store) — нет: там часто **нет той же авторизации** или репозиторий **приватный** и для этой среды не выдан доступ.
Что проверить:
1. **Fine-grained PAT**: в разделе доступа к репозиториям явно добавлен нужный репозиторий (или группа «All repositories», если так задумано). Один только заголовок в UI не гарантирует, что токен передан в ту среду, где выполняется команда.
2. **Permissions**: для `gh repo view` как минимум чтение метаданных репозитория (в терминах GitHub — **Metadata** read и при необходимости **Contents** read).
3. **Контекст агента**: удалённый агент должен работать в **workspace = клон нужного репозитория** и иметь способ подставить токен (`GH_TOKEN`, `gh auth login` в этой среде и т.д.). Локальный успех команды у вас в PowerShell не переносится автоматически в облако.
Если цель — чтобы автоматизация сама делала коммиты/PR в приватный репозиторий, выдайте секрет с PAT в этой среде и ограничьте права токена минимально необходимыми scope.
## 9) Рабочий чек-лист перед началом
```bash
docs/quickstart-30min.md
+3 -1
View File
@@ -2,7 +2,7 @@
Короткий маршрут "с нуля до рабочего стенда" на Ubuntu.
Если вы на **Windows**, установите Ollama и Node.js локально, затем для запуска OpenClaude на локальной модели используйте блоки **Windows PowerShell** в `README.md` (раздел «4) Быстрый запуск OpenClaude»). Полный стек ниже (Docker, bash-скрипты, пути `~/...`) удобнее повторять в **WSL2** или на Linux-сервере с тем же репозиторием.
Если вы на **Windows**, установите Ollama и Node.js локально, затем для запуска OpenClaude на локальной модели используйте блоки **Windows PowerShell** в `README.md` (раздел «4) Быстрый запуск OpenClaude»: предусловия **4.0**, установка CLI **4.1**, установка Ollama **4.2**, профиль **4.3**). Полный стек ниже (Docker, bash-скрипты, пути `~/...`) удобнее повторять в **WSL2** или на Linux-сервере с тем же репозиторием.
## 0) Что получится
@@ -21,6 +21,8 @@ sudo systemctl start docker
## 2) Установка Ollama
Ниже — типичный путь для Ubuntu/сервера. Для **macOS**, **Windows** и **winget** см. `README.md`, раздел **4.2**.
```bash
curl -fsSL https://ollama.com/install.sh | sh
sudo systemctl enable ollama