RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
Go agent-harnessagent-native-databaseagentic-aiagentic-retrievalagentic-searchaiai-agentscontext-enginecontext-engineeringcontext-managementharness-engineeringknowledge-compilationragretrieval-augmented-generationretrieval-harnesssearch-harness
Fix: set tag to v1.0.0-rc2 (#21061)
Lynn7d6860dde0c1
diff --git a/docs/administrator/migration/database_change_log.md b/docs/administrator/migration/database_change_log.mdindex 8f2b169b28..f0fe58a993 100644--- a/docs/administrator/migration/database_change_log.md+++ b/docs/administrator/migration/database_change_log.md@@ -16,7 +16,7 @@ A version-by-version record of the schema and data changes the Go backend applie- The marker is a row in `system_settings` with the key `mysql_migration.database.version`.- The marker prevents a migration step from running again after that step has completed successfully.-- Go defines the versions as constants: `modelMigrationBaseVersion` and `modelMigrationTargetVersion` in [migration_version.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/migration_version.go), `conversationHistoryTargetVersion` in [conversation_history_migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/conversation_history_migration.go), `knowledgebaseParserConfigTargetVersion` in [migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/migration.go), and `ingestionParserConfigTargetVersion` in [ingestion_parser_config_migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/ingestion_parser_config_migration.go). The two parser-config constants share `v1.0.0-rc2.dev1`.+- Go defines the versions as constants: `modelMigrationBaseVersion` and `modelMigrationTargetVersion` in [migration_version.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/migration_version.go), `conversationHistoryTargetVersion` in [conversation_history_migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/conversation_history_migration.go), `knowledgebaseParserConfigTargetVersion` in [migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/migration.go), and `ingestionParserConfigTargetVersion` in [ingestion_parser_config_migration.go](https://github.com/infiniflow/ragflow/blob/main/internal/dao/ingestion_parser_config_migration.go). The two parser-config constants share `v1.0.0-rc2`.- A step runs when the stored version is lower than the step's version. Versions are compared with Python PEP 440 semantics, where a `dev` prerelease sorts *before* the release it precedes (`v1.0.0-rc1.dev1` < `v1.0.0-rc1`). A missing or unparsable marker never skips a step.- `checkDatabaseVersion` in [cmd/ragflow_server.go](https://github.com/infiniflow/ragflow/blob/main/cmd/ragflow_server.go) refuses to start when the code version is older than the stored database version, so a database migrated by a newer release cannot be opened by an older one.@@ -34,8 +34,8 @@ Startup order in `InitDB` ([database.go](https://github.com/infiniflow/ragflow/b|-------------------|--------------------------------------------------------------------------------------------------------------|------------------------------------|| `v0.26.0` | Rebuild the tenant model tables from `tenant_llm` and normalize stored model ids | `modelMigrationBaseVersion` || `v1.0.0-rc1` | Seed factory-declared models, merge `model_type` into an integer bitmask, populate the `tenant_*_id` columns | `modelMigrationTargetVersion` |-| `v1.0.0-rc1.dev1` | Split conversation message and reference payloads into child tables | `conversationHistoryTargetVersion` |-| `v1.0.0-rc2.dev1` | Convert Python ingestion settings in dataset/document `parser_config` onto pipeline components, then remove retired dataset `raptor` / `graphrag` sections | `ingestionParserConfigTargetVersion` / `knowledgebaseParserConfigTargetVersion` |+| `v1.0.0-rc1` | Split conversation message and reference payloads into child tables | `conversationHistoryTargetVersion` |+| `v1.0.0-rc2` | Convert Python ingestion settings in dataset/document `parser_config` onto pipeline components, then remove retired dataset `raptor` / `graphrag` sections | `ingestionParserConfigTargetVersion` / `knowledgebaseParserConfigTargetVersion` |The two tenant model steps are cumulative: a database at `v0.26.0` still runs the `v1.0.0-rc1` step, and a database at or above `v1.0.0-rc1` runs neither.@@ -93,7 +93,7 @@ On success the step writes `v0.27.2` into the version marker.----## v1.0.0-rc1.dev1+## v1.0.0-rc1This step only prepares the schema owned by `v1.0.0-rc1`; dropping the legacy payload columns is out of its scope.@@ -120,11 +120,11 @@ Execution details:- A conversation that already has rows in either child table is left untouched: rows written after the split took effect win over the payload, so a rerun neither duplicates nor clobbers them.- Parent tables without `message` and `reference` columns are skipped.-On success the step writes `v1.0.0-rc1.dev1` into the version marker.+On success the step writes `v1.0.0-rc1` into the version marker.----## v1.0.0-rc2.dev1+## v1.0.0-rc2Converts saved Python v0.27.2 ingestion settings into the component-scoped configuration consumed by Go. After conversion, the existing dataset cleanup removes the retired `raptor` and `graphrag` sections.@@ -145,7 +145,7 @@ Execution details:- SQL `NULL`, empty strings and JSON `null` are left untouched. Invalid JSON, unsupported metadata schemas and unsupported engine selections stop migration with table/row context. A failed batch rolls back; earlier committed batches can be rerun safely. See [Parser-config conversion failures](./upgrade_from_v1_to_later_releases.md#parser-config-conversion-failures) for recovery instructions.- The marker advances only after both table conversions and the existing dataset cleanup succeed. If neither table exists, the marker is left unchanged.-On success the migration records `v1.0.0-rc2.dev1`. Databases already marked `v1.0.0-rc2.dev1` or later skip conversion. This includes databases marked by the earlier cleanup-only implementation: that marker does not prove their ingestion settings were converted.+On success the migration records `v1.0.0-rc2`. Databases already marked `v1.0.0-rc2` or later skip conversion. This includes databases marked by the earlier cleanup-only implementation: that marker does not prove their ingestion settings were converted.---diff --git a/docs/administrator/migration/upgrade_from_v1_to_later_releases.md b/docs/administrator/migration/upgrade_from_v1_to_later_releases.mdindex 7ed02122b0..c135e0793c 100644--- a/docs/administrator/migration/upgrade_from_v1_to_later_releases.md+++ b/docs/administrator/migration/upgrade_from_v1_to_later_releases.md@@ -57,7 +57,7 @@ If the logs report a migration failure, stop the deployment and preserve the log#### Parser-config conversion failures-The `v1.0.0-rc2.dev1` step converts saved Python v0.27.2 ingestion settings for Parser, Chunker, Tokenizer, and Extractor together before the existing dataset `raptor` and `graphrag` cleanup records the shared version. Invalid JSON, metadata schemas that Go cannot represent, and unsupported PDF engine or OCR model-reference choices stop `--migrate` and block application startup. The error identifies the table, row ID, and rejected setting.+The `v1.0.0-rc2` step converts saved Python v0.27.2 ingestion settings for Parser, Chunker, Tokenizer, and Extractor together before the existing dataset `raptor` and `graphrag` cleanup records the shared version. Invalid JSON, metadata schemas that Go cannot represent, and unsupported PDF engine or OCR model-reference choices stop `--migrate` and block application startup. The error identifies the table, row ID, and rejected setting.Keep all writers stopped. Back up the affected row's original `parser_config`, then correct the reported value in that row. For an unsupported engine or OCR model reference, explicitly choose and configure an engine that Go can run; deleting the setting would select the template's default engine instead. Start the target deployment again to rerun `--migrate`, and review its logs before resuming writes.diff --git a/internal/dao/ingestion_parser_config_migration_test.go b/internal/dao/ingestion_parser_config_migration_test.goindex e0f99cffcc..fa331c72e9 100644--- a/internal/dao/ingestion_parser_config_migration_test.go+++ b/internal/dao/ingestion_parser_config_migration_test.go@@ -263,7 +263,7 @@ func TestMigrateIngestionParserConfigsVersionAndEmptyRows(t *testing.T) {skip bool}{{"", false}, {"v0.27.2", false}, {"v1.0.0-rc1", false},- {"v1.0.0-rc2.dev2", true},+ {"v1.0.0-rc2.dev2", false},{ingestionParserConfigTargetVersion, true}, {"v1.0.0", true},} {t.Run(tc.version, func(t *testing.T) {@@ -411,9 +411,12 @@ func TestMigrateExtractorConfig(t *testing.T) {func ptrString(value string) *string { return &value }-func TestMigrateIngestionParserConfigsSharesDev1Cleanup(t *testing.T) {- if ingestionParserConfigTargetVersion != "v1.0.0-rc2.dev1" {- t.Fatalf("migration version = %s", ingestionParserConfigTargetVersion)+// The cleanup step runs only after the component conversion succeeds, and both+// record the same version marker.+func TestMigrateIngestionParserConfigsSharesCleanupVersion(t *testing.T) {+ if ingestionParserConfigTargetVersion != knowledgebaseParserConfigTargetVersion {+ t.Fatalf("ingestion version %s does not match cleanup version %s",+ ingestionParserConfigTargetVersion, knowledgebaseParserConfigTargetVersion)}db := openIngestionMigrationDB(t)insertIngestionConfig(t, db, "knowledgebase", "kb", "general", `{"raptor":{},"auto_keywords":8}`)diff --git a/internal/dao/migration.go b/internal/dao/migration.goindex 1aa4c9bea3..214830559e 100644--- a/internal/dao/migration.go+++ b/internal/dao/migration.go@@ -499,10 +499,10 @@ func migrateUserCanvasTitleUnique(ctx context.Context, db *gorm.DB) error {// system_settings under mysql_migration.database.version, the marker shared with// the other versioned steps, so work already performed by a previous run is// skipped.-const knowledgebaseParserConfigTargetVersion = "v1.0.0-rc2.dev1"+const knowledgebaseParserConfigTargetVersion = "v1.0.0-rc2"// removedParserConfigKeys are the top level knowledgebase parser config keys the-// v1.0.0-rc2.dev1 step deletes. raptor and graphrag moved out of the dataset+// v1.0.0-rc2 step deletes. raptor and graphrag moved out of the dataset// parser config, so the stored sections are dead data.var removedParserConfigKeys = []string{"raptor", "graphrag"}diff --git a/internal/dao/tenant_model_max_tokens_migration.go b/internal/dao/tenant_model_max_tokens_migration.goindex 508ab335f7..6896cd6000 100644--- a/internal/dao/tenant_model_max_tokens_migration.go+++ b/internal/dao/tenant_model_max_tokens_migration.go@@ -31,7 +31,7 @@ import ("gorm.io/gorm")-const tenantModelMaxTokensTargetVersion = "v1.0.0-rc2.dev1"+const tenantModelMaxTokensTargetVersion = "v1.0.0-rc2"type tenantModelMaxTokensTarget struct {ID string `gorm:"column:id"`