Dify 1.17.1 vyžaduje u Weaviate postup přes dvanáct menších verzí

Dify vydalo 10. září 2026 verzi 1.17.1. U nových funkcí a oprav stojí hned nahoře varování pro správce vlastních instalací: přibalená vektorová databáze Weaviate se mění z verze 1.27.0 na 1.39.2 a existující datový svazek nesmí tento rozdíl přeskočit najednou.

Dify je platforma pro stavbu aplikací nad jazykovými modely. Weaviate v její výchozí sestavě ukládá číselné vektory dokumentů, podle kterých znalostní báze vyhledává pasáže pro odpověď modelu. Porucha tohoto indexu proto nemusí smazat dokumenty ani shodit server. Stačí, když se část vektorů přestane objevovat ve výsledcích.

Přímý restart je u starého datového svazku chybný postup

Změnu provedl návrh číslo 38214, sloučený 9. září. Tři soubory pro Docker Compose přepíná z obrazu semitechnologies/weaviate:1.27.0 na cr.weaviate.io/semitechnologies/weaviate:1.39.2. Přesouvá se tedy i registr, ze kterého se obraz stahuje.

Samotný Weaviate dává v oficiálním návodu k aktualizacím dvě obecná doporučení: předem pořídit úplnou zálohu a postupovat vždy po jedné menší verzi, pokaždé na její nejnovější opravné vydání. Dify nepřidává vlastní opatrnost bez opory. Jeho přechod jen převádí toto pravidlo na konkrétní cestu přes dvanáct hranic mezi verzemi 1.27 a 1.39.

Migrační návod Dify začíná opravnou verzí 1.27.27, pokračuje přes 1.28.16, 1.29.11 a další nejnovější opravy každé řady a končí přesně na 1.39.2. Správce tak spustí třináct novějších obrazů. Po každém musí Weaviate korektně zastavit a ověřit, než přejde k dalšímu.

Odpověď ze stavového rozhraní ještě nedokládá funkční index

Návod nebere jako důkaz pouhé spuštění kontejneru. Uvádí čtyři kontroly: správnou verzi serveru, nezměněný počet objektů, shodu uložených vektorů a skutečný dotaz na vektorové hledání. Teprve poslední z nich měří, kvůli čemu Dify Weaviate používá.

Rozdíl je vidět na zkoušce, kterou popisuje Dify. Po tvrdém ukončení Weaviate 1.39.2 zůstalo v kolekci všech 700 objektů a fungoval jejich výpis, vyhledávání BM25 i načtení podle identifikátoru. Dotaz near_vector však dosáhl jen na 680 z nich. Server podle návodu nezapsal chybu a stav se po dalším restartu sám nespravil. Jde o jedno měření projektu, nikoli o záruku, že každé tvrdé ukončení ztratí stejných dvacet výsledků. Dokládá ale, proč počet řádků nestačí.

Tvrdým ukončením návod myslí například docker kill, vynucené odstranění kontejneru, zásah po vypršení krátké lhůty pro zastavení nebo ukončení kvůli nedostatku paměti. Pro každý krok proto předepisuje zastavení bez časového limitu. Před prvním z nich mají zůstat vypnuté služby Dify, které by jinak do databáze dál zapisovaly.

Po startu se databáze hlásí dřív než její kolekce

Druhá past vypadá opačně: zdravý index se může několik sekund tvářit jako prázdný. Podle měření v návodu odpovídalo rozhraní /v1/meta zhruba dvě sekundy po startu. Od verze 1.31 se však kolekce připojily o čtyři až devět sekund později. Dotaz na objekty v této mezeře vracel 404 a GraphQL hlásil, že schéma není přítomné.

Proto se po každém restartu čeká na dotaz do skutečné kolekce, ne na samotné /v1/meta. Teprve potom se kontrolují počty a vektory. Stejný test Dify žádá i po dokončení celé cesty: načíst úryvky ze znalostní báze. Právě tento krok odliší přeživší data od funkčního vyhledávacího grafu.

Postup se týká jen jedné skupiny instalací

Třináct kroků nepotřebuje čerstvá instalace Dify 1.17.1, protože začíná rovnou s prázdným svazkem na Weaviate 1.39.2. Netýká se ani provozovatelů s externím Weaviate nebo s jiným vektorovým úložištěm. Rozhodující je starý existující svazek výchozího Weaviate, ne samotné číslo verze Dify.

Vedle svazku Weaviate má správce zálohovat i databázi Dify. Vydání obsahuje migraci starých názvů typů modelů, jejíž návratová funkce je úmyslně prázdná: nové řádky už nelze spolehlivě rozeznat od přepsaných. Návrat k předchozí verzi proto není prosté přepsání značky obrazu.

Verze 1.17.1 také opravuje chyby při načítání CSV, tabulek z Notionu, starých souborů XLS a webových stránek do znalostních bází. Dify výslovně upozorňuje, že dříve vytvořený index samo neopraví; dotčené dokumenty se musí po aktualizaci načíst znovu. Úspěšný přechod databáze tedy zachová starý obsah takový, jaký v ní byl, včetně chyb vzniklých při někdejším zpracování.

Zdroje

• Dify 1.17.1 – datum vydání, změna obrazu, databázové migrace a opravy načítání dokumentů
• Migrační návod Dify – jednotlivé verze, způsob ověření a výsledky zkoušek po restartu
• Oficiální návod Weaviate – záloha a postup po jedné menší verzi
• Návrh změny #38214 – přesný rozsah úpravy a ověření přechodové cesty
• Weaviate 1.39.2 – cílové opravné vydání z 26. srpna 2026