RAGRAF an DeepSeek Harness anbinden

So funktioniert es

Was in RAGRAF nachgebessert wurde

Der Defekt war nicht „unbequem", sondern „funktioniert überhaupt nicht": Die allererste Antwort mit russischem Text tötete den Server. Durch Ausführen gemessen — drei Ursachen, jede durch eine Messung bestätigt.

UnicodeEncodeError: 'charmap' codec can't encode characters in position 97-105
  File "src/ragraf/mcp_server.py", line 551, in send
    sys.stdout.write(json.dumps(message, ensure_ascii=False) + "\n")

1. 1Stream-KodierungDas MCP-SDK gibt nur 12 Variablen an den Kindprozess weiter (APPDATA, PATH, TEMP, USERPROFILE usw. — DEFAULT_INHERITED_ENV_VARS), und HARNESS entfernt zusätzlich Namen mit PASSWORD|SECRET|TOKEN|KEY sowie alle DSH_*. Weder PYTHONUTF8 noch PYTHONIOENCODING sind dabei — die Prozess-Locale bleibt cp1252. Fix: force_utf8_stdio() konfiguriert stdin, stdout und stderr auf UTF-8, ohne sich auf die Umgebung zu verlassen.
2. 2Abhängigkeitenfastembed, PyYAML, sqlite_vec, tree_sitter und ijson waren für den Interpreter aus PATH nur über die Variable PYTHONUSERBASE erreichbar — HARNESS entfernt sie, und der Server meldet „PyYAML ist nicht installiert". Lösung: Der Server wird mit dem Interpreter der projektinternen .venv gestartet — gemessen importiert er alle Pakete auch bei vollständig entfernten PYTHON*-Variablen.
3. 3Pflichtparameter --projectEin Client, der den Server ohne Argumente startet, konnte ihn überhaupt nicht starten. Fix: --project ist nicht mehr Pflicht — der Korpus wird über das Arbeitsverzeichnis aus dem Registry bestimmt (_resolve_default_project()), zum manuellen Umschalten kam das Tool ragraf_use_project hinzu, und --agent wird zusätzlich aus der Variable RAGRAF_AGENT gelesen.

Die Kompatibilität mit früheren Clients bleibt erhalten: AutoClaw und SagaAI übergeben --project explizit und setzen PYTHONIOENCODING — für sie ändert sich nichts.

Installation — drei Schritte

Alle drei Schritte legen Dateien im HARNESS-Home-Verzeichnis ab (%USERPROFILE%\.dsh oder $DSH_HOME); die fertigen Blöcke liegen im Verzeichnis harness/ des RAGRAF-Repositorys. In den Befehlen unten ist $repo der Pfad zum lokalen RAGRAF-Klon und $dsh die mitgelieferte CLI der App.

1. 1MCP-Server anbindenDer fertige Block harness/ragraf-mcp.patch.yml wird an das Ende der Patch-Ebene des Profils cordis.patch.yml angehängt. Die App speichert Patches als Array, daher wird der Block als separate Zeile „- insert:" eingefügt. Zuerst ein Backup — die Datei gehört dem Benutzer.
   Patch-Block anhängen (PowerShell)Kopieren

   $repo = 'C:\AutoClaw\RAGRAF'   # путь к локальному клону RAGRAF
   $src  = Join-Path $repo 'harness\ragraf-mcp.patch.yml'
   $dst  = Join-Path ([Environment]::GetFolderPath('UserProfile')) '.dsh\profiles\desktop\cordis.patch.yml'
   
   # 1. бэкап (обязательно: файл принадлежит пользователю)
   Copy-Item $dst "$dst.bak-$(Get-Date -Format yyyyMMdd-HHmmss)"
   
   # 2. проверить, что блока ещё нет
   Select-String -LiteralPath $dst -Pattern 'mcp-ragraf'
   
   # 3. дописать блок (слой патчей — массив; блок вставляется отдельной строкой "- insert:")
   Add-Content -LiteralPath $dst -Value (Get-Content -LiteralPath $src -Raw) -Encoding utf8NoBOM

   Prüfen, dass der Patch greift — ohne die App zu starten:

   Prüfung über dsh --dump-configKopieren

   $dsh = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
   & $dsh --profile headless --patch $src --dump-config | Select-String 'serverName: ragraf' -Context 1,3

   Das Profil desktop ist das Arbeitsprofil der App; headless dient Einmalaufgaben von der Kommandozeile. Für ein anderes Profil wird der Block auf dieselbe Weise in dessen cordis.patch.yml gelegt.

2. 2Skill installierenDas Skill-Stammverzeichnis %USERPROFILE%\.dsh\skills liest der Provider @deepseek-ai/dsh-skill-filesystem: Auf der obersten Ebene sucht er <name>/SKILL.md. Ein Skill in diesem Verzeichnis wird ohne Neustart entdeckt — der Provider überwacht das Verzeichnis.
   Installation des Skills ragraf-coreKopieren

   $skills = Join-Path ([Environment]::GetFolderPath('UserProfile')) '.dsh\skills\ragraf-core'
   New-Item -ItemType Directory -Path $skills -Force | Out-Null
   Copy-Item (Join-Path $repo 'harness\skills\ragraf-core\SKILL.md') "$skills\SKILL.md" -Force

