Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

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.md
index 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-rc1
This 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-rc2
Converts 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.md
index 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.go
index 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.go
index 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.go
index 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"`