3. 3Regel zu den globalen Anweisungen hinzufügenHARNESS liest %USERPROFILE%\.dsh\AGENTS.md (Modul dsh-agent-instructions; dshHome = $DSH_HOME oder ~/.dsh). Der einzufügende Abschnitt ist harness/agents-section.md; er wird vor dem Abschnitt „Änderungsprotokoll" platziert, sonst landet die Regel nach der Historie (in der verifizierten Installation ist es Abschnitt 6). Erwartetes Verhalten: Auf die Frage „Womit beginnt eine Code-Aufgabe?" antwortet der Agent mit mcp__ragraf__ensure und verweist auf diesen Abschnitt.

Verifikation — vier Stufen

Von eng nach breit: der Server allein → ein Live-Start in der App → der Skill → der Projekt-Checker. Jede Stufe ist ein Befehl und eine erwartete Ausgabe, gemessen in der Live-Sitzung.

cd $repo
Remove-Item Env:\PYTHONUTF8, Env:\PYTHONIOENCODING -ErrorAction SilentlyContinue
python tests\test_mcp_compat.py

ИТОГ: пройдено 13, провалено 0

& $dsh --profile headless --patch $src --json `
  "Вызови mcp__ragraf__index_status и приведи первую строку ответа"

{"type":"tool_call","tool":"mcp__ragraf__ragraf_index_status","input":{}}
{"type":"tool_result","status":"completed","result":"op=index_status rev=rev-0043 capability=full ..."}

& $dsh --profile headless --patch $src "Загрузи навык ragraf-core и назови первый шаг"

{"type":"tool_call","tool":"skill","input":{"name":"ragraf-core"}}

pwsh -NoLogo -NoProfile -NonInteractive -File tools\Invoke-ProjectDoctrine.ps1

checks: 16, errors: 0, warnings: 0, Result: PASS
[PASS] MCP server survives a scrubbed client environment
[PASS] operations outside the facade are recorded

Drei Einschränkungen, die man kennen sollte

Get-CimInstance Win32_Process -Filter "Name='java.exe'" |
  Select-Object ProcessId, @{n='MB';e={[int]($_.WorkingSetSize/1MB)}}
Get-NetTCPConnection -LocalPort 9500 -ErrorAction SilentlyContinue

# висящий сервер снимается вместе с родительским процессом:
taskkill /PID <PID родительского cmd.exe> /T /F

Rollback

HARNESS: Patch-Ebene und AGENTS.md aus den Backups wiederherstellen (deren Namen die Installation ausgegeben hat), das Skill-Verzeichnis ragraf-core entfernen.

$home2 = [Environment]::GetFolderPath('UserProfile')
# 1. вернуть слой патчей из бэкапа (имя печатала установка)
Copy-Item "$home2\.dsh\profiles\desktop\cordis.patch.yml.bak-<метка>" `
          "$home2\.dsh\profiles\desktop\cordis.patch.yml" -Force
# 2. вернуть глобальные правила
Copy-Item "$home2\.dsh\AGENTS.md.bak-<метка>" "$home2\.dsh\AGENTS.md" -Force
# 3. убрать навык
Remove-Item "$home2\.dsh\skills\ragraf-core" -Recurse -Force

RAGRAF: Die Änderungen sind additiv — sie berühren weder Index, Speicherschema, Revisionsnummerierung noch Registry, daher erfordert ein Rollback keine Neuindizierung. Für das frühere Verhalten genügen drei Änderungen: den Aufruf von force_utf8_stdio() entfernen, required=True bei --project wiederherstellen und das Tool ragraf_use_project aus TOOLS und _handlers löschen.

HARNESS-Verhalten: Was liegt wo

Das Home-Verzeichnis steuern die Variablen DSH_HOME (expliziter Pfad gewinnt) und DSH_AGENTS_HOME (gemeinsames Agent-Skill-Verzeichnis, Standard ~/.agents). HARNESS entfernt beide aus Kindprozess-Umgebungen — auf den Start des MCP-Servers wirkt sich das nicht aus: Er liest nur --project und das Arbeitsverzeichnis.

Auflösungsreihenfolge der Skill-Wurzeln (Rang): <projekt>/.dsh/skills (100), <projekt>/.agents/skills (200), benutzerdefinierte customSkillDirs (300), ~/.dsh/skills (400), ~/.agents/skills (500). Die Projektwurzel ist das nächste Verzeichnis mit .git.

HARNESS wird in einem privaten Repository entwickelt (github.com/deepseek-ai/deepseek-harness); eine öffentliche API-Prüfung fand nicht statt. Der Vertrag oben ist aus den Fakten der aktuellen Installation beschrieben — lib/index.js und READMEs der Pakete in app.asar — nicht aus der Dokumentation.