You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hugegraph.apache.org by gi...@apache.org on 2026/10/23 04:35:33 UTC

(hugegraph-doc) branch asf-site updated: Deploy production site from run 39846439611 attempt 1 efa1d042316e3f18caef4a642a685f38d2ec596f

This is an automated email from the ASF dual-hosted git repository.

github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hugegraph-doc.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 00ee453b7 Deploy production site from run 39846439611 attempt 1 efa1d042316e3f18caef4a642a685f38d2ec596f
00ee453b7 is described below

commit 00ee453b7c3f3f7e64b6d0c341034e4a2d2d4105
Author: imbajin <im...@users.noreply.github.com>
AuthorDate: Fri Oct 23 04:35:25 2026 +0000

    Deploy production site from run 39846439611 attempt 1 efa1d042316e3f18caef4a642a685f38d2ec596f
---
 .version.json                                      |    2 +-
 404.html                                           |    2 +-
 _print/docs/clients/index.html                     |   52 +-
 _print/docs/config/index.html                      |   98 +-
 _print/docs/guides/index.html                      |   76 +-
 _print/docs/index.html                             |  660 ++++++---
 _print/docs/quickstart/client/index.html           |   21 +-
 _print/docs/quickstart/hugegraph-ai/index.html     |   72 +-
 _print/docs/quickstart/hugegraph/index.html        |    7 +-
 _print/docs/quickstart/index.html                  |  434 ++++--
 _print/docs/quickstart/toolchain/index.html        |  334 +++--
 .../quickstart/toolchain/visualization/index.html  |   20 +-
 about/index.html                                   |    2 +-
 .../toplingdb-yaml-configuration-file/index.html   |    2 +-
 blog/2025/10/09/toplingdb-quick-start/index.html   |    2 +-
 blog/2025/10/29/agentic-graphrag/index.html        |    2 +-
 blog/computing/index.html                          |    2 +-
 blog/hugegraph-ai/index.html                       |    2 +-
 blog/hugegraph/index.html                          |    2 +-
 blog/hugegraph/toplingdb/index.html                |    2 +-
 blog/index.html                                    |    2 +-
 blog/toolchain/index.html                          |    2 +-
 build-metadata/versions.json                       |    2 +-
 categories/graph-ai/index.html                     |    2 +-
 categories/index.html                              |    2 +-
 categories/storage/index.html                      |    2 +-
 cn/404.html                                        |    2 +-
 cn/_print/docs/clients/index.html                  |   56 +-
 cn/_print/docs/config/index.html                   |   71 +-
 cn/_print/docs/guides/index.html                   |   51 +-
 cn/_print/docs/index.html                          |  619 ++++----
 cn/_print/docs/quickstart/client/index.html        |   20 +-
 cn/_print/docs/quickstart/hugegraph-ai/index.html  |   66 +-
 cn/_print/docs/quickstart/hugegraph/index.html     |    7 +-
 cn/_print/docs/quickstart/index.html               |  441 +++---
 cn/_print/docs/quickstart/toolchain/index.html     |  348 +++--
 .../quickstart/toolchain/visualization/index.html  |   34 +-
 cn/about/index.html                                |    2 +-
 .../toplingdb-yaml-configuration-file/index.html   |    2 +-
 .../2025/10/09/toplingdb-quick-start/index.html    |    2 +-
 cn/blog/2025/10/29/agentic-graphrag/index.html     |    2 +-
 cn/blog/computing/index.html                       |    2 +-
 cn/blog/hugegraph-ai/index.html                    |    2 +-
 cn/blog/hugegraph/index.html                       |    2 +-
 cn/blog/hugegraph/toplingdb/index.html             |    2 +-
 cn/blog/index.html                                 |    2 +-
 cn/blog/toolchain/index.html                       |    2 +-
 cn/categories/graph-ai/index.html                  |    2 +-
 cn/categories/index.html                           |    4 +-
 cn/categories/storage/index.html                   |    2 +-
 cn/community/documentation/index.html              |    4 +-
 cn/community/index.html                            |    2 +-
 .../hugegraph-0.12.0-release-notes/index.html      |    4 +-
 .../hugegraph-1.0.0-release-notes/index.html       |    4 +-
 .../hugegraph-1.2.0-release-notes/index.html       |    4 +-
 .../hugegraph-1.3.0-release-notes/index.html       |    4 +-
 .../hugegraph-1.5.0-release-notes/index.html       |    4 +-
 .../hugegraph-1.7.0-release-notes/index.html       |    4 +-
 cn/docs/changelog/index.html                       |    4 +-
 cn/docs/cla/index.html                             |    4 +-
 cn/docs/clients/gremlin-console/index.html         |   89 +-
 cn/docs/clients/gremlin-console/index.md           |  125 +-
 cn/docs/clients/hugegraph-client/index.html        |    4 +-
 cn/docs/clients/index.html                         |    4 +-
 cn/docs/clients/index.xml                          |    2 +-
 cn/docs/clients/restful-api/auth/index.html        |    4 +-
 cn/docs/clients/restful-api/cypher/index.html      |    4 +-
 cn/docs/clients/restful-api/edge/index.html        |    4 +-
 cn/docs/clients/restful-api/edgelabel/index.html   |    4 +-
 cn/docs/clients/restful-api/graphs/index.html      |    4 +-
 cn/docs/clients/restful-api/graphspace/index.html  |    4 +-
 cn/docs/clients/restful-api/gremlin/index.html     |    4 +-
 cn/docs/clients/restful-api/index.html             |    4 +-
 cn/docs/clients/restful-api/indexlabel/index.html  |    4 +-
 cn/docs/clients/restful-api/metrics/index.html     |    4 +-
 cn/docs/clients/restful-api/other/index.html       |    4 +-
 cn/docs/clients/restful-api/propertykey/index.html |    4 +-
 cn/docs/clients/restful-api/rank/index.html        |    4 +-
 cn/docs/clients/restful-api/rebuild/index.html     |    4 +-
 cn/docs/clients/restful-api/schema/index.html      |    7 +-
 cn/docs/clients/restful-api/schema/index.md        |    6 +
 cn/docs/clients/restful-api/task/index.html        |    4 +-
 cn/docs/clients/restful-api/traverser/index.html   |    4 +-
 cn/docs/clients/restful-api/variable/index.html    |    4 +-
 cn/docs/clients/restful-api/vertex/index.html      |    4 +-
 cn/docs/clients/restful-api/vertexlabel/index.html |    4 +-
 cn/docs/config/config-authentication/index.html    |   99 +-
 cn/docs/config/config-authentication/index.md      |  176 ++-
 cn/docs/config/config-backend-hbase/index.html     |    4 +-
 cn/docs/config/config-backend-hstore/index.html    |    4 +-
 cn/docs/config/config-backend-rocksdb/index.html   |    4 +-
 cn/docs/config/config-guide/index.html             |    4 +-
 cn/docs/config/config-https/index.html             |    6 +-
 cn/docs/config/config-option/index.html            |    4 +-
 cn/docs/config/index.html                          |    4 +-
 cn/docs/config/index.xml                           |    2 +-
 .../committer-guidelines/index.html                |    4 +-
 .../contribution-guidelines/contribute/index.html  |    4 +-
 .../hugegraph-server-idea-setup/index.html         |    4 +-
 cn/docs/contribution-guidelines/index.html         |    4 +-
 .../contribution-guidelines/subscribe/index.html   |    4 +-
 .../validate-release/index.html                    |    4 +-
 cn/docs/download/download/index.html               |    4 +-
 cn/docs/download/download/index.md                 |    1 +
 cn/docs/guides/architectural/index.html            |    4 +-
 cn/docs/guides/backup-restore/index.html           |   64 +-
 cn/docs/guides/backup-restore/index.md             |  132 +-
 cn/docs/guides/custom-plugin/index.html            |    4 +-
 cn/docs/guides/desgin-concept/index.html           |    4 +-
 cn/docs/guides/faq/index.html                      |  187 +--
 cn/docs/guides/faq/index.md                        |  161 ++-
 cn/docs/guides/hugegraph-docker-cluster/index.html |    4 +-
 cn/docs/guides/index.html                          |    4 +-
 cn/docs/guides/index.md                            |    2 +-
 cn/docs/guides/index.xml                           |    2 +-
 cn/docs/guides/security/index.html                 |    6 +-
 .../guides/shared-foundation-migration/index.html  |    4 +-
 cn/docs/guides/toolchain-local-test/index.html     |    4 +-
 cn/docs/guides/toplingdb/index.html                |    4 +-
 cn/docs/images/hubble/accounts.jpg                 |  Bin 63367 -> 68027 bytes
 cn/docs/images/hubble/algorithms.jpg               |  Bin 84352 -> 144160 bytes
 cn/docs/images/hubble/cluster-overview.jpg         |  Bin 84825 -> 111034 bytes
 cn/docs/images/hubble/graphspace.jpg               |  Bin 79781 -> 85243 bytes
 cn/docs/images/hubble/members.jpg                  |  Bin 70762 -> 69987 bytes
 cn/docs/images/hubble/overview.jpg                 |  Bin 59303 -> 69323 bytes
 cn/docs/images/hubble/query.jpg                    |  Bin 106837 -> 154098 bytes
 cn/docs/images/hubble/schema.jpg                   |  Bin 64805 -> 84496 bytes
 cn/docs/images/hubble/store-node.jpg               |  Bin 122202 -> 140330 bytes
 cn/docs/images/hubble/text2gql-prompt.jpg          |  Bin 123380 -> 140108 bytes
 cn/docs/images/hubble/text2gql-settings.jpg        |  Bin 66032 -> 87124 bytes
 cn/docs/images/hubble/text2gql.jpg                 |  Bin 92737 -> 158786 bytes
 cn/docs/index.html                                 |    4 +-
 cn/docs/introduction/index.html                    |    4 +-
 cn/docs/language/hugegraph-example/index.html      |    4 +-
 cn/docs/language/hugegraph-gremlin/index.html      |    4 +-
 cn/docs/language/index.html                        |    4 +-
 cn/docs/llms-full.txt                              | 1448 ++++++++++++-------
 .../hugegraph-api-0.5.6-cassandra/index.html       |    4 +-
 .../hugegraph-api-0.5.6-rocksdb/index.html         |    4 +-
 cn/docs/performance/api-performance/index.html     |    4 +-
 .../hugegraph-benchmark-0.4.4/index.html           |    4 +-
 .../hugegraph-benchmark-0.5.6/index.html           |    4 +-
 .../hugegraph-loader-performance/index.html        |    4 +-
 cn/docs/performance/index.html                     |    4 +-
 .../client/hugegraph-client-go/index.html          |    4 +-
 .../client/hugegraph-client-python/index.html      |    4 +-
 .../quickstart/client/hugegraph-client/index.html  |   43 +-
 .../quickstart/client/hugegraph-client/index.md    |   62 +-
 cn/docs/quickstart/client/index.html               |    4 +-
 cn/docs/quickstart/client/index.xml                |    2 +-
 .../computing/hugegraph-computer-config/index.html |    4 +-
 .../computing/hugegraph-computer/index.html        |    4 +-
 .../computing/hugegraph-vermeer/index.html         |    4 +-
 cn/docs/quickstart/computing/index.html            |    4 +-
 .../hugegraph-ai/config-reference/index.html       |    4 +-
 .../hugegraph-ai/hugegraph-llm/index.html          |    4 +-
 .../hugegraph-ai/hugegraph-ml/index.html           |    4 +-
 cn/docs/quickstart/hugegraph-ai/index.html         |    4 +-
 cn/docs/quickstart/hugegraph-ai/index.xml          |    2 +-
 .../quickstart/hugegraph-ai/quick_start/index.html |   86 +-
 .../quickstart/hugegraph-ai/quick_start/index.md   |  205 ++-
 .../quickstart/hugegraph-ai/rest-api/index.html    |    4 +-
 .../hugegraph-ai/vermeer-python-client/index.html  |    4 +-
 .../hugegraph/hugegraph-helm-operations/index.html |    4 +-
 .../quickstart/hugegraph/hugegraph-helm/index.html |    4 +-
 .../hugegraph/hugegraph-hstore/index.html          |    4 +-
 .../quickstart/hugegraph/hugegraph-pd/index.html   |   10 +-
 cn/docs/quickstart/hugegraph/hugegraph-pd/index.md |    2 +-
 .../hugegraph/hugegraph-server/index.html          |   13 +-
 .../quickstart/hugegraph/hugegraph-server/index.md |    5 +-
 cn/docs/quickstart/hugegraph/index.html            |    4 +-
 cn/docs/quickstart/hugegraph/index.xml             |    2 +-
 cn/docs/quickstart/index.html                      |    4 +-
 .../hugegraph-seatunnel-source/index.html          |    4 +-
 .../toolchain/export-migration/index.html          |    4 +-
 .../toolchain/hugegraph-hubble/index.html          |   82 +-
 .../quickstart/toolchain/hugegraph-hubble/index.md |  159 ++-
 .../toolchain/hugegraph-loader/index.html          |  301 ++--
 .../quickstart/toolchain/hugegraph-loader/index.md |  273 ++--
 .../toolchain/hugegraph-spark-connector/index.html |    4 +-
 .../toolchain/hugegraph-tools/index.html           |   98 +-
 .../quickstart/toolchain/hugegraph-tools/index.md  |  103 +-
 .../hugegraph-seatunnel-connector/index.html       |    4 +-
 cn/docs/quickstart/toolchain/import/index.html     |    4 +-
 cn/docs/quickstart/toolchain/index.html            |    4 +-
 cn/docs/quickstart/toolchain/index.xml             |    2 +-
 .../hugegraph-hubble-hstore/index.html             |   58 +-
 .../visualization/hugegraph-hubble-hstore/index.md |   38 +-
 .../quickstart/toolchain/visualization/index.html  |    4 +-
 .../quickstart/toolchain/visualization/index.xml   |    2 +-
 cn/index.html                                      |    4 +-
 cn/index.xml                                       |    2 +-
 cn/series/index.html                               |    4 +-
 cn/series/toplingdb/index.html                     |    2 +-
 cn/sitemap.xml                                     |    2 +-
 cn/tags/graphrag/index.html                        |    2 +-
 cn/tags/index.html                                 |    4 +-
 cn/tags/rag/index.html                             |    2 +-
 cn/tags/rocksdb/index.html                         |    2 +-
 cn/tags/toplingdb/index.html                       |    2 +-
 cn/tags/workflow/index.html                        |    2 +-
 community/documentation/index.html                 |    2 +-
 community/index.html                               |    2 +-
 .../hugegraph-1.0.0-release-notes/index.html       |    2 +-
 .../hugegraph-1.2.0-release-notes/index.html       |    2 +-
 .../hugegraph-1.3.0-release-notes/index.html       |    2 +-
 .../hugegraph-1.5.0-release-notes/index.html       |    2 +-
 .../hugegraph-1.7.0-release-notes/index.html       |    2 +-
 docs/changelog/index.html                          |    2 +-
 docs/cla/index.html                                |    2 +-
 docs/clients/gremlin-console/index.html            |   73 +-
 docs/clients/gremlin-console/index.md              |  115 +-
 docs/clients/hugegraph-client/index.html           |    2 +-
 docs/clients/index.html                            |    2 +-
 docs/clients/index.xml                             |    2 +-
 docs/clients/restful-api/auth/index.html           |    2 +-
 docs/clients/restful-api/cypher/index.html         |    2 +-
 docs/clients/restful-api/edge/index.html           |    2 +-
 docs/clients/restful-api/edgelabel/index.html      |    2 +-
 docs/clients/restful-api/graphs/index.html         |    2 +-
 docs/clients/restful-api/graphspace/index.html     |    2 +-
 docs/clients/restful-api/gremlin/index.html        |    2 +-
 docs/clients/restful-api/index.html                |    2 +-
 docs/clients/restful-api/indexlabel/index.html     |    2 +-
 docs/clients/restful-api/metrics/index.html        |    2 +-
 docs/clients/restful-api/other/index.html          |    2 +-
 docs/clients/restful-api/propertykey/index.html    |    2 +-
 docs/clients/restful-api/rank/index.html           |    2 +-
 docs/clients/restful-api/rebuild/index.html        |    2 +-
 docs/clients/restful-api/schema/index.html         |    5 +-
 docs/clients/restful-api/schema/index.md           |    6 +
 docs/clients/restful-api/task/index.html           |    2 +-
 docs/clients/restful-api/traverser/index.html      |    2 +-
 docs/clients/restful-api/variable/index.html       |    2 +-
 docs/clients/restful-api/vertex/index.html         |    2 +-
 docs/clients/restful-api/vertexlabel/index.html    |    2 +-
 docs/config/config-authentication/index.html       |  140 +-
 docs/config/config-authentication/index.md         |  213 ++-
 docs/config/config-backend-hbase/index.html        |    2 +-
 docs/config/config-backend-hstore/index.html       |    2 +-
 docs/config/config-backend-rocksdb/index.html      |    2 +-
 docs/config/config-guide/index.html                |    2 +-
 docs/config/config-https/index.html                |    2 +-
 docs/config/config-option/index.html               |    2 +-
 docs/config/index.html                             |    2 +-
 docs/config/index.xml                              |    2 +-
 .../committer-guidelines/index.html                |    2 +-
 docs/contribution-guidelines/contribute/index.html |    2 +-
 .../hugegraph-server-idea-setup/index.html         |    2 +-
 docs/contribution-guidelines/index.html            |    2 +-
 docs/contribution-guidelines/subscribe/index.html  |    2 +-
 .../validate-release/index.html                    |    2 +-
 docs/download/download/index.html                  |    2 +-
 docs/download/download/index.md                    |    1 +
 docs/guides/architectural/index.html               |    2 +-
 docs/guides/backup-restore/index.html              |   81 +-
 docs/guides/backup-restore/index.md                |  141 +-
 docs/guides/custom-plugin/index.html               |    2 +-
 docs/guides/desgin-concept/index.html              |    2 +-
 docs/guides/faq/index.html                         |  209 +--
 docs/guides/faq/index.md                           |  183 ++-
 docs/guides/hugegraph-docker-cluster/index.html    |    2 +-
 docs/guides/index.html                             |    2 +-
 docs/guides/index.xml                              |    2 +-
 docs/guides/security/index.html                    |    2 +-
 docs/guides/shared-foundation-migration/index.html |    2 +-
 docs/guides/toolchain-local-test/index.html        |    2 +-
 docs/guides/toplingdb/index.html                   |    2 +-
 docs/images/hubble/accounts.jpg                    |  Bin 71840 -> 79756 bytes
 docs/images/hubble/algorithms.jpg                  |  Bin 119421 -> 158250 bytes
 docs/images/hubble/cluster-overview.jpg            |  Bin 92475 -> 124290 bytes
 docs/images/hubble/graphspace.jpg                  |  Bin 89518 -> 95893 bytes
 docs/images/hubble/members.jpg                     |  Bin 76509 -> 82913 bytes
 docs/images/hubble/overview.jpg                    |  Bin 60488 -> 79887 bytes
 docs/images/hubble/query.jpg                       |  Bin 105156 -> 159180 bytes
 docs/images/hubble/schema.jpg                      |  Bin 72182 -> 96178 bytes
 docs/images/hubble/store-node.jpg                  |  Bin 135346 -> 163779 bytes
 docs/images/hubble/text2gql-prompt.jpg             |  Bin 144769 -> 154130 bytes
 docs/images/hubble/text2gql-settings.jpg           |  Bin 90475 -> 103656 bytes
 docs/images/hubble/text2gql.jpg                    |  Bin 121774 -> 163160 bytes
 docs/index.html                                    |    2 +-
 docs/introduction/index.html                       |    2 +-
 docs/language/hugegraph-example/index.html         |    2 +-
 docs/language/hugegraph-gremlin/index.html         |    2 +-
 docs/language/index.html                           |    2 +-
 docs/llms-full.txt                                 | 1482 +++++++++++++-------
 .../hugegraph-api-0.5.6-cassandra/index.html       |    2 +-
 .../hugegraph-api-0.5.6-rocksdb/index.html         |    2 +-
 docs/performance/api-performance/index.html        |    2 +-
 .../hugegraph-benchmark-0.4.4/index.html           |    2 +-
 .../hugegraph-benchmark-0.5.6/index.html           |    2 +-
 .../hugegraph-loader-performance/index.html        |    2 +-
 docs/performance/index.html                        |    2 +-
 .../client/hugegraph-client-go/index.html          |    2 +-
 .../client/hugegraph-client-python/index.html      |    2 +-
 docs/quickstart/client/hugegraph-client/index.html |   48 +-
 docs/quickstart/client/hugegraph-client/index.md   |   55 +-
 docs/quickstart/client/index.html                  |    2 +-
 docs/quickstart/client/index.xml                   |    2 +-
 .../computing/hugegraph-computer-config/index.html |    2 +-
 .../computing/hugegraph-computer/index.html        |    2 +-
 .../computing/hugegraph-vermeer/index.html         |    2 +-
 docs/quickstart/computing/index.html               |    2 +-
 .../hugegraph-ai/config-reference/index.html       |    2 +-
 .../hugegraph-ai/hugegraph-llm/index.html          |    2 +-
 .../hugegraph-ai/hugegraph-ml/index.html           |    2 +-
 docs/quickstart/hugegraph-ai/index.html            |    2 +-
 docs/quickstart/hugegraph-ai/index.xml             |    2 +-
 .../quickstart/hugegraph-ai/quick_start/index.html |   94 +-
 docs/quickstart/hugegraph-ai/quick_start/index.md  |  181 ++-
 docs/quickstart/hugegraph-ai/rest-api/index.html   |    2 +-
 .../hugegraph-ai/vermeer-python-client/index.html  |    2 +-
 .../hugegraph/hugegraph-helm-operations/index.html |    2 +-
 .../quickstart/hugegraph/hugegraph-helm/index.html |    2 +-
 .../hugegraph/hugegraph-hstore/index.html          |    2 +-
 docs/quickstart/hugegraph/hugegraph-pd/index.html  |   10 +-
 docs/quickstart/hugegraph/hugegraph-pd/index.md    |    2 +-
 .../hugegraph/hugegraph-server/index.html          |   13 +-
 .../quickstart/hugegraph/hugegraph-server/index.md |    5 +-
 docs/quickstart/hugegraph/index.html               |    2 +-
 docs/quickstart/hugegraph/index.xml                |    2 +-
 docs/quickstart/index.html                         |    2 +-
 .../hugegraph-seatunnel-source/index.html          |    2 +-
 .../toolchain/export-migration/index.html          |    2 +-
 .../toolchain/hugegraph-hubble/index.html          |   47 +-
 .../quickstart/toolchain/hugegraph-hubble/index.md |  122 +-
 .../toolchain/hugegraph-loader/index.html          |  313 +++--
 .../quickstart/toolchain/hugegraph-loader/index.md |  330 +++--
 .../toolchain/hugegraph-spark-connector/index.html |    2 +-
 .../toolchain/hugegraph-tools/index.html           |  105 +-
 docs/quickstart/toolchain/hugegraph-tools/index.md |  114 +-
 .../hugegraph-seatunnel-connector/index.html       |    2 +-
 docs/quickstart/toolchain/import/index.html        |    2 +-
 docs/quickstart/toolchain/index.html               |    2 +-
 docs/quickstart/toolchain/index.xml                |    2 +-
 .../hugegraph-hubble-hstore/index.html             |   42 +-
 .../visualization/hugegraph-hubble-hstore/index.md |   16 +-
 docs/quickstart/toolchain/visualization/index.html |    2 +-
 docs/quickstart/toolchain/visualization/index.xml  |    2 +-
 en/sitemap.xml                                     |    2 +-
 images/docs/hugegraph-ai/cn/graph-tools.jpg        |  Bin 0 -> 51326 bytes
 images/docs/hugegraph-ai/cn/graphrag.jpg           |  Bin 0 -> 82511 bytes
 images/docs/hugegraph-ai/cn/query-prompts.jpg      |  Bin 0 -> 33423 bytes
 images/docs/hugegraph-ai/cn/text2gremlin.jpg       |  Bin 0 -> 158507 bytes
 images/docs/hugegraph-ai/en/graph-tools.jpg        |  Bin 0 -> 51326 bytes
 images/docs/hugegraph-ai/en/graphrag.jpg           |  Bin 0 -> 87564 bytes
 images/docs/hugegraph-ai/en/query-prompts.jpg      |  Bin 0 -> 35120 bytes
 images/docs/hugegraph-ai/en/text2gremlin.jpg       |  Bin 0 -> 162693 bytes
 images/docs/hugegraph-ai/quick-start-03.jpg        |  Bin 18059 -> 0 bytes
 images/docs/hugegraph-ai/quick-start-04.png        |  Bin 164923 -> 0 bytes
 index.html                                         |    4 +-
 index.xml                                          |    2 +-
 ...-index.cn.6fc3b4ef3a2669267719cf8832358a64.json |    1 +
 ...-index.cn.b52b17b98a8ecf085fbba33ab15f3c91.json |    1 -
 ...-index.en.ad2a248032416d0415d89b4b492a8139.json |    1 +
 ...-index.en.eea12fed7dbdd45c7e531a68b6bb6f6c.json |    1 -
 series/index.html                                  |    2 +-
 series/toplingdb/index.html                        |    2 +-
 tags/graphrag/index.html                           |    2 +-
 tags/index.html                                    |    2 +-
 tags/rag/index.html                                |    2 +-
 tags/rocksdb/index.html                            |    2 +-
 tags/toplingdb/index.html                          |    2 +-
 tags/workflow/index.html                           |    2 +-
 364 files changed, 7672 insertions(+), 4692 deletions(-)

diff --git a/.version.json b/.version.json
index 6dd6332f3..eec5b3ff4 100644
--- a/.version.json
+++ b/.version.json
@@ -25,7 +25,7 @@
   "nonEquivalentHreflangRemoved": 0,
   "publishPath": "",
   "ref": "master",
-  "sha": "69d32b05ffb2ccb3383616e02db97533e038a92f",
+  "sha": "efa1d042316e3f18caef4a642a685f38d2ec596f",
   "urlScoping": {
     "files": 316,
     "historicalHomeRedirects": 0,
diff --git a/404.html b/404.html
index 6d5083743..232e9a7f5 100644
--- a/404.html
+++ b/404.html
@@ -32,7 +32,7 @@
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--moon fa-solid fa-moon" aria-hidden=true></i><span>Dark</span>
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-navbar value=auto data-bs-theme-value=auto checked>
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>System</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>Your browser is not saving settings, so this choice lasts only on this page.</p></dialog></div><div class="td-shell-keyboard td-nav-hover-menu" data-td-nav-hover><button type=button class="td-shell-iconbtn td-shell-keyboard__trigger" data-td-nav [...]
-<a class="btn btn-outline-primary" href=https://hugegraph.apache.org/>Go to the home page</a></p></div></main><footer class=d-print-none data-td-shell-footer><div class=hg-asf-footer id=td-site-footer><div class=hg-asf-footer__container><div class=hg-asf-footer__brand><a href=https://www.apache.org/ target=_blank rel="noopener noreferrer" aria-label="The Apache Software Foundation"><img src=https://hugegraph.apache.org/img/apache_logo.svg alt="The Apache Software Foundation" width=300 he [...]
+<a class="btn btn-outline-primary" href=https://hugegraph.apache.org/>Go to the home page</a></p></div></main><footer class=d-print-none data-td-shell-footer><div class=hg-asf-footer id=td-site-footer><div class=hg-asf-footer__container><div class=hg-asf-footer__brand><a href=https://www.apache.org/ target=_blank rel="noopener noreferrer" aria-label="The Apache Software Foundation"><img src=https://hugegraph.apache.org/img/apache_logo.svg alt="The Apache Software Foundation" width=300 he [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/_print/docs/clients/index.html b/_print/docs/clients/index.html
index 4771de3e7..ff4c42878 100644
--- a/_print/docs/clients/index.html
+++ b/_print/docs/clients/index.html
@@ -5444,36 +5444,28 @@ First add the indexed properties below; <code>id</code> is a business property,
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>1</span><span class=o>&gt;&gt;</span><span class=nl>S1:</span><span class=n>vadas</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>knows</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>peter</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>peter</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
-</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>For more Gremlin statements, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-mode>2 Client/Server mode</h3><p>Gremlin Console connects to HugeGraph Server through WebSocket. The default configuration [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># ......</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>channelizer</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># ......</span></span></span></code></pre></div></div></div><p>Confirm that <code>host</code> and <code>port</code> match the settings in <code>remote.yaml</code>, and then follow the <a href=/docs/quickstart/hugegraph/hugegraph-server/>steps</a> to start HugeGraph Server.</p><p>Then enter Gremlin-Console:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-4 data-td-code data-td-cod [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>
-</span></span><span class=line><span class=ln>3</span><span class=cl>         <span class=se>\,</span>,,/
-</span></span><span class=line><span class=ln>4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>-----oOOo-<span class=o>(</span>3<span class=o>)</span>-oOOo-----
-</span></span><span class=line><span class=ln>6</span><span class=cl>plugin activated: HugeGraph
-</span></span><span class=line><span class=ln>7</span><span class=cl>plugin activated: tinkerpop.server
-</span></span><span class=line><span class=ln>8</span><span class=cl>plugin activated: tinkerpop.utilities
-</span></span><span class=line><span class=ln>9</span><span class=cl>plugin activated: tinkerpop.tinkergraph</span></span></code></pre></div></div></div><p>To connect to the server, you need to specify the connection parameters in the configuration file, and there is a default <code>remote.yaml</code> file in the conf directory</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-5 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=10><div class=td- [...]
-</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=p>,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>  </span>}<span class=w>
-</span></span></span><span class=line><span class=ln>10</span><span class=cl>}</span></span></code></pre></div></div></div><p>If the Server runs in auth mode, add the credentials to the same file:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-6 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2><div class=td-code__viewport id=td-code-8087517a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code clas [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=l>pa</span></span></span></code></pre></div></div></div><p>The <code>conf</code> directory also ships <code>remote-objects.yaml</code> and <code>gremlin-driver-settings.yaml</code>, which carry the same host, port, and serializer settings.</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-7 data-td-code data-td [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>==&gt;Configured localhost/</span><span class=mf>127.0</span><span class=o>.</span><span class=mf>0.1</span><span class=o>:</span><span class=mi>8182</span></span></span></code></pre></div></div></div><p>Server-side graphs are bound under a graphspace-qualified name, so the graph <code>hugegraph</code> in graphspace <code>DEFAULT</code> is bound as <code>DEFAULT-hugegraph</code> and its traversal so [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>();</span> <span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div><blockquote><p>NOTE: In Client/Server mode, all operations related to the Server should be prefixed with <code>:> </code>.  [...]
+</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>For more Gremlin statements, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-mode>2 Client/Server mode</h3><p>Gremlin Console connects to HugeGraph Server through WebSocket. Use the Console and <code [...]
+Keep the serializer settings from that file; change only the address and, if authentication is enabled, credentials.
+Older configuration files may reference serializer classes that no longer exist.</p><ol class=steps><li><p>Prepare the connection configuration and start Server.</p><p>Check the <code>host</code> and <code>port</code> in <code>conf/gremlin-server.yaml</code>. The default <code>WsAndHttpChannelizer</code> handles both WebSocket and HTTP requests;
+it does not need to be changed. In <code>conf/remote.yaml</code>, <code>hosts</code> must contain the Server address reachable from the Console,
+and <code>port</code> must match the Gremlin port (default <code>8182</code>, not the REST port <code>8080</code>).
+Start Server following the <a href=/docs/quickstart/hugegraph/hugegraph-server/>quick start</a>.</p><p>The current master configuration uses GraphBinary V1 with HugeGraph&rsquo;s type registry:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-3 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-8087517a-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=l [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div><p>If Server requires authentication, add your actual credentials to the same file:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-4 data-td-code data-td-code-a [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;replace-with-your-password&#34;</span></span></span></code></pre></div></div></div><p>The bundled <code>remote-objects.yaml</code> and <code>gremlin-driver-settings.yaml</code> use the same serializer settings. Keep them aligned if you use them.</p></li><li><p>Start Console from the Server distribution directory and crea [...]
+Because hyphens are invalid in Groovy variable names, use <code>.alias(['g': '__g_DEFAULT-hugegraph'])</code> to map it to <code>g</code> when creating the driver client:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-8087517a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-l [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span></span></span></code></pre></div></div></div></li><li><p>Submit queries through the cli [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span></span></span></code></pre></div></div></div><p>Both return <code>6</code> i [...]
+When submitting scripts via <code>client.submit()</code>, no <code>:></code> prefix is needed.</p></li><li><p>Close the client and cluster when finished.</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-8 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=2><div class=td-code__viewport id=td-code-8087517a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div></li></ol><p>Alternatively, you can connect using Gremlin Console&rsquo;s built-in <code>:remote</code> command:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-9 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-co [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>/</span><span class=o>/</span> <span class=n>Use</span> <span class=o>:&gt;</span> <span class=k>as</span> <span class=n>a</span> <span class=n>prefix</span> <span class=n>when</span> <span class=n>submitting</span> <span class=n>scripts</span> <span class=n>through</span> <span class=n>the</span> <span class=n>Console</span> <span class=n>remote</span> <span class=n>connection</span><span class=o>.</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>close</span></span></span></code></pre></div></div></div><p>When connected with <code>:remote</code>, expressions prefixed with <code>:></code> are sent to the remote Server, while normal expressions execute locally in Console.</p><p>For more information, see the <a href=https://tinkerpop.apache.org/docs/current/reference/#gremlin-console>TinkerPop Gremlin  [...]
 <i class="fa-solid fa-wand-magic-sparkles" aria-hidden=true></i>
 <span>Ask AI</span></button><section class="hg-ai-consent d-print-none" data-hg-ai-consent hidden aria-labelledby=hg-ai-consent-title aria-describedby=hg-ai-disclosure><h2 class=visually-hidden id=hg-ai-consent-title>Ask AI</h2><p id=hg-ai-disclosure>Agree to send your questions to the third-party Kapa service for AI answers based on the documentation.</p><p>Answers use the latest documentation</p><p><a href=https://www.kapa.ai/content/privacy-policy target=_blank rel="noopener noreferre [...]
 <button type=button class="btn btn-primary" data-hg-ai-continue aria-haspopup=dialog aria-describedby=hg-ai-disclosure>Agree and open Ask AI</button></div></section><div class="hg-ai-status visually-hidden" role=status aria-live=polite data-hg-ai-status></div><script src=/js/kapa-adapter.min.c3349abb2aa6680f8807e3d8f687be02149dc18617e87d1936e1c55f1db37d97.js integrity="sha256-wzSauyqmaA+IB+PY9oe+AhSdwYYX6H0ZNuHFXx2zfZc=" crossorigin=anonymous></script></body></html>
\ No newline at end of file
diff --git a/_print/docs/config/index.html b/_print/docs/config/index.html
index 1bc58a1fb..18fd498a4 100644
--- a/_print/docs/config/index.html
+++ b/_print/docs/config/index.html
@@ -89,20 +89,29 @@ see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start t
 <code>raft.mode=true</code>, and <code>raft.group_peers</code> is read from <code>rest-server.properties</code> instead of the graph file.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>config option</th><th scope=col>default value</th><th scope=col>description</th></tr></thead><tbody><tr><td>raft.mode</td><td>false</td><td>Whether the backend storage works in raft mode.</td [...]
 Starting with HugeGraph 1.8.0.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Config option</th><th scope=col>Default value</th><th scope=col>Description</th></tr></thead><tbody><tr><td>arthas.telnet_port</td><td>8562</td><td>Arthas telnet port for administrator activation through <code>PUT /arthas</code>.</td></tr><tr><td>arthas.http_port</td><td>8561</td><td>Arthas HTTP po [...]
 The bundled <code>bin/arthas.sh</code> provides local diagnostics without changing configuration. For activation workflows, permissions, and authentication options,
-see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start the Arthas agent</a>.</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server Config Options</strong></span></div><div class=td-callout__body><p>Corresponding configuration file <code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll--static"  [...]
-which supports multi-user authentication and fine-grained access control. It adopts a 4-layer design based on &ldquo;User-UserGroup-Operation-Resource&rdquo; to
-flexibly control user roles and permissions (supports multiple GraphServers).</p><p>Some key designs of the <code>StandardAuthenticator</code> mode include:</p><ul><li>During initialization, a super administrator (<code>admin</code>) user is created. Subsequently, other users can be created by the super administrator. Once newly created users are assigned sufficient permissions, they can create or manage more users.</li><li>It supports dynamic creation of users, user groups, and resource [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start the Arthas agent</a>.</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server Config Options</strong></span></div><div class=td-callout__body><p>Corresponding configuration file <code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll--static"  [...]
+Users receive read, write, delete, and execute permissions through their groups.</p><p>A resource describes accessible data using <code>type</code>, <code>label</code>, and <code>properties</code>. Conditions within one resource are combined with AND; multiple resources are
+combined with OR.</p><p>This relationship grants a user read access to data for Beijing.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-0 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=ln>1</span><span class=cl><span class=c1>// Scen [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+maintain the Server IP allowlist, and grant minimum permissions. Do not expose Gremlin, Cypher, or other query endpoints directly to the public network.
+Standard Server configuration writes authentication-proxy audit records to <code>audit-*.log</code>; retain these files and restrict read access. <code>auth.audit_log_rate</code>
+limits per-user output rather than serving as a dedicated audit-log on/off switch.</p></div></div><p>Use <code>StandardAuthenticator</code> for built-in access control, or implement <code>HugeAuthenticator</code> to connect an existing identity system.</p><p>HugeGraph uses <a href=https://en.wikipedia.org/wiki/Basic_access_authentication>HTTP Basic Authentication</a>. The value after
 <code>Basic</code> is the Base64 encoding of <code>username:password</code>. With curl, pass the credentials directly through <code>-u</code>:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span  [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>Protect Basic Authentication credenti [...]
-The source-code default generates 32 random bytes encoded as Base64, but does not write the value back to the file. Independently generated defaults cannot remain consistent across restarts or Server nodes. To preserve existing tokens across restarts or validate the same token on multiple nodes, explicitly configure the same strong random secret in each authentication graph configuration.</p><p>Server encodes this string as UTF-8 for JJWT&rsquo;s HS256 signer, which requires at least 32  [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;locally-generated-secret&gt;</span></span></span></code></pre></div></div></div><p>Generate the secret locally and transfer it securely into the authentication graph configuration. Do not commit the actual secret or expose it in public logs:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-3 data-td-code data-td-code-auto-i [...]
-implementation authenticates users based on their names and passwords (encrypted) stored in the database and controls user permissions based on their
-roles. Below is the specific configuration process (requires service restart):</p><p>Configure the <code>authenticator</code> and its <code>rest-server</code> file path in the <code>gremlin-server.yaml</code> configuration file:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=5><div class=td-code__viewport id=td-code-c11d92dd-fence-4-viewport data-td-code-viewport><div class=highlight><pre ta [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>Protect Basic Authentication credenti [...]
+configuration</a>.</p></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>JWT risks in older versions</strong></p><p>HugeGraph-Server versions before 1.5.0 have JWT-related security risks in Auth mode. Upgrade affected versions or change the JWT <code>secretKey</code> according [...]
+version&rsquo;s requirements.</p></div></div><p><code>auth.token_secret</code> is read from the authentication graph&rsquo;s configuration. The default graph is <code>hugegraph</code>, so its file is normally
+<code>conf/graphs/hugegraph.properties</code>; if <code>auth.graph_store</code> changes, use that graph&rsquo;s properties file.
+The core configuration defaults to 32 random bytes encoded as Base64 and does not write that default back to the file. Independently generated defaults cannot
+remain consistent across restarts or Server nodes. To preserve existing tokens across restarts or validate the same token on multiple nodes, explicitly
+configure the same strong random secret in each authentication graph configuration.</p><p>Server encodes this string as UTF-8 for JJWT&rsquo;s HS256 signer, which requires at least 32 bytes. This is a byte-length requirement; an arbitrary 32-character
+string need not have sufficient randomness. The command below generates 32 random bytes and Base64-encodes them locally.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span clas [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;locally-generated-secret&gt;</span></span></span></code></pre></div></div></div><p>Generate the secret locally and transfer it securely into the authentication graph configuration. Do not commit the actual secret or expose it in public logs:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-3 data-td-code data-td-code-auto-i [...]
+<code>rest-server.properties</code> do not override that graph configuration.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-mode>StandardAuthenticator Mode</h4><p><code>StandardAuthenticator</code> stores users and password hashes in the backend and checks access by role.
+After updating these three configurations, <a href=#pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>initialize authentication and restart Server</a>.</p><p>Set the authenticator and REST configuration path in <code>conf/gremlin-server.yaml</code>.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=5><div class=td-code__viewport id=td-code-c11d92dd-fence-4-viewport data-td-code [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>authenticator</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.StandardAuthenticator,</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>authenticationHandler</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.WsAndHttpBasicAuthHandler,</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=nt>tokens</span><span class=p>:</span><span class=w> </span><span class=l>conf/rest-server.properties}</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>Configure the authenticator and the graph that stores authorization data in <code>rest-server.properties</code>:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-c11d92dd-fence-5-viewport data-td-code-viewport><div class=hi [...]
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>Set the authenticator and authentication graph in <code>conf/rest-server.properties</code>.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-c11d92dd-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.graph_store</span><span class=o>=</span><span class=s>hugegraph</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Used when Server first creates admin; replace public default pa with a strong password in production</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># For local persistent backends, init-store.sh prompts for a password when StandardAuthenticator is first initialized</span>
@@ -110,28 +119,53 @@ roles. Below is the specific configuration process (requires service restart):</
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># Auth Client Config</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl><span class=c1># If GraphServer and AuthServer are deployed separately, you also need to specify the following configuration. Fill in the IP:RPC port of AuthServer.</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1># auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p>In the above configuration, the <code>graph_store</code> option specifies which graph to use for storing user information. If there are multiple graphs, you can choose any of them.</p><p>In the <code>hugegraph{n}.properties</code> configuration file, configure the <code>gremlin.graph</code> [...]
-Simply implement the <code>org.apache.hugegraph.auth.HugeAuthenticator</code> interface with your custom authenticator,
-and then modify the <code>authenticator</code> configuration item in the configuration file to point to your implementation.</p><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</h3><p>When <code>init-store.sh</code> is run for the first time and the <code>admin</code> user does not yet exist, the command prompts for the
-administrator password. For an initialized persistent backend, <code>init-store.sh</code> adds the system metadata required for
-authentication without deleting existing graph data.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-c11d92dd-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=c1># stop the hugeGraph firstly</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl>bin/stop-hugegraph.sh
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># Initialize authentication system metadata; existing backend data is preserved</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>bin/init-store.sh
-</span></span><span class=line><span class=ln>6</span><span class=cl>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># start hugeGraph again</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hugegraph.sh</span></span></code></pre></div></div></div><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--use-docker-to-enable-authentication-mode>Use docker to enable authentication mode</h3><p>For versions of the hugegraph/hugegraph image equal to or greater than 1.2.0, you can enable authentication mode while starting the Docker image.</p><p>The steps are as follows:</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>hugegraph/hugegraph:1.7.0</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>      </span>- <span class=m>8080</span><span class=p>:</span><span class=m>8080</span><span class=w>
-</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>9</span><span class=cl><span class=w>      </span>- <span class=l>PASSWORD=xxx</span></span></span></code></pre></div></div></div><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>3. Enter the container to enable authentication mode</h4><p>Enter the container first:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-10 data-td-code data-td-code-auto-id data-td-language=bash [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># Modify the config quickly, the modified file are save in the conf-bak folder</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>Then follow <a href=#pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</a></p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4 - Configuring HugeGraphServer to Use HTTPS Protocol</h1><template data-hg-auth [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1># auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p><code>auth.graph_store</code> names the graph that stores authentication data. It must match a graph configuration in <code>conf/graphs/</code>.</p><p>Set <code>gremlin.graph</code> in <code>conf/graphs/&lt;graph>.properties</code> for each protected graph.</p><div class="td-code td-code--u [...]
+system.</p><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</h3><p>Use this sequence for a local persistent backend such as RocksDB, after applying the configuration above.
+HStore/PD deployments create the administrator through the PD startup path. Set <code>auth.admin_pa</code> for that deployment instead of using local interactive
+initialization.</p><ol class=steps><li><p><strong>Stop Server.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-c11d92dd-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/stop-hugegraph.sh</span></span></co [...]
+password.
+Keep the existing storage directory.</p></li><li><p><strong>Start Server and check authentication.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-c11d92dd-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>curl -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>curl prompts for the password. Correct credentials should return HTTP 200; missing or incorrect credentials should return HTTP 401.
+If startup fails, check the logs and authentication graph configuration before retrying.</p></li></ol><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--enable-authentication-with-docker>Enable authentication with Docker</h3><p>For a new container, choose either Docker run or Docker Compose. For an existing container, see
+<a href=#pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>enabling authentication in existing containers</a>.</p><p>When deploying with Docker, the official image supports enabling authentication
+directly via environment variables (applicable to the official <code>/hugegraph-server</code> layout).
+Replace the placeholder below with your image tag or digest:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-c11d92dd-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>HUGE [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>read</span> -r -s -p <span class=s1>&#39;Admin password: &#39;</span> PASSWORD
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>printf</span> <span class=s1>&#39;\n&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>export</span> PASSWORD</span></span></code></pre></div></div></div><p>Execute the command and enter a strong administrator password when prompted. Avoid committing plaintext passwords into shared Compose files.
+Persist the JWT secret in the authentication graph configuration as described <a href=#pg-7d189549d4201521c83e0d93a2474a2d--configure-user-authentication>above</a>. Use the same value across all nodes.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-use-docker-run>Docker run</h4><p>Create a new container and publish its REST port only on the local host.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td- [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -p 127.0.0.1:8080:8080 <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  -e PASSWORD <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUGEGRAPH_IMAGE</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>The entrypoint configures authentication, initializes the backend on first startup, and starts Server.
+Continue with <a href=#pg-7d189549d4201521c83e0d93a2474a2d--check-authentication>checking authentication</a>.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--2-use-docker-compose>Docker Compose</h4><p>Save the following as <code>compose.yaml</code>. Compose rejects missing required variables to avoid starting an unauthenticated service by accident.
+Start the service in the same terminal.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-12 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-c11d92dd-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>      </span>- <span class=s2>&#34;127.0.0.1:8080:8080&#34;</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>      </span><span class=nt>PASSWORD</span><span class=p>:</span><span class=w> </span><span class=l>${PASSWORD:?Set PASSWORD}</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-13-viewport data-td-code [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>Set these variables again before recreating the container. Retain its data volumes and persist the configuration required by your deployment.
+Continue with <a href=#pg-7d189549d4201521c83e0d93a2474a2d--check-authentication>checking authentication</a>.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>Existing containers</h4><p>Use this path for an official Server container that ran without authentication and uses a local persistent backend.
+Back up its data first. Confirm that the configuration, backend data, and <code>conf-bak</code> are all in mounted persistent volumes.
+The official image declares <code>/hugegraph-server</code> as a volume; inspect the mounts of custom images first.
+HStore/PD and external authentication services use their own administrator initialization paths.</p><ol class=steps><li><p><strong>Stop the original container and open a maintenance container with the same image and volumes.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-c11d92dd-fence-14-viewport data-td-code-viewport><div class=highlight> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>docker stop server
+</span></span><span class=line><span class=ln>3</span><span class=cl>docker run --rm -it --volumes-from server <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --entrypoint bash <span class=s2>&#34;</span><span class=nv>$SERVER_IMAGE</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>Keep the original container stopped so two JVMs do not open the local database at once. <code>--entrypoint bash</code> opens a shell without starting Server.</p></li><li><p><strong>Configure authentication and initialize it inside the maintenance container.</ [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>On its first run, <code>enable-auth.sh</code> saves the original configuration in <code>conf-bak</code> and updates authentication and the default <code>hugegraph</code> graph.
+If <code>conf-bak</code> already exists, the script skips its changes. Check all three configurations under <a href=#pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-mode>StandardAuthenticator mode</a>.
+Configure other authentication graphs manually.
+Write a strong random JWT secret to the authentication graph configuration as described <a href=#pg-7d189549d4201521c83e0d93a2474a2d--configure-user-authentication>above</a>, then initialize it.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-16 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-16-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code clas [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>exit</span></span></code></pre></div></div></div><p>Enter the administrator password when prompted, then exit after initialization succeeds.</p></li><li><p><strong>Start the original container from the host.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-17 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-c11d92dd-fence-17- [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+</span></span><span class=line><span class=ln>3</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>Requests without credentials should return <code>401 Unauthorized</code>, while requests with the correct password return <code>200 OK</code> (incorrect passwords also return <code>401</code>).
+Note: Current master URLs include <code>/graphspaces/DEFAULT</code>; for 1.7.0 and older versions, omit the graphspace prefix (use <code>/graphs/hugegraph/...</code> directly).
+If unauthenticated requests still return <code>200</code>, authentication is not active; inspect configuration and restart Server.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4 - Configuring HugeGraphServer to Use HTTPS Protocol</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1fe5a73f419--overview>Overview</h3><p>HugeGraphServer uses HTTP b [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>restserver.url</span><span class=o>=</span><span class=s>https://127.0.0.1:8080</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Server keystore file path. This default value is automatically effective when using HTTPS, and you can modify it as needed.</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>ssl.keystore_file</span><span class=o>=</span><span class=s>conf/hugegraph-server.keystore</span>
diff --git a/_print/docs/guides/index.html b/_print/docs/guides/index.html
index bf835616c..6b3da1c08 100644
--- a/_print/docs/guides/index.html
+++ b/_print/docs/guides/index.html
@@ -516,10 +516,42 @@ target directory. Copy the Jar package to the <code>plugins</code> directory whe
 </span></span><span class=line><span class=ln>11</span><span class=cl>hubble-dist/assembly/travis/verify-hubble-issue-694.sh <span class=se>\
 </span></span></span><span class=line><span class=ln>12</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUBBLE_TARBALL</span><span class=s2>&#34;</span> http://127.0.0.1:8080</span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--44-hugegraph-spark-connector>4.4 hugegraph-spark-connector</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--compile-3>Compile</h4><div class="td-code td-code--untitled" id=td-code-d1c060c1-fence-18 data-td-code d [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--45-hugegraph-tools>4.5 hugegraph-tools</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--compile-4>Compile</h4><div class="td-code td-code--untitled" id=td-code-d1c060c1-fence-20 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-coun [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-common-issues>5. Common Issues</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--service-connection-issues>Service Connection Issues</h3><p>If Server, MySQL, or Hadoop cannot be reached:</p><ul><li>Confirm se [...]
-Merging mode as needed, and when the Restore is completed, restore the graph mode to None.</p><p>The implemented RESTful API for setting graph mode is as follows:</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--view-the-mode-of-a-graph>View the mode of a graph</h5><p>When authentication is enabled, graph read permission is required (<code>space_member</code> or the graph owner).</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-common-issues>5. Common Issues</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--service-connection-issues>Service Connection Issues</h3><p>If Server, MySQL, or Hadoop cannot be reached:</p><ul><li>Confirm se [...]
+These <a href=/docs/quickstart/toolchain/hugegraph-tools/>HugeGraph-Tools</a> commands support migration, recovery after an upgrade, and graph merging.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup>Backup</h4><p>Backup runs in any graph mode. Pausing source writes before exporting is recommended to keep schema, vertices, and edges consistent
+(paginated read APIs do not provide a global transactional snapshot).
+Note: <code>backup -t all</code> only exports schema and graph data, excluding deployment configurations and user permissions.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore>Restore</h4><p>Before restoring data, switch the target graph to the appropriate mode.
+Normal read/write operations use <code>NONE</code> mode; note that <code>LOADING</code> mode cannot be used for <code>restore</code>.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Target</th><th scope=col>Mode</th><th scope=col>Schema IDs</th><th scope=col>Vertex and edge IDs</th></tr></thead><tbody><tr><td>New graph without schema or data</td><td><code>RESTORING</code></td><td>Use IDs from the [...]
+It retains <code>AUTOMATIC</code> and custom vertex IDs. The merge reuses schema with matching names.
+Check that their definitions are compatible and that retained vertex IDs do not conflict.
+It does not resolve arbitrary schema or data conflicts. Test on a separate target before merging production data.</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--instructions>Instructions</h2><p>Prepare <a href=/docs/quickstart/toolchain/hugegraph-tools/>HugeGraph-Tools</a> compatible with your Server version, then run the commands from the Tools root directory.
+This example restores a source graph on port <code>8080</code> to an empty target on port <code>8081</code>.
+Both Servers and the target graph must already exist and be running. Adjust the addresses and graph names for your deployment.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-274df940-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>TARGET_URL</span><span class=o>=</span>http://127.0.0.1:8081
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>SOURCE_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nv>TARGET_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nv>BACKUP_DIR</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$PWD</span><span class=s2>/data/hugegraph-backup&#34;</span></span></span></code></pre></div></div></div><p>With authentication enabled, add <code>--user &lt;user> --password &lt;password></code> before the subcommand in each Tools command.
+The account needs the relevant graph access and graph-mode management permissions.
+See the <a href=/docs/quickstart/toolchain/hugegraph-tools/>Tools reference</a> for connection and credential options.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-1>Backup</h4><p>Pause source writes, then export all schema, vertices, and edges.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-274df940-fence-1-viewport data-td-code-viewport><d [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  backup -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>An explicit <code>-d</code> is the backup directory itself; the graph name is not appended. Use a separate directory for each backup to avoid mixing old files.
+Retain the complete directory, including compressed files. Restore reads the JSON backup formats supported by Tools.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-1>Restore</h4><p>This sequence uses <code>RESTORING</code>. To merge, use <code>MERGING</code> after the compatibility checks above.
+Pause application writes to the target during maintenance.</p><ol class=steps><li><p><span id=step-1-view-and-set-graph-mode></span><strong>Record the original mode, then switch it.</strong></p><div class="td-code td-code--untitled" id=td-code-274df940-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-274df940-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>ORIGINAL_MODE</span><span class=o>=</span>NONE
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  graph-mode-set -m RESTORING</span></span></code></pre></div></div></div><p>A graph in normal use should be in <code>NONE</code> mode. Set <code>ORIGINAL_MODE</code> to the value returned by the query, such as <code>NONE</code> below.
+If another task is using <code>RESTORING</code>, <code>MERGING</code>, or <code>LOADING</code>, coordinate with that task before changing its mode.</p></li><li><p><span id=step-2-restore-data></span><strong>Restore the data.</strong></p><div class="td-code td-code--untitled" id=td-code-274df940-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-274df940-fence-3-viewport data-td-code-viewport><div class=highlight><p [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  restore -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>Check command output and the restore results for each type. On failure, retain the backup directory and logs to inspect target state.
+Restore does not automatically roll back committed writes; do not re-run on a partially restored graph without inspection.</p></li><li><p><span id=step-3-restoring-graph-mode></span><strong>Restore the original mode.</strong></p><p>Reset the mode using <code>ORIGINAL_MODE</code>, recorded in the first step.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> graph-mode-get</span></span></code></pre></div></div></div><p>Regardless of whether restore succeeds or fails, always restore the graph mode back to its original state (usually <code>NONE</code>).
+On failure, preserve the logs and state, and re-prepare the target graph before resuming business writes.</p></li></ol><p>After resetting the mode, compare vertex and edge counts on both graphs.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-274df940-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span></span></span></code></pre></div></div></div><p>Each pair of counts should match exactly. We also recommend using the <a href=/docs/clients/restful [...]
+and sampling vertex and edge properties and endpoints to ensure complete data integrity.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--help>Help</h4><p>For additional options on compression, concurrency, and selective type backup, see the <a href=/docs/quickstart/toolchain/hugegraph-tools/>Tools reference</a>.
+Before performing cross-major-version restores, verify backup file compatibility in a test environment first.</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--api-description-for-backuprestore-usage-and-implementation>API description for Backup/Restore usage and implementation</h2><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-2>Backup</h4><p>Backup exports data through the schema, vertex, and edge list GET APIs.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-2>Restore</h4><p>R [...]
+<code>RESTORING</code> accepts schema IDs; <code>MERGING</code> does not. Both accept retained <code>AUTOMATIC</code> vertex IDs.
+Normal <code>NONE</code> mode does not accept these ID settings required for restore.</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--view-the-mode-of-a-graph>View the mode of a graph</h5><p>When authentication is enabled, graph read permission is required (<code>space_member</code> or the graph owner).</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-274df940-fence-6 data-td-code data-td-code-auto-id data-td-lan [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;NONE&#34;</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><blockquote><p>Legal graph modes include: NONE, RESTORING, MERGING, LOADING</p></blockquote><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--set-the-mode-of-a-graph>Set the mode of a graph</h5><p>When authentication is enabled, graph-space management permission (<code>space</code>) is required; administrators can satisfy it through permission inheritance.</p> [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Valid graph modes are <code>NONE</code>, <code>RESTORING</code>, <code>MERGING</code>, and <code>LOADING</code>.</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--set-the-mode-of-a-graph>Set the mode of a graph</h5><p>When authentication is enabled, graph-space management permission (<code>space</code>) is required; administrators can satisfy it through  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;RESTORING&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3>6 - HugeGraph Docker Cluster Guide</h1><template data-hg-authored-content=start></template><h2 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--overview>Overview</h2><p>Docker Compose provides a quick way to run a [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>HUGEGRAPH_AUTH_TOKEN_SECRET</span><span class=o>=</span><span class=s1>&#39;&lt;32 random bytes, e.g. openssl rand -hex 32&gt;&#39;</span>
@@ -608,19 +640,31 @@ A startup deadline failure or Java exiting with <code>0</code> before readiness
 an early nonzero Java exit keeps its status. The deadline excludes earlier storage initialization and backend readiness waits.
 Readiness and partition checks remain interruptible during shutdown. A deadline failure requests termination and returns without an indefinite wait;
 an unresponsive Java process relies on container termination for final cleanup.</p><p>For example, from the HugeGraph repository&rsquo;s <code>docker/</code> directory, extend the standalone Server wait to 300 seconds (Compose passes this variable to the container):</p><div class="td-code td-code--untitled" id=td-code-c193a316-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c193a316-fence-11-viewport data-td-co [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>This setting is independent of Docker health-check <code>start_period</code>, <code>interval</code>, <code>timeout</code>, and <code>retries</code>. Those determine when a container becomes <code>unhealthy</code>; extending health-check grace periods does not extend the startup script deadline. Adjusting this variab [...]
-<code>graphs</code> in <code>conf/rest-server.properties</code>. <code>graph.load_from_local_config</code> defaults to <code>false</code> and controls constructor preloading, not whether startup loads
-local graphs. Give each local graph its own configuration file and restart Server after changing it. See the
-<a href=/docs/config/config-guide/>Server configuration guide</a>.</p></li><li><p>After the service starts successfully, garbled characters are returned when using <code>curl</code> to query all vertices</p><p>The batch vertices/edges returned by the server are compressed (gzip), and can be redirected to <code>gunzip</code> for decompression (<code>curl http://example | gunzip</code>), or can be sent with the <code>postman</code> of <code>Firefox</code> or the <code>restlet</code> plug-i [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>------------------| -------------
-</span></span><span class=line><span class=ln> 3</span><span class=cl>+                 | %2B
-</span></span><span class=line><span class=ln> 4</span><span class=cl>space             | %20
-</span></span><span class=line><span class=ln> 5</span><span class=cl>/                 | %2F
-</span></span><span class=line><span class=ln> 6</span><span class=cl>?                 | %3F
-</span></span><span class=line><span class=ln> 7</span><span class=cl>%                 | %25
-</span></span><span class=line><span class=ln> 8</span><span class=cl>#                 | %23
-</span></span><span class=line><span class=ln> 9</span><span class=cl>&amp;                 | %26
-</span></span><span class=line><span class=ln>10</span><span class=cl>=                 | %3D</span></span></code></pre></div></div></div></li><li><p>Timeout when querying vertices or edges of a certain category (<code>query by label</code>)</p><p>Since the amount of data belonging to a certain label may be relatively large, please add a limit limit.</p></li><li><p>It is possible to operate the graph through the <code>RESTful API</code>, but when sending <code>Gremlin</code> statements,  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>This setting is independent of Docker health-check <code>start_period</code>, <code>interval</code>, <code>timeout</code>, and <code>retries</code>. Those determine when a container becomes <code>unhealthy</code>; extending health-check grace periods does not extend the startup script deadline. Adjusting this variab [...]
+performance. When data volume is large (TB to PB scale) or requires horizontal scalability and multi-replica high availability, deploy an
+<strong>HStore distributed cluster</strong> (PD + Store + Server).</p><p>Version 1.7.0 supports RocksDB, HStore, HBase, and Memory. Legacy backends such as Cassandra, ScyllaDB, MySQL, and PostgreSQL require a
+version earlier than 1.7.0. See the <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server quick start</a> for deployment steps.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--core-dump>Investigate a core dump at startup</h3><p>First, run <code>java -version</code> to confirm your JDK version: <strong>HugeGraph master (1.8 baseline) requires Java 17</strong>, and <strong>1.7.0 requires Java 11</strong> (Java 8 is no longer supported). If the JDK version is correct, inspect the Serve [...]
+architecture mismatches, missing native libraries (such as RocksDB JNI), or insufficient system memory.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--initialize-backend>Which backends need init-store</h3><p>When using local persistent backends like RocksDB or HBase, <strong>you must run <code>bin/init-store.sh</code> before the first startup</strong>. Memory (in-memory
+backend) and HStore (distributed backend) do not use this script; HStore storage is managed directly by PD and Store.</p><p>Note: The <code>backend</code> and <code>serializer</code> settings must match (for example, RocksDB requires <code>binary</code>). If the service starts but reports that
+the backend is disconnected, verify initialization and backend connection settings first.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--native-library>Resolve a missing GLIBCXX version during init-store</h3><p>The following error indicates that the host system&rsquo;s <code>libstdc++</code> version is too old and lacks symbols required by the RocksDB JNI native library:</p><div class="td-code td-code--untitled" id=td-code-d5b2f53b-fence-0 data-td-code data-td-code-auto-id data-td-langua [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>.../libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found</span></span></code></pre></div></div></div><p>To resolve: Upgrade the system&rsquo;s <code>libstdc++</code> (or install a newer GCC runtime), or run HugeGraph using the official Docker image.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--start-script>Which Server startup script should I use</h3><p>Current releases uniformly use <code>bin/start-hugegraph.sh</co [...]
+<code>start-restserver.sh</code> and <code>start-gremlinserver.sh</code> scripts from older documentation are deprecated.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--load-graphs>Which graphs does the startup script load</h3><p>The script name has no relation to the graph name. Server scans and loads all graph configurations in <code>conf/graphs</code> by default (this
+directory can be customized via <code>graphs</code> in <code>conf/rest-server.properties</code>). Each local graph uses an independent configuration file; restart
+Server after editing configurations.</p><p>Note: <code>graph.load_from_local_config</code> defaults to <code>false</code> (controlling constructor preloading) and cannot prevent local graph loading at
+startup. See the <a href=/docs/config/config-guide/>Server configuration guide</a>.</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--queries>Connections and queries</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--compressed-response>Read compressed responses with curl</h3><p>Batch vertex and edge endpoints return gzip-compressed data by default. Add the <code>--compressed</code> flag to curl to decompress automatically:</p><div class="td-code td-code--untitled" id=td-code-d5b2f53b-fence-1  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  <span class=s1>&#39;http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10&#39;</span></span></span></code></pre></div></div></div><p>If authentication is enabled, supply credentials. If output remains unexpected, check HTTP status codes, <code>Content-Type</code>, and
+<code>Content-Encoding</code>. Do not pipe JSON error responses directly into <code>gunzip</code>.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--vertex-id>A vertex exists, but lookup by ID cannot find it</h3><p>Check the exact format and type of <code>id</code> in existing query results: <strong>string IDs require JSON double quotes, while numeric IDs do not</strong>. For
+example, the string ID <code>1:marko</code> is written in JSON as <code>"1:marko"</code>.</p><p>When embedding this JSON ID into a URL path, URL-encode the entire string including double quotes. If the ID contains special characters,
+encoding the whole quoted string is required:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Character</th><th scope=col>URL encoding</th></tr></thead><tbody><tr><td><code>+</code></td><td><code>%2B</code></td></tr><tr><td>Space</td><td><code>%20</code></td></tr><tr><td><code>/</code></td><td><code>%2F</code></td></tr><tr><td><code>?</code></td><td><code>%3F</code></td></tr><tr><td><code>%</code [...]
+port (default <code>8182</code>, configured in <code>conf/gremlin-server.yaml</code>);</li><li><strong>Query syntax or logic error</strong>: Such as unindexed property filtering triggering scan limits;</li><li><strong>Missing or expired credentials</strong>.</li></ol><p>Check <code>logs/hugegraph-server.log</code> for the detailed exception stack trace.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--content-type>REST returns HTTP 415</h3><p>When sending POST/PUT requests with a JSON body [...]
+API</a> for complete reference.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--schema-cache>Schema still exists after clearing the backend</h3><p>Server caches metadata in memory. Bypassing Server to clear underlying storage directly (such as wiping RocksDB directories or HBase tables)
+causes cache inconsistency. If storage was manually deleted, <strong>restart Server</strong> to clear the cache. For normal cleanup, use the official
+<a href=/docs/clients/restful-api/graphs/#clear-graph>Clear Graph API</a>.</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--modeling>Modeling and IDs</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--id-length>A vertex or edge ID exceeds the length limit</h3><p>To maintain storage and indexing performance, HugeGraph enforces maximum ID length limits (calculated by encoded byte count):</p><ul><li><strong>Vertex ID</strong>: Maximum 16384 bytes (16 KB);</li><li><strong>Edge ID</strong>: Maximu [...]
+are automatically hashed for storage and will not trigger length errors.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--nested-properties>Are nested properties supported</h3><p>Nested properties (complex nested maps or objects) are not currently supported. To represent multi-level relations, model the nested object
+as an independent vertex and link it to the parent vertex with an edge.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--edge-links>Can one edge label connect several vertex-label pairs</h3><p>Yes. When creating an <code>EdgeLabel</code>, invoke <code>link(sourceLabel, targetLabel)</code> once for each source-target pair.
+For example, an <code>investment</code> edge label can link both <code>individual → enterprise</code> and <code>enterprise → enterprise</code>. The deprecated
+<code>sourceLabel()</code> and <code>targetLabel()</code> methods only supported a single pair and should no longer be used.</p><p>For other questions, search the <a href=https://github.com/apache/hugegraph/issues>Server issues</a> or <a href=https://github.com/apache/hugegraph-toolchain/issues>Toolchain
+issues</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d54c862d45861ca39a945d90325e3909>8 - Security Report</h1><template data-hg-authored-content=start></template><h2 id=pg-d54c862d45861ca39a945d90325e3909--reporting-new-security-problems-with-apache-hugegraph>Reporting New Security Problems with Apache HugeGraph</h2><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class=" [...]
 Use this guide to identify affected code, rebuild your integrations and check existing data before deployment.</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--find-the-work-that-applies-to-you>Find the work that applies to you</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Your integration</th><th scope=col>What to prepare</th></tr></thead><tbody><tr><td>Java code using Server IDs, schema metada [...]
 Use matching Server, PD, Store and downstream artifacts when upgrading.
 See the <a href=https://github.com/apache/hugegraph/blob/master/docs/shared-foundation-migration.md>source migration guide</a>
diff --git a/_print/docs/index.html b/_print/docs/index.html
index 9bf654ed2..a547e9a48 100644
--- a/_print/docs/index.html
+++ b/_print/docs/index.html
@@ -53,13 +53,14 @@ Build all modules with <strong>JDK 17 and Maven 3.6.3 or later</strong>, and run
 Server security check (<code>-s true</code>) requires Java 17 to 23 and a readable <code>conf/java-security.properties</code>;
 on Java 24 or later, start Server with <code>-s false</code> (JDK 24+ dropped Security Manager via JEP 486).</p><p><strong>Before continuing, run <code>java -version</code> to confirm your JDK version.</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p><strong>TinkerPop 3.8.1 Compatibility & Key Cha [...]
 Keep HugeGraph registries.</li><li><strong>Graph.Features</strong>: <code>supportsUniformListValues()</code> returns <code>false</code> for properties.
-Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
+Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema results are standard maps</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob values are binary (including inside returned elements)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON ( [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP / Leg [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Preserves the legacy Tree key/value array structure</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 is disabled for security (typed V2/V3 remain available for simple values and IDs)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() returns property keys, vertex labels, edge labels, and index labels</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>For complete client configurati [...]
@@ -310,7 +311,7 @@ the start script rejects older runtimes; 1.7.0 is the last release supporting Ja
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
 install-snapshot timeout, and id allocation runs no ReadIndex wait.</p><p><strong>PD core</strong></p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Key</th><th scope=col>Master distribution value</th><th scope=col>Built-in default</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>pd.data-path</code></td><td><code>./pd_data</code></td><td>none, required</td><t [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
@@ -759,17 +760,21 @@ provides complete orchestration for PD, Store, Server, and Hubble. Follow the ad
 then launch services from <code>docker/</code> without maintaining separate Compose files.
 The guidance below focuses on connectivity and operations; ensure prerequisite credentials and service readiness from the README are met.
 Docker <code>latest</code> is a moving tag. Screenshots assist in UI navigation; verify deployed versions via image digests and build details.
-Metrics and permission APIs vary by version.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
-and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e0 [...]
+Metrics and permission APIs vary by version.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
+and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|Graph API| S[Server]
+    S --&gt;|Graph reads and writes| T[Store]
+    H -.-&gt;|Discovery and cluster information| P[PD]
+    H -.-&gt;|Node metrics| T</code></pre><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=highlight><pre t [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>The script reads <code>HG_PD_AUTH_SECRET_KEY</code> from <code>.env</code> and writes its value as <code>operations.pd.password</code> into the generated file
 <code>docker/conf/hubble/hstore.local.properties</code>. Edit this generated file to adjust connection or operations settings (do not overwrite
 the tracked <code>.example</code> template), ensuring <code>operations.pd.password</code> matches the PD secret. Compose mounts this file read-only into
 the container; do not edit inside the container. Both <code>.env</code> and the generated file contain secrets and should not be committed to Git.
-Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=h [...]
+Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=h [...]
 <a href=/docs/quickstart/hugegraph/hugegraph-hstore/>HStore deployment guide</a>. A source or binary Hubble deployment instead uses the package&rsquo;s
-<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
+<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Setting</th><th scope=col>Purpose</th><th scope=col>Bundled value</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>Explicitly enable PD mode; <c [...]
@@ -777,7 +782,7 @@ rather than <code>127.0.0.1</code> for cross-container traffic.
 The bundled package sets <code>pd.enabled=false</code>. If omitted, the fallback default is <code>true</code>, so declare this setting explicitly in both standalone and distributed
 setups.
 After editing configuration: restart the Hubble process for source or binary deployments; for Docker Compose, recreate the Hubble container from <code>docker/</code>
-to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
+to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
 so each team can work with its own graphs. Modeling, importing, and querying within a space follow the standalone guide.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--create-and-adjust-a-graphspace>Create and adjust a GraphSpace</h3><p>With Server authentication enabled, creating, editing, and deleting GraphSpaces require super administrator access.
 Start with a globally unique GraphSpace name, an optional display alias, and the maximum graph count.
 For example, use <code>research</code> as the API identifier and “Research_graph” as the display alias.
@@ -786,7 +791,7 @@ Choose GraphSpace administrators from existing accounts.</p><p>“Advanced deplo
 plus the storage capacity limit. These deployment quotas neither report current usage nor resize existing containers.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Advanced deployment defaults</span></div><div class=td-callout__body><p>Defaults are 100 graphs, 64 CPU cores and 128 GB of memory for each of the graph and compute services, and 1000000 GB of storage.
 Keep the defaults for a container trial. Configure Kubernetes namespaces, Operator images, and algorithm images only for the corresponding deployment
 or compute use.</p></div></div><p>Select a space before opening a graph. Check the current graph after switching spaces, especially when spaces contain identically named graphs.
-The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation and advanced resource limits" width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema within a GraphSpace.
+The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation form and entry to advanced resource limits" width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema  [...]
 When several business graphs share vertex labels, edge labels, and indexes, save the model as a template and select it when creating subsequent graphs.
 For example, a user template in <code>research</code> can be reused for new graphs in that space. After switching spaces, select a template belonging to the new space.</p><p>User templates differ from the built-in sample templates in the main guide: built-in templates help explore preset models,
 while user templates preserve your own models for future use. A template is not an import of data; loading sample data is a separate graph creation choice.
@@ -800,7 +805,7 @@ Accounts and space memberships are managed separately; removing a member does no
 After creating an account, continue directly to assigning space access. When changing an existing membership, check the selected space and preset
 and preserve permissions still needed in other spaces. Enabling <code>pd.enabled</code> grants no permissions;
 legacy custom roles on older Servers are not interchangeable with these presets.
-See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to fi [...]
+See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to f [...]
 PD Leader, online Store count, graphs, partitions, replicas, and data size help identify cluster scale and nodes requiring attention.
 Partitions and replicas describe data distribution. Data size is observed usage, distinct from a GraphSpace&rsquo;s configured storage limit.</p><p>Start with cluster and source status, then inspect an affected node. <code>UP</code> indicates a successful collection from the source;
 <code>DEGRADED</code> indicates a cluster or partial source issue, and <code>DOWN</code> indicates that the corresponding probe failed.
@@ -813,32 +818,32 @@ GraphSpace administrators and ordinary members do not inherit cluster access.
 Use container isolation, a trusted HTTPS entrypoint, Server authentication, and network allowlists; avoid publishing Hubble or component ports directly.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--configure-operations-access>Configure operations access</h3><p>Hubble&rsquo;s <strong>backend</strong> uses the PD/Store operations credentials, separately from the Server account used to log in through the browser.
 For Compose, edit the generated host file <code>docker/conf/hubble/hstore.local.properties</code>; other deployments use the Hubble package configuration.
 The script-generated PD password must match the secret in <code>.env</code>. Configure the Store service account when Store authentication is enabled.
-Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
+Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
 matching the Store metric target returned by PD. Adding an origin here only authorizes access—it does not register or discover nodes.</p><p>If topology renders but node metrics are missing, check Hubble backend connectivity and credentials to PD REST, verify the Store REST and metric addresses
 returned by PD, and ensure targets are in <code>operations.store.allowed_targets</code>. A partially available overview indicates metrics collection was blocked for
 specific sources, not that graph APIs are down.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-55eecaa5c3ceec829e0f0d20863baa46>3.2.2 - Graph Visualization with Hubble: Standalone Quick Start</h1><div class=lead>Use Hubble and RocksDB Server to manage schema, import CSV, and query graph data with Gremlin, Cypher, or Text2GQL.</div><template data-hg-authored-content=start></template><p>Hubble is the HugeGraph Web m [...]
 and switch smoothly between graph, table, and JSON results. This guide uses <strong>standalone RocksDB Server + Hubble</strong>, without requiring PD or Store.</p><p>For use with an HStore distributed cluster, read the foundational operations here first, then consult the
 <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a>.
-This guide aligns with the Toolchain and Server <code>master</code> branches (both currently <code>1.8.0</code>).</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p>Do not expose unauthenticated Hubble or Server instances directly to the public internet. In production, use HTTPS, container isolation,
-<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start the standalone pair</h2><p>Use the main repository&rsquo;s <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a>
+This guide aligns with the Toolchain and Server <code>master</code> branches (currently based on 1.8, unreleased). Docker <code>latest</code> is a moving tag; use released versions for production deployments.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" a [...]
+<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><p>Jump directly to a task below. If this is your first visit, start with the standalone deployment:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start and load a sample</a></p><p>Start the two services and load the People & Software Demo Graph.</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-workspa [...]
 instead of writing custom Compose files. It already integrates RocksDB Server and Hubble with networking, health checks, and data volumes;
-see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span>< [...]
+see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><ol class=steps><li><p><strong>Prepare the official Compose configuration.</strong></p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>If you already have the repository locally, navigate directly to its <code>docker/</code> directory. Compose automatically mounts
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 which pre-configures <code>pd.enabled=false</code> and <code>server.direct_url=http://server:8080</code>. Because both services communicate over a shared Docker network,
 you do not need to configure Server endpoints per graph. Start Compose directly from <code>docker/</code> so relative file paths resolve correctly.</p><p>Hubble publishes on host loopback port <code>8088</code> by default (controlled by <code>HUBBLE_PUBLISH_HOST</code>, defaulting to <code>127.0.0.1</code>), whereas Server publishes
 <code>8080</code> across all interfaces. For a local trial, set Server&rsquo;s <code>ports</code> in Compose to <code>127.0.0.1:8080:8080</code> to prevent exposing unauthenticated ports
-beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chrom [...]
+beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p></li><li><p><strong>Start and check the services.</strong></p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>Open Hubble.</strong></p><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
 Server permits anonymous access and Hubble opens the homepage directly. If authentication is enabled, configure an admin password and JWT secret in <code>.env</code>
 as described in the Docker README, then sign in with a Server account (Hubble has no independent user database).
-Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
+Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p></li></ol><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
 <a href=/docs/download/download/>download page</a>.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Verify the deployed versions</span></div><div class=td-callout__body><p>Screenshots help locate controls. Verify actual versions from the deployed image digests and build information.</p></div></div><p>Compose&rsquo;s <code>server-data</code> and <code>hubble-data</code>  [...]
 see the <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server deployment guide</a>.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--home-find-the-right-starting-point>Home: find the right starting point</h2><p>Home groups the workspace into graph overview, data preparation, and graph queries. Use it to understand the workflow,
 then return to any section through the sidebar. The top graph selector determines the target of queries, schema operations, and async tasks;
@@ -858,15 +863,13 @@ Use <strong>New</strong> to create elements, or edit existing data when authoriz
 adding or editing elements via the UI or executing Gremlin write statements modifies underlying Server graph data.</p><p>Press <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> to execute queries quickly. Immediate execution is ideal for interactive exploration; submit long or resource-intensive
 queries as background async tasks. Cypher is available when supported by the backend Server.
 The keyboard shortcut acts on whichever input currently has focus: generating a query from
-the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p>The Text2GQL backend capabilities (including Model settings, built-in/temporary models, and Prom [...]
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> or a release containing it.
-Earlier builds display a preview tab without model management.</p></div></div><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
+the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
 and execute it automatically. Generated statements can be edited freely (read-only safety checks still apply before execution).
 In <strong>Async</strong> mode, both generated and handwritten queries can be submitted as background tasks.
-Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL query and graph results" loading=lazy decoding=async><p class=td-gallery__description>Query workspace</p></li><li class=td-gallery__item><img class=td-gall [...]
+Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL entry and handwritten query results" loading=lazy decoding=async><p class=td-gallery__description>Unconfigured model; handwritten query</p></li><li class=t [...]
 The Base URL must be reachable from Hubble&rsquo;s backend; container <code>localhost</code> refers to that container. Public endpoints require HTTPS, while plain HTTP is
 accepted only for loopback or private-network models; when changing the Base URL in Model settings, supply a new Key or explicitly clear the saved Key.
-Only the <code>admin</code> account (a super administrator in PD mode) manages shared settings. When Server authentication is disabled, anyone who can access the
+Administrators with model-settings management permission manage shared settings. When Server authentication is disabled, anyone who can access the
 deployment can manage them.</p><p>Under model settings, click <strong>Text2GQL Prompt</strong> in the header to customize Gremlin and Cypher generation rules and few-shot examples.
 Click <strong>Apply</strong> and then save model settings to persist templates to the H2 database for both built-in and temporary models.
 The current graph schema is appended automatically during generation.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Key storage and privacy notes</span></div><div class=td-callout__body><p>When backing up the Hubble H2 database, always back up the master-key file (<code>data/text2gql-master.key</code> by default); losing it prevents decrypting saved Keys.
@@ -877,7 +880,7 @@ Start with a known vertex ID and limit direction, edge labels, depth, and result
 Results use graph or algorithm-specific panels. Consult the help and documentation links beside the algorithm title for definitions and parameters.
 While the parameter form is focused, <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> runs the current algorithm.</p><p>OLAP batch algorithms require external compute services such as Computer or Vermeer.
 The two containers in this example provide online graph operations, not those compute services.</p><p>For example, select K-neighbor (GET) with <code>source=1:marko</code>, <code>max_depth=1</code>, and <code>limit=20</code>.
-After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, incl [...]
+After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, inc [...]
 Filter by task type and status, inspect IDs, creation times, and execution states, open successful query results, or expand failure information.
 Completed task records can be deleted where the interface permits. These tasks are separate from import execution history.</p><p>For example, submit <code>g.V().count()</code> asynchronously, confirm success in the list, then inspect the returned count.
 A successful submission means the request was accepted, not that computation or indexing has finished.
@@ -908,7 +911,7 @@ The following presets are for PD mode, and are not universally editable on older
 Before replacing custom permissions with a preset, inspect the grants that need to be retained; complex permissions may not match a single preset.
 After changes, refresh permission context or sign in again and verify menus and space selection. Server still validates every request.
 Older Servers may hide or disable unsupported operations; a visible button alone does not establish resource authorization.
-See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in PD mode" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Information< [...]
+See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in standalone mode" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Inf [...]
 Search nodes, filter health status, and open node details to inspect available version, system, JVM, and Server-backend metrics.
 When metrics are unavailable or stale, use collection state and the last successful observation time;
 a missing value is neither zero nor proof of health.</p><p>Anonymous mode can read operations information. With authentication enabled, operations are available only to administrators with the capability.
@@ -916,15 +919,12 @@ This is an observation and diagnosis interface, not a start/stop or scaling cons
 The distributed supplement covers cluster overview and the PD/Store node hierarchy.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--keyboard-shortcuts-and-graph-interactions>Keyboard shortcuts and graph interactions</h2><p>Use the topbar shortcut-help button to see key bindings. Their scope differs: typing <code>?</code> in an input does not trigger global help.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr>< [...]
 it is not a universal hard limit. <code>gremlin.vertex_degree_limit</code> (<code>100</code>) and <code>gremlin.edges_total_limit</code> (<code>500</code>) constrain expansion.
 FILE uploads allow <code>csv,txt</code> by default, with 1 GB per file and 10 GB total. Override <code>upload_file.*</code> settings when needed.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--stop-the-trial-or-build-from-source>Stop the trial or build from source</h2><p>When finished, run this in the main repository&rsquo;s <code>docker/</code> directory:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td [...]
-To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>To obtain an exact master build, use JDK 17 and Maven. The Maven plugin installs the required Node/Yarn;
-you do not need to install them separately. These commands skip tests:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branc [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># Edit conf/hugegraph-hubble.properties with the correct Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
+To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>Building current master requires <strong>JDK 17, Maven 3.9+, Python 3.9+, and stable Node.js 24 (at least 24.22.0)</strong>,
+with <strong>pnpm 12.14.0</strong> selected through Corepack. Maven no longer installs Node/Yarn automatically.</p><ol class=steps><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration instructions</a>
+to install the Server SDK in an isolated Maven repository.</p></li><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble source-build procedure</a>
+to install Python dependencies and build Client, Loader, and Hubble with that same repository (skipping tests).</p></li><li><p>Open the resulting <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> directory,
+configure Server connection settings in <code>conf/hugegraph-hubble.properties</code>, then start:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hu [...]
+Old metadata has no automatic migration and cannot be reused directly.</p><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
 For development and testing, see the <a href=/docs/guides/toolchain-local-test/>Toolchain local test guide</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>3.2.3 - Graph import</h1><template data-hg-authored-content=start></template><p>Choose an import tool when you need to write file, database, or message data into HugeGraph. Use Loader for a direct import, SeaTunnel Sink when  [...]
 All examples use the <code>mappings</code> configuration available in SeaTunnel 3.0+.</p></blockquote><p><a href=/docs/images/seatunnel/seatunnel-vs-loader-en.png><img class=td-image src=/docs/images/seatunnel/seatunnel-vs-loader-en.png alt="Loader imports data directly with graph mappings; SeaTunnel 3.0+ combines Source, Transform, and Sink, and both support JDBC, Kafka, and graph data" loading=lazy decoding=async></a></p><p>Click a diagram to view the original size.</p><h2 id=pg-b8e8e0 [...]
 lists Java 8 and 11 as prerequisites. Choose a 3.0+ binary distribution from the
@@ -1058,10 +1058,63 @@ as needed<sup>[11][12]</sup>. The JDBC examples also require the MySQL driver JA
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
-check the version you use and build from source for unreleased functionality.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader is the data import component of HugeGraph, which can convert data from various data sources into graph vertices and edges and import them into the graph database in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and J [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).
-Older Servers retain the legacy import behavior described below.</p></blockquote><blockquote><p><strong>Testing Guide</strong>: For running HugeGraph-Loader tests locally, please refer to <a href=/docs/guides/toolchain-local-test/>HugeGraph Toolchain Local Testing Guide</a></p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>2 Get HugeGraph-Loader</h3><p>HugeGraph-Loader is available in the following three ways:</p><ul><li>Use docker image (Convenient for T [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+First <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>install Loader</a> and start <a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>.
+The commands below run from the Loader directory, importing into the default graph <code>hugegraph</code>.
+For an authenticated Server, append <code>--username</code> and <code>--password</code> (or <code>--token</code>).</p><ol class=steps><li><p><strong>Create the data files.</strong></p><p>These CSV files have no header row. The mapping in the next step supplies the column names.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-8a011ca1-fence-0-viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Create the schema and mapping.</strong></p><p>Dedicated <code>docs_*</code> names keep this example separate from the built-in <code>person</code> data.
+File paths are relative to the directory where you run Loader.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-8a011ca1-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Run the import.</strong></p><p>Keep the same working directory. Change the host and port if Server runs elsewhere.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-2-viewpor [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>A first successful run imports two vertices and one edge. Check the success and failure counts in the summary.</p></li><li><p><strong>Query the result in Hubble.</strong></p><p>Connect Hubble to the same Server and graph, then run these queries separately in the Gremlin workspace.</p><div class="td-code td-code--unt [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>The first query returns Alice with age <code>29</code> and Bob with age <code>31</code>. The second returns <code>docs-sm [...]
+The <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>bundled full example</a> also includes software vertices and edge properties.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader converts source data into graph vertices and edges and imports them into HugeGraph in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and JSON format [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -1076,10 +1129,12 @@ Older Servers retain the legacy import behavior described below.</p></blockquote
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>The specific data loading process can be referenced under <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 User Docker to load data</a></p><blockquote><p>Note:</p><ol><li><p>The docker image of hugegraph-loader is a convenience release to start hugegraph-l [...]
-A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Clone the <code>master</code> branch:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=t [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extracted Loader <code>lib/</code> directory.
-The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>The basic process of using HugeGraph-Loader is divided into the following steps:</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-g [...]
-&ldquo;Software&rdquo; includes: &ldquo;name&rdquo;, &ldquo;sale price&rdquo; and other attributes; side &ldquo;knowledge&rdquo; includes: &ldquo;date&rdquo; attribute and so on.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>After designing the graph model, we can use <code>groovy</code> to write the definition of <code>schema</code> a [...]
+A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Building Loader from the master branch requires Java 17, Maven 3.6.3+, and Python 3.9+. Clone the repository and build:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-au [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>To build against candidate Server SDKs during development, refer to the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a>.</p><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extrac [...]
+The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>To import a dataset, prepare the schema, data and mapping, then run Loader.</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-graph- [...]
+People have names, ages and cities; software has a name and price. Each edge records a date.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>Save the schema definitions in <code>schema.groovy</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-lin [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1094,19 +1149,23 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// Create the knows edge type, which goes from person to person
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// Create the created edge type, which points from person to software
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+Column names can come from a header row or from the mapping&rsquo;s <code>header</code> setting.</p><p>An example is as follows:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-7 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</sp [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-6-viewport data-td-code-view [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If the id strategy of person or software is specified as PRIMARY_KEY when modeling (schema), choose name as the primary key (note: this is the concept of vertex-label in hugegraph), when importing edge data, the source vertex and target need to be spliced ​​out. For the id of the vertex, you must go to the person/software table with p_id/s_id to find [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+Each input row must provide the values needed to construct its graph elements. Prepare any joins in the source query first.</p><p>Consider three tables named <code>person</code>, <code>software</code> and <code>created</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-10-viewport data-td-code-viewport><div class=highlight><pre ta [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If <code>person</code> and <code>software</code> use <code>PRIMARY_KEY</code> IDs with <code>name</code> as the primary key, each edge needs its endpoints&rsquo; names.
+The <code>created</code> table contains only <code>p_id</code> and <code>s_id</code>; Loader will not query the names from those IDs. Use either of these ID designs.</p><ol><li>Keep <code>PRIMARY_KEY</code> and use each vertex table&rsquo;s <code>id</code> column as its primary key property.
+Loader can then build endpoint IDs from <code>p_id</code>, <code>s_id</code> and the vertex labels.</li><li>Use custom IDs, taking each vertex table&rsquo;s <code>id</code> column as the vertex ID. The edge mapping can use <code>p_id</code> and <code>s_id</code> directly.</li></ol><p>Both designs let edge rows supply endpoint IDs without another lookup.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-prepare-vertex-and-edge-data>3.2.2 Prepare vertex and edge data</h5><h6 id=pg-85740db [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1123,7 +1182,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -1321,7 +1380,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-16 data-td [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-19 data-td [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1372,8 +1431,8 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
-(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
+(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1402,59 +1461,24 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// If there is no update strategy, you will get
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 If the argument file contains credentials, restrict it to mode <code>0600</code> with <code>chmod 0600 loader.args</code>.
 The <code>@file</code> form keeps credential values out of process arguments.
 Loader must be able to create and write the mapping-prefix directory used for progress output.
-Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>Usually, the Loader task takes a long time to execute. If the import interrupt process exits for some reason, and next time you want to continue the import from the interrupted point, this is the scenario of using breakpoint continuation.</p><p>Set <code>--incremen [...]
+Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>For a long import, use a progress file to resume after an interruption.</p><p>Set <code>--incremental-mode</code> to <code>true</code> to resume from a progress file. Loader records progress when it closes normally after a successful import
 or a normal stop; an unexpected failure may prevent this write.
 The progress file is in <code>${struct}</code> and named <code>load-progress_${timestamp}</code>, where <code>${struct}</code> is the mapping-file prefix and <code>${timestamp}</code> is the
 import start time, formatted as <code>yyyyMMdd-HHmmss</code>. For example, an import started at <code>2019-10-10 12:30:30</code> with mapping file <code>struct-example.json</code>
 writes <code>struct-example/load-progress_20191010-123030</code>. When the directory holds several progress files, the resumed import reads the last one in name
 order, which is the most recent one.</p><blockquote><p>Note: A progress file is written after a successful import or a normal stop (including an error limit), regardless of <code>--incremental-mode</code>
-or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>If the data file formats are all legal and the import task is stopped by the user (CTRL + C or kill, kill -9 is not supported), that is to say, if there is no error record, the next import only needs to be set to
-Continue for the breakpoint.</p><p>But if the limit of &ndash;max-read-errors, &ndash;max-parse-errors or &ndash;max-insert-errors is reached because too much data is invalid or network abnormality is reached, Loader will record these original rows that failed into
-the failure file, after the user modifies the data lines in the failure file, set &ndash;failure-mode to true to import these &ldquo;failure files&rdquo; as input sources (does not affect the normal file import),
-Of course, if there is still a problem with the modified data line, it will be logged again to the failure file (don&rsquo;t worry about duplicate lines, they are dropped when the file is closed). Failure mode lifts the three error limits above, so the whole failure file is scanned.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error [...]
+or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>After stopping an import with <code>Ctrl+C</code> or <code>kill</code>, set <code>--incremental-mode true</code> to continue from the recorded position.
+A forced stop with <code>kill -9</code> cannot save progress.</p><p>Invalid data or connection failures can exhaust <code>--max-read-errors</code>, <code>--max-parse-errors</code> or <code>--max-insert-errors</code>.
+Correct the rows in the failure files, then use <code>--failure-mode true</code> to retry them. This leaves the original data files unchanged.
+Rows that still fail are recorded again and deduplicated when the failure file closes. Failure mode lifts these three limits and scans the entire file.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error</code> and is stored in the <code>${struct}/failure-data</code> directory.
 Every failed line is written as a pair of lines: a tip line starting with <code>#### READ ERROR:</code>, <code>#### PARSE ERROR:</code> or <code>#### INSERT ERROR:</code>, followed by the original data line. When the input source has a header, that header is written as JSON to a sibling <code>${id}.header</code> file, so the failure file can be read back with the right columns.
-For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p>The CSV has no header row; <code>input.header</code> in the mapping supplies column names. <code>input.path</code> is relative to the Loader process working directory, so keep running from the installation directory. If Server runs in another container, set <code>--host</code> to a Server address reachable by Loader:</p><div class="td-code t [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>Expected result: two vertices and zero edges imported. This example uses dedicated schema names to avoid conflicts with a preloaded <code>person</code> label. In Hubble, run <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code> to confirm <code>docs-smoke-alice</code> and <code>docs-smoke-bob</code>.< [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
+When the deployed Server provides this endpoint and returns <code>protocol: 1</code>, Loader enables ownership protection automatically; released Server 1.7.0 and older versions continue using the legacy mode switching flow.</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;Graph Mode: NONE&#34;] --&gt;|First Loader acquires owner| B[&#34;LOADING Mode (Acquires Token)&#34;]
     B --&gt;|Concurrent Loaders join| B
     B --&gt;|Loader finishes &amp; releases| B
@@ -1471,18 +1495,19 @@ Network or permission errors, or a <code>404</code> for a missing graph, do not
 manually reset graph mode to <code>NONE</code> before starting ordinary imports.
 Do not run restore, graph-source, Spark connector, or older Loader imports while owned imports are active.</li><li><strong>Scope & Lifecycle</strong>: Ownership is bound to the target Server instance without cross-node synchronization or automatic lease expiry.
 For embedded programmatic integrations, callers must invoke <code>HugeGraphLoader.shutdown()</code> to attempt a single graceful release. If release
-fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>Given below is an example in the example directory of the hugegraph-loader package. (<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub address</a>)</p><h4 id=pg-85740db4cef1a86c [...]
+fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>The Loader distribution includes this dataset in <code>example/file/</code>.
+See the <a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>source files</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-prepare-data>4.1 Prepare data</h4><p>Vertex file: <code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=6><div class=td-code__viewport id=td-code-8a011ca1-fence-28-viewp [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1505,7 +1530,7 @@ fails, the handle is not retried; the owner may remain active on the Server, and
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> uses custom numeric IDs: mapping <code>id</code> supplies the vertex ID and <code>created.target_id</code> supplies the edge’s target ID.
-Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
+Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1565,7 +1590,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-33-viewport data-td-code-viewport><div class=highlig [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-34-viewport data-td-code-viewport><div class=highlig [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -1577,7 +1602,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -1585,11 +1610,11 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Taking the built-in example dataset as an example, we can use the following command to load the data.</p><p>If you need to import your custom dataset, you need to modify the paths for <c [...]
-Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Run this command to import the built-in dataset.</p><p>For custom data, set <code>-f</code> to your mapping file and <code>-s</code> to your schema file.</p><p>You can refer to <a href=# [...]
+Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -1611,19 +1636,31 @@ Changing only <code>-f</code> and <code>-s</code> does not change where Loader l
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>You can also use <code>curl</code> or <code>hubble</code> to observe the import result. Here&rsquo;s an example using <code>curl</code>:</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-these two-parameter names have overlapping parts, please use the full name of the parameter.
-And there is no need to guarantee the order between the two parameters.</p><ul><li>hugegraph parameters (Reference: <a href=https://hugegraph.apache.org/docs/quickstart/toolchain/hugegraph-loader/#341-parameter-description>hugegraph-loader parameter description</a> )</li><li>Spark task submission parameters (Reference: <a href=https://spark.apache.org/docs/3.3.0/submitting-applications.html#content>Submitting Applications</a>)</li></ul><p>Example:</p><div class="td-code td-code--untitled [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> submits <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code> through <code>${SPARK_HOME}/bin/spark-submit</code>, so <code>SPARK_HOME</code> has to point at a Spark installation. Every jar u [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> is treated separately: with <code>--deploy-mode cluster</code> the mapping file is shipped to the executors through <code>--files</code> and the loader receives only its base name, otherwise the path is passed through as written.</p><p>In this mode the loader reads FILE,  [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>3.2.5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migra [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>Query the imported data with Hubble or <code>curl</code>.</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-41 data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+The POM&rsquo;s Spark <code>3.2.2</code> dependency supplies compile-time APIs; it is not the runtime engine.
+Set <code>SPARK_HOME</code> and <code>JAVA_HOME</code>, then use the distribution&rsquo;s shaded Loader JAR with its launcher.</p><p>Create the schema first and make data files readable by the executors. CSV and TEXT inputs need headerless UTF-8 data and an explicit mapping <code>header</code>.
+Other charsets and <code>has_header: true</code> are rejected. Load vertex data before edge data when the edges depend on those vertices.
+Replace the mapping path below with your prepared vertex mapping.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>Pass Spark options such as <code>--master</code>, <code>--conf</code> and <code>--jars</code> to the launcher alongside Loader options.
+Additional JDBC drivers need explicit <code>--jars</code>; copying them into <code>lib/</code> does not distribute them to executors.
+Query the target graph to verify counts and properties; the API sink&rsquo;s insertion counters do not report distributed writes.</p><p>This path rejects <code>--incremental-mode true</code> and <code>--failure-mode true</code>. Standalone Spark supports client deployment only.
+HBase bulkload (<code>--sink-type false</code>) is unsupported on Spark 3.5.8 / Java 17; keep an existing bulkload deployment on its separately validated
+released Loader/JVM/Spark/HBase environment.
+For details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark migration guide</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-import-data-by-flink-cdc-loader>4.7 Import data by flink-cdc-loader</h4><p>The current <code>master</code> integration targets Flink <code>2.2.1</code>, MySQL CDC <code>3.6.0-2.2</code> and Java 17.
+Older examples using Flink 1.13.5 and CDC 2.2.1 belong to the previous implementation.
+Set <code>FLINK_HOME</code>; the submission JVM, JobManager and TaskManager must all use Java 17.
+Keep Flink&rsquo;s module-access options and exactly one shaded Loader JAR in the distribution&rsquo;s <code>lib/</code>.</p><p>Each mapping needs a MySQL JDBC input with <code>url</code>, <code>database</code>, <code>table</code>, <code>username</code> and <code>password</code>.
+Set MySQL <code>binlog_row_image=FULL</code>. UPDATE events require explicit, nonempty <code>update_strategies</code> and unchanged graph IDs;
+changes to vertex IDs, edge endpoints or sort keys are rejected. CDC also rejects <code>--dry-run true</code> and <code>--use-prefilter true</code>.</p><p>Without a separator, all arguments go to Loader. To set Flink options, put them before <code>--</code> and Loader options after it.
+For a prepared mapping at <code>mysql-cdc.json</code>, submit with one sink writer.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-lo [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>Each mapping uses a single source reader and sink writer. <code>--cdc-sink-parallelism</code> defaults to <code>1</code>; other values are rejected.
+After <code>--</code>, Loader&rsquo;s <code>-p</code> means the Server port. Checkpoint flushing does not provide transactional graph writes or an exactly-once guarantee.
+Validate edge CDC and broader mappings in your test environment before deploying to production.
+For more details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC documentation</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>3.2.5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migration tool when you need to back up, export, or move dat [...]
 See the <a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>official Source documentation</a>
 for parallel-scan backend requirements and configuration limits.</p><p>Before starting, complete the <a href=/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-prepare-the-environment>shared environment and configuration steps on the import page</a>. They cover JDK, HOCON, plugin installation, and the sample graph model.</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-migrate-a-hugegraph-graph-graph2graph>1 Migrate a HugeGraph graph (graph2graph)</h2><p>The following exa [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
@@ -1733,23 +1770,40 @@ for parallel-scan backend requirements and configuration limits.</p><p>Before st
 </span></span><span class=line><span class=ln>24</span><span class=cl>    <span class=n>path</span> <span class=o>=</span> <span class=s2>&#34;/tmp/hugegraph-export/${table_name}&#34;</span>
 </span></span><span class=line><span class=ln>25</span><span class=cl>    <span class=n>file_format_type</span> <span class=o>=</span> <span class=s2>&#34;json&#34;</span>
 </span></span><span class=line><span class=ln>26</span><span class=cl>  <span class=p>}</span>
-</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
+</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools ships inside the toolchain package, in a directory</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># whose version suffix is the same as the archive&#39;s</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. Download a released source package</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>Compile and generate tar package:</p><div class="td-code td-code--untitled" id=td-code-beb8 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>The package is generated as <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>, and the unpacked directory <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> (containing <code>bin/</code> and <code>lib/</code>) is created next to it.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-ho [...]
-For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-4-viewport data-td-code-viewport><div class=highli [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
+Each example ends in the generated Tools directory, where <code>bin/hugegraph help</code> lists the available commands.</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git tag" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git tag</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb85dde-fence-1-viewport data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="Source archive" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Source archive</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-beb85 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>The build also writes <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code> relative to the source root.</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 Build current source</h4><p>To use unreleased features from the master branch, build Tools from source (master is currently based on 1.8; require [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>Build matching Server SDK</strong></p><p>Run the script below to download Server source and install the SDK into an isolated Maven repository:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>See the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a> for details.</p></li><li><p><strong>Packa [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>Keep the SDK repository while using this source build. The master build directory does not contain <code>incubating</code>.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-how-to-use>3 How to use</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-function-overview>3.1 Function overview</h4><p>From the extracted or generated Tools directory, run [...]
+or <code>bin/hugegraph help &lt;sub-command></code> for one command. The commands cover these tasks.</p><ul><li>Graph management type, graph-mode-set, graph-mode-get, graph-list, graph-get, graph-clear, graph-create, graph-clone and graph-drop</li><li>Asynchronous task management type, task-list, task-get, task-delete, task-cancel and task-clear</li><li>Gremlin type, gremlin-execute and gremlin-schedule</li><li>Backup/Restore type, backup, restore, migrate, schedule-backup and dump</li>< [...]
+Supply both <code>--user</code> and <code>--password</code>, or omit both.</p></blockquote><p>Use <code>export</code> to set an option for the current shell and the commands launched from it.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Global Variable</th><th scope=col>Environment Variable</th><th scope=col>Example</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGR [...]
+For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-7-viewport data-td-code-viewport><div class=highli [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>Another way is to set the environment variable in the bin/hugegraph script:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-6-vi [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>You can also set these variables in <code>bin/hugegraph</code>.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-9-viewport data- [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -1758,10 +1812,15 @@ For an authenticated Server, also provide the username and password described ab
 </span></span><span class=line><span class=ln> 7</span><span class=cl>#export HUGEGRAPH_PASSWORD=
 </span></span><span class=line><span class=ln> 8</span><span class=cl>#export HUGEGRAPH_TIMEOUT=
 </span></span><span class=line><span class=ln> 9</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_FILE=
-</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
+</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
 restore requires the graph to be in RESTORING or MERGING mode (set it with graph-mode-set first), otherwise the command fails</p></blockquote></li><li>migrate, migrate the currently connected graph to another HugeGraphServer<ul><li>&ndash;target-graph, the name of the target graph, the default is hugegraph</li><li>&ndash;target-url, the HugeGraphServer where the target graph is located, the default is http://127.0.0.1:8081</li><li>&ndash;target-user, the username used to access the targe [...]
 To customize the format, implement a <code>Formatter</code> subclass such as <code>CustomFormatter</code> under <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code>, then select it when running the command:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+and do not support current HugeGraph Server or Hubble.
+For modern deployments, follow <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server Quick Start</a>
+and <a href=/docs/quickstart/toolchain/hugegraph-hubble/>Hubble Quick Start</a>.
+The options below are retained only for maintaining legacy environments.</p><ul><li>deploy, one-click download, install and start HugeGraph-Server and HugeGraph-Studio<ul><li>-v, required, specifies the HugeGraph-Server and HugeGraph-Studio version to install, must be one of the versions listed in bin/version-map.yaml (0.6, 0.7, 0.8, 0.9, 0.10), which maps it to the matching server and studio release versions</li><li>-p, required, specifies the installed HugeGraph-Server and HugeGraph-St [...]
+Later runs without <code>-u</code> reuse the saved URL. Without either setting, the script uses <code>https://github.com/hugegraph</code>.</p></blockquote><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--39-specific-command-parameters>3.9 Specific command parameters</h5><p>The help output below lists each subcommand and its options.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=410><div class=t [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -2170,26 +2229,26 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code_ [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># Execute gremlin asynchronously</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-11-viewport data-td-code- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-14-viewport data-td-code- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># recovery graph</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># restore graph mode</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-15-viewpo [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-18-viewpo [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
 </span></span><span class=line><span class=ln>3</span><span class=cl>mvn clean package -pl hugegraph-spark-connector -am -DskipTests -ntp</span></span></code></pre></div></div></div><h4 id=pg-7a8b9421800a2b76e91d76ba1eccb218--32-build-with-default-tests>3.2 Build with default tests</h4><div class="td-code td-code--untitled" id=td-code-add49e69-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-add49e69-fence-1-view [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
@@ -2403,23 +2462,85 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span><span class=line><span class=ln>10</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+<code>Graph Tools</code> needs no model. Document vectors require embeddings; graph extraction and answers also require an LLM.
+The reranker is optional. Start with the local <code>bleu</code> method.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Task</th><th scope=col>UI tab</th><th scope=col>Prerequisites</th></tr></thead><tbody><tr><td>Build indexes from documents</td><td><code>1. Build RAG Index</code></td><td>Documents and embeddings; graph extraction also needs a schema and LLM</td></tr><tr><td>Answer from documen [...]
+then restart. This preserves an existing file. The template has all 6 columns, with a test question and expected answer; the 4 model-answer columns stay empty.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-2e1ba1fa-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-configuration-panel>0. Configuration Panel</h2><p>Above the tabs sits a collapsible configuration panel with five sections: <code>1. Set up the HugeGraph server.</code>, <code>2. Set up the LLM.</code>, <code>3. Set up the Embedding.</code>, <code>4. Set up the Reranker.</code>, and < [...]
+The screenshots use local Ollama models <code>qwen2.5:3b</code> and <code>mxbai-embed-large</code>, with <code>Faiss</code> as the vector engine.
+Rebuild indexes after changing embedding models, since vector dimensions or meaning can differ.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-build-rag-indexes>1. Build RAG Indexes</h2><p>The first tab splits documents into a chunk vector index. It also extracts vertices and edges according to a schema, writes them to HugeGraph, and maintains a vertex vector index.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[Input document] --&gt; B[Split text]
     B --&gt; C[Generate chunk vectors]
     C --&gt; D[Write vector index]
     B --&gt; E[LLM extracts vertices and edges from schema]
     E --&gt; F[Write to HugeGraph]
-    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>Common operations are <code>Import into Vector</code>, <code>Extract Graph Data (1)</code>, <code>Load into GraphDB (2)</code>, and <code>Update Vid Embedding</code>. <code>Load into GraphDB (2)</code> also refreshes the [...]
+    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>For a first run, paste this short document into <code>Input Doc(s)</code>. Select a dedicated test graph before importing it.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-2 data-td-code data-td-cod [...]
+It allows people and roommate relationships, with optional age and occupation.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-3 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=16><div class=td-code__viewport id=td-code-2e1ba1fa-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln> 1</span><span class=cl><span class=p>{</span>
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Follow these steps to build the indexes. For vector-only retrieval, stop after step 1.</p><ol class=steps><li>Click <code>Import into Vector</code> to split the document and build the chunk vector index.</li><li>Enter schema JSON or an existing graph name in <code>Graph Schema</code>, then click <code>Extract Graph Data (1)</code>.
+Check the vertices, edges, and properties in <code>Output Info</code>.</li><li>Click <code>Load into GraphDB (2)</code> after checking the extraction. This writes to HugeGraph and refreshes vertex embeddings.</li><li>Open <code>Graph Tools</code>. Run <code>g.V().count()</code> and <code>g.E().count()</code>, then query the properties to confirm that the data was written.</li></ol><p>This example should produce 2 vertices and 1 edge, with Sarah&rsquo;s age set to <code>30</code> and occu [...]
+If the graph already contains data, use <code>Update Vid Embedding</code> to refresh its vertex index separately.
+The <code>Graph Extraction Split Type</code> dropdown selects <code>document</code>, <code>paragraph</code>, or <code>sentence</code>.
+<code>document</code> uses the whole input; the other options split it before extraction.</p><p>The page can also inspect or clear chunk indexes, vertex indexes, and graph data. Clearing removes existing data, so first confirm that the current graph and indexes are not still used by other queries.</p><p>Two collapsed helpers sit below the main controls:</p><ul><li><code>Graph Schema Generator</code> takes query examples and a few-shot example and produces a schema for the Graph Schema fi [...]
+vector search for more comprehensive fact retrieval. Other scopes are summarized in the table above.</p><p>The screenshots use these short prompts. Paste them into <code>Query Prompt</code> and <code>Keywords Extraction Prompt</code>, respectively.
+The service fills the placeholders. Keep the <code>KEYWORDS:</code> prefix and ASCII colons in keyword output, and preserve name capitalization.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><spa [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Context: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1< [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Return one line in this exact ASCII format: KEYWORDS:name:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {question}</span></span></code></pre></div></div></div><ol class=steps><li>Enter <code>Who is Sarah?</code>, set <code>Graph-only Answer</code> to <code>False</code>, and set <code>Graph-Vector Answer</code> to <code>True</code>.</li><li>Keep <code>Template Num=-1</code> and <code>Rerank method=bleu</code> for the first check, then click <code>Answer Question</code>.</li><li>Read <code>Graph-Vector Answer</cod [...]
     Q[Question] --&gt; V[Query chunk vector index]
     Q --&gt; K[Extract keywords]
     K --&gt; M[Match graph vertices]
-    M --&gt; T[Generate and execute Gremlin]
-    T --&gt;|Failure| B[Fallback to BFS graph traversal]
+    M --&gt; D{Text2Gremlin enabled}
+    D --&gt;|Yes| T[Generate and execute Gremlin]
+    D --&gt;|No| B[BFS graph traversal]
+    T --&gt;|Failure| B
     T --&gt; R[Prepare graph results]
     B --&gt; R
     V --&gt; S[Merge and rerank]
     R --&gt; S
-    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+The upper panel builds an example vector index from question and Gremlin pairs in <code>.json</code> or <code>.csv</code> files.
+When no file is uploaded, it uses <code>resources/demo/text2gremlin.csv</code>. Match example labels and properties to the current graph.</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>If building the example index does not automatically retrieve similar templates, you can provide few-shot examples directly  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-2e1ba1fa-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>For person-name lookups, use g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;name from question&gt;&#39;).valueMap().
+</span></span><span class=line><span class=ln> 3</span><span class=cl>Preserve name capitalization. Query by name; do not use vertex IDs.
+</span></span><span class=line><span class=ln> 4</span><span class=cl>Example question: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Example Gremlin: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>Graph schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>Additional examples: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>Known vertices: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>Question: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>Return only one ```gremlin``` code block.</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/en/text2gremlin.jpg alt="Generated Text2Gremlin queries and execution results" loading=lazy decoding=async></li></ul><p>A small model can generate incorrect IDs, change name capitalization, or use filters tha [...]
+Check the returned data before treating a query as successful. The Web UI executes generated queries directly, so use a dedicated test graph.
+To generate a query without executing it, select the corresponding output types in the <a href=/docs/quickstart/hugegraph-ai/rest-api/>REST API</a>.</p><p>A custom prompt must retain <code>{query}</code>, <code>{schema}</code>, <code>{example}</code>, and <code>{vertices}</code>. The REST API rejects it if any placeholder is missing.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-graph-and-administration-tools>4. Graph and Administration Tools</h2><p><code>Graph Tools</code> runs a Gre [...]
+Initializing demo data first clears the current graph. Use this action only on a dedicated test graph.</p><p><code>Admin Tools</code> is password protected. Entering the configured <code>ADMIN_TOKEN</code> reveals the tail of <code>logs/llm-server.log</code>, which refreshes every 60 seconds, along with buttons to refresh or clear it. Access is refused while <code>ADMIN_TOKEN</code> is empty or still set to the placeholder <code>xxxx</code>.</p><p>When <code>ENABLE_LOGIN=True</code>, the [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> is enabled by default, so running without arguments has the same effect. On first configuration-module import, missing <code>.env</code> and prompt YAML files are created from defaults. The generator asks interactively before overwriting existing files. It handles HugeGraph, administrator, LLM, index, an [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>The same choice is available in the <code>5. Set up the vector engine.</code> panel of the Web UI, which also persists the connection settings for the selected engine.</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--login-and-log-api>Login and Log API</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=reg [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
@@ -3042,18 +3163,21 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_endpoint</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;http://minio:9000&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_access_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-access-key&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_secret_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-secret-key&#34;</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker--master-configuration>5. Worker & Master Configuration</h3><p>Configuration for worker and master computation logic.</p><h4 id=pg-094fc5e6c5eaa81703 [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker--master-configuration>5. Worker & Master Configuration</h3><p>Configuration for worker and master computation logic.</p><h4 id=pg-094fc5e6c5eaa81703 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;artifactId&gt;</span>hugegraph-client<span class=nt>&lt;/artifactId&gt;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>        <span class=c>&lt;!-- The complete examples below work with the published 1.7.0 client --&gt;</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>    
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>The complete examples below use Schema, Graph, Gremlin and resource-cleanup APIs available in the published Client <code>1.7.0</code>
-and compatible with Toolchain <code>master</code>. Use the dependency above directly in your example project.</p><p>For new master APIs in the <a href=/docs/clients/hugegraph-client/>API reference</a>, such as capability detection, use Client <code>1.8.0</code>
-from Toolchain <code>master</code> and change the POM version to <code>1.8.0</code>. If that version is not published to Maven yet, run the following
-command from the Toolchain source root to install the Client and its parent POM locally. The source build still needs
-its dependencies available from your configured Maven repositories.</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-440b860c-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -Dskip [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>Choose the client version before building:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Use case</th><th scope=col>Client version</th><th scope=col>Java build target</th></tr></thead><tbody><tr><td>Run the complete examples below</td><t [...]
+The release&rsquo;s Java build target does not describe the runtime requirements of every transitive dependency.</p><p>To use unreleased features from the master branch, build Client from source (see <a href=/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools source build instructions</a>):</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>Both version checks must report JDK 17. Also pass <code>-Dmaven.repo.local="$candidate_dir/m2"</code> to Maven commands in projects using Client from master.
+Client and Server versions need not be identical; check the required APIs and compatibility before upgrading.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>Choose a single-record or batch example. Save the complete code as <code>src/main/java/SingleExample.java</code> or
+<code>src/main/java/BatchExample.java</code> in your Maven project. The copy button includes the folded lines.</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-440b860c-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea1298 [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -3201,7 +3325,7 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-440b860c-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=138><div class=td-code__viewport id=td-code-440b860c-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -3338,7 +3462,9 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>135</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><p>Before running Example, you need to start the Server. For the startup process, see<a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph-Server Quick Start</a>.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5  [...]
+</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><ol class=steps><li><a href=/docs/quickstart/hugegraph/hugegraph-server/>Start HugeGraph Server</a> and prepare a test graph named <code>hugegraph</code> in graphspace <code>DEFAULT</code>.</li><li>Set the Maven project&rsquo;s JDK to 17. In  [...]
+and <code>configUser(...)</code> with your settings. Omit <code>configUser(...)</code> if Server does not require authentication.</li><li>Run <code>SingleExample.main()</code> or <code>BatchExample.main()</code> in your IDE. Both examples create schema and graph data, print the results, and close the client.
+Use a test graph: existing schema or data can affect repeated runs.</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5 More Information About Client-API</h4><p>See<a href=/docs/clients/hugegraph-client/>Introduce basic API of HugeGraph-Client</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>3.5.2 - HugeGraph Python Client Quick Start</h [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># Alternatively: pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>These commands do not pin a version and install the latest release; see <a href=https://pypi.org/project/hugegraph-python/>PyPI</a>. The source directory is <code>hugegraph-python-client</code>, while the distribution is <code>hugegraph-python</code>. Install from the HugeGraph-AI workspace for master code. [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
@@ -3664,20 +3790,29 @@ see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start t
 <code>raft.mode=true</code>, and <code>raft.group_peers</code> is read from <code>rest-server.properties</code> instead of the graph file.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>config option</th><th scope=col>default value</th><th scope=col>description</th></tr></thead><tbody><tr><td>raft.mode</td><td>false</td><td>Whether the backend storage works in raft mode.</td [...]
 Starting with HugeGraph 1.8.0.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Config option</th><th scope=col>Default value</th><th scope=col>Description</th></tr></thead><tbody><tr><td>arthas.telnet_port</td><td>8562</td><td>Arthas telnet port for administrator activation through <code>PUT /arthas</code>.</td></tr><tr><td>arthas.http_port</td><td>8561</td><td>Arthas HTTP po [...]
 The bundled <code>bin/arthas.sh</code> provides local diagnostics without changing configuration. For activation workflows, permissions, and authentication options,
-see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start the Arthas agent</a>.</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server Config Options</strong></span></div><div class=td-callout__body><p>Corresponding configuration file <code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll--static"  [...]
-which supports multi-user authentication and fine-grained access control. It adopts a 4-layer design based on &ldquo;User-UserGroup-Operation-Resource&rdquo; to
-flexibly control user roles and permissions (supports multiple GraphServers).</p><p>Some key designs of the <code>StandardAuthenticator</code> mode include:</p><ul><li>During initialization, a super administrator (<code>admin</code>) user is created. Subsequently, other users can be created by the super administrator. Once newly created users are assigned sufficient permissions, they can create or manage more users.</li><li>It supports dynamic creation of users, user groups, and resource [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+see <a href=/docs/clients/restful-api/other/#1116-start-the-arthas-agent>Start the Arthas agent</a>.</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server Config Options</strong></span></div><div class=td-callout__body><p>Corresponding configuration file <code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll--static"  [...]
+Users receive read, write, delete, and execute permissions through their groups.</p><p>A resource describes accessible data using <code>type</code>, <code>label</code>, and <code>properties</code>. Conditions within one resource are combined with AND; multiple resources are
+combined with OR.</p><p>This relationship grants a user read access to data for Beijing.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-0 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=ln>1</span><span class=cl><span class=c1>// Scen [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+maintain the Server IP allowlist, and grant minimum permissions. Do not expose Gremlin, Cypher, or other query endpoints directly to the public network.
+Standard Server configuration writes authentication-proxy audit records to <code>audit-*.log</code>; retain these files and restrict read access. <code>auth.audit_log_rate</code>
+limits per-user output rather than serving as a dedicated audit-log on/off switch.</p></div></div><p>Use <code>StandardAuthenticator</code> for built-in access control, or implement <code>HugeAuthenticator</code> to connect an existing identity system.</p><p>HugeGraph uses <a href=https://en.wikipedia.org/wiki/Basic_access_authentication>HTTP Basic Authentication</a>. The value after
 <code>Basic</code> is the Base64 encoding of <code>username:password</code>. With curl, pass the credentials directly through <code>-u</code>:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span  [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>Protect Basic Authentication credenti [...]
-The source-code default generates 32 random bytes encoded as Base64, but does not write the value back to the file. Independently generated defaults cannot remain consistent across restarts or Server nodes. To preserve existing tokens across restarts or validate the same token on multiple nodes, explicitly configure the same strong random secret in each authentication graph configuration.</p><p>Server encodes this string as UTF-8 for JJWT&rsquo;s HS256 signer, which requires at least 32  [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;locally-generated-secret&gt;</span></span></span></code></pre></div></div></div><p>Generate the secret locally and transfer it securely into the authentication graph configuration. Do not commit the actual secret or expose it in public logs:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-3 data-td-code data-td-code-auto-i [...]
-implementation authenticates users based on their names and passwords (encrypted) stored in the database and controls user permissions based on their
-roles. Below is the specific configuration process (requires service restart):</p><p>Configure the <code>authenticator</code> and its <code>rest-server</code> file path in the <code>gremlin-server.yaml</code> configuration file:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=5><div class=td-code__viewport id=td-code-c11d92dd-fence-4-viewport data-td-code-viewport><div class=highlight><pre ta [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>Protect Basic Authentication credenti [...]
+configuration</a>.</p></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p><strong>JWT risks in older versions</strong></p><p>HugeGraph-Server versions before 1.5.0 have JWT-related security risks in Auth mode. Upgrade affected versions or change the JWT <code>secretKey</code> according [...]
+version&rsquo;s requirements.</p></div></div><p><code>auth.token_secret</code> is read from the authentication graph&rsquo;s configuration. The default graph is <code>hugegraph</code>, so its file is normally
+<code>conf/graphs/hugegraph.properties</code>; if <code>auth.graph_store</code> changes, use that graph&rsquo;s properties file.
+The core configuration defaults to 32 random bytes encoded as Base64 and does not write that default back to the file. Independently generated defaults cannot
+remain consistent across restarts or Server nodes. To preserve existing tokens across restarts or validate the same token on multiple nodes, explicitly
+configure the same strong random secret in each authentication graph configuration.</p><p>Server encodes this string as UTF-8 for JJWT&rsquo;s HS256 signer, which requires at least 32 bytes. This is a byte-length requirement; an arbitrary 32-character
+string need not have sufficient randomness. The command below generates 32 random bytes and Base64-encodes them locally.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span clas [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;locally-generated-secret&gt;</span></span></span></code></pre></div></div></div><p>Generate the secret locally and transfer it securely into the authentication graph configuration. Do not commit the actual secret or expose it in public logs:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-3 data-td-code data-td-code-auto-i [...]
+<code>rest-server.properties</code> do not override that graph configuration.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-mode>StandardAuthenticator Mode</h4><p><code>StandardAuthenticator</code> stores users and password hashes in the backend and checks access by role.
+After updating these three configurations, <a href=#pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>initialize authentication and restart Server</a>.</p><p>Set the authenticator and REST configuration path in <code>conf/gremlin-server.yaml</code>.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=5><div class=td-code__viewport id=td-code-c11d92dd-fence-4-viewport data-td-code [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>authenticator</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.StandardAuthenticator,</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>authenticationHandler</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.WsAndHttpBasicAuthHandler,</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=nt>tokens</span><span class=p>:</span><span class=w> </span><span class=l>conf/rest-server.properties}</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>Configure the authenticator and the graph that stores authorization data in <code>rest-server.properties</code>:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-c11d92dd-fence-5-viewport data-td-code-viewport><div class=hi [...]
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>Set the authenticator and authentication graph in <code>conf/rest-server.properties</code>.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-c11d92dd-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.graph_store</span><span class=o>=</span><span class=s>hugegraph</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Used when Server first creates admin; replace public default pa with a strong password in production</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># For local persistent backends, init-store.sh prompts for a password when StandardAuthenticator is first initialized</span>
@@ -3685,28 +3820,53 @@ roles. Below is the specific configuration process (requires service restart):</
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># Auth Client Config</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl><span class=c1># If GraphServer and AuthServer are deployed separately, you also need to specify the following configuration. Fill in the IP:RPC port of AuthServer.</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1># auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p>In the above configuration, the <code>graph_store</code> option specifies which graph to use for storing user information. If there are multiple graphs, you can choose any of them.</p><p>In the <code>hugegraph{n}.properties</code> configuration file, configure the <code>gremlin.graph</code> [...]
-Simply implement the <code>org.apache.hugegraph.auth.HugeAuthenticator</code> interface with your custom authenticator,
-and then modify the <code>authenticator</code> configuration item in the configuration file to point to your implementation.</p><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</h3><p>When <code>init-store.sh</code> is run for the first time and the <code>admin</code> user does not yet exist, the command prompts for the
-administrator password. For an initialized persistent backend, <code>init-store.sh</code> adds the system metadata required for
-authentication without deleting existing graph data.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-c11d92dd-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=c1># stop the hugeGraph firstly</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl>bin/stop-hugegraph.sh
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># Initialize authentication system metadata; existing backend data is preserved</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>bin/init-store.sh
-</span></span><span class=line><span class=ln>6</span><span class=cl>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># start hugeGraph again</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hugegraph.sh</span></span></code></pre></div></div></div><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--use-docker-to-enable-authentication-mode>Use docker to enable authentication mode</h3><p>For versions of the hugegraph/hugegraph image equal to or greater than 1.2.0, you can enable authentication mode while starting the Docker image.</p><p>The steps are as follows:</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>hugegraph/hugegraph:1.7.0</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>      </span>- <span class=m>8080</span><span class=p>:</span><span class=m>8080</span><span class=w>
-</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>9</span><span class=cl><span class=w>      </span>- <span class=l>PASSWORD=xxx</span></span></span></code></pre></div></div></div><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>3. Enter the container to enable authentication mode</h4><p>Enter the container first:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-10 data-td-code data-td-code-auto-id data-td-language=bash [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># Modify the config quickly, the modified file are save in the conf-bak folder</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>Then follow <a href=#pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</a></p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4.4 - Configuring HugeGraphServer to Use HTTPS Protocol</h1><template data-hg-au [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1># auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p><code>auth.graph_store</code> names the graph that stores authentication data. It must match a graph configuration in <code>conf/graphs/</code>.</p><p>Set <code>gremlin.graph</code> in <code>conf/graphs/&lt;graph>.properties</code> for each protected graph.</p><div class="td-code td-code--u [...]
+system.</p><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--switching-authentication-mode>Switching authentication mode</h3><p>Use this sequence for a local persistent backend such as RocksDB, after applying the configuration above.
+HStore/PD deployments create the administrator through the PD startup path. Set <code>auth.admin_pa</code> for that deployment instead of using local interactive
+initialization.</p><ol class=steps><li><p><strong>Stop Server.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-c11d92dd-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/stop-hugegraph.sh</span></span></co [...]
+password.
+Keep the existing storage directory.</p></li><li><p><strong>Start Server and check authentication.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-c11d92dd-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>curl -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>curl prompts for the password. Correct credentials should return HTTP 200; missing or incorrect credentials should return HTTP 401.
+If startup fails, check the logs and authentication graph configuration before retrying.</p></li></ol><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--enable-authentication-with-docker>Enable authentication with Docker</h3><p>For a new container, choose either Docker run or Docker Compose. For an existing container, see
+<a href=#pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>enabling authentication in existing containers</a>.</p><p>When deploying with Docker, the official image supports enabling authentication
+directly via environment variables (applicable to the official <code>/hugegraph-server</code> layout).
+Replace the placeholder below with your image tag or digest:</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-c11d92dd-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>HUGE [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>read</span> -r -s -p <span class=s1>&#39;Admin password: &#39;</span> PASSWORD
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>printf</span> <span class=s1>&#39;\n&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>export</span> PASSWORD</span></span></code></pre></div></div></div><p>Execute the command and enter a strong administrator password when prompted. Avoid committing plaintext passwords into shared Compose files.
+Persist the JWT secret in the authentication graph configuration as described <a href=#pg-7d189549d4201521c83e0d93a2474a2d--configure-user-authentication>above</a>. Use the same value across all nodes.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-use-docker-run>Docker run</h4><p>Create a new container and publish its REST port only on the local host.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td- [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -p 127.0.0.1:8080:8080 <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  -e PASSWORD <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUGEGRAPH_IMAGE</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>The entrypoint configures authentication, initializes the backend on first startup, and starts Server.
+Continue with <a href=#pg-7d189549d4201521c83e0d93a2474a2d--check-authentication>checking authentication</a>.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--2-use-docker-compose>Docker Compose</h4><p>Save the following as <code>compose.yaml</code>. Compose rejects missing required variables to avoid starting an unauthenticated service by accident.
+Start the service in the same terminal.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-12 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-c11d92dd-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>      </span>- <span class=s2>&#34;127.0.0.1:8080:8080&#34;</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>      </span><span class=nt>PASSWORD</span><span class=p>:</span><span class=w> </span><span class=l>${PASSWORD:?Set PASSWORD}</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-13-viewport data-td-code [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>Set these variables again before recreating the container. Retain its data volumes and persist the configuration required by your deployment.
+Continue with <a href=#pg-7d189549d4201521c83e0d93a2474a2d--check-authentication>checking authentication</a>.</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-enter-the-container-to-enable-authentication-mode>Existing containers</h4><p>Use this path for an official Server container that ran without authentication and uses a local persistent backend.
+Back up its data first. Confirm that the configuration, backend data, and <code>conf-bak</code> are all in mounted persistent volumes.
+The official image declares <code>/hugegraph-server</code> as a volume; inspect the mounts of custom images first.
+HStore/PD and external authentication services use their own administrator initialization paths.</p><ol class=steps><li><p><strong>Stop the original container and open a maintenance container with the same image and volumes.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-c11d92dd-fence-14-viewport data-td-code-viewport><div class=highlight> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>docker stop server
+</span></span><span class=line><span class=ln>3</span><span class=cl>docker run --rm -it --volumes-from server <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --entrypoint bash <span class=s2>&#34;</span><span class=nv>$SERVER_IMAGE</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>Keep the original container stopped so two JVMs do not open the local database at once. <code>--entrypoint bash</code> opens a shell without starting Server.</p></li><li><p><strong>Configure authentication and initialize it inside the maintenance container.</ [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>On its first run, <code>enable-auth.sh</code> saves the original configuration in <code>conf-bak</code> and updates authentication and the default <code>hugegraph</code> graph.
+If <code>conf-bak</code> already exists, the script skips its changes. Check all three configurations under <a href=#pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-mode>StandardAuthenticator mode</a>.
+Configure other authentication graphs manually.
+Write a strong random JWT secret to the authentication graph configuration as described <a href=#pg-7d189549d4201521c83e0d93a2474a2d--configure-user-authentication>above</a>, then initialize it.</p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-16 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c11d92dd-fence-16-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code clas [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>exit</span></span></code></pre></div></div></div><p>Enter the administrator password when prompted, then exit after initialization succeeds.</p></li><li><p><strong>Start the original container from the host.</strong></p><div class="td-code td-code--untitled" id=td-code-c11d92dd-fence-17 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-c11d92dd-fence-17- [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+</span></span><span class=line><span class=ln>3</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>Requests without credentials should return <code>401 Unauthorized</code>, while requests with the correct password return <code>200 OK</code> (incorrect passwords also return <code>401</code>).
+Note: Current master URLs include <code>/graphspaces/DEFAULT</code>; for 1.7.0 and older versions, omit the graphspace prefix (use <code>/graphs/hugegraph/...</code> directly).
+If unauthenticated requests still return <code>200</code>, authentication is not active; inspect configuration and restart Server.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4.4 - Configuring HugeGraphServer to Use HTTPS Protocol</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1fe5a73f419--overview>Overview</h3><p>HugeGraphServer uses HTTP [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>restserver.url</span><span class=o>=</span><span class=s>https://127.0.0.1:8080</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Server keystore file path. This default value is automatically effective when using HTTPS, and you can modify it as needed.</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>ssl.keystore_file</span><span class=o>=</span><span class=s>conf/hugegraph-server.keystore</span>
@@ -9337,36 +9497,28 @@ First add the indexed properties below; <code>id</code> is a business property,
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>1</span><span class=o>&gt;&gt;</span><span class=nl>S1:</span><span class=n>vadas</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>knows</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>peter</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>peter</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
-</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>For more Gremlin statements, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-mode>2 Client/Server mode</h3><p>Gremlin Console connects to HugeGraph Server through WebSocket. The default configuration [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># ......</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>channelizer</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># ......</span></span></span></code></pre></div></div></div><p>Confirm that <code>host</code> and <code>port</code> match the settings in <code>remote.yaml</code>, and then follow the <a href=/docs/quickstart/hugegraph/hugegraph-server/>steps</a> to start HugeGraph Server.</p><p>Then enter Gremlin-Console:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-4 data-td-code data-td-cod [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>
-</span></span><span class=line><span class=ln>3</span><span class=cl>         <span class=se>\,</span>,,/
-</span></span><span class=line><span class=ln>4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>-----oOOo-<span class=o>(</span>3<span class=o>)</span>-oOOo-----
-</span></span><span class=line><span class=ln>6</span><span class=cl>plugin activated: HugeGraph
-</span></span><span class=line><span class=ln>7</span><span class=cl>plugin activated: tinkerpop.server
-</span></span><span class=line><span class=ln>8</span><span class=cl>plugin activated: tinkerpop.utilities
-</span></span><span class=line><span class=ln>9</span><span class=cl>plugin activated: tinkerpop.tinkergraph</span></span></code></pre></div></div></div><p>To connect to the server, you need to specify the connection parameters in the configuration file, and there is a default <code>remote.yaml</code> file in the conf directory</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-5 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=10><div class=td- [...]
-</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=p>,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>  </span>}<span class=w>
-</span></span></span><span class=line><span class=ln>10</span><span class=cl>}</span></span></code></pre></div></div></div><p>If the Server runs in auth mode, add the credentials to the same file:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-6 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2><div class=td-code__viewport id=td-code-8087517a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code clas [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=l>pa</span></span></span></code></pre></div></div></div><p>The <code>conf</code> directory also ships <code>remote-objects.yaml</code> and <code>gremlin-driver-settings.yaml</code>, which carry the same host, port, and serializer settings.</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-7 data-td-code data-td [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>==&gt;Configured localhost/</span><span class=mf>127.0</span><span class=o>.</span><span class=mf>0.1</span><span class=o>:</span><span class=mi>8182</span></span></span></code></pre></div></div></div><p>Server-side graphs are bound under a graphspace-qualified name, so the graph <code>hugegraph</code> in graphspace <code>DEFAULT</code> is bound as <code>DEFAULT-hugegraph</code> and its traversal so [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>();</span> <span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div><blockquote><p>NOTE: In Client/Server mode, all operations related to the Server should be prefixed with <code>:> </code>.  [...]
+</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>For more Gremlin statements, please refer to <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop Official Website</a></p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-mode>2 Client/Server mode</h3><p>Gremlin Console connects to HugeGraph Server through WebSocket. Use the Console and <code [...]
+Keep the serializer settings from that file; change only the address and, if authentication is enabled, credentials.
+Older configuration files may reference serializer classes that no longer exist.</p><ol class=steps><li><p>Prepare the connection configuration and start Server.</p><p>Check the <code>host</code> and <code>port</code> in <code>conf/gremlin-server.yaml</code>. The default <code>WsAndHttpChannelizer</code> handles both WebSocket and HTTP requests;
+it does not need to be changed. In <code>conf/remote.yaml</code>, <code>hosts</code> must contain the Server address reachable from the Console,
+and <code>port</code> must match the Gremlin port (default <code>8182</code>, not the REST port <code>8080</code>).
+Start Server following the <a href=/docs/quickstart/hugegraph/hugegraph-server/>quick start</a>.</p><p>The current master configuration uses GraphBinary V1 with HugeGraph&rsquo;s type registry:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-3 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-8087517a-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=l [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div><p>If Server requires authentication, add your actual credentials to the same file:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-4 data-td-code data-td-code-a [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;replace-with-your-password&#34;</span></span></span></code></pre></div></div></div><p>The bundled <code>remote-objects.yaml</code> and <code>gremlin-driver-settings.yaml</code> use the same serializer settings. Keep them aligned if you use them.</p></li><li><p>Start Console from the Server distribution directory and crea [...]
+Because hyphens are invalid in Groovy variable names, use <code>.alias(['g': '__g_DEFAULT-hugegraph'])</code> to map it to <code>g</code> when creating the driver client:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-8087517a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-l [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span></span></span></code></pre></div></div></div></li><li><p>Submit queries through the cli [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span></span></span></code></pre></div></div></div><p>Both return <code>6</code> i [...]
+When submitting scripts via <code>client.submit()</code>, no <code>:></code> prefix is needed.</p></li><li><p>Close the client and cluster when finished.</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-8 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=2><div class=td-code__viewport id=td-code-8087517a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div></li></ol><p>Alternatively, you can connect using Gremlin Console&rsquo;s built-in <code>:remote</code> command:</p><div class="td-code td-code--untitled" id=td-code-8087517a-fence-9 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-co [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>/</span><span class=o>/</span> <span class=n>Use</span> <span class=o>:&gt;</span> <span class=k>as</span> <span class=n>a</span> <span class=n>prefix</span> <span class=n>when</span> <span class=n>submitting</span> <span class=n>scripts</span> <span class=n>through</span> <span class=n>the</span> <span class=n>Console</span> <span class=n>remote</span> <span class=n>connection</span><span class=o>.</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>close</span></span></span></code></pre></div></div></div><p>When connected with <code>:remote</code>, expressions prefixed with <code>:></code> are sent to the remote Server, while normal expressions execute locally in Console.</p><p>For more information, see the <a href=https://tinkerpop.apache.org/docs/current/reference/#gremlin-console>TinkerPop Gremlin  [...]
   Apps[&#34;Applications / Operations&#34;] --&gt; Toolchain[&#34;Toolchain&#34;] --&gt; Server[&#34;Server REST API&#34;]
   AI[&#34;AI&#34;] -. REST .-&gt; Server
   Computer[&#34;Computer&#34;] -. REST .-&gt; Server
@@ -9883,10 +10035,42 @@ target directory. Copy the Jar package to the <code>plugins</code> directory whe
 </span></span><span class=line><span class=ln>11</span><span class=cl>hubble-dist/assembly/travis/verify-hubble-issue-694.sh <span class=se>\
 </span></span></span><span class=line><span class=ln>12</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUBBLE_TARBALL</span><span class=s2>&#34;</span> http://127.0.0.1:8080</span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--44-hugegraph-spark-connector>4.4 hugegraph-spark-connector</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--compile-3>Compile</h4><div class="td-code td-code--untitled" id=td-code-d1c060c1-fence-18 data-td-code d [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--45-hugegraph-tools>4.5 hugegraph-tools</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--compile-4>Compile</h4><div class="td-code td-code--untitled" id=td-code-d1c060c1-fence-20 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-coun [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-common-issues>5. Common Issues</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--service-connection-issues>Service Connection Issues</h3><p>If Server, MySQL, or Hadoop cannot be reached:</p><ul><li>Confirm se [...]
-Merging mode as needed, and when the Restore is completed, restore the graph mode to None.</p><p>The implemented RESTful API for setting graph mode is as follows:</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--view-the-mode-of-a-graph>View the mode of a graph</h5><p>When authentication is enabled, graph read permission is required (<code>space_member</code> or the graph owner).</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># Requires Server running</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-common-issues>5. Common Issues</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--service-connection-issues>Service Connection Issues</h3><p>If Server, MySQL, or Hadoop cannot be reached:</p><ul><li>Confirm se [...]
+These <a href=/docs/quickstart/toolchain/hugegraph-tools/>HugeGraph-Tools</a> commands support migration, recovery after an upgrade, and graph merging.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup>Backup</h4><p>Backup runs in any graph mode. Pausing source writes before exporting is recommended to keep schema, vertices, and edges consistent
+(paginated read APIs do not provide a global transactional snapshot).
+Note: <code>backup -t all</code> only exports schema and graph data, excluding deployment configurations and user permissions.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore>Restore</h4><p>Before restoring data, switch the target graph to the appropriate mode.
+Normal read/write operations use <code>NONE</code> mode; note that <code>LOADING</code> mode cannot be used for <code>restore</code>.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Target</th><th scope=col>Mode</th><th scope=col>Schema IDs</th><th scope=col>Vertex and edge IDs</th></tr></thead><tbody><tr><td>New graph without schema or data</td><td><code>RESTORING</code></td><td>Use IDs from the [...]
+It retains <code>AUTOMATIC</code> and custom vertex IDs. The merge reuses schema with matching names.
+Check that their definitions are compatible and that retained vertex IDs do not conflict.
+It does not resolve arbitrary schema or data conflicts. Test on a separate target before merging production data.</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--instructions>Instructions</h2><p>Prepare <a href=/docs/quickstart/toolchain/hugegraph-tools/>HugeGraph-Tools</a> compatible with your Server version, then run the commands from the Tools root directory.
+This example restores a source graph on port <code>8080</code> to an empty target on port <code>8081</code>.
+Both Servers and the target graph must already exist and be running. Adjust the addresses and graph names for your deployment.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-274df940-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>TARGET_URL</span><span class=o>=</span>http://127.0.0.1:8081
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>SOURCE_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nv>TARGET_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nv>BACKUP_DIR</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$PWD</span><span class=s2>/data/hugegraph-backup&#34;</span></span></span></code></pre></div></div></div><p>With authentication enabled, add <code>--user &lt;user> --password &lt;password></code> before the subcommand in each Tools command.
+The account needs the relevant graph access and graph-mode management permissions.
+See the <a href=/docs/quickstart/toolchain/hugegraph-tools/>Tools reference</a> for connection and credential options.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-1>Backup</h4><p>Pause source writes, then export all schema, vertices, and edges.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-274df940-fence-1-viewport data-td-code-viewport><d [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  backup -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>An explicit <code>-d</code> is the backup directory itself; the graph name is not appended. Use a separate directory for each backup to avoid mixing old files.
+Retain the complete directory, including compressed files. Restore reads the JSON backup formats supported by Tools.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-1>Restore</h4><p>This sequence uses <code>RESTORING</code>. To merge, use <code>MERGING</code> after the compatibility checks above.
+Pause application writes to the target during maintenance.</p><ol class=steps><li><p><span id=step-1-view-and-set-graph-mode></span><strong>Record the original mode, then switch it.</strong></p><div class="td-code td-code--untitled" id=td-code-274df940-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-274df940-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>ORIGINAL_MODE</span><span class=o>=</span>NONE
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  graph-mode-set -m RESTORING</span></span></code></pre></div></div></div><p>A graph in normal use should be in <code>NONE</code> mode. Set <code>ORIGINAL_MODE</code> to the value returned by the query, such as <code>NONE</code> below.
+If another task is using <code>RESTORING</code>, <code>MERGING</code>, or <code>LOADING</code>, coordinate with that task before changing its mode.</p></li><li><p><span id=step-2-restore-data></span><strong>Restore the data.</strong></p><div class="td-code td-code--untitled" id=td-code-274df940-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-274df940-fence-3-viewport data-td-code-viewport><div class=highlight><p [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  restore -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>Check command output and the restore results for each type. On failure, retain the backup directory and logs to inspect target state.
+Restore does not automatically roll back committed writes; do not re-run on a partially restored graph without inspection.</p></li><li><p><span id=step-3-restoring-graph-mode></span><strong>Restore the original mode.</strong></p><p>Reset the mode using <code>ORIGINAL_MODE</code>, recorded in the first step.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> graph-mode-get</span></span></code></pre></div></div></div><p>Regardless of whether restore succeeds or fails, always restore the graph mode back to its original state (usually <code>NONE</code>).
+On failure, preserve the logs and state, and re-prepare the target graph before resuming business writes.</p></li></ol><p>After resetting the mode, compare vertex and edge counts on both graphs.</p><div class="td-code td-code--untitled" id=td-code-274df940-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-274df940-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span></span></span></code></pre></div></div></div><p>Each pair of counts should match exactly. We also recommend using the <a href=/docs/clients/restful [...]
+and sampling vertex and edge properties and endpoints to ensure complete data integrity.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--help>Help</h4><p>For additional options on compression, concurrency, and selective type backup, see the <a href=/docs/quickstart/toolchain/hugegraph-tools/>Tools reference</a>.
+Before performing cross-major-version restores, verify backup file compatibility in a test environment first.</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--api-description-for-backuprestore-usage-and-implementation>API description for Backup/Restore usage and implementation</h2><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-2>Backup</h4><p>Backup exports data through the schema, vertex, and edge list GET APIs.</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-2>Restore</h4><p>R [...]
+<code>RESTORING</code> accepts schema IDs; <code>MERGING</code> does not. Both accept retained <code>AUTOMATIC</code> vertex IDs.
+Normal <code>NONE</code> mode does not accept these ID settings required for restore.</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--view-the-mode-of-a-graph>View the mode of a graph</h5><p>When authentication is enabled, graph read permission is required (<code>space_member</code> or the graph owner).</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-274df940-fence-6 data-td-code data-td-code-auto-id data-td-lan [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;NONE&#34;</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><blockquote><p>Legal graph modes include: NONE, RESTORING, MERGING, LOADING</p></blockquote><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--set-the-mode-of-a-graph>Set the mode of a graph</h5><p>When authentication is enabled, graph-space management permission (<code>space</code>) is required; administrators can satisfy it through permission inheritance.</p> [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Valid graph modes are <code>NONE</code>, <code>RESTORING</code>, <code>MERGING</code>, and <code>LOADING</code>.</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--set-the-mode-of-a-graph>Set the mode of a graph</h5><p>When authentication is enabled, graph-space management permission (<code>space</code>) is required; administrators can satisfy it through  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;RESTORING&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3>6.6 - HugeGraph Docker Cluster Guide</h1><template data-hg-authored-content=start></template><h2 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--overview>Overview</h2><p>Docker Compose provides a quick way to run [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>HUGEGRAPH_AUTH_TOKEN_SECRET</span><span class=o>=</span><span class=s1>&#39;&lt;32 random bytes, e.g. openssl rand -hex 32&gt;&#39;</span>
@@ -9975,19 +10159,31 @@ A startup deadline failure or Java exiting with <code>0</code> before readiness
 an early nonzero Java exit keeps its status. The deadline excludes earlier storage initialization and backend readiness waits.
 Readiness and partition checks remain interruptible during shutdown. A deadline failure requests termination and returns without an indefinite wait;
 an unresponsive Java process relies on container termination for final cleanup.</p><p>For example, from the HugeGraph repository&rsquo;s <code>docker/</code> directory, extend the standalone Server wait to 300 seconds (Compose passes this variable to the container):</p><div class="td-code td-code--untitled" id=td-code-c193a316-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-c193a316-fence-11-viewport data-td-co [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>This setting is independent of Docker health-check <code>start_period</code>, <code>interval</code>, <code>timeout</code>, and <code>retries</code>. Those determine when a container becomes <code>unhealthy</code>; extending health-check grace periods does not extend the startup script deadline. Adjusting this variab [...]
-<code>graphs</code> in <code>conf/rest-server.properties</code>. <code>graph.load_from_local_config</code> defaults to <code>false</code> and controls constructor preloading, not whether startup loads
-local graphs. Give each local graph its own configuration file and restart Server after changing it. See the
-<a href=/docs/config/config-guide/>Server configuration guide</a>.</p></li><li><p>After the service starts successfully, garbled characters are returned when using <code>curl</code> to query all vertices</p><p>The batch vertices/edges returned by the server are compressed (gzip), and can be redirected to <code>gunzip</code> for decompression (<code>curl http://example | gunzip</code>), or can be sent with the <code>postman</code> of <code>Firefox</code> or the <code>restlet</code> plug-i [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>------------------| -------------
-</span></span><span class=line><span class=ln> 3</span><span class=cl>+                 | %2B
-</span></span><span class=line><span class=ln> 4</span><span class=cl>space             | %20
-</span></span><span class=line><span class=ln> 5</span><span class=cl>/                 | %2F
-</span></span><span class=line><span class=ln> 6</span><span class=cl>?                 | %3F
-</span></span><span class=line><span class=ln> 7</span><span class=cl>%                 | %25
-</span></span><span class=line><span class=ln> 8</span><span class=cl>#                 | %23
-</span></span><span class=line><span class=ln> 9</span><span class=cl>&amp;                 | %26
-</span></span><span class=line><span class=ln>10</span><span class=cl>=                 | %3D</span></span></code></pre></div></div></div></li><li><p>Timeout when querying vertices or edges of a certain category (<code>query by label</code>)</p><p>Since the amount of data belonging to a certain label may be relatively large, please add a limit limit.</p></li><li><p>It is possible to operate the graph through the <code>RESTful API</code>, but when sending <code>Gremlin</code> statements,  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>This setting is independent of Docker health-check <code>start_period</code>, <code>interval</code>, <code>timeout</code>, and <code>retries</code>. Those determine when a container becomes <code>unhealthy</code>; extending health-check grace periods does not extend the startup script deadline. Adjusting this variab [...]
+performance. When data volume is large (TB to PB scale) or requires horizontal scalability and multi-replica high availability, deploy an
+<strong>HStore distributed cluster</strong> (PD + Store + Server).</p><p>Version 1.7.0 supports RocksDB, HStore, HBase, and Memory. Legacy backends such as Cassandra, ScyllaDB, MySQL, and PostgreSQL require a
+version earlier than 1.7.0. See the <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server quick start</a> for deployment steps.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--core-dump>Investigate a core dump at startup</h3><p>First, run <code>java -version</code> to confirm your JDK version: <strong>HugeGraph master (1.8 baseline) requires Java 17</strong>, and <strong>1.7.0 requires Java 11</strong> (Java 8 is no longer supported). If the JDK version is correct, inspect the Serve [...]
+architecture mismatches, missing native libraries (such as RocksDB JNI), or insufficient system memory.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--initialize-backend>Which backends need init-store</h3><p>When using local persistent backends like RocksDB or HBase, <strong>you must run <code>bin/init-store.sh</code> before the first startup</strong>. Memory (in-memory
+backend) and HStore (distributed backend) do not use this script; HStore storage is managed directly by PD and Store.</p><p>Note: The <code>backend</code> and <code>serializer</code> settings must match (for example, RocksDB requires <code>binary</code>). If the service starts but reports that
+the backend is disconnected, verify initialization and backend connection settings first.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--native-library>Resolve a missing GLIBCXX version during init-store</h3><p>The following error indicates that the host system&rsquo;s <code>libstdc++</code> version is too old and lacks symbols required by the RocksDB JNI native library:</p><div class="td-code td-code--untitled" id=td-code-d5b2f53b-fence-0 data-td-code data-td-code-auto-id data-td-langua [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>.../libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found</span></span></code></pre></div></div></div><p>To resolve: Upgrade the system&rsquo;s <code>libstdc++</code> (or install a newer GCC runtime), or run HugeGraph using the official Docker image.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--start-script>Which Server startup script should I use</h3><p>Current releases uniformly use <code>bin/start-hugegraph.sh</co [...]
+<code>start-restserver.sh</code> and <code>start-gremlinserver.sh</code> scripts from older documentation are deprecated.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--load-graphs>Which graphs does the startup script load</h3><p>The script name has no relation to the graph name. Server scans and loads all graph configurations in <code>conf/graphs</code> by default (this
+directory can be customized via <code>graphs</code> in <code>conf/rest-server.properties</code>). Each local graph uses an independent configuration file; restart
+Server after editing configurations.</p><p>Note: <code>graph.load_from_local_config</code> defaults to <code>false</code> (controlling constructor preloading) and cannot prevent local graph loading at
+startup. See the <a href=/docs/config/config-guide/>Server configuration guide</a>.</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--queries>Connections and queries</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--compressed-response>Read compressed responses with curl</h3><p>Batch vertex and edge endpoints return gzip-compressed data by default. Add the <code>--compressed</code> flag to curl to decompress automatically:</p><div class="td-code td-code--untitled" id=td-code-d5b2f53b-fence-1  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  <span class=s1>&#39;http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10&#39;</span></span></span></code></pre></div></div></div><p>If authentication is enabled, supply credentials. If output remains unexpected, check HTTP status codes, <code>Content-Type</code>, and
+<code>Content-Encoding</code>. Do not pipe JSON error responses directly into <code>gunzip</code>.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--vertex-id>A vertex exists, but lookup by ID cannot find it</h3><p>Check the exact format and type of <code>id</code> in existing query results: <strong>string IDs require JSON double quotes, while numeric IDs do not</strong>. For
+example, the string ID <code>1:marko</code> is written in JSON as <code>"1:marko"</code>.</p><p>When embedding this JSON ID into a URL path, URL-encode the entire string including double quotes. If the ID contains special characters,
+encoding the whole quoted string is required:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Character</th><th scope=col>URL encoding</th></tr></thead><tbody><tr><td><code>+</code></td><td><code>%2B</code></td></tr><tr><td>Space</td><td><code>%20</code></td></tr><tr><td><code>/</code></td><td><code>%2F</code></td></tr><tr><td><code>?</code></td><td><code>%3F</code></td></tr><tr><td><code>%</code [...]
+port (default <code>8182</code>, configured in <code>conf/gremlin-server.yaml</code>);</li><li><strong>Query syntax or logic error</strong>: Such as unindexed property filtering triggering scan limits;</li><li><strong>Missing or expired credentials</strong>.</li></ol><p>Check <code>logs/hugegraph-server.log</code> for the detailed exception stack trace.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--content-type>REST returns HTTP 415</h3><p>When sending POST/PUT requests with a JSON body [...]
+API</a> for complete reference.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--schema-cache>Schema still exists after clearing the backend</h3><p>Server caches metadata in memory. Bypassing Server to clear underlying storage directly (such as wiping RocksDB directories or HBase tables)
+causes cache inconsistency. If storage was manually deleted, <strong>restart Server</strong> to clear the cache. For normal cleanup, use the official
+<a href=/docs/clients/restful-api/graphs/#clear-graph>Clear Graph API</a>.</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--modeling>Modeling and IDs</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--id-length>A vertex or edge ID exceeds the length limit</h3><p>To maintain storage and indexing performance, HugeGraph enforces maximum ID length limits (calculated by encoded byte count):</p><ul><li><strong>Vertex ID</strong>: Maximum 16384 bytes (16 KB);</li><li><strong>Edge ID</strong>: Maximu [...]
+are automatically hashed for storage and will not trigger length errors.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--nested-properties>Are nested properties supported</h3><p>Nested properties (complex nested maps or objects) are not currently supported. To represent multi-level relations, model the nested object
+as an independent vertex and link it to the parent vertex with an edge.</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--edge-links>Can one edge label connect several vertex-label pairs</h3><p>Yes. When creating an <code>EdgeLabel</code>, invoke <code>link(sourceLabel, targetLabel)</code> once for each source-target pair.
+For example, an <code>investment</code> edge label can link both <code>individual → enterprise</code> and <code>enterprise → enterprise</code>. The deprecated
+<code>sourceLabel()</code> and <code>targetLabel()</code> methods only supported a single pair and should no longer be used.</p><p>For other questions, search the <a href=https://github.com/apache/hugegraph/issues>Server issues</a> or <a href=https://github.com/apache/hugegraph-toolchain/issues>Toolchain
+issues</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d54c862d45861ca39a945d90325e3909>6.8 - Security Report</h1><template data-hg-authored-content=start></template><h2 id=pg-d54c862d45861ca39a945d90325e3909--reporting-new-security-problems-with-apache-hugegraph>Reporting New Security Problems with Apache HugeGraph</h2><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class [...]
 Use this guide to identify affected code, rebuild your integrations and check existing data before deployment.</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--find-the-work-that-applies-to-you>Find the work that applies to you</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Your integration</th><th scope=col>What to prepare</th></tr></thead><tbody><tr><td>Java code using Server IDs, schema metada [...]
 Use matching Server, PD, Store and downstream artifacts when upgrading.
 See the <a href=https://github.com/apache/hugegraph/blob/master/docs/shared-foundation-migration.md>source migration guide</a>
diff --git a/_print/docs/quickstart/client/index.html b/_print/docs/quickstart/client/index.html
index 2bf035d1a..f99d1971e 100644
--- a/_print/docs/quickstart/client/index.html
+++ b/_print/docs/quickstart/client/index.html
@@ -1,16 +1,19 @@
 <!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=en-US data-td-typography=technical data-td-preset=slate data-td-site-preset=slate><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-theme=dark]{background [...]
-<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>Click here to print</button>.</p><p><a href=/docs/quickstart/client/>Return to the regular view of this page</a>.</p></div><h1 class=title>HugeGraph Client</h1><ul><li>1: <a href=#pg-ffe87f885ed695dba5fb26ef5ea12983>HugeGraph-Java-Client</a></li><li>2: <a href=#pg-0f122bc9c526a968d392f6806ad6ddce>HugeGraph Python Client Quick Start</a></li><li>3: <a href=#pg-c0ed8628ca3e43165a14118d58e2b4b2>HugeGraph Go Clie [...]
+<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>Click here to print</button>.</p><p><a href=/docs/quickstart/client/>Return to the regular view of this page</a>.</p></div><h1 class=title>HugeGraph Client</h1><ul><li>1: <a href=#pg-ffe87f885ed695dba5fb26ef5ea12983>HugeGraph-Java-Client</a></li><li>2: <a href=#pg-0f122bc9c526a968d392f6806ad6ddce>HugeGraph Python Client Quick Start</a></li><li>3: <a href=#pg-c0ed8628ca3e43165a14118d58e2b4b2>HugeGraph Go Clie [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;artifactId&gt;</span>hugegraph-client<span class=nt>&lt;/artifactId&gt;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>        <span class=c>&lt;!-- The complete examples below work with the published 1.7.0 client --&gt;</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>    
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>The complete examples below use Schema, Graph, Gremlin and resource-cleanup APIs available in the published Client <code>1.7.0</code>
-and compatible with Toolchain <code>master</code>. Use the dependency above directly in your example project.</p><p>For new master APIs in the <a href=/docs/clients/hugegraph-client/>API reference</a>, such as capability detection, use Client <code>1.8.0</code>
-from Toolchain <code>master</code> and change the POM version to <code>1.8.0</code>. If that version is not published to Maven yet, run the following
-command from the Toolchain source root to install the Client and its parent POM locally. The source build still needs
-its dependencies available from your configured Maven repositories.</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-440b860c-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -Dskip [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>Choose the client version before building:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Use case</th><th scope=col>Client version</th><th scope=col>Java build target</th></tr></thead><tbody><tr><td>Run the complete examples below</td><t [...]
+The release&rsquo;s Java build target does not describe the runtime requirements of every transitive dependency.</p><p>To use unreleased features from the master branch, build Client from source (see <a href=/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools source build instructions</a>):</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>Both version checks must report JDK 17. Also pass <code>-Dmaven.repo.local="$candidate_dir/m2"</code> to Maven commands in projects using Client from master.
+Client and Server versions need not be identical; check the required APIs and compatibility before upgrading.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>Choose a single-record or batch example. Save the complete code as <code>src/main/java/SingleExample.java</code> or
+<code>src/main/java/BatchExample.java</code> in your Maven project. The copy button includes the folded lines.</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-440b860c-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea1298 [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -158,7 +161,7 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-440b860c-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=138><div class=td-code__viewport id=td-code-440b860c-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -295,7 +298,9 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>135</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><p>Before running Example, you need to start the Server. For the startup process, see<a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph-Server Quick Start</a>.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5  [...]
+</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><ol class=steps><li><a href=/docs/quickstart/hugegraph/hugegraph-server/>Start HugeGraph Server</a> and prepare a test graph named <code>hugegraph</code> in graphspace <code>DEFAULT</code>.</li><li>Set the Maven project&rsquo;s JDK to 17. In  [...]
+and <code>configUser(...)</code> with your settings. Omit <code>configUser(...)</code> if Server does not require authentication.</li><li>Run <code>SingleExample.main()</code> or <code>BatchExample.main()</code> in your IDE. Both examples create schema and graph data, print the results, and close the client.
+Use a test graph: existing schema or data can affect repeated runs.</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5 More Information About Client-API</h4><p>See<a href=/docs/clients/hugegraph-client/>Introduce basic API of HugeGraph-Client</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>2 - HugeGraph Python Client Quick Start</h1><t [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># Alternatively: pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>These commands do not pin a version and install the latest release; see <a href=https://pypi.org/project/hugegraph-python/>PyPI</a>. The source directory is <code>hugegraph-python-client</code>, while the distribution is <code>hugegraph-python</code>. Install from the HugeGraph-AI workspace for master code. [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
diff --git a/_print/docs/quickstart/hugegraph-ai/index.html b/_print/docs/quickstart/hugegraph-ai/index.html
index 5341051e7..7cf40f9e8 100644
--- a/_print/docs/quickstart/hugegraph-ai/index.html
+++ b/_print/docs/quickstart/hugegraph-ai/index.html
@@ -109,23 +109,85 @@ Modules hugegraph-llm: knowledge graph construction, GraphRAG, and natural-langu
 </span></span><span class=line><span class=ln>10</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+<code>Graph Tools</code> needs no model. Document vectors require embeddings; graph extraction and answers also require an LLM.
+The reranker is optional. Start with the local <code>bleu</code> method.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Task</th><th scope=col>UI tab</th><th scope=col>Prerequisites</th></tr></thead><tbody><tr><td>Build indexes from documents</td><td><code>1. Build RAG Index</code></td><td>Documents and embeddings; graph extraction also needs a schema and LLM</td></tr><tr><td>Answer from documen [...]
+then restart. This preserves an existing file. The template has all 6 columns, with a test question and expected answer; the 4 model-answer columns stay empty.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-2e1ba1fa-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-configuration-panel>0. Configuration Panel</h2><p>Above the tabs sits a collapsible configuration panel with five sections: <code>1. Set up the HugeGraph server.</code>, <code>2. Set up the LLM.</code>, <code>3. Set up the Embedding.</code>, <code>4. Set up the Reranker.</code>, and < [...]
+The screenshots use local Ollama models <code>qwen2.5:3b</code> and <code>mxbai-embed-large</code>, with <code>Faiss</code> as the vector engine.
+Rebuild indexes after changing embedding models, since vector dimensions or meaning can differ.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-build-rag-indexes>1. Build RAG Indexes</h2><p>The first tab splits documents into a chunk vector index. It also extracts vertices and edges according to a schema, writes them to HugeGraph, and maintains a vertex vector index.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[Input document] --&gt; B[Split text]
     B --&gt; C[Generate chunk vectors]
     C --&gt; D[Write vector index]
     B --&gt; E[LLM extracts vertices and edges from schema]
     E --&gt; F[Write to HugeGraph]
-    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>Common operations are <code>Import into Vector</code>, <code>Extract Graph Data (1)</code>, <code>Load into GraphDB (2)</code>, and <code>Update Vid Embedding</code>. <code>Load into GraphDB (2)</code> also refreshes the [...]
+    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>For a first run, paste this short document into <code>Input Doc(s)</code>. Select a dedicated test graph before importing it.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-2 data-td-code data-td-cod [...]
+It allows people and roommate relationships, with optional age and occupation.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-3 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=16><div class=td-code__viewport id=td-code-2e1ba1fa-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln> 1</span><span class=cl><span class=p>{</span>
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Follow these steps to build the indexes. For vector-only retrieval, stop after step 1.</p><ol class=steps><li>Click <code>Import into Vector</code> to split the document and build the chunk vector index.</li><li>Enter schema JSON or an existing graph name in <code>Graph Schema</code>, then click <code>Extract Graph Data (1)</code>.
+Check the vertices, edges, and properties in <code>Output Info</code>.</li><li>Click <code>Load into GraphDB (2)</code> after checking the extraction. This writes to HugeGraph and refreshes vertex embeddings.</li><li>Open <code>Graph Tools</code>. Run <code>g.V().count()</code> and <code>g.E().count()</code>, then query the properties to confirm that the data was written.</li></ol><p>This example should produce 2 vertices and 1 edge, with Sarah&rsquo;s age set to <code>30</code> and occu [...]
+If the graph already contains data, use <code>Update Vid Embedding</code> to refresh its vertex index separately.
+The <code>Graph Extraction Split Type</code> dropdown selects <code>document</code>, <code>paragraph</code>, or <code>sentence</code>.
+<code>document</code> uses the whole input; the other options split it before extraction.</p><p>The page can also inspect or clear chunk indexes, vertex indexes, and graph data. Clearing removes existing data, so first confirm that the current graph and indexes are not still used by other queries.</p><p>Two collapsed helpers sit below the main controls:</p><ul><li><code>Graph Schema Generator</code> takes query examples and a few-shot example and produces a schema for the Graph Schema fi [...]
+vector search for more comprehensive fact retrieval. Other scopes are summarized in the table above.</p><p>The screenshots use these short prompts. Paste them into <code>Query Prompt</code> and <code>Keywords Extraction Prompt</code>, respectively.
+The service fills the placeholders. Keep the <code>KEYWORDS:</code> prefix and ASCII colons in keyword output, and preserve name capitalization.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><spa [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Context: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1< [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Return one line in this exact ASCII format: KEYWORDS:name:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {question}</span></span></code></pre></div></div></div><ol class=steps><li>Enter <code>Who is Sarah?</code>, set <code>Graph-only Answer</code> to <code>False</code>, and set <code>Graph-Vector Answer</code> to <code>True</code>.</li><li>Keep <code>Template Num=-1</code> and <code>Rerank method=bleu</code> for the first check, then click <code>Answer Question</code>.</li><li>Read <code>Graph-Vector Answer</cod [...]
     Q[Question] --&gt; V[Query chunk vector index]
     Q --&gt; K[Extract keywords]
     K --&gt; M[Match graph vertices]
-    M --&gt; T[Generate and execute Gremlin]
-    T --&gt;|Failure| B[Fallback to BFS graph traversal]
+    M --&gt; D{Text2Gremlin enabled}
+    D --&gt;|Yes| T[Generate and execute Gremlin]
+    D --&gt;|No| B[BFS graph traversal]
+    T --&gt;|Failure| B
     T --&gt; R[Prepare graph results]
     B --&gt; R
     V --&gt; S[Merge and rerank]
     R --&gt; S
-    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+The upper panel builds an example vector index from question and Gremlin pairs in <code>.json</code> or <code>.csv</code> files.
+When no file is uploaded, it uses <code>resources/demo/text2gremlin.csv</code>. Match example labels and properties to the current graph.</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>If building the example index does not automatically retrieve similar templates, you can provide few-shot examples directly  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-2e1ba1fa-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>For person-name lookups, use g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;name from question&gt;&#39;).valueMap().
+</span></span><span class=line><span class=ln> 3</span><span class=cl>Preserve name capitalization. Query by name; do not use vertex IDs.
+</span></span><span class=line><span class=ln> 4</span><span class=cl>Example question: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Example Gremlin: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>Graph schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>Additional examples: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>Known vertices: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>Question: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>Return only one ```gremlin``` code block.</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/en/text2gremlin.jpg alt="Generated Text2Gremlin queries and execution results" loading=lazy decoding=async></li></ul><p>A small model can generate incorrect IDs, change name capitalization, or use filters tha [...]
+Check the returned data before treating a query as successful. The Web UI executes generated queries directly, so use a dedicated test graph.
+To generate a query without executing it, select the corresponding output types in the <a href=/docs/quickstart/hugegraph-ai/rest-api/>REST API</a>.</p><p>A custom prompt must retain <code>{query}</code>, <code>{schema}</code>, <code>{example}</code>, and <code>{vertices}</code>. The REST API rejects it if any placeholder is missing.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-graph-and-administration-tools>4. Graph and Administration Tools</h2><p><code>Graph Tools</code> runs a Gre [...]
+Initializing demo data first clears the current graph. Use this action only on a dedicated test graph.</p><p><code>Admin Tools</code> is password protected. Entering the configured <code>ADMIN_TOKEN</code> reveals the tail of <code>logs/llm-server.log</code>, which refreshes every 60 seconds, along with buttons to refresh or clear it. Access is refused while <code>ADMIN_TOKEN</code> is empty or still set to the placeholder <code>xxxx</code>.</p><p>When <code>ENABLE_LOGIN=True</code>, the [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> is enabled by default, so running without arguments has the same effect. On first configuration-module import, missing <code>.env</code> and prompt YAML files are created from defaults. The generator asks interactively before overwriting existing files. It handles HugeGraph, administrator, LLM, index, an [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>The same choice is available in the <code>5. Set up the vector engine.</code> panel of the Web UI, which also persists the connection settings for the selected engine.</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--login-and-log-api>Login and Log API</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=reg [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
diff --git a/_print/docs/quickstart/hugegraph/index.html b/_print/docs/quickstart/hugegraph/index.html
index 9fc439ed9..0a5cf234e 100644
--- a/_print/docs/quickstart/hugegraph/index.html
+++ b/_print/docs/quickstart/hugegraph/index.html
@@ -37,13 +37,14 @@ Build all modules with <strong>JDK 17 and Maven 3.6.3 or later</strong>, and run
 Server security check (<code>-s true</code>) requires Java 17 to 23 and a readable <code>conf/java-security.properties</code>;
 on Java 24 or later, start Server with <code>-s false</code> (JDK 24+ dropped Security Manager via JEP 486).</p><p><strong>Before continuing, run <code>java -version</code> to confirm your JDK version.</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p><strong>TinkerPop 3.8.1 Compatibility & Key Cha [...]
 Keep HugeGraph registries.</li><li><strong>Graph.Features</strong>: <code>supportsUniformListValues()</code> returns <code>false</code> for properties.
-Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
+Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema results are standard maps</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob values are binary (including inside returned elements)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON ( [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP / Leg [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Preserves the legacy Tree key/value array structure</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 is disabled for security (typed V2/V3 remain available for simple values and IDs)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() returns property keys, vertex labels, edge labels, and index labels</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>For complete client configurati [...]
@@ -294,7 +295,7 @@ the start script rejects older runtimes; 1.7.0 is the last release supporting Ja
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
 install-snapshot timeout, and id allocation runs no ReadIndex wait.</p><p><strong>PD core</strong></p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Key</th><th scope=col>Master distribution value</th><th scope=col>Built-in default</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>pd.data-path</code></td><td><code>./pd_data</code></td><td>none, required</td><t [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
diff --git a/_print/docs/quickstart/index.html b/_print/docs/quickstart/index.html
index 09208deb5..98d46bcac 100644
--- a/_print/docs/quickstart/index.html
+++ b/_print/docs/quickstart/index.html
@@ -25,13 +25,14 @@ Build all modules with <strong>JDK 17 and Maven 3.6.3 or later</strong>, and run
 Server security check (<code>-s true</code>) requires Java 17 to 23 and a readable <code>conf/java-security.properties</code>;
 on Java 24 or later, start Server with <code>-s false</code> (JDK 24+ dropped Security Manager via JEP 486).</p><p><strong>Before continuing, run <code>java -version</code> to confirm your JDK version.</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p><strong>TinkerPop 3.8.1 Compatibility & Key Cha [...]
 Keep HugeGraph registries.</li><li><strong>Graph.Features</strong>: <code>supportsUniformListValues()</code> returns <code>false</code> for properties.
-Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
+Schema <code>valueList()</code>/<code>LIST</code> properties remain supported without rewriting existing data.</li><li><strong>Traversal Multiplicity</strong>: Mid-traversal scans retain input multiplicity (e.g. for 3 vertices, <code>g.V().V().count()</code> returns <code>9L</code>).</li><li><strong>Date & Time Types</strong>: <code>DATE</code> properties accept <code>OffsetDateTime</code> for writes and indexed equality/range queries (instant normalized to milliseconds).</li><li><strong [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema results are standard maps</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob values are binary (including inside returned elements)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON ( [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP / Legacy)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP / Leg [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Preserves the legacy Tree key/value array structure</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 is disabled for security (typed V2/V3 remain available for simple values and IDs)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() returns property keys, vertex labels, edge labels, and index labels</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>For complete client configurati [...]
@@ -282,7 +283,7 @@ the start script rejects older runtimes; 1.7.0 is the last release supporting Ja
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Variable</th><th scope=col>Required</th><th scope=col>Default</th><th scope=col>Configuration key</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></t [...]
 install-snapshot timeout, and id allocation runs no ReadIndex wait.</p><p><strong>PD core</strong></p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Key</th><th scope=col>Master distribution value</th><th scope=col>Built-in default</th><th scope=col>Description</th></tr></thead><tbody><tr><td><code>pd.data-path</code></td><td><code>./pd_data</code></td><td>none, required</td><t [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
@@ -731,17 +732,21 @@ provides complete orchestration for PD, Store, Server, and Hubble. Follow the ad
 then launch services from <code>docker/</code> without maintaining separate Compose files.
 The guidance below focuses on connectivity and operations; ensure prerequisite credentials and service readiness from the README are met.
 Docker <code>latest</code> is a moving tag. Screenshots assist in UI navigation; verify deployed versions via image digests and build details.
-Metrics and permission APIs vary by version.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
-and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e0 [...]
+Metrics and permission APIs vary by version.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
+and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|Graph API| S[Server]
+    S --&gt;|Graph reads and writes| T[Store]
+    H -.-&gt;|Discovery and cluster information| P[PD]
+    H -.-&gt;|Node metrics| T</code></pre><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=highlight><pre t [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>The script reads <code>HG_PD_AUTH_SECRET_KEY</code> from <code>.env</code> and writes its value as <code>operations.pd.password</code> into the generated file
 <code>docker/conf/hubble/hstore.local.properties</code>. Edit this generated file to adjust connection or operations settings (do not overwrite
 the tracked <code>.example</code> template), ensuring <code>operations.pd.password</code> matches the PD secret. Compose mounts this file read-only into
 the container; do not edit inside the container. Both <code>.env</code> and the generated file contain secrets and should not be committed to Git.
-Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=h [...]
+Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=h [...]
 <a href=/docs/quickstart/hugegraph/hugegraph-hstore/>HStore deployment guide</a>. A source or binary Hubble deployment instead uses the package&rsquo;s
-<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
+<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Setting</th><th scope=col>Purpose</th><th scope=col>Bundled value</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>Explicitly enable PD mode; <c [...]
@@ -749,7 +754,7 @@ rather than <code>127.0.0.1</code> for cross-container traffic.
 The bundled package sets <code>pd.enabled=false</code>. If omitted, the fallback default is <code>true</code>, so declare this setting explicitly in both standalone and distributed
 setups.
 After editing configuration: restart the Hubble process for source or binary deployments; for Docker Compose, recreate the Hubble container from <code>docker/</code>
-to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
+to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
 so each team can work with its own graphs. Modeling, importing, and querying within a space follow the standalone guide.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--create-and-adjust-a-graphspace>Create and adjust a GraphSpace</h3><p>With Server authentication enabled, creating, editing, and deleting GraphSpaces require super administrator access.
 Start with a globally unique GraphSpace name, an optional display alias, and the maximum graph count.
 For example, use <code>research</code> as the API identifier and “Research_graph” as the display alias.
@@ -758,7 +763,7 @@ Choose GraphSpace administrators from existing accounts.</p><p>“Advanced deplo
 plus the storage capacity limit. These deployment quotas neither report current usage nor resize existing containers.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Advanced deployment defaults</span></div><div class=td-callout__body><p>Defaults are 100 graphs, 64 CPU cores and 128 GB of memory for each of the graph and compute services, and 1000000 GB of storage.
 Keep the defaults for a container trial. Configure Kubernetes namespaces, Operator images, and algorithm images only for the corresponding deployment
 or compute use.</p></div></div><p>Select a space before opening a graph. Check the current graph after switching spaces, especially when spaces contain identically named graphs.
-The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation and advanced resource limits" width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema within a GraphSpace.
+The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation form and entry to advanced resource limits" width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema  [...]
 When several business graphs share vertex labels, edge labels, and indexes, save the model as a template and select it when creating subsequent graphs.
 For example, a user template in <code>research</code> can be reused for new graphs in that space. After switching spaces, select a template belonging to the new space.</p><p>User templates differ from the built-in sample templates in the main guide: built-in templates help explore preset models,
 while user templates preserve your own models for future use. A template is not an import of data; loading sample data is a separate graph creation choice.
@@ -772,7 +777,7 @@ Accounts and space memberships are managed separately; removing a member does no
 After creating an account, continue directly to assigning space access. When changing an existing membership, check the selected space and preset
 and preserve permissions still needed in other spaces. Enabling <code>pd.enabled</code> grants no permissions;
 legacy custom roles on older Servers are not interchangeable with these presets.
-See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to fi [...]
+See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to f [...]
 PD Leader, online Store count, graphs, partitions, replicas, and data size help identify cluster scale and nodes requiring attention.
 Partitions and replicas describe data distribution. Data size is observed usage, distinct from a GraphSpace&rsquo;s configured storage limit.</p><p>Start with cluster and source status, then inspect an affected node. <code>UP</code> indicates a successful collection from the source;
 <code>DEGRADED</code> indicates a cluster or partial source issue, and <code>DOWN</code> indicates that the corresponding probe failed.
@@ -785,32 +790,32 @@ GraphSpace administrators and ordinary members do not inherit cluster access.
 Use container isolation, a trusted HTTPS entrypoint, Server authentication, and network allowlists; avoid publishing Hubble or component ports directly.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--configure-operations-access>Configure operations access</h3><p>Hubble&rsquo;s <strong>backend</strong> uses the PD/Store operations credentials, separately from the Server account used to log in through the browser.
 For Compose, edit the generated host file <code>docker/conf/hubble/hstore.local.properties</code>; other deployments use the Hubble package configuration.
 The script-generated PD password must match the secret in <code>.env</code>. Configure the Store service account when Store authentication is enabled.
-Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
+Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
 matching the Store metric target returned by PD. Adding an origin here only authorizes access—it does not register or discover nodes.</p><p>If topology renders but node metrics are missing, check Hubble backend connectivity and credentials to PD REST, verify the Store REST and metric addresses
 returned by PD, and ensure targets are in <code>operations.store.allowed_targets</code>. A partially available overview indicates metrics collection was blocked for
 specific sources, not that graph APIs are down.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-55eecaa5c3ceec829e0f0d20863baa46>2.2 - Graph Visualization with Hubble: Standalone Quick Start</h1><div class=lead>Use Hubble and RocksDB Server to manage schema, import CSV, and query graph data with Gremlin, Cypher, or Text2GQL.</div><template data-hg-authored-content=start></template><p>Hubble is the HugeGraph Web man [...]
 and switch smoothly between graph, table, and JSON results. This guide uses <strong>standalone RocksDB Server + Hubble</strong>, without requiring PD or Store.</p><p>For use with an HStore distributed cluster, read the foundational operations here first, then consult the
 <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a>.
-This guide aligns with the Toolchain and Server <code>master</code> branches (both currently <code>1.8.0</code>).</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p>Do not expose unauthenticated Hubble or Server instances directly to the public internet. In production, use HTTPS, container isolation,
-<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start the standalone pair</h2><p>Use the main repository&rsquo;s <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a>
+This guide aligns with the Toolchain and Server <code>master</code> branches (currently based on 1.8, unreleased). Docker <code>latest</code> is a moving tag; use released versions for production deployments.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" a [...]
+<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><p>Jump directly to a task below. If this is your first visit, start with the standalone deployment:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start and load a sample</a></p><p>Start the two services and load the People & Software Demo Graph.</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-workspa [...]
 instead of writing custom Compose files. It already integrates RocksDB Server and Hubble with networking, health checks, and data volumes;
-see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span>< [...]
+see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><ol class=steps><li><p><strong>Prepare the official Compose configuration.</strong></p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>If you already have the repository locally, navigate directly to its <code>docker/</code> directory. Compose automatically mounts
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 which pre-configures <code>pd.enabled=false</code> and <code>server.direct_url=http://server:8080</code>. Because both services communicate over a shared Docker network,
 you do not need to configure Server endpoints per graph. Start Compose directly from <code>docker/</code> so relative file paths resolve correctly.</p><p>Hubble publishes on host loopback port <code>8088</code> by default (controlled by <code>HUBBLE_PUBLISH_HOST</code>, defaulting to <code>127.0.0.1</code>), whereas Server publishes
 <code>8080</code> across all interfaces. For a local trial, set Server&rsquo;s <code>ports</code> in Compose to <code>127.0.0.1:8080:8080</code> to prevent exposing unauthenticated ports
-beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chrom [...]
+beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p></li><li><p><strong>Start and check the services.</strong></p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>Open Hubble.</strong></p><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
 Server permits anonymous access and Hubble opens the homepage directly. If authentication is enabled, configure an admin password and JWT secret in <code>.env</code>
 as described in the Docker README, then sign in with a Server account (Hubble has no independent user database).
-Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
+Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p></li></ol><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
 <a href=/docs/download/download/>download page</a>.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Verify the deployed versions</span></div><div class=td-callout__body><p>Screenshots help locate controls. Verify actual versions from the deployed image digests and build information.</p></div></div><p>Compose&rsquo;s <code>server-data</code> and <code>hubble-data</code>  [...]
 see the <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server deployment guide</a>.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--home-find-the-right-starting-point>Home: find the right starting point</h2><p>Home groups the workspace into graph overview, data preparation, and graph queries. Use it to understand the workflow,
 then return to any section through the sidebar. The top graph selector determines the target of queries, schema operations, and async tasks;
@@ -830,15 +835,13 @@ Use <strong>New</strong> to create elements, or edit existing data when authoriz
 adding or editing elements via the UI or executing Gremlin write statements modifies underlying Server graph data.</p><p>Press <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> to execute queries quickly. Immediate execution is ideal for interactive exploration; submit long or resource-intensive
 queries as background async tasks. Cypher is available when supported by the backend Server.
 The keyboard shortcut acts on whichever input currently has focus: generating a query from
-the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p>The Text2GQL backend capabilities (including Model settings, built-in/temporary models, and Prom [...]
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> or a release containing it.
-Earlier builds display a preview tab without model management.</p></div></div><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
+the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
 and execute it automatically. Generated statements can be edited freely (read-only safety checks still apply before execution).
 In <strong>Async</strong> mode, both generated and handwritten queries can be submitted as background tasks.
-Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL query and graph results" loading=lazy decoding=async><p class=td-gallery__description>Query workspace</p></li><li class=td-gallery__item><img class=td-gall [...]
+Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL entry and handwritten query results" loading=lazy decoding=async><p class=td-gallery__description>Unconfigured model; handwritten query</p></li><li class=t [...]
 The Base URL must be reachable from Hubble&rsquo;s backend; container <code>localhost</code> refers to that container. Public endpoints require HTTPS, while plain HTTP is
 accepted only for loopback or private-network models; when changing the Base URL in Model settings, supply a new Key or explicitly clear the saved Key.
-Only the <code>admin</code> account (a super administrator in PD mode) manages shared settings. When Server authentication is disabled, anyone who can access the
+Administrators with model-settings management permission manage shared settings. When Server authentication is disabled, anyone who can access the
 deployment can manage them.</p><p>Under model settings, click <strong>Text2GQL Prompt</strong> in the header to customize Gremlin and Cypher generation rules and few-shot examples.
 Click <strong>Apply</strong> and then save model settings to persist templates to the H2 database for both built-in and temporary models.
 The current graph schema is appended automatically during generation.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Key storage and privacy notes</span></div><div class=td-callout__body><p>When backing up the Hubble H2 database, always back up the master-key file (<code>data/text2gql-master.key</code> by default); losing it prevents decrypting saved Keys.
@@ -849,7 +852,7 @@ Start with a known vertex ID and limit direction, edge labels, depth, and result
 Results use graph or algorithm-specific panels. Consult the help and documentation links beside the algorithm title for definitions and parameters.
 While the parameter form is focused, <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> runs the current algorithm.</p><p>OLAP batch algorithms require external compute services such as Computer or Vermeer.
 The two containers in this example provide online graph operations, not those compute services.</p><p>For example, select K-neighbor (GET) with <code>source=1:marko</code>, <code>max_depth=1</code>, and <code>limit=20</code>.
-After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, incl [...]
+After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, inc [...]
 Filter by task type and status, inspect IDs, creation times, and execution states, open successful query results, or expand failure information.
 Completed task records can be deleted where the interface permits. These tasks are separate from import execution history.</p><p>For example, submit <code>g.V().count()</code> asynchronously, confirm success in the list, then inspect the returned count.
 A successful submission means the request was accepted, not that computation or indexing has finished.
@@ -880,7 +883,7 @@ The following presets are for PD mode, and are not universally editable on older
 Before replacing custom permissions with a preset, inspect the grants that need to be retained; complex permissions may not match a single preset.
 After changes, refresh permission context or sign in again and verify menus and space selection. Server still validates every request.
 Older Servers may hide or disable unsupported operations; a visible button alone does not establish resource authorization.
-See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in PD mode" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Information< [...]
+See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in standalone mode" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Inf [...]
 Search nodes, filter health status, and open node details to inspect available version, system, JVM, and Server-backend metrics.
 When metrics are unavailable or stale, use collection state and the last successful observation time;
 a missing value is neither zero nor proof of health.</p><p>Anonymous mode can read operations information. With authentication enabled, operations are available only to administrators with the capability.
@@ -888,15 +891,12 @@ This is an observation and diagnosis interface, not a start/stop or scaling cons
 The distributed supplement covers cluster overview and the PD/Store node hierarchy.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--keyboard-shortcuts-and-graph-interactions>Keyboard shortcuts and graph interactions</h2><p>Use the topbar shortcut-help button to see key bindings. Their scope differs: typing <code>?</code> in an input does not trigger global help.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr>< [...]
 it is not a universal hard limit. <code>gremlin.vertex_degree_limit</code> (<code>100</code>) and <code>gremlin.edges_total_limit</code> (<code>500</code>) constrain expansion.
 FILE uploads allow <code>csv,txt</code> by default, with 1 GB per file and 10 GB total. Override <code>upload_file.*</code> settings when needed.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--stop-the-trial-or-build-from-source>Stop the trial or build from source</h2><p>When finished, run this in the main repository&rsquo;s <code>docker/</code> directory:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td [...]
-To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>To obtain an exact master build, use JDK 17 and Maven. The Maven plugin installs the required Node/Yarn;
-you do not need to install them separately. These commands skip tests:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branc [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># Edit conf/hugegraph-hubble.properties with the correct Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
+To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>Building current master requires <strong>JDK 17, Maven 3.9+, Python 3.9+, and stable Node.js 24 (at least 24.22.0)</strong>,
+with <strong>pnpm 12.14.0</strong> selected through Corepack. Maven no longer installs Node/Yarn automatically.</p><ol class=steps><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration instructions</a>
+to install the Server SDK in an isolated Maven repository.</p></li><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble source-build procedure</a>
+to install Python dependencies and build Client, Loader, and Hubble with that same repository (skipping tests).</p></li><li><p>Open the resulting <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> directory,
+configure Server connection settings in <code>conf/hugegraph-hubble.properties</code>, then start:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hu [...]
+Old metadata has no automatic migration and cannot be reused directly.</p><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
 For development and testing, see the <a href=/docs/guides/toolchain-local-test/>Toolchain local test guide</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>2.3 - Graph import</h1><template data-hg-authored-content=start></template><p>Choose an import tool when you need to write file, database, or message data into HugeGraph. Use Loader for a direct import, SeaTunnel Sink when an [...]
 All examples use the <code>mappings</code> configuration available in SeaTunnel 3.0+.</p></blockquote><p><a href=/docs/images/seatunnel/seatunnel-vs-loader-en.png><img class=td-image src=/docs/images/seatunnel/seatunnel-vs-loader-en.png alt="Loader imports data directly with graph mappings; SeaTunnel 3.0+ combines Source, Transform, and Sink, and both support JDBC, Kafka, and graph data" loading=lazy decoding=async></a></p><p>Click a diagram to view the original size.</p><h2 id=pg-b8e8e0 [...]
 lists Java 8 and 11 as prerequisites. Choose a 3.0+ binary distribution from the
@@ -1030,10 +1030,63 @@ as needed<sup>[11][12]</sup>. The JDBC examples also require the MySQL driver JA
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
-check the version you use and build from source for unreleased functionality.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader is the data import component of HugeGraph, which can convert data from various data sources into graph vertices and edges and import them into the graph database in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and J [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).
-Older Servers retain the legacy import behavior described below.</p></blockquote><blockquote><p><strong>Testing Guide</strong>: For running HugeGraph-Loader tests locally, please refer to <a href=/docs/guides/toolchain-local-test/>HugeGraph Toolchain Local Testing Guide</a></p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>2 Get HugeGraph-Loader</h3><p>HugeGraph-Loader is available in the following three ways:</p><ul><li>Use docker image (Convenient for T [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+First <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>install Loader</a> and start <a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>.
+The commands below run from the Loader directory, importing into the default graph <code>hugegraph</code>.
+For an authenticated Server, append <code>--username</code> and <code>--password</code> (or <code>--token</code>).</p><ol class=steps><li><p><strong>Create the data files.</strong></p><p>These CSV files have no header row. The mapping in the next step supplies the column names.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-8a011ca1-fence-0-viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Create the schema and mapping.</strong></p><p>Dedicated <code>docs_*</code> names keep this example separate from the built-in <code>person</code> data.
+File paths are relative to the directory where you run Loader.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-8a011ca1-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Run the import.</strong></p><p>Keep the same working directory. Change the host and port if Server runs elsewhere.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-2-viewpor [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>A first successful run imports two vertices and one edge. Check the success and failure counts in the summary.</p></li><li><p><strong>Query the result in Hubble.</strong></p><p>Connect Hubble to the same Server and graph, then run these queries separately in the Gremlin workspace.</p><div class="td-code td-code--unt [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>The first query returns Alice with age <code>29</code> and Bob with age <code>31</code>. The second returns <code>docs-sm [...]
+The <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>bundled full example</a> also includes software vertices and edge properties.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader converts source data into graph vertices and edges and imports them into HugeGraph in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and JSON format [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -1048,10 +1101,12 @@ Older Servers retain the legacy import behavior described below.</p></blockquote
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>The specific data loading process can be referenced under <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 User Docker to load data</a></p><blockquote><p>Note:</p><ol><li><p>The docker image of hugegraph-loader is a convenience release to start hugegraph-l [...]
-A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Clone the <code>master</code> branch:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=t [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extracted Loader <code>lib/</code> directory.
-The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>The basic process of using HugeGraph-Loader is divided into the following steps:</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-g [...]
-&ldquo;Software&rdquo; includes: &ldquo;name&rdquo;, &ldquo;sale price&rdquo; and other attributes; side &ldquo;knowledge&rdquo; includes: &ldquo;date&rdquo; attribute and so on.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>After designing the graph model, we can use <code>groovy</code> to write the definition of <code>schema</code> a [...]
+A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Building Loader from the master branch requires Java 17, Maven 3.6.3+, and Python 3.9+. Clone the repository and build:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-au [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>To build against candidate Server SDKs during development, refer to the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a>.</p><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extrac [...]
+The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>To import a dataset, prepare the schema, data and mapping, then run Loader.</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-graph- [...]
+People have names, ages and cities; software has a name and price. Each edge records a date.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>Save the schema definitions in <code>schema.groovy</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-lin [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1066,19 +1121,23 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// Create the knows edge type, which goes from person to person
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// Create the created edge type, which points from person to software
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+Column names can come from a header row or from the mapping&rsquo;s <code>header</code> setting.</p><p>An example is as follows:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-7 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</sp [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-6-viewport data-td-code-view [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If the id strategy of person or software is specified as PRIMARY_KEY when modeling (schema), choose name as the primary key (note: this is the concept of vertex-label in hugegraph), when importing edge data, the source vertex and target need to be spliced ​​out. For the id of the vertex, you must go to the person/software table with p_id/s_id to find [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+Each input row must provide the values needed to construct its graph elements. Prepare any joins in the source query first.</p><p>Consider three tables named <code>person</code>, <code>software</code> and <code>created</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-10-viewport data-td-code-viewport><div class=highlight><pre ta [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If <code>person</code> and <code>software</code> use <code>PRIMARY_KEY</code> IDs with <code>name</code> as the primary key, each edge needs its endpoints&rsquo; names.
+The <code>created</code> table contains only <code>p_id</code> and <code>s_id</code>; Loader will not query the names from those IDs. Use either of these ID designs.</p><ol><li>Keep <code>PRIMARY_KEY</code> and use each vertex table&rsquo;s <code>id</code> column as its primary key property.
+Loader can then build endpoint IDs from <code>p_id</code>, <code>s_id</code> and the vertex labels.</li><li>Use custom IDs, taking each vertex table&rsquo;s <code>id</code> column as the vertex ID. The edge mapping can use <code>p_id</code> and <code>s_id</code> directly.</li></ol><p>Both designs let edge rows supply endpoint IDs without another lookup.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-prepare-vertex-and-edge-data>3.2.2 Prepare vertex and edge data</h5><h6 id=pg-85740db [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1095,7 +1154,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -1293,7 +1352,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-16 data-td [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-19 data-td [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1344,8 +1403,8 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
-(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
+(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1374,59 +1433,24 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// If there is no update strategy, you will get
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 If the argument file contains credentials, restrict it to mode <code>0600</code> with <code>chmod 0600 loader.args</code>.
 The <code>@file</code> form keeps credential values out of process arguments.
 Loader must be able to create and write the mapping-prefix directory used for progress output.
-Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>Usually, the Loader task takes a long time to execute. If the import interrupt process exits for some reason, and next time you want to continue the import from the interrupted point, this is the scenario of using breakpoint continuation.</p><p>Set <code>--incremen [...]
+Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>For a long import, use a progress file to resume after an interruption.</p><p>Set <code>--incremental-mode</code> to <code>true</code> to resume from a progress file. Loader records progress when it closes normally after a successful import
 or a normal stop; an unexpected failure may prevent this write.
 The progress file is in <code>${struct}</code> and named <code>load-progress_${timestamp}</code>, where <code>${struct}</code> is the mapping-file prefix and <code>${timestamp}</code> is the
 import start time, formatted as <code>yyyyMMdd-HHmmss</code>. For example, an import started at <code>2019-10-10 12:30:30</code> with mapping file <code>struct-example.json</code>
 writes <code>struct-example/load-progress_20191010-123030</code>. When the directory holds several progress files, the resumed import reads the last one in name
 order, which is the most recent one.</p><blockquote><p>Note: A progress file is written after a successful import or a normal stop (including an error limit), regardless of <code>--incremental-mode</code>
-or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>If the data file formats are all legal and the import task is stopped by the user (CTRL + C or kill, kill -9 is not supported), that is to say, if there is no error record, the next import only needs to be set to
-Continue for the breakpoint.</p><p>But if the limit of &ndash;max-read-errors, &ndash;max-parse-errors or &ndash;max-insert-errors is reached because too much data is invalid or network abnormality is reached, Loader will record these original rows that failed into
-the failure file, after the user modifies the data lines in the failure file, set &ndash;failure-mode to true to import these &ldquo;failure files&rdquo; as input sources (does not affect the normal file import),
-Of course, if there is still a problem with the modified data line, it will be logged again to the failure file (don&rsquo;t worry about duplicate lines, they are dropped when the file is closed). Failure mode lifts the three error limits above, so the whole failure file is scanned.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error [...]
+or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>After stopping an import with <code>Ctrl+C</code> or <code>kill</code>, set <code>--incremental-mode true</code> to continue from the recorded position.
+A forced stop with <code>kill -9</code> cannot save progress.</p><p>Invalid data or connection failures can exhaust <code>--max-read-errors</code>, <code>--max-parse-errors</code> or <code>--max-insert-errors</code>.
+Correct the rows in the failure files, then use <code>--failure-mode true</code> to retry them. This leaves the original data files unchanged.
+Rows that still fail are recorded again and deduplicated when the failure file closes. Failure mode lifts these three limits and scans the entire file.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error</code> and is stored in the <code>${struct}/failure-data</code> directory.
 Every failed line is written as a pair of lines: a tip line starting with <code>#### READ ERROR:</code>, <code>#### PARSE ERROR:</code> or <code>#### INSERT ERROR:</code>, followed by the original data line. When the input source has a header, that header is written as JSON to a sibling <code>${id}.header</code> file, so the failure file can be read back with the right columns.
-For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p>The CSV has no header row; <code>input.header</code> in the mapping supplies column names. <code>input.path</code> is relative to the Loader process working directory, so keep running from the installation directory. If Server runs in another container, set <code>--host</code> to a Server address reachable by Loader:</p><div class="td-code t [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>Expected result: two vertices and zero edges imported. This example uses dedicated schema names to avoid conflicts with a preloaded <code>person</code> label. In Hubble, run <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code> to confirm <code>docs-smoke-alice</code> and <code>docs-smoke-bob</code>.< [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
+When the deployed Server provides this endpoint and returns <code>protocol: 1</code>, Loader enables ownership protection automatically; released Server 1.7.0 and older versions continue using the legacy mode switching flow.</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;Graph Mode: NONE&#34;] --&gt;|First Loader acquires owner| B[&#34;LOADING Mode (Acquires Token)&#34;]
     B --&gt;|Concurrent Loaders join| B
     B --&gt;|Loader finishes &amp; releases| B
@@ -1443,18 +1467,19 @@ Network or permission errors, or a <code>404</code> for a missing graph, do not
 manually reset graph mode to <code>NONE</code> before starting ordinary imports.
 Do not run restore, graph-source, Spark connector, or older Loader imports while owned imports are active.</li><li><strong>Scope & Lifecycle</strong>: Ownership is bound to the target Server instance without cross-node synchronization or automatic lease expiry.
 For embedded programmatic integrations, callers must invoke <code>HugeGraphLoader.shutdown()</code> to attempt a single graceful release. If release
-fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>Given below is an example in the example directory of the hugegraph-loader package. (<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub address</a>)</p><h4 id=pg-85740db4cef1a86c [...]
+fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>The Loader distribution includes this dataset in <code>example/file/</code>.
+See the <a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>source files</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-prepare-data>4.1 Prepare data</h4><p>Vertex file: <code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=6><div class=td-code__viewport id=td-code-8a011ca1-fence-28-viewp [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1477,7 +1502,7 @@ fails, the handle is not retried; the owner may remain active on the Server, and
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> uses custom numeric IDs: mapping <code>id</code> supplies the vertex ID and <code>created.target_id</code> supplies the edge’s target ID.
-Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
+Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1537,7 +1562,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-33-viewport data-td-code-viewport><div class=highlig [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-34-viewport data-td-code-viewport><div class=highlig [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -1549,7 +1574,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -1557,11 +1582,11 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Taking the built-in example dataset as an example, we can use the following command to load the data.</p><p>If you need to import your custom dataset, you need to modify the paths for <c [...]
-Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Run this command to import the built-in dataset.</p><p>For custom data, set <code>-f</code> to your mapping file and <code>-s</code> to your schema file.</p><p>You can refer to <a href=# [...]
+Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -1583,19 +1608,31 @@ Changing only <code>-f</code> and <code>-s</code> does not change where Loader l
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>You can also use <code>curl</code> or <code>hubble</code> to observe the import result. Here&rsquo;s an example using <code>curl</code>:</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-these two-parameter names have overlapping parts, please use the full name of the parameter.
-And there is no need to guarantee the order between the two parameters.</p><ul><li>hugegraph parameters (Reference: <a href=https://hugegraph.apache.org/docs/quickstart/toolchain/hugegraph-loader/#341-parameter-description>hugegraph-loader parameter description</a> )</li><li>Spark task submission parameters (Reference: <a href=https://spark.apache.org/docs/3.3.0/submitting-applications.html#content>Submitting Applications</a>)</li></ul><p>Example:</p><div class="td-code td-code--untitled [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> submits <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code> through <code>${SPARK_HOME}/bin/spark-submit</code>, so <code>SPARK_HOME</code> has to point at a Spark installation. Every jar u [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> is treated separately: with <code>--deploy-mode cluster</code> the mapping file is shipped to the executors through <code>--files</code> and the loader receives only its base name, otherwise the path is passed through as written.</p><p>In this mode the loader reads FILE,  [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>2.5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migrati [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>Query the imported data with Hubble or <code>curl</code>.</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-41 data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+The POM&rsquo;s Spark <code>3.2.2</code> dependency supplies compile-time APIs; it is not the runtime engine.
+Set <code>SPARK_HOME</code> and <code>JAVA_HOME</code>, then use the distribution&rsquo;s shaded Loader JAR with its launcher.</p><p>Create the schema first and make data files readable by the executors. CSV and TEXT inputs need headerless UTF-8 data and an explicit mapping <code>header</code>.
+Other charsets and <code>has_header: true</code> are rejected. Load vertex data before edge data when the edges depend on those vertices.
+Replace the mapping path below with your prepared vertex mapping.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>Pass Spark options such as <code>--master</code>, <code>--conf</code> and <code>--jars</code> to the launcher alongside Loader options.
+Additional JDBC drivers need explicit <code>--jars</code>; copying them into <code>lib/</code> does not distribute them to executors.
+Query the target graph to verify counts and properties; the API sink&rsquo;s insertion counters do not report distributed writes.</p><p>This path rejects <code>--incremental-mode true</code> and <code>--failure-mode true</code>. Standalone Spark supports client deployment only.
+HBase bulkload (<code>--sink-type false</code>) is unsupported on Spark 3.5.8 / Java 17; keep an existing bulkload deployment on its separately validated
+released Loader/JVM/Spark/HBase environment.
+For details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark migration guide</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-import-data-by-flink-cdc-loader>4.7 Import data by flink-cdc-loader</h4><p>The current <code>master</code> integration targets Flink <code>2.2.1</code>, MySQL CDC <code>3.6.0-2.2</code> and Java 17.
+Older examples using Flink 1.13.5 and CDC 2.2.1 belong to the previous implementation.
+Set <code>FLINK_HOME</code>; the submission JVM, JobManager and TaskManager must all use Java 17.
+Keep Flink&rsquo;s module-access options and exactly one shaded Loader JAR in the distribution&rsquo;s <code>lib/</code>.</p><p>Each mapping needs a MySQL JDBC input with <code>url</code>, <code>database</code>, <code>table</code>, <code>username</code> and <code>password</code>.
+Set MySQL <code>binlog_row_image=FULL</code>. UPDATE events require explicit, nonempty <code>update_strategies</code> and unchanged graph IDs;
+changes to vertex IDs, edge endpoints or sort keys are rejected. CDC also rejects <code>--dry-run true</code> and <code>--use-prefilter true</code>.</p><p>Without a separator, all arguments go to Loader. To set Flink options, put them before <code>--</code> and Loader options after it.
+For a prepared mapping at <code>mysql-cdc.json</code>, submit with one sink writer.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-lo [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>Each mapping uses a single source reader and sink writer. <code>--cdc-sink-parallelism</code> defaults to <code>1</code>; other values are rejected.
+After <code>--</code>, Loader&rsquo;s <code>-p</code> means the Server port. Checkpoint flushing does not provide transactional graph writes or an exactly-once guarantee.
+Validate edge CDC and broader mappings in your test environment before deploying to production.
+For more details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC documentation</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>2.5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migration tool when you need to back up, export, or move data  [...]
 See the <a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>official Source documentation</a>
 for parallel-scan backend requirements and configuration limits.</p><p>Before starting, complete the <a href=/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-prepare-the-environment>shared environment and configuration steps on the import page</a>. They cover JDK, HOCON, plugin installation, and the sample graph model.</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-migrate-a-hugegraph-graph-graph2graph>1 Migrate a HugeGraph graph (graph2graph)</h2><p>The following exa [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
@@ -1705,23 +1742,40 @@ for parallel-scan backend requirements and configuration limits.</p><p>Before st
 </span></span><span class=line><span class=ln>24</span><span class=cl>    <span class=n>path</span> <span class=o>=</span> <span class=s2>&#34;/tmp/hugegraph-export/${table_name}&#34;</span>
 </span></span><span class=line><span class=ln>25</span><span class=cl>    <span class=n>file_format_type</span> <span class=o>=</span> <span class=s2>&#34;json&#34;</span>
 </span></span><span class=line><span class=ln>26</span><span class=cl>  <span class=p>}</span>
-</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
+</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools ships inside the toolchain package, in a directory</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># whose version suffix is the same as the archive&#39;s</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. Download a released source package</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>Compile and generate tar package:</p><div class="td-code td-code--untitled" id=td-code-beb8 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>The package is generated as <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>, and the unpacked directory <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> (containing <code>bin/</code> and <code>lib/</code>) is created next to it.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-ho [...]
-For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-4-viewport data-td-code-viewport><div class=highli [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
+Each example ends in the generated Tools directory, where <code>bin/hugegraph help</code> lists the available commands.</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git tag" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git tag</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb85dde-fence-1-viewport data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="Source archive" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Source archive</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-beb85 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>The build also writes <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code> relative to the source root.</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 Build current source</h4><p>To use unreleased features from the master branch, build Tools from source (master is currently based on 1.8; require [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>Build matching Server SDK</strong></p><p>Run the script below to download Server source and install the SDK into an isolated Maven repository:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>See the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a> for details.</p></li><li><p><strong>Packa [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>Keep the SDK repository while using this source build. The master build directory does not contain <code>incubating</code>.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-how-to-use>3 How to use</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-function-overview>3.1 Function overview</h4><p>From the extracted or generated Tools directory, run [...]
+or <code>bin/hugegraph help &lt;sub-command></code> for one command. The commands cover these tasks.</p><ul><li>Graph management type, graph-mode-set, graph-mode-get, graph-list, graph-get, graph-clear, graph-create, graph-clone and graph-drop</li><li>Asynchronous task management type, task-list, task-get, task-delete, task-cancel and task-clear</li><li>Gremlin type, gremlin-execute and gremlin-schedule</li><li>Backup/Restore type, backup, restore, migrate, schedule-backup and dump</li>< [...]
+Supply both <code>--user</code> and <code>--password</code>, or omit both.</p></blockquote><p>Use <code>export</code> to set an option for the current shell and the commands launched from it.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Global Variable</th><th scope=col>Environment Variable</th><th scope=col>Example</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGR [...]
+For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-7-viewport data-td-code-viewport><div class=highli [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>Another way is to set the environment variable in the bin/hugegraph script:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-6-vi [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>You can also set these variables in <code>bin/hugegraph</code>.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-9-viewport data- [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -1730,10 +1784,15 @@ For an authenticated Server, also provide the username and password described ab
 </span></span><span class=line><span class=ln> 7</span><span class=cl>#export HUGEGRAPH_PASSWORD=
 </span></span><span class=line><span class=ln> 8</span><span class=cl>#export HUGEGRAPH_TIMEOUT=
 </span></span><span class=line><span class=ln> 9</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_FILE=
-</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
+</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
 restore requires the graph to be in RESTORING or MERGING mode (set it with graph-mode-set first), otherwise the command fails</p></blockquote></li><li>migrate, migrate the currently connected graph to another HugeGraphServer<ul><li>&ndash;target-graph, the name of the target graph, the default is hugegraph</li><li>&ndash;target-url, the HugeGraphServer where the target graph is located, the default is http://127.0.0.1:8081</li><li>&ndash;target-user, the username used to access the targe [...]
 To customize the format, implement a <code>Formatter</code> subclass such as <code>CustomFormatter</code> under <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code>, then select it when running the command:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+and do not support current HugeGraph Server or Hubble.
+For modern deployments, follow <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server Quick Start</a>
+and <a href=/docs/quickstart/toolchain/hugegraph-hubble/>Hubble Quick Start</a>.
+The options below are retained only for maintaining legacy environments.</p><ul><li>deploy, one-click download, install and start HugeGraph-Server and HugeGraph-Studio<ul><li>-v, required, specifies the HugeGraph-Server and HugeGraph-Studio version to install, must be one of the versions listed in bin/version-map.yaml (0.6, 0.7, 0.8, 0.9, 0.10), which maps it to the matching server and studio release versions</li><li>-p, required, specifies the installed HugeGraph-Server and HugeGraph-St [...]
+Later runs without <code>-u</code> reuse the saved URL. Without either setting, the script uses <code>https://github.com/hugegraph</code>.</p></blockquote><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--39-specific-command-parameters>3.9 Specific command parameters</h5><p>The help output below lists each subcommand and its options.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=410><div class=t [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -2142,26 +2201,26 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code_ [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># Execute gremlin asynchronously</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-11-viewport data-td-code- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-14-viewport data-td-code- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># recovery graph</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># restore graph mode</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-15-viewpo [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-18-viewpo [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
 </span></span><span class=line><span class=ln>3</span><span class=cl>mvn clean package -pl hugegraph-spark-connector -am -DskipTests -ntp</span></span></code></pre></div></div></div><h4 id=pg-7a8b9421800a2b76e91d76ba1eccb218--32-build-with-default-tests>3.2 Build with default tests</h4><div class="td-code td-code--untitled" id=td-code-add49e69-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-add49e69-fence-1-view [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
@@ -2375,23 +2434,85 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span><span class=line><span class=ln>10</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND returns a list of logits per augmentation sample, and <code>NodeClassify</code> masks each element of that list before computing the loss. The complete script is <code>hugegraph-ml/src/hugegraph_ml/examples/grand_exampl [...]
+<code>Graph Tools</code> needs no model. Document vectors require embeddings; graph extraction and answers also require an LLM.
+The reranker is optional. Start with the local <code>bleu</code> method.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Task</th><th scope=col>UI tab</th><th scope=col>Prerequisites</th></tr></thead><tbody><tr><td>Build indexes from documents</td><td><code>1. Build RAG Index</code></td><td>Documents and embeddings; graph extraction also needs a schema and LLM</td></tr><tr><td>Answer from documen [...]
+then restart. This preserves an existing file. The template has all 6 columns, with a test question and expected answer; the 4 model-answer columns stay empty.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-2e1ba1fa-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-configuration-panel>0. Configuration Panel</h2><p>Above the tabs sits a collapsible configuration panel with five sections: <code>1. Set up the HugeGraph server.</code>, <code>2. Set up the LLM.</code>, <code>3. Set up the Embedding.</code>, <code>4. Set up the Reranker.</code>, and < [...]
+The screenshots use local Ollama models <code>qwen2.5:3b</code> and <code>mxbai-embed-large</code>, with <code>Faiss</code> as the vector engine.
+Rebuild indexes after changing embedding models, since vector dimensions or meaning can differ.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-build-rag-indexes>1. Build RAG Indexes</h2><p>The first tab splits documents into a chunk vector index. It also extracts vertices and edges according to a schema, writes them to HugeGraph, and maintains a vertex vector index.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[Input document] --&gt; B[Split text]
     B --&gt; C[Generate chunk vectors]
     C --&gt; D[Write vector index]
     B --&gt; E[LLM extracts vertices and edges from schema]
     E --&gt; F[Write to HugeGraph]
-    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>Common operations are <code>Import into Vector</code>, <code>Extract Graph Data (1)</code>, <code>Load into GraphDB (2)</code>, and <code>Update Vid Embedding</code>. <code>Load into GraphDB (2)</code> also refreshes the [...]
+    F --&gt; G[Update vertex vector index]</code></pre><p>Input comes from either the <code>text</code> sub-tab or the <code>file</code> sub-tab. Uploads accept <code>.txt</code>, <code>.docx</code>, and <code>.pdf</code>, and several files can be selected at once.</p><p>For a first run, paste this short document into <code>Input Doc(s)</code>. Select a dedicated test graph before importing it.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-2 data-td-code data-td-cod [...]
+It allows people and roommate relationships, with optional age and occupation.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-3 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=16><div class=td-code__viewport id=td-code-2e1ba1fa-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln> 1</span><span class=cl><span class=p>{</span>
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Follow these steps to build the indexes. For vector-only retrieval, stop after step 1.</p><ol class=steps><li>Click <code>Import into Vector</code> to split the document and build the chunk vector index.</li><li>Enter schema JSON or an existing graph name in <code>Graph Schema</code>, then click <code>Extract Graph Data (1)</code>.
+Check the vertices, edges, and properties in <code>Output Info</code>.</li><li>Click <code>Load into GraphDB (2)</code> after checking the extraction. This writes to HugeGraph and refreshes vertex embeddings.</li><li>Open <code>Graph Tools</code>. Run <code>g.V().count()</code> and <code>g.E().count()</code>, then query the properties to confirm that the data was written.</li></ol><p>This example should produce 2 vertices and 1 edge, with Sarah&rsquo;s age set to <code>30</code> and occu [...]
+If the graph already contains data, use <code>Update Vid Embedding</code> to refresh its vertex index separately.
+The <code>Graph Extraction Split Type</code> dropdown selects <code>document</code>, <code>paragraph</code>, or <code>sentence</code>.
+<code>document</code> uses the whole input; the other options split it before extraction.</p><p>The page can also inspect or clear chunk indexes, vertex indexes, and graph data. Clearing removes existing data, so first confirm that the current graph and indexes are not still used by other queries.</p><p>Two collapsed helpers sit below the main controls:</p><ul><li><code>Graph Schema Generator</code> takes query examples and a few-shot example and produces a schema for the Graph Schema fi [...]
+vector search for more comprehensive fact retrieval. Other scopes are summarized in the table above.</p><p>The screenshots use these short prompts. Paste them into <code>Query Prompt</code> and <code>Keywords Extraction Prompt</code>, respectively.
+The service fills the placeholders. Keep the <code>KEYWORDS:</code> prefix and ASCII colons in keyword output, and preserve name capitalization.</p><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><spa [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Context: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-2e1ba1fa-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1< [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>Return one line in this exact ASCII format: KEYWORDS:name:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>Question: {question}</span></span></code></pre></div></div></div><ol class=steps><li>Enter <code>Who is Sarah?</code>, set <code>Graph-only Answer</code> to <code>False</code>, and set <code>Graph-Vector Answer</code> to <code>True</code>.</li><li>Keep <code>Template Num=-1</code> and <code>Rerank method=bleu</code> for the first check, then click <code>Answer Question</code>.</li><li>Read <code>Graph-Vector Answer</cod [...]
     Q[Question] --&gt; V[Query chunk vector index]
     Q --&gt; K[Extract keywords]
     K --&gt; M[Match graph vertices]
-    M --&gt; T[Generate and execute Gremlin]
-    T --&gt;|Failure| B[Fallback to BFS graph traversal]
+    M --&gt; D{Text2Gremlin enabled}
+    D --&gt;|Yes| T[Generate and execute Gremlin]
+    D --&gt;|No| B[BFS graph traversal]
+    T --&gt;|Failure| B
     T --&gt; R[Prepare graph results]
     B --&gt; R
     V --&gt; S[Merge and rerank]
     R --&gt; S
-    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+    S --&gt; A[Generate answer]</code></pre><p>Graph retrieval first matches HugeGraph vertices exactly by keyword and then uses vector similarity if no exact match exists. The matched vertices are passed to Text2Gremlin. If generation or execution fails, the pipeline can fall back to a predefined traversal.</p><p><code>Template Num</code> controls how Text2Gremlin participates in graph retrieval:</p><ul><li>A negative value skips Text2Gremlin entirely, so graph retrieval goes straight t [...]
+The upper panel builds an example vector index from question and Gremlin pairs in <code>.json</code> or <code>.csv</code> files.
+When no file is uploaded, it uses <code>resources/demo/text2gremlin.csv</code>. Match example labels and properties to the current graph.</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>Tip</span></div><div class=td-callout__body><p>If building the example index does not automatically retrieve similar templates, you can provide few-shot examples directly  [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-2e1ba1fa-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-2e1ba1fa-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>For person-name lookups, use g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;name from question&gt;&#39;).valueMap().
+</span></span><span class=line><span class=ln> 3</span><span class=cl>Preserve name capitalization. Query by name; do not use vertex IDs.
+</span></span><span class=line><span class=ln> 4</span><span class=cl>Example question: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Example Gremlin: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>Graph schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>Additional examples: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>Known vertices: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>Question: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>Return only one ```gremlin``` code block.</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/en/text2gremlin.jpg alt="Generated Text2Gremlin queries and execution results" loading=lazy decoding=async></li></ul><p>A small model can generate incorrect IDs, change name capitalization, or use filters tha [...]
+Check the returned data before treating a query as successful. The Web UI executes generated queries directly, so use a dedicated test graph.
+To generate a query without executing it, select the corresponding output types in the <a href=/docs/quickstart/hugegraph-ai/rest-api/>REST API</a>.</p><p>A custom prompt must retain <code>{query}</code>, <code>{schema}</code>, <code>{example}</code>, and <code>{vertices}</code>. The REST API rejects it if any placeholder is missing.</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-graph-and-administration-tools>4. Graph and Administration Tools</h2><p><code>Graph Tools</code> runs a Gre [...]
+Initializing demo data first clears the current graph. Use this action only on a dedicated test graph.</p><p><code>Admin Tools</code> is password protected. Entering the configured <code>ADMIN_TOKEN</code> reveals the tail of <code>logs/llm-server.log</code>, which refreshes every 60 seconds, along with buttons to refresh or clear it. Access is refused while <code>ADMIN_TOKEN</code> is empty or still set to the placeholder <code>xxxx</code>.</p><p>When <code>ENABLE_LOGIN=True</code>, the [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> is enabled by default, so running without arguments has the same effect. On first configuration-module import, missing <code>.env</code> and prompt YAML files are created from defaults. The generator asks interactively before overwriting existing files. It handles HugeGraph, administrator, LLM, index, an [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>The same choice is available in the <code>5. Set up the vector engine.</code> panel of the Web UI, which also persists the connection settings for the selected engine.</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--login-and-log-api>Login and Log API</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=reg [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
@@ -3014,18 +3135,21 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_endpoint</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;http://minio:9000&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_access_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-access-key&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_secret_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-secret-key&#34;</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker--master-configuration>5. Worker & Master Configuration</h3><p>Configuration for worker and master computation logic.</p><h4 id=pg-094fc5e6c5eaa81703 [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker--master-configuration>5. Worker & Master Configuration</h3><p>Configuration for worker and master computation logic.</p><h4 id=pg-094fc5e6c5eaa81703 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;artifactId&gt;</span>hugegraph-client<span class=nt>&lt;/artifactId&gt;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>        <span class=c>&lt;!-- The complete examples below work with the published 1.7.0 client --&gt;</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>    
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>The complete examples below use Schema, Graph, Gremlin and resource-cleanup APIs available in the published Client <code>1.7.0</code>
-and compatible with Toolchain <code>master</code>. Use the dependency above directly in your example project.</p><p>For new master APIs in the <a href=/docs/clients/hugegraph-client/>API reference</a>, such as capability detection, use Client <code>1.8.0</code>
-from Toolchain <code>master</code> and change the POM version to <code>1.8.0</code>. If that version is not published to Maven yet, run the following
-command from the Toolchain source root to install the Client and its parent POM locally. The source build still needs
-its dependencies available from your configured Maven repositories.</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-440b860c-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -Dskip [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>Choose the client version before building:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Use case</th><th scope=col>Client version</th><th scope=col>Java build target</th></tr></thead><tbody><tr><td>Run the complete examples below</td><t [...]
+The release&rsquo;s Java build target does not describe the runtime requirements of every transitive dependency.</p><p>To use unreleased features from the master branch, build Client from source (see <a href=/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools source build instructions</a>):</p><div class="td-code td-code--untitled" id=td-code-440b860c-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>Both version checks must report JDK 17. Also pass <code>-Dmaven.repo.local="$candidate_dir/m2"</code> to Maven commands in projects using Client from master.
+Client and Server versions need not be identical; check the required APIs and compatibility before upgrading.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>Choose a single-record or batch example. Save the complete code as <code>src/main/java/SingleExample.java</code> or
+<code>src/main/java/BatchExample.java</code> in your Maven project. The copy button includes the folded lines.</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-440b860c-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea1298 [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -3173,7 +3297,7 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-440b860c-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=138><div class=td-code__viewport id=td-code-440b860c-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -3310,7 +3434,9 @@ its dependencies available from your configured Maven repositories.</p><div clas
 </span></span></span><span class=line><span class=ln>135</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><p>Before running Example, you need to start the Server. For the startup process, see<a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph-Server Quick Start</a>.</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5  [...]
+</span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-run-the-example>4.4 Run The Example</h4><ol class=steps><li><a href=/docs/quickstart/hugegraph/hugegraph-server/>Start HugeGraph Server</a> and prepare a test graph named <code>hugegraph</code> in graphspace <code>DEFAULT</code>.</li><li>Set the Maven project&rsquo;s JDK to 17. In  [...]
+and <code>configUser(...)</code> with your settings. Omit <code>configUser(...)</code> if Server does not require authentication.</li><li>Run <code>SingleExample.main()</code> or <code>BatchExample.main()</code> in your IDE. Both examples create schema and graph data, print the results, and close the client.
+Use a test graph: existing schema or data can affect repeated runs.</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-more-information-about-client-api>4.5 More Information About Client-API</h4><p>See<a href=/docs/clients/hugegraph-client/>Introduce basic API of HugeGraph-Client</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>5.2 - HugeGraph Python Client Quick Start</h1> [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># Alternatively: pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>These commands do not pin a version and install the latest release; see <a href=https://pypi.org/project/hugegraph-python/>PyPI</a>. The source directory is <code>hugegraph-python-client</code>, while the distribution is <code>hugegraph-python</code>. Install from the HugeGraph-AI workspace for master code. [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
diff --git a/_print/docs/quickstart/toolchain/index.html b/_print/docs/quickstart/toolchain/index.html
index ba8ea89ff..d11356b14 100644
--- a/_print/docs/quickstart/toolchain/index.html
+++ b/_print/docs/quickstart/toolchain/index.html
@@ -12,17 +12,21 @@ provides complete orchestration for PD, Store, Server, and Hubble. Follow the ad
 then launch services from <code>docker/</code> without maintaining separate Compose files.
 The guidance below focuses on connectivity and operations; ensure prerequisite credentials and service readiness from the README are met.
 Docker <code>latest</code> is a moving tag. Screenshots assist in UI navigation; verify deployed versions via image digests and build details.
-Metrics and permission APIs vary by version.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
-and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e0 [...]
+Metrics and permission APIs vary by version.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
+and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|Graph API| S[Server]
+    S --&gt;|Graph reads and writes| T[Store]
+    H -.-&gt;|Discovery and cluster information| P[PD]
+    H -.-&gt;|Node metrics| T</code></pre><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=highlight><pre t [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>The script reads <code>HG_PD_AUTH_SECRET_KEY</code> from <code>.env</code> and writes its value as <code>operations.pd.password</code> into the generated file
 <code>docker/conf/hubble/hstore.local.properties</code>. Edit this generated file to adjust connection or operations settings (do not overwrite
 the tracked <code>.example</code> template), ensuring <code>operations.pd.password</code> matches the PD secret. Compose mounts this file read-only into
 the container; do not edit inside the container. Both <code>.env</code> and the generated file contain secrets and should not be committed to Git.
-Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=h [...]
+Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=h [...]
 <a href=/docs/quickstart/hugegraph/hugegraph-hstore/>HStore deployment guide</a>. A source or binary Hubble deployment instead uses the package&rsquo;s
-<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
+<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Setting</th><th scope=col>Purpose</th><th scope=col>Bundled value</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>Explicitly enable PD mode; <c [...]
@@ -30,7 +34,7 @@ rather than <code>127.0.0.1</code> for cross-container traffic.
 The bundled package sets <code>pd.enabled=false</code>. If omitted, the fallback default is <code>true</code>, so declare this setting explicitly in both standalone and distributed
 setups.
 After editing configuration: restart the Hubble process for source or binary deployments; for Docker Compose, recreate the Hubble container from <code>docker/</code>
-to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
+to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
 so each team can work with its own graphs. Modeling, importing, and querying within a space follow the standalone guide.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--create-and-adjust-a-graphspace>Create and adjust a GraphSpace</h3><p>With Server authentication enabled, creating, editing, and deleting GraphSpaces require super administrator access.
 Start with a globally unique GraphSpace name, an optional display alias, and the maximum graph count.
 For example, use <code>research</code> as the API identifier and “Research_graph” as the display alias.
@@ -39,7 +43,7 @@ Choose GraphSpace administrators from existing accounts.</p><p>“Advanced deplo
 plus the storage capacity limit. These deployment quotas neither report current usage nor resize existing containers.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Advanced deployment defaults</span></div><div class=td-callout__body><p>Defaults are 100 graphs, 64 CPU cores and 128 GB of memory for each of the graph and compute services, and 1000000 GB of storage.
 Keep the defaults for a container trial. Configure Kubernetes namespaces, Operator images, and algorithm images only for the corresponding deployment
 or compute use.</p></div></div><p>Select a space before opening a graph. Check the current graph after switching spaces, especially when spaces contain identically named graphs.
-The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation and advanced resource limits" width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema within a GraphSpace.
+The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation form and entry to advanced resource limits" width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema  [...]
 When several business graphs share vertex labels, edge labels, and indexes, save the model as a template and select it when creating subsequent graphs.
 For example, a user template in <code>research</code> can be reused for new graphs in that space. After switching spaces, select a template belonging to the new space.</p><p>User templates differ from the built-in sample templates in the main guide: built-in templates help explore preset models,
 while user templates preserve your own models for future use. A template is not an import of data; loading sample data is a separate graph creation choice.
@@ -53,7 +57,7 @@ Accounts and space memberships are managed separately; removing a member does no
 After creating an account, continue directly to assigning space access. When changing an existing membership, check the selected space and preset
 and preserve permissions still needed in other spaces. Enabling <code>pd.enabled</code> grants no permissions;
 legacy custom roles on older Servers are not interchangeable with these presets.
-See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to fi [...]
+See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to f [...]
 PD Leader, online Store count, graphs, partitions, replicas, and data size help identify cluster scale and nodes requiring attention.
 Partitions and replicas describe data distribution. Data size is observed usage, distinct from a GraphSpace&rsquo;s configured storage limit.</p><p>Start with cluster and source status, then inspect an affected node. <code>UP</code> indicates a successful collection from the source;
 <code>DEGRADED</code> indicates a cluster or partial source issue, and <code>DOWN</code> indicates that the corresponding probe failed.
@@ -66,32 +70,32 @@ GraphSpace administrators and ordinary members do not inherit cluster access.
 Use container isolation, a trusted HTTPS entrypoint, Server authentication, and network allowlists; avoid publishing Hubble or component ports directly.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--configure-operations-access>Configure operations access</h3><p>Hubble&rsquo;s <strong>backend</strong> uses the PD/Store operations credentials, separately from the Server account used to log in through the browser.
 For Compose, edit the generated host file <code>docker/conf/hubble/hstore.local.properties</code>; other deployments use the Hubble package configuration.
 The script-generated PD password must match the secret in <code>.env</code>. Configure the Store service account when Store authentication is enabled.
-Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
+Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
 matching the Store metric target returned by PD. Adding an origin here only authorizes access—it does not register or discover nodes.</p><p>If topology renders but node metrics are missing, check Hubble backend connectivity and credentials to PD REST, verify the Store REST and metric addresses
 returned by PD, and ensure targets are in <code>operations.store.allowed_targets</code>. A partially available overview indicates metrics collection was blocked for
 specific sources, not that graph APIs are down.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-55eecaa5c3ceec829e0f0d20863baa46>2 - Graph Visualization with Hubble: Standalone Quick Start</h1><div class=lead>Use Hubble and RocksDB Server to manage schema, import CSV, and query graph data with Gremlin, Cypher, or Text2GQL.</div><template data-hg-authored-content=start></template><p>Hubble is the HugeGraph Web manag [...]
 and switch smoothly between graph, table, and JSON results. This guide uses <strong>standalone RocksDB Server + Hubble</strong>, without requiring PD or Store.</p><p>For use with an HStore distributed cluster, read the foundational operations here first, then consult the
 <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a>.
-This guide aligns with the Toolchain and Server <code>master</code> branches (both currently <code>1.8.0</code>).</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>Warning</span></div><div class=td-callout__body><p>Do not expose unauthenticated Hubble or Server instances directly to the public internet. In production, use HTTPS, container isolation,
-<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start the standalone pair</h2><p>Use the main repository&rsquo;s <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a>
+This guide aligns with the Toolchain and Server <code>master</code> branches (currently based on 1.8, unreleased). Docker <code>latest</code> is a moving tag; use released versions for production deployments.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" a [...]
+<a href=/docs/config/config-authentication/>authentication and authorization</a>, and network allowlists.</p></div></div><p>Jump directly to a task below. If this is your first visit, start with the standalone deployment:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--start-the-standalone-pair>Start and load a sample</a></p><p>Start the two services and load the People & Software Demo Graph.</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-workspa [...]
 instead of writing custom Compose files. It already integrates RocksDB Server and Hubble with networking, health checks, and data volumes;
-see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span>< [...]
+see the adjacent <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a> for deployment details.</p><ol class=steps><li><p><strong>Prepare the official Compose configuration.</strong></p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cb6cacef-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>If you already have the repository locally, navigate directly to its <code>docker/</code> directory. Compose automatically mounts
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 which pre-configures <code>pd.enabled=false</code> and <code>server.direct_url=http://server:8080</code>. Because both services communicate over a shared Docker network,
 you do not need to configure Server endpoints per graph. Start Compose directly from <code>docker/</code> so relative file paths resolve correctly.</p><p>Hubble publishes on host loopback port <code>8088</code> by default (controlled by <code>HUBBLE_PUBLISH_HOST</code>, defaulting to <code>127.0.0.1</code>), whereas Server publishes
 <code>8080</code> across all interfaces. For a local trial, set Server&rsquo;s <code>ports</code> in Compose to <code>127.0.0.1:8080:8080</code> to prevent exposing unauthenticated ports
-beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chrom [...]
+beyond loopback (set <code>HUBBLE_PUBLISH_HOST=0.0.0.0</code> if remote access to Hubble is required).</p></li><li><p><strong>Start and check the services.</strong></p><p>Choose an unused project name for this trial and keep these variables in the same terminal session:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-1-viewport data-td- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>Open Hubble.</strong></p><p>Once services are healthy, open <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>. When <code>HUGEGRAPH_ADMIN_PASSWORD</code> is unset in <code>.env</code>,
 Server permits anonymous access and Hubble opens the homepage directly. If authentication is enabled, configure an admin password and JWT secret in <code>.env</code>
 as described in the Docker README, then sign in with a Server account (Hubble has no independent user database).
-Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
+Profile and account management options appear only when authentication is enabled and the account holds requisite permissions.</p></li></ol><p>Use <code>latest</code> to explore recent features; pin a released image version or digest for production. Official release archives are on the
 <a href=/docs/download/download/>download page</a>.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Verify the deployed versions</span></div><div class=td-callout__body><p>Screenshots help locate controls. Verify actual versions from the deployed image digests and build information.</p></div></div><p>Compose&rsquo;s <code>server-data</code> and <code>hubble-data</code>  [...]
 see the <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server deployment guide</a>.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--home-find-the-right-starting-point>Home: find the right starting point</h2><p>Home groups the workspace into graph overview, data preparation, and graph queries. Use it to understand the workflow,
 then return to any section through the sidebar. The top graph selector determines the target of queries, schema operations, and async tasks;
@@ -111,15 +115,13 @@ Use <strong>New</strong> to create elements, or edit existing data when authoriz
 adding or editing elements via the UI or executing Gremlin write statements modifies underlying Server graph data.</p><p>Press <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> to execute queries quickly. Immediate execution is ideal for interactive exploration; submit long or resource-intensive
 queries as background async tasks. Cypher is available when supported by the backend Server.
 The keyboard shortcut acts on whichever input currently has focus: generating a query from
-the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>Note</span></div><div class=td-callout__body><p>The Text2GQL backend capabilities (including Model settings, built-in/temporary models, and Prom [...]
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> or a release containing it.
-Earlier builds display a preview tab without model management.</p></div></div><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
+the natural language prompt, or running statements in the code editor.</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL natural-language queries</h3><p>Describe your query requirement in the <strong>Natural language</strong> input. Text2GQL combines the current graph schema to generate read-only Gremlin or Cypher
 and execute it automatically. Generated statements can be edited freely (read-only safety checks still apply before execution).
 In <strong>Async</strong> mode, both generated and handwritten queries can be submitted as background tasks.
-Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL query and graph results" loading=lazy decoding=async><p class=td-gallery__description>Query workspace</p></li><li class=td-gallery__item><img class=td-gall [...]
+Inputs automatically restore the graph&rsquo;s most recent query prompt without running it, and the execution history retains original natural-language questions.</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/docs/images/hubble/text2gql.jpg alt="Text2GQL entry and handwritten query results" loading=lazy decoding=async><p class=td-gallery__description>Unconfigured model; handwritten query</p></li><li class=t [...]
 The Base URL must be reachable from Hubble&rsquo;s backend; container <code>localhost</code> refers to that container. Public endpoints require HTTPS, while plain HTTP is
 accepted only for loopback or private-network models; when changing the Base URL in Model settings, supply a new Key or explicitly clear the saved Key.
-Only the <code>admin</code> account (a super administrator in PD mode) manages shared settings. When Server authentication is disabled, anyone who can access the
+Administrators with model-settings management permission manage shared settings. When Server authentication is disabled, anyone who can access the
 deployment can manage them.</p><p>Under model settings, click <strong>Text2GQL Prompt</strong> in the header to customize Gremlin and Cypher generation rules and few-shot examples.
 Click <strong>Apply</strong> and then save model settings to persist templates to the H2 database for both built-in and temporary models.
 The current graph schema is appended automatically during generation.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Key storage and privacy notes</span></div><div class=td-callout__body><p>When backing up the Hubble H2 database, always back up the master-key file (<code>data/text2gql-master.key</code> by default); losing it prevents decrypting saved Keys.
@@ -130,7 +132,7 @@ Start with a known vertex ID and limit direction, edge labels, depth, and result
 Results use graph or algorithm-specific panels. Consult the help and documentation links beside the algorithm title for definitions and parameters.
 While the parameter form is focused, <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> runs the current algorithm.</p><p>OLAP batch algorithms require external compute services such as Computer or Vermeer.
 The two containers in this example provide online graph operations, not those compute services.</p><p>For example, select K-neighbor (GET) with <code>source=1:marko</code>, <code>max_depth=1</code>, and <code>limit=20</code>.
-After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, incl [...]
+After parameter validation, use the run button on the card or the form shortcut to explore one-hop neighbors.</p><img class=td-image src=/docs/images/hubble/algorithms.jpg alt="Built-in neighbor algorithm parameters and graph result" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--async-tasks-confirm-background-results>Async Tasks: confirm background results</h2><p><strong>Async Tasks</strong> lists background work for the current graph, inc [...]
 Filter by task type and status, inspect IDs, creation times, and execution states, open successful query results, or expand failure information.
 Completed task records can be deleted where the interface permits. These tasks are separate from import execution history.</p><p>For example, submit <code>g.V().count()</code> asynchronously, confirm success in the list, then inspect the returned count.
 A successful submission means the request was accepted, not that computation or indexing has finished.
@@ -161,7 +163,7 @@ The following presets are for PD mode, and are not universally editable on older
 Before replacing custom permissions with a preset, inspect the grants that need to be retained; complex permissions may not match a single preset.
 After changes, refresh permission context or sign in again and verify menus and space selection. Server still validates every request.
 Older Servers may hide or disable unsupported operations; a visible button alone does not establish resource authorization.
-See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in PD mode" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Information< [...]
+See the <a href=/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>distributed supplement</a> for space management.</p><img class=td-image src=/docs/images/hubble/accounts.jpg alt="Authenticated account list in standalone mode" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--operations-inspect-the-standalone-server>Operations: inspect the standalone Server</h2><p>Standalone <strong>Operations</strong> provides <strong>Node Inf [...]
 Search nodes, filter health status, and open node details to inspect available version, system, JVM, and Server-backend metrics.
 When metrics are unavailable or stale, use collection state and the last successful observation time;
 a missing value is neither zero nor proof of health.</p><p>Anonymous mode can read operations information. With authentication enabled, operations are available only to administrators with the capability.
@@ -169,15 +171,12 @@ This is an observation and diagnosis interface, not a start/stop or scaling cons
 The distributed supplement covers cluster overview and the PD/Store node hierarchy.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--keyboard-shortcuts-and-graph-interactions>Keyboard shortcuts and graph interactions</h2><p>Use the topbar shortcut-help button to see key bindings. Their scope differs: typing <code>?</code> in an input does not trigger global help.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr>< [...]
 it is not a universal hard limit. <code>gremlin.vertex_degree_limit</code> (<code>100</code>) and <code>gremlin.edges_total_limit</code> (<code>500</code>) constrain expansion.
 FILE uploads allow <code>csv,txt</code> by default, with 1 GB per file and 10 GB total. Override <code>upload_file.*</code> settings when needed.</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--stop-the-trial-or-build-from-source>Stop the trial or build from source</h2><p>When finished, run this in the main repository&rsquo;s <code>docker/</code> directory:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td [...]
-To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>To obtain an exact master build, use JDK 17 and Maven. The Maven plugin installs the required Node/Yarn;
-you do not need to install them separately. These commands skip tests:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branc [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># Edit conf/hugegraph-hubble.properties with the correct Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
+To retain data, omit <code>--volumes</code> when taking the deployment down and reuse the same project name when starting it again.</p><p>Building current master requires <strong>JDK 17, Maven 3.9+, Python 3.9+, and stable Node.js 24 (at least 24.22.0)</strong>,
+with <strong>pnpm 12.14.0</strong> selected through Corepack. Maven no longer installs Node/Yarn automatically.</p><ol class=steps><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration instructions</a>
+to install the Server SDK in an isolated Maven repository.</p></li><li><p>Follow the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble source-build procedure</a>
+to install Python dependencies and build Client, Loader, and Hubble with that same repository (skipping tests).</p></li><li><p>Open the resulting <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> directory,
+configure Server connection settings in <code>conf/hugegraph-hubble.properties</code>, then start:</p><div class="td-code td-code--untitled" id=td-code-cb6cacef-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cb6cacef-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hu [...]
+Old metadata has no automatic migration and cannot be reused directly.</p><p>The bundled configuration binds to <code>localhost:8088</code>. <code>bin/stop-hubble.sh</code> requests graceful shutdown before forcing termination on timeout.
 For development and testing, see the <a href=/docs/guides/toolchain-local-test/>Toolchain local test guide</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>3 - Graph import</h1><template data-hg-authored-content=start></template><p>Choose an import tool when you need to write file, database, or message data into HugeGraph. Use Loader for a direct import, SeaTunnel Sink when an e [...]
 All examples use the <code>mappings</code> configuration available in SeaTunnel 3.0+.</p></blockquote><p><a href=/docs/images/seatunnel/seatunnel-vs-loader-en.png><img class=td-image src=/docs/images/seatunnel/seatunnel-vs-loader-en.png alt="Loader imports data directly with graph mappings; SeaTunnel 3.0+ combines Source, Transform, and Sink, and both support JDBC, Kafka, and graph data" loading=lazy decoding=async></a></p><p>Click a diagram to view the original size.</p><h2 id=pg-b8e8e0 [...]
 lists Java 8 and 11 as prerequisites. Choose a 3.0+ binary distribution from the
@@ -311,10 +310,63 @@ as needed<sup>[11][12]</sup>. The JDBC examples also require the MySQL driver JA
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
-check the version you use and build from source for unreleased functionality.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader is the data import component of HugeGraph, which can convert data from various data sources into graph vertices and edges and import them into the graph database in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and J [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).
-Older Servers retain the legacy import behavior described below.</p></blockquote><blockquote><p><strong>Testing Guide</strong>: For running HugeGraph-Loader tests locally, please refer to <a href=/docs/guides/toolchain-local-test/>HugeGraph Toolchain Local Testing Guide</a></p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>2 Get HugeGraph-Loader</h3><p>HugeGraph-Loader is available in the following three ways:</p><ul><li>Use docker image (Convenient for T [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-edb994a7-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-edb994a7-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+First <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-get-hugegraph-loader>install Loader</a> and start <a href=/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>.
+The commands below run from the Loader directory, importing into the default graph <code>hugegraph</code>.
+For an authenticated Server, append <code>--username</code> and <code>--password</code> (or <code>--token</code>).</p><ol class=steps><li><p><strong>Create the data files.</strong></p><p>These CSV files have no header row. The mapping in the next step supplies the column names.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-8a011ca1-fence-0-viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Create the schema and mapping.</strong></p><p>Dedicated <code>docs_*</code> names keep this example separate from the built-in <code>person</code> data.
+File paths are relative to the directory where you run Loader.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-8a011ca1-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class [...]
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>Run the import.</strong></p><p>Keep the same working directory. Change the host and port if Server runs elsewhere.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-2-viewpor [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>A first successful run imports two vertices and one edge. Check the success and failure counts in the summary.</p></li><li><p><strong>Query the result in Hubble.</strong></p><p>Connect Hubble to the same Server and graph, then run these queries separately in the Gremlin workspace.</p><div class="td-code td-code--unt [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>The first query returns Alice with age <code>29</code> and Bob with age <code>31</code>. The second returns <code>docs-sm [...]
+The <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>bundled full example</a> also includes software vertices and edge properties.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-overview>1 HugeGraph-Loader Overview</h3><p>HugeGraph-Loader converts source data into graph vertices and edges and imports them into HugeGraph in batches.</p><p>Currently supported data sources include:</p><ul><li>Local disk file or directory, supports TEXT, CSV and JSON format [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -329,10 +381,12 @@ Older Servers retain the legacy import behavior described below.</p></blockquote
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>The specific data loading process can be referenced under <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 User Docker to load data</a></p><blockquote><p>Note:</p><ol><li><p>The docker image of hugegraph-loader is a convenience release to start hugegraph-l [...]
-A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Clone the <code>master</code> branch:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=t [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extracted Loader <code>lib/</code> directory.
-The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>The basic process of using HugeGraph-Loader is divided into the following steps:</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-g [...]
-&ldquo;Software&rdquo; includes: &ldquo;name&rdquo;, &ldquo;sale price&rdquo; and other attributes; side &ldquo;knowledge&rdquo; includes: &ldquo;date&rdquo; attribute and so on.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>After designing the graph model, we can use <code>groovy</code> to write the definition of <code>schema</code> a [...]
+A release may not include all <code>master</code> functionality; use the source build below for the implementation described here.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-clone-source-code-to-compile-and-install>2.3 Clone source code to compile and install</h4><p>Building Loader from the master branch requires Java 17, Maven 3.6.3+, and Python 3.9+. Clone the repository and build:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-au [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>To build against candidate Server SDKs during development, refer to the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a>.</p><p>For Oracle input, obtain a JDBC driver JAR compatible with your Oracle/JDK versions and place it in the extrac [...]
+The startup script loads JARs there; installing a driver only in the local Maven repository does not put it on Loader’s runtime classpath.</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-how-to-use>3 How to use</h3><p>To import a dataset, prepare the schema, data and mapping, then run Loader.</p><ul><li>Write graph schema</li><li>Prepare data files</li><li>Write input source map files</li><li>Execute command import</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-construct-graph- [...]
+People have names, ages and cities; software has a name and price. Each edge records a date.</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt="Example graph with person and software vertices connected by knows and created edges"><p>graph model example</p></div><p>Save the schema definitions in <code>schema.groovy</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-lin [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -347,19 +401,23 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// Create the knows edge type, which goes from person to person
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// Create the created edge type, which points from person to software
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+Column names can come from a header row or from the mapping&rsquo;s <code>header</code> setting.</p><p>An example is as follows:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-7 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</sp [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-6-viewport data-td-code-view [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If the id strategy of person or software is specified as PRIMARY_KEY when modeling (schema), choose name as the primary key (note: this is the concept of vertex-label in hugegraph), when importing edge data, the source vertex and target need to be spliced ​​out. For the id of the vertex, you must go to the person/software table with p_id/s_id to find [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV is a TEXT file with commas <code>,</code> as delimiters. When a column value itself contains a comma, the column value needs to be enclosed in double quotes, for example:</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>The JSON file requires that each line is a JSON string, and the format of each line needs to be consistent.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-9-viewport data-td-code-view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+Each input row must provide the values needed to construct its graph elements. Prepare any joins in the source query first.</p><p>Consider three tables named <code>person</code>, <code>software</code> and <code>created</code>.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-10-viewport data-td-code-viewport><div class=highlight><pre ta [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>If <code>person</code> and <code>software</code> use <code>PRIMARY_KEY</code> IDs with <code>name</code> as the primary key, each edge needs its endpoints&rsquo; names.
+The <code>created</code> table contains only <code>p_id</code> and <code>s_id</code>; Loader will not query the names from those IDs. Use either of these ID designs.</p><ol><li>Keep <code>PRIMARY_KEY</code> and use each vertex table&rsquo;s <code>id</code> column as its primary key property.
+Loader can then build endpoint IDs from <code>p_id</code>, <code>s_id</code> and the vertex labels.</li><li>Use custom IDs, taking each vertex table&rsquo;s <code>id</code> column as the vertex ID. The edge mapping can use <code>p_id</code> and <code>s_id</code> directly.</li></ol><p>Both designs let edge rows supply endpoint IDs without another lookup.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-prepare-vertex-and-edge-data>3.2.2 Prepare vertex and edge data</h5><h6 id=pg-85740db [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software vertex data (the data itself contains the header)</li></ul><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport  [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-edge-data>3.2.2.2 Edge data</h6><p>The edge data file consists of data line by line. Generally, each line is used as an edge. Some columns are used as the IDs of the source and target vertices, and other columns are used as edge attributes. The foll [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-write-data-source-mapping-file>3.3 Write data source mapp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -376,7 +434,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>Two versions of the mapping file are given directly here (the above graph model and data file are described)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 2.0</ [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -574,7 +632,7 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-16 data-td [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Click to expand/collapse the mapping file for version 1.0</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-19 data-td [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -625,8 +683,8 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
-(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>The 1.0 version of the mapping file is centered on the vertex and edge, and sets the input source; while the 2.0 version is centered on the input source, and sets the vertex and edge mapping. Some input sources (such as a file) can generate both vertices and edges. If you write in the 1.0 format, you need to write an input block in ea [...]
+(see has_header). JSON does not require a header; optional;</li><li>has_header: for CSV and TEXT, the first line of every file is dropped when it is identical to the header, so a header repeated in each part file of a directory is not imported as data. Set this to <code>false</code> to turn that check off when the first line of a file is real data that happens to equal the header, optional;</li><li>delimiter: The column delimiter of the file line. The default depends on <code>format</cod [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -655,59 +713,24 @@ The startup script loads JARs there; installing a driver only in the local Maven
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// If there is no update strategy, you will get
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>Note</strong> : After adopting the batch update strategy, the number of disk read requests will increase significantly, and the import speed will be several times slower than that of pure write coverage (at this [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 If the argument file contains credentials, restrict it to mode <code>0600</code> with <code>chmod 0600 loader.args</code>.
 The <code>@file</code> form keeps credential values out of process arguments.
 Loader must be able to create and write the mapping-prefix directory used for progress output.
-Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>Usually, the Loader task takes a long time to execute. If the import interrupt process exits for some reason, and next time you want to continue the import from the interrupted point, this is the scenario of using breakpoint continuation.</p><p>Set <code>--incremen [...]
+Copy a mapping mounted from a read-only Kubernetes ConfigMap to a writable volume before running Loader.</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-breakpoint-continuation-mode>3.4.2 Breakpoint Continuation Mode</h5><p>For a long import, use a progress file to resume after an interruption.</p><p>Set <code>--incremental-mode</code> to <code>true</code> to resume from a progress file. Loader records progress when it closes normally after a successful import
 or a normal stop; an unexpected failure may prevent this write.
 The progress file is in <code>${struct}</code> and named <code>load-progress_${timestamp}</code>, where <code>${struct}</code> is the mapping-file prefix and <code>${timestamp}</code> is the
 import start time, formatted as <code>yyyyMMdd-HHmmss</code>. For example, an import started at <code>2019-10-10 12:30:30</code> with mapping file <code>struct-example.json</code>
 writes <code>struct-example/load-progress_20191010-123030</code>. When the directory holds several progress files, the resumed import reads the last one in name
 order, which is the most recent one.</p><blockquote><p>Note: A progress file is written after a successful import or a normal stop (including an error limit), regardless of <code>--incremental-mode</code>
-or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>If the data file formats are all legal and the import task is stopped by the user (CTRL + C or kill, kill -9 is not supported), that is to say, if there is no error record, the next import only needs to be set to
-Continue for the breakpoint.</p><p>But if the limit of &ndash;max-read-errors, &ndash;max-parse-errors or &ndash;max-insert-errors is reached because too much data is invalid or network abnormality is reached, Loader will record these original rows that failed into
-the failure file, after the user modifies the data lines in the failure file, set &ndash;failure-mode to true to import these &ldquo;failure files&rdquo; as input sources (does not affect the normal file import),
-Of course, if there is still a problem with the modified data line, it will be logged again to the failure file (don&rsquo;t worry about duplicate lines, they are dropped when the file is closed). Failure mode lifts the three error limits above, so the whole failure file is scanned.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error [...]
+or <code>--print-progress</code>. An import aborted by an unexpected failure may not write one.</p></blockquote><p>After stopping an import with <code>Ctrl+C</code> or <code>kill</code>, set <code>--incremental-mode true</code> to continue from the recorded position.
+A forced stop with <code>kill -9</code> cannot save progress.</p><p>Invalid data or connection failures can exhaust <code>--max-read-errors</code>, <code>--max-parse-errors</code> or <code>--max-insert-errors</code>.
+Correct the rows in the failure files, then use <code>--failure-mode true</code> to retry them. This leaves the original data files unchanged.
+Rows that still fail are recorded again and deduplicated when the failure file closes. Failure mode lifts these three limits and scans the entire file.</p><p>Each input source, that is each item of <code>structs</code> in the mapping file, gets its own failure file. The file is named after the <code>id</code> of that input source with the suffix <code>.error</code> and is stored in the <code>${struct}/failure-data</code> directory.
 Every failed line is written as a pair of lines: a tip line starting with <code>#### READ ERROR:</code>, <code>#### PARSE ERROR:</code> or <code>#### INSERT ERROR:</code>, followed by the original data line. When the input source has a header, that header is written as JSON to a sibling <code>${id}.header</code> file, so the failure file can be read back with the right columns.
-For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p>The CSV has no header row; <code>input.header</code> in the mapping supplies column names. <code>input.path</code> is relative to the Loader process working directory, so keep running from the installation directory. If Server runs in another container, set <code>--host</code> to a Server address reachable by Loader:</p><div class="td-code t [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>Expected result: two vertices and zero edges imported. This example uses dedicated schema names to avoid conflicts with a preloaded <code>person</code> label. In Hubble, run <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code> to confirm <code>docs-smoke-alice</code> and <code>docs-smoke-bob</code>.< [...]
-(requires a Server whose <code>GET .../mode/owners</code> returns <code>protocol: 1</code> and a matching Loader; current <code>master</code> does not include it yet).</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+For example, if the mapping file has an input source with id <code>1</code> holding a vertex mapping person and an input source with id <code>3</code> holding an edge mapping knows, each of which has some error lines, you will see the following files in the <code>${struct}/failure-data</code> directory when the Loader exits:</p><ul><li>1.error: the failed lines of input source 1, each preceded by its tip line</li><li>1.header: the header of input source 1, written only when that input so [...]
+When the deployed Server provides this endpoint and returns <code>protocol: 1</code>, Loader enables ownership protection automatically; released Server 1.7.0 and older versions continue using the legacy mode switching flow.</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;Graph Mode: NONE&#34;] --&gt;|First Loader acquires owner| B[&#34;LOADING Mode (Acquires Token)&#34;]
     B --&gt;|Concurrent Loaders join| B
     B --&gt;|Loader finishes &amp; releases| B
@@ -724,18 +747,19 @@ Network or permission errors, or a <code>404</code> for a missing graph, do not
 manually reset graph mode to <code>NONE</code> before starting ordinary imports.
 Do not run restore, graph-source, Spark connector, or older Loader imports while owned imports are active.</li><li><strong>Scope & Lifecycle</strong>: Ownership is bound to the target Server instance without cross-node synchronization or automatic lease expiry.
 For embedded programmatic integrations, callers must invoke <code>HugeGraphLoader.shutdown()</code> to attempt a single graceful release. If release
-fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>Given below is an example in the example directory of the hugegraph-loader package. (<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub address</a>)</p><h4 id=pg-85740db4cef1a86c [...]
+fails, the handle is not retried; the owner may remain active on the Server, and the administrator recovery step above may be required.</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-complete-example>4 Complete example</h3><p>The Loader distribution includes this dataset in <code>example/file/</code>.
+See the <a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>source files</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-prepare-data>4.1 Prepare data</h4><p>Vertex file: <code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=6><div class=td-code__viewport id=td-code-8a011ca1-fence-28-viewp [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>Vertex file: <code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-8a0 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>Edge file: <code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-8a011ca1-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -758,7 +782,7 @@ fails, the handle is not retried; the owner may remain active on the Server, and
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> uses custom numeric IDs: mapping <code>id</code> supplies the vertex ID and <code>created.target_id</code> supplies the edge’s target ID.
-Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
+Run this example in an empty graph without these schema labels; <code>ifNotExist()</code> does not replace incompatible existing definitions.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-write-the-input-source-mapping-file-examplefilestructjson>4.3 Write the input source mapping file <code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__l [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -818,7 +842,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-33-viewport data-td-code-viewport><div class=highlig [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-command-to-import>4.4 Command to import</h4><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-8a011ca1-fence-34-viewport data-td-code-viewport><div class=highlig [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -830,7 +854,7 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-use-docker-to-load-data>4.5 Use Docker to load data</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-use-docker-exec-to-load-data-directly>4.5.1 Use docker exec to load data directly</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-prepare-data>4.5.1.1 Prepare dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -838,11 +862,11 @@ Run this example in an empty graph without these schema labels; <code>ifNotExist
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>Copy the files into the container.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Taking the built-in example dataset as an example, we can use the following command to load the data.</p><p>If you need to import your custom dataset, you need to modify the paths for <c [...]
-Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-data-loading>4.5.1.2 Data loading</h6><p>Run this command to import the built-in dataset.</p><p>For custom data, set <code>-f</code> to your mapping file and <code>-s</code> to your schema file.</p><p>You can refer to <a href=# [...]
+Changing only <code>-f</code> and <code>-s</code> does not change where Loader looks for data files.</p><blockquote><p>If <code>loader</code> and <code>server</code> are in the same Docker network, you can specify <code>-h {server_container_name}</code>; otherwise, you need to specify the IP of the <code>server</code> host (in our example, <code>server_container_name</code> is <code>server</code>).</p></blockquote><p>Then we can see the result:</p><div class="td-code td-code--untitled" i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -864,19 +888,31 @@ Changing only <code>-f</code> and <code>-s</code> does not change where Loader l
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>You can also use <code>curl</code> or <code>hubble</code> to observe the import result. Here&rsquo;s an example using <code>curl</code>:</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-these two-parameter names have overlapping parts, please use the full name of the parameter.
-And there is no need to guarantee the order between the two parameters.</p><ul><li>hugegraph parameters (Reference: <a href=https://hugegraph.apache.org/docs/quickstart/toolchain/hugegraph-loader/#341-parameter-description>hugegraph-loader parameter description</a> )</li><li>Spark task submission parameters (Reference: <a href=https://spark.apache.org/docs/3.3.0/submitting-applications.html#content>Submitting Applications</a>)</li></ul><p>Example:</p><div class="td-code td-code--untitled [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> submits <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code> through <code>${SPARK_HOME}/bin/spark-submit</code>, so <code>SPARK_HOME</code> has to point at a Spark installation. Every jar u [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> is treated separately: with <code>--deploy-mode cluster</code> the mapping file is shipped to the executors through <code>--files</code> and the loader receives only its base name, otherwise the path is passed through as written.</p><p>In this mode the loader reads FILE,  [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migration [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>Query the imported data with Hubble or <code>curl</code>.</p><p>These requests use the GraphSpace-aware Server API. For an older Server, omit <code>/graphspaces/DEFAULT</code> from the path.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-41 data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+The POM&rsquo;s Spark <code>3.2.2</code> dependency supplies compile-time APIs; it is not the runtime engine.
+Set <code>SPARK_HOME</code> and <code>JAVA_HOME</code>, then use the distribution&rsquo;s shaded Loader JAR with its launcher.</p><p>Create the schema first and make data files readable by the executors. CSV and TEXT inputs need headerless UTF-8 data and an explicit mapping <code>header</code>.
+Other charsets and <code>has_header: true</code> are rejected. Load vertex data before edge data when the edges depend on those vertices.
+Replace the mapping path below with your prepared vertex mapping.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-8a011ca1-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>Pass Spark options such as <code>--master</code>, <code>--conf</code> and <code>--jars</code> to the launcher alongside Loader options.
+Additional JDBC drivers need explicit <code>--jars</code>; copying them into <code>lib/</code> does not distribute them to executors.
+Query the target graph to verify counts and properties; the API sink&rsquo;s insertion counters do not report distributed writes.</p><p>This path rejects <code>--incremental-mode true</code> and <code>--failure-mode true</code>. Standalone Spark supports client deployment only.
+HBase bulkload (<code>--sink-type false</code>) is unsupported on Spark 3.5.8 / Java 17; keep an existing bulkload deployment on its separately validated
+released Loader/JVM/Spark/HBase environment.
+For details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark migration guide</a>.</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-import-data-by-flink-cdc-loader>4.7 Import data by flink-cdc-loader</h4><p>The current <code>master</code> integration targets Flink <code>2.2.1</code>, MySQL CDC <code>3.6.0-2.2</code> and Java 17.
+Older examples using Flink 1.13.5 and CDC 2.2.1 belong to the previous implementation.
+Set <code>FLINK_HOME</code>; the submission JVM, JobManager and TaskManager must all use Java 17.
+Keep Flink&rsquo;s module-access options and exactly one shaded Loader JAR in the distribution&rsquo;s <code>lib/</code>.</p><p>Each mapping needs a MySQL JDBC input with <code>url</code>, <code>database</code>, <code>table</code>, <code>username</code> and <code>password</code>.
+Set MySQL <code>binlog_row_image=FULL</code>. UPDATE events require explicit, nonempty <code>update_strategies</code> and unchanged graph IDs;
+changes to vertex IDs, edge endpoints or sort keys are rejected. CDC also rejects <code>--dry-run true</code> and <code>--use-prefilter true</code>.</p><p>Without a separator, all arguments go to Loader. To set Flink options, put them before <code>--</code> and Loader options after it.
+For a prepared mapping at <code>mysql-cdc.json</code>, submit with one sink writer.</p><div class="td-code td-code--untitled" id=td-code-8a011ca1-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-8a011ca1-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-lo [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>Each mapping uses a single source reader and sink writer. <code>--cdc-sink-parallelism</code> defaults to <code>1</code>; other values are rejected.
+After <code>--</code>, Loader&rsquo;s <code>-p</code> means the Server port. Checkpoint flushing does not provide transactional graph writes or an exactly-once guarantee.
+Validate edge CDC and broader mappings in your test environment before deploying to production.
+For more details, see the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC documentation</a>.</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6699f1df5d5d2cd8d6f3ce46c9393379>5 - Graph export and migration</h1><template data-hg-authored-content=start></template><p>Choose an export or migration tool when you need to back up, export, or move data be [...]
 See the <a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>official Source documentation</a>
 for parallel-scan backend requirements and configuration limits.</p><p>Before starting, complete the <a href=/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-prepare-the-environment>shared environment and configuration steps on the import page</a>. They cover JDK, HOCON, plugin installation, and the sample graph model.</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-migrate-a-hugegraph-graph-graph2graph>1 Migrate a HugeGraph graph (graph2graph)</h2><p>The following exa [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
@@ -986,23 +1022,40 @@ for parallel-scan backend requirements and configuration limits.</p><p>Before st
 </span></span><span class=line><span class=ln>24</span><span class=cl>    <span class=n>path</span> <span class=o>=</span> <span class=s2>&#34;/tmp/hugegraph-export/${table_name}&#34;</span>
 </span></span><span class=line><span class=ln>25</span><span class=cl>    <span class=n>file_format_type</span> <span class=o>=</span> <span class=s2>&#34;json&#34;</span>
 </span></span><span class=line><span class=ln>26</span><span class=cl>  <span class=p>}</span>
-</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
+</span></span><span class=line><span class=ln>27</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>Save this as <code>config/graph2file-person.conf</code> and run it from the SeaTunnel installation directory:</p><div class="td-code td-code--untitled" id=td-code-b465ad3a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-b465ad3a-fence-5-viewport data-td-code-viewport><div cl [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools ships inside the toolchain package, in a directory</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># whose version suffix is the same as the archive&#39;s</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. Download a released source package</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>Compile and generate tar package:</p><div class="td-code td-code--untitled" id=td-code-beb8 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>The package is generated as <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>, and the unpacked directory <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> (containing <code>bin/</code> and <code>lib/</code>) is created next to it.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-ho [...]
-For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-4-viewport data-td-code-viewport><div class=highli [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-clone-source-code-to-compile-and-install>2. [...]
+Each example ends in the generated Tools directory, where <code>bin/hugegraph help</code> lists the available commands.</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git tag" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git tag</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb85dde-fence-1-viewport data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="Source archive" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Source archive</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-beb85 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>The build also writes <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code> relative to the source root.</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 Build current source</h4><p>To use unreleased features from the master branch, build Tools from source (master is currently based on 1.8; require [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>Build matching Server SDK</strong></p><p>Run the script below to download Server source and install the SDK into an isolated Maven repository:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__view [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>See the <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 migration guide</a> for details.</p></li><li><p><strong>Packa [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>Keep the SDK repository while using this source build. The master build directory does not contain <code>incubating</code>.</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-how-to-use>3 How to use</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-function-overview>3.1 Function overview</h4><p>From the extracted or generated Tools directory, run [...]
+or <code>bin/hugegraph help &lt;sub-command></code> for one command. The commands cover these tasks.</p><ul><li>Graph management type, graph-mode-set, graph-mode-get, graph-list, graph-get, graph-clear, graph-create, graph-clone and graph-drop</li><li>Asynchronous task management type, task-list, task-get, task-delete, task-cancel and task-clear</li><li>Gremlin type, gremlin-execute and gremlin-schedule</li><li>Backup/Restore type, backup, restore, migrate, schedule-backup and dump</li>< [...]
+Supply both <code>--user</code> and <code>--password</code>, or omit both.</p></blockquote><p>Use <code>export</code> to set an option for the current shell and the commands launched from it.</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Global Variable</th><th scope=col>Environment Variable</th><th scope=col>Example</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGR [...]
+For an authenticated Server, also provide the username and password described above.</p><div class="td-tab-block td-tab-block--code" data-td-tab="CLI flags" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>CLI flags</div><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-7-viewport data-td-code-viewport><div class=highli [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>Another way is to set the environment variable in the bin/hugegraph script:</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-6-vi [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>You can also set these variables in <code>bin/hugegraph</code>.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-beb85dde-fence-9-viewport data- [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -1011,10 +1064,15 @@ For an authenticated Server, also provide the username and password described ab
 </span></span><span class=line><span class=ln> 7</span><span class=cl>#export HUGEGRAPH_PASSWORD=
 </span></span><span class=line><span class=ln> 8</span><span class=cl>#export HUGEGRAPH_TIMEOUT=
 </span></span><span class=line><span class=ln> 9</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_FILE=
-</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
+</span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> also reads <code>JAVA_HOME</code> (a warning is printed when it is not set, and it is needed for https) and <code>JAVA_OPTIONS</code> (JVM options; when it is empty the script uses <code>-Xms512m</code> plus an <code>-Xmx</code> computed from the free memory of the machine).</p><h5 id=pg-578593298ffbd00c4ba [...]
 restore requires the graph to be in RESTORING or MERGING mode (set it with graph-mode-set first), otherwise the command fails</p></blockquote></li><li>migrate, migrate the currently connected graph to another HugeGraphServer<ul><li>&ndash;target-graph, the name of the target graph, the default is hugegraph</li><li>&ndash;target-url, the HugeGraphServer where the target graph is located, the default is http://127.0.0.1:8081</li><li>&ndash;target-user, the username used to access the targe [...]
 To customize the format, implement a <code>Formatter</code> subclass such as <code>CustomFormatter</code> under <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code>, then select it when running the command:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter or -f, specify the formatter to use, the default is JsonFormatter</li><li>&ndash;directory or -d, the directory where schema or data is stored, the default is &lsquo;./{graphName}&rsquo; for local directory, and &lsquo;{fs.default.name}/{graphName}&rsquo; for HDFS</li><li>&ndash;log or -l, specify the log directory, the default is ./logs</li><li>&ndash;retry, specify the number of failed retries, the default is 3< [...]
+and do not support current HugeGraph Server or Hubble.
+For modern deployments, follow <a href=/docs/quickstart/hugegraph/hugegraph-server/>Server Quick Start</a>
+and <a href=/docs/quickstart/toolchain/hugegraph-hubble/>Hubble Quick Start</a>.
+The options below are retained only for maintaining legacy environments.</p><ul><li>deploy, one-click download, install and start HugeGraph-Server and HugeGraph-Studio<ul><li>-v, required, specifies the HugeGraph-Server and HugeGraph-Studio version to install, must be one of the versions listed in bin/version-map.yaml (0.6, 0.7, 0.8, 0.9, 0.10), which maps it to the matching server and studio release versions</li><li>-p, required, specifies the installed HugeGraph-Server and HugeGraph-St [...]
+Later runs without <code>-u</code> reuse the saved URL. Without either setting, the script uses <code>https://github.com/hugegraph</code>.</p></blockquote><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--39-specific-command-parameters>3.9 Specific command parameters</h5><p>The help output below lists each subcommand and its options.</p><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=410><div class=t [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -1423,26 +1481,26 @@ To customize the format, implement a <code>Formatter</code> subclass such as <co
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code_ [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-specific-command-example>3.10 Specific command example</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin-statement>1. gremlin statement</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># Execute gremlin asynchronously</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-show-task-status>2. Show task status</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-set-and-show-graph-mode>3. Set and show graph mode</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-beb8 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-11-viewport data-td-code- [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-cleanup-graph>4. Cleanup Graph</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-14-viewport data-td-code- [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># recovery graph</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># restore graph mode</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-15-viewpo [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-graph-migration>8. Graph Migration</h6><div class="td-code td-code--untitled" id=td-code-beb85dde-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-beb85dde-fence-18-viewpo [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
 </span></span><span class=line><span class=ln>3</span><span class=cl>mvn clean package -pl hugegraph-spark-connector -am -DskipTests -ntp</span></span></code></pre></div></div></div><h4 id=pg-7a8b9421800a2b76e91d76ba1eccb218--32-build-with-default-tests>3.2 Build with default tests</h4><div class="td-code td-code--untitled" id=td-code-add49e69-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-add49e69-fence-1-view [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
diff --git a/_print/docs/quickstart/toolchain/visualization/index.html b/_print/docs/quickstart/toolchain/visualization/index.html
index 2ba25998d..ff738e2e2 100644
--- a/_print/docs/quickstart/toolchain/visualization/index.html
+++ b/_print/docs/quickstart/toolchain/visualization/index.html
@@ -12,17 +12,21 @@ provides complete orchestration for PD, Store, Server, and Hubble. Follow the ad
 then launch services from <code>docker/</code> without maintaining separate Compose files.
 The guidance below focuses on connectivity and operations; ensure prerequisite credentials and service readiness from the README are met.
 Docker <code>latest</code> is a moving tag. Screenshots assist in UI navigation; verify deployed versions via image digests and build details.
-Metrics and permission APIs vary by version.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
-and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e0 [...]
+Metrics and permission APIs vary by version.</p><p>The screenshots show the HugeGraph Hubble interface in action; features and workflows are identical in both English and Chinese.</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--connect-to-a-distributed-cluster>Connect to a distributed cluster</h2><p>Hubble still manages graph data through the <strong>Server graph API</strong>. In distributed mode, it discovers Servers through PD
+and collects cluster information from PD and Store. Hubble does not read or write graph data directly in Store.</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|Graph API| S[Server]
+    S --&gt;|Graph reads and writes| T[Store]
+    H -.-&gt;|Discovery and cluster information| P[PD]
+    H -.-&gt;|Node metrics| T</code></pre><ol class=steps><li><p><strong>Generate Hubble configuration.</strong> Prepare <code>.env</code> in the main repository&rsquo;s <code>docker/</code> directory following the Docker README.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=highlight><pre t [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>The script reads <code>HG_PD_AUTH_SECRET_KEY</code> from <code>.env</code> and writes its value as <code>operations.pd.password</code> into the generated file
 <code>docker/conf/hubble/hstore.local.properties</code>. Edit this generated file to adjust connection or operations settings (do not overwrite
 the tracked <code>.example</code> template), ensuring <code>operations.pd.password</code> matches the PD secret. Compose mounts this file read-only into
 the container; do not edit inside the container. Both <code>.env</code> and the generated file contain secrets and should not be committed to Git.
-Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-1-viewport data-td-code-viewport><div class=h [...]
+Re-running the script overwrites the generated file, requiring custom settings to be reapplied.</p></li><li><p><strong>Start the services.</strong> Use the same <code>docker/</code> directory and confirm Server registration and Store readiness.</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=h [...]
 <a href=/docs/quickstart/hugegraph/hugegraph-hstore/>HStore deployment guide</a>. A source or binary Hubble deployment instead uses the package&rsquo;s
-<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
+<code>conf/hugegraph-hubble.properties</code>. These settings match the official minimal topology; use backend-reachable addresses for other deployments:</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=prope [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table><thead><tr><th scope=col>Setting</th><th scope=col>Purpose</th><th scope=col>Bundled value</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>Explicitly enable PD mode; <c [...]
@@ -30,7 +34,7 @@ rather than <code>127.0.0.1</code> for cross-container traffic.
 The bundled package sets <code>pd.enabled=false</code>. If omitted, the fallback default is <code>true</code>, so declare this setting explicitly in both standalone and distributed
 setups.
 After editing configuration: restart the Hubble process for source or binary deployments; for Docker Compose, recreate the Hubble container from <code>docker/</code>
-to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
+to reload the mounted configuration (retaining the project name and all <code>-f</code> arguments):</p><div class="td-code td-code--untitled" id=td-code-e03ce7eb-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e03ce7eb-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker comp [...]
 so each team can work with its own graphs. Modeling, importing, and querying within a space follow the standalone guide.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--create-and-adjust-a-graphspace>Create and adjust a GraphSpace</h3><p>With Server authentication enabled, creating, editing, and deleting GraphSpaces require super administrator access.
 Start with a globally unique GraphSpace name, an optional display alias, and the maximum graph count.
 For example, use <code>research</code> as the API identifier and “Research_graph” as the display alias.
@@ -39,7 +43,7 @@ Choose GraphSpace administrators from existing accounts.</p><p>“Advanced deplo
 plus the storage capacity limit. These deployment quotas neither report current usage nor resize existing containers.</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>Advanced deployment defaults</span></div><div class=td-callout__body><p>Defaults are 100 graphs, 64 CPU cores and 128 GB of memory for each of the graph and compute services, and 1000000 GB of storage.
 Keep the defaults for a container trial. Configure Kubernetes namespaces, Operator images, and algorithm images only for the corresponding deployment
 or compute use.</p></div></div><p>Select a space before opening a graph. Check the current graph after switching spaces, especially when spaces contain identically named graphs.
-The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation and advanced resource limits" width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema within a GraphSpace.
+The list reflects account access. If a space is missing, check membership permissions before creating more graphs.</p><img class=td-image src=/docs/images/hubble/graphspace.jpg alt="GraphSpace creation form and entry to advanced resource limits" width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--reuse-schema-templates>Reuse Schema templates</h3><p><strong>User-defined Schema templates require PD mode</strong> and persist reusable Groovy Schema  [...]
 When several business graphs share vertex labels, edge labels, and indexes, save the model as a template and select it when creating subsequent graphs.
 For example, a user template in <code>research</code> can be reused for new graphs in that space. After switching spaces, select a template belonging to the new space.</p><p>User templates differ from the built-in sample templates in the main guide: built-in templates help explore preset models,
 while user templates preserve your own models for future use. A template is not an import of data; loading sample data is a separate graph creation choice.
@@ -53,7 +57,7 @@ Accounts and space memberships are managed separately; removing a member does no
 After creating an account, continue directly to assigning space access. When changing an existing membership, check the selected space and preset
 and preserve permissions still needed in other spaces. Enabling <code>pd.enabled</code> grants no permissions;
 legacy custom roles on older Servers are not interchangeable with these presets.
-See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to fi [...]
+See <a href=/docs/config/config-authentication/>Server authentication and authorization</a>.</p><img class=td-image src=/docs/images/hubble/members.jpg alt="GraphSpace members and access presets" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--locate-problems-through-the-cluster-overview>Locate problems through the cluster overview</h2><p>The overview presents <strong>Server → PD → Store</strong> in one topology. Switch to the node list to f [...]
 PD Leader, online Store count, graphs, partitions, replicas, and data size help identify cluster scale and nodes requiring attention.
 Partitions and replicas describe data distribution. Data size is observed usage, distinct from a GraphSpace&rsquo;s configured storage limit.</p><p>Start with cluster and source status, then inspect an affected node. <code>UP</code> indicates a successful collection from the source;
 <code>DEGRADED</code> indicates a cluster or partial source issue, and <code>DOWN</code> indicates that the corresponding probe failed.
@@ -66,7 +70,7 @@ GraphSpace administrators and ordinary members do not inherit cluster access.
 Use container isolation, a trusted HTTPS entrypoint, Server authentication, and network allowlists; avoid publishing Hubble or component ports directly.</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--configure-operations-access>Configure operations access</h3><p>Hubble&rsquo;s <strong>backend</strong> uses the PD/Store operations credentials, separately from the Server account used to log in through the browser.
 For Compose, edit the generated host file <code>docker/conf/hubble/hstore.local.properties</code>; other deployments use the Hubble package configuration.
 The script-generated PD password must match the secret in <code>.env</code>. Configure the Store service account when Store authentication is enabled.
-Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
+Do not include passwords in documentation, screenshots, or committed configuration:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label="Scrollable table"><table class=td-table--wide><thead><tr><th scope=col>Setting</th><th scope=col>Bundled default</th><th scope=col>Configuration</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>Username <code>hubble</code>, empty password</td><td>Match [...]
 matching the Store metric target returned by PD. Adding an origin here only authorizes access—it does not register or discover nodes.</p><p>If topology renders but node metrics are missing, check Hubble backend connectivity and credentials to PD REST, verify the Store REST and metric addresses
 returned by PD, and ensure targets are in <code>operations.store.allowed_targets</code>. A partially available overview indicates metrics collection was blocked for
 specific sources, not that graph APIs are down.</p><template data-hg-authored-content=end></template></div></main></div><script type=application/json id=td-action-manifest>{"actions":[{"available":true,"description":"Copy Markdown","disabledReason":"","icon":"fa-regular fa-copy","id":"copy_markdown","keywords":["Copy Markdown","markdown","copy"],"kind":"copy","options":[],"placements":{"page":true,"palette":true},"target":"self","title":"Copy Markdown","url":"/docs/quickstart/toolchain/v [...]
diff --git a/about/index.html b/about/index.html
index 47111b27d..14dffa53e 100644
--- a/about/index.html
+++ b/about/index.html
@@ -62,7 +62,7 @@
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-drawer value=auto data-bs-theme-value=auto checked>
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>System</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>Your browser is not saving settings, so this choice lasts only on this page.</p></dialog></div></div><a class=td-site-nav__menu-link href=https://github.com/apache/hugegraph target=_blank rel="noopener noreferrer"><i class="fa-brands fa-github"  [...]
 <span>Apache HugeGraph</span></p><h1 class=td-landing-hero__title id=hero-title>One ecosystem for graph data and graph intelligence</h1><p class=td-landing-hero__lead>HugeGraph is an Apache top-level project that covers transactional graph storage, distributed analytics, visualization, data loading, and graph AI.</p><div class=td-landing-hero__actions><a class="td-landing-button td-landing-button--primary" href=https://hugegraph.apache.org/docs/><span>Read the documentation</span>
-</a><a class="td-landing-button td-landing-button--ghost" href=https://hugegraph.apache.org/community/><span>Join the community</span></a></div></div></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>The project family</h2></header><div class=td-landing-card-grid style=--td-columns:3><article class=td-landing-card><div class=td-landing-car [...]
+</a><a class="td-landing-button td-landing-button--ghost" href=https://hugegraph.apache.org/community/><span>Join the community</span></a></div></div></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>The project family</h2></header><div class=td-landing-card-grid style=--td-columns:3><article class=td-landing-card><div class=td-landing-car [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html b/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
index 743aca0cc..f0295cdff 100644
--- a/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
+++ b/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
@@ -268,7 +268,7 @@ If <code>mem_cap</code> is found to be too small, it will be automatically adjus
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/2025/10/09/toplingdb-quick-start/index.html b/blog/2025/10/09/toplingdb-quick-start/index.html
index 7276d93b6..3460b5213 100644
--- a/blog/2025/10/09/toplingdb-quick-start/index.html
+++ b/blog/2025/10/09/toplingdb-quick-start/index.html
@@ -149,7 +149,7 @@ That guide describes unreleased changes; do not mix its settings with these hist
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/2025/10/29/agentic-graphrag/index.html b/blog/2025/10/29/agentic-graphrag/index.html
index adf5b8405..7c6098bb3 100644
--- a/blog/2025/10/29/agentic-graphrag/index.html
+++ b/blog/2025/10/29/agentic-graphrag/index.html
@@ -292,7 +292,7 @@ We fully leverage the Pool abstraction provided by the underlying CGraph framewo
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/computing/index.html b/blog/computing/index.html
index 43a66a62c..4f8df85a8 100644
--- a/blog/computing/index.html
+++ b/blog/computing/index.html
@@ -88,7 +88,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/hugegraph-ai/index.html b/blog/hugegraph-ai/index.html
index 072d8e51b..7ee897754 100644
--- a/blog/hugegraph-ai/index.html
+++ b/blog/hugegraph-ai/index.html
@@ -89,7 +89,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/hugegraph/index.html b/blog/hugegraph/index.html
index 1f16c9eb2..5ad7b95a4 100644
--- a/blog/hugegraph/index.html
+++ b/blog/hugegraph/index.html
@@ -89,7 +89,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/hugegraph/toplingdb/index.html b/blog/hugegraph/toplingdb/index.html
index 751559a8b..45d0e3602 100644
--- a/blog/hugegraph/toplingdb/index.html
+++ b/blog/hugegraph/toplingdb/index.html
@@ -94,7 +94,7 @@ That guide describes unreleased changes; do not mix its settings with these hist
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/index.html b/blog/index.html
index 7322097c9..5f7b3a43c 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -96,7 +96,7 @@ HugeGraph (OLTP): Core graph database features, performance optimization, storag
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/blog/toolchain/index.html b/blog/toolchain/index.html
index 08f64d010..14a365940 100644
--- a/blog/toolchain/index.html
+++ b/blog/toolchain/index.html
@@ -89,7 +89,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/build-metadata/versions.json b/build-metadata/versions.json
index 52e09a16d..e3e4ca79c 100644
--- a/build-metadata/versions.json
+++ b/build-metadata/versions.json
@@ -28,7 +28,7 @@
       "nonEquivalentHreflangRemoved": 0,
       "publishPath": "",
       "ref": "master",
-      "sha": "69d32b05ffb2ccb3383616e02db97533e038a92f",
+      "sha": "efa1d042316e3f18caef4a642a685f38d2ec596f",
       "urlScoping": {
         "files": 316,
         "historicalHomeRedirects": 0,
diff --git a/categories/graph-ai/index.html b/categories/graph-ai/index.html
index e07067a6f..5d9d4ad7a 100644
--- a/categories/graph-ai/index.html
+++ b/categories/graph-ai/index.html
@@ -94,7 +94,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/categories/index.html b/categories/index.html
index 766d72fc1..30e57d4f5 100644
--- a/categories/index.html
+++ b/categories/index.html
@@ -115,7 +115,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/categories/storage/index.html b/categories/storage/index.html
index 23ab49181..6fae02863 100644
--- a/categories/storage/index.html
+++ b/categories/storage/index.html
@@ -94,7 +94,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title="Show table of contents" aria-label="Show table of contents"><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print- [...]
 <input type=search class=td-shell-search__input placeholder=Search… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=Search… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=Close>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=Search…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
diff --git a/cn/404.html b/cn/404.html
index 3018d5bb7..3ea2576eb 100644
--- a/cn/404.html
+++ b/cn/404.html
@@ -32,7 +32,7 @@
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--moon fa-solid fa-moon" aria-hidden=true></i><span>暗色</span>
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-navbar value=auto data-bs-theme-value=auto checked>
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>跟随系统</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>浏览器未保存设置,此选择仅在当前页面有效。</p></dialog></div><div class="td-shell-keyboard td-nav-hover-menu" data-td-nav-hover><button type=button class="td-shell-iconbtn td-shell-keyboard__trigger" data-td-nav-hover-trigger data-td-nav-hover-open title=键盘快捷键 aria-la [...]
-<a class="btn btn-outline-primary" href=https://hugegraph.apache.org/cn/>返回首页</a></p></div></main><footer class=d-print-none data-td-shell-footer><div class=hg-asf-footer id=td-site-footer><div class=hg-asf-footer__container><div class=hg-asf-footer__brand><a href=https://www.apache.org/ target=_blank rel="noopener noreferrer" aria-label="The Apache Software Foundation"><img src=https://hugegraph.apache.org/img/apache_logo.svg alt="The Apache Software Foundation" width=300 height=122></a [...]
+<a class="btn btn-outline-primary" href=https://hugegraph.apache.org/cn/>返回首页</a></p></div></main><footer class=d-print-none data-td-shell-footer><div class=hg-asf-footer id=td-site-footer><div class=hg-asf-footer__container><div class=hg-asf-footer__brand><a href=https://www.apache.org/ target=_blank rel="noopener noreferrer" aria-label="The Apache Software Foundation"><img src=https://hugegraph.apache.org/img/apache_logo.svg alt="The Apache Software Foundation" width=300 height=122></a [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/_print/docs/clients/index.html b/cn/_print/docs/clients/index.html
index 0b7b16596..fae147d51 100644
--- a/cn/_print/docs/clients/index.html
+++ b/cn/_print/docs/clients/index.html
@@ -5403,8 +5403,8 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=n>graphSpace</span><span class=p>.</span><span class=na>setMaxRoleNumber</span><span class=p>(</span><span class=n>100</span><span class=p>);</span><span class=w>  </span><span class=c1>// 最大角色数量</span><span class=w>
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=c1>// 创建 GraphSpace</span><span class=w>
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>spaceManager</span><span class=p>.</span><span class=na>createGraphSpace</span><span class=p>(</span><span class=n>graphSpace</span><span class=p>);</span></span></span></code></pre></div></div></div><h4 id=pg-3457a7585a93814fdbb1a44b68edc0d3--42-graphspace-接口汇总>4.2 GraphSpace 接口汇总</h4><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr> [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div></div><p>然后输入下述命令:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class=td-code__viewport id=td-code-41ddd794-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma> [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>spaceManager</span><span class=p>.</span><span class=na>createGraphSpace</span><span class=p>(</span><span class=n>graphSpace</span><span class=p>);</span></span></span></code></pre></div></div></div><h4 id=pg-3457a7585a93814fdbb1a44b68edc0d3--42-graphspace-接口汇总>4.2 GraphSpace 接口汇总</h4><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div></div><p>然后运行示例脚本。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class=td-code__viewport id=td-code-41ddd794-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma> [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>         <span class=se>\,</span>,,/
 </span></span><span class=line><span class=ln> 4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
@@ -5417,7 +5417,7 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span><span class=line><span class=ln>11</span><span class=cl>model load finished, <span class=nb>time</span> elapsed <span class=m>35</span> ms.
 </span></span><span class=line><span class=ln>12</span><span class=cl>&gt;&gt;&gt;&gt; query all vertices: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
 </span></span><span class=line><span class=ln>13</span><span class=cl>&gt;&gt;&gt;&gt; query all edges: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
-</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/3.5.1/gremlin-console/src/main/groovy/org/apache/tinkerpop/gremlin/console/Console.g [...]
+</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/3.5.1/gremlin-console/src/main/groovy/org/apache/tinkerpop/gremlin/console/Console.g [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>2</span><span class=o>:</span><span class=n>lop</span><span class=o>]</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>1</span><span class=o>:</span><span class=n>josh</span><span class=o>]</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>]</span>
@@ -5431,36 +5431,26 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>1</span><span class=o>&gt;&gt;</span><span class=nl>S1:</span><span class=n>vadas</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>knows</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>peter</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>peter</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
-</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-请求模式>2 Client/Server 请求模式</h3><p>Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。默认配置使用 <code>WsAndHttpChannelizer</code>,可同时处理 WebSocket 和 HTTP 请求,无需切换 Channeli [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># ......</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>channelizer</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># ......</span></span></span></code></pre></div></div></div><p>确认 <code>host</code>、<code>port</code> 与 <code>remote.yaml</code> 一致,然后按照<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>步骤</a>启动 HugeGraph-Server。</p><p>下面进入 Gremlin-Console:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=9><div cla [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>
-</span></span><span class=line><span class=ln>3</span><span class=cl>         <span class=se>\,</span>,,/
-</span></span><span class=line><span class=ln>4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>-----oOOo-<span class=o>(</span>3<span class=o>)</span>-oOOo-----
-</span></span><span class=line><span class=ln>6</span><span class=cl>plugin activated: HugeGraph
-</span></span><span class=line><span class=ln>7</span><span class=cl>plugin activated: tinkerpop.server
-</span></span><span class=line><span class=ln>8</span><span class=cl>plugin activated: tinkerpop.utilities
-</span></span><span class=line><span class=ln>9</span><span class=cl>plugin activated: tinkerpop.tinkergraph</span></span></code></pre></div></div></div><p>连接 Server,需在配置文件中指定连接参数,在 conf 目录下有一个默认的 <code>remote.yaml</code>:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-5 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=10><div class=td-code__viewport id=td-code-41ddd794-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabinde [...]
-</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=p>,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>  </span>}<span class=w>
-</span></span></span><span class=line><span class=ln>10</span><span class=cl>}</span></span></code></pre></div></div></div><p>如果 Server 开启了鉴权模式,需要在同一个文件中补上凭据:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span c [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=l>pa</span></span></span></code></pre></div></div></div><p><code>conf</code> 目录下还提供了 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code>,它们使用相同的 host、port 和序列化器配置。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line- [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>==&gt;Configured localhost/</span><span class=mf>127.0</span><span class=o>.</span><span class=mf>0.1</span><span class=o>:</span><span class=mi>8182</span></span></span></code></pre></div></div></div><p>Server 端的图以图空间限定名绑定,因此图空间 <code>DEFAULT</code> 下的图 <code>hugegraph</code> 绑定名为 <code>DEFAULT-hugegraph</code>,其 traversal source 绑定名为 <code>__g_DEFAULT-hugegraph</code>。裸写 <code>hugegraph</code> 在 S [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>();</span> <span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div><blockquote><p>注意:在 Client/Server 模式下,所有和 Server 有关的操作都要加上 <code>:> </code>,如果不加,表示在 console 本地操作。<code>:> </code>发送的脚本不带别名 [...]
+</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-请求模式>2 Client/Server 请求模式</h3><p>Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。使用与 Server 同版本发行包中的 Console 和 <code>conf/remote.yaml</code>,
+保留文件中的序列化器配置,只修改地址,以及启用鉴权时需要的凭据。旧版配置可能引用已经不存在的序列化器类。</p><ol class=steps><li><p>准备连接配置并启动 Server。</p><p>检查 <code>conf/gremlin-server.yaml</code> 中的 <code>host</code>、<code>port</code>。默认的 <code>WsAndHttpChannelizer</code> 同时处理 WebSocket 和 HTTP 请求,无需修改。
+<code>conf/remote.yaml</code> 中的 <code>hosts</code> 应填写 Console 能访问的 Server 地址,<code>port</code> 应与 Gremlin 端口一致(默认为 <code>8182</code>,不是 REST 端口 <code>8080</code>)。
+按照<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>快速上手</a>启动 Server。</p><p>当前 master 配置使用 GraphBinary V1 和 HugeGraph 类型注册器。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-3 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-41ddd794-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1< [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div><p>如果 Server 开启了鉴权,在同一个文件中填写实际凭据。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2> [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;replace-with-your-password&#34;</span></span></span></code></pre></div></div></div><p>随包的 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code> 使用相同的序列化器配置;使用这些文件时也要保持一致。</p></li><li><p>从 Server 发行包目录启动 Console,并创建带 traversal 别名的客户端。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fen [...]
+由于连字符 <code>-</code> 在 Groovy 中不能直接用作变量名,通过 Java Driver 连接时,使用 <code>.alias(['g': '__g_DEFAULT-hugegraph'])</code> 将其映射为 <code>g</code>。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span></span></span></code></pre></div></div></div></li><li><p>通过客户端提交查询。</p><div class="td-c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span></span></span></code></pre></div></div></div><p>若启动 Server 时预加载了示例图,两条查询均返回  [...]
+通过 Driver 的 <code>client.submit()</code> 提交脚本时,无需在语句前加 <code>:></code> 前缀。</p></li><li><p>使用结束后关闭客户端和集群连接。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-8 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=2><div class=td-code__viewport id=td-code-41ddd794-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div></li></ol><p>此外,也可以使用 Gremlin Console 内置的 <code>:remote</code> 命令连接:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-9 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-41ddd794-fence-9-vie [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>/</span><span class=o>/</span> <span class=err>通过</span> <span class=n>Console</span> <span class=err>远程连接提交脚本时,前缀使用</span> <span class=o>:&gt;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>close</span></span></span></code></pre></div></div></div><p>使用 <code>:remote</code> 连接时,以 <code>:></code> 开头的语句会被发送至远端 Server 执行,普通语句则在 Console 本地执行。</p><p>更多用法见 <a href=https://tinkerpop.apache.org/docs/current/reference/#gremlin-console>TinkerPop Gremlin Console 参考</a>。</p><template data-hg-authored-content=end></template></div></main></div><script type=a [...]
 <i class="fa-solid fa-wand-magic-sparkles" aria-hidden=true></i>
 <span>询问 AI</span></button><section class="hg-ai-consent d-print-none" data-hg-ai-consent hidden aria-labelledby=hg-ai-consent-title aria-describedby=hg-ai-disclosure><h2 class=visually-hidden id=hg-ai-consent-title>询问 AI</h2><p id=hg-ai-disclosure>同意后将把你的问题发送给第三方 Kapa 服务,使用 AI 结合文档回答。</p><p>回答基于 latest 版本文档</p><p><a href=https://www.kapa.ai/content/privacy-policy target=_blank rel="noopener noreferrer">隐私政策</a></p><div class=hg-ai-consent-actions><button type=button class="btn btn-secon [...]
 <button type=button class="btn btn-primary" data-hg-ai-continue aria-haspopup=dialog aria-describedby=hg-ai-disclosure>同意并打开 Ask AI</button></div></section><div class="hg-ai-status visually-hidden" role=status aria-live=polite data-hg-ai-status></div><script src=/js/kapa-adapter.min.c3349abb2aa6680f8807e3d8f687be02149dc18617e87d1936e1c55f1db37d97.js integrity="sha256-wzSauyqmaA+IB+PY9oe+AhSdwYYX6H0ZNuHFXx2zfZc=" crossorigin=anonymous></script></body></html>
\ No newline at end of file
diff --git a/cn/_print/docs/config/index.html b/cn/_print/docs/config/index.html
index 894bbeca0..c58ae1176 100644
--- a/cn/_print/docs/config/index.html
+++ b/cn/_print/docs/config/index.html
@@ -87,15 +87,17 @@ Server 配置指南 Server 配置选项 认证与授权 HTTPS 配置 后端配
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;hugegraph_rocksdb&#34;</span>,<span class=s2>&#34;backend&#34;</span>:<span class=s2>&#34;rocksdb&#34;</span><span class=o>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6bfbb2db4e1f281942d741cef305e724>2 - Server 完整配置手 [...]
 自 HugeGraph 1.8.0 起生效。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置项</th><th scope=col>默认值</th><th scope=col>说明</th></tr></thead><tbody><tr><td>arthas.telnet_port</td><td>8562</td><td>管理员通过 <code>PUT /arthas</code> 激活时使用的 Arthas telnet 端口。</td></tr><tr><td>arthas.http_port</td><td>8561</td><td>管理员激活时使用的 Arthas HTTP 端口。</td></tr><tr><td>arthas.ip</td><td>127.0.0.1</td><td>监听地址;管理员 [...]
 发行包内的 <code>bin/arthas.sh</code> 可直接免配置进行本地诊断。
-详细激活方式、权限要求及认证配置请参见 <a href=/cn/docs/clients/restful-api/other/#1116-%E5%90%AF%E5%8A%A8-arthas-%E8%AF%8A%E6%96%AD%E4%BB%A3%E7%90%86>Arthas 诊断代理</a>。</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server 配置项</strong></span></div><div class=td-callout__body><p>对应配置文件<code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+详细激活方式、权限要求及认证配置请参见 <a href=/cn/docs/clients/restful-api/other/#1116-%E5%90%AF%E5%8A%A8-arthas-%E8%AF%8A%E6%96%AD%E4%BB%A3%E7%90%86>Arthas 诊断代理</a>。</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server 配置项</strong></span></div><div class=td-callout__body><p>对应配置文件<code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+<code>audit-*.log</code>,部署时必须保留并限制这些日志的读取权限。<code>auth.audit_log_rate</code> 只限制每用户的日志输出速率,不是审计日志的启停开关。</p></div></div><p><code>StandardAuthenticator</code> 支持多用户认证和细粒度权限控制。也可以实现 <code>HugeAuthenticator</code> 接口来接入已有的用户系统。</p><p>用户认证使用 <a href=https://zh.wikipedia.org/wiki/HTTP%E5%9F%BA%E6%9C%AC%E8%AE%A4%E8%AF%81>HTTP Basic Authentication</a>。<code>Basic</code> 后面的值是 <code>用户名:密码</code> 的 Base64 编码。使用 curl 时可直接通过
+<code>-u</code> 传入凭据。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>curl -u <span class=s1>&#39;admin:&lt;password&gt;&#39;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p><strong>保护 Basic Authentication 凭据</strong></p><p> [...]
-源码默认会生成 32 个随机字节并以 Base64 编码,但该值不会写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥:</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-2-viewport data-td-code- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewpo [...]
+核心配置默认会生成 32 个随机字节并以 Base64 编码,该默认值不会自行写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥。</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-2-viewport data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewpo [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>authenticator</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.StandardAuthenticator,</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>authenticationHandler</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.WsAndHttpBasicAuthHandler,</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=nt>tokens</span><span class=p>:</span><span class=w> </span><span class=l>conf/rest-server.properties}</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>在 <code>rest-server.properties</code> 中配置认证器和权限数据存储图:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-bbebf2ff-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-p [...]
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>在 <code>conf/rest-server.properties</code> 中配置认证器和权限数据存储图。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-bbebf2ff-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=langu [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.graph_store</span><span class=o>=</span><span class=s>hugegraph</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Server 启动路径首次创建内置 admin 账号时使用,默认值为公开的 pa,生产部署前务必显式设置强密码</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 本地持久化后端首次启用 StandardAuthenticator 时,init-store.sh 会交互式读取密码</span>
@@ -103,24 +105,47 @@ Server 配置指南 Server 配置选项 认证与授权 HTTPS 配置 后端配
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># auth client config</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl><span class=c1># 如果是分开部署 GraphServer 和 AuthServer,还需要指定下面的配置,地址填写 AuthServer 的 IP:RPC 端口</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p>其中,<code>graph_store</code>配置项是指使用哪一个图来存储用户信息,如果存在多个图的话,选取任意一个均可。</p><p>在配置文件<code>hugegraph{n}.properties</code>中配置<code>gremlin.graph</code>信息:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-6 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-c [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>bin/stop-hugegraph.sh
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 初始化认证系统信息;已有后端数据会被保留</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>bin/init-store.sh
-</span></span><span class=line><span class=ln>6</span><span class=cl>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># start hugeGraph again</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hugegraph.sh</span></span></code></pre></div></div></div><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式</h3><p>对于镜像 <code>hugegraph/hugegraph</code> 大于等于 <code>1.2.0</code> 的版本,我们可以在启动 <code>docker</code> 镜像的同时开启鉴权模式</p><p>具体做法如下:</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-采用-docker-run>1. 采用 docker run</h4><p>在 <code>docker run</code> 中添加环境变量 <code>PASSWORD=xxx</code>(密码 [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>hugegraph/hugegraph:1.7.0</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>      </span>- <span class=m>8080</span><span class=p>:</span><span class=m>8080</span><span class=w>
-</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>9</span><span class=cl><span class=w>      </span>- <span class=l>PASSWORD=xxx</span></span></span></code></pre></div></div></div><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>3. 进入容器后重新开启鉴权模式</h4><p>首先进入容器:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport da [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 用于快速修改配置, 修改前的文件被保存在conf-bak文件夹下</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>之后参照 <a href=#pg-7d189549d4201521c83e0d93a2474a2d--基于鉴权模式启动>基于鉴权模式启动</a> 即可</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4 - 配置 HugeGraphServer 使用 https 协议</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1fe5 [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p><code>auth.graph_store</code> 指定保存认证数据的图,名称必须与 <code>conf/graphs/</code> 中的图配置对应。</p><p>在每个受保护图的配置文件 <code>conf/graphs/&lt;graph>.properties</code> 中设置 <code>gremlin.graph</code>。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-6 data-td-code data-td-code-auto-id data-td- [...]
+HStore/PD 部署的管理员由 PD 启动路径创建,须按该部署的配置设置 <code>auth.admin_pa</code>,不要照搬本地后端的交互式初始化流程。</p><ol class=steps><li><p><strong>停止 Server。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span clas [...]
+此命令补充后端与认证系统信息,不需要删除原有存储目录。</p></li><li><p><strong>启动并检查认证。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-bbebf2ff-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hugegraph.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>curl -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>curl 会提示输入密码。正确密码应返回 HTTP 200;不带凭据或使用错误密码应返回 HTTP 401。
+启动失败时先检查日志和认证图配置,不要通过清空数据来重试。</p></li></ol><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式</h3><p>新容器在 Docker run 和 Compose 中选择一种方式。已经运行过的容器直接阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>既有容器</a>。</p><p>使用 Docker 部署时,官方镜像支持通过环境变量直接开启鉴权模式(适用于官方 Server 镜像 <code>/hugegraph-server</code> 布局)。
+将占位符替换为实际镜像标签或 digest:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_IMAGE</span><span class=o>=</spa [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>read</span> -r -s -p <span class=s1>&#39;Admin password: &#39;</span> PASSWORD
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>printf</span> <span class=s1>&#39;\n&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>export</span> PASSWORD</span></span></code></pre></div></div></div><p>提示输入管理员密码后执行启动命令。为保障凭据安全,请避免将密码以明文形式提交到共享 Compose 文件中。
+JWT 密钥仍按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--配置用户认证>上面的配置</a>持久保存到认证图配置;多节点必须使用同一个值。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-采用-docker-run>Docker run</h4><p>创建一个新容器,并仅向本机开放 REST 端口。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-bbebf2ff-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -p 127.0.0.1:8080:8080 <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  -e PASSWORD <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUGEGRAPH_IMAGE</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>入口脚本完成认证配置和首次初始化后启动 Server。接着阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--检查认证结果>检查认证结果</a>。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--2-采用-docker-compose>Docker Compose</h4><p>将下面的内容保存为 <code>compose.yaml</code>。必填变量缺失时,Compose 会报错,避免意外启动无认证服务。
+在同一终端中启动服务。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-12 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-bbebf2ff-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>      </span>- <span class=s2>&#34;127.0.0.1:8080:8080&#34;</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>      </span><span class=nt>PASSWORD</span><span class=p>:</span><span class=w> </span><span class=l>${PASSWORD:?Set PASSWORD}</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-13-viewport data-td-code [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>以后重新创建容器前,需要重新设置这些变量。保留已有数据卷,并按部署要求持久保存配置。
+接着阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--检查认证结果>检查认证结果</a>。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>既有容器</h4><p>此路径适用于原先未开启认证、使用本地持久化后端的官方 Server 容器。
+先备份数据,并确认配置、后端数据及 <code>conf-bak</code> 均位于容器挂载的持久卷中。
+官方镜像将 <code>/hugegraph-server</code> 声明为卷;自定义镜像应先检查挂载位置。
+HStore/PD 或外部认证服务使用各自的管理员初始化流程。</p><ol class=steps><li><p><strong>停止原容器,使用同一镜像和数据卷打开临时维护容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-bbebf2ff-fence-14-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span cl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>docker stop server
+</span></span><span class=line><span class=ln>3</span><span class=cl>docker run --rm -it --volumes-from server <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --entrypoint bash <span class=s2>&#34;</span><span class=nv>$SERVER_IMAGE</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>原容器须保持停止,防止两个 JVM 同时打开本地数据库。<code>--entrypoint bash</code> 使维护容器只打开终端。</p></li><li><p><strong>在维护容器内修改配置并初始化。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p><code>enable-auth.sh</code> 首次运行时将原配置保存到 <code>conf-bak</code>,然后修改默认 <code>hugegraph</code> 图和认证配置。
+如果 <code>conf-bak</code> 已存在,脚本会跳过修改,须按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-模式>StandardAuthenticator 模式</a>检查三处配置。
+使用其他认证图时也应手动配置对应文件。
+按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--配置用户认证>上面的配置</a>将强随机 JWT 密钥写入认证图配置,再运行初始化命令。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-16 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-16-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/init-store.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>exit</span></span></code></pre></div></div></div><p>按提示输入管理员密码,确认初始化成功后退出。</p></li><li><p><strong>在宿主机启动原容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-17 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-17-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=langua [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+</span></span><span class=line><span class=ln>3</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>未携带凭据的请求预期返回 <code>401 Unauthorized</code>,输入正确密码的请求返回 <code>200 OK</code>(若输入错误密码则同样返回 <code>401</code>)。
+注:当前主线版本 URL 包含 <code>/graphspaces/DEFAULT</code>,1.7.0 等历史版本请省略 graphspace 前缀(直接使用 <code>/graphs/hugegraph/...</code>)。
+若未提供凭据仍返回 <code>200</code>,说明鉴权未成功启用,请检查配置并重启 Server。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4 - 配置 HugeGraphServer 使用 https 协议</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1fe5a73f419--概述>概述</h3><p>HugeGraphServer 默认使用的是 http 协议,可以配置成 https。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i cl [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>restserver.url</span><span class=o>=</span><span class=s>https://127.0.0.1:8080</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># 服务端 keystore 文件路径,当协议为 https 时该默认值自动生效,可按需修改此项</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>ssl.keystore_file</span><span class=o>=</span><span class=s>conf/hugegraph-server.keystore</span>
diff --git a/cn/_print/docs/guides/index.html b/cn/_print/docs/guides/index.html
index 43e3410a7..611b93c26 100644
--- a/cn/_print/docs/guides/index.html
+++ b/cn/_print/docs/guides/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-theme=dark]{background [...]
-<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/guides/>返回本页常规视图</a>.</p></div><h1 class=title>使用指南</h1><ul><li>1: <a href=#pg-dcb89d888ea6f4146ace522d76fe2776>HugeGraph 架构概览</a></li><li>2: <a href=#pg-3d0f9ef831ef5d7d11acfb09140359fa>HugeGraph 设计理念</a></li><li>3: <a href=#pg-96a920d19e01666d95eded506d502ab4>HugeGraph Plugin 机制及插件扩展流程</a></li><li>4: <a href=#pg-b40b2c5536e23eb0d840cec7ca4f346a>HugeGraph工具链本地测试指南</a> [...]
+<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/guides/>返回本页常规视图</a>.</p></div><h1 class=title>使用指南</h1><ul><li>1: <a href=#pg-dcb89d888ea6f4146ace522d76fe2776>HugeGraph 架构概览</a></li><li>2: <a href=#pg-3d0f9ef831ef5d7d11acfb09140359fa>HugeGraph 设计理念</a></li><li>3: <a href=#pg-96a920d19e01666d95eded506d502ab4>HugeGraph Plugin 机制及插件扩展流程</a></li><li>4: <a href=#pg-b40b2c5536e23eb0d840cec7ca4f346a>HugeGraph工具链本地测试指南</a> [...]
   Apps[&#34;应用 / 运维&#34;] --&gt; Toolchain[&#34;Toolchain&#34;] --&gt; Server[&#34;Server REST API&#34;]
   AI[&#34;AI&#34;] -. REST .-&gt; Server
   Computer[&#34;Computer&#34;] -. REST .-&gt; Server
@@ -496,9 +496,36 @@ RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂
 </span></span><span class=line><span class=ln>11</span><span class=cl>hubble-dist/assembly/travis/verify-hubble-issue-694.sh <span class=se>\
 </span></span></span><span class=line><span class=ln>12</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUBBLE_TARBALL</span><span class=s2>&#34;</span> http://127.0.0.1:8080</span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--44-hugegraph-spark-connector>4.4 hugegraph-spark-connector</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--编译-3>编译</h4><div class="td-code td-code--untitled" id=td-code-1ef5b90d-fence-18 data-td-code data-td-cod [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--45-hugegraph-tools>4.5 hugegraph-tools</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--编译-4>编译</h4><div class="td-code td-code--untitled" id=td-code-1ef5b90d-fence-20 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-常见问题>5. 常见问题</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--服务连接问题>服务连接问题</h3><p>无法连接 Server、MySQL 或 Hadoop 时:</p><ul><li>确认服务已启动(Server 必须在 8080 端口)</li><li>检查端口占用:<code>lsof -i:8080</code></li><li>Docker 检查:<code>do [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-常见问题>5. 常见问题</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--服务连接问题>服务连接问题</h3><p>无法连接 Server、MySQL 或 Hadoop 时:</p><ul><li>确认服务已启动(Server 必须在 8080 端口)</li><li>检查端口占用:<code>lsof -i:8080</code></li><li>Docker 检查:<code>do [...]
+它们是 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a> 的命令,适合图迁移、升级后的恢复及图合并。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup>Backup</h4><p>备份可在任意图模式下执行。建议在导出前暂停源图的写入操作,以确保 Schema、顶点和边的数据一致性(分批读取不提供全局事务快照)。
+注意:<code>backup -t all</code> 仅导出图的 Schema 和图数据,不包含系统配置文件与用户权限。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore>Restore</h4><p>恢复数据前,需先根据目标图的状态切换恢复模式。日常读写处于 <code>NONE</code> 模式;注意:<code>LOADING</code> 模式不能用于 <code>restore</code>。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>目标</th><th scope=col>模式</th><th scope=col>Schema ID</th><th scope=col>顶点和边 ID</th></tr></thead><tbody><tr><td>恢复到没有 Schema  [...]
+<code>AUTOMATIC</code> 和自定义顶点 ID 保留。合并会复用同名 Schema,先检查双方的定义是否兼容,以及保留的顶点 ID 是否冲突。
+它不提供任意 Schema 冲突或数据冲突的自动解决策略。先在独立目标图验证,再合并正式数据。</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--使用方法>使用方法</h2><p>准备与 Server 版本匹配的 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a>,在 Tools 根目录执行以下命令。
+本例从 <code>8080</code> 的源图恢复到 <code>8081</code> 的空目标图。两个 Server 和目标图应已创建并启动;可将变量改成实际地址及图名。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-705ab766-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nv>SOURCE [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>TARGET_URL</span><span class=o>=</span>http://127.0.0.1:8081
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>SOURCE_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nv>TARGET_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nv>BACKUP_DIR</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$PWD</span><span class=s2>/data/hugegraph-backup&#34;</span></span></span></code></pre></div></div></div><p>启用认证时,在每条 Tools 命令的子命令前加入 <code>--user &lt;user> --password &lt;password></code>,并使用具备对应图读写和模式管理权限的账号。
+详细参数及凭据使用方式见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-1>Backup</h4><p>暂停源图写入后,备份全部 Schema、顶点和边。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-705ab766-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  backup -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>显式指定的 <code>-d</code> 就是备份目录,不会自动附加图名。为每次备份使用独立目录,避免混入旧文件。
+保留完整目录,包括压缩文件;Restore 可读取 Tools 支持的 JSON 备份格式。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-1>Restore</h4><p>以下流程使用 <code>RESTORING</code>。合并时改为 <code>MERGING</code>,并先完成上面的兼容性检查。
+操作期间暂停目标图业务写入。</p><ol class=steps><li><p><span id=步骤1查看并设置图模式></span><strong>查看并记录原模式,再切换。</strong></p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-705ab766-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegra [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>ORIGINAL_MODE</span><span class=o>=</span>NONE
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  graph-mode-set -m RESTORING</span></span></code></pre></div></div></div><p>正常业务图应处于 <code>NONE</code>。将查询返回的值填入 <code>ORIGINAL_MODE</code>,例如下方的 <code>NONE</code>。若另一项维护正在使用 <code>RESTORING</code>、<code>MERGING</code> 或 <code>LOADING</code>,先协调该任务,不要覆盖其模式。</p></li><li><p><span id=步骤2restore-数据></span><strong>恢复数据。</strong></p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-3 data-td-code data-t [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  restore -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>检查命令输出与各类型的导入结果。若发生错误,请先保留备份目录与日志,并检查目标图的数据状态。
+Restore 不会自动回滚已写入的数据,切勿在部分恢复的图上盲目重跑。</p></li><li><p><span id=步骤3恢复图模式></span><strong>还原原模式。</strong></p><p>使用第一步记录的 <code>ORIGINAL_MODE</code> 还原模式。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-705ab766-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> graph-mode-get</span></span></code></pre></div></div></div><p>无论恢复成功还是失败,最后都必须将图模式还原为原有模式(通常为 <code>NONE</code>)。
+若恢复失败,先保留现场并排查日志,待重新准备目标图后再恢复业务写入。</p></li></ol><p>还原模式后,对比两端的顶点数和边数。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-705ab766-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;< [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span></span></span></code></pre></div></div></div><p>两组计数结果应保持完全一致。建议进一步通过 <a href=/cn/docs/clients/restful-api/schema/>Schema API</a> 核对元数据定义,
+并抽样检查顶点和边的属性与端点关联,确保业务数据的完整性。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--帮助>帮助</h4><p>更多关于压缩、并发和分类型备份的参数说明,见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。
+在跨大版本恢复前,建议先在测试环境中验证备份文件的兼容性。</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--backuprestore使用和实现的api说明>Backup/Restore使用和实现的API说明</h2><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-2>Backup</h4><p>Backup 使用 Schema、顶点和边的列表 GET API 导出数据。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-2>Restore</h4><p>Restore 使用 Schema、顶点和边的创建 API 导入数据。模式对应的 ID 行为见<a href=#pg-2c9db416c8d78f898d52c91ec12535d4--restore>前面的选择表</a>。
+<code>RESTORING</code> 允许指定 Schema ID;<code>MERGING</code> 不允许指定 Schema ID。两种模式均允许保留 <code>AUTOMATIC</code> 顶点 ID。
+普通 <code>NONE</code> 模式不接受这些恢复操作所需的 ID 设置。</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--查看某个图的模式>查看某个图的模式</h5><p>启用鉴权时需要图读取权限(<code>space_member</code> 或该图的所有者)。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=1><div class=td-code__viewport id=td-code-705ab766-fence-6-viewport data-td-code-viewport><div class=highlight [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;NONE&#34;</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><blockquote><p>合法的图模式包括:NONE,RESTORING,MERGING,LOADING</p></blockquote><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--设置某个图的模式>设置某个图的模式</h5><p>启用鉴权时需要图空间管理权限(<code>space</code>);管理员可按权限继承规则满足。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url-1>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-fence-8 data-td-code data-td- [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>合法图模式为 <code>NONE</code>、<code>RESTORING</code>、<code>MERGING</code> 和 <code>LOADING</code>。</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--设置某个图的模式>设置某个图的模式</h5><p>启用鉴权时需要图空间管理权限(<code>space</code>);管理员可按权限继承规则满足。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url-1>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-f [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;RESTORING&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3>6 - HugeGraph Docker 集群部署指南</h1><template data-hg-authored-content=start></template><h2 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--概述>概述</h2><p>HugeGraph 通过 Docker-Compose 可快速运行完整的分布式集群版(PD + Store + Server) [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>HUGEGRAPH_AUTH_TOKEN_SECRET</span><span class=o>=</span><span class=s1>&#39;&lt;32 字节随机值,例如 openssl rand -hex 32&gt;&#39;</span>
@@ -568,17 +595,13 @@ Compose 中 Server 服务的 <code>environment:</code> 里添加,自带的 Com
 启动期限失败、或 Java 在就绪前以 <code>0</code> 退出时,入口脚本返回 <code>1</code>;提前以非零码退出则保留该退出码。
 此时长不包括此前的存储初始化或等待后端就绪的时间。关闭时可以中断就绪和分区检查;启动期限失败会请求终止 Java 并返回,不增加无限等待。
 未响应终止请求的 Java 进程仍依靠容器终止完成最终清理。</p><p>例如,在 HugeGraph 仓库的 <code>docker/</code> 目录下,将单机 Server 的启动等待时间增加到 300 秒(Compose 文件会将该变量传入容器):</p><div class="td-code td-code--untitled" id=td-code-a045eb23-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-a045eb23-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1 [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>该设置与 Docker 健康检查的 <code>start_period</code>、<code>interval</code>、<code>timeout</code> 和 <code>retries</code> 相互独立。健康检查参数决定何时将容器标记为 <code>unhealthy</code>;仅增加健康检查的等待时间,不会延长 Server 启动脚本的等待期限。调整此变量也不会自动修改健康检查参数,启动较慢时应分别检查这两组设置。</p><h3 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--健康检查端点>健康检查端点</h3><p>所有四个 Docker 镜像现已内置 <cod [...]
-<code>false</code>,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见<a href=/cn/docs/config/config-guide/>服务端配置说明</a>。</p></li><li><p>服务启动成功后,使用<code>curl</code>查询所有顶点时返回乱码</p><p>服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 <code>gunzip</code> 进行解压(<code>curl http://example | gunzip</code>),也可以用<code>Firefox</code>的<code>postman</code>或者<code>Chrome</code>浏览器的<code>restlet</code>插件发请求,会自动解压缩响应数据。</p></li><li><p>使用顶点Id通过<code>RESTful API</code>查询顶点时返回空,但是顶点确实是存在的</p><p>检查顶点Id的类型,如果是字符串类型,<code> [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>--------| ----
-</span></span><span class=line><span class=ln> 3</span><span class=cl>+       | %2B
-</span></span><span class=line><span class=ln> 4</span><span class=cl>空格     | %20
-</span></span><span class=line><span class=ln> 5</span><span class=cl>/       | %2F
-</span></span><span class=line><span class=ln> 6</span><span class=cl>?       | %3F
-</span></span><span class=line><span class=ln> 7</span><span class=cl>%       | %25
-</span></span><span class=line><span class=ln> 8</span><span class=cl>#       | %23
-</span></span><span class=line><span class=ln> 9</span><span class=cl>&amp;       | %26
-</span></span><span class=line><span class=ln>10</span><span class=cl>=       | %3D</span></span></code></pre></div></div></div></li><li><p>查询某一类别的顶点或边(<code>query by label</code>)时提示超时</p><p>由于属于某一label的数据量可能比较多,请加上limit限制。</p></li><li><p>通过<code>RESTful API</code>操作图是可以的,但是发送<code>Gremlin</code>语句就报错:<code>Request Failed(500)</code></p><p>可能是<code>GremlinServer</code>的配置有误,检查<code>gremlin-server.yaml</code>的<code>host</code>、<code>port</code>是否与<code>rest-server.properties</code>的<code [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>该设置与 Docker 健康检查的 <code>start_period</code>、<code>interval</code>、<code>timeout</code> 和 <code>retries</code> 相互独立。健康检查参数决定何时将容器标记为 <code>unhealthy</code>;仅增加健康检查的等待时间,不会延长 Server 启动脚本的等待期限。调整此变量也不会自动修改健康检查参数,启动较慢时应分别检查这两组设置。</p><h3 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--健康检查端点>健康检查端点</h3><p>所有四个 Docker 镜像现已内置 <cod [...]
+部署步骤见 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速开始</a>。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--core-dump>启动时出现 core dumped 怎么查</h3><p>先执行 <code>java -version</code> 确认 JDK 版本:<strong>HugeGraph master 分支(以 1.8 为基线)要求 Java 17</strong>,<strong>1.7.0 要求 Java 11</strong>(已不再支持 Java 8)。
+若 JDK 版本正确,进一步查看 Server 日志及 JVM 崩溃日志(<code>hs_err_pid*.log</code>),排查是否由于系统架构不匹配、依赖的动态库(如 RocksDB JNI)缺失或系统内存不足引起。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--initialize-backend>哪些后端需要 init-store</h3><p>使用 RocksDB 或 HBase 等本地持久化后端时,<strong>首次启动前必须执行 <code>bin/init-store.sh</code></strong> 进行初始化。Memory(内存后端)和 HStore(分布式后端)无需执行此脚本,HStore 的存储由 PD 和 Store 统一管理。</p><p>注意:<code>backend</code> 与 <code>serializer</code> 必须配套使用(例如 RocksDB 配套 <code>binary</code>),不可随意替换。若服务启动后提示无法连接后端,请优先检查是否完成 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>.../libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found</span></span></code></pre></div></div></div><p>解决方法:核对发行包支持的系统架构,升级系统的 <code>libstdc++</code>(或安装较新的 GCC 运行库),或者直接使用官方提供的 Docker 镜像运行。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--start-script>应该使用哪个 Server 启动脚本</h3><p>当前发行包统一使用 <code>bin/start-hugegraph.sh</code>,GremlinServer 与 REST Server 会在同一个进程中启动。旧版本文档中的 <code>start-restserver.sh</code> 和 <code>start-gre [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  <span class=s1>&#39;http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10&#39;</span></span></span></code></pre></div></div></div><p>若开启了认证,需同时传入凭据。若返回内容仍不符合预期,请检查 HTTP 状态码、<code>Content-Type</code> 与 <code>Content-Encoding</code>,不要把 JSON 报错直接管道传给 <code>gunzip</code>。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--vertex-id>按顶点 ID 查询却找不到顶点</h3><p>先从已有查询结果中确认 <code>id</code> 的实际格式和类 [...]
+若已手动清理底层,必须<strong>重启 Server</strong>。日常清理建议使用官方提供的 <a href=/cn/docs/clients/restful-api/graphs/#clear-graph>Clear 图 API</a>。</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--modeling>建模与 ID</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--id-length>顶点或边 ID 超过长度限制</h3><p>为保证底层存储与索引性能,HugeGraph 对 ID 长度作了如下限制(按编码后的字节数计算):</p><ul><li><strong>顶点 ID</strong>:最长 16384 字节(16 KB);</li><li><strong>边 ID</strong>:最长 65536 字节(64 KB)。</li></ul><p>建议使用简洁的业务唯一标识作为主键,避免在 ID 中拼接大段文本。注:属性索引值超过 32 字节时会自动转为哈希存 [...]
+例如“投资”关系可以同时连接“个人 → 企业”和“企业 → 企业”。旧版 <code>sourceLabel()</code> 与 <code>targetLabel()</code> 只支持单一配对,现已废弃。</p><p>其他问题可搜索 <a href=https://github.com/apache/hugegraph/issues>Server issues</a> 或 <a href=https://github.com/apache/hugegraph-toolchain/issues>Toolchain issues</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d54c862d45861ca39a945d90325e3909>8 - 报告安全问题</h1><template data-hg-authored-content=start></temp [...]
 先根据集成方式找出受影响代码,再重新构建应用,并在部署前检查已有数据。</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--先确定需要调整的部分>先确定需要调整的部分</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>你的集成方式</th><th scope=col>需要准备什么</th></tr></thead><tbody><tr><td>Java 代码使用 Server 的 ID、schema 元数据、查询或索引</td><td>调整 import 和受影响签名,使用配套的 1.8.0 依赖包重新编译。</td></tr><tr><td>自定义序列化器、<code>HugeGraph</code> 实现或元素子类</td><td>按下方说明修改 SPI 契约和共享元素状态的适配。</td></tr><tr><td [...]
 升级时请使用配套的 Server、PD、Store 发行包及下游依赖。
 Java 映射和兼容性样本见<a href=https://github.com/apache/hugegraph/blob/master/docs/shared-foundation-migration.md>源码迁移指南</a>。</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--共享代码现在由谁维护>共享代码现在由谁维护</h2><p>此前 Server core 和 struct 分别维护了部分 ID、schema 类型、查询、元素和编解码实现。
diff --git a/cn/_print/docs/index.html b/cn/_print/docs/index.html
index ad3d74d92..8e89b94a9 100644
--- a/cn/_print/docs/index.html
+++ b/cn/_print/docs/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-theme=dark]{background [...]
-<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/>返回本页常规视图</a>.</p></div><h1 class=title>Documentation</h1><ul><li>1: <a href=#pg-d1742b0a409facb9dc9b2828826c6df3>Apache HugeGraph 介绍</a><ul></ul></li><li>2: <a href=#pg-64d47cfe1880443239e7c31f8fd1ac1a>下载 Apache HugeGraph</a></li><li>3: <a href=#pg-08b1b69f6319108b0455d24614fdd660>快速上手</a><ul><li>3.1: <a href=#pg-47e4c121d898d966f83e783dd8f23933>HugeGraph (OLTP)</a><u [...]
+<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/>返回本页常规视图</a>.</p></div><h1 class=title>Documentation</h1><ul><li>1: <a href=#pg-d1742b0a409facb9dc9b2828826c6df3>Apache HugeGraph 介绍</a><ul></ul></li><li>2: <a href=#pg-64d47cfe1880443239e7c31f8fd1ac1a>下载 Apache HugeGraph</a></li><li>3: <a href=#pg-08b1b69f6319108b0455d24614fdd660>快速上手</a><ul><li>3.1: <a href=#pg-47e4c121d898d966f83e783dd8f23933>HugeGraph (OLTP)</a><u [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>│                    Apache HugeGraph 生态                         │
 </span></span><span class=line><span class=ln> 3</span><span class=cl>├─────────────────────────────────────────────────────────────────┤
 </span></span><span class=line><span class=ln> 4</span><span class=cl>│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
@@ -44,13 +44,14 @@ markmap:
 ## pd
 ## store</code></pre><h2 id=pg-b7c813bb4e5fdd09cff177617e07847d--2-依赖>2 依赖</h2><p><span id=21-安装-java-11-jdk-11></span></p><h3 id=pg-b7c813bb4e5fdd09cff177617e07847d--21-安装-java-17-jdk-17>2.1 安装 Java 17 (JDK 17)</h3><p>从 HugeGraph 1.8.0 开始使用 <strong>Java 17</strong>;<strong>1.7.0 是最后一个支持 Java 11 的版本</strong>。
 所有模块的源码构建要求 <strong>JDK 17 和 Maven 3.6.3 或更高版本</strong>,Server、PD 和 Store 的运行环境统一使用 <strong>JDK 17</strong>。
-Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
+Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema 结果为标准 Map</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob 值以二进制格式传输(包含在返回图元素内的 Blob)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼 [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼容)</div><d [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - 保留 Tree 的旧 key/value 数组结构</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 因安全原因已禁用(typed V2/V3 仅适用于受支持的简单标量与 ID)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() 返回包含各类 label 的 Map</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>完整客户端配置与验证细节见 <a href=https://github.com/apache/hugegraph/blob/master/docs/server [...]
@@ -278,7 +279,7 @@ chart 和这些环境变量不会自动创建图空间;同一个 Server Deploy
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -694,62 +695,61 @@ HTTP 可以直接使用,TLS 终止可选。Hubble 仍是单副本,当前登
 chart 正常情况下自动注入共享 PD REST 凭据,自定义容器或 manifest 必须向 PD 和客户端提供同一值。
 GitOps 先创建外部 Secret 再调谐工作负载,普通 Helm 保留自动创建的 release Secret。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-a4bced169085a0c224fa69566df656b0>3.2 - HugeGraph ToolChain</h1><template data-hg-authored-content=start></template><blockquote><p><strong>测试指南</strong>:如需在本地运行工具链测试,请参考 <a href=/cn/docs/guides/toolchain-local-test>HugeGraph 工具链本地测试指南</a></p></blockquote><p>HugeGraph Toolchain 包含 Java/Go 客户端、Loader、Hubble、Tool [...]
 并在图、表格和 JSON 视图之间自由切换。本文以 <strong>单机 RocksDB Server + Hubble</strong> 为例走通完整操作,无需预先部署 PD 或 Store。</p><p>如需搭配 HStore 分布式集群使用,可先了解本文的基础操作,再参考 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>HStore 分布式补充</a>。
-文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前版本均为 <code>1.8.0</code>)为准;Docker <code>latest</code> 为动态标签,实际部署建议使用固定版本。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
-<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动单机组合</h2><p>直接使用主仓库提供的 <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a> 即可,
+文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前均以 1.8 为基线,尚未正式发布)为准;Docker <code>latest</code> 为动态标签,生产环境建议使用已发布的固定版本。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
+<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><p>可按需快速跳转到对应操作;首次使用建议从启动单机环境开始:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动并加载示例</a></p><p>启动两个服务,加载人物与软件示例图。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>查询与可视化</a></p><p>运行 Gremlin,再查看图、表格或 JSON 结果。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>导入自己的数据</a></p><p>准备 CSV,配置数据源、字段映射并验证导入结果。</p></li></ul><h2 id=p [...]
 无需自行编写 Compose 配置文件。该文件已内置编排了 RocksDB Server 与 Hubble,并配置好网络、健康检查及持久化数据卷;
-完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --br [...]
+完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><ol class=steps><li><p><strong>准备官方 Compose 配置。</strong></p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span cla [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>若本地已有主仓库,直接进入其 <code>docker/</code> 目录即可。Compose 会自动挂载该目录下的
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 已预设 <code>pd.enabled=false</code> 与 <code>server.direct_url=http://server:8080</code>。两项服务处于同一 Docker 网络中通信,
 无需为每个图单独配置 Server 地址。请直接在 <code>docker/</code> 目录下启动,以确保相对配置路径有效。</p><p>Hubble 默认只在宿主机回环地址开放 <code>8088</code>(由 <code>HUBBLE_PUBLISH_HOST</code> 环境变量控制,默认为 <code>127.0.0.1</code>);
-Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-b [...]
+Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p></li><li><p><strong>启动并检查服务。</strong></p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabin [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>打开 Hubble。</strong></p><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
 Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在 <code>.env</code> 中配置管理员密码与 JWT 密钥,并使用 Server 账号登录(Hubble 无独立用户库)。
-个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</code> 卷分别持 [...]
-<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页:找到当前任务的入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
+个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p></li></ol><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</ [...]
+<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页与任务入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
 顶部的图选择器用于切换当前操作的目标图,所有查询、Schema 操作和异步任务均作用于当前选中的图。
-单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
+单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
 初次体验建议在空图上加载,避免与已有同名 Schema 冲突。后续章节均基于该示例图演示。</p><p>若需新建图,可在页面点击新建按钮,填写图名称、可选别名并选择 Schema 模板或示例数据。连接信息由 Hubble 后端统一配置,
-无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>Schema 建模:定义数据的形状</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
-在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中:<code>person</code> 以 <cod [...]
+无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>定义 Schema</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
+在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中,<code>person</code> 以 <cod [...]
 <code>software</code> 采用自定义数值 ID;边类型 <code>created</code> 连接人物与软件。模型定义与 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>Loader 示例</a> 保持一致。</p><p>自主建模时,建议遵循 <strong>属性 → 顶点类型 → 边类型 → 索引</strong> 的顺序依次创建。
-删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>GQL 工作台:查询与探索人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
-支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中执行人物属性查询:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><s [...]
+删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>在 GQL 工作台查询人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
+支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中查询人物属性。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><spa [...]
 布局、样式和筛选工具帮助突出重点,导出功能便于分享结果。【新增】用于创建元素,有权限时也可以编辑已有数据。
 调整布局、颜色或显示范围仅影响前端画布;通过界面新增、编辑元素或执行 Gremlin 写入语句才会真正修改 Server 中的图数据。</p><p>快捷键 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 可快速执行查询。普通即时执行适合小规模交互探索;大数据量或耗时查询建议提交为后台异步任务。
-Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__body><p>Text2GQL 后端能力(包括模型设置、内置/临时模型管理与 Prompt 模板)依赖包含
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> 的 Hubble 构建或后续发布版本;未合入该特性的旧版本仅提供预览占位,不包含模型设置页面。</p></div></div><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
+Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
 生成的语句支持二次编辑(执行前同样会进行只读安全校验)。切换至【异步】模式时,生成的查询与手写查询均可提交为后台异步任务。
-输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="Text2GQL 查询与图结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p class=td-gallery__description>模型设 [...]
-注意:Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
+输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="未配置模型时的自然语言入口与手写 Gremlin 查询结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台,模型尚未配置,结果来自手写查询</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p cla [...]
+Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
 本地回环或私网模型;在【模型设置】中修改 Base URL 时,必须重新填写 Key 或清空已保存的 Key。
-全局内置模型仅由 <code>admin</code> 账号(PD 模式下为超级管理员)统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
+全局内置模型由具备模型设置管理权限的管理员统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
 点击【应用】后需保存模型设置,模板将持久化存入 H2 数据库供内置模型与临时模型共享,生成时会自动附加当前图的 Schema。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>API Key 存储与隐私说明</span></div><div class=td-callout__body><p>备份 Hubble H2 数据库时,请一并备份主密钥文件(默认路径 <code>data/text2gql-master.key</code>),该文件丢失将导致无法解密已保存的 Key。
 生成查询时仅向模型接口发送用户问题、当前 Schema 及纠错提示,绝不会发送图数据查询结果。
-浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>内置图算法:用表单探索关系</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
+浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>使用内置图算法</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
 邻居探索用于回答“这个点附近有什么”,路径算法用于寻找两个点的连接,相似度和排序算法用于比较或筛选顶点。
 从一个已知顶点 ID 开始,先限定方向、边类型、深度与返回规模,再观察结果,会比直接运行大范围计算更容易理解。</p><p>算法表单提供参数说明及文档入口;常用参数可以在页面间往返时恢复。
 运行结果按算法显示为图或相应的结果面板;需要理解具体定义和参数时,使用算法标题旁的说明与文档链接。
 表单聚焦时也可用 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 运行当前算法。</p><p>OLAP 批量算法需要 Computer 或 Vermeer 等外部计算环境。本例的两个容器用于在线图操作,不包含这些计算服务。</p><p>例如选择 K-neighbor(GET),设置 <code>source=1:marko</code>、<code>max_depth=1</code>、<code>limit=20</code>,
-参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>异步任务:确认后台操作的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
+参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>查看异步任务的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
 可以按任务类型和状态筛选,查看任务 ID、创建时间与执行状态;成功查询可打开结果,失败任务可展开错误信息。
 已结束的任务可按界面提供的操作删除记录,任务列表与导入任务的执行历史是两个不同入口。</p><p>例如把 <code>g.V().count()</code> 以异步方式提交后,先在列表确认成功,再查看返回的数量。
-“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>数据源管理:把原始数据准备好</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
-不同来源需要对应的路径、连接或订阅配置。FILE 最适合先体验:上传文件后,配置格式、分隔符、编码和表头,
-检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
+“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>准备数据源</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
+不同来源需要对应的路径、连接或订阅配置。首次体验可选择 FILE。上传文件后,配置格式、分隔符、编码和表头,
+检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>docs_alice</span><span class=p>,</span><span class=s>28</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs_bob</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><p>创建 FILE 数据源并上传它,选择 CSV(逗号分隔、默认 UTF-8),列名为 <code>name,age,city</code>。
-表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>数据导入:从字段映射到可查询的图</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
-沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务:</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
+表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>映射字段并导入数据</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
+沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务。</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
 AUTOMATIC 由 Server 生成 ID,PRIMARY_KEY 根据映射的主键属性生成 ID。边映射还需指定起点、终点字段并匹配对应顶点的 ID 规则。</p><p>任务列表用于管理配置和执行入口,详情中的执行历史用于查看每次实例的状态、导入量与错误。
 Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源类型匹配。
-完成后返回 GQL 工作台验证:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</sp [...]
+完成后返回 GQL 工作台查询新导入的数据。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>( [...]
 失败时先检查源字段、数值类型、可空属性及目标 Schema。Hubble 导入适合小规模体验,
 大批量正式导入请使用 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>HugeGraph Loader</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--个人中心与账号权限>个人中心与账号权限</h2><p>Hubble 使用 Server 的认证和账号,没有独立用户库。匿名访问时不显示【个人中心】与【账号管理】;
 开启认证后,个人中心展示当前账号资料与权限信息,可修改自己的密码。昵称等资料编辑依赖 Server 对个人资料接口的支持。
@@ -757,25 +757,20 @@ Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源
 通过 Hubble 新建的普通单机账号会获得覆盖所有图的读、写、删除和执行权限,不能把它当作只读账号或单图隔离账号。
 需要更细的资源权限时,应按 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>配置,而不是依赖空间预设。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--pd-模式的空间权限>PD 模式的空间权限</h3><p>连接支持默认角色接口的 Server 后,账号与空间访问可以分别管理。管理员管理全局账号,
 空间管理员只管理已授权空间的成员;普通成员不会获得账号管理或运维入口。
-以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
+以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
 把已有自定义权限替换为预设前,先核对需要保留的授权,避免把复杂权限误认为单一预设。
 权限变更后刷新权限上下文或重新登录,确认菜单和目标空间已更新;最终请求仍由 Server 校验。
 旧 Server 未提供相应接口时,页面按能力隐藏或禁用操作,不应只凭按钮是否可见推断资源权限。
-更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt="认证模式下的账号列表(PD 模式示例)" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>系统运维:检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
+更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt=认证模式下的账号列表(单机模式示例) width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
 节点列表可搜索、筛选健康状态并进入详情;详情用于查看可用的版本、系统、JVM、Server 后端等指标。
 指标缺失或标记过期时,应结合采集状态与最近成功时间判断,不能把空值当作零或健康。</p><p>匿名模式可以查看运维信息;开启认证后,运维入口仅对有运维权限的管理员显示。
 此处用于观测和排查,不是启动、停止或扩缩容控制台。PD 模式的集群概览与节点层级见分布式补充。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--快捷键与画布操作>快捷键与画布操作</h2><p>顶部的快捷键帮助入口随时可查看按键说明。以下快捷键有不同的作用范围,输入框中不会触发全局 <code>?</code> 帮助。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>操作</th><th scope=col>按键或动作</th><th scope=col>生效位置</th></tr></thead><tbody><tr><td>打开 / 关闭快捷键说明</td><td><span class=td-kbd-sequence><kbd>?</kbd></span></td><td>输入框和编辑器之外</td></tr [...]
 不是所有查询的硬上限;<code>gremlin.vertex_degree_limit</code>(<code>100</code>)与 <code>gremlin.edges_total_limit</code>(<code>500</code>)限制展开规模。
-FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>不再需要示例时,在主仓库的 <code>docker/</code> 目录执行:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>需要与 master 精确一致的产物时,使用 JDK 17 和 Maven 从 Toolchain 构建。
-Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不执行测试:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branch https://github.com/apache/ [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 编辑 conf/hugegraph-hubble.properties,设置正确的 Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>打包配置默认绑定本机 <code>localhost:8088</code>。<code>bin/stop-hubble.sh</code> 会先请求正常停机,超时后才强制终止。
+FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>清理测试环境时,在 <code>docker/</code> 目录下执行以下命令:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
+若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>从当前 master 构建时,需要 <strong>JDK 17、Maven 3.9+、Python 3.9+、稳定版 Node.js 24(至少 24.22.0)</strong>,
+并通过 Corepack 使用仓库锁定的 <strong>pnpm 12.14.0</strong>。Maven 不再自动安装 Node/Yarn。</p><ol class=steps><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 构建说明</a>
+编译并安装 Server SDK 到独立 Maven 仓库。</p></li><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble 源码构建步骤</a>
+安装 Python 依赖,再使用同一 Maven 仓库构建 Client、Loader 和 Hubble(跳过测试)。</p></li><li><p>进入构建生成的 <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> 目录,配置 <code>conf/hugegraph-hubble.properties</code> 中的 Server 连接信息后启动:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
 需要开发与测试说明时,参考 <a href=/cn/docs/guides/toolchain-local-test/>Toolchain 本地测试指南</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-91cea9e83b921f10aa1de60b138055b0>3.2.2 - 图可视化</h1><template data-hg-authored-content=start></template><p>Hubble 为 HugeGraph 提供图数据、Schema、查询和导入的 Web 界面。先从不依赖 PD 的单机组合入手,
 再按需要了解分布式集群的差异。</p><ul class=cards><li><a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机 RocksDB</a>:启动、示例图、建模、导入与查询。</li><li><a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>Hubble 与 HStore 分布式集群</a>:PD 发现、图空间与集群运维。</li></ul><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-33fca9af1c30d5ed43daaa61aa0928ea>3.2.2.1 - 使用 Hubble 管理 HStore 分布式集群</h1><div class=lead>连接 HStore 与 [...]
 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机指南</a>。
@@ -784,51 +779,108 @@ Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不
 配置 <code>.env</code> 并生成 Hubble 本地配置文件,然后在 <code>docker/</code> 目录下启动,无需自行维护部署文件。
 下文重点说明连接与运维配置要点,部署前请确保满足 README 中的 PD 凭据与前置依赖要求。
 Docker <code>latest</code> 为动态标签,配图用于定位界面,实际版本以部署镜像的 digest 及构建信息为准。
-不同版本可提供的指标和权限接口有所区别。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
-同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang [...]
+不同版本可提供的指标和权限接口有所区别。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
+同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|图 API| S[Server]
+    S --&gt;|读写图数据| T[Store]
+    H -.-&gt;|服务发现与集群信息| P[PD]
+    H -.-&gt;|节点指标| T</code></pre><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>脚本会读取 <code>.env</code> 中的 <code>HG_PD_AUTH_SECRET_KEY</code>,将其值作为 <code>operations.pd.password</code> 写入生成文件 <code>docker/conf/hubble/hstore.local.properties</code>。
 若需调整连接地址或运维参数,直接编辑该文件即可(请勿覆盖 Git 跟踪的 <code>.example</code> 模板文件),并确保 <code>operations.pd.password</code>
 与 PD 所用密钥一致。Compose 会将该文件只读挂载到容器内部,无需进入容器修改。
-该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
+该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
 <a href=/cn/docs/quickstart/hugegraph/hugegraph-hstore/>HStore 部署指南</a>;源码或二进制包启动的 Hubble 则编辑其
-<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址:</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
+<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
 发行包默认配置中显式设为 <code>pd.enabled=false</code>;若未配置该项,代码默认值为 <code>true</code>,因此单机与分布式部署均建议显式声明该配置。
-修改配置后:源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
-(沿用启动时的项目名及所有 <code>-f</code> 参数):</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
+修改配置后,源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
+(沿用启动时的项目名及所有 <code>-f</code> 参数)。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
 让各团队只看到并操作自己的图。进入图空间后,图的建模、导入和查询仍沿用基础指南的流程。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--创建与调整图空间>创建与调整图空间</h3><p>开启 Server 认证时,创建、编辑和删除图空间要求超级管理员权限。创建时先填写全局唯一的 GraphSpace 名称、
 可选的显示别名及最大图数;例如用 <code>research</code> 作 API 标识,用“研究图谱”作显示名。GraphSpace 名称创建后不可修改,
 别名和描述可随后调整,别名不参与 URL 或权限匹配。图空间管理员从已有账号中选择。</p><p>“高级部署与资源限制”包含图查询/写入服务、异步计算任务的 CPU 与内存上限,以及存储容量限制。
 这些部署配额不会显示实时资源用量,也不会自动扩容现有容器。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>高级部署的默认值</span></div><div class=td-callout__body><p>默认最大图数为 100;图服务与计算任务分别为 64 核、128 GB,存储上限为 1000000 GB。
 普通容器试用可保留默认值。Kubernetes 命名空间、Operator 和算法镜像仅在对应场景中填写。</p></div></div><p>选择图空间后,再进入其中的图。切换空间时应重新确认当前图,尤其是不同空间中存在同名图时。
-列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
+列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
 当一组业务图需要同样的顶点类型、边类型和索引时,可以先保存模板,再在创建图时选择它,减少重复建模。
-例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>用户模板与主篇的内置示例模板不同:内置模板用于快速体验预设模型,用户模板用于保存自己的模型并长期复用。
+例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>主篇的内置示例模板用于快速体验预设模型。用户模板用于保存自己的模型并长期复用。
 模板本身不等于导入数据;是否加载示例数据是创建图时的另一个选择。
 开启 Server 认证时,创建用户模板需要所在空间的写权限,更新或删除还要求模板所有者或相应管理权限。
 匿名模式不进行按用户的权限与模板所有者检查。
 单机模式不提供用户模板管理。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--给用户分配图空间权限>给用户分配图空间权限</h2><p>账号创建、登录和个人资料管理见<a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>基础指南</a>;
 分布式模式额外提供“管理 GraphSpace 成员”,在已有账号与指定空间之间分配权限。
-支持权限预设的 Server 提供以下常用选择:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
+支持权限预设的 Server 提供以下常用选择。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
 账号与空间成员分开管理,移除成员不会删除全局账号。创建账号后可以立即继续分配空间权限;调整已有成员时,确认当前空间及预设,保留其他空间仍需要的权限。
 仅启用 <code>pd.enabled</code> 不会授予权限,旧 Server 的自定义角色也不能直接当作这些预设处理。
-认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
+认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
 概览中的 PD Leader、在线 Store 数、图数、分区数、副本数和数据量,帮助判断当前连接的规模及哪些节点需要关注。
-分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点:<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
+分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点。<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
 <code>DOWN</code> 表示相应探测未成功。拓扑可用而指标部分缺失时,仍可能正常查询图。
-页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
+页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
 Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性检查;各版本可用的指标不同。</p><p>开启 Server 认证时,集群运维读取要求超级管理员(<code>ADMIN</code> 级别),空间管理员和普通成员不会因此获得集群读取权限。
 部署时使用容器隔离、可信 HTTPS 入口、Server 认证与网络白名单,避免直接公开 Hubble 和组件端口。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--配置运维访问>配置运维访问</h3><p>PD/Store 的运维凭据由 Hubble <strong>后端</strong>使用,与浏览器登录 Server 的账号分开。
 Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.local.properties</code>;其他部署修改 Hubble 包内配置文件。
-其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
-且需与 PD 返回的 Store 指标目标完全一致。注意:仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次排查:Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
-以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>3.2.3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code>(当前版本为 <code>1.8.0</code>)为准。发布版和 Docker <code>latest</code> 可能与源码不同;使用时请核对版本,未发布的版本请按下文从源码构建。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loa [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。
-旧版 Server 保持下文说明的原有导入行为。</p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>2 获取 HugeGraph-Loader</h3><p>可以通过以下三种方式获取 HugeGraph-Loader:</p><ul><li>使用 Docker 镜像 (便于<strong>测试</strong>)</li><li>下载已编译的压缩包</li><li>克隆源码编译安装</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--21-使用-docker-镜像-便于测试>2.1 使用 Docker 镜像 (便于<strong>测试</strong>)</h4><p>我们可以使用 <code>docker run -itd --name loader hugegraph/loader:latest</code> 部署 loader 服务。对于需要加载的数据,则可以通过挂载 <code>-v /path/ [...]
+其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
+且需与 PD 返回的 Store 指标目标完全一致。仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次检查 Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
+以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>3.2.3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code> 分支(以 1.8 为基线,尚未正式发布)为准。发布版和 Docker <code>latest</code> 可能存在部分差异,使用未发布功能前请先核对版本。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--quick-local-file-import>快速上手: [...]
+请先<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>安装 Loader</a> 并启动 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>。
+以下命令均在 Loader 安装目录下执行,连接本地默认图 <code>hugegraph</code>。若 Server 已启用鉴权,在命令中追加 <code>--username</code> 与 <code>--password</code>(或 <code>--token</code>)。</p><ol class=steps><li><p><strong>创建数据文件</strong></p><p>两份 CSV 均不含表头,列名由下一步的映射文件指定。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-955f155a-fence-0-viewport data-td-code-viewport><div class=highlight><p [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>创建 Schema 和映射文件</strong></p><p>本例使用独立的 <code>docs_*</code> 名称,避免与内置的 <code>person</code> 数据冲突。
+映射文件中的路径相对于运行 Loader 时的工作目录。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>执行导入</strong></p><p>保持在同一工作目录。Server 运行在其他地址时,修改主机和端口。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>首次成功导入后,统计应显示两个顶点、一条边。检查汇总中的成功数和失败数。</p></li><li><p><strong>在 Hubble 中查询结果</strong></p><p>将 Hubble 连接到同一个 Server 和图,在 Gremlin 工作台分别执行以下查询。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>第一条查询返回 Alice 的年龄 <code>29</code>、Bob 的年龄 <code>31</code>,第二条返回 <code>docs-smoke-bob</code>。</p></li></ol><p>导入其他数据源时,继续阅 [...]
+<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>内置完整示例</a>还包含软件顶点和边属性。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-概述>1 HugeGraph-Loader 概述</h3><p>HugeGraph-Loader 是 HugeGraph 的数据导入组件,能够将多种数据源的数据转化为图的顶点和边并批量导入到图数据库中。</p><p>目前支持的数据源包括:</p><ul><li>本地磁盘文件或目录,支持 TEXT、CSV 和 JSON 格式的文件,支持压缩文件</li><li>HDFS 文件或目录,支持压缩文件</li><li>主流关系型数据库,如 MySQL、PostgreSQL、Oracle、SQL Server</li><li>Kafka topic</li><li>已有的 HugeGraph 图,用于把数据从一个图复制到另一个图</li></ul><p>本地磁盘文件和 HDFS 文件支持断点续传。</ [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -843,9 +895,12 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>具体的数据导入流程可以参考 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</a></p><blockquote><p>注意:</p><ol><li><p>hugegraph-loader 的 docker 镜像是一个便捷版本,用于快速启动 loader,并不是<strong>官方发布物料包方式</strong>。你可以从 <a href=https://infra.apache.org/release-distribution.html#dockerh [...]
-发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>克隆 <code>master</code> 分支:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash>< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
-启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>使用 HugeGraph-Loader 的基本流程分为以下几步:</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>这一步是建模的过程,用户需要对自己已有的数据和想要创建的图模型有一个清晰的构想,然后编写 schema 建立图模型。</p><p>比如想创建一个拥有两类顶点及两类边的图,顶点是"人"和"软件",边是"人认识人"和"人创造软件",并且这些顶点和边都带有一些属性,比如顶点"人"有:&ldquo;姓名&rdquo;、&ldquo;年龄"等属性, &ldquo;软件"有:&ldquo;名 [...]
+发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>从 master 分支编译 Loader 需要 Java 17、Maven 3.6.3+ 与 Python 3.9+。直接克隆仓库并编译:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>如需搭配开发阶段的 Server master SDK 编译,可参阅 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
+启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>导入数据前先准备图模型、数据文件和映射文件,再运行 Loader。</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>先确定数据对应的顶点类型、边类型和属性,再编写 Schema。</p><p>以下示例包含 <code>person</code> 和 <code>software</code> 两类顶点,以及 <code>knows</code> 和 <code>created</code> 两类边。
+人有姓名、年龄和城市,软件有名称和价格,两类边都记录日期。</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt=由“认识”和“创建”边连接人物与软件顶点的示例图><p>示例图模型</p></div><p>将 Schema 定义保存到 <code>schema.groovy</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=16><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code  [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -860,19 +915,21 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// 创建 knows 边类型,这类边是从 person 指向 person 的
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// 创建 created 边类型,这类边是从 person 指向 software 的
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln> [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>如果在建模(schema)时指定 person 或 software 的 id 策略是 PRIMARY_KEY,选择以 name 作为 primary keys(注意:这是 hugegraph 中 vertexlabel 的概念),在导入边数据时,由于需要拼接出源顶点和目标顶点的 id,必须拿着 p_id/s_id 去 person/software 表中查到对应的 name,这种需要做额外查询的表结构的情况,loader 暂时是不支持的。这时可以采用以下两种方式替代:</p><ol><li>仍然指定 person 和 software 的 id 策略为 PRIMARY_KEY,但是以 person 表和 software 表的 id 列作为顶点的主键属性,这样导入边时直接使用 p_id 和 s [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-11-v [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+需要关联数据时,先在数据源侧准备好查询结果。</p><p>以下以 <code>person</code>、<code>software</code>、<code>created</code> 三张表为例。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>// person 表结构
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=l [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>若 <code>person</code> 和 <code>software</code> 使用 <code>PRIMARY_KEY</code> 策略,以 <code>name</code> 为主键,导入边时就需要两个端点的 <code>name</code>。
+<code>created</code> 表只有 <code>p_id</code> 和 <code>s_id</code>,Loader 不会用它们回查名称。可以改用以下两种 ID 设计。</p><ol><li>保留 <code>PRIMARY_KEY</code> 策略,将两张顶点表的 <code>id</code> 列作为主键属性。Loader 可用 <code>p_id</code>、<code>s_id</code> 和顶点标签生成端点 ID。</li><li>使用自定义 ID 策略,将两张顶点表的 <code>id</code> 列直接作为顶点 ID,导入边时直接使用 <code>p_id</code> 和 <code>s_id</code>。</li></ol><p>这两种设计都让边数据直接提供端点 ID,省去回查。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-准备顶点和边数据>3.2.2 准备顶点和边数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-14-v [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-languag [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-code data-td-code-auto-id data-td-languag [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -889,7 +946,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-c [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-18 data-td-c [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -1087,7 +1144,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-16 data-td-code data-td-code-auto-id data-td-lan [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-19 data-td-code data-td-code-auto-id data-td-lan [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1138,7 +1195,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1167,8 +1224,8 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// 如果没有更新策略,则会得到
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 若参数文件包含凭据,使用 <code>chmod 0600 loader.args</code> 把权限限制为 <code>0600</code>;<code>@file</code> 调用让这些值不出现在进程参数中。
 Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 从只读 Kubernetes ConfigMap 挂载映射文件时,先把映射复制到可写卷中再运行 Loader。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-断点续导模式>3.4.2 断点续导模式</h5><p>通常情况下,Loader 任务都需要较长时间执行,如果因为某些原因导致导入中断进程退出,而下次希望能从中断的点继续导,这就是使用断点续导的场景。</p><p>设置 <code>--incremental-mode</code> 为 <code>true</code> 即可从进度文件续导。Loader 在导入成功或正常停止后关闭时写入进度;意外失败可能阻止该写入。
@@ -1179,43 +1236,8 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 失败文件中,用户对失败文件中的数据行修改后,设置 &ndash;failure-mode 为 true 即可把这些"失败文件"也当作输入源进行导入(不影响正常的文件的导入),
 当然如果修改后的数据行仍然有问题,则会被再次记录到失败文件中(不用担心会有重复行,关闭文件时会去重)。失败模式下上述三个错误上限会被解除,因此会扫描整个失败文件。</p><p>每个输入源(即映射文件 <code>structs</code> 中的每一项)都会有自己的失败文件,文件名为该输入源的 <code>id</code> 加后缀 <code>.error</code>,保存在 <code>${struct}/failure-data</code> 目录下。
 每一条失败记录写为两行:一行以 <code>#### READ ERROR:</code>、<code>#### PARSE ERROR:</code> 或 <code>#### INSERT ERROR:</code> 开头的提示行,紧接着是原始数据行。当输入源有 header 时,header 会以 JSON 形式写入同目录下的 <code>${id}.header</code> 文件,以便失败文件能按正确的列重新读取。
-比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p><code>people.csv</code> 没有表头行,列名由映射文件的 <code>header</code> 提供。映射文件中的本地路径相对于运行命令时的工作目录。仍在 Loader 安装目录中执行导入;如果 Server 在其他容器中,请把 <code>--host</code> 改为 Loader 能访问到的 Server 地址。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__vi [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>本例用独立的 <code>docs_smoke_person</code> 标签和 <code>docs_*</code> 属性,避免与预置的 <code>person</code> 样例数据冲突。成功时统计中应显示顶点写入成功数为 <code>2</code>、边写入成功数为 <code>0</code>。也可以在 Hubble 的 Gremlin 工作台查询 <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code>,结果应包含 <code>docs-smoke-alice</code> 和 <code>docs-smoke-bob</code> [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
+若部署的 Server 提供该接口并返回 <code>protocol: 1</code>,Loader 会自动启用所有权保护;已发布的 Server 1.7.0 及更早版本则继续使用原有模式切换流程。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;图模式 NONE&#34;] --&gt;|首个 Loader 申请所有权| B[&#34;进入 LOADING 模式 (分配 token)&#34;]
     B --&gt;|其他并发 Loader 加入| B
     B --&gt;|部分 Loader 导入完成释放| B
@@ -1228,18 +1250,18 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 权限、网络、图不存在或无效响应错误不会触发回退。</li><li><strong>恢复与图源导入</strong>:保留 <code>RESTORING</code> 模式,不探测 owner 且不自动重置。恢复导入完成后须手动将图模式设回 <code>NONE</code>,否则后续普通导入无法获取首个所有权。
 在活跃 owner 存在期间,请勿运行恢复导入、图源导入、Spark connector 或旧版 Loader 导入。</li><li><strong>作用范围与生命周期</strong>:所有权属于直连 Server 实例,不跨节点同步;owner 无自动租期过期机制。
 对于嵌入式程序集成,调用方必须调用 <code>HugeGraphLoader.shutdown()</code> 执行单次句柄释放;若释放失败,不会自动重试;
-该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
+该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1262,7 +1284,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> 使用自定义数值 ID,映射中的 <code>id</code> 和 <code>created.target_id</code> 分别对应顶点 ID 及边的目标 ID。
-请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
+请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1322,7 +1344,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-33-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-34-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -1334,7 +1356,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -1342,11 +1364,11 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
-只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-39 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
+只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -1368,17 +1390,29 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> 通过 <code>${SPARK_HOME}/bin/spark-submit</code> 提交 <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code>,因此 <code>SPARK_HOME</code> 必须指向一个 Spark 安装目录。<code>lib/</code> 下的所有 jar 都会加入 classpath。 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> 单独处理:使用 <code>--deploy-mode cluster</code> 时,映射文件会通过 <code>--files</code> 分发到 executor,loader 只收到它的文件名;其他情况下路径原样传入。</p><p>该模式下 loader 只读取 FILE、HDFS 和 JDBC 输入源,KAFKA 和 GRAPH 输入源会被拒绝。</p><p>默认情况下(<code>--sink-type true</code>),每个 Spark 分区各自创建一个 HugeClient,通过 HugeGraph serve [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>3.2.4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loa [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-41 data-td-code data-td-code-auto- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+POM 中的 Spark <code>3.2.2</code> 只提供编译期 API,不是运行引擎。设置 <code>SPARK_HOME</code> 和 <code>JAVA_HOME</code>,
+再使用发行目录中的启动脚本和 shaded Loader JAR。</p><p>先创建 Schema,确保 executor 可以读取数据文件。CSV、TEXT 数据须使用 UTF-8、去掉表头行,并在映射中显式指定 <code>header</code>。
+其他字符集和 <code>has_header: true</code> 会被拒绝。边依赖已有顶点时,先导入顶点。将以下路径替换为准备好的顶点映射文件。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <s [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>启动脚本可同时接收 <code>--master</code>、<code>--conf</code>、<code>--jars</code> 等 Spark 参数和 Loader 参数。
+额外的 JDBC 驱动需通过 <code>--jars</code> 传入,仅放在 <code>lib/</code> 中不会分发到 executor。
+导入后查询目标图,核对数量和属性;API 写入路径的插入计数器不统计分布式写入。</p><p>该路径拒绝 <code>--incremental-mode true</code> 和 <code>--failure-mode true</code>。Standalone Spark 仅支持 client 部署模式。
+Spark 3.5.8 / Java 17 不支持 HBase bulkload(<code>--sink-type false</code>)。已有 bulkload 部署建议继续沿用原环境验证通过的
+Loader 发布包及其相关依赖。更多细节见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark 迁移说明</a>。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-使用-flink-cdc-loader-导入>4.7 使用 flink-cdc-loader 导入</h4><p>当前 master 分支适配 Flink <code>2.2.1</code>、MySQL CDC <code>3.6.0-2.2</code> 和 Java 17。
+此前使用 Flink 1.13.5、CDC 2.2.1 的示例属于旧实现。
+设置 <code>FLINK_HOME</code>,确保提交进程、JobManager 和 TaskManager 都使用 Java 17。
+保留 Flink 的模块访问参数,发行目录的 <code>lib/</code> 中须恰好有一个 shaded Loader JAR。</p><p>每个映射都需使用 MySQL JDBC 输入,包含 <code>url</code>、<code>database</code>、<code>table</code>、<code>username</code> 和 <code>password</code>。
+MySQL 须配置 <code>binlog_row_image=FULL</code>。UPDATE 事件需要显式指定非空的 <code>update_strategies</code>,且图元素标识保持不变。
+顶点 ID、边端点或排序键变化时,任务会拒绝更新。CDC 也会拒绝 <code>--dry-run true</code> 和 <code>--use-prefilter true</code>。</p><p>不带分隔符时,所有参数均交给 Loader。需要设置 Flink 参数时,将其放在 <code>--</code> 之前,Loader 参数放在之后。
+准备好 <code>mysql-cdc.json</code> 映射后,使用单个 sink writer 提交任务。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-loader.sh -p <span class=m> [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>每个映射使用一个 source reader 和一个 sink writer。<code>--cdc-sink-parallelism</code> 默认为 <code>1</code>,其他取值会被拒绝。
+<code>--</code> 之后的 Loader 参数 <code>-p</code> 表示 Server 端口。Checkpoint 刷新不提供图写入事务,也不保证 exactly-once。
+在生产环境部署边 CDC 或更复杂的多表映射前,建议先在真实环境中充分验证。
+支持范围和恢复流程见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC 说明</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>3.2.4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loader;已有 Source、Transform、Sink 管道时使用 SeaTunnel Sink;Spark 作业可使用 Spark Connector。</p [...]
 列出的前置要求为 Java 8 或 11。从<a href=https://seatunnel.apache.org/download/>官方下载页</a><sup>[4]</sup>
 选择 3.0+ 二进制发行包,并使用页面提供的校验文件或签名验证下载包。
 下面以 3.0.0 为例,请将 <code>SEATUNNEL_VERSION</code> 改为实际下载的发行版本。</p><div class="td-code td-code--untitled" id=td-code-7df75818-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-7df75818-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>SEATUNN [...]
@@ -1511,22 +1545,39 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools 位于 toolchain 发布包的子目录中,</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># 其版本后缀与发布包本身一致</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>源码编译前请确保安装了wge [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. 下载发布版源码包</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>编译生成 tar 包:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-c [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>生成的 tar 包位于 <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>,同时会在 <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> 生成解压后的目录(包含 <code>bin/</code> 和 <code>lib/</code>)</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3. [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>任选一种方式构建发布版 <c [...]
+两段命令均包含编译和进入生成目录,最后用 <code>bin/hugegraph help</code> 查看可用命令。</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git 标签" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git 标签</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab=源码包 data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>源码包</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-e3b5ef3d-fence-2-viewport dat [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>编译还会在源码根目录下生成 <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code>。</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 构建当前源码</h4><p>若需要使用 master 分支未发布的新特性,可按以下步骤从源码构建 Tools(当前 master 以 1.8 为基线,需 JDK 17、Maven 3.6.3+ 与 Python 3.9+):</p><ol class=steps><li><p><strong>获取 Toolchain 源码</strong></p><div c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>构建配套 Server SDK</strong></p><p>执行以下脚本下载 Server 源码并将配套 SDK 安装到独立 Maven 仓库:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__viewport id=td-code-e3b5ef3d-fence-4-viewport data-td-code-viewport><div  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>详细说明见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p></li><li><p><strong>打包 Tools</strong></p><div clas [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>使用这份源码构建时保留 SDK 仓库。master 分支生成目录名不含 <code>incubating</code>。</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3.1 功能概览</h4><p>进入解压或编译生成的 Tools 目录,用 <code>bin/hugegraph help</code> 查看命令列表,
+用 <code>bin/hugegraph help &lt;子命令></code> 查看单个命令的用法。可用命令分为以下几类。</p><ul><li>图管理类,graph-mode-set、graph-mode-get、graph-list、graph-get、graph-clear、graph-create、graph-clone 和 graph-drop</li><li>异步任务管理类,task-list、task-get、task-delete、task-cancel 和 task-clear</li><li>Gremlin类,gremlin-execute 和 gremlin-schedule</li><li>备份/恢复类,backup、restore、migrate、schedule-backup 和 dump</li><li>认证数据备份/恢复类,auth-backup 和 auth-restore</li><li>旧版 Server/Studio 部署,deploy、clear、start-all 和 stop-all</li></ul><div cla [...]
+<code>--user</code> 和 <code>--password</code> 必须同时提供或同时省略。</p></blockquote><p>使用 <code>export</code> 设置的环境变量对当前终端及其启动的命令生效。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>全局变量</th><th scope=col>环境变量</th><th scope=col>示例</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGRAPH_URL</td><td>export HUGEGRAPH_URL=http://127.0.0.1:8080</td></tr><tr><td>&ndash;graph</td><td>HUGEGRAPH_GRA [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>另一种方式是在 bin/hugegraph 脚本中设置环境变量:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-6-viewport data-td-code-viewport><div class=hig [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>也可以在 <code>bin/hugegraph</code> 脚本中设置这些变量。</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-9-viewport data-td-code-viewport><div [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -1538,7 +1589,9 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> 还会读取 <code>JAVA_HOME</code>(未设置时打印警告,https 需要它)和 <code>JAVA_OPTIONS</code>(JVM 参数,为空时脚本使用 <code>-Xms512m</code>,并根据机器空闲内存计算 <code>-Xmx</code>)。</p><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--33-图管理类graph-mode-setgraph-mode-getgraph-listgraph-getgraph-cleargraph-creategraph-clone和graph-drop>3.3 图管理类,graph-mo [...]
 restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设置),否则命令会失败</p></blockquote></li><li>migrate,将当前连接的图迁移至另一个 HugeGraphServer 中<ul><li>&ndash;target-graph,目标图的名字,默认为 hugegraph</li><li>&ndash;target-url,目标图所在的 HugeGraphServer,默认为 http://127.0.0.1:8081</li><li>&ndash;target-user,访问目标图的用户名</li><li>&ndash;target-password,访问目标图的密码</li><li>&ndash;target-timeout,访问目标图的超时时间</li><li>&ndash;target-trust-store-file,访问目标图使用的 truststore 文件</li><li>&ndash;target-trust-store-password,访问目标图使用的 trust [...]
 用户也可以自定义存储格式。在 <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code> 下实现一个继承自 <code>Formatter</code> 的类,例如 <code>CustomFormatter</code>,使用时指定该类为 formatter:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+新部署请参考 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速上手</a> 与 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 快速上手</a>,
+以下说明仅供维护旧环境参考。</p><ul><li>deploy,一键下载、安装和启动 HugeGraph-Server 和 HugeGraph-Studio<ul><li>-v,必填项,指定要安装的 HugeGraph-Server 和 HugeGraph-Studio 版本,必须是 bin/version-map.yaml 中列出的版本之一(0.6、0.7、0.8、0.9、0.10),脚本据此映射到对应的 server 和 studio 发布版本</li><li>-p,必填项,指定安装的 HugeGraph-Server 和 HugeGraph-Studio 目录</li><li>-u,选填项,指定下载 HugeGraph-Server 和 HugeGraph-Studio 压缩包的链接</li></ul></li><li>clear,清理 HugeGraph-Server 和 HugeGraph-Studio 目录和tar包(若对应的 server 或 studio 进程仍在运行则拒绝执行,删除每一项前都会提示确认)<ul><li>-p,必填项,指定要清理的 Hu [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -1947,26 +2000,26 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-8-viewport data- [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 异步执行gremlin</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-10-viewport data-td [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-13-viewport data-td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport data-td-code-viewport><div class= [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-14-viewport data-td-code-viewport><div class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 恢复图</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 恢复图模式</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-15-viewport data-td-code-viewport [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-18-viewport data-td-code-viewport [...]
 并行扫描的后端要求和配置限制见<a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>官方 Source 文档</a>。</p><p>开始前请先完成<a href=/cn/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-%E5%87%86%E5%A4%87%E7%8E%AF%E5%A2%83>导入页中的通用环境准备和配置</a>,其中包含 JDK、HOCON、插件安装和图模型说明。</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-迁移-hugegraph-图graph2graph>1 迁移 HugeGraph 图(graph2graph)</h2><p>下面从源图迁移 <code>person</code> 顶点和 <code>knows</code> 边。请使用独立的目标图:本节采用 <code>CUSTOMIZE_STRING</code> 保留顶点 [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
 </span></span><span class=line><span class=ln> 3</span><span class=cl>}
@@ -2297,27 +2350,81 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+文档向量化需要 Embedding,图数据抽取和答案生成还需要 LLM。Reranker 可选,初次运行可用本地 <code>bleu</code>。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>想做什么</th><th scope=col>页面入口</th><th scope=col>需要准备什么</th></tr></thead><tbody><tr><td>从文档建立索引</td><td><code>1. Build RAG Index</code></td><td>文档、Embedding;抽取图数据还需 Schema 和 LLM</td></tr><tr><td>根据文档或图回答问题</td><td><code>2. (Graph)RAG & User Functions</code></td><td>对应索引和 LLM</td></tr><tr [...]
+已有文件会保留。模板包含完整的 6 列,只填写测试问题和预期答案,4 个模型回答列留空。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-49825bb1-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>uv run --extra llm python - <span class=s>&lt;&lt;&#39;PYTHON&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-配置面板>0. 配置面板</h2><p>标签页上方是可折叠的配置面板,共五个部分,包括 <code>1. Set up the HugeGraph server.</code>、<code>2. Set up the LLM.</code>、<code>3. Set up the Embedding.</code>、<code>4. Set up the Reranker.</code> 和 <code>5. Set up the vector engine.</code>。每部分都有独立的应用按钮,应用后会把受支持的字段写回 <code>.env</code>。 [...]
+截图使用本地 Ollama 的 <code>qwen2.5:3b</code> 和 <code>mxbai-embed-large</code>,向量引擎为 <code>Faiss</code>。
+更换 Embedding 模型后需重建索引,避免新旧向量维数或含义不同。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-构建-rag-索引>1. 构建 RAG 索引</h2><p>第一个标签页负责两类索引。</p><ul><li>将文档切分后写入 chunk 向量索引。</li><li>按 Schema 从文档抽取顶点和边,写入 HugeGraph,并维护顶点向量索引。</li></ul><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[输入文档] --&gt; B[文本切分]
     B --&gt; C[生成 chunk 向量]
     C --&gt; D[写入向量索引]
     B --&gt; E[LLM 按 Schema 抽取顶点和边]
     E --&gt; F[写入 HugeGraph]
-    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>页面包含文档、Schema、抽取提示词和结果区域。常用操作有:</p><ol><li><code>Import into Vector</code>:切分文档并建立 chunk 向量索引。</li><li><code>Extract Graph Data (1)</code>:按 Schema 抽取图数据。</li><li><code>Load into GraphDB (2)</code>:把抽取结果写入 HugeGraph,并自动更新顶点向量。</li><li><code>Update Vid Embedding</code>:重新生成顶点向量,通常只在图中已有数据时才需要单独执行。</li></ol><p>这些按钮旁的 <code>Gr [...]
+    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>首次尝试可以使用下面的短文,填入 <code>Input Doc(s)</code>。请先选择专用测试图,避免将示例写入业务图。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-2 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-2-viewport data-td-code-viewport><div class=highlight><pre [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>页面包含文档、Schema、抽取提示词和结果区域。按下面的顺序建立图索引。只用向量检索时,完成第 1 步即可。</p><ol class=steps><li>点击 <code>Import into Vector</code>,切分文档并建立 chunk 向量索引。</li><li>在 <code>Graph Schema</code> 填入 Schema JSON 或已有图名,再点击 <code>Extract Graph Data (1)</code>。检查 <code>Output Info</code> 中的顶点、边和属性。</li><li>确认抽取结果后点击 <code>Load into GraphDB (2)</code>,写入 HugeGraph 并更新顶点向量。</li><li [...]
+图里已经有数据时,可以单独点击 <code>Update Vid Embedding</code> 更新顶点索引。</p><p>这些按钮旁的 <code>Graph Extraction Split Type</code> 下拉框可选 <code>document</code>、<code>paragraph</code> 或 <code>sentence</code>。<code>document</code> 把输入整体作为一个单元,另外两种会在抽取前先切分长文档。</p><p>页面还可以查看或清除 chunk 索引、顶点索引和图数据。清除操作会删除已有数据,执行前先确认当前图和索引是否仍被其他查询使用。</p><p>主控件下方还有两个折叠的辅助工具。</p><ul><li><code>Graph Schema Generator</code> 根据查询示例和少样本示例生成 Schema,填入 Graph Schema 字段。</li><li><code>Graph Extraction Prompt Generator</code> 根据期望场景(例如社交关系、金 [...]
+关键词输出需使用代码块中的英文前缀和冒号,姓名的大小写应与图数据一致。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>只根据检索到的上下文,用中文简洁回答问题,保留原文中的姓名。上下文不足时说明缺少信息。
+</span></span><span class=line><span class=ln>2</span><span class=cl>上下文: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>只返回一行,严格使用英文冒号,格式为 KEYWORDS:姓名:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {question}</span></span></code></pre></div></div></div><ol class=steps><li>输入 <code>Who is Sarah?</code>,将 <code>Graph-only Answer</code> 设为 <code>False</code>,<code>Graph-Vector Answer</code> 设为 <code>True</code>。</li><li>初次验证时保留 <code>Template Num=-1</code> 和 <code>Rerank method=bleu</code>,点击 <code>Answer Question</code>。</li><li>查看 <code>Graph-Vector Answer</code>,将答案中的职业、年龄等事实与原文和图数据核对。</li></ol><ul class="td-g [...]
     Q[问题] --&gt; V[查询 chunk 向量索引]
     Q --&gt; K[抽取关键词]
     K --&gt; M[匹配图顶点]
-    M --&gt; T[生成并执行 Gremlin]
-    T --&gt;|失败| B[BFS 图遍历回退]
+    M --&gt; D{启用 Text2Gremlin}
+    D --&gt;|是| T[生成并执行 Gremlin]
+    D --&gt;|否| B[BFS 图遍历]
+    T --&gt;|失败| B
     T --&gt; R[整理图结果]
     B --&gt; R
     V --&gt; S[合并与重排序]
     R --&gt; S
-    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式:</p><ul><li>小于 0:完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0:不带任何示例生成 Gremlin(zero-shot)。</li><li>大于 0:从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 [...]
+    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式。</p><ul><li>小于 0 时,完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0 时,不检索参考示例,使用基础生成结果。</li><li>大于 0 时,从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 <cod [...]
+未上传文件时使用内置的 <code>resources/demo/text2gremlin.csv</code>。示例中的标签和属性应与当前图一致。</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>若上传 CSV 构建示例向量索引后未自动召回示例模板,可直接在下面的 Prompt 模板中手动提供 Few-shot 参考示例。</p></div></div><p>复现 Sarah 查询时,使用以下输入。</p><ol class=steps><li>将下面的 CSV 保存为 <code>sarah-gremlin.csv</code>,上传后点击 <code>Build [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>按人物姓名查询时,使用 g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;问题中的姓名&gt;&#39;).valueMap()。
+</span></span><span class=line><span class=ln> 3</span><span class=cl>保留姓名的大小写,按姓名查询,不使用顶点 ID。
+</span></span><span class=line><span class=ln> 4</span><span class=cl>问题示例: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Gremlin 示例: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>图 Schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>其他示例: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>已知顶点: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>问题: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>只返回一个 ```gremlin``` 代码块。</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/cn/text2gremlin.jpg alt="Text2Gremlin 生成的查询与执行结果" loading=lazy decoding=async></li></ul><p>小模型可能生成错误 ID、大小写不符的姓名或不满足索引条件的过滤语句。应查看执行结果中的具体数据,再判断查询是否成功。
+Web 页面会直接执行生成的语句,请使用专用测试图。需要只生成语句时,在 <a href=/cn/docs/quickstart/hugegraph-ai/rest-api/>REST API</a> 中选择相应输出类型。</p><p>自定义提示词必须保留 <code>{query}</code>、<code>{schema}</code>、<code>{example}</code> 和 <code>{vertices}</code>。缺少任一占位符时,REST API 会拒绝请求。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-图工具与管理工具>4. 图工具与管理工具</h2><p><code>Graph Tools</code> 标签页可直接对当前图执行 Gremlin 查询、手动触发图备份,并通过 beta 操作初始化 HugeGraph 演示数据。后台还有两个任务,每天凌晨 1 点自动备份图数据,以及在进程运行期间持续更新顶点 id 向量。
+初始化演示数据会先清空当前图,只能在专用测试图上使用。</p><p><code>Admin Tools</code> 需要密码。输入已配置的 <code>ADMIN_TOKEN</code> 后可查看 <code>logs/llm-server.log</code> 的末尾内容(每 60 秒自动刷新),并可手动刷新或清空该文件。<code>ADMIN_TOKEN</code> 为空或仍是占位值 <code>xxxx</code> 时,访问会被拒绝。</p><p>设置 <code>ENABLE_LOGIN=True</code> 后,Web 页面会要求基础认证,用户名固定为 <code>rag</code>,密码是 <code>USER_TOKEN</code>;REST API 则要求把 <code>USER_TOKEN</code> 作为 Bearer token。日志接口还要求单独配置安全的 <code>ADMIN_TOKEN</code>。</p><div class="td-callout td-callout--warning" role=note><div  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>EN</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 中文提示词</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不是 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quickst [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不属于 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quicks [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> 默认开启,因此不带参数运行效果相同。配置模块首次导入时会为缺失的 <code>.env</code> 和提示词 YAML 按默认值创建文件;文件已存在时,生成器会交互询问是否覆盖。该命令会处理 HugeGraph、管理员、LLM、索引配置及提示词 YAML,不会在无确认的情况下覆盖已有文件。</p><p><code>.env</code> 包含密钥和密码,不要提交到版本库。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--基础选项>基础选项</h2><div class="td-table-scroll td-table-scroll--static" ta [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>Web 页面的 <code>5. Set up the vector engine.</code> 面板提供同样的选择,并会保存所选引擎的连接配置。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--登录与日志接口>登录与日志接口</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置项</th><th scope=col>默认值</th><th scope=col>说明</th></tr>< [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
@@ -2940,7 +3047,7 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_endpoint</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;http://minio:9000&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_access_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-access-key&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_secret_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-secret-key&#34;</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker-与-master-配置>5. Worker 与 Master 配置</h3><p>Worker 和 Master 计算逻辑的配置。</p><h4 id=pg-094fc5e6c5eaa81703c55b700e7863d5--51-master-配置>5.1 Master 配置</h4><div [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker-与-master-配置>5. Worker 与 Master 配置</h3><p>Worker 和 Master 计算逻辑的配置。</p><h4 id=pg-094fc5e6c5eaa81703c55b700e7863d5--51-master-配置>5.1 Master 配置</h4><div [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>&lt;dependencies&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
@@ -2948,10 +3055,14 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=c>&lt;!-- 以下完整示例可使用已发布的 1.7.0 --&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>以下完整示例使用的 Schema、Graph、Gremlin 和资源关闭接口在已发布的 Client <code>1.7.0</code> 中可用,也与 Toolchain <code>master</code> 兼容。
-上面的依赖可直接用于示例工程。</p><p>如果需要<a href=/cn/docs/clients/hugegraph-client/>API 参考</a>中的 master 新接口(例如能力探测),请使用 Toolchain <code>master</code> 的 Client <code>1.8.0</code>,
-将 POM 中的版本改为 <code>1.8.0</code>。该版本未发布到 Maven 仓库时,先在 Toolchain 源码根目录运行以下命令,
-将 Client 及其父 POM 安装到本地 Maven 仓库。源码构建仍需从配置的 Maven 仓库获取依赖。</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -DskipTests -Dmav [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>先根据用途选择客户端版本。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>用途</th><th scope=col>客户端版本</th><th scope=col>Java 编译目标</th></tr></thead><tbody><tr><td>运行下方完整示例</td><td>已发布的 <code>1.7.0</code>,使用上面的依赖即可</td><td>发布版 POM 为 Java 8;本文统一使用 JDK 17</td></tr>< [...]
+发布版的 Java 编译目标不代表所有传递依赖的运行环境要求。</p><p>若需要使用 master 分支未发布的新接口,可从源码编译安装 Client(需配合 Toolchain 源码,详见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools 源码构建指引</a>):</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lan [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>两条版本检查都应显示 JDK 17。使用 master 分支 Client 的项目运行 Maven 命令时,也需添加 <code>-Dmaven.repo.local="$candidate_dir/m2"</code>。
+Client 与 Server 的版本不必相同;升级前核对所需 API 及兼容范围。</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>选择单条操作或批量操作示例,将完整代码保存为 Maven 工程中的 <code>src/main/java/SingleExample.java</code> 或
+<code>src/main/java/BatchExample.java</code>。复制按钮会包含已折叠的代码行。</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-18ca6629-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--431-singleexample>4.3.1 SingleExample</h5><div  [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -3099,7 +3210,7 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=139><div class=td-code__viewport id=td-code-18ca6629-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -3237,7 +3348,9 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><p>运行 Example 之前需要启动 Server, 启动过程见<a href=/cn/docs/quickstart/hugegraph/hugegraph-server>HugeGraph-Server 快速上手</a></p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍< [...]
+</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><ol class=steps><li><a href=/cn/docs/quickstart/hugegraph/hugegraph-server>启动 HugeGraph Server</a>,在图空间 <code>DEFAULT</code> 中准备名为 <code>hugegraph</code> 的测试图。</li><li>将 Maven 工程的 JDK 设为 17,把所选示例中 <code>HugeClient.builder(...)</code> 和 <code>configUser [...]
+Server 未开启鉴权时,省略 <code>configUser(...)</code>。</li><li>在 IDE 中运行 <code>SingleExample.main()</code> 或 <code>BatchExample.main()</code>。两个示例都会创建 Schema 和图数据、打印结果并关闭客户端。
+请使用测试图,已有 Schema 或数据可能影响重复运行。</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍</a></p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>3.5.2 - HugeGraph Python 客户端快速上手</h1><template data-hg-authored-content=start></template><p><code>hugegraph-python-client</code> 是 HugeGraph 的 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 也可以使用 pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>上述命令不固定版本号,默认安装最新发布版;发行信息见 <a href=https://pypi.org/project/hugegraph-python/>PyPI 发布页</a>。源码目录名是 <code>hugegraph-python-client</code>,发行包名为 <code>hugegraph-python</code>;需要主线代码时,请从 HugeGraph-AI workspace 安装。</p><p>如需使用仓库中的最新代码,请从 HugeGraph-AI 仓库根目录同步 workspace。<code>hugegraph-python-client</code> 是 workspace 成员,通过  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
@@ -3560,15 +3673,17 @@ HTTP 4xx/5xx 仍可能返回 <code>err == nil</code>,例如创建顶点时指
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;hugegraph_rocksdb&#34;</span>,<span class=s2>&#34;backend&#34;</span>:<span class=s2>&#34;rocksdb&#34;</span><span class=o>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-6bfbb2db4e1f281942d741cef305e724>4.2 - Server 完整配 [...]
 自 HugeGraph 1.8.0 起生效。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置项</th><th scope=col>默认值</th><th scope=col>说明</th></tr></thead><tbody><tr><td>arthas.telnet_port</td><td>8562</td><td>管理员通过 <code>PUT /arthas</code> 激活时使用的 Arthas telnet 端口。</td></tr><tr><td>arthas.http_port</td><td>8561</td><td>管理员激活时使用的 Arthas HTTP 端口。</td></tr><tr><td>arthas.ip</td><td>127.0.0.1</td><td>监听地址;管理员 [...]
 发行包内的 <code>bin/arthas.sh</code> 可直接免配置进行本地诊断。
-详细激活方式、权限要求及认证配置请参见 <a href=/cn/docs/clients/restful-api/other/#1116-%E5%90%AF%E5%8A%A8-arthas-%E8%AF%8A%E6%96%AD%E4%BB%A3%E7%90%86>Arthas 诊断代理</a>。</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server 配置项</strong></span></div><div class=td-callout__body><p>对应配置文件<code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+详细激活方式、权限要求及认证配置请参见 <a href=/cn/docs/clients/restful-api/other/#1116-%E5%90%AF%E5%8A%A8-arthas-%E8%AF%8A%E6%96%AD%E4%BB%A3%E7%90%86>Arthas 诊断代理</a>。</p></div></div><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label><strong>RPC Server 配置项</strong></span></div><div class=td-callout__body><p>对应配置文件<code>rest-server.properties</code></p><div class="td-table-scroll td-table-scroll [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+<code>audit-*.log</code>,部署时必须保留并限制这些日志的读取权限。<code>auth.audit_log_rate</code> 只限制每用户的日志输出速率,不是审计日志的启停开关。</p></div></div><p><code>StandardAuthenticator</code> 支持多用户认证和细粒度权限控制。也可以实现 <code>HugeAuthenticator</code> 接口来接入已有的用户系统。</p><p>用户认证使用 <a href=https://zh.wikipedia.org/wiki/HTTP%E5%9F%BA%E6%9C%AC%E8%AE%A4%E8%AF%81>HTTP Basic Authentication</a>。<code>Basic</code> 后面的值是 <code>用户名:密码</code> 的 Base64 编码。使用 curl 时可直接通过
+<code>-u</code> 传入凭据。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>curl -u <span class=s1>&#39;admin:&lt;password&gt;&#39;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p><strong>保护 Basic Authentication 凭据</strong></p><p> [...]
-源码默认会生成 32 个随机字节并以 Base64 编码,但该值不会写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥:</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-2-viewport data-td-code- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewpo [...]
+核心配置默认会生成 32 个随机字节并以 Base64 编码,该默认值不会自行写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥。</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-2-viewport data-td- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewpo [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>authenticator</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.StandardAuthenticator,</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>authenticationHandler</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.WsAndHttpBasicAuthHandler,</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=nt>tokens</span><span class=p>:</span><span class=w> </span><span class=l>conf/rest-server.properties}</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>在 <code>rest-server.properties</code> 中配置认证器和权限数据存储图:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-bbebf2ff-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-p [...]
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div></div><p>在 <code>conf/rest-server.properties</code> 中配置认证器和权限数据存储图。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class=td-code__viewport id=td-code-bbebf2ff-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=langu [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.graph_store</span><span class=o>=</span><span class=s>hugegraph</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Server 启动路径首次创建内置 admin 账号时使用,默认值为公开的 pa,生产部署前务必显式设置强密码</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 本地持久化后端首次启用 StandardAuthenticator 时,init-store.sh 会交互式读取密码</span>
@@ -3576,24 +3691,47 @@ HTTP 4xx/5xx 仍可能返回 <code>err == nil</code>,例如创建顶点时指
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># auth client config</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl><span class=c1># 如果是分开部署 GraphServer 和 AuthServer,还需要指定下面的配置,地址填写 AuthServer 的 IP:RPC 端口</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p>其中,<code>graph_store</code>配置项是指使用哪一个图来存储用户信息,如果存在多个图的话,选取任意一个均可。</p><p>在配置文件<code>hugegraph{n}.properties</code>中配置<code>gremlin.graph</code>信息:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-6 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-c [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>bin/stop-hugegraph.sh
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 初始化认证系统信息;已有后端数据会被保留</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>bin/init-store.sh
-</span></span><span class=line><span class=ln>6</span><span class=cl>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># start hugeGraph again</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hugegraph.sh</span></span></code></pre></div></div></div><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式</h3><p>对于镜像 <code>hugegraph/hugegraph</code> 大于等于 <code>1.2.0</code> 的版本,我们可以在启动 <code>docker</code> 镜像的同时开启鉴权模式</p><p>具体做法如下:</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-采用-docker-run>1. 采用 docker run</h4><p>在 <code>docker run</code> 中添加环境变量 <code>PASSWORD=xxx</code>(密码 [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>hugegraph/hugegraph:1.7.0</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>      </span>- <span class=m>8080</span><span class=p>:</span><span class=m>8080</span><span class=w>
-</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>9</span><span class=cl><span class=w>      </span>- <span class=l>PASSWORD=xxx</span></span></span></code></pre></div></div></div><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>3. 进入容器后重新开启鉴权模式</h4><p>首先进入容器:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport da [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 用于快速修改配置, 修改前的文件被保存在conf-bak文件夹下</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p>之后参照 <a href=#pg-7d189549d4201521c83e0d93a2474a2d--基于鉴权模式启动>基于鉴权模式启动</a> 即可</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4.4 - 配置 HugeGraphServer 使用 https 协议</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1f [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div></div><p><code>auth.graph_store</code> 指定保存认证数据的图,名称必须与 <code>conf/graphs/</code> 中的图配置对应。</p><p>在每个受保护图的配置文件 <code>conf/graphs/&lt;graph>.properties</code> 中设置 <code>gremlin.graph</code>。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-6 data-td-code data-td-code-auto-id data-td- [...]
+HStore/PD 部署的管理员由 PD 启动路径创建,须按该部署的配置设置 <code>auth.admin_pa</code>,不要照搬本地后端的交互式初始化流程。</p><ol class=steps><li><p><strong>停止 Server。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span clas [...]
+此命令补充后端与认证系统信息,不需要删除原有存储目录。</p></li><li><p><strong>启动并检查认证。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-bbebf2ff-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hugegraph.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>curl -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>curl 会提示输入密码。正确密码应返回 HTTP 200;不带凭据或使用错误密码应返回 HTTP 401。
+启动失败时先检查日志和认证图配置,不要通过清空数据来重试。</p></li></ol><h3 id=pg-7d189549d4201521c83e0d93a2474a2d--使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式</h3><p>新容器在 Docker run 和 Compose 中选择一种方式。已经运行过的容器直接阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>既有容器</a>。</p><p>使用 Docker 部署时,官方镜像支持通过环境变量直接开启鉴权模式(适用于官方 Server 镜像 <code>/hugegraph-server</code> 布局)。
+将占位符替换为实际镜像标签或 digest:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_IMAGE</span><span class=o>=</spa [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>read</span> -r -s -p <span class=s1>&#39;Admin password: &#39;</span> PASSWORD
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>printf</span> <span class=s1>&#39;\n&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>export</span> PASSWORD</span></span></code></pre></div></div></div><p>提示输入管理员密码后执行启动命令。为保障凭据安全,请避免将密码以明文形式提交到共享 Compose 文件中。
+JWT 密钥仍按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--配置用户认证>上面的配置</a>持久保存到认证图配置;多节点必须使用同一个值。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--1-采用-docker-run>Docker run</h4><p>创建一个新容器,并仅向本机开放 REST 端口。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-bbebf2ff-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -p 127.0.0.1:8080:8080 <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  -e PASSWORD <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUGEGRAPH_IMAGE</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>入口脚本完成认证配置和首次初始化后启动 Server。接着阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--检查认证结果>检查认证结果</a>。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--2-采用-docker-compose>Docker Compose</h4><p>将下面的内容保存为 <code>compose.yaml</code>。必填变量缺失时,Compose 会报错,避免意外启动无认证服务。
+在同一终端中启动服务。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-12 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-bbebf2ff-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>      </span>- <span class=s2>&#34;127.0.0.1:8080:8080&#34;</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>      </span><span class=nt>PASSWORD</span><span class=p>:</span><span class=w> </span><span class=l>${PASSWORD:?Set PASSWORD}</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-13-viewport data-td-code [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div></div><p>以后重新创建容器前,需要重新设置这些变量。保留已有数据卷,并按部署要求持久保存配置。
+接着阅读<a href=#pg-7d189549d4201521c83e0d93a2474a2d--检查认证结果>检查认证结果</a>。</p><h4 id=pg-7d189549d4201521c83e0d93a2474a2d--3-进入容器后重新开启鉴权模式>既有容器</h4><p>此路径适用于原先未开启认证、使用本地持久化后端的官方 Server 容器。
+先备份数据,并确认配置、后端数据及 <code>conf-bak</code> 均位于容器挂载的持久卷中。
+官方镜像将 <code>/hugegraph-server</code> 声明为卷;自定义镜像应先检查挂载位置。
+HStore/PD 或外部认证服务使用各自的管理员初始化流程。</p><ol class=steps><li><p><strong>停止原容器,使用同一镜像和数据卷打开临时维护容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-bbebf2ff-fence-14-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span cl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>docker stop server
+</span></span><span class=line><span class=ln>3</span><span class=cl>docker run --rm -it --volumes-from server <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --entrypoint bash <span class=s2>&#34;</span><span class=nv>$SERVER_IMAGE</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>原容器须保持停止,防止两个 JVM 同时打开本地数据库。<code>--entrypoint bash</code> 使维护容器只打开终端。</p></li><li><p><strong>在维护容器内修改配置并初始化。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div></div><p><code>enable-auth.sh</code> 首次运行时将原配置保存到 <code>conf-bak</code>,然后修改默认 <code>hugegraph</code> 图和认证配置。
+如果 <code>conf-bak</code> 已存在,脚本会跳过修改,须按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--standardauthenticator-模式>StandardAuthenticator 模式</a>检查三处配置。
+使用其他认证图时也应手动配置对应文件。
+按<a href=#pg-7d189549d4201521c83e0d93a2474a2d--配置用户认证>上面的配置</a>将强随机 JWT 密钥写入认证图配置,再运行初始化命令。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-16 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-bbebf2ff-fence-16-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/init-store.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>exit</span></span></code></pre></div></div></div><p>按提示输入管理员密码,确认初始化成功后退出。</p></li><li><p><strong>在宿主机启动原容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-17 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-bbebf2ff-fence-17-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=langua [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+</span></span><span class=line><span class=ln>3</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div></div><p>未携带凭据的请求预期返回 <code>401 Unauthorized</code>,输入正确密码的请求返回 <code>200 OK</code>(若输入错误密码则同样返回 <code>401</code>)。
+注:当前主线版本 URL 包含 <code>/graphspaces/DEFAULT</code>,1.7.0 等历史版本请省略 graphspace 前缀(直接使用 <code>/graphs/hugegraph/...</code>)。
+若未提供凭据仍返回 <code>200</code>,说明鉴权未成功启用,请检查配置并重启 Server。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-7e400260398a18d0be72b1fe5a73f419>4.4 - 配置 HugeGraphServer 使用 https 协议</h1><template data-hg-authored-content=start></template><h3 id=pg-7e400260398a18d0be72b1fe5a73f419--概述>概述</h3><p>HugeGraphServer 默认使用的是 http 协议,可以配置成 https。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>restserver.url</span><span class=o>=</span><span class=s>https://127.0.0.1:8080</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># 服务端 keystore 文件路径,当协议为 https 时该默认值自动生效,可按需修改此项</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>ssl.keystore_file</span><span class=o>=</span><span class=s>conf/hugegraph-server.keystore</span>
@@ -9114,8 +9252,8 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=n>graphSpace</span><span class=p>.</span><span class=na>setMaxRoleNumber</span><span class=p>(</span><span class=n>100</span><span class=p>);</span><span class=w>  </span><span class=c1>// 最大角色数量</span><span class=w>
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=c1>// 创建 GraphSpace</span><span class=w>
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>spaceManager</span><span class=p>.</span><span class=na>createGraphSpace</span><span class=p>(</span><span class=n>graphSpace</span><span class=p>);</span></span></span></code></pre></div></div></div><h4 id=pg-3457a7585a93814fdbb1a44b68edc0d3--42-graphspace-接口汇总>4.2 GraphSpace 接口汇总</h4><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr> [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div></div><p>然后输入下述命令:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class=td-code__viewport id=td-code-41ddd794-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma> [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=n>spaceManager</span><span class=p>.</span><span class=na>createGraphSpace</span><span class=p>(</span><span class=n>graphSpace</span><span class=p>);</span></span></span></code></pre></div></div></div><h4 id=pg-3457a7585a93814fdbb1a44b68edc0d3--42-graphspace-接口汇总>4.2 GraphSpace 接口汇总</h4><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div></div><p>然后运行示例脚本。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class=td-code__viewport id=td-code-41ddd794-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma> [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>         <span class=se>\,</span>,,/
 </span></span><span class=line><span class=ln> 4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
@@ -9128,7 +9266,7 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span><span class=line><span class=ln>11</span><span class=cl>model load finished, <span class=nb>time</span> elapsed <span class=m>35</span> ms.
 </span></span><span class=line><span class=ln>12</span><span class=cl>&gt;&gt;&gt;&gt; query all vertices: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
 </span></span><span class=line><span class=ln>13</span><span class=cl>&gt;&gt;&gt;&gt; query all edges: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
-</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/3.5.1/gremlin-console/src/main/groovy/org/apache/tinkerpop/gremlin/console/Console.g [...]
+</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/3.5.1/gremlin-console/src/main/groovy/org/apache/tinkerpop/gremlin/console/Console.g [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>2</span><span class=o>:</span><span class=n>lop</span><span class=o>]</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>1</span><span class=o>:</span><span class=n>josh</span><span class=o>]</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>]</span>
@@ -9142,36 +9280,26 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>1</span><span class=o>&gt;&gt;</span><span class=nl>S1:</span><span class=n>vadas</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>knows</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>peter</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>peter</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
-</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-请求模式>2 Client/Server 请求模式</h3><p>Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。默认配置使用 <code>WsAndHttpChannelizer</code>,可同时处理 WebSocket 和 HTTP 请求,无需切换 Channeli [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># ......</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>channelizer</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># ......</span></span></span></code></pre></div></div></div><p>确认 <code>host</code>、<code>port</code> 与 <code>remote.yaml</code> 一致,然后按照<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>步骤</a>启动 HugeGraph-Server。</p><p>下面进入 Gremlin-Console:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=9><div cla [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>
-</span></span><span class=line><span class=ln>3</span><span class=cl>         <span class=se>\,</span>,,/
-</span></span><span class=line><span class=ln>4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>-----oOOo-<span class=o>(</span>3<span class=o>)</span>-oOOo-----
-</span></span><span class=line><span class=ln>6</span><span class=cl>plugin activated: HugeGraph
-</span></span><span class=line><span class=ln>7</span><span class=cl>plugin activated: tinkerpop.server
-</span></span><span class=line><span class=ln>8</span><span class=cl>plugin activated: tinkerpop.utilities
-</span></span><span class=line><span class=ln>9</span><span class=cl>plugin activated: tinkerpop.tinkergraph</span></span></code></pre></div></div></div><p>连接 Server,需在配置文件中指定连接参数,在 conf 目录下有一个默认的 <code>remote.yaml</code>:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-5 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=10><div class=td-code__viewport id=td-code-41ddd794-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabinde [...]
-</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=p>,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>  </span>}<span class=w>
-</span></span></span><span class=line><span class=ln>10</span><span class=cl>}</span></span></code></pre></div></div></div><p>如果 Server 开启了鉴权模式,需要在同一个文件中补上凭据:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span c [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=l>pa</span></span></span></code></pre></div></div></div><p><code>conf</code> 目录下还提供了 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code>,它们使用相同的 host、port 和序列化器配置。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line- [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>==&gt;Configured localhost/</span><span class=mf>127.0</span><span class=o>.</span><span class=mf>0.1</span><span class=o>:</span><span class=mi>8182</span></span></span></code></pre></div></div></div><p>Server 端的图以图空间限定名绑定,因此图空间 <code>DEFAULT</code> 下的图 <code>hugegraph</code> 绑定名为 <code>DEFAULT-hugegraph</code>,其 traversal source 绑定名为 <code>__g_DEFAULT-hugegraph</code>。裸写 <code>hugegraph</code> 在 S [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>();</span> <span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div><blockquote><p>注意:在 Client/Server 模式下,所有和 Server 有关的操作都要加上 <code>:> </code>,如果不加,表示在 console 本地操作。<code>:> </code>发送的脚本不带别名 [...]
+</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=pg-1ebf9ecb86d8a6b8536fd581e696ce8c--2-clientserver-请求模式>2 Client/Server 请求模式</h3><p>Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。使用与 Server 同版本发行包中的 Console 和 <code>conf/remote.yaml</code>,
+保留文件中的序列化器配置,只修改地址,以及启用鉴权时需要的凭据。旧版配置可能引用已经不存在的序列化器类。</p><ol class=steps><li><p>准备连接配置并启动 Server。</p><p>检查 <code>conf/gremlin-server.yaml</code> 中的 <code>host</code>、<code>port</code>。默认的 <code>WsAndHttpChannelizer</code> 同时处理 WebSocket 和 HTTP 请求,无需修改。
+<code>conf/remote.yaml</code> 中的 <code>hosts</code> 应填写 Console 能访问的 Server 地址,<code>port</code> 应与 Gremlin 端口一致(默认为 <code>8182</code>,不是 REST 端口 <code>8080</code>)。
+按照<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>快速上手</a>启动 Server。</p><p>当前 master 配置使用 GraphBinary V1 和 HugeGraph 类型注册器。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-3 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class=td-code__viewport id=td-code-41ddd794-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1< [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div><p>如果 Server 开启了鉴权,在同一个文件中填写实际凭据。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-4 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2> [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;replace-with-your-password&#34;</span></span></span></code></pre></div></div></div><p>随包的 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code> 使用相同的序列化器配置;使用这些文件时也要保持一致。</p></li><li><p>从 Server 发行包目录启动 Console,并创建带 traversal 别名的客户端。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fen [...]
+由于连字符 <code>-</code> 在 Groovy 中不能直接用作变量名,通过 Java Driver 连接时,使用 <code>.alias(['g': '__g_DEFAULT-hugegraph'])</code> 将其映射为 <code>g</code>。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span></span></span></code></pre></div></div></div></li><li><p>通过客户端提交查询。</p><div class="td-c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span></span></span></code></pre></div></div></div><p>若启动 Server 时预加载了示例图,两条查询均返回  [...]
+通过 Driver 的 <code>client.submit()</code> 提交脚本时,无需在语句前加 <code>:></code> 前缀。</p></li><li><p>使用结束后关闭客户端和集群连接。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-8 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=2><div class=td-code__viewport id=td-code-41ddd794-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div></div></li></ol><p>此外,也可以使用 Gremlin Console 内置的 <code>:remote</code> 命令连接:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-9 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport id=td-code-41ddd794-fence-9-vie [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>/</span><span class=o>/</span> <span class=err>通过</span> <span class=n>Console</span> <span class=err>远程连接提交脚本时,前缀使用</span> <span class=o>:&gt;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>close</span></span></span></code></pre></div></div></div><p>使用 <code>:remote</code> 连接时,以 <code>:></code> 开头的语句会被发送至远端 Server 执行,普通语句则在 Console 本地执行。</p><p>更多用法见 <a href=https://tinkerpop.apache.org/docs/current/reference/#gremlin-console>TinkerPop Gremlin Console 参考</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style [...]
   Apps[&#34;应用 / 运维&#34;] --&gt; Toolchain[&#34;Toolchain&#34;] --&gt; Server[&#34;Server REST API&#34;]
   AI[&#34;AI&#34;] -. REST .-&gt; Server
   Computer[&#34;Computer&#34;] -. REST .-&gt; Server
@@ -9668,9 +9796,36 @@ RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂
 </span></span><span class=line><span class=ln>11</span><span class=cl>hubble-dist/assembly/travis/verify-hubble-issue-694.sh <span class=se>\
 </span></span></span><span class=line><span class=ln>12</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUBBLE_TARBALL</span><span class=s2>&#34;</span> http://127.0.0.1:8080</span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--44-hugegraph-spark-connector>4.4 hugegraph-spark-connector</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--编译-3>编译</h4><div class="td-code td-code--untitled" id=td-code-1ef5b90d-fence-18 data-td-code data-td-cod [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--45-hugegraph-tools>4.5 hugegraph-tools</h3><h4 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--编译-4>编译</h4><div class="td-code td-code--untitled" id=td-code-1ef5b90d-fence-20 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-常见问题>5. 常见问题</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--服务连接问题>服务连接问题</h3><p>无法连接 Server、MySQL 或 Hadoop 时:</p><ul><li>确认服务已启动(Server 必须在 8080 端口)</li><li>检查端口占用:<code>lsof -i:8080</code></li><li>Docker 检查:<code>do [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn <span class=nb>test</span> -Dtest<span class=o>=</span>FuncTestSuite -ntp  <span class=c1># 需 Server 运行</span></span></span></code></pre></div></div></div><h2 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--5-常见问题>5. 常见问题</h2><h3 id=pg-b40b2c5536e23eb0d840cec7ca4f346a--服务连接问题>服务连接问题</h3><p>无法连接 Server、MySQL 或 Hadoop 时:</p><ul><li>确认服务已启动(Server 必须在 8080 端口)</li><li>检查端口占用:<code>lsof -i:8080</code></li><li>Docker 检查:<code>do [...]
+它们是 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a> 的命令,适合图迁移、升级后的恢复及图合并。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup>Backup</h4><p>备份可在任意图模式下执行。建议在导出前暂停源图的写入操作,以确保 Schema、顶点和边的数据一致性(分批读取不提供全局事务快照)。
+注意:<code>backup -t all</code> 仅导出图的 Schema 和图数据,不包含系统配置文件与用户权限。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore>Restore</h4><p>恢复数据前,需先根据目标图的状态切换恢复模式。日常读写处于 <code>NONE</code> 模式;注意:<code>LOADING</code> 模式不能用于 <code>restore</code>。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>目标</th><th scope=col>模式</th><th scope=col>Schema ID</th><th scope=col>顶点和边 ID</th></tr></thead><tbody><tr><td>恢复到没有 Schema  [...]
+<code>AUTOMATIC</code> 和自定义顶点 ID 保留。合并会复用同名 Schema,先检查双方的定义是否兼容,以及保留的顶点 ID 是否冲突。
+它不提供任意 Schema 冲突或数据冲突的自动解决策略。先在独立目标图验证,再合并正式数据。</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--使用方法>使用方法</h2><p>准备与 Server 版本匹配的 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a>,在 Tools 根目录执行以下命令。
+本例从 <code>8080</code> 的源图恢复到 <code>8081</code> 的空目标图。两个 Server 和目标图应已创建并启动;可将变量改成实际地址及图名。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-705ab766-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nv>SOURCE [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>TARGET_URL</span><span class=o>=</span>http://127.0.0.1:8081
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>SOURCE_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nv>TARGET_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nv>BACKUP_DIR</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$PWD</span><span class=s2>/data/hugegraph-backup&#34;</span></span></span></code></pre></div></div></div><p>启用认证时,在每条 Tools 命令的子命令前加入 <code>--user &lt;user> --password &lt;password></code>,并使用具备对应图读写和模式管理权限的账号。
+详细参数及凭据使用方式见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-1>Backup</h4><p>暂停源图写入后,备份全部 Schema、顶点和边。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-705ab766-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  backup -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>显式指定的 <code>-d</code> 就是备份目录,不会自动附加图名。为每次备份使用独立目录,避免混入旧文件。
+保留完整目录,包括压缩文件;Restore 可读取 Tools 支持的 JSON 备份格式。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-1>Restore</h4><p>以下流程使用 <code>RESTORING</code>。合并时改为 <code>MERGING</code>,并先完成上面的兼容性检查。
+操作期间暂停目标图业务写入。</p><ol class=steps><li><p><span id=步骤1查看并设置图模式></span><strong>查看并记录原模式,再切换。</strong></p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-705ab766-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegra [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>ORIGINAL_MODE</span><span class=o>=</span>NONE
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  graph-mode-set -m RESTORING</span></span></code></pre></div></div></div><p>正常业务图应处于 <code>NONE</code>。将查询返回的值填入 <code>ORIGINAL_MODE</code>,例如下方的 <code>NONE</code>。若另一项维护正在使用 <code>RESTORING</code>、<code>MERGING</code> 或 <code>LOADING</code>,先协调该任务,不要覆盖其模式。</p></li><li><p><span id=步骤2restore-数据></span><strong>恢复数据。</strong></p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-3 data-td-code data-t [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  restore -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><p>检查命令输出与各类型的导入结果。若发生错误,请先保留备份目录与日志,并检查目标图的数据状态。
+Restore 不会自动回滚已写入的数据,切勿在部分恢复的图上盲目重跑。</p></li><li><p><span id=步骤3恢复图模式></span><strong>还原原模式。</strong></p><p>使用第一步记录的 <code>ORIGINAL_MODE</code> 还原模式。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-705ab766-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> graph-mode-get</span></span></code></pre></div></div></div><p>无论恢复成功还是失败,最后都必须将图模式还原为原有模式(通常为 <code>NONE</code>)。
+若恢复失败,先保留现场并排查日志,待重新准备目标图后再恢复业务写入。</p></li></ol><p>还原模式后,对比两端的顶点数和边数。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-705ab766-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;< [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span></span></span></code></pre></div></div></div><p>两组计数结果应保持完全一致。建议进一步通过 <a href=/cn/docs/clients/restful-api/schema/>Schema API</a> 核对元数据定义,
+并抽样检查顶点和边的属性与端点关联,确保业务数据的完整性。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--帮助>帮助</h4><p>更多关于压缩、并发和分类型备份的参数说明,见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。
+在跨大版本恢复前,建议先在测试环境中验证备份文件的兼容性。</p><h2 id=pg-2c9db416c8d78f898d52c91ec12535d4--backuprestore使用和实现的api说明>Backup/Restore使用和实现的API说明</h2><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--backup-2>Backup</h4><p>Backup 使用 Schema、顶点和边的列表 GET API 导出数据。</p><h4 id=pg-2c9db416c8d78f898d52c91ec12535d4--restore-2>Restore</h4><p>Restore 使用 Schema、顶点和边的创建 API 导入数据。模式对应的 ID 行为见<a href=#pg-2c9db416c8d78f898d52c91ec12535d4--restore>前面的选择表</a>。
+<code>RESTORING</code> 允许指定 Schema ID;<code>MERGING</code> 不允许指定 Schema ID。两种模式均允许保留 <code>AUTOMATIC</code> 顶点 ID。
+普通 <code>NONE</code> 模式不接受这些恢复操作所需的 ID 设置。</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--查看某个图的模式>查看某个图的模式</h5><p>启用鉴权时需要图读取权限(<code>space_member</code> 或该图的所有者)。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=1><div class=td-code__viewport id=td-code-705ab766-fence-6-viewport data-td-code-viewport><div class=highlight [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;NONE&#34;</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><blockquote><p>合法的图模式包括:NONE,RESTORING,MERGING,LOADING</p></blockquote><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--设置某个图的模式>设置某个图的模式</h5><p>启用鉴权时需要图空间管理权限(<code>space</code>);管理员可按权限继承规则满足。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url-1>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-fence-8 data-td-code data-td- [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>合法图模式为 <code>NONE</code>、<code>RESTORING</code>、<code>MERGING</code> 和 <code>LOADING</code>。</p><h5 id=pg-2c9db416c8d78f898d52c91ec12535d4--设置某个图的模式>设置某个图的模式</h5><p>启用鉴权时需要图空间管理权限(<code>space</code>);管理员可按权限继承规则满足。</p><h6 id=pg-2c9db416c8d78f898d52c91ec12535d4--method--url-1>Method & Url</h6><div class="td-code td-code--untitled" id=td-code-705ab766-f [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;RESTORING&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3>6.6 - HugeGraph Docker 集群部署指南</h1><template data-hg-authored-content=start></template><h2 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--概述>概述</h2><p>HugeGraph 通过 Docker-Compose 可快速运行完整的分布式集群版(PD + Store + Serve [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>HUGEGRAPH_AUTH_TOKEN_SECRET</span><span class=o>=</span><span class=s1>&#39;&lt;32 字节随机值,例如 openssl rand -hex 32&gt;&#39;</span>
@@ -9740,17 +9895,13 @@ Compose 中 Server 服务的 <code>environment:</code> 里添加,自带的 Com
 启动期限失败、或 Java 在就绪前以 <code>0</code> 退出时,入口脚本返回 <code>1</code>;提前以非零码退出则保留该退出码。
 此时长不包括此前的存储初始化或等待后端就绪的时间。关闭时可以中断就绪和分区检查;启动期限失败会请求终止 Java 并返回,不增加无限等待。
 未响应终止请求的 Java 进程仍依靠容器终止完成最终清理。</p><p>例如,在 HugeGraph 仓库的 <code>docker/</code> 目录下,将单机 Server 的启动等待时间增加到 300 秒(Compose 文件会将该变量传入容器):</p><div class="td-code td-code--untitled" id=td-code-a045eb23-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-a045eb23-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1 [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>该设置与 Docker 健康检查的 <code>start_period</code>、<code>interval</code>、<code>timeout</code> 和 <code>retries</code> 相互独立。健康检查参数决定何时将容器标记为 <code>unhealthy</code>;仅增加健康检查的等待时间,不会延长 Server 启动脚本的等待期限。调整此变量也不会自动修改健康检查参数,启动较慢时应分别检查这两组设置。</p><h3 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--健康检查端点>健康检查端点</h3><p>所有四个 Docker 镜像现已内置 <cod [...]
-<code>false</code>,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见<a href=/cn/docs/config/config-guide/>服务端配置说明</a>。</p></li><li><p>服务启动成功后,使用<code>curl</code>查询所有顶点时返回乱码</p><p>服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 <code>gunzip</code> 进行解压(<code>curl http://example | gunzip</code>),也可以用<code>Firefox</code>的<code>postman</code>或者<code>Chrome</code>浏览器的<code>restlet</code>插件发请求,会自动解压缩响应数据。</p></li><li><p>使用顶点Id通过<code>RESTful API</code>查询顶点时返回空,但是顶点确实是存在的</p><p>检查顶点Id的类型,如果是字符串类型,<code> [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>--------| ----
-</span></span><span class=line><span class=ln> 3</span><span class=cl>+       | %2B
-</span></span><span class=line><span class=ln> 4</span><span class=cl>空格     | %20
-</span></span><span class=line><span class=ln> 5</span><span class=cl>/       | %2F
-</span></span><span class=line><span class=ln> 6</span><span class=cl>?       | %3F
-</span></span><span class=line><span class=ln> 7</span><span class=cl>%       | %25
-</span></span><span class=line><span class=ln> 8</span><span class=cl>#       | %23
-</span></span><span class=line><span class=ln> 9</span><span class=cl>&amp;       | %26
-</span></span><span class=line><span class=ln>10</span><span class=cl>=       | %3D</span></span></code></pre></div></div></div></li><li><p>查询某一类别的顶点或边(<code>query by label</code>)时提示超时</p><p>由于属于某一label的数据量可能比较多,请加上limit限制。</p></li><li><p>通过<code>RESTful API</code>操作图是可以的,但是发送<code>Gremlin</code>语句就报错:<code>Request Failed(500)</code></p><p>可能是<code>GremlinServer</code>的配置有误,检查<code>gremlin-server.yaml</code>的<code>host</code>、<code>port</code>是否与<code>rest-server.properties</code>的<code [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  docker compose -f docker-compose.yml up -d --wait</span></span></code></pre></div></div></div><p>该设置与 Docker 健康检查的 <code>start_period</code>、<code>interval</code>、<code>timeout</code> 和 <code>retries</code> 相互独立。健康检查参数决定何时将容器标记为 <code>unhealthy</code>;仅增加健康检查的等待时间,不会延长 Server 启动脚本的等待期限。调整此变量也不会自动修改健康检查参数,启动较慢时应分别检查这两组设置。</p><h3 id=pg-e0d85ec18e6b33c4b55ae5d9a2ea88e3--健康检查端点>健康检查端点</h3><p>所有四个 Docker 镜像现已内置 <cod [...]
+部署步骤见 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速开始</a>。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--core-dump>启动时出现 core dumped 怎么查</h3><p>先执行 <code>java -version</code> 确认 JDK 版本:<strong>HugeGraph master 分支(以 1.8 为基线)要求 Java 17</strong>,<strong>1.7.0 要求 Java 11</strong>(已不再支持 Java 8)。
+若 JDK 版本正确,进一步查看 Server 日志及 JVM 崩溃日志(<code>hs_err_pid*.log</code>),排查是否由于系统架构不匹配、依赖的动态库(如 RocksDB JNI)缺失或系统内存不足引起。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--initialize-backend>哪些后端需要 init-store</h3><p>使用 RocksDB 或 HBase 等本地持久化后端时,<strong>首次启动前必须执行 <code>bin/init-store.sh</code></strong> 进行初始化。Memory(内存后端)和 HStore(分布式后端)无需执行此脚本,HStore 的存储由 PD 和 Store 统一管理。</p><p>注意:<code>backend</code> 与 <code>serializer</code> 必须配套使用(例如 RocksDB 配套 <code>binary</code>),不可随意替换。若服务启动后提示无法连接后端,请优先检查是否完成 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>.../libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found</span></span></code></pre></div></div></div><p>解决方法:核对发行包支持的系统架构,升级系统的 <code>libstdc++</code>(或安装较新的 GCC 运行库),或者直接使用官方提供的 Docker 镜像运行。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--start-script>应该使用哪个 Server 启动脚本</h3><p>当前发行包统一使用 <code>bin/start-hugegraph.sh</code>,GremlinServer 与 REST Server 会在同一个进程中启动。旧版本文档中的 <code>start-restserver.sh</code> 和 <code>start-gre [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  <span class=s1>&#39;http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10&#39;</span></span></span></code></pre></div></div></div><p>若开启了认证,需同时传入凭据。若返回内容仍不符合预期,请检查 HTTP 状态码、<code>Content-Type</code> 与 <code>Content-Encoding</code>,不要把 JSON 报错直接管道传给 <code>gunzip</code>。</p><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--vertex-id>按顶点 ID 查询却找不到顶点</h3><p>先从已有查询结果中确认 <code>id</code> 的实际格式和类 [...]
+若已手动清理底层,必须<strong>重启 Server</strong>。日常清理建议使用官方提供的 <a href=/cn/docs/clients/restful-api/graphs/#clear-graph>Clear 图 API</a>。</p><h2 id=pg-3465b699399f48689cdc6b5e59a10d69--modeling>建模与 ID</h2><h3 id=pg-3465b699399f48689cdc6b5e59a10d69--id-length>顶点或边 ID 超过长度限制</h3><p>为保证底层存储与索引性能,HugeGraph 对 ID 长度作了如下限制(按编码后的字节数计算):</p><ul><li><strong>顶点 ID</strong>:最长 16384 字节(16 KB);</li><li><strong>边 ID</strong>:最长 65536 字节(64 KB)。</li></ul><p>建议使用简洁的业务唯一标识作为主键,避免在 ID 中拼接大段文本。注:属性索引值超过 32 字节时会自动转为哈希存 [...]
+例如“投资”关系可以同时连接“个人 → 企业”和“企业 → 企业”。旧版 <code>sourceLabel()</code> 与 <code>targetLabel()</code> 只支持单一配对,现已废弃。</p><p>其他问题可搜索 <a href=https://github.com/apache/hugegraph/issues>Server issues</a> 或 <a href=https://github.com/apache/hugegraph-toolchain/issues>Toolchain issues</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d54c862d45861ca39a945d90325e3909>6.8 - 报告安全问题</h1><template data-hg-authored-content=start></te [...]
 先根据集成方式找出受影响代码,再重新构建应用,并在部署前检查已有数据。</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--先确定需要调整的部分>先确定需要调整的部分</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>你的集成方式</th><th scope=col>需要准备什么</th></tr></thead><tbody><tr><td>Java 代码使用 Server 的 ID、schema 元数据、查询或索引</td><td>调整 import 和受影响签名,使用配套的 1.8.0 依赖包重新编译。</td></tr><tr><td>自定义序列化器、<code>HugeGraph</code> 实现或元素子类</td><td>按下方说明修改 SPI 契约和共享元素状态的适配。</td></tr><tr><td [...]
 升级时请使用配套的 Server、PD、Store 发行包及下游依赖。
 Java 映射和兼容性样本见<a href=https://github.com/apache/hugegraph/blob/master/docs/shared-foundation-migration.md>源码迁移指南</a>。</p><h2 id=pg-782cb144ccc6293291807ac82f56f508--共享代码现在由谁维护>共享代码现在由谁维护</h2><p>此前 Server core 和 struct 分别维护了部分 ID、schema 类型、查询、元素和编解码实现。
diff --git a/cn/_print/docs/quickstart/client/index.html b/cn/_print/docs/quickstart/client/index.html
index db4a42d95..ec69ec96c 100644
--- a/cn/_print/docs/quickstart/client/index.html
+++ b/cn/_print/docs/quickstart/client/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-theme=dark]{background [...]
-<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/quickstart/client/>返回本页常规视图</a>.</p></div><h1 class=title>HugeGraph Client</h1><ul><li>1: <a href=#pg-ffe87f885ed695dba5fb26ef5ea12983>HugeGraph-Java-Client</a></li><li>2: <a href=#pg-0f122bc9c526a968d392f6806ad6ddce>HugeGraph Python 客户端快速上手</a></li><li>3: <a href=#pg-c0ed8628ca3e43165a14118d58e2b4b2>HugeGraph Go 客户端快速入门</a></li></ul><div class=content><template data-h [...]
+<button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/quickstart/client/>返回本页常规视图</a>.</p></div><h1 class=title>HugeGraph Client</h1><ul><li>1: <a href=#pg-ffe87f885ed695dba5fb26ef5ea12983>HugeGraph-Java-Client</a></li><li>2: <a href=#pg-0f122bc9c526a968d392f6806ad6ddce>HugeGraph Python 客户端快速上手</a></li><li>3: <a href=#pg-c0ed8628ca3e43165a14118d58e2b4b2>HugeGraph Go 客户端快速入门</a></li></ul><div class=content><template data-h [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>&lt;dependencies&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
@@ -7,10 +7,14 @@
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=c>&lt;!-- 以下完整示例可使用已发布的 1.7.0 --&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>以下完整示例使用的 Schema、Graph、Gremlin 和资源关闭接口在已发布的 Client <code>1.7.0</code> 中可用,也与 Toolchain <code>master</code> 兼容。
-上面的依赖可直接用于示例工程。</p><p>如果需要<a href=/cn/docs/clients/hugegraph-client/>API 参考</a>中的 master 新接口(例如能力探测),请使用 Toolchain <code>master</code> 的 Client <code>1.8.0</code>,
-将 POM 中的版本改为 <code>1.8.0</code>。该版本未发布到 Maven 仓库时,先在 Toolchain 源码根目录运行以下命令,
-将 Client 及其父 POM 安装到本地 Maven 仓库。源码构建仍需从配置的 Maven 仓库获取依赖。</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -DskipTests -Dmav [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>先根据用途选择客户端版本。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>用途</th><th scope=col>客户端版本</th><th scope=col>Java 编译目标</th></tr></thead><tbody><tr><td>运行下方完整示例</td><td>已发布的 <code>1.7.0</code>,使用上面的依赖即可</td><td>发布版 POM 为 Java 8;本文统一使用 JDK 17</td></tr>< [...]
+发布版的 Java 编译目标不代表所有传递依赖的运行环境要求。</p><p>若需要使用 master 分支未发布的新接口,可从源码编译安装 Client(需配合 Toolchain 源码,详见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools 源码构建指引</a>):</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lan [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>两条版本检查都应显示 JDK 17。使用 master 分支 Client 的项目运行 Maven 命令时,也需添加 <code>-Dmaven.repo.local="$candidate_dir/m2"</code>。
+Client 与 Server 的版本不必相同;升级前核对所需 API 及兼容范围。</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>选择单条操作或批量操作示例,将完整代码保存为 Maven 工程中的 <code>src/main/java/SingleExample.java</code> 或
+<code>src/main/java/BatchExample.java</code>。复制按钮会包含已折叠的代码行。</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-18ca6629-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--431-singleexample>4.3.1 SingleExample</h5><div  [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -158,7 +162,7 @@
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=139><div class=td-code__viewport id=td-code-18ca6629-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -296,7 +300,9 @@
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><p>运行 Example 之前需要启动 Server, 启动过程见<a href=/cn/docs/quickstart/hugegraph/hugegraph-server>HugeGraph-Server 快速上手</a></p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍< [...]
+</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><ol class=steps><li><a href=/cn/docs/quickstart/hugegraph/hugegraph-server>启动 HugeGraph Server</a>,在图空间 <code>DEFAULT</code> 中准备名为 <code>hugegraph</code> 的测试图。</li><li>将 Maven 工程的 JDK 设为 17,把所选示例中 <code>HugeClient.builder(...)</code> 和 <code>configUser [...]
+Server 未开启鉴权时,省略 <code>configUser(...)</code>。</li><li>在 IDE 中运行 <code>SingleExample.main()</code> 或 <code>BatchExample.main()</code>。两个示例都会创建 Schema 和图数据、打印结果并关闭客户端。
+请使用测试图,已有 Schema 或数据可能影响重复运行。</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍</a></p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>2 - HugeGraph Python 客户端快速上手</h1><template data-hg-authored-content=start></template><p><code>hugegraph-python-client</code> 是 HugeGraph 的 Pyt [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 也可以使用 pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>上述命令不固定版本号,默认安装最新发布版;发行信息见 <a href=https://pypi.org/project/hugegraph-python/>PyPI 发布页</a>。源码目录名是 <code>hugegraph-python-client</code>,发行包名为 <code>hugegraph-python</code>;需要主线代码时,请从 HugeGraph-AI workspace 安装。</p><p>如需使用仓库中的最新代码,请从 HugeGraph-AI 仓库根目录同步 workspace。<code>hugegraph-python-client</code> 是 workspace 成员,通过  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
diff --git a/cn/_print/docs/quickstart/hugegraph-ai/index.html b/cn/_print/docs/quickstart/hugegraph-ai/index.html
index 1a094848c..dc6ff1b7f 100644
--- a/cn/_print/docs/quickstart/hugegraph-ai/index.html
+++ b/cn/_print/docs/quickstart/hugegraph-ai/index.html
@@ -117,27 +117,81 @@ Apache License 2.0 · Ask DeepWiki
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+文档向量化需要 Embedding,图数据抽取和答案生成还需要 LLM。Reranker 可选,初次运行可用本地 <code>bleu</code>。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>想做什么</th><th scope=col>页面入口</th><th scope=col>需要准备什么</th></tr></thead><tbody><tr><td>从文档建立索引</td><td><code>1. Build RAG Index</code></td><td>文档、Embedding;抽取图数据还需 Schema 和 LLM</td></tr><tr><td>根据文档或图回答问题</td><td><code>2. (Graph)RAG & User Functions</code></td><td>对应索引和 LLM</td></tr><tr [...]
+已有文件会保留。模板包含完整的 6 列,只填写测试问题和预期答案,4 个模型回答列留空。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-49825bb1-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>uv run --extra llm python - <span class=s>&lt;&lt;&#39;PYTHON&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-配置面板>0. 配置面板</h2><p>标签页上方是可折叠的配置面板,共五个部分,包括 <code>1. Set up the HugeGraph server.</code>、<code>2. Set up the LLM.</code>、<code>3. Set up the Embedding.</code>、<code>4. Set up the Reranker.</code> 和 <code>5. Set up the vector engine.</code>。每部分都有独立的应用按钮,应用后会把受支持的字段写回 <code>.env</code>。 [...]
+截图使用本地 Ollama 的 <code>qwen2.5:3b</code> 和 <code>mxbai-embed-large</code>,向量引擎为 <code>Faiss</code>。
+更换 Embedding 模型后需重建索引,避免新旧向量维数或含义不同。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-构建-rag-索引>1. 构建 RAG 索引</h2><p>第一个标签页负责两类索引。</p><ul><li>将文档切分后写入 chunk 向量索引。</li><li>按 Schema 从文档抽取顶点和边,写入 HugeGraph,并维护顶点向量索引。</li></ul><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[输入文档] --&gt; B[文本切分]
     B --&gt; C[生成 chunk 向量]
     C --&gt; D[写入向量索引]
     B --&gt; E[LLM 按 Schema 抽取顶点和边]
     E --&gt; F[写入 HugeGraph]
-    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>页面包含文档、Schema、抽取提示词和结果区域。常用操作有:</p><ol><li><code>Import into Vector</code>:切分文档并建立 chunk 向量索引。</li><li><code>Extract Graph Data (1)</code>:按 Schema 抽取图数据。</li><li><code>Load into GraphDB (2)</code>:把抽取结果写入 HugeGraph,并自动更新顶点向量。</li><li><code>Update Vid Embedding</code>:重新生成顶点向量,通常只在图中已有数据时才需要单独执行。</li></ol><p>这些按钮旁的 <code>Gr [...]
+    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>首次尝试可以使用下面的短文,填入 <code>Input Doc(s)</code>。请先选择专用测试图,避免将示例写入业务图。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-2 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-2-viewport data-td-code-viewport><div class=highlight><pre [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>页面包含文档、Schema、抽取提示词和结果区域。按下面的顺序建立图索引。只用向量检索时,完成第 1 步即可。</p><ol class=steps><li>点击 <code>Import into Vector</code>,切分文档并建立 chunk 向量索引。</li><li>在 <code>Graph Schema</code> 填入 Schema JSON 或已有图名,再点击 <code>Extract Graph Data (1)</code>。检查 <code>Output Info</code> 中的顶点、边和属性。</li><li>确认抽取结果后点击 <code>Load into GraphDB (2)</code>,写入 HugeGraph 并更新顶点向量。</li><li [...]
+图里已经有数据时,可以单独点击 <code>Update Vid Embedding</code> 更新顶点索引。</p><p>这些按钮旁的 <code>Graph Extraction Split Type</code> 下拉框可选 <code>document</code>、<code>paragraph</code> 或 <code>sentence</code>。<code>document</code> 把输入整体作为一个单元,另外两种会在抽取前先切分长文档。</p><p>页面还可以查看或清除 chunk 索引、顶点索引和图数据。清除操作会删除已有数据,执行前先确认当前图和索引是否仍被其他查询使用。</p><p>主控件下方还有两个折叠的辅助工具。</p><ul><li><code>Graph Schema Generator</code> 根据查询示例和少样本示例生成 Schema,填入 Graph Schema 字段。</li><li><code>Graph Extraction Prompt Generator</code> 根据期望场景(例如社交关系、金 [...]
+关键词输出需使用代码块中的英文前缀和冒号,姓名的大小写应与图数据一致。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>只根据检索到的上下文,用中文简洁回答问题,保留原文中的姓名。上下文不足时说明缺少信息。
+</span></span><span class=line><span class=ln>2</span><span class=cl>上下文: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>只返回一行,严格使用英文冒号,格式为 KEYWORDS:姓名:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {question}</span></span></code></pre></div></div></div><ol class=steps><li>输入 <code>Who is Sarah?</code>,将 <code>Graph-only Answer</code> 设为 <code>False</code>,<code>Graph-Vector Answer</code> 设为 <code>True</code>。</li><li>初次验证时保留 <code>Template Num=-1</code> 和 <code>Rerank method=bleu</code>,点击 <code>Answer Question</code>。</li><li>查看 <code>Graph-Vector Answer</code>,将答案中的职业、年龄等事实与原文和图数据核对。</li></ol><ul class="td-g [...]
     Q[问题] --&gt; V[查询 chunk 向量索引]
     Q --&gt; K[抽取关键词]
     K --&gt; M[匹配图顶点]
-    M --&gt; T[生成并执行 Gremlin]
-    T --&gt;|失败| B[BFS 图遍历回退]
+    M --&gt; D{启用 Text2Gremlin}
+    D --&gt;|是| T[生成并执行 Gremlin]
+    D --&gt;|否| B[BFS 图遍历]
+    T --&gt;|失败| B
     T --&gt; R[整理图结果]
     B --&gt; R
     V --&gt; S[合并与重排序]
     R --&gt; S
-    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式:</p><ul><li>小于 0:完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0:不带任何示例生成 Gremlin(zero-shot)。</li><li>大于 0:从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 [...]
+    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式。</p><ul><li>小于 0 时,完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0 时,不检索参考示例,使用基础生成结果。</li><li>大于 0 时,从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 <cod [...]
+未上传文件时使用内置的 <code>resources/demo/text2gremlin.csv</code>。示例中的标签和属性应与当前图一致。</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>若上传 CSV 构建示例向量索引后未自动召回示例模板,可直接在下面的 Prompt 模板中手动提供 Few-shot 参考示例。</p></div></div><p>复现 Sarah 查询时,使用以下输入。</p><ol class=steps><li>将下面的 CSV 保存为 <code>sarah-gremlin.csv</code>,上传后点击 <code>Build [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>按人物姓名查询时,使用 g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;问题中的姓名&gt;&#39;).valueMap()。
+</span></span><span class=line><span class=ln> 3</span><span class=cl>保留姓名的大小写,按姓名查询,不使用顶点 ID。
+</span></span><span class=line><span class=ln> 4</span><span class=cl>问题示例: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Gremlin 示例: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>图 Schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>其他示例: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>已知顶点: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>问题: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>只返回一个 ```gremlin``` 代码块。</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/cn/text2gremlin.jpg alt="Text2Gremlin 生成的查询与执行结果" loading=lazy decoding=async></li></ul><p>小模型可能生成错误 ID、大小写不符的姓名或不满足索引条件的过滤语句。应查看执行结果中的具体数据,再判断查询是否成功。
+Web 页面会直接执行生成的语句,请使用专用测试图。需要只生成语句时,在 <a href=/cn/docs/quickstart/hugegraph-ai/rest-api/>REST API</a> 中选择相应输出类型。</p><p>自定义提示词必须保留 <code>{query}</code>、<code>{schema}</code>、<code>{example}</code> 和 <code>{vertices}</code>。缺少任一占位符时,REST API 会拒绝请求。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-图工具与管理工具>4. 图工具与管理工具</h2><p><code>Graph Tools</code> 标签页可直接对当前图执行 Gremlin 查询、手动触发图备份,并通过 beta 操作初始化 HugeGraph 演示数据。后台还有两个任务,每天凌晨 1 点自动备份图数据,以及在进程运行期间持续更新顶点 id 向量。
+初始化演示数据会先清空当前图,只能在专用测试图上使用。</p><p><code>Admin Tools</code> 需要密码。输入已配置的 <code>ADMIN_TOKEN</code> 后可查看 <code>logs/llm-server.log</code> 的末尾内容(每 60 秒自动刷新),并可手动刷新或清空该文件。<code>ADMIN_TOKEN</code> 为空或仍是占位值 <code>xxxx</code> 时,访问会被拒绝。</p><p>设置 <code>ENABLE_LOGIN=True</code> 后,Web 页面会要求基础认证,用户名固定为 <code>rag</code>,密码是 <code>USER_TOKEN</code>;REST API 则要求把 <code>USER_TOKEN</code> 作为 Bearer token。日志接口还要求单独配置安全的 <code>ADMIN_TOKEN</code>。</p><div class="td-callout td-callout--warning" role=note><div  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>EN</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 中文提示词</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不是 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quickst [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不属于 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quicks [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> 默认开启,因此不带参数运行效果相同。配置模块首次导入时会为缺失的 <code>.env</code> 和提示词 YAML 按默认值创建文件;文件已存在时,生成器会交互询问是否覆盖。该命令会处理 HugeGraph、管理员、LLM、索引配置及提示词 YAML,不会在无确认的情况下覆盖已有文件。</p><p><code>.env</code> 包含密钥和密码,不要提交到版本库。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--基础选项>基础选项</h2><div class="td-table-scroll td-table-scroll--static" ta [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>Web 页面的 <code>5. Set up the vector engine.</code> 面板提供同样的选择,并会保存所选引擎的连接配置。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--登录与日志接口>登录与日志接口</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置项</th><th scope=col>默认值</th><th scope=col>说明</th></tr>< [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
diff --git a/cn/_print/docs/quickstart/hugegraph/index.html b/cn/_print/docs/quickstart/hugegraph/index.html
index 8a1fd5b31..3f94e475e 100644
--- a/cn/_print/docs/quickstart/hugegraph/index.html
+++ b/cn/_print/docs/quickstart/hugegraph/index.html
@@ -29,13 +29,14 @@ markmap:
 ## pd
 ## store</code></pre><h2 id=pg-b7c813bb4e5fdd09cff177617e07847d--2-依赖>2 依赖</h2><p><span id=21-安装-java-11-jdk-11></span></p><h3 id=pg-b7c813bb4e5fdd09cff177617e07847d--21-安装-java-17-jdk-17>2.1 安装 Java 17 (JDK 17)</h3><p>从 HugeGraph 1.8.0 开始使用 <strong>Java 17</strong>;<strong>1.7.0 是最后一个支持 Java 11 的版本</strong>。
 所有模块的源码构建要求 <strong>JDK 17 和 Maven 3.6.3 或更高版本</strong>,Server、PD 和 Store 的运行环境统一使用 <strong>JDK 17</strong>。
-Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
+Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema 结果为标准 Map</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob 值以二进制格式传输(包含在返回图元素内的 Blob)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼 [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼容)</div><d [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - 保留 Tree 的旧 key/value 数组结构</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 因安全原因已禁用(typed V2/V3 仅适用于受支持的简单标量与 ID)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() 返回包含各类 label 的 Map</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>完整客户端配置与验证细节见 <a href=https://github.com/apache/hugegraph/blob/master/docs/server [...]
@@ -263,7 +264,7 @@ chart 和这些环境变量不会自动创建图空间;同一个 Server Deploy
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>server</span><span class=p>:</span><span class=w>
diff --git a/cn/_print/docs/quickstart/index.html b/cn/_print/docs/quickstart/index.html
index 4d2639818..635bfda4c 100644
--- a/cn/_print/docs/quickstart/index.html
+++ b/cn/_print/docs/quickstart/index.html
@@ -21,13 +21,14 @@ markmap:
 ## pd
 ## store</code></pre><h2 id=pg-b7c813bb4e5fdd09cff177617e07847d--2-依赖>2 依赖</h2><p><span id=21-安装-java-11-jdk-11></span></p><h3 id=pg-b7c813bb4e5fdd09cff177617e07847d--21-安装-java-17-jdk-17>2.1 安装 Java 17 (JDK 17)</h3><p>从 HugeGraph 1.8.0 开始使用 <strong>Java 17</strong>;<strong>1.7.0 是最后一个支持 Java 11 的版本</strong>。
 所有模块的源码构建要求 <strong>JDK 17 和 Maven 3.6.3 或更高版本</strong>,Server、PD 和 Store 的运行环境统一使用 <strong>JDK 17</strong>。
-Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
+Server 安全检查(<code>-s true</code>)要求 Java 17 到 23 以及可读的 <code>conf/java-security.properties</code>;在 Java 24 或更高版本上,需以 <code>-s false</code> 启动 Server(JDK 24 通过 JEP 486 移除了 Security Manager)。</p><p><strong>在继续阅读前,请先执行 <code>java -version</code> 命令确认 JDK 版本。</strong></p><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__bo [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - Schema 结果为标准 Map</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Blob 值以二进制格式传输(包含在返回图元素内的 Blob)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.structure.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼 [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab="GraphSON (HTTP/兼容)" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>GraphSON (HTTP/兼容)</div><d [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># - 保留 Tree 的旧 key/value 数组结构</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=c># - Typed GraphSON V1 因安全原因已禁用(typed V2/V3 仅适用于受支持的简单标量与 ID)</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># - graph.schema() 返回包含各类 label 的 Map</span></span></span></code></pre></div></div></div></div><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>完整客户端配置与验证细节见 <a href=https://github.com/apache/hugegraph/blob/master/docs/server [...]
@@ -255,7 +256,7 @@ chart 和这些环境变量不会自动创建图空间;同一个 Server Deploy
 </span></span></span><span class=line><span class=ln> 8</span><span class=cl>  -e <span class=nv>HG_PD_AUTH_SECRET_KEY</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$HG_PD_AUTH_SECRET_KEY</span><span class=s2>&#34;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln> 9</span><span class=cl>  -v /path/to/data:/hugegraph-pd/pd_data <span class=se>\
 </span></span></span><span class=line><span class=ln>10</span><span class=cl>  --name hugegraph-pd <span class=se>\
-</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
+</span></span></span><span class=line><span class=ln>11</span><span class=cl>  hugegraph/pd:local</span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>变量</th><th scope=col>必填</th><th scope=col>默认值</th><th scope=col>对应配置项</th><th scope=col>描述</th></tr></thead><tbody><tr><td><code>HG_PD_GRPC_HOST</code></td><td>是</td><td>无</td><td><code>grpc.host</code [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>  </span><span class=nt>host</span><span class=p>:</span><span class=w> </span><span class=m>127.0.0.1</span><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=w>  </span><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8686</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -671,62 +672,61 @@ HTTP 可以直接使用,TLS 终止可选。Hubble 仍是单副本,当前登
 chart 正常情况下自动注入共享 PD REST 凭据,自定义容器或 manifest 必须向 PD 和客户端提供同一值。
 GitOps 先创建外部 Secret 再调谐工作负载,普通 Helm 保留自动创建的 release Secret。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-a4bced169085a0c224fa69566df656b0>2 - HugeGraph ToolChain</h1><template data-hg-authored-content=start></template><blockquote><p><strong>测试指南</strong>:如需在本地运行工具链测试,请参考 <a href=/cn/docs/guides/toolchain-local-test>HugeGraph 工具链本地测试指南</a></p></blockquote><p>HugeGraph Toolchain 包含 Java/Go 客户端、Loader、Hubble、Tools、 [...]
 并在图、表格和 JSON 视图之间自由切换。本文以 <strong>单机 RocksDB Server + Hubble</strong> 为例走通完整操作,无需预先部署 PD 或 Store。</p><p>如需搭配 HStore 分布式集群使用,可先了解本文的基础操作,再参考 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>HStore 分布式补充</a>。
-文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前版本均为 <code>1.8.0</code>)为准;Docker <code>latest</code> 为动态标签,实际部署建议使用固定版本。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
-<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动单机组合</h2><p>直接使用主仓库提供的 <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a> 即可,
+文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前均以 1.8 为基线,尚未正式发布)为准;Docker <code>latest</code> 为动态标签,生产环境建议使用已发布的固定版本。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
+<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><p>可按需快速跳转到对应操作;首次使用建议从启动单机环境开始:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动并加载示例</a></p><p>启动两个服务,加载人物与软件示例图。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>查询与可视化</a></p><p>运行 Gremlin,再查看图、表格或 JSON 结果。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>导入自己的数据</a></p><p>准备 CSV,配置数据源、字段映射并验证导入结果。</p></li></ul><h2 id=p [...]
 无需自行编写 Compose 配置文件。该文件已内置编排了 RocksDB Server 与 Hubble,并配置好网络、健康检查及持久化数据卷;
-完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --br [...]
+完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><ol class=steps><li><p><strong>准备官方 Compose 配置。</strong></p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span cla [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>若本地已有主仓库,直接进入其 <code>docker/</code> 目录即可。Compose 会自动挂载该目录下的
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 已预设 <code>pd.enabled=false</code> 与 <code>server.direct_url=http://server:8080</code>。两项服务处于同一 Docker 网络中通信,
 无需为每个图单独配置 Server 地址。请直接在 <code>docker/</code> 目录下启动,以确保相对配置路径有效。</p><p>Hubble 默认只在宿主机回环地址开放 <code>8088</code>(由 <code>HUBBLE_PUBLISH_HOST</code> 环境变量控制,默认为 <code>127.0.0.1</code>);
-Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-b [...]
+Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p></li><li><p><strong>启动并检查服务。</strong></p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabin [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>打开 Hubble。</strong></p><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
 Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在 <code>.env</code> 中配置管理员密码与 JWT 密钥,并使用 Server 账号登录(Hubble 无独立用户库)。
-个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</code> 卷分别持 [...]
-<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页:找到当前任务的入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
+个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p></li></ol><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</ [...]
+<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页与任务入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
 顶部的图选择器用于切换当前操作的目标图,所有查询、Schema 操作和异步任务均作用于当前选中的图。
-单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
+单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
 初次体验建议在空图上加载,避免与已有同名 Schema 冲突。后续章节均基于该示例图演示。</p><p>若需新建图,可在页面点击新建按钮,填写图名称、可选别名并选择 Schema 模板或示例数据。连接信息由 Hubble 后端统一配置,
-无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>Schema 建模:定义数据的形状</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
-在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中:<code>person</code> 以 <cod [...]
+无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>定义 Schema</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
+在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中,<code>person</code> 以 <cod [...]
 <code>software</code> 采用自定义数值 ID;边类型 <code>created</code> 连接人物与软件。模型定义与 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>Loader 示例</a> 保持一致。</p><p>自主建模时,建议遵循 <strong>属性 → 顶点类型 → 边类型 → 索引</strong> 的顺序依次创建。
-删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>GQL 工作台:查询与探索人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
-支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中执行人物属性查询:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><s [...]
+删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>在 GQL 工作台查询人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
+支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中查询人物属性。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><spa [...]
 布局、样式和筛选工具帮助突出重点,导出功能便于分享结果。【新增】用于创建元素,有权限时也可以编辑已有数据。
 调整布局、颜色或显示范围仅影响前端画布;通过界面新增、编辑元素或执行 Gremlin 写入语句才会真正修改 Server 中的图数据。</p><p>快捷键 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 可快速执行查询。普通即时执行适合小规模交互探索;大数据量或耗时查询建议提交为后台异步任务。
-Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__body><p>Text2GQL 后端能力(包括模型设置、内置/临时模型管理与 Prompt 模板)依赖包含
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> 的 Hubble 构建或后续发布版本;未合入该特性的旧版本仅提供预览占位,不包含模型设置页面。</p></div></div><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
+Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
 生成的语句支持二次编辑(执行前同样会进行只读安全校验)。切换至【异步】模式时,生成的查询与手写查询均可提交为后台异步任务。
-输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="Text2GQL 查询与图结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p class=td-gallery__description>模型设 [...]
-注意:Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
+输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="未配置模型时的自然语言入口与手写 Gremlin 查询结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台,模型尚未配置,结果来自手写查询</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p cla [...]
+Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
 本地回环或私网模型;在【模型设置】中修改 Base URL 时,必须重新填写 Key 或清空已保存的 Key。
-全局内置模型仅由 <code>admin</code> 账号(PD 模式下为超级管理员)统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
+全局内置模型由具备模型设置管理权限的管理员统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
 点击【应用】后需保存模型设置,模板将持久化存入 H2 数据库供内置模型与临时模型共享,生成时会自动附加当前图的 Schema。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>API Key 存储与隐私说明</span></div><div class=td-callout__body><p>备份 Hubble H2 数据库时,请一并备份主密钥文件(默认路径 <code>data/text2gql-master.key</code>),该文件丢失将导致无法解密已保存的 Key。
 生成查询时仅向模型接口发送用户问题、当前 Schema 及纠错提示,绝不会发送图数据查询结果。
-浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>内置图算法:用表单探索关系</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
+浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>使用内置图算法</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
 邻居探索用于回答“这个点附近有什么”,路径算法用于寻找两个点的连接,相似度和排序算法用于比较或筛选顶点。
 从一个已知顶点 ID 开始,先限定方向、边类型、深度与返回规模,再观察结果,会比直接运行大范围计算更容易理解。</p><p>算法表单提供参数说明及文档入口;常用参数可以在页面间往返时恢复。
 运行结果按算法显示为图或相应的结果面板;需要理解具体定义和参数时,使用算法标题旁的说明与文档链接。
 表单聚焦时也可用 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 运行当前算法。</p><p>OLAP 批量算法需要 Computer 或 Vermeer 等外部计算环境。本例的两个容器用于在线图操作,不包含这些计算服务。</p><p>例如选择 K-neighbor(GET),设置 <code>source=1:marko</code>、<code>max_depth=1</code>、<code>limit=20</code>,
-参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>异步任务:确认后台操作的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
+参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>查看异步任务的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
 可以按任务类型和状态筛选,查看任务 ID、创建时间与执行状态;成功查询可打开结果,失败任务可展开错误信息。
 已结束的任务可按界面提供的操作删除记录,任务列表与导入任务的执行历史是两个不同入口。</p><p>例如把 <code>g.V().count()</code> 以异步方式提交后,先在列表确认成功,再查看返回的数量。
-“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>数据源管理:把原始数据准备好</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
-不同来源需要对应的路径、连接或订阅配置。FILE 最适合先体验:上传文件后,配置格式、分隔符、编码和表头,
-检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
+“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>准备数据源</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
+不同来源需要对应的路径、连接或订阅配置。首次体验可选择 FILE。上传文件后,配置格式、分隔符、编码和表头,
+检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>docs_alice</span><span class=p>,</span><span class=s>28</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs_bob</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><p>创建 FILE 数据源并上传它,选择 CSV(逗号分隔、默认 UTF-8),列名为 <code>name,age,city</code>。
-表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>数据导入:从字段映射到可查询的图</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
-沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务:</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
+表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>映射字段并导入数据</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
+沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务。</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
 AUTOMATIC 由 Server 生成 ID,PRIMARY_KEY 根据映射的主键属性生成 ID。边映射还需指定起点、终点字段并匹配对应顶点的 ID 规则。</p><p>任务列表用于管理配置和执行入口,详情中的执行历史用于查看每次实例的状态、导入量与错误。
 Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源类型匹配。
-完成后返回 GQL 工作台验证:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</sp [...]
+完成后返回 GQL 工作台查询新导入的数据。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>( [...]
 失败时先检查源字段、数值类型、可空属性及目标 Schema。Hubble 导入适合小规模体验,
 大批量正式导入请使用 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>HugeGraph Loader</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--个人中心与账号权限>个人中心与账号权限</h2><p>Hubble 使用 Server 的认证和账号,没有独立用户库。匿名访问时不显示【个人中心】与【账号管理】;
 开启认证后,个人中心展示当前账号资料与权限信息,可修改自己的密码。昵称等资料编辑依赖 Server 对个人资料接口的支持。
@@ -734,25 +734,20 @@ Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源
 通过 Hubble 新建的普通单机账号会获得覆盖所有图的读、写、删除和执行权限,不能把它当作只读账号或单图隔离账号。
 需要更细的资源权限时,应按 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>配置,而不是依赖空间预设。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--pd-模式的空间权限>PD 模式的空间权限</h3><p>连接支持默认角色接口的 Server 后,账号与空间访问可以分别管理。管理员管理全局账号,
 空间管理员只管理已授权空间的成员;普通成员不会获得账号管理或运维入口。
-以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
+以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
 把已有自定义权限替换为预设前,先核对需要保留的授权,避免把复杂权限误认为单一预设。
 权限变更后刷新权限上下文或重新登录,确认菜单和目标空间已更新;最终请求仍由 Server 校验。
 旧 Server 未提供相应接口时,页面按能力隐藏或禁用操作,不应只凭按钮是否可见推断资源权限。
-更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt="认证模式下的账号列表(PD 模式示例)" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>系统运维:检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
+更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt=认证模式下的账号列表(单机模式示例) width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
 节点列表可搜索、筛选健康状态并进入详情;详情用于查看可用的版本、系统、JVM、Server 后端等指标。
 指标缺失或标记过期时,应结合采集状态与最近成功时间判断,不能把空值当作零或健康。</p><p>匿名模式可以查看运维信息;开启认证后,运维入口仅对有运维权限的管理员显示。
 此处用于观测和排查,不是启动、停止或扩缩容控制台。PD 模式的集群概览与节点层级见分布式补充。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--快捷键与画布操作>快捷键与画布操作</h2><p>顶部的快捷键帮助入口随时可查看按键说明。以下快捷键有不同的作用范围,输入框中不会触发全局 <code>?</code> 帮助。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>操作</th><th scope=col>按键或动作</th><th scope=col>生效位置</th></tr></thead><tbody><tr><td>打开 / 关闭快捷键说明</td><td><span class=td-kbd-sequence><kbd>?</kbd></span></td><td>输入框和编辑器之外</td></tr [...]
 不是所有查询的硬上限;<code>gremlin.vertex_degree_limit</code>(<code>100</code>)与 <code>gremlin.edges_total_limit</code>(<code>500</code>)限制展开规模。
-FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>不再需要示例时,在主仓库的 <code>docker/</code> 目录执行:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>需要与 master 精确一致的产物时,使用 JDK 17 和 Maven 从 Toolchain 构建。
-Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不执行测试:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branch https://github.com/apache/ [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 编辑 conf/hugegraph-hubble.properties,设置正确的 Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>打包配置默认绑定本机 <code>localhost:8088</code>。<code>bin/stop-hubble.sh</code> 会先请求正常停机,超时后才强制终止。
+FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>清理测试环境时,在 <code>docker/</code> 目录下执行以下命令:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
+若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>从当前 master 构建时,需要 <strong>JDK 17、Maven 3.9+、Python 3.9+、稳定版 Node.js 24(至少 24.22.0)</strong>,
+并通过 Corepack 使用仓库锁定的 <strong>pnpm 12.14.0</strong>。Maven 不再自动安装 Node/Yarn。</p><ol class=steps><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 构建说明</a>
+编译并安装 Server SDK 到独立 Maven 仓库。</p></li><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble 源码构建步骤</a>
+安装 Python 依赖,再使用同一 Maven 仓库构建 Client、Loader 和 Hubble(跳过测试)。</p></li><li><p>进入构建生成的 <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> 目录,配置 <code>conf/hugegraph-hubble.properties</code> 中的 Server 连接信息后启动:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
 需要开发与测试说明时,参考 <a href=/cn/docs/guides/toolchain-local-test/>Toolchain 本地测试指南</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-91cea9e83b921f10aa1de60b138055b0>2.2 - 图可视化</h1><template data-hg-authored-content=start></template><p>Hubble 为 HugeGraph 提供图数据、Schema、查询和导入的 Web 界面。先从不依赖 PD 的单机组合入手,
 再按需要了解分布式集群的差异。</p><ul class=cards><li><a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机 RocksDB</a>:启动、示例图、建模、导入与查询。</li><li><a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>Hubble 与 HStore 分布式集群</a>:PD 发现、图空间与集群运维。</li></ul><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-33fca9af1c30d5ed43daaa61aa0928ea>2.2.1 - 使用 Hubble 管理 HStore 分布式集群</h1><div class=lead>连接 HStore 与 P [...]
 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机指南</a>。
@@ -761,51 +756,108 @@ Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不
 配置 <code>.env</code> 并生成 Hubble 本地配置文件,然后在 <code>docker/</code> 目录下启动,无需自行维护部署文件。
 下文重点说明连接与运维配置要点,部署前请确保满足 README 中的 PD 凭据与前置依赖要求。
 Docker <code>latest</code> 为动态标签,配图用于定位界面,实际版本以部署镜像的 digest 及构建信息为准。
-不同版本可提供的指标和权限接口有所区别。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
-同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang [...]
+不同版本可提供的指标和权限接口有所区别。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
+同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|图 API| S[Server]
+    S --&gt;|读写图数据| T[Store]
+    H -.-&gt;|服务发现与集群信息| P[PD]
+    H -.-&gt;|节点指标| T</code></pre><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>脚本会读取 <code>.env</code> 中的 <code>HG_PD_AUTH_SECRET_KEY</code>,将其值作为 <code>operations.pd.password</code> 写入生成文件 <code>docker/conf/hubble/hstore.local.properties</code>。
 若需调整连接地址或运维参数,直接编辑该文件即可(请勿覆盖 Git 跟踪的 <code>.example</code> 模板文件),并确保 <code>operations.pd.password</code>
 与 PD 所用密钥一致。Compose 会将该文件只读挂载到容器内部,无需进入容器修改。
-该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
+该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
 <a href=/cn/docs/quickstart/hugegraph/hugegraph-hstore/>HStore 部署指南</a>;源码或二进制包启动的 Hubble 则编辑其
-<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址:</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
+<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
 发行包默认配置中显式设为 <code>pd.enabled=false</code>;若未配置该项,代码默认值为 <code>true</code>,因此单机与分布式部署均建议显式声明该配置。
-修改配置后:源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
-(沿用启动时的项目名及所有 <code>-f</code> 参数):</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
+修改配置后,源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
+(沿用启动时的项目名及所有 <code>-f</code> 参数)。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
 让各团队只看到并操作自己的图。进入图空间后,图的建模、导入和查询仍沿用基础指南的流程。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--创建与调整图空间>创建与调整图空间</h3><p>开启 Server 认证时,创建、编辑和删除图空间要求超级管理员权限。创建时先填写全局唯一的 GraphSpace 名称、
 可选的显示别名及最大图数;例如用 <code>research</code> 作 API 标识,用“研究图谱”作显示名。GraphSpace 名称创建后不可修改,
 别名和描述可随后调整,别名不参与 URL 或权限匹配。图空间管理员从已有账号中选择。</p><p>“高级部署与资源限制”包含图查询/写入服务、异步计算任务的 CPU 与内存上限,以及存储容量限制。
 这些部署配额不会显示实时资源用量,也不会自动扩容现有容器。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>高级部署的默认值</span></div><div class=td-callout__body><p>默认最大图数为 100;图服务与计算任务分别为 64 核、128 GB,存储上限为 1000000 GB。
 普通容器试用可保留默认值。Kubernetes 命名空间、Operator 和算法镜像仅在对应场景中填写。</p></div></div><p>选择图空间后,再进入其中的图。切换空间时应重新确认当前图,尤其是不同空间中存在同名图时。
-列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
+列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
 当一组业务图需要同样的顶点类型、边类型和索引时,可以先保存模板,再在创建图时选择它,减少重复建模。
-例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>用户模板与主篇的内置示例模板不同:内置模板用于快速体验预设模型,用户模板用于保存自己的模型并长期复用。
+例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>主篇的内置示例模板用于快速体验预设模型。用户模板用于保存自己的模型并长期复用。
 模板本身不等于导入数据;是否加载示例数据是创建图时的另一个选择。
 开启 Server 认证时,创建用户模板需要所在空间的写权限,更新或删除还要求模板所有者或相应管理权限。
 匿名模式不进行按用户的权限与模板所有者检查。
 单机模式不提供用户模板管理。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--给用户分配图空间权限>给用户分配图空间权限</h2><p>账号创建、登录和个人资料管理见<a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>基础指南</a>;
 分布式模式额外提供“管理 GraphSpace 成员”,在已有账号与指定空间之间分配权限。
-支持权限预设的 Server 提供以下常用选择:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
+支持权限预设的 Server 提供以下常用选择。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
 账号与空间成员分开管理,移除成员不会删除全局账号。创建账号后可以立即继续分配空间权限;调整已有成员时,确认当前空间及预设,保留其他空间仍需要的权限。
 仅启用 <code>pd.enabled</code> 不会授予权限,旧 Server 的自定义角色也不能直接当作这些预设处理。
-认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
+认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
 概览中的 PD Leader、在线 Store 数、图数、分区数、副本数和数据量,帮助判断当前连接的规模及哪些节点需要关注。
-分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点:<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
+分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点。<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
 <code>DOWN</code> 表示相应探测未成功。拓扑可用而指标部分缺失时,仍可能正常查询图。
-页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
+页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
 Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性检查;各版本可用的指标不同。</p><p>开启 Server 认证时,集群运维读取要求超级管理员(<code>ADMIN</code> 级别),空间管理员和普通成员不会因此获得集群读取权限。
 部署时使用容器隔离、可信 HTTPS 入口、Server 认证与网络白名单,避免直接公开 Hubble 和组件端口。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--配置运维访问>配置运维访问</h3><p>PD/Store 的运维凭据由 Hubble <strong>后端</strong>使用,与浏览器登录 Server 的账号分开。
 Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.local.properties</code>;其他部署修改 Hubble 包内配置文件。
-其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
-且需与 PD 返回的 Store 指标目标完全一致。注意:仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次排查:Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
-以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>2.3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code>(当前版本为 <code>1.8.0</code>)为准。发布版和 Docker <code>latest</code> 可能与源码不同;使用时请核对版本,未发布的版本请按下文从源码构建。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loade [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。
-旧版 Server 保持下文说明的原有导入行为。</p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>2 获取 HugeGraph-Loader</h3><p>可以通过以下三种方式获取 HugeGraph-Loader:</p><ul><li>使用 Docker 镜像 (便于<strong>测试</strong>)</li><li>下载已编译的压缩包</li><li>克隆源码编译安装</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--21-使用-docker-镜像-便于测试>2.1 使用 Docker 镜像 (便于<strong>测试</strong>)</h4><p>我们可以使用 <code>docker run -itd --name loader hugegraph/loader:latest</code> 部署 loader 服务。对于需要加载的数据,则可以通过挂载 <code>-v /path/ [...]
+其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
+且需与 PD 返回的 Store 指标目标完全一致。仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次检查 Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
+以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>2.3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code> 分支(以 1.8 为基线,尚未正式发布)为准。发布版和 Docker <code>latest</code> 可能存在部分差异,使用未发布功能前请先核对版本。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--quick-local-file-import>快速上手:本地 [...]
+请先<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>安装 Loader</a> 并启动 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>。
+以下命令均在 Loader 安装目录下执行,连接本地默认图 <code>hugegraph</code>。若 Server 已启用鉴权,在命令中追加 <code>--username</code> 与 <code>--password</code>(或 <code>--token</code>)。</p><ol class=steps><li><p><strong>创建数据文件</strong></p><p>两份 CSV 均不含表头,列名由下一步的映射文件指定。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-955f155a-fence-0-viewport data-td-code-viewport><div class=highlight><p [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>创建 Schema 和映射文件</strong></p><p>本例使用独立的 <code>docs_*</code> 名称,避免与内置的 <code>person</code> 数据冲突。
+映射文件中的路径相对于运行 Loader 时的工作目录。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>执行导入</strong></p><p>保持在同一工作目录。Server 运行在其他地址时,修改主机和端口。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>首次成功导入后,统计应显示两个顶点、一条边。检查汇总中的成功数和失败数。</p></li><li><p><strong>在 Hubble 中查询结果</strong></p><p>将 Hubble 连接到同一个 Server 和图,在 Gremlin 工作台分别执行以下查询。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>第一条查询返回 Alice 的年龄 <code>29</code>、Bob 的年龄 <code>31</code>,第二条返回 <code>docs-smoke-bob</code>。</p></li></ol><p>导入其他数据源时,继续阅 [...]
+<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>内置完整示例</a>还包含软件顶点和边属性。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-概述>1 HugeGraph-Loader 概述</h3><p>HugeGraph-Loader 是 HugeGraph 的数据导入组件,能够将多种数据源的数据转化为图的顶点和边并批量导入到图数据库中。</p><p>目前支持的数据源包括:</p><ul><li>本地磁盘文件或目录,支持 TEXT、CSV 和 JSON 格式的文件,支持压缩文件</li><li>HDFS 文件或目录,支持压缩文件</li><li>主流关系型数据库,如 MySQL、PostgreSQL、Oracle、SQL Server</li><li>Kafka topic</li><li>已有的 HugeGraph 图,用于把数据从一个图复制到另一个图</li></ul><p>本地磁盘文件和 HDFS 文件支持断点续传。</ [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -820,9 +872,12 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>具体的数据导入流程可以参考 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</a></p><blockquote><p>注意:</p><ol><li><p>hugegraph-loader 的 docker 镜像是一个便捷版本,用于快速启动 loader,并不是<strong>官方发布物料包方式</strong>。你可以从 <a href=https://infra.apache.org/release-distribution.html#dockerh [...]
-发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>克隆 <code>master</code> 分支:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash>< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
-启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>使用 HugeGraph-Loader 的基本流程分为以下几步:</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>这一步是建模的过程,用户需要对自己已有的数据和想要创建的图模型有一个清晰的构想,然后编写 schema 建立图模型。</p><p>比如想创建一个拥有两类顶点及两类边的图,顶点是"人"和"软件",边是"人认识人"和"人创造软件",并且这些顶点和边都带有一些属性,比如顶点"人"有:&ldquo;姓名&rdquo;、&ldquo;年龄"等属性, &ldquo;软件"有:&ldquo;名 [...]
+发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>从 master 分支编译 Loader 需要 Java 17、Maven 3.6.3+ 与 Python 3.9+。直接克隆仓库并编译:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>如需搭配开发阶段的 Server master SDK 编译,可参阅 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
+启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>导入数据前先准备图模型、数据文件和映射文件,再运行 Loader。</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>先确定数据对应的顶点类型、边类型和属性,再编写 Schema。</p><p>以下示例包含 <code>person</code> 和 <code>software</code> 两类顶点,以及 <code>knows</code> 和 <code>created</code> 两类边。
+人有姓名、年龄和城市,软件有名称和价格,两类边都记录日期。</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt=由“认识”和“创建”边连接人物与软件顶点的示例图><p>示例图模型</p></div><p>将 Schema 定义保存到 <code>schema.groovy</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=16><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code  [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -837,19 +892,21 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// 创建 knows 边类型,这类边是从 person 指向 person 的
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// 创建 created 边类型,这类边是从 person 指向 software 的
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln> [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>如果在建模(schema)时指定 person 或 software 的 id 策略是 PRIMARY_KEY,选择以 name 作为 primary keys(注意:这是 hugegraph 中 vertexlabel 的概念),在导入边数据时,由于需要拼接出源顶点和目标顶点的 id,必须拿着 p_id/s_id 去 person/software 表中查到对应的 name,这种需要做额外查询的表结构的情况,loader 暂时是不支持的。这时可以采用以下两种方式替代:</p><ol><li>仍然指定 person 和 software 的 id 策略为 PRIMARY_KEY,但是以 person 表和 software 表的 id 列作为顶点的主键属性,这样导入边时直接使用 p_id 和 s [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-11-v [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+需要关联数据时,先在数据源侧准备好查询结果。</p><p>以下以 <code>person</code>、<code>software</code>、<code>created</code> 三张表为例。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>// person 表结构
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=l [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>若 <code>person</code> 和 <code>software</code> 使用 <code>PRIMARY_KEY</code> 策略,以 <code>name</code> 为主键,导入边时就需要两个端点的 <code>name</code>。
+<code>created</code> 表只有 <code>p_id</code> 和 <code>s_id</code>,Loader 不会用它们回查名称。可以改用以下两种 ID 设计。</p><ol><li>保留 <code>PRIMARY_KEY</code> 策略,将两张顶点表的 <code>id</code> 列作为主键属性。Loader 可用 <code>p_id</code>、<code>s_id</code> 和顶点标签生成端点 ID。</li><li>使用自定义 ID 策略,将两张顶点表的 <code>id</code> 列直接作为顶点 ID,导入边时直接使用 <code>p_id</code> 和 <code>s_id</code>。</li></ol><p>这两种设计都让边数据直接提供端点 ID,省去回查。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-准备顶点和边数据>3.2.2 准备顶点和边数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-14-v [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-languag [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-code data-td-code-auto-id data-td-languag [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -866,7 +923,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-c [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-18 data-td-c [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -1064,7 +1121,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-16 data-td-code data-td-code-auto-id data-td-lan [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-19 data-td-code data-td-code-auto-id data-td-lan [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1115,7 +1172,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -1144,8 +1201,8 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// 如果没有更新策略,则会得到
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 若参数文件包含凭据,使用 <code>chmod 0600 loader.args</code> 把权限限制为 <code>0600</code>;<code>@file</code> 调用让这些值不出现在进程参数中。
 Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 从只读 Kubernetes ConfigMap 挂载映射文件时,先把映射复制到可写卷中再运行 Loader。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-断点续导模式>3.4.2 断点续导模式</h5><p>通常情况下,Loader 任务都需要较长时间执行,如果因为某些原因导致导入中断进程退出,而下次希望能从中断的点继续导,这就是使用断点续导的场景。</p><p>设置 <code>--incremental-mode</code> 为 <code>true</code> 即可从进度文件续导。Loader 在导入成功或正常停止后关闭时写入进度;意外失败可能阻止该写入。
@@ -1156,43 +1213,8 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 失败文件中,用户对失败文件中的数据行修改后,设置 &ndash;failure-mode 为 true 即可把这些"失败文件"也当作输入源进行导入(不影响正常的文件的导入),
 当然如果修改后的数据行仍然有问题,则会被再次记录到失败文件中(不用担心会有重复行,关闭文件时会去重)。失败模式下上述三个错误上限会被解除,因此会扫描整个失败文件。</p><p>每个输入源(即映射文件 <code>structs</code> 中的每一项)都会有自己的失败文件,文件名为该输入源的 <code>id</code> 加后缀 <code>.error</code>,保存在 <code>${struct}/failure-data</code> 目录下。
 每一条失败记录写为两行:一行以 <code>#### READ ERROR:</code>、<code>#### PARSE ERROR:</code> 或 <code>#### INSERT ERROR:</code> 开头的提示行,紧接着是原始数据行。当输入源有 header 时,header 会以 JSON 形式写入同目录下的 <code>${id}.header</code> 文件,以便失败文件能按正确的列重新读取。
-比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p><code>people.csv</code> 没有表头行,列名由映射文件的 <code>header</code> 提供。映射文件中的本地路径相对于运行命令时的工作目录。仍在 Loader 安装目录中执行导入;如果 Server 在其他容器中,请把 <code>--host</code> 改为 Loader 能访问到的 Server 地址。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__vi [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>本例用独立的 <code>docs_smoke_person</code> 标签和 <code>docs_*</code> 属性,避免与预置的 <code>person</code> 样例数据冲突。成功时统计中应显示顶点写入成功数为 <code>2</code>、边写入成功数为 <code>0</code>。也可以在 Hubble 的 Gremlin 工作台查询 <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code>,结果应包含 <code>docs-smoke-alice</code> 和 <code>docs-smoke-bob</code> [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
+若部署的 Server 提供该接口并返回 <code>protocol: 1</code>,Loader 会自动启用所有权保护;已发布的 Server 1.7.0 及更早版本则继续使用原有模式切换流程。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;图模式 NONE&#34;] --&gt;|首个 Loader 申请所有权| B[&#34;进入 LOADING 模式 (分配 token)&#34;]
     B --&gt;|其他并发 Loader 加入| B
     B --&gt;|部分 Loader 导入完成释放| B
@@ -1205,18 +1227,18 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 权限、网络、图不存在或无效响应错误不会触发回退。</li><li><strong>恢复与图源导入</strong>:保留 <code>RESTORING</code> 模式,不探测 owner 且不自动重置。恢复导入完成后须手动将图模式设回 <code>NONE</code>,否则后续普通导入无法获取首个所有权。
 在活跃 owner 存在期间,请勿运行恢复导入、图源导入、Spark connector 或旧版 Loader 导入。</li><li><strong>作用范围与生命周期</strong>:所有权属于直连 Server 实例,不跨节点同步;owner 无自动租期过期机制。
 对于嵌入式程序集成,调用方必须调用 <code>HugeGraphLoader.shutdown()</code> 执行单次句柄释放;若释放失败,不会自动重试;
-该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
+该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -1239,7 +1261,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> 使用自定义数值 ID,映射中的 <code>id</code> 和 <code>created.target_id</code> 分别对应顶点 ID 及边的目标 ID。
-请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
+请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -1299,7 +1321,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-33-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-34-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -1311,7 +1333,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -1319,11 +1341,11 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
-只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-39 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
+只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -1345,17 +1367,29 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> 通过 <code>${SPARK_HOME}/bin/spark-submit</code> 提交 <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code>,因此 <code>SPARK_HOME</code> 必须指向一个 Spark 安装目录。<code>lib/</code> 下的所有 jar 都会加入 classpath。 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> 单独处理:使用 <code>--deploy-mode cluster</code> 时,映射文件会通过 <code>--files</code> 分发到 executor,loader 只收到它的文件名;其他情况下路径原样传入。</p><p>该模式下 loader 只读取 FILE、HDFS 和 JDBC 输入源,KAFKA 和 GRAPH 输入源会被拒绝。</p><p>默认情况下(<code>--sink-type true</code>),每个 Spark 分区各自创建一个 HugeClient,通过 HugeGraph serve [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>2.4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loade [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-41 data-td-code data-td-code-auto- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+POM 中的 Spark <code>3.2.2</code> 只提供编译期 API,不是运行引擎。设置 <code>SPARK_HOME</code> 和 <code>JAVA_HOME</code>,
+再使用发行目录中的启动脚本和 shaded Loader JAR。</p><p>先创建 Schema,确保 executor 可以读取数据文件。CSV、TEXT 数据须使用 UTF-8、去掉表头行,并在映射中显式指定 <code>header</code>。
+其他字符集和 <code>has_header: true</code> 会被拒绝。边依赖已有顶点时,先导入顶点。将以下路径替换为准备好的顶点映射文件。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <s [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>启动脚本可同时接收 <code>--master</code>、<code>--conf</code>、<code>--jars</code> 等 Spark 参数和 Loader 参数。
+额外的 JDBC 驱动需通过 <code>--jars</code> 传入,仅放在 <code>lib/</code> 中不会分发到 executor。
+导入后查询目标图,核对数量和属性;API 写入路径的插入计数器不统计分布式写入。</p><p>该路径拒绝 <code>--incremental-mode true</code> 和 <code>--failure-mode true</code>。Standalone Spark 仅支持 client 部署模式。
+Spark 3.5.8 / Java 17 不支持 HBase bulkload(<code>--sink-type false</code>)。已有 bulkload 部署建议继续沿用原环境验证通过的
+Loader 发布包及其相关依赖。更多细节见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark 迁移说明</a>。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-使用-flink-cdc-loader-导入>4.7 使用 flink-cdc-loader 导入</h4><p>当前 master 分支适配 Flink <code>2.2.1</code>、MySQL CDC <code>3.6.0-2.2</code> 和 Java 17。
+此前使用 Flink 1.13.5、CDC 2.2.1 的示例属于旧实现。
+设置 <code>FLINK_HOME</code>,确保提交进程、JobManager 和 TaskManager 都使用 Java 17。
+保留 Flink 的模块访问参数,发行目录的 <code>lib/</code> 中须恰好有一个 shaded Loader JAR。</p><p>每个映射都需使用 MySQL JDBC 输入,包含 <code>url</code>、<code>database</code>、<code>table</code>、<code>username</code> 和 <code>password</code>。
+MySQL 须配置 <code>binlog_row_image=FULL</code>。UPDATE 事件需要显式指定非空的 <code>update_strategies</code>,且图元素标识保持不变。
+顶点 ID、边端点或排序键变化时,任务会拒绝更新。CDC 也会拒绝 <code>--dry-run true</code> 和 <code>--use-prefilter true</code>。</p><p>不带分隔符时,所有参数均交给 Loader。需要设置 Flink 参数时,将其放在 <code>--</code> 之前,Loader 参数放在之后。
+准备好 <code>mysql-cdc.json</code> 映射后,使用单个 sink writer 提交任务。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-loader.sh -p <span class=m> [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>每个映射使用一个 source reader 和一个 sink writer。<code>--cdc-sink-parallelism</code> 默认为 <code>1</code>,其他取值会被拒绝。
+<code>--</code> 之后的 Loader 参数 <code>-p</code> 表示 Server 端口。Checkpoint 刷新不提供图写入事务,也不保证 exactly-once。
+在生产环境部署边 CDC 或更复杂的多表映射前,建议先在真实环境中充分验证。
+支持范围和恢复流程见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC 说明</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>2.4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loader;已有 Source、Transform、Sink 管道时使用 SeaTunnel Sink;Spark 作业可使用 Spark Connector。</p>< [...]
 列出的前置要求为 Java 8 或 11。从<a href=https://seatunnel.apache.org/download/>官方下载页</a><sup>[4]</sup>
 选择 3.0+ 二进制发行包,并使用页面提供的校验文件或签名验证下载包。
 下面以 3.0.0 为例,请将 <code>SEATUNNEL_VERSION</code> 改为实际下载的发行版本。</p><div class="td-code td-code--untitled" id=td-code-7df75818-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-7df75818-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>SEATUNN [...]
@@ -1488,22 +1522,39 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools 位于 toolchain 发布包的子目录中,</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># 其版本后缀与发布包本身一致</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>源码编译前请确保安装了wge [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. 下载发布版源码包</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>编译生成 tar 包:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-c [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>生成的 tar 包位于 <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>,同时会在 <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> 生成解压后的目录(包含 <code>bin/</code> 和 <code>lib/</code>)</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3. [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>任选一种方式构建发布版 <c [...]
+两段命令均包含编译和进入生成目录,最后用 <code>bin/hugegraph help</code> 查看可用命令。</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git 标签" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git 标签</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab=源码包 data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>源码包</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-e3b5ef3d-fence-2-viewport dat [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>编译还会在源码根目录下生成 <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code>。</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 构建当前源码</h4><p>若需要使用 master 分支未发布的新特性,可按以下步骤从源码构建 Tools(当前 master 以 1.8 为基线,需 JDK 17、Maven 3.6.3+ 与 Python 3.9+):</p><ol class=steps><li><p><strong>获取 Toolchain 源码</strong></p><div c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>构建配套 Server SDK</strong></p><p>执行以下脚本下载 Server 源码并将配套 SDK 安装到独立 Maven 仓库:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__viewport id=td-code-e3b5ef3d-fence-4-viewport data-td-code-viewport><div  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>详细说明见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p></li><li><p><strong>打包 Tools</strong></p><div clas [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>使用这份源码构建时保留 SDK 仓库。master 分支生成目录名不含 <code>incubating</code>。</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3.1 功能概览</h4><p>进入解压或编译生成的 Tools 目录,用 <code>bin/hugegraph help</code> 查看命令列表,
+用 <code>bin/hugegraph help &lt;子命令></code> 查看单个命令的用法。可用命令分为以下几类。</p><ul><li>图管理类,graph-mode-set、graph-mode-get、graph-list、graph-get、graph-clear、graph-create、graph-clone 和 graph-drop</li><li>异步任务管理类,task-list、task-get、task-delete、task-cancel 和 task-clear</li><li>Gremlin类,gremlin-execute 和 gremlin-schedule</li><li>备份/恢复类,backup、restore、migrate、schedule-backup 和 dump</li><li>认证数据备份/恢复类,auth-backup 和 auth-restore</li><li>旧版 Server/Studio 部署,deploy、clear、start-all 和 stop-all</li></ul><div cla [...]
+<code>--user</code> 和 <code>--password</code> 必须同时提供或同时省略。</p></blockquote><p>使用 <code>export</code> 设置的环境变量对当前终端及其启动的命令生效。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>全局变量</th><th scope=col>环境变量</th><th scope=col>示例</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGRAPH_URL</td><td>export HUGEGRAPH_URL=http://127.0.0.1:8080</td></tr><tr><td>&ndash;graph</td><td>HUGEGRAPH_GRA [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>另一种方式是在 bin/hugegraph 脚本中设置环境变量:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-6-viewport data-td-code-viewport><div class=hig [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>也可以在 <code>bin/hugegraph</code> 脚本中设置这些变量。</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-9-viewport data-td-code-viewport><div [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -1515,7 +1566,9 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> 还会读取 <code>JAVA_HOME</code>(未设置时打印警告,https 需要它)和 <code>JAVA_OPTIONS</code>(JVM 参数,为空时脚本使用 <code>-Xms512m</code>,并根据机器空闲内存计算 <code>-Xmx</code>)。</p><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--33-图管理类graph-mode-setgraph-mode-getgraph-listgraph-getgraph-cleargraph-creategraph-clone和graph-drop>3.3 图管理类,graph-mo [...]
 restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设置),否则命令会失败</p></blockquote></li><li>migrate,将当前连接的图迁移至另一个 HugeGraphServer 中<ul><li>&ndash;target-graph,目标图的名字,默认为 hugegraph</li><li>&ndash;target-url,目标图所在的 HugeGraphServer,默认为 http://127.0.0.1:8081</li><li>&ndash;target-user,访问目标图的用户名</li><li>&ndash;target-password,访问目标图的密码</li><li>&ndash;target-timeout,访问目标图的超时时间</li><li>&ndash;target-trust-store-file,访问目标图使用的 truststore 文件</li><li>&ndash;target-trust-store-password,访问目标图使用的 trust [...]
 用户也可以自定义存储格式。在 <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code> 下实现一个继承自 <code>Formatter</code> 的类,例如 <code>CustomFormatter</code>,使用时指定该类为 formatter:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+新部署请参考 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速上手</a> 与 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 快速上手</a>,
+以下说明仅供维护旧环境参考。</p><ul><li>deploy,一键下载、安装和启动 HugeGraph-Server 和 HugeGraph-Studio<ul><li>-v,必填项,指定要安装的 HugeGraph-Server 和 HugeGraph-Studio 版本,必须是 bin/version-map.yaml 中列出的版本之一(0.6、0.7、0.8、0.9、0.10),脚本据此映射到对应的 server 和 studio 发布版本</li><li>-p,必填项,指定安装的 HugeGraph-Server 和 HugeGraph-Studio 目录</li><li>-u,选填项,指定下载 HugeGraph-Server 和 HugeGraph-Studio 压缩包的链接</li></ul></li><li>clear,清理 HugeGraph-Server 和 HugeGraph-Studio 目录和tar包(若对应的 server 或 studio 进程仍在运行则拒绝执行,删除每一项前都会提示确认)<ul><li>-p,必填项,指定要清理的 Hu [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -1924,26 +1977,26 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-8-viewport data- [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 异步执行gremlin</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-10-viewport data-td [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-13-viewport data-td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport data-td-code-viewport><div class= [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-14-viewport data-td-code-viewport><div class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 恢复图</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 恢复图模式</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-15-viewport data-td-code-viewport [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-18-viewport data-td-code-viewport [...]
 并行扫描的后端要求和配置限制见<a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>官方 Source 文档</a>。</p><p>开始前请先完成<a href=/cn/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-%E5%87%86%E5%A4%87%E7%8E%AF%E5%A2%83>导入页中的通用环境准备和配置</a>,其中包含 JDK、HOCON、插件安装和图模型说明。</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-迁移-hugegraph-图graph2graph>1 迁移 HugeGraph 图(graph2graph)</h2><p>下面从源图迁移 <code>person</code> 顶点和 <code>knows</code> 边。请使用独立的目标图:本节采用 <code>CUSTOMIZE_STRING</code> 保留顶点 [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
 </span></span><span class=line><span class=ln> 3</span><span class=cl>}
@@ -2274,27 +2327,81 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=p>)</span>
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>task</span> <span class=o>=</span> <span class=n>NodeClassify</span><span class=p>(</span><span class=n>graph</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>task</span><span class=o>.</span><span class=n>train</span><span class=p>(</span><span class=n>lr</span><span class=o>=</span><span class=mf>1e-2</span><span class=p>,</span> <span class=n>weight_decay</span><span class=o>=</span><span class=mf>5e-4</span><span class=p>,</span> <span class=n>n_epochs</span><span class=o>=</span><span class=mi>2000</span><span class=p>,</span> <span class=n>patience</span> [...]
-</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=nb>print</span><span class=p>(</span><span class=n>task</span><span class=o>.</span><span class=n>evaluate</span><span class=p>())</span></span></span></code></pre></div></div></div><p>GRAND 每次增强采样都会返回一组 logits,<code>NodeClassify</code> 会对列表中的每个元素分别应用掩码后再计算损失。完整脚本是 <code>hugegraph-ml/src/hugegraph_ml/examples/grand_example.py</code>。</p><h2 id=pg-e0b469442bebe4a5db69564efbaa4753--排查问题>排查问题</h2><ul><li>连接失败: [...]
+文档向量化需要 Embedding,图数据抽取和答案生成还需要 LLM。Reranker 可选,初次运行可用本地 <code>bleu</code>。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>想做什么</th><th scope=col>页面入口</th><th scope=col>需要准备什么</th></tr></thead><tbody><tr><td>从文档建立索引</td><td><code>1. Build RAG Index</code></td><td>文档、Embedding;抽取图数据还需 Schema 和 LLM</td></tr><tr><td>根据文档或图回答问题</td><td><code>2. (Graph)RAG & User Functions</code></td><td>对应索引和 LLM</td></tr><tr [...]
+已有文件会保留。模板包含完整的 6 列,只填写测试问题和预期答案,4 个模型回答列留空。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=15><div class=td-code__viewport id=td-code-49825bb1-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>uv run --extra llm python - <span class=s>&lt;&lt;&#39;PYTHON&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>from pathlib import Path
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>from openpyxl import Workbook
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>path = Path(&#34;hugegraph-llm/src/hugegraph_llm/resources/demo/questions_template.xlsx&#34;)
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>if not path.exists():
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>    workbook = Workbook()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>    sheet = workbook.active
+</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>    sheet.append([
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>        &#34;Question&#34;, &#34;Expected Answer&#34;, &#34;Basic LLM Answer&#34;,
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>        &#34;Vector-only Answer&#34;, &#34;Graph-only Answer&#34;, &#34;Graph-Vector Answer&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>    ])
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    sheet.append([&#34;Who is Sarah?&#34;, &#34;Sarah is a 30-year-old attorney.&#34;, None, None, None, None])
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>    workbook.save(path)
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>PYTHON</span></span></span></code></pre></div></div></div></div></div><h2 id=pg-bb10fc095f5061d789104547f7246a67--0-配置面板>0. 配置面板</h2><p>标签页上方是可折叠的配置面板,共五个部分,包括 <code>1. Set up the HugeGraph server.</code>、<code>2. Set up the LLM.</code>、<code>3. Set up the Embedding.</code>、<code>4. Set up the Reranker.</code> 和 <code>5. Set up the vector engine.</code>。每部分都有独立的应用按钮,应用后会把受支持的字段写回 <code>.env</code>。 [...]
+截图使用本地 Ollama 的 <code>qwen2.5:3b</code> 和 <code>mxbai-embed-large</code>,向量引擎为 <code>Faiss</code>。
+更换 Embedding 模型后需重建索引,避免新旧向量维数或含义不同。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--1-构建-rag-索引>1. 构建 RAG 索引</h2><p>第一个标签页负责两类索引。</p><ul><li>将文档切分后写入 chunk 向量索引。</li><li>按 Schema 从文档抽取顶点和边,写入 HugeGraph,并维护顶点向量索引。</li></ul><pre class=td-mermaid-source><code class=language-mermaid>flowchart TD
     A[输入文档] --&gt; B[文本切分]
     B --&gt; C[生成 chunk 向量]
     C --&gt; D[写入向量索引]
     B --&gt; E[LLM 按 Schema 抽取顶点和边]
     E --&gt; F[写入 HugeGraph]
-    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>页面包含文档、Schema、抽取提示词和结果区域。常用操作有:</p><ol><li><code>Import into Vector</code>:切分文档并建立 chunk 向量索引。</li><li><code>Extract Graph Data (1)</code>:按 Schema 抽取图数据。</li><li><code>Load into GraphDB (2)</code>:把抽取结果写入 HugeGraph,并自动更新顶点向量。</li><li><code>Update Vid Embedding</code>:重新生成顶点向量,通常只在图中已有数据时才需要单独执行。</li></ol><p>这些按钮旁的 <code>Gr [...]
+    F --&gt; G[更新顶点向量索引]</code></pre><p>输入来自 <code>text</code> 子页或 <code>file</code> 子页。上传支持 <code>.txt</code>、<code>.docx</code> 和 <code>.pdf</code>,可一次选择多个文件。</p><p>首次尝试可以使用下面的短文,填入 <code>Input Doc(s)</code>。请先选择专用测试图,避免将示例写入业务图。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-2 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-2-viewport data-td-code-viewport><div class=highlight><pre [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertexlabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;id_strategy&#34;</span><span class=p>:</span> <span class=s2>&#34;PRIMARY_KEY&#34;</span><span class=p>,</span>
+</span></span><span class=line><span class=ln> 4</span><span class=cl>     <span class=nt>&#34;primary_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>],</span> <span class=nt>&#34;properties&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>],</span>
+</span></span><span class=line><span class=ln> 5</span><span class=cl>     <span class=nt>&#34;nullable_keys&#34;</span><span class=p>:</span> <span class=p>[</span><span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=s2>&#34;occupation&#34;</span><span class=p>]}</span>
+</span></span><span class=line><span class=ln> 6</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln> 7</span><span class=cl>  <span class=nt>&#34;edgelabels&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln> 8</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;roommate&#34;</span><span class=p>,</span> <span class=nt>&#34;source_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#34;target_label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span> <span class=nt>&#3 [...]
+</span></span><span class=line><span class=ln> 9</span><span class=cl>  <span class=p>],</span>
+</span></span><span class=line><span class=ln>10</span><span class=cl>  <span class=nt>&#34;propertykeys&#34;</span><span class=p>:</span> <span class=p>[</span>
+</span></span><span class=line><span class=ln>11</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;name&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>12</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;age&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;INT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>13</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;occupation&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>},</span>
+</span></span><span class=line><span class=ln>14</span><span class=cl>    <span class=p>{</span><span class=nt>&#34;name&#34;</span><span class=p>:</span> <span class=s2>&#34;date&#34;</span><span class=p>,</span> <span class=nt>&#34;data_type&#34;</span><span class=p>:</span> <span class=s2>&#34;TEXT&#34;</span><span class=p>,</span> <span class=nt>&#34;cardinality&#34;</span><span class=p>:</span> <span class=s2>&#34;SINGLE&#34;</span><span class=p>}</span>
+</span></span><span class=line><span class=ln>15</span><span class=cl>  <span class=p>]</span>
+</span></span><span class=line><span class=ln>16</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><p>页面包含文档、Schema、抽取提示词和结果区域。按下面的顺序建立图索引。只用向量检索时,完成第 1 步即可。</p><ol class=steps><li>点击 <code>Import into Vector</code>,切分文档并建立 chunk 向量索引。</li><li>在 <code>Graph Schema</code> 填入 Schema JSON 或已有图名,再点击 <code>Extract Graph Data (1)</code>。检查 <code>Output Info</code> 中的顶点、边和属性。</li><li>确认抽取结果后点击 <code>Load into GraphDB (2)</code>,写入 HugeGraph 并更新顶点向量。</li><li [...]
+图里已经有数据时,可以单独点击 <code>Update Vid Embedding</code> 更新顶点索引。</p><p>这些按钮旁的 <code>Graph Extraction Split Type</code> 下拉框可选 <code>document</code>、<code>paragraph</code> 或 <code>sentence</code>。<code>document</code> 把输入整体作为一个单元,另外两种会在抽取前先切分长文档。</p><p>页面还可以查看或清除 chunk 索引、顶点索引和图数据。清除操作会删除已有数据,执行前先确认当前图和索引是否仍被其他查询使用。</p><p>主控件下方还有两个折叠的辅助工具。</p><ul><li><code>Graph Schema Generator</code> 根据查询示例和少样本示例生成 Schema,填入 Graph Schema 字段。</li><li><code>Graph Extraction Prompt Generator</code> 根据期望场景(例如社交关系、金 [...]
+关键词输出需使用代码块中的英文前缀和冒号,姓名的大小写应与图数据一致。</p><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-4 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>只根据检索到的上下文,用中文简洁回答问题,保留原文中的姓名。上下文不足时说明缺少信息。
+</span></span><span class=line><span class=ln>2</span><span class=cl>上下文: {context_str}
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {query_str}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-49825bb1-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span> [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>只返回一行,严格使用英文冒号,格式为 KEYWORDS:姓名:1.0
+</span></span><span class=line><span class=ln>3</span><span class=cl>问题: {question}</span></span></code></pre></div></div></div><ol class=steps><li>输入 <code>Who is Sarah?</code>,将 <code>Graph-only Answer</code> 设为 <code>False</code>,<code>Graph-Vector Answer</code> 设为 <code>True</code>。</li><li>初次验证时保留 <code>Template Num=-1</code> 和 <code>Rerank method=bleu</code>,点击 <code>Answer Question</code>。</li><li>查看 <code>Graph-Vector Answer</code>,将答案中的职业、年龄等事实与原文和图数据核对。</li></ol><ul class="td-g [...]
     Q[问题] --&gt; V[查询 chunk 向量索引]
     Q --&gt; K[抽取关键词]
     K --&gt; M[匹配图顶点]
-    M --&gt; T[生成并执行 Gremlin]
-    T --&gt;|失败| B[BFS 图遍历回退]
+    M --&gt; D{启用 Text2Gremlin}
+    D --&gt;|是| T[生成并执行 Gremlin]
+    D --&gt;|否| B[BFS 图遍历]
+    T --&gt;|失败| B
     T --&gt; R[整理图结果]
     B --&gt; R
     V --&gt; S[合并与重排序]
     R --&gt; S
-    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式:</p><ul><li>小于 0:完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0:不带任何示例生成 Gremlin(zero-shot)。</li><li>大于 0:从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 [...]
+    S --&gt; A[生成答案]</code></pre><p>图召回先用关键词精确匹配 HugeGraph 顶点,找不到时再用顶点向量做近似匹配。匹配结果会进入 Text2Gremlin;生成或执行失败时,流程可以回退到预定义的图遍历。</p><p><code>Template Num</code> 控制 Text2Gremlin 在图召回中的参与方式。</p><ul><li>小于 0 时,完全跳过 Text2Gremlin,图召回直接使用预定义的图遍历。</li><li>等于 0 时,不检索参考示例,使用基础生成结果。</li><li>大于 0 时,从示例索引中取相应数量的相近示例,并采用带模板的生成结果。示例数量会被限制在 0 到 10 之间。</li></ul><p>该标签页的其他控件还有 <code>Rerank method</code>(<code>bleu</code> 或 <code>reranker</code>)、<code>Graph Ratio</code>、<code>Near neighbor first</code> 和 <cod [...]
+未上传文件时使用内置的 <code>resources/demo/text2gremlin.csv</code>。示例中的标签和属性应与当前图一致。</p><div class="td-callout td-callout--tip" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-lightbulb" aria-hidden=true></i><span class=td-callout__label>提示</span></div><div class=td-callout__body><p>若上传 CSV 构建示例向量索引后未自动召回示例模板,可直接在下面的 Prompt 模板中手动提供 Few-shot 参考示例。</p></div></div><p>复现 Sarah 查询时,使用以下输入。</p><ol class=steps><li>将下面的 CSV 保存为 <code>sarah-gremlin.csv</code>,上传后点击 <code>Build [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Who is Sarah?</span><span class=p>,</span><span class=s2>&#34;g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Sarah&#39;).valueMap()&#34;</span></span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-49825bb1-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=1><div class=td-code__viewport id=td-code-49825bb1-fence-9-viewport da [...]
+</span></span><span class=line><span class=ln> 2</span><span class=cl>按人物姓名查询时,使用 g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;&lt;问题中的姓名&gt;&#39;).valueMap()。
+</span></span><span class=line><span class=ln> 3</span><span class=cl>保留姓名的大小写,按姓名查询,不使用顶点 ID。
+</span></span><span class=line><span class=ln> 4</span><span class=cl>问题示例: Who is Peter?
+</span></span><span class=line><span class=ln> 5</span><span class=cl>Gremlin 示例: g.V().has(&#39;person&#39;, &#39;name&#39;, &#39;Peter&#39;).valueMap()
+</span></span><span class=line><span class=ln> 6</span><span class=cl>图 Schema: {schema}
+</span></span><span class=line><span class=ln> 7</span><span class=cl>其他示例: {example}
+</span></span><span class=line><span class=ln> 8</span><span class=cl>已知顶点: {vertices}
+</span></span><span class=line><span class=ln> 9</span><span class=cl>问题: {query}
+</span></span><span class=line><span class=ln>10</span><span class=cl>只返回一个 ```gremlin``` 代码块。</span></span></code></pre></div></div></div><ul class="td-gallery td-gallery--static"><li class=td-gallery__item><img class=td-gallery__image src=/images/docs/hugegraph-ai/cn/text2gremlin.jpg alt="Text2Gremlin 生成的查询与执行结果" loading=lazy decoding=async></li></ul><p>小模型可能生成错误 ID、大小写不符的姓名或不满足索引条件的过滤语句。应查看执行结果中的具体数据,再判断查询是否成功。
+Web 页面会直接执行生成的语句,请使用专用测试图。需要只生成语句时,在 <a href=/cn/docs/quickstart/hugegraph-ai/rest-api/>REST API</a> 中选择相应输出类型。</p><p>自定义提示词必须保留 <code>{query}</code>、<code>{schema}</code>、<code>{example}</code> 和 <code>{vertices}</code>。缺少任一占位符时,REST API 会拒绝请求。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--4-图工具与管理工具>4. 图工具与管理工具</h2><p><code>Graph Tools</code> 标签页可直接对当前图执行 Gremlin 查询、手动触发图备份,并通过 beta 操作初始化 HugeGraph 演示数据。后台还有两个任务,每天凌晨 1 点自动备份图数据,以及在进程运行期间持续更新顶点 id 向量。
+初始化演示数据会先清空当前图,只能在专用测试图上使用。</p><p><code>Admin Tools</code> 需要密码。输入已配置的 <code>ADMIN_TOKEN</code> 后可查看 <code>logs/llm-server.log</code> 的末尾内容(每 60 秒自动刷新),并可手动刷新或清空该文件。<code>ADMIN_TOKEN</code> 为空或仍是占位值 <code>xxxx</code> 时,访问会被拒绝。</p><p>设置 <code>ENABLE_LOGIN=True</code> 后,Web 页面会要求基础认证,用户名固定为 <code>rag</code>,密码是 <code>USER_TOKEN</code>;REST API 则要求把 <code>USER_TOKEN</code> 作为 Bearer token。日志接口还要求单独配置安全的 <code>ADMIN_TOKEN</code>。</p><div class="td-callout td-callout--warning" role=note><div  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>EN</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 中文提示词</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不是 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quickst [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=na>LANGUAGE</span><span class=o>=</span><span class=s>CN</span></span></span></code></pre></div></div></div><p>修改后重启服务。该配置选择内置提示词语言,不会自动翻译输入文档,也不属于 <code>/rag</code> 请求体字段。</p><h2 id=pg-bb10fc095f5061d789104547f7246a67--6-rest-调用>6. REST 调用</h2><p>Web 页面和 REST API 使用同一套流程。需要程序集成时使用 <code>/rag</code>、<code>/rag/graph</code>、<code>/graph/extract</code> 和 <code>/text2gremlin</code>;请求结构见 <a href=/cn/docs/quicks [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>python -m hugegraph_llm.config.generate --update</span></span></code></pre></div></div></div><p><code>--update</code> 默认开启,因此不带参数运行效果相同。配置模块首次导入时会为缺失的 <code>.env</code> 和提示词 YAML 按默认值创建文件;文件已存在时,生成器会交互询问是否覆盖。该命令会处理 HugeGraph、管理员、LLM、索引配置及提示词 YAML,不会在无确认的情况下覆盖已有文件。</p><p><code>.env</code> 包含密钥和密码,不要提交到版本库。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--基础选项>基础选项</h2><div class="td-table-scroll td-table-scroll--static" ta [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>uv sync --package hugegraph-llm --extra vectordb</span></span></code></pre></div></div></div><p>Web 页面的 <code>5. Set up the vector engine.</code> 面板提供同样的选择,并会保存所选引擎的连接配置。</p><h2 id=pg-6cc3291f0d6d469d81467164d710a8f2--登录与日志接口>登录与日志接口</h2><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置项</th><th scope=col>默认值</th><th scope=col>说明</th></tr>< [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=na>CHAT_LLM_TYPE</span><span class=o>=</span><span class=s>openai</span>
@@ -2917,7 +3024,7 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_endpoint</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;http://minio:9000&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_access_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-access-key&#34;</span><span class=w>
 </span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_secret_key</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;my-secret-key&#34;</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker-与-master-配置>5. Worker 与 Master 配置</h3><p>Worker 和 Master 计算逻辑的配置。</p><h4 id=pg-094fc5e6c5eaa81703c55b700e7863d5--51-master-配置>5.1 Master 配置</h4><div [...]
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>  </span><span class=nt>snapshot.minio_bucket_name</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;hugegraph-snapshots&#34;</span></span></span></code></pre></div></div></div><hr><h3 id=pg-094fc5e6c5eaa81703c55b700e7863d5--5-worker-与-master-配置>5. Worker 与 Master 配置</h3><p>Worker 和 Master 计算逻辑的配置。</p><h4 id=pg-094fc5e6c5eaa81703c55b700e7863d5--51-master-配置>5.1 Master 配置</h4><div [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>&lt;dependencies&gt;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>    <span class=nt>&lt;dependency&gt;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>        <span class=nt>&lt;groupId&gt;</span>org.apache.hugegraph<span class=nt>&lt;/groupId&gt;</span>
@@ -2925,10 +3032,14 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>6</span><span class=cl>        <span class=c>&lt;!-- 以下完整示例可使用已发布的 1.7.0 --&gt;</span>
 </span></span><span class=line><span class=ln>7</span><span class=cl>        <span class=nt>&lt;version&gt;</span>1.7.0<span class=nt>&lt;/version&gt;</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl>    <span class=nt>&lt;/dependency&gt;</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>以下完整示例使用的 Schema、Graph、Gremlin 和资源关闭接口在已发布的 Client <code>1.7.0</code> 中可用,也与 Toolchain <code>master</code> 兼容。
-上面的依赖可直接用于示例工程。</p><p>如果需要<a href=/cn/docs/clients/hugegraph-client/>API 参考</a>中的 master 新接口(例如能力探测),请使用 Toolchain <code>master</code> 的 Client <code>1.8.0</code>,
-将 POM 中的版本改为 <code>1.8.0</code>。该版本未发布到 Maven 仓库时,先在 Toolchain 源码根目录运行以下命令,
-将 Client 及其父 POM 安装到本地 Maven 仓库。源码构建仍需从配置的 Maven 仓库获取依赖。</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>mvn install -pl hugegraph-client -am -DskipTests -Dmav [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=nt>&lt;/dependencies&gt;</span></span></span></code></pre></div></div></div><p>先根据用途选择客户端版本。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>用途</th><th scope=col>客户端版本</th><th scope=col>Java 编译目标</th></tr></thead><tbody><tr><td>运行下方完整示例</td><td>已发布的 <code>1.7.0</code>,使用上面的依赖即可</td><td>发布版 POM 为 Java 8;本文统一使用 JDK 17</td></tr>< [...]
+发布版的 Java 编译目标不代表所有传递依赖的运行环境要求。</p><p>若需要使用 master 分支未发布的新接口,可从源码编译安装 Client(需配合 Toolchain 源码,详见 <a href=/cn/docs/quickstart/toolchain/hugegraph-tools/#build-current-source>Tools 源码构建指引</a>):</p><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-18ca6629-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lan [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn -Dmaven.repo.local<span class=o>=</span><span class=s2>&#34;</span><span class=si>${</span><span class=nv>candidate_dir</span><span class=p>:?Run the candidate SDK setup first</span><span class=si>}</span><span class=s2>/m2&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>  install -pl hugegraph-client -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp</span></span></code></pre></div></div></div><p>两条版本检查都应显示 JDK 17。使用 master 分支 Client 的项目运行 Maven 命令时,也需添加 <code>-Dmaven.repo.local="$candidate_dir/m2"</code>。
+Client 与 Server 的版本不必相同;升级前核对所需 API 及兼容范围。</p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--43-example>4.3 Example</h4><p>选择单条操作或批量操作示例,将完整代码保存为 Maven 工程中的 <code>src/main/java/SingleExample.java</code> 或
+<code>src/main/java/BatchExample.java</code>。复制按钮会包含已折叠的代码行。</p><div class="td-tabs td-tabs--shortcode" id=pg-ffe87f885ed695dba5fb26ef5ea12983--td-tabs-18ca6629-0><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-single data-td-tabs-value=single data-td-tabs-active><div class=td-tabs__panel-title aria-hidden=true>SingleExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--431-singleexample>4.3.1 SingleExample</h5><div  [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.Iterator</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=w>
@@ -3076,7 +3187,7 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>146</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>147</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>148</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitled" id=td-code-18ca6629-fence-3 data-td-code data-td-code-auto-id data-td-language=java data-td-line-count=139><div class=td-code__viewport id=td-code-18ca6629-fence-3-viewport data-td-code-viewport><div class=highlight><pre tab [...]
+</span></span></span><span class=line><span class=ln>149</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><div class=td-tabs__panel id=pg-ffe87f885ed695dba5fb26ef5ea12983--java-client-example-batch data-td-tabs-value=batch><div class=td-tabs__panel-title aria-hidden=true>BatchExample</div><div class=td-tabs__panel-body><h5 id=pg-ffe87f885ed695dba5fb26ef5ea12983--432-batchexample>4.3.2 BatchExample</h5><div class="td-code td-code--untitle [...]
 </span></span></span><span class=line><span class=ln>  2</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>java.util.List</span><span class=p>;</span><span class=w>
 </span></span></span><span class=line><span class=ln>  3</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>  4</span><span class=cl><span class=kn>import</span><span class=w> </span><span class=nn>org.apache.hugegraph.driver.GraphManager</span><span class=p>;</span><span class=w>
@@ -3214,7 +3325,9 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span></span><span class=line><span class=ln>136</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln>137</span><span class=cl><span class=w>        </span><span class=n>hugeClient</span><span class=p>.</span><span class=na>close</span><span class=p>();</span><span class=w>
 </span></span></span><span class=line><span class=ln>138</span><span class=cl><span class=w>    </span><span class=p>}</span><span class=w>
-</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><p>运行 Example 之前需要启动 Server, 启动过程见<a href=/cn/docs/quickstart/hugegraph/hugegraph-server>HugeGraph-Server 快速上手</a></p><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍< [...]
+</span></span></span><span class=line><span class=ln>139</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div></div><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--44-运行-example>4.4 运行 Example</h4><ol class=steps><li><a href=/cn/docs/quickstart/hugegraph/hugegraph-server>启动 HugeGraph Server</a>,在图空间 <code>DEFAULT</code> 中准备名为 <code>hugegraph</code> 的测试图。</li><li>将 Maven 工程的 JDK 设为 17,把所选示例中 <code>HugeClient.builder(...)</code> 和 <code>configUser [...]
+Server 未开启鉴权时,省略 <code>configUser(...)</code>。</li><li>在 IDE 中运行 <code>SingleExample.main()</code> 或 <code>BatchExample.main()</code>。两个示例都会创建 Schema 和图数据、打印结果并关闭客户端。
+请使用测试图,已有 Schema 或数据可能影响重复运行。</li></ol><h4 id=pg-ffe87f885ed695dba5fb26ef5ea12983--45-详细-api-说明>4.5 详细 API 说明</h4><p>示例说明见<a href=/cn/docs/clients/hugegraph-client>HugeGraph-Client 基本 API 介绍</a></p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-0f122bc9c526a968d392f6806ad6ddce>5.2 - HugeGraph Python 客户端快速上手</h1><template data-hg-authored-content=start></template><p><code>hugegraph-python-client</code> 是 HugeGraph 的 P [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 也可以使用 pip install hugegraph-python</span></span></span></code></pre></div></div></div><p>上述命令不固定版本号,默认安装最新发布版;发行信息见 <a href=https://pypi.org/project/hugegraph-python/>PyPI 发布页</a>。源码目录名是 <code>hugegraph-python-client</code>,发行包名为 <code>hugegraph-python</code>;需要主线代码时,请从 HugeGraph-AI workspace 安装。</p><p>如需使用仓库中的最新代码,请从 HugeGraph-AI 仓库根目录同步 workspace。<code>hugegraph-python-client</code> 是 workspace 成员,通过  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-ai
 </span></span><span class=line><span class=ln>3</span><span class=cl>uv sync --extra python-client
diff --git a/cn/_print/docs/quickstart/toolchain/index.html b/cn/_print/docs/quickstart/toolchain/index.html
index 4bf6650f1..3b0baa054 100644
--- a/cn/_print/docs/quickstart/toolchain/index.html
+++ b/cn/_print/docs/quickstart/toolchain/index.html
@@ -5,62 +5,61 @@ HugeGraph Toolchain 包含 Java/Go 客户端、Loader、Hubble、Tools、Spark C
 HugeGraph Toolchain 包含 Java/Go 客户端、Loader、Hubble、Tools、Spark Connector 和 SeaTunnel Sink/Source。先按任务选择入口,再查看对应组件的配置与命令。"><link rel=preload href=/scss/main.min.fa8bb553ea6f16a972e22510cefd5bf77b8474fbee1474dc452465ab36c84c0a.css as=style integrity="sha256-+ou1U+pvFqly4iUQzv1b93uEdPvuFHTcRSRlqzbITAo=" crossorigin=anonymous><link href=/scss/fontawesome.min.d1b0898e80994c0e0be2e673debfd8c2e5eb8c0b96d55c483e1be19cb01e5d10.css rel=stylesheet integrity="sha256-0bCJjoCZTA4L4uZz3r/YwuXrjAuW1VxIPhv [...]
 <button type=button class="btn btn-link p-0 align-baseline" data-td-action=print>点击此处打印</button>.</p><p><a href=/cn/docs/quickstart/toolchain/>返回本页常规视图</a>.</p></div><h1 class=title>HugeGraph ToolChain</h1><ul><li>1: <a href=#pg-55eecaa5c3ceec829e0f0d20863baa46>使用 Hubble 实现图可视化:单机快速上手</a></li><li>2: <a href=#pg-91cea9e83b921f10aa1de60b138055b0>图可视化</a><ul><li>2.1: <a href=#pg-33fca9af1c30d5ed43daaa61aa0928ea>使用 Hubble 管理 HStore 分布式集群</a></li></ul></li><li>3: <a href=#pg-85740db4cef1a86c9 [...]
 并在图、表格和 JSON 视图之间自由切换。本文以 <strong>单机 RocksDB Server + Hubble</strong> 为例走通完整操作,无需预先部署 PD 或 Store。</p><p>如需搭配 HStore 分布式集群使用,可先了解本文的基础操作,再参考 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>HStore 分布式补充</a>。
-文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前版本均为 <code>1.8.0</code>)为准;Docker <code>latest</code> 为动态标签,实际部署建议使用固定版本。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
-<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动单机组合</h2><p>直接使用主仓库提供的 <a href=https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml>docker/docker-compose.yml</a> 即可,
+文档内容以 Toolchain 与 Server 的 <code>master</code> 分支(当前均以 1.8 为基线,尚未正式发布)为准;Docker <code>latest</code> 为动态标签,生产环境建议使用已发布的固定版本。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></div><div class=td-callout__body><p>请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
+<a href=/cn/docs/config/config-authentication/>认证与授权</a>及访问白名单。</p></div></div><p>可按需快速跳转到对应操作;首次使用建议从启动单机环境开始:</p><ul class=cards><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--启动单机组合>启动并加载示例</a></p><p>启动两个服务,加载人物与软件示例图。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>查询与可视化</a></p><p>运行 Gremlin,再查看图、表格或 JSON 结果。</p></li><li><p><a href=#pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>导入自己的数据</a></p><p>准备 CSV,配置数据源、字段映射并验证导入结果。</p></li></ul><h2 id=p [...]
 无需自行编写 Compose 配置文件。该文件已内置编排了 RocksDB Server 与 Hubble,并配置好网络、健康检查及持久化数据卷;
-完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --br [...]
+完整部署说明见同目录的 <a href=https://github.com/apache/hugegraph/blob/master/docker/README.md>README</a>。</p><ol class=steps><li><p><strong>准备官方 Compose 配置。</strong></p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class=td-code__viewport id=td-code-cdca8595-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span cla [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph/docker</span></span></code></pre></div></div></div><p>若本地已有主仓库,直接进入其 <code>docker/</code> 目录即可。Compose 会自动挂载该目录下的
 <a href=https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties><code>conf/hubble/standalone.properties</code></a>,
 已预设 <code>pd.enabled=false</code> 与 <code>server.direct_url=http://server:8080</code>。两项服务处于同一 Docker 网络中通信,
 无需为每个图单独配置 Server 地址。请直接在 <code>docker/</code> 目录下启动,以确保相对配置路径有效。</p><p>Hubble 默认只在宿主机回环地址开放 <code>8088</code>(由 <code>HUBBLE_PUBLISH_HOST</code> 环境变量控制,默认为 <code>127.0.0.1</code>);
-Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-b [...]
+Server 默认对外发布 <code>8080</code>。若仅供本机试用,可将 Compose 中 Server 的 <code>ports</code> 改为 <code>127.0.0.1:8080:8080</code>,避免匿名端口暴露到外部网络。</p></li><li><p><strong>启动并检查服务。</strong></p><p>为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabin [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_IMAGE</span><span class=o>=</span>hugegraph/hubble:latest
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>export</span> <span class=nv>HUBBLE_DEMO_PROJECT</span><span class=o>=</span><span class=s2>&#34;hubble-demo-</span><span class=k>$(</span>date +%Y%m%d-%H%M%S<span class=k>)</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>docker compose ls
 </span></span><span class=line><span class=ln>5</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml pull
 </span></span><span class=line><span class=ln>6</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml up -d --wait
 </span></span><span class=line><span class=ln>7</span><span class=cl>docker compose -p <span class=s2>&#34;</span><span class=nv>$HUBBLE_DEMO_PROJECT</span><span class=s2>&#34;</span> -f docker-compose.yml ps
-</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
+</span></span><span class=line><span class=ln>8</span><span class=cl>curl -fsS http://127.0.0.1:8080/versions</span></span></code></pre></div></div></div></li><li><p><strong>打开 Hubble。</strong></p><p>服务启动完成后,在浏览器访问 <a href=http://127.0.0.1:8088>http://127.0.0.1:8088</a>。若未在 <code>.env</code> 中配置 <code>HUGEGRAPH_ADMIN_PASSWORD</code>,Server 默认允许匿名访问,
 Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在 <code>.env</code> 中配置管理员密码与 JWT 密钥,并使用 Server 账号登录(Hubble 无独立用户库)。
-个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</code> 卷分别持 [...]
-<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页:找到当前任务的入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
+个人中心与账号管理入口仅在开启认证且具备相应权限时展示。</p></li></ol><p><code>latest</code> 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 <a href=/cn/docs/download/download/>下载页</a> 获取。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>核实部署版本</span></div><div class=td-callout__body><p>文档截图用于定位界面元素,实际版本以部署镜像的 digest 及构建信息为准。</p></div></div><p>Compose 中的 <code>server-data</code> 与 <code>hubble-data</ [...]
+<a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 部署指南</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--首页找到当前任务的入口>首页与任务入口</h2><p>首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
 顶部的图选择器用于切换当前操作的目标图,所有查询、Schema 操作和异步任务均作用于当前选中的图。
-单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
+单机模式下仅包含默认的 <code>DEFAULT</code> 图空间,无需配置 PD。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>栏目</th><th scope=col>主要用途</th></tr></thead><tbody><tr><td>图概览与图详情</td><td>选择图、加载示例、查看数据规模,再进入建模或查询</td></tr><tr><td>Schema / 元数据配置</td><td>定义属性、顶点类型、边类型及索引</td></tr><tr><td>GQL 图遍历</td><td>编写查询,在图、表格和 JSON 中探索结果</td></tr><tr><td>内置图算法</td><td>用参数表单探索邻居、路径和相似关系</td></tr><tr><td>异步任务</td><td>跟踪后台查询、Schema 和索引操作</td> [...]
 初次体验建议在空图上加载,避免与已有同名 Schema 冲突。后续章节均基于该示例图演示。</p><p>若需新建图,可在页面点击新建按钮,填写图名称、可选别名并选择 Schema 模板或示例数据。连接信息由 Hubble 后端统一配置,
-无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>Schema 建模:定义数据的形状</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
-在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中:<code>person</code> 以 <cod [...]
+无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--schema-建模定义数据的形状>定义 Schema</h2><p>Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
+在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>定义</th><th scope=col>建模时关注什么</th></tr></thead><tbody><tr><td>属性</td><td>数据类型、单值或多值,避免把数值读成文本</td></tr><tr><td>顶点类型</td><td>属性、可空属性、ID 策略与主键</td></tr><tr><td>边类型</td><td>起点和终点类型、属性、边的频次及排序键</td></tr><tr><td>顶点索引 / 边索引</td><td>索引类型与字段,匹配实际过滤和范围查询</td></tr></tbody></table></div><p>在人物与软件示例中,<code>person</code> 以 <cod [...]
 <code>software</code> 采用自定义数值 ID;边类型 <code>created</code> 连接人物与软件。模型定义与 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>Loader 示例</a> 保持一致。</p><p>自主建模时,建议遵循 <strong>属性 → 顶点类型 → 边类型 → 索引</strong> 的顺序依次创建。
-删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>GQL 工作台:查询与探索人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
-支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中执行人物属性查询:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><s [...]
+删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--gql-工作台查询与探索人物关系>在 GQL 工作台查询人物关系</h2><p>进入【GQL 图遍历】,确认当前图为 <code>hugegraph</code>。工作台将查询编辑器与图展示区集成在一起,
+支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中查询人物属性。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><spa [...]
 布局、样式和筛选工具帮助突出重点,导出功能便于分享结果。【新增】用于创建元素,有权限时也可以编辑已有数据。
 调整布局、颜色或显示范围仅影响前端画布;通过界面新增、编辑元素或执行 Gremlin 写入语句才会真正修改 Server 中的图数据。</p><p>快捷键 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 可快速执行查询。普通即时执行适合小规模交互探索;大数据量或耗时查询建议提交为后台异步任务。
-Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><div class="td-callout td-callout--note" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-circle-info" aria-hidden=true></i><span class=td-callout__label>说明</span></div><div class=td-callout__body><p>Text2GQL 后端能力(包括模型设置、内置/临时模型管理与 Prompt 模板)依赖包含
-<a href=https://github.com/apache/hugegraph-toolchain/pull/824>apache/hugegraph-toolchain#824</a> 的 Hubble 构建或后续发布版本;未合入该特性的旧版本仅提供预览占位,不包含模型设置页面。</p></div></div><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
+Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前获得焦点的输入框(在自然语言框中生成查询,在语句框中执行已有语句)。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--text2gql>Text2GQL 自然语言查询</h3><p>在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
 生成的语句支持二次编辑(执行前同样会进行只读安全校验)。切换至【异步】模式时,生成的查询与手写查询均可提交为后台异步任务。
-输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="Text2GQL 查询与图结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p class=td-gallery__description>模型设 [...]
-注意:Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
+输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。</p><ul class="td-gallery td-gallery--static td-gallery--described"><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql.jpg alt="未配置模型时的自然语言入口与手写 Gremlin 查询结果" loading=lazy decoding=async><p class=td-gallery__description>查询工作台,模型尚未配置,结果来自手写查询</p></li><li class=td-gallery__item><img class=td-gallery__image src=/cn/docs/images/hubble/text2gql-settings.jpg alt=内置模型设置 loading=lazy decoding=async><p cla [...]
+Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,<code>localhost</code> 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
 本地回环或私网模型;在【模型设置】中修改 Base URL 时,必须重新填写 Key 或清空已保存的 Key。
-全局内置模型仅由 <code>admin</code> 账号(PD 模式下为超级管理员)统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
+全局内置模型由具备模型设置管理权限的管理员统一配置;未开启 Server 认证时,任何访问者均可配置。</p><p>在模型设置页面右上角打开 <strong>Text2GQL Prompt</strong>,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
 点击【应用】后需保存模型设置,模板将持久化存入 H2 数据库供内置模型与临时模型共享,生成时会自动附加当前图的 Schema。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>API Key 存储与隐私说明</span></div><div class=td-callout__body><p>备份 Hubble H2 数据库时,请一并备份主密钥文件(默认路径 <code>data/text2gql-master.key</code>),该文件丢失将导致无法解密已保存的 Key。
 生成查询时仅向模型接口发送用户问题、当前 Schema 及纠错提示,绝不会发送图数据查询结果。
-浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>内置图算法:用表单探索关系</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
+浏览器可选择记住常用的 Base URL 与模型名称,但临时 API Key 仅保留在前端内存中,刷新页面即自动清除。</p></div></div><p>页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--内置图算法用表单探索关系>使用内置图算法</h2><p>不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
 邻居探索用于回答“这个点附近有什么”,路径算法用于寻找两个点的连接,相似度和排序算法用于比较或筛选顶点。
 从一个已知顶点 ID 开始,先限定方向、边类型、深度与返回规模,再观察结果,会比直接运行大范围计算更容易理解。</p><p>算法表单提供参数说明及文档入口;常用参数可以在页面间往返时恢复。
 运行结果按算法显示为图或相应的结果面板;需要理解具体定义和参数时,使用算法标题旁的说明与文档链接。
 表单聚焦时也可用 <code>Ctrl</code> / <code>Command</code> + <code>Enter</code> 运行当前算法。</p><p>OLAP 批量算法需要 Computer 或 Vermeer 等外部计算环境。本例的两个容器用于在线图操作,不包含这些计算服务。</p><p>例如选择 K-neighbor(GET),设置 <code>source=1:marko</code>、<code>max_depth=1</code>、<code>limit=20</code>,
-参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>异步任务:确认后台操作的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
+参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。</p><img class=td-image src=/cn/docs/images/hubble/algorithms.jpg alt=内置邻居算法的参数与图结果 width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--异步任务确认后台操作的最终结果>查看异步任务的最终结果</h2><p>【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
 可以按任务类型和状态筛选,查看任务 ID、创建时间与执行状态;成功查询可打开结果,失败任务可展开错误信息。
 已结束的任务可按界面提供的操作删除记录,任务列表与导入任务的执行历史是两个不同入口。</p><p>例如把 <code>g.V().count()</code> 以异步方式提交后,先在列表确认成功,再查看返回的数量。
-“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>数据源管理:把原始数据准备好</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
-不同来源需要对应的路径、连接或订阅配置。FILE 最适合先体验:上传文件后,配置格式、分隔符、编码和表头,
-检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
+“提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据源管理把原始数据准备好>准备数据源</h2><p>数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
+不同来源需要对应的路径、连接或订阅配置。首次体验可选择 FILE。上传文件后,配置格式、分隔符、编码和表头,
+检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。</p><p>为人物示例保存一个 UTF-8 文件 <code>people.csv</code>。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-6 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-cdca8595-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-csv data-lang=csv><span class=line><span class=ln>1</span><span class=cl><span class=s>name</span [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>docs_alice</span><span class=p>,</span><span class=s>28</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs_bob</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><p>创建 FILE 数据源并上传它,选择 CSV(逗号分隔、默认 UTF-8),列名为 <code>name,age,city</code>。
-表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>数据导入:从字段映射到可查询的图</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
-沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务:</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
+表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--数据导入从字段映射到可查询的图>映射字段并导入数据</h2><p>【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
+沿用上面的数据源,在 <code>DEFAULT</code> / <code>hugegraph</code> 中创建人物导入任务。</p><ol class=steps><li><strong>基础信息</strong> 选择目标图与刚创建的数据源,填写任务名。</li><li><strong>源端字段</strong> 选择 <code>name</code>、<code>age</code>、<code>city</code>,移到已选字段列表。</li><li><strong>映射字段</strong> 添加 <code>person</code> 顶点映射,用【自动匹配】关联同名属性后核对类型。</li><li><strong>调度信息</strong> 选择执行一次,确认后提交任务。</li></ol><p><code>person</code> 使用 PRIMARY_KEY,不设置独立 ID 列。自定义 ID 策略需要指定 ID 列;
 AUTOMATIC 由 Server 生成 ID,PRIMARY_KEY 根据映射的主键属性生成 ID。边映射还需指定起点、终点字段并匹配对应顶点的 ID 规则。</p><p>任务列表用于管理配置和执行入口,详情中的执行历史用于查看每次实例的状态、导入量与错误。
 Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源类型匹配。
-完成后返回 GQL 工作台验证:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</sp [...]
+完成后返回 GQL 工作台查询新导入的数据。</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-7 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>( [...]
 失败时先检查源字段、数值类型、可空属性及目标 Schema。Hubble 导入适合小规模体验,
 大批量正式导入请使用 <a href=/cn/docs/quickstart/toolchain/hugegraph-loader/>HugeGraph Loader</a>。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--个人中心与账号权限>个人中心与账号权限</h2><p>Hubble 使用 Server 的认证和账号,没有独立用户库。匿名访问时不显示【个人中心】与【账号管理】;
 开启认证后,个人中心展示当前账号资料与权限信息,可修改自己的密码。昵称等资料编辑依赖 Server 对个人资料接口的支持。
@@ -68,25 +67,20 @@ Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源
 通过 Hubble 新建的普通单机账号会获得覆盖所有图的读、写、删除和执行权限,不能把它当作只读账号或单图隔离账号。
 需要更细的资源权限时,应按 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>配置,而不是依赖空间预设。</p><h3 id=pg-55eecaa5c3ceec829e0f0d20863baa46--pd-模式的空间权限>PD 模式的空间权限</h3><p>连接支持默认角色接口的 Server 后,账号与空间访问可以分别管理。管理员管理全局账号,
 空间管理员只管理已授权空间的成员;普通成员不会获得账号管理或运维入口。
-以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
+以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>范围与用途</th></tr></thead><tbody><tr><td><code>SUPER_ADMIN</code></td><td>全局管理账号、图空间和运维;可授予或撤销超级管理员</td></tr><tr><td><code>GS_ADMIN</code></td><td>管理已授权图空间及其成员,不授予其他空间或全局超级管理员权限</td></tr><tr><td><code>GS_READ_WRITE</code></td><td>在已授权空间执行图数据读写操作,不管理全局账号</td></tr><tr><td><code>GS_READ_ONLY</code>< [...]
 把已有自定义权限替换为预设前,先核对需要保留的授权,避免把复杂权限误认为单一预设。
 权限变更后刷新权限上下文或重新登录,确认菜单和目标空间已更新;最终请求仍由 Server 校验。
 旧 Server 未提供相应接口时,页面按能力隐藏或禁用操作,不应只凭按钮是否可见推断资源权限。
-更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt="认证模式下的账号列表(PD 模式示例)" width=2033 height=977 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>系统运维:检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
+更完整的空间管理见 <a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>分布式补充</a>。</p><img class=td-image src=/cn/docs/images/hubble/accounts.jpg alt=认证模式下的账号列表(单机模式示例) width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--系统运维检查单机-server>检查单机 Server</h2><p>单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
 节点列表可搜索、筛选健康状态并进入详情;详情用于查看可用的版本、系统、JVM、Server 后端等指标。
 指标缺失或标记过期时,应结合采集状态与最近成功时间判断,不能把空值当作零或健康。</p><p>匿名模式可以查看运维信息;开启认证后,运维入口仅对有运维权限的管理员显示。
 此处用于观测和排查,不是启动、停止或扩缩容控制台。PD 模式的集群概览与节点层级见分布式补充。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--快捷键与画布操作>快捷键与画布操作</h2><p>顶部的快捷键帮助入口随时可查看按键说明。以下快捷键有不同的作用范围,输入框中不会触发全局 <code>?</code> 帮助。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>操作</th><th scope=col>按键或动作</th><th scope=col>生效位置</th></tr></thead><tbody><tr><td>打开 / 关闭快捷键说明</td><td><span class=td-kbd-sequence><kbd>?</kbd></span></td><td>输入框和编辑器之外</td></tr [...]
 不是所有查询的硬上限;<code>gremlin.vertex_degree_limit</code>(<code>100</code>)与 <code>gremlin.edges_total_limit</code>(<code>500</code>)限制展开规模。
-FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>不再需要示例时,在主仓库的 <code>docker/</code> 目录执行:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chr [...]
-若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>需要与 master 精确一致的产物时,使用 JDK 17 和 Maven 从 Toolchain 构建。
-Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不执行测试:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>git clone --branch master --single-branch https://github.com/apache/ [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
-</span></span><span class=line><span class=ln>3</span><span class=cl>mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-hubble
-</span></span><span class=line><span class=ln>5</span><span class=cl>mvn package -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -DskipTests -ntp
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>cd</span> apache-hugegraph-hubble-*
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 编辑 conf/hugegraph-hubble.properties,设置正确的 Server URL</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hubble.sh</span></span></code></pre></div></div></div><p>打包配置默认绑定本机 <code>localhost:8088</code>。<code>bin/stop-hubble.sh</code> 会先请求正常停机,超时后才强制终止。
+FILE 上传默认允许 <code>csv,txt</code>,单文件 1 GB、总量 10 GB;需要覆盖时修改 <code>upload_file.*</code> 配置。</p><h2 id=pg-55eecaa5c3ceec829e0f0d20863baa46--停止试用环境或从源码构建>停止试用环境或从源码构建</h2><p>清理测试环境时,在 <code>docker/</code> 目录下执行以下命令:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=ch [...]
+若想保留数据,下线时省略 <code>--volumes</code>,以后用同一项目名启动。</p><p>从当前 master 构建时,需要 <strong>JDK 17、Maven 3.9+、Python 3.9+、稳定版 Node.js 24(至少 24.22.0)</strong>,
+并通过 Corepack 使用仓库锁定的 <strong>pnpm 12.14.0</strong>。Maven 不再自动安装 Node/Yarn。</p><ol class=steps><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 构建说明</a>
+编译并安装 Server SDK 到独立 Maven 仓库。</p></li><li><p>按 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md>Hubble 源码构建步骤</a>
+安装 Python 依赖,再使用同一 Maven 仓库构建 Client、Loader 和 Hubble(跳过测试)。</p></li><li><p>进入构建生成的 <code>hugegraph-hubble/apache-hugegraph-hubble-*</code> 目录,配置 <code>conf/hugegraph-hubble.properties</code> 中的 Server 连接信息后启动:</p><div class="td-code td-code--untitled" id=td-code-cdca8595-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-cdca8595-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
 需要开发与测试说明时,参考 <a href=/cn/docs/guides/toolchain-local-test/>Toolchain 本地测试指南</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-91cea9e83b921f10aa1de60b138055b0>2 - 图可视化</h1><template data-hg-authored-content=start></template><p>Hubble 为 HugeGraph 提供图数据、Schema、查询和导入的 Web 界面。先从不依赖 PD 的单机组合入手,
 再按需要了解分布式集群的差异。</p><ul class=cards><li><a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机 RocksDB</a>:启动、示例图、建模、导入与查询。</li><li><a href=/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/>Hubble 与 HStore 分布式集群</a>:PD 发现、图空间与集群运维。</li></ul><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-33fca9af1c30d5ed43daaa61aa0928ea>2.1 - 使用 Hubble 管理 HStore 分布式集群</h1><div class=lead>连接 HStore 与 PD, [...]
 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 基础与单机指南</a>。
@@ -95,51 +89,108 @@ Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不
 配置 <code>.env</code> 并生成 Hubble 本地配置文件,然后在 <code>docker/</code> 目录下启动,无需自行维护部署文件。
 下文重点说明连接与运维配置要点,部署前请确保满足 README 中的 PD 凭据与前置依赖要求。
 Docker <code>latest</code> 为动态标签,配图用于定位界面,实际版本以部署镜像的 digest 及构建信息为准。
-不同版本可提供的指标和权限接口有所区别。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
-同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang [...]
+不同版本可提供的指标和权限接口有所区别。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
+同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|图 API| S[Server]
+    S --&gt;|读写图数据| T[Store]
+    H -.-&gt;|服务发现与集群信息| P[PD]
+    H -.-&gt;|节点指标| T</code></pre><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>脚本会读取 <code>.env</code> 中的 <code>HG_PD_AUTH_SECRET_KEY</code>,将其值作为 <code>operations.pd.password</code> 写入生成文件 <code>docker/conf/hubble/hstore.local.properties</code>。
 若需调整连接地址或运维参数,直接编辑该文件即可(请勿覆盖 Git 跟踪的 <code>.example</code> 模板文件),并确保 <code>operations.pd.password</code>
 与 PD 所用密钥一致。Compose 会将该文件只读挂载到容器内部,无需进入容器修改。
-该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
+该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
 <a href=/cn/docs/quickstart/hugegraph/hugegraph-hstore/>HStore 部署指南</a>;源码或二进制包启动的 Hubble 则编辑其
-<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址:</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
+<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
 发行包默认配置中显式设为 <code>pd.enabled=false</code>;若未配置该项,代码默认值为 <code>true</code>,因此单机与分布式部署均建议显式声明该配置。
-修改配置后:源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
-(沿用启动时的项目名及所有 <code>-f</code> 参数):</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
+修改配置后,源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
+(沿用启动时的项目名及所有 <code>-f</code> 参数)。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
 让各团队只看到并操作自己的图。进入图空间后,图的建模、导入和查询仍沿用基础指南的流程。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--创建与调整图空间>创建与调整图空间</h3><p>开启 Server 认证时,创建、编辑和删除图空间要求超级管理员权限。创建时先填写全局唯一的 GraphSpace 名称、
 可选的显示别名及最大图数;例如用 <code>research</code> 作 API 标识,用“研究图谱”作显示名。GraphSpace 名称创建后不可修改,
 别名和描述可随后调整,别名不参与 URL 或权限匹配。图空间管理员从已有账号中选择。</p><p>“高级部署与资源限制”包含图查询/写入服务、异步计算任务的 CPU 与内存上限,以及存储容量限制。
 这些部署配额不会显示实时资源用量,也不会自动扩容现有容器。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>高级部署的默认值</span></div><div class=td-callout__body><p>默认最大图数为 100;图服务与计算任务分别为 64 核、128 GB,存储上限为 1000000 GB。
 普通容器试用可保留默认值。Kubernetes 命名空间、Operator 和算法镜像仅在对应场景中填写。</p></div></div><p>选择图空间后,再进入其中的图。切换空间时应重新确认当前图,尤其是不同空间中存在同名图时。
-列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
+列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
 当一组业务图需要同样的顶点类型、边类型和索引时,可以先保存模板,再在创建图时选择它,减少重复建模。
-例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>用户模板与主篇的内置示例模板不同:内置模板用于快速体验预设模型,用户模板用于保存自己的模型并长期复用。
+例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>主篇的内置示例模板用于快速体验预设模型。用户模板用于保存自己的模型并长期复用。
 模板本身不等于导入数据;是否加载示例数据是创建图时的另一个选择。
 开启 Server 认证时,创建用户模板需要所在空间的写权限,更新或删除还要求模板所有者或相应管理权限。
 匿名模式不进行按用户的权限与模板所有者检查。
 单机模式不提供用户模板管理。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--给用户分配图空间权限>给用户分配图空间权限</h2><p>账号创建、登录和个人资料管理见<a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>基础指南</a>;
 分布式模式额外提供“管理 GraphSpace 成员”,在已有账号与指定空间之间分配权限。
-支持权限预设的 Server 提供以下常用选择:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
+支持权限预设的 Server 提供以下常用选择。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
 账号与空间成员分开管理,移除成员不会删除全局账号。创建账号后可以立即继续分配空间权限;调整已有成员时,确认当前空间及预设,保留其他空间仍需要的权限。
 仅启用 <code>pd.enabled</code> 不会授予权限,旧 Server 的自定义角色也不能直接当作这些预设处理。
-认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
+认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
 概览中的 PD Leader、在线 Store 数、图数、分区数、副本数和数据量,帮助判断当前连接的规模及哪些节点需要关注。
-分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点:<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
+分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点。<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
 <code>DOWN</code> 表示相应探测未成功。拓扑可用而指标部分缺失时,仍可能正常查询图。
-页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
+页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
 Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性检查;各版本可用的指标不同。</p><p>开启 Server 认证时,集群运维读取要求超级管理员(<code>ADMIN</code> 级别),空间管理员和普通成员不会因此获得集群读取权限。
 部署时使用容器隔离、可信 HTTPS 入口、Server 认证与网络白名单,避免直接公开 Hubble 和组件端口。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--配置运维访问>配置运维访问</h3><p>PD/Store 的运维凭据由 Hubble <strong>后端</strong>使用,与浏览器登录 Server 的账号分开。
 Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.local.properties</code>;其他部署修改 Hubble 包内配置文件。
-其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
-且需与 PD 返回的 Store 指标目标完全一致。注意:仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次排查:Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
-以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code>(当前版本为 <code>1.8.0</code>)为准。发布版和 Docker <code>latest</code> 可能与源码不同;使用时请核对版本,未发布的版本请按下文从源码构建。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader- [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。
-旧版 Server 保持下文说明的原有导入行为。</p></blockquote><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>2 获取 HugeGraph-Loader</h3><p>可以通过以下三种方式获取 HugeGraph-Loader:</p><ul><li>使用 Docker 镜像 (便于<strong>测试</strong>)</li><li>下载已编译的压缩包</li><li>克隆源码编译安装</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--21-使用-docker-镜像-便于测试>2.1 使用 Docker 镜像 (便于<strong>测试</strong>)</h4><p>我们可以使用 <code>docker run -itd --name loader hugegraph/loader:latest</code> 部署 loader 服务。对于需要加载的数据,则可以通过挂载 <code>-v /path/ [...]
+其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
+且需与 PD 返回的 Store 指标目标完全一致。仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次检查 Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
+以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-85740db4cef1a86c9bd97f4c81a4a701>3 - HugeGraph-Loader 快速上手</h1><template data-hg-authored-content=start></template><p>本文以 Toolchain <code>master</code> 分支(以 1.8 为基线,尚未正式发布)为准。发布版和 Docker <code>latest</code> 可能存在部分差异,使用未发布功能前请先核对版本。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--quick-local-file-import>快速上手:本地文件 [...]
+请先<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--2-获取-hugegraph-loader>安装 Loader</a> 并启动 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>HugeGraph Server</a>。
+以下命令均在 Loader 安装目录下执行,连接本地默认图 <code>hugegraph</code>。若 Server 已启用鉴权,在命令中追加 <code>--username</code> 与 <code>--password</code>(或 <code>--token</code>)。</p><ol class=steps><li><p><strong>创建数据文件</strong></p><p>两份 CSV 均不含表头,列名由下一步的映射文件指定。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-955f155a-fence-0-viewport data-td-code-viewport><div class=highlight><p [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>docs-smoke-alice,29
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>docs-smoke-bob,31
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>cat &gt; demo-loader/knows.csv <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=s>docs-smoke-alice,docs-smoke-bob
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>创建 Schema 和映射文件</strong></p><p>本例使用独立的 <code>docs_*</code> 名称,避免与内置的 <code>person</code> 数据冲突。
+映射文件中的路径相对于运行 Loader 时的工作目录。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=40><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;)
+</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>      .primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>schema.edgeLabel(&#34;docs_smoke_knows&#34;).sourceLabel(&#34;docs_smoke_person&#34;)
+</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=s>      .targetLabel(&#34;docs_smoke_person&#34;).ifNotExist().create()
+</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=s>EOF</span>
+</span></span><span class=line><span class=ln> 9</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
+</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>{
+</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
+</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>  &#34;structs&#34;: [
+</span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
+</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
+</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
+</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>      &#34;vertices&#34;: [{&#34;label&#34;: &#34;docs_smoke_person&#34;}]
+</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>    },
+</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>    {
+</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>      &#34;id&#34;: &#34;knows&#34;,
+</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      &#34;input&#34;: {
+</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
+</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/knows.csv&#34;,
+</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
+</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;source_name&#34;, &#34;target_name&#34;]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>      },
+</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>      &#34;edges&#34;: [{
+</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>        &#34;label&#34;: &#34;docs_smoke_knows&#34;,
+</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>        &#34;source&#34;: [&#34;source_name&#34;],
+</span></span></span><span class=line><span class=ln>34</span><span class=cl><span class=s>        &#34;target&#34;: [&#34;target_name&#34;],
+</span></span></span><span class=line><span class=ln>35</span><span class=cl><span class=s>        &#34;field_mapping&#34;: {&#34;source_name&#34;: &#34;docs_name&#34;, &#34;target_name&#34;: &#34;docs_name&#34;}
+</span></span></span><span class=line><span class=ln>36</span><span class=cl><span class=s>      }]
+</span></span></span><span class=line><span class=ln>37</span><span class=cl><span class=s>    }
+</span></span></span><span class=line><span class=ln>38</span><span class=cl><span class=s>  ]
+</span></span></span><span class=line><span class=ln>39</span><span class=cl><span class=s>}
+</span></span></span><span class=line><span class=ln>40</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div></li><li><p><strong>执行导入</strong></p><p>保持在同一工作目录。Server 运行在其他地址时,修改主机和端口。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>首次成功导入后,统计应显示两个顶点、一条边。检查汇总中的成功数和失败数。</p></li><li><p><strong>在 Hubble 中查询结果</strong></p><p>将 Hubble 连接到同一个 Server 和图,在 Gremlin 工作台分别执行以下查询。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-3 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class=td-code__viewport  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>().</span><span class=na>has</span><span class=o>(</span><span class=s1>&#39;docs_smoke_person&#39;</span><span class=o>,</span> <span class=s1>&#39;docs_name&#39;</span><span class=o>,</span> <span class=s1>&#39;docs-smoke-alice&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl> <span class=o>.</span><span class=na>out</span><span class=o>(</span><span class=s1>&#39;docs_smoke_knows&#39;</span><span class=o>).</span><span class=na>values</span><span class=o>(</span><span class=s1>&#39;docs_name&#39;</span><span class=o>)</span></span></span></code></pre></div></div></div><p>第一条查询返回 Alice 的年龄 <code>29</code>、Bob 的年龄 <code>31</code>,第二条返回 <code>docs-smoke-bob</code>。</p></li></ol><p>导入其他数据源时,继续阅 [...]
+<a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>内置完整示例</a>还包含软件顶点和边属性。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--1-hugegraph-loader-概述>1 HugeGraph-Loader 概述</h3><p>HugeGraph-Loader 是 HugeGraph 的数据导入组件,能够将多种数据源的数据转化为图的顶点和边并批量导入到图数据库中。</p><p>目前支持的数据源包括:</p><ul><li>本地磁盘文件或目录,支持 TEXT、CSV 和 JSON 格式的文件,支持压缩文件</li><li>HDFS 文件或目录,支持压缩文件</li><li>主流关系型数据库,如 MySQL、PostgreSQL、Oracle、SQL Server</li><li>Kafka topic</li><li>已有的 HugeGraph 图,用于把数据从一个图复制到另一个图</li></ul><p>本地磁盘文件和 HDFS 文件支持断点续传。</ [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=w>
 </span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
 </span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
@@ -154,9 +205,12 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>13</span><span class=cl><span class=w>    </span><span class=c># mount your own data here</span><span class=w>
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=w>    </span><span class=c># volumes:</span><span class=w>
 </span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=w>      </span><span class=c># - /path/to/data/file:/loader/file</span></span></span></code></pre></div></div></div><p>具体的数据导入流程可以参考 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</a></p><blockquote><p>注意:</p><ol><li><p>hugegraph-loader 的 docker 镜像是一个便捷版本,用于快速启动 loader,并不是<strong>官方发布物料包方式</strong>。你可以从 <a href=https://infra.apache.org/release-distribution.html#dockerh [...]
-发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>克隆 <code>master</code> 分支:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash>< [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn clean package -pl hugegraph-loader -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
-启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>使用 HugeGraph-Loader 的基本流程分为以下几步:</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>这一步是建模的过程,用户需要对自己已有的数据和想要创建的图模型有一个清晰的构想,然后编写 schema 建立图模型。</p><p>比如想创建一个拥有两类顶点及两类边的图,顶点是"人"和"软件",边是"人认识人"和"人创造软件",并且这些顶点和边都带有一些属性,比如顶点"人"有:&ldquo;姓名&rdquo;、&ldquo;年龄"等属性, &ldquo;软件"有:&ldquo;名 [...]
+发布包不一定包含 <code>master</code> 的全部功能;需要本文对应实现时,使用下一节的源码构建方式。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--23-克隆源码编译安装>2.3 克隆源码编译安装</h4><p>从 master 分支编译 Loader 需要 Java 17、Maven 3.6.3+ 与 Python 3.9+。直接克隆仓库并编译:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-loader/apache-hugegraph-loader-*</span></span></code></pre></div></div></div><p>如需搭配开发阶段的 Server master SDK 编译,可参阅 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p><p>如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 <code>lib/</code> 目录。
+启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。</p><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3-使用流程>3 使用流程</h3><p>导入数据前先准备图模型、数据文件和映射文件,再运行 Loader。</p><ul><li>编写图模型</li><li>准备数据文件</li><li>编写输入源映射文件</li><li>执行命令导入</li></ul><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--31-编写图模型>3.1 编写图模型</h4><p>先确定数据对应的顶点类型、边类型和属性,再编写 Schema。</p><p>以下示例包含 <code>person</code> 和 <code>software</code> 两类顶点,以及 <code>knows</code> 和 <code>created</code> 两类边。
+人有姓名、年龄和城市,软件有名称和价格,两类边都记录日期。</p><div style=text-align:center><img src=/docs/images/demo-graph-model.png alt=由“认识”和“创建”边连接人物与软件顶点的示例图><p>示例图模型</p></div><p>将 Schema 定义保存到 <code>schema.groovy</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=16><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code  [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;name&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -171,19 +225,21 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=c1>// 创建 knows 边类型,这类边是从 person 指向 person 的
 </span></span></span><span class=line><span class=ln>14</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>proper [...]
 </span></span><span class=line><span class=ln>15</span><span class=cl><span class=c1>// 创建 created 边类型,这类边是从 person 指向 software 的
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
+</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>edgeLabel</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>sourceLabel</span><span class=o>(</span><span class=s2>&#34;person&#34;</span><span class=o>).</span><span class=na>targetLabel</span><span class=o>(</span><span class=s2>&#34;software&#34;</span><span class=o>).</span><span class=na>if [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-5 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-6 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln> [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>如果在建模(schema)时指定 person 或 software 的 id 策略是 PRIMARY_KEY,选择以 name 作为 primary keys(注意:这是 hugegraph 中 vertexlabel 的概念),在导入边数据时,由于需要拼接出源顶点和目标顶点的 id,必须拿着 p_id/s_id 去 person/software 表中查到对应的 name,这种需要做额外查询的表结构的情况,loader 暂时是不支持的。这时可以采用以下两种方式替代:</p><ol><li>仍然指定 person 和 software 的 id 策略为 PRIMARY_KEY,但是以 person 表和 software 表的 id 列作为顶点的主键属性,这样导入边时直接使用 p_id 和 s [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-11-v [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>CSV 是分隔符为逗号<code>,</code>的 TEXT 文件,当列值本身包含逗号时,该列值需要用双引号包起来,如:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-8 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cl [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>&#34;li,nary&#34;,26,&#34;Wu,han&#34;</span></span></code></pre></div></div></div><p>JSON 文件要求每一行都是一个 JSON 串,且每行的格式需保持一致。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-9 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=lang [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+需要关联数据时,先在数据源侧准备好查询结果。</p><p>以下以 <code>person</code>、<code>software</code>、<code>created</code> 三张表为例。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-10 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>// person 表结构
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | age | city </span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-11 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=l [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | name | lang | price</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class= [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>id | p_id | s_id | date</span></span></code></pre></div></div></div><p>若 <code>person</code> 和 <code>software</code> 使用 <code>PRIMARY_KEY</code> 策略,以 <code>name</code> 为主键,导入边时就需要两个端点的 <code>name</code>。
+<code>created</code> 表只有 <code>p_id</code> 和 <code>s_id</code>,Loader 不会用它们回查名称。可以改用以下两种 ID 设计。</p><ol><li>保留 <code>PRIMARY_KEY</code> 策略,将两张顶点表的 <code>id</code> 列作为主键属性。Loader 可用 <code>p_id</code>、<code>s_id</code> 和顶点标签生成端点 ID。</li><li>使用自定义 ID 策略,将两张顶点表的 <code>id</code> 列直接作为顶点 ID,导入边时直接使用 <code>p_id</code> 和 <code>s_id</code>。</li></ol><p>这两种设计都让边数据直接提供端点 ID,省去回查。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--322-准备顶点和边数据>3.2.2 准备顶点和边数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Jerry</span><span class=p>,</span><span class=s>36</span><span class=p>,</span><span class=s>Shanghai</span></span></span></code></pre></div></div></div><ul><li>software 顶点数据(数据本身包含 header)</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-14 data-td-code data-td-code-auto-id data-td-language=csv data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-14-v [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>Photoshop</span><span class=p>,</span><span class=s>999</span><span class=p>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-12 data-td-code data-td-code-auto-id data-td-languag [...]
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>Office</span><span class=p>,</span><span class=s>388</span></span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--3222-边数据>3.2.2.2 边数据</h6><p>边数据文件由一行一行的数据组成,一般每一行作为一条边,其中有部分列会作为源顶点和目标顶点的 id,其他列作为边属性。下面以 JSON 格式作为示例进行说明。</p><ul><li>knows 边数据</li></ul><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-code data-td-code-auto-id data-td-languag [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Tom&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Jerry&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;Office&#34;</span><span class=p>}</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--33-编写数据源映射文件>3.3 编写数据源映射文件</h4><h5 id=pg-85740db4cef1a86c9bd [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -200,7 +256,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>15</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>16</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>17</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-15 data-td-c [...]
+</span></span><span class=line><span class=ln>18</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>这里直接给出两个版本的映射文件(描述了上面图模型和数据文件)</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 2.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-18 data-td-c [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  <span class=nt>&#34;version&#34;</span><span class=p>:</span> <span class=s2>&#34;2.0&#34;</span><span class=p>,</span>
 </span></span><span class=line><span class=ln>  3</span><span class=cl>  <span class=nt>&#34;structs&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln>  4</span><span class=cl>    <span class=p>{</span>
@@ -398,7 +454,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>196</span><span class=cl>      <span class=p>]</span>
 </span></span><span class=line><span class=ln>197</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>198</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-16 data-td-code data-td-code-auto-id data-td-lan [...]
+</span></span><span class=line><span class=ln>199</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 1.0 版本的映射文件</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code-955f155a-fence-19 data-td-code data-td-code-auto-id data-td-lan [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -449,7 +505,7 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span><span class=line><span class=ln>49</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>50</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>51</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
+</span></span><span class=line><span class=ln>52</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><br><p>映射文件 1.0 版本是以顶点和边为中心,设置输入源;而 2.0 版本是以输入源为中心,设置顶点和边映射。有些输入源(比如一个文件)既能生成顶点,也能生成边,如果用 1.0 版的格式写,就需要在 vertex 和 edge 映射块中各写一次 input 块,这两次的 input 块是完全一样的;而 2.0 版本只需要写一次 input。所以 2.0 版相比于 1.0 版,能省掉一些 input 的重复书写。</p><p>在 hugegraph-loader-{version} 的 bin 目录下,有一个脚本工具 <code>mapping-convert.sh</code> 能直接将 1.0 版本的映射文件转换为 2.0 版本的,使用方式如下:</p><div c [...]
 </span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>    <span class=p>{</span>
@@ -478,8 +534,8 @@ Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.loc
 </span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=err>&#39;a</span> <span class=err>b</span> <span class=err>c</span> <span class=err>d&#39;</span>   
 </span></span><span class=line><span class=ln>28</span><span class=cl>
 </span></span><span class=line><span class=ln>29</span><span class=cl><span class=c1>// 如果没有更新策略,则会得到
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-22 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-22-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
+</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=err>&#39;</span><span class=kc>null</span> <span class=kc>null</span> <span class=err>c</span> <span class=err>d&#39;</span></span></span></code></pre></div></div></div><blockquote><p><strong>注意</strong> : 采用了批量更新的策略后, 磁盘读请求数会大幅上升, 导入速度相比纯写覆盖会慢数倍 (此时HDD磁盘<a href=https://en.wikipedia.org/wiki/IOPS>IOPS</a>会成为瓶颈, 建议采用SSD以保证速度)</p></blockquote><p><strong>顶点映射的特有节点</strong></p><ul><li>id: 指定某一列作为顶点的 id 列 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>struct.json</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-25-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><s [...]
 若参数文件包含凭据,使用 <code>chmod 0600 loader.args</code> 把权限限制为 <code>0600</code>;<code>@file</code> 调用让这些值不出现在进程参数中。
 Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 从只读 Kubernetes ConfigMap 挂载映射文件时,先把映射复制到可写卷中再运行 Loader。</p><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--342-断点续导模式>3.4.2 断点续导模式</h5><p>通常情况下,Loader 任务都需要较长时间执行,如果因为某些原因导致导入中断进程退出,而下次希望能从中断的点继续导,这就是使用断点续导的场景。</p><p>设置 <code>--incremental-mode</code> 为 <code>true</code> 即可从进度文件续导。Loader 在导入成功或正常停止后关闭时写入进度;意外失败可能阻止该写入。
@@ -490,43 +546,8 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 失败文件中,用户对失败文件中的数据行修改后,设置 &ndash;failure-mode 为 true 即可把这些"失败文件"也当作输入源进行导入(不影响正常的文件的导入),
 当然如果修改后的数据行仍然有问题,则会被再次记录到失败文件中(不用担心会有重复行,关闭文件时会去重)。失败模式下上述三个错误上限会被解除,因此会扫描整个失败文件。</p><p>每个输入源(即映射文件 <code>structs</code> 中的每一项)都会有自己的失败文件,文件名为该输入源的 <code>id</code> 加后缀 <code>.error</code>,保存在 <code>${struct}/failure-data</code> 目录下。
 每一条失败记录写为两行:一行以 <code>#### READ ERROR:</code>、<code>#### PARSE ERROR:</code> 或 <code>#### INSERT ERROR:</code> 开头的提示行,紧接着是原始数据行。当输入源有 header 时,header 会以 JSON 形式写入同目录下的 <code>${id}.header</code> 文件,以便失败文件能按正确的列重新读取。
-比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
-</span></span><span class=line><span class=ln> 2</span><span class=cl>
-</span></span><span class=line><span class=ln> 3</span><span class=cl>cat &gt; demo-loader/people.csv <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=s>docs-smoke-alice,29
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=s>docs-smoke-bob,31
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln> 7</span><span class=cl>
-</span></span><span class=line><span class=ln> 8</span><span class=cl>cat &gt; demo-loader/schema.groovy <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_name&#34;).asText().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>10</span><span class=cl><span class=s>schema.propertyKey(&#34;docs_age&#34;).asInt().ifNotExist().create()
-</span></span></span><span class=line><span class=ln>11</span><span class=cl><span class=s>schema.vertexLabel(&#34;docs_smoke_person&#34;).properties(&#34;docs_name&#34;, &#34;docs_age&#34;).primaryKeys(&#34;docs_name&#34;).ifNotExist().create()
-</span></span></span><span class=line><span class=ln>12</span><span class=cl><span class=s>EOF</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>
-</span></span><span class=line><span class=ln>14</span><span class=cl>cat &gt; demo-loader/struct.json <span class=s>&lt;&lt;&#39;EOF&#39;
-</span></span></span><span class=line><span class=ln>15</span><span class=cl><span class=s>{
-</span></span></span><span class=line><span class=ln>16</span><span class=cl><span class=s>  &#34;version&#34;: &#34;2.0&#34;,
-</span></span></span><span class=line><span class=ln>17</span><span class=cl><span class=s>  &#34;structs&#34;: [
-</span></span></span><span class=line><span class=ln>18</span><span class=cl><span class=s>    {
-</span></span></span><span class=line><span class=ln>19</span><span class=cl><span class=s>      &#34;id&#34;: &#34;people&#34;,
-</span></span></span><span class=line><span class=ln>20</span><span class=cl><span class=s>      &#34;input&#34;: {
-</span></span></span><span class=line><span class=ln>21</span><span class=cl><span class=s>        &#34;type&#34;: &#34;FILE&#34;,
-</span></span></span><span class=line><span class=ln>22</span><span class=cl><span class=s>        &#34;path&#34;: &#34;demo-loader/people.csv&#34;,
-</span></span></span><span class=line><span class=ln>23</span><span class=cl><span class=s>        &#34;format&#34;: &#34;CSV&#34;,
-</span></span></span><span class=line><span class=ln>24</span><span class=cl><span class=s>        &#34;header&#34;: [&#34;docs_name&#34;, &#34;docs_age&#34;]
-</span></span></span><span class=line><span class=ln>25</span><span class=cl><span class=s>      },
-</span></span></span><span class=line><span class=ln>26</span><span class=cl><span class=s>      &#34;vertices&#34;: [
-</span></span></span><span class=line><span class=ln>27</span><span class=cl><span class=s>        {&#34;label&#34;: &#34;docs_smoke_person&#34;}
-</span></span></span><span class=line><span class=ln>28</span><span class=cl><span class=s>      ],
-</span></span></span><span class=line><span class=ln>29</span><span class=cl><span class=s>      &#34;edges&#34;: []
-</span></span></span><span class=line><span class=ln>30</span><span class=cl><span class=s>    }
-</span></span></span><span class=line><span class=ln>31</span><span class=cl><span class=s>  ]
-</span></span></span><span class=line><span class=ln>32</span><span class=cl><span class=s>}
-</span></span></span><span class=line><span class=ln>33</span><span class=cl><span class=s>EOF</span></span></span></code></pre></div></div></div><p><code>people.csv</code> 没有表头行,列名由映射文件的 <code>header</code> 提供。映射文件中的本地路径相对于运行命令时的工作目录。仍在 Loader 安装目录中执行导入;如果 Server 在其他容器中,请把 <code>--host</code> 改为 Loader 能访问到的 Server 地址。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-25 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__vi [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --graphspace DEFAULT --graph hugegraph <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file demo-loader/struct.json --schema demo-loader/schema.groovy <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span></span></span></code></pre></div></div></div><p>本例用独立的 <code>docs_smoke_person</code> 标签和 <code>docs_*</code> 属性,避免与预置的 <code>person</code> 样例数据冲突。成功时统计中应显示顶点写入成功数为 <code>2</code>、边写入成功数为 <code>0</code>。也可以在 Hubble 的 Gremlin 工作台查询 <code>g.V().hasLabel('docs_smoke_person').values('docs_name')</code>,结果应包含 <code>docs-smoke-alice</code> 和 <code>docs-smoke-bob</code> [...]
-(需配合返回 <code>protocol: 1</code> 的新版 Server 与对应 Loader;当前 <code>master</code> 分支暂未包含该协议)。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
+比如映射文件中 id 为 <code>1</code> 的输入源包含顶点映射 person,id 为 <code>3</code> 的输入源包含边映射 knows,它们各有一些错误行,当 Loader 退出后,在 <code>${struct}/failure-data</code> 目录下会看到如下文件:</p><ul><li>1.error: 输入源 1 的失败数据行,每行前面都有对应的提示行</li><li>1.header: 输入源 1 的 header,仅当该输入源有 header 时才会生成</li><li>3.error: 输入源 3 的失败数据行</li><li>3.header: 输入源 3 的 header</li></ul><blockquote><p>内容为空的 <code>.error</code> 文件会在 Loader 退出时删除,因此只有真正出现失败行的输入源才会留下文件。增量模式下新的失败行会追加到已有文件,其他模式下该文件会被重新写入。</p></blockquote><h5 id=pg-85740db4cef1a86c9bd97f4 [...]
+若部署的 Server 提供该接口并返回 <code>protocol: 1</code>,Loader 会自动启用所有权保护;已发布的 Server 1.7.0 及更早版本则继续使用原有模式切换流程。</p><pre class=td-mermaid-source><code class=language-mermaid>graph TD
     A[&#34;图模式 NONE&#34;] --&gt;|首个 Loader 申请所有权| B[&#34;进入 LOADING 模式 (分配 token)&#34;]
     B --&gt;|其他并发 Loader 加入| B
     B --&gt;|部分 Loader 导入完成释放| B
@@ -539,18 +560,18 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 权限、网络、图不存在或无效响应错误不会触发回退。</li><li><strong>恢复与图源导入</strong>:保留 <code>RESTORING</code> 模式,不探测 owner 且不自动重置。恢复导入完成后须手动将图模式设回 <code>NONE</code>,否则后续普通导入无法获取首个所有权。
 在活跃 owner 存在期间,请勿运行恢复导入、图源导入、Spark connector 或旧版 Loader 导入。</li><li><strong>作用范围与生命周期</strong>:所有权属于直连 Server 实例,不跨节点同步;owner 无自动租期过期机制。
 对于嵌入式程序集成,调用方必须调用 <code>HugeGraphLoader.shutdown()</code> 执行单次句柄释放;若释放失败,不会自动重试;
-该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
+该 owner 可能会在 Server 端保持活跃,此时可能需要通过上述管理员恢复流程处理。</li></ul></div></div><h3 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4-完整示例>4 完整示例</h3><p>下面给出的是 hugegraph-loader 包中 example 目录下的例子。(<a href=https://github.com/apache/hugegraph-toolchain/tree/master/hugegraph-loader/assembly/static/example/file>GitHub 地址</a>)</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--41-准备数据>4.1 准备数据</h4><p>顶点文件:<code>example/file/vertex_person.csv</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-2 [...]
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>vadas</span><span class=p>,</span><span class=s>27</span><span class=p>,</span><span class=s>Hongkong</span><span class=p>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=s>josh</span><span class=p>,</span><span class=s>32</span><span class=p>,</span><span class=s>Beijing</span><span class=p>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=s>peter</span><span class=p>,</span><span class=s>35</span><span class=p>,</span><span class=s>Shanghai</span><span class=p>
 </span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=s2>&#34;li,nary&#34;</span><span class=p>,</span><span class=s>26</span><span class=p>,</span><span class=s2>&#34;Wu,han&#34;</span><span class=p>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-28 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=s>tom</span><span class=p>,</span><span class=s>null</span><span class=p>,</span><span class=s>NULL</span></span></span></code></pre></div></div></div><p>顶点文件:<code>example/file/vertex_software.txt</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fe [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>1|lop|java|328|ISBN978-7-107-18618-5
-</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-29 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-29-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>2|ripple|java|199|ISBN978-7-100-13678-5</span></span></code></pre></div></div></div><p>边文件:<code>example/file/edge_knows.json</code></p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-30 data-td-code data-td-code-auto-id data-td-language=json data-td-line-count=2><div class=td-code__viewport id=td-code-955f155a-fence-30-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><co [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;marko&#34;</span><span class=p>,</span> <span class=nt>&#34;target_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;20130220&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&# [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2009-11-11&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;josh&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>2</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-12-10&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><spa [...]
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=p>{</span><span class=nt>&#34;source_name&#34;</span><span class=p>:</span> <span class=s2>&#34;peter&#34;</span><span class=p>,</span> <span class=nt>&#34;target_id&#34;</span><span class=p>:</span> <span class=mi>1</span><span class=p>,</span> <span class=nt>&#34;date&#34;</span><span class=p>:</span> <span class=s2>&#34;2017-03-24&#34;</span><span class=p>,</span> <span class=nt>&#34;weight&#34;</span><sp [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;age&#34;</span><span class=o>).</span><span class=na>asInt</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;city&#34;</span><span class=o>).</span><span class=na>asText</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>propertyKey</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>asDouble</span><span class=o>().</span><span class=na>ifNotExist</span><span class=o>().</span><span class=na>create</span><span class=o>();</span>
@@ -573,7 +594,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>21</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;createdByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;created&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span  [...]
 </span></span><span class=line><span class=ln>22</span><span class=cl><span class=n>schema</span><span class=o>.</span><span class=na>indexLabel</span><span class=o>(</span><span class=s2>&#34;knowsByWeight&#34;</span><span class=o>).</span><span class=na>onE</span><span class=o>(</span><span class=s2>&#34;knows&#34;</span><span class=o>).</span><span class=na>by</span><span class=o>(</span><span class=s2>&#34;weight&#34;</span><span class=o>).</span><span class=na>range</span><span clas [...]
 <code>software</code> 使用自定义数值 ID,映射中的 <code>id</code> 和 <code>created.target_id</code> 分别对应顶点 ID 及边的目标 ID。
-请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
+请在未包含同名 Schema 的空图中执行,避免 <code>ifNotExist()</code> 保留已有的不兼容定义。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--43-编写输入源映射文件examplefilestructjson>4.3 编写输入源映射文件<code>example/file/struct.json</code></h4><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>点击展开/折叠 源映射文件 example/file/struct.json</span></div><div class=td-callout__body><div class="td-code td-code--untitled" id=td-code [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  <span class=nt>&#34;vertices&#34;</span><span class=p>:</span> <span class=p>[</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>    <span class=p>{</span>
 </span></span><span class=line><span class=ln> 4</span><span class=cl>      <span class=nt>&#34;label&#34;</span><span class=p>:</span> <span class=s2>&#34;person&#34;</span><span class=p>,</span>
@@ -633,7 +654,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>58</span><span class=cl>      <span class=p>}</span>
 </span></span><span class=line><span class=ln>59</span><span class=cl>    <span class=p>}</span>
 </span></span><span class=line><span class=ln>60</span><span class=cl>  <span class=p>]</span>
-</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-33 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-33-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
+</span></span><span class=line><span class=ln>61</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--44-执行命令导入>4.4 执行命令导入</h4><div class="td-code td-code--untitled" id=td-code-955f155a-fence-34 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-955f155a-fence-34-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 cla [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 3</span><span class=cl>count metrics
 </span></span><span class=line><span class=ln> 4</span><span class=cl>     input <span class=nb>read</span> success            : <span class=m>14</span>
@@ -645,7 +666,7 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>10</span><span class=cl>     edge parse success            : <span class=m>6</span>
 </span></span><span class=line><span class=ln>11</span><span class=cl>     edge parse failure            : <span class=m>0</span>
 </span></span><span class=line><span class=ln>12</span><span class=cl>     edge insert success           : <span class=m>6</span>
-</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
+</span></span><span class=line><span class=ln>13</span><span class=cl>     edge insert failure           : <span class=m>0</span></span></span></code></pre></div></div></div><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--45-使用-docker-导入>4.5 使用 docker 导入</h4><h5 id=pg-85740db4cef1a86c9bd97f4c81a4a701--451-使用-docker-exec-直接导入数据>4.5.1 使用 docker exec 直接导入数据</h5><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4511-数据准备>4.5.1.1 数据准备</h6><p>如果仅仅尝试使用 loader, 我们可以使用内置的 example 数据集进行导入,无需自己额外准备数据</p><p>如 [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>hugegraph-dataset
 </span></span><span class=line><span class=ln>4</span><span class=cl>├── hugegraph-dataset/edge_created.json
@@ -653,11 +674,11 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>6</span><span class=cl>├── hugegraph-dataset/schema.groovy
 </span></span><span class=line><span class=ln>7</span><span class=cl>├── hugegraph-dataset/struct.json
 </span></span><span class=line><span class=ln>8</span><span class=cl>├── hugegraph-dataset/vertex_person.csv
-</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-36 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-36-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl>└── hugegraph-dataset/vertex_software.txt</span></span></code></pre></div></div></div><p>将文件复制到容器内部</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-37 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-37-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>docker <span class=nb>exec</span> -it loader ls /loader/dataset
 </span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
-只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-39 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl>edge_created.json  edge_knows.json  schema.groovy  struct.json  vertex_person.csv  vertex_software.txt</span></span></code></pre></div></div></div><h6 id=pg-85740db4cef1a86c9bd97f4c81a4a701--4512-数据导入>4.5.1.2 数据导入</h6><p>以内置的 example 数据集为例,我们可以使用以下的命令对数据进行导入。</p><p>如果需要导入自己准备的数据集,则只需要修改 <code>-f</code> 配置脚本的路径 以及 <code>-s</code> schema 文件路径即可。</p><p>其他的参数可以参照 <a href=#pg-85740db4cef1a86c9bd97f4c81a4a701--341-参数说明>3.4.1  [...]
+只修改 <code>-f</code> 和 <code>-s</code> 不会改变数据文件的解析路径。</p><blockquote><p>如果 <code>loader</code> 和 <code>server</code>位于同一 docker 网络,则可以指定 <code>-h {server_container_name}</code>, 否则需要指定 <code>server</code>的宿主机的 ip (在我们的例子中, <code>server_container_name</code> 为 <code>server</code>).</p></blockquote><p>然后我们可以观察到结果:</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=23><div class=td-code__viewport i [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>vertices/edges loaded this <span class=nb>time</span> : 8/6
 </span></span><span class=line><span class=ln> 3</span><span class=cl>--------------------------------------------------
 </span></span><span class=line><span class=ln> 4</span><span class=cl>count metrics
@@ -679,17 +700,29 @@ Loader 必须能够创建并写入以映射文件前缀命名的进度目录。
 </span></span><span class=line><span class=ln>20</span><span class=cl>    vertex load <span class=nb>time</span>              : 0.077s              
 </span></span><span class=line><span class=ln>21</span><span class=cl>    vertex load rate<span class=o>(</span>vertices/s<span class=o>)</span>  : <span class=m>103</span>                 
 </span></span><span class=line><span class=ln>22</span><span class=cl>    edge load <span class=nb>time</span>                : 0.112s              
-</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-40 data-td-code data-td-code-auto- [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--deploy-mode cluster --name spark-hugegraph-loader --file ./hugegraph.json <span class=se>\
-</span></span></span><span class=line><span class=ln>3</span><span class=cl>--username admin --token admin --host xx.xx.xx.xx --port <span class=m>8093</span> <span class=se>\
-</span></span></span><span class=line><span class=ln>4</span><span class=cl>--graph graph-test --num-executors <span class=m>6</span> --executor-cores <span class=m>16</span> --executor-memory 15g</span></span></code></pre></div></div></div><p><code>bin/hugegraph-spark-loader.sh</code> 通过 <code>${SPARK_HOME}/bin/spark-submit</code> 提交 <code>org.apache.hugegraph.loader.spark.HugeGraphSparkLoader</code>,因此 <code>SPARK_HOME</code> 必须指向一个 Spark 安装目录。<code>lib/</code> 下的所有 jar 都会加入 classpath。 [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>--trust-store-file --trust-store-password --clear-all-data --clear-timeout
-</span></span><span class=line><span class=ln>3</span><span class=cl>--incremental-mode --failure-mode --batch-insert-threads --single-insert-threads
-</span></span><span class=line><span class=ln>4</span><span class=cl>--max-conn --max-conn-per-route --batch-size --max-parse-errors --max-insert-errors
-</span></span><span class=line><span class=ln>5</span><span class=cl>--timeout --shutdown-timeout --retry-times --retry-interval --check-vertex
-</span></span><span class=line><span class=ln>6</span><span class=cl>--print-progress --dry-run --sink-type --vertex-partitions --edge-partitions --help</span></span></code></pre></div></div></div><p><code>--file</code> 单独处理:使用 <code>--deploy-mode cluster</code> 时,映射文件会通过 <code>--files</code> 分发到 executor,loader 只收到它的文件名;其他情况下路径原样传入。</p><p>该模式下 loader 只读取 FILE、HDFS 和 JDBC 输入源,KAFKA 和 GRAPH 输入源会被拒绝。</p><p>默认情况下(<code>--sink-type true</code>),每个 Spark 分区各自创建一个 HugeClient,通过 HugeGraph serve [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl>--host xx.xx.xx.xx --port <span class=m>8080</span> --graph hugegraph --username admin --token admin</span></span></code></pre></div></div></div><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loader; [...]
+</span></span><span class=line><span class=ln>23</span><span class=cl>    edge load rate<span class=o>(</span>edges/s<span class=o>)</span>       : <span class=m>53</span>   </span></span></code></pre></div></div></div><p>也可以使用 <code>curl</code> 或者 <code>hubble</code>观察导入结果,此处以 <code>curl</code> 为例:</p><p>以下使用支持 GraphSpace 的 Server API;旧版 Server 的路径需去掉 <code>/graphspaces/DEFAULT</code>。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-41 data-td-code data-td-code-auto- [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=o>{</span><span class=s2>&#34;vertices&#34;</span>:<span class=o>[{</span><span class=s2>&#34;id&#34;</span>:1,<span class=s2>&#34;label&#34;</span>:<span class=s2>&#34;software&#34;</span>,<span class=s2>&#34;type&#34;</span>:<span class=s2>&#34;vertex&#34;</span>,<span class=s2>&#34;properties&#34;</span>:<span class=o>{</span><span class=s2>&#34;name&#34;</span>:<span class=s2>&#34;lop&#34;</span>,<span c [...]
+POM 中的 Spark <code>3.2.2</code> 只提供编译期 API,不是运行引擎。设置 <code>SPARK_HOME</code> 和 <code>JAVA_HOME</code>,
+再使用发行目录中的启动脚本和 shaded Loader JAR。</p><p>先创建 Schema,确保 executor 可以读取数据文件。CSV、TEXT 数据须使用 UTF-8、去掉表头行,并在映射中显式指定 <code>header</code>。
+其他字符集和 <code>has_header: true</code> 会被拒绝。边依赖已有顶点时,先导入顶点。将以下路径替换为准备好的顶点映射文件。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-43 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-955f155a-fence-43-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-spark-loader.sh <s [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --master <span class=s1>&#39;local[2]&#39;</span> --driver-memory 1g <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --file /path/to/vertex-mapping.json <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --host 127.0.0.1 --port <span class=m>8080</span> --graph hugegraph --sink-type true</span></span></code></pre></div></div></div><p>启动脚本可同时接收 <code>--master</code>、<code>--conf</code>、<code>--jars</code> 等 Spark 参数和 Loader 参数。
+额外的 JDBC 驱动需通过 <code>--jars</code> 传入,仅放在 <code>lib/</code> 中不会分发到 executor。
+导入后查询目标图,核对数量和属性;API 写入路径的插入计数器不统计分布式写入。</p><p>该路径拒绝 <code>--incremental-mode true</code> 和 <code>--failure-mode true</code>。Standalone Spark 仅支持 client 部署模式。
+Spark 3.5.8 / Java 17 不支持 HBase bulkload(<code>--sink-type false</code>)。已有 bulkload 部署建议继续沿用原环境验证通过的
+Loader 发布包及其相关依赖。更多细节见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/spark-java17.md>Spark 迁移说明</a>。</p><h4 id=pg-85740db4cef1a86c9bd97f4c81a4a701--47-使用-flink-cdc-loader-导入>4.7 使用 flink-cdc-loader 导入</h4><p>当前 master 分支适配 Flink <code>2.2.1</code>、MySQL CDC <code>3.6.0-2.2</code> 和 Java 17。
+此前使用 Flink 1.13.5、CDC 2.2.1 的示例属于旧实现。
+设置 <code>FLINK_HOME</code>,确保提交进程、JobManager 和 TaskManager 都使用 Java 17。
+保留 Flink 的模块访问参数,发行目录的 <code>lib/</code> 中须恰好有一个 shaded Loader JAR。</p><p>每个映射都需使用 MySQL JDBC 输入,包含 <code>url</code>、<code>database</code>、<code>table</code>、<code>username</code> 和 <code>password</code>。
+MySQL 须配置 <code>binlog_row_image=FULL</code>。UPDATE 事件需要显式指定非空的 <code>update_strategies</code>,且图元素标识保持不变。
+顶点 ID、边端点或排序键变化时,任务会拒绝更新。CDC 也会拒绝 <code>--dry-run true</code> 和 <code>--use-prefilter true</code>。</p><p>不带分隔符时,所有参数均交给 Loader。需要设置 Flink 参数时,将其放在 <code>--</code> 之前,Loader 参数放在之后。
+准备好 <code>mysql-cdc.json</code> 映射后,使用单个 sink writer 提交任务。</p><div class="td-code td-code--untitled" id=td-code-955f155a-fence-44 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-955f155a-fence-44-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph-flinkcdc-loader.sh -p <span class=m> [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  --file ./mysql-cdc.json --host 127.0.0.1 --port <span class=m>8080</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  --graph hugegraph --cdc-sink-parallelism <span class=m>1</span></span></span></code></pre></div></div></div><p>每个映射使用一个 source reader 和一个 sink writer。<code>--cdc-sink-parallelism</code> 默认为 <code>1</code>,其他取值会被拒绝。
+<code>--</code> 之后的 Loader 参数 <code>-p</code> 表示 Server 端口。Checkpoint 刷新不提供图写入事务,也不保证 exactly-once。
+在生产环境部署边 CDC 或更复杂的多表映射前,建议先在真实环境中充分验证。
+支持范围和恢复流程见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-loader/docs/flink-cdc-java17.md>Flink CDC 说明</a>。</p><template data-hg-authored-content=end></template></div><div class=td-content style=page-break-before:always><h1 id=pg-d02803affe751e9f41f5846ddb6970de>4 - 图导入</h1><template data-hg-authored-content=start></template><p>需要把文件、数据库或消息数据写入 HugeGraph 时,从这里选择工具。直接导入可使用 Loader;已有 Source、Transform、Sink 管道时使用 SeaTunnel Sink;Spark 作业可使用 Spark Connector。</p><ul [...]
 列出的前置要求为 Java 8 或 11。从<a href=https://seatunnel.apache.org/download/>官方下载页</a><sup>[4]</sup>
 选择 3.0+ 二进制发行包,并使用页面提供的校验文件或签名验证下载包。
 下面以 3.0.0 为例,请将 <code>SEATUNNEL_VERSION</code> 改为实际下载的发行版本。</p><div class="td-code td-code--untitled" id=td-code-7df75818-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class=td-code__viewport id=td-code-7df75818-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>SEATUNN [...]
@@ -822,22 +855,39 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>37</span><span class=cl>      }
 </span></span><span class=line><span class=ln>38</span><span class=cl>    ]
 </span></span><span class=line><span class=ln>39</span><span class=cl>  }
-</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
+</span></span><span class=line><span class=ln>40</span><span class=cl>}</span></span></code></pre></div></div></div><div class="td-code td-code--untitled" id=td-code-7df75818-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-7df75818-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>.tar.gz&#34;</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl><span class=c1># hugegraph-tools 位于 toolchain 发布包的子目录中,</span>
 </span></span><span class=line><span class=ln>6</span><span class=cl><span class=c1># 其版本后缀与发布包本身一致</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>源码编译前请确保安装了wge [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>git clone https://github.com/apache/hugegraph-toolchain.git
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 2. 下载发布版源码包</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>export</span> <span class=nv>VERSION</span><span class=o>=</span>1.7.0
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span></span></span></code></pre></div></div></div><p>编译生成 tar 包:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-c [...]
-</span></span><span class=line><span class=ln>2</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp</span></span></code></pre></div></div></div><p>生成的 tar 包位于 <code>hugegraph-tools/target/apache-hugegraph-tools-${version}.tar.gz</code>,同时会在 <code>hugegraph-tools/apache-hugegraph-tools-${version}</code> 生成解压后的目录(包含 <code>bin/</code> 和 <code>lib/</code>)</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3. [...]
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span></span></span></code></pre></div></div></div><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--22-下载源码编译安装>2.2 下载源码编译安装</h4><p>任选一种方式构建发布版 <c [...]
+两段命令均包含编译和进入生成目录,最后用 <code>bin/hugegraph help</code> 查看可用命令。</p><div class="td-tab-block td-tab-block--code" data-td-tab="Git 标签" data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>Git 标签</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chro [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain
+</span></span><span class=line><span class=ln>3</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-incubating-1.7.0
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><div class="td-tab-block td-tab-block--code" data-td-tab=源码包 data-td-tab-kind=code><div class=td-tab-block__title data-td-tab-title>源码包</div><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=8><div class=td-code__viewport id=td-code-e3b5ef3d-fence-2-viewport dat [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>ARCHIVE</span><span class=o>=</span><span class=s2>&#34;apache-hugegraph-toolchain-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>wget <span class=s2>&#34;https://downloads.apache.org/hugegraph/</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>/</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>tar zxf <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src.tar.gz&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;</span><span class=si>${</span><span class=nv>ARCHIVE</span><span class=si>}</span><span class=s2>-src&#34;</span>
+</span></span><span class=line><span class=ln>6</span><span class=cl>mvn package -pl hugegraph-tools -am -DskipTests -ntp
+</span></span><span class=line><span class=ln>7</span><span class=cl><span class=nb>cd</span> <span class=s2>&#34;hugegraph-tools/apache-hugegraph-tools-incubating-</span><span class=si>${</span><span class=nv>VERSION</span><span class=si>}</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>8</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></div><p>编译还会在源码根目录下生成 <code>hugegraph-tools/target/apache-hugegraph-tools-incubating-1.7.0.tar.gz</code>。</p><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--build-current-source>2.3 构建当前源码</h4><p>若需要使用 master 分支未发布的新特性,可按以下步骤从源码构建 Tools(当前 master 以 1.8 为基线,需 JDK 17、Maven 3.6.3+ 与 Python 3.9+):</p><ol class=steps><li><p><strong>获取 Toolchain 源码</strong></p><div c [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>cd</span> hugegraph-toolchain</span></span></code></pre></div></div></div></li><li><p><strong>构建配套 Server SDK</strong></p><p>执行以下脚本下载 Server 源码并将配套 SDK 安装到独立 Maven 仓库:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=6><div class=td-code__viewport id=td-code-e3b5ef3d-fence-4-viewport data-td-code-viewport><div  [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>mvn -version
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>candidate_dir</span><span class=o>=</span><span class=k>$(</span>mktemp -d<span class=k>)</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>mkdir -p <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl>bash hugegraph-client/assembly/travis/install-candidate-sdk.sh <span class=se>\
+</span></span></span><span class=line><span class=ln>6</span><span class=cl>  master <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/server&#34;</span> <span class=s2>&#34;</span><span class=nv>$candidate_dir</span><span class=s2>/m2&#34;</span></span></span></code></pre></div></div></div><p>详细说明见 <a href=https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md>Java 17 迁移指引</a>。</p></li><li><p><strong>打包 Tools</strong></p><div clas [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -Dsdk.validation.mode<span class=o>=</span>candidate <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  package -pl hugegraph-tools -am -DskipTests -Dmaven.javadoc.skip<span class=o>=</span><span class=nb>true</span> -ntp
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>cd</span> hugegraph-tools/apache-hugegraph-tools-*
+</span></span><span class=line><span class=ln>5</span><span class=cl>bin/hugegraph help</span></span></code></pre></div></div></div></li></ol><p>使用这份源码构建时保留 SDK 仓库。master 分支生成目录名不含 <code>incubating</code>。</p><h3 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-使用>3 使用</h3><h4 id=pg-578593298ffbd00c4ba2246ed746c1b8--31-功能概览>3.1 功能概览</h4><p>进入解压或编译生成的 Tools 目录,用 <code>bin/hugegraph help</code> 查看命令列表,
+用 <code>bin/hugegraph help &lt;子命令></code> 查看单个命令的用法。可用命令分为以下几类。</p><ul><li>图管理类,graph-mode-set、graph-mode-get、graph-list、graph-get、graph-clear、graph-create、graph-clone 和 graph-drop</li><li>异步任务管理类,task-list、task-get、task-delete、task-cancel 和 task-clear</li><li>Gremlin类,gremlin-execute 和 gremlin-schedule</li><li>备份/恢复类,backup、restore、migrate、schedule-backup 和 dump</li><li>认证数据备份/恢复类,auth-backup 和 auth-restore</li><li>旧版 Server/Studio 部署,deploy、clear、start-all 和 stop-all</li></ul><div cla [...]
+<code>--user</code> 和 <code>--password</code> 必须同时提供或同时省略。</p></blockquote><p>使用 <code>export</code> 设置的环境变量对当前终端及其启动的命令生效。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>全局变量</th><th scope=col>环境变量</th><th scope=col>示例</th></tr></thead><tbody><tr><td>&ndash;url</td><td>HUGEGRAPH_URL</td><td>export HUGEGRAPH_URL=http://127.0.0.1:8080</td></tr><tr><td>&ndash;graph</td><td>HUGEGRAPH_GRA [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_GRAPH</span><span class=o>=</span>hugegraph
-</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>另一种方式是在 bin/hugegraph 脚本中设置环境变量:</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-6-viewport data-td-code-viewport><div class=hig [...]
+</span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div></div><p>也可以在 <code>bin/hugegraph</code> 脚本中设置这些变量。</p><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=text data-td-line-count=10><div class=td-code__viewport id=td-code-e3b5ef3d-fence-9-viewport data-td-code-viewport><div [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl># Set environment here if needed
 </span></span><span class=line><span class=ln> 4</span><span class=cl>#export HUGEGRAPH_URL=
@@ -849,7 +899,9 @@ JDBC 示例还需将 MySQL 驱动 JAR 放入 <code>lib/</code>,驱动类为 <c
 </span></span><span class=line><span class=ln>10</span><span class=cl>#export HUGEGRAPH_TRUST_STORE_PASSWORD=</span></span></code></pre></div></div></div><p><code>bin/hugegraph</code> 还会读取 <code>JAVA_HOME</code>(未设置时打印警告,https 需要它)和 <code>JAVA_OPTIONS</code>(JVM 参数,为空时脚本使用 <code>-Xms512m</code>,并根据机器空闲内存计算 <code>-Xmx</code>)。</p><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--33-图管理类graph-mode-setgraph-mode-getgraph-listgraph-getgraph-cleargraph-creategraph-clone和graph-drop>3.3 图管理类,graph-mo [...]
 restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设置),否则命令会失败</p></blockquote></li><li>migrate,将当前连接的图迁移至另一个 HugeGraphServer 中<ul><li>&ndash;target-graph,目标图的名字,默认为 hugegraph</li><li>&ndash;target-url,目标图所在的 HugeGraphServer,默认为 http://127.0.0.1:8081</li><li>&ndash;target-user,访问目标图的用户名</li><li>&ndash;target-password,访问目标图的密码</li><li>&ndash;target-timeout,访问目标图的超时时间</li><li>&ndash;target-trust-store-file,访问目标图使用的 truststore 文件</li><li>&ndash;target-trust-store-password,访问目标图使用的 trust [...]
 用户也可以自定义存储格式。在 <code>hugegraph-tools/src/main/java/org/apache/hugegraph/formatter</code> 下实现一个继承自 <code>Formatter</code> 的类,例如 <code>CustomFormatter</code>,使用时指定该类为 formatter:
-<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+<code>bin/hugegraph dump -f CustomFormatter</code><ul><li>&ndash;formatter 或者 -f,指定使用的 formatter,默认为 JsonFormatter</li><li>&ndash;directory 或者 -d,存储 schema 或者 data 的目录,本地目录时,默认为&rsquo;./{graphName}&rsquo;,HDFS 时,默认为 &lsquo;{fs.default.name}/{graphName}&rsquo;</li><li>&ndash;log 或者 -l,指定日志目录,默认为 ./logs</li><li>&ndash;retry,指定失败重试次数,默认为 3</li><li>&ndash;thread-num 或者 -T,使用的线程数,默认为 Math.min(10, Math.max(4, CPUs / 2))</li><li>&ndash;split-size 或者 -s,指定在备份时对顶点或者边分块的大小,默认为 1048576,且不能小于 104857 [...]
+新部署请参考 <a href=/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速上手</a> 与 <a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>Hubble 快速上手</a>,
+以下说明仅供维护旧环境参考。</p><ul><li>deploy,一键下载、安装和启动 HugeGraph-Server 和 HugeGraph-Studio<ul><li>-v,必填项,指定要安装的 HugeGraph-Server 和 HugeGraph-Studio 版本,必须是 bin/version-map.yaml 中列出的版本之一(0.6、0.7、0.8、0.9、0.10),脚本据此映射到对应的 server 和 studio 发布版本</li><li>-p,必填项,指定安装的 HugeGraph-Server 和 HugeGraph-Studio 目录</li><li>-u,选填项,指定下载 HugeGraph-Server 和 HugeGraph-Studio 压缩包的链接</li></ul></li><li>clear,清理 HugeGraph-Server 和 HugeGraph-Studio 目录和tar包(若对应的 server 或 studio 进程仍在运行则拒绝执行,删除每一项前都会提示确认)<ul><li>-p,必填项,指定要清理的 Hu [...]
 </span></span><span class=line><span class=ln>  2</span><span class=cl>  Options:
 </span></span><span class=line><span class=ln>  3</span><span class=cl>    --graph
 </span></span><span class=line><span class=ln>  4</span><span class=cl>      Name of graph
@@ -1258,26 +1310,26 @@ restore 要求图处于 RESTORING 或 MERGING 模式(先用 graph-mode-set 设
 </span></span><span class=line><span class=ln>407</span><span class=cl>            Default: <span class=o>{}</span>
 </span></span><span class=line><span class=ln>408</span><span class=cl>
 </span></span><span class=line><span class=ln>409</span><span class=cl>    <span class=nb>help</span>      Print usage
-</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-8 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-8-viewport data- [...]
+</span></span><span class=line><span class=ln>410</span><span class=cl>      Usage: help</span></span></code></pre></div></div></div><h5 id=pg-578593298ffbd00c4ba2246ed746c1b8--310-具体命令示例>3.10 具体命令示例</h5><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--1-gremlin语句>1. gremlin语句</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport dat [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 异步执行gremlin</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport i [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph gremlin-schedule --script <span class=s1>&#39;g.V().count()&#39;</span></span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--2-查看task情况>2. 查看task情况</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-12 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --limit <span class=m>5</span>
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-10-viewport data-td [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph task-list --status success</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--3-图模式查看和设置>3. 图模式查看和设置</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class=td-code__viewport id=td-code-e3b5ef3d-fence-13-viewport data-td [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>
 </span></span><span class=line><span class=ln>3</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-get
 </span></span><span class=line><span class=ln>4</span><span class=cl>
-</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-11-viewport data-td-code-viewport><div class= [...]
+</span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-list</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--4-清理图>4. 清理图</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-14-viewport data-td-code-viewport><div class= [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m RESTORING
 </span></span><span class=line><span class=ln>3</span><span class=cl>
 </span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 恢复图</span>
 </span></span><span class=line><span class=ln>5</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph restore -t all --directory ./backup-test
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># 恢复图模式</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-15 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-15-viewport data-td-code-viewport [...]
+</span></span><span class=line><span class=ln>8</span><span class=cl>./bin/hugegraph --url http://127.0.0.1:8080 --graph hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div></div><h6 id=pg-578593298ffbd00c4ba2246ed746c1b8--8-图迁移>8. 图迁移</h6><div class="td-code td-code--untitled" id=td-code-e3b5ef3d-fence-18 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-e3b5ef3d-fence-18-viewport data-td-code-viewport [...]
 并行扫描的后端要求和配置限制见<a href=https://seatunnel.apache.org/docs/connectors/source/HugeGraph/>官方 Source 文档</a>。</p><p>开始前请先完成<a href=/cn/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/#2-%E5%87%86%E5%A4%87%E7%8E%AF%E5%A2%83>导入页中的通用环境准备和配置</a>,其中包含 JDK、HOCON、插件安装和图模型说明。</p><h2 id=pg-ccd69baffd5f65fef8a9ffd973f078b3--1-迁移-hugegraph-图graph2graph>1 迁移 HugeGraph 图(graph2graph)</h2><p>下面从源图迁移 <code>person</code> 顶点和 <code>knows</code> 边。请使用独立的目标图:本节采用 <code>CUSTOMIZE_STRING</code> 保留顶点 [...]
 </span></span><span class=line><span class=ln> 2</span><span class=cl>  job.mode = &#34;BATCH&#34;
 </span></span><span class=line><span class=ln> 3</span><span class=cl>}
diff --git a/cn/_print/docs/quickstart/toolchain/visualization/index.html b/cn/_print/docs/quickstart/toolchain/visualization/index.html
index 49e013692..be42113cd 100644
--- a/cn/_print/docs/quickstart/toolchain/visualization/index.html
+++ b/cn/_print/docs/quickstart/toolchain/visualization/index.html
@@ -11,48 +11,52 @@ Hubble 基础与单机 RocksDB:启动、示例图、建模、导入与查询
 配置 <code>.env</code> 并生成 Hubble 本地配置文件,然后在 <code>docker/</code> 目录下启动,无需自行维护部署文件。
 下文重点说明连接与运维配置要点,部署前请确保满足 README 中的 PD 凭据与前置依赖要求。
 Docker <code>latest</code> 为动态标签,配图用于定位界面,实际版本以部署镜像的 digest 及构建信息为准。
-不同版本可提供的指标和权限接口有所区别。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
-同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang [...]
+不同版本可提供的指标和权限接口有所区别。</p><p>本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--连接分布式集群>连接分布式集群</h2><p>Hubble 仍通过 <strong>Server 的图 API</strong> 管理数据。区别在于,分布式模式通过 PD 发现 Server,
+同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。</p><pre class=td-mermaid-source><code class=language-mermaid>flowchart LR
+    H[Hubble] --&gt;|图 API| S[Server]
+    S --&gt;|读写图数据| T[Store]
+    H -.-&gt;|服务发现与集群信息| P[PD]
+    H -.-&gt;|节点指标| T</code></pre><ol class=steps><li><p><strong>生成 Hubble 配置。</strong> 按 Docker README 在主仓库的 <code>docker/</code> 目录准备 <code>.env</code>。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl>. ./.env
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>set</span> +a
 </span></span><span class=line><span class=ln>4</span><span class=cl>./set-hubble-pd-password.sh hstore</span></span></code></pre></div></div></div><p>脚本会读取 <code>.env</code> 中的 <code>HG_PD_AUTH_SECRET_KEY</code>,将其值作为 <code>operations.pd.password</code> 写入生成文件 <code>docker/conf/hubble/hstore.local.properties</code>。
 若需调整连接地址或运维参数,直接编辑该文件即可(请勿覆盖 Git 跟踪的 <code>.example</code> 模板文件),并确保 <code>operations.pd.password</code>
 与 PD 所用密钥一致。Compose 会将该文件只读挂载到容器内部,无需进入容器修改。
-该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
+该生成文件与 <code>.env</code> 均属于敏感配置,请勿提交到版本库;重新运行脚本会覆盖该文件,届时需重新补齐自定义参数。</p></li><li><p><strong>启动服务。</strong> 在同一 <code>docker/</code> 目录启动组合,确认 Server 已注册、Store 已就绪。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><s [...]
 <a href=/cn/docs/quickstart/hugegraph/hugegraph-hstore/>HStore 部署指南</a>;源码或二进制包启动的 Hubble 则编辑其
-<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址:</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
+<code>conf/hugegraph-hubble.properties</code>。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=4><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span  [...]
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>cluster</span><span class=o>=</span><span class=s>hg</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=na>pd.peers</span><span class=o>=</span><span class=s>pd:8686</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=na>pd.server</span><span class=o>=</span><span class=s>pd:8620</span></span></span></code></pre></div></div></div><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>配置</th><th scope=col>用途</th><th scope=col>随包配置值</th></tr></thead><tbody><tr><td><code>pd.enabled</code></td><td>显式启用 PD 模式;此时不使用 <code>server.direct_url</code>。</td><td> [...]
 发行包默认配置中显式设为 <code>pd.enabled=false</code>;若未配置该项,代码默认值为 <code>true</code>,因此单机与分布式部署均建议显式声明该配置。
-修改配置后:源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
-(沿用启动时的项目名及所有 <code>-f</code> 参数):</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
+修改配置后,源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 <code>docker/</code> 目录下重新创建 Hubble 容器以重新加载挂载配置
+(沿用启动时的项目名及所有 <code>-f</code> 参数)。</p><div class="td-code td-code--untitled" id=td-code-f2c783df-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class=td-code__viewport id=td-code-f2c783df-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble</s [...]
 让各团队只看到并操作自己的图。进入图空间后,图的建模、导入和查询仍沿用基础指南的流程。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--创建与调整图空间>创建与调整图空间</h3><p>开启 Server 认证时,创建、编辑和删除图空间要求超级管理员权限。创建时先填写全局唯一的 GraphSpace 名称、
 可选的显示别名及最大图数;例如用 <code>research</code> 作 API 标识,用“研究图谱”作显示名。GraphSpace 名称创建后不可修改,
 别名和描述可随后调整,别名不参与 URL 或权限匹配。图空间管理员从已有账号中选择。</p><p>“高级部署与资源限制”包含图查询/写入服务、异步计算任务的 CPU 与内存上限,以及存储容量限制。
 这些部署配额不会显示实时资源用量,也不会自动扩容现有容器。</p><div class="td-callout td-callout--details td-callout--collapsible" role=note data-td-callout-collapsible><div class=td-callout__title><span class=td-callout__label>高级部署的默认值</span></div><div class=td-callout__body><p>默认最大图数为 100;图服务与计算任务分别为 64 核、128 GB,存储上限为 1000000 GB。
 普通容器试用可保留默认值。Kubernetes 命名空间、Operator 和算法镜像仅在对应场景中填写。</p></div></div><p>选择图空间后,再进入其中的图。切换空间时应重新确认当前图,尤其是不同空间中存在同名图时。
-列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=2048 height=984 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
+列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。</p><img class=td-image src=/cn/docs/images/hubble/graphspace.jpg alt=图空间创建表单与高级资源限制入口 width=1600 height=1000 loading=lazy decoding=async><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--复用-schema-模板>复用 Schema 模板</h3><p><strong>用户 Schema 模板仅适用于 PD 模式</strong>,按图空间持久化保存 Groovy Schema。
 当一组业务图需要同样的顶点类型、边类型和索引时,可以先保存模板,再在创建图时选择它,减少重复建模。
-例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>用户模板与主篇的内置示例模板不同:内置模板用于快速体验预设模型,用户模板用于保存自己的模型并长期复用。
+例如 <code>research</code> 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。</p><p>主篇的内置示例模板用于快速体验预设模型。用户模板用于保存自己的模型并长期复用。
 模板本身不等于导入数据;是否加载示例数据是创建图时的另一个选择。
 开启 Server 认证时,创建用户模板需要所在空间的写权限,更新或删除还要求模板所有者或相应管理权限。
 匿名模式不进行按用户的权限与模板所有者检查。
 单机模式不提供用户模板管理。</p><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--给用户分配图空间权限>给用户分配图空间权限</h2><p>账号创建、登录和个人资料管理见<a href=/cn/docs/quickstart/toolchain/hugegraph-hubble/>基础指南</a>;
 分布式模式额外提供“管理 GraphSpace 成员”,在已有账号与指定空间之间分配权限。
-支持权限预设的 Server 提供以下常用选择:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
+支持权限预设的 Server 提供以下常用选择。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>预设</th><th scope=col>适用对象</th><th scope=col>作用范围</th></tr></thead><tbody><tr><td>GraphSpace 只读</td><td>查看、查询图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 读写</td><td>建模、导入和维护图数据的使用者</td><td>所选空间。</td></tr><tr><td>GraphSpace 管理员</td><td>管理该空间的成员与图资源的负责人</td><td>所选空间,不因此获得创建/编辑图空间或集群运维权限。</td></tr><tr><td>超级管理员</td><td>管理账号、图空间及集群的运维 [...]
 账号与空间成员分开管理,移除成员不会删除全局账号。创建账号后可以立即继续分配空间权限;调整已有成员时,确认当前空间及预设,保留其他空间仍需要的权限。
 仅启用 <code>pd.enabled</code> 不会授予权限,旧 Server 的自定义角色也不能直接当作这些预设处理。
-认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=2048 height=984 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
+认证配置见 <a href=/cn/docs/config/config-authentication/>Server 认证与授权</a>。</p><img class=td-image src=/cn/docs/images/hubble/members.jpg alt="GraphSpace 成员与权限预设" width=1600 height=1000 loading=lazy decoding=async><h2 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--从集群概览定位异常>从集群概览定位异常</h2><p>集群概览用一张拓扑展示 <strong>Server → PD → Store</strong>,可切换节点列表按类型、状态或名称筛选。
 概览中的 PD Leader、在线 Store 数、图数、分区数、副本数和数据量,帮助判断当前连接的规模及哪些节点需要关注。
-分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点:<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
+分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。</p><p>先看集群和来源状态,再进入异常节点。<code>UP</code> 表示本次采集的来源正常;<code>DEGRADED</code> 表示集群或部分来源异常;
 <code>DOWN</code> 表示相应探测未成功。拓扑可用而指标部分缺失时,仍可能正常查询图。
-页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
+页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--节点详情读什么>节点详情读什么</h3><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>节点</th><th scope=col>主要关注信息</th><th scope=col>如何使用</th></tr></thead><tbody><tr><td>Server</td><td>节点可用性、JVM/CPU/内存及后端指标</td><td>判断查询与写入入口是否可达,并检查资源压力。</td></tr><tr><td>PD</td><td>Leader/Follower 角色、状态及上游可提供的运行指标</td><td>确认元数据与 [...]
 Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性检查;各版本可用的指标不同。</p><p>开启 Server 认证时,集群运维读取要求超级管理员(<code>ADMIN</code> 级别),空间管理员和普通成员不会因此获得集群读取权限。
 部署时使用容器隔离、可信 HTTPS 入口、Server 认证与网络白名单,避免直接公开 Hubble 和组件端口。</p><h3 id=pg-33fca9af1c30d5ed43daaa61aa0928ea--配置运维访问>配置运维访问</h3><p>PD/Store 的运维凭据由 Hubble <strong>后端</strong>使用,与浏览器登录 Server 的账号分开。
 Compose 部署修改上文生成的宿主机 <code>docker/conf/hubble/hstore.local.properties</code>;其他部署修改 Hubble 包内配置文件。
-其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置:</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
-且需与 PD 返回的 Store 指标目标完全一致。注意:仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次排查:Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
+其中 PD 密码由脚本生成并与 <code>.env</code> 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置。</p><div class="td-table-scroll td-table-scroll--static" tabindex=0 role=region aria-label=可横向滚动的表格><table class=td-table--wide><thead><tr><th scope=col>配置</th><th scope=col>随包默认值</th><th scope=col>设置方式</th></tr></thead><tbody><tr><td><code>operations.pd.username</code> / <code>operations.pd.password</code></td><td>用户名 <code>hubble</code>,密码为空</td><td>与 PD 运维 REST 认证匹配。</td></tr><tr><td><code>operations.st [...]
+且需与 PD 返回的 Store 指标目标完全一致。仅在白名单中添加地址不会自动建立节点发现。</p><p>若集群拓扑可见但节点指标不完整,请依次检查 Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
 以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。</p><template data-hg-authored-content=end></template></div></main></div><script type=application/json id=td-action-manifest>{"actions":[{"available":true,"description":"复制 Markdown 文本","disabledReason":"","icon":"fa-regular fa-copy","id":"copy_markdown","keywords":["复制 Markdown 文本","markdown","copy"],"kind":"copy","options":[],"placements":{"page":true,"palette":true},"target":"self","title":"复制 Markdown 文本","url":"/cn/docs/quicks [...]
 <i class="fa-solid fa-wand-magic-sparkles" aria-hidden=true></i>
 <span>询问 AI</span></button><section class="hg-ai-consent d-print-none" data-hg-ai-consent hidden aria-labelledby=hg-ai-consent-title aria-describedby=hg-ai-disclosure><h2 class=visually-hidden id=hg-ai-consent-title>询问 AI</h2><p id=hg-ai-disclosure>同意后将把你的问题发送给第三方 Kapa 服务,使用 AI 结合文档回答。</p><p>回答基于 latest 版本文档</p><p><a href=https://www.kapa.ai/content/privacy-policy target=_blank rel="noopener noreferrer">隐私政策</a></p><div class=hg-ai-consent-actions><button type=button class="btn btn-secon [...]
diff --git a/cn/about/index.html b/cn/about/index.html
index 6a2579ed2..2a6673aee 100644
--- a/cn/about/index.html
+++ b/cn/about/index.html
@@ -62,7 +62,7 @@
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-drawer value=auto data-bs-theme-value=auto checked>
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>跟随系统</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>浏览器未保存设置,此选择仅在当前页面有效。</p></dialog></div></div><a class=td-site-nav__menu-link href=https://github.com/apache/hugegraph target=_blank rel="noopener noreferrer"><i class="fa-brands fa-github" aria-hidden=true></i><span>GitHub</span></a></nav></div>< [...]
 <span>Apache HugeGraph</span></p><h1 class=td-landing-hero__title id=hero-title>连接图数据与图智能的一体化生态</h1><p class=td-landing-hero__lead>HugeGraph 是 Apache 顶级项目,覆盖事务型图存储、分布式分析、可视化、数据导入和图智能。</p><div class=td-landing-hero__actions><a class="td-landing-button td-landing-button--primary" href=https://hugegraph.apache.org/cn/docs/><span>阅读文档</span>
-</a><a class="td-landing-button td-landing-button--ghost" href=https://hugegraph.apache.org/cn/community/><span>加入社区</span></a></div></div></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>项目组件</h2></header><div class=td-landing-card-grid style=--td-columns:3><article class=td-landing-card><div class=td-landing-card__media><i class="fa-sol [...]
+</a><a class="td-landing-button td-landing-button--ghost" href=https://hugegraph.apache.org/cn/community/><span>加入社区</span></a></div></div></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>项目组件</h2></header><div class=td-landing-card-grid style=--td-columns:3><article class=td-landing-card><div class=td-landing-card__media><i class="fa-sol [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html b/cn/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
index 02c2ebe46..c66bbe19b 100644
--- a/cn/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
+++ b/cn/blog/2025/09/30/toplingdb-yaml-configuration-file/index.html
@@ -244,7 +244,7 @@ RocksDB 提供了丰富的参数配置,但大多数情况下,这些配置需
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/2025/10/09/toplingdb-quick-start/index.html b/cn/blog/2025/10/09/toplingdb-quick-start/index.html
index 25efa4522..310eae4cb 100644
--- a/cn/blog/2025/10/09/toplingdb-quick-start/index.html
+++ b/cn/blog/2025/10/09/toplingdb-quick-start/index.html
@@ -141,7 +141,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/2025/10/29/agentic-graphrag/index.html b/cn/blog/2025/10/29/agentic-graphrag/index.html
index 6ea90850b..7d02f91c6 100644
--- a/cn/blog/2025/10/29/agentic-graphrag/index.html
+++ b/cn/blog/2025/10/29/agentic-graphrag/index.html
@@ -291,7 +291,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/computing/index.html b/cn/blog/computing/index.html
index 1e3bbf934..56b302601 100644
--- a/cn/blog/computing/index.html
+++ b/cn/blog/computing/index.html
@@ -88,7 +88,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/hugegraph-ai/index.html b/cn/blog/hugegraph-ai/index.html
index 86f541510..1a63e78b8 100644
--- a/cn/blog/hugegraph-ai/index.html
+++ b/cn/blog/hugegraph-ai/index.html
@@ -90,7 +90,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/hugegraph/index.html b/cn/blog/hugegraph/index.html
index 4b63e8002..5b9d30c4f 100644
--- a/cn/blog/hugegraph/index.html
+++ b/cn/blog/hugegraph/index.html
@@ -89,7 +89,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/hugegraph/toplingdb/index.html b/cn/blog/hugegraph/toplingdb/index.html
index e91fa72dd..4e5f7b5e0 100644
--- a/cn/blog/hugegraph/toplingdb/index.html
+++ b/cn/blog/hugegraph/toplingdb/index.html
@@ -97,7 +97,7 @@ ToplingDB 在此基础上引入了 SidePlugin …</p></div></article></div><div
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/index.html b/cn/blog/index.html
index c51f046e0..835514c3d 100644
--- a/cn/blog/index.html
+++ b/cn/blog/index.html
@@ -100,7 +100,7 @@ ToplingDB 在此基础上引入了 SidePlugin …</p></div></article></div><div
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/blog/toolchain/index.html b/cn/blog/toolchain/index.html
index 5c42026ab..8b41dfe62 100644
--- a/cn/blog/toolchain/index.html
+++ b/cn/blog/toolchain/index.html
@@ -89,7 +89,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/categories/graph-ai/index.html b/cn/categories/graph-ai/index.html
index 86076815c..02c9ed1f3 100644
--- a/cn/categories/graph-ai/index.html
+++ b/cn/categories/graph-ai/index.html
@@ -96,7 +96,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/categories/index.html b/cn/categories/index.html
index 0252a5cb3..b39ed7374 100644
--- a/cn/categories/index.html
+++ b/cn/categories/index.html
@@ -67,7 +67,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsclients-children aria-label="展开章节: 客户端与 API" data-td-label-expand="展开章节: 客户端与 API" data-td-label-collapse="收起章节: 客户端与 API"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsclients-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-sh [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsclientsrestful-api-children aria-label="展开章节: RESTful API" data-td-label-expand="展开章节: RESTful API" data-td-label-collapse="收起章节: RESTful API"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsclientsrestful-api-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul c [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsguides-children aria-label="展开章节: 使用指南" data-td-label-expand="展开章节: 使用指南" data-td-label-collapse="收起章节: 使用指南"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsguides-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__list [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsguides-children aria-label="展开章节: 使用指南" data-td-label-expand="展开章节: 使用指南" data-td-label-collapse="收起章节: 使用指南"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsguides-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__list [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
@@ -115,7 +115,7 @@
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/categories/storage/index.html b/cn/categories/storage/index.html
index 29cea8dbe..52dc21afa 100644
--- a/cn/categories/storage/index.html
+++ b/cn/categories/storage/index.html
@@ -106,7 +106,7 @@ ToplingDB 在此基础上引入了 SidePlugin + YAML 的方式,使得配置更
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/toplingdb/><span>ToplingDB</span><span class=td-shell-tag__count>2</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/graphrag/><span>GraphRAG</span><span class=td-shell-tag__count>1</span>
 </a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/rag/><span>RAG</span><span class=td-shell-tag__count>1</span>
-</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
+</a><a class=td-shell-tag href=https://hugegraph.apache.org/cn/tags/workflow/><span>Workflow</span><span class=td-shell-tag__count>1</span></a></div></div></div></div></div></div></aside><div class="td-shell-toc-float d-print-none"><button type=button class=td-shell-iconbtn data-td-shell-right-toggle title=显示目录 aria-label=显示目录><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></button></div></div><footer class=d-print-none data-td-shell-footer><div class= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/community/documentation/index.html b/cn/community/documentation/index.html
index 404f777d9..b6d17f806 100644
--- a/cn/community/documentation/index.html
+++ b/cn/community/documentation/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -111,7 +111,7 @@
 <span>最后修改 2026-10-12 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/6181c870599030a864303ffa74821925293d1192>feat: upgrade OINK to 1.2.0 and improve docs UX (#514) (6181c8705)</a></span></div></div></section></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-aside-group--toc"><div class=td-shell-aside-g [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#检查本地工具链>检查本地工具链</a></li><li><a href=#预览与验证>预览与验证</a>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#检查本地工具链>检查本地工具链</a></li><li><a href=#预览与验证>预览与验证</a>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/community/index.html b/cn/community/index.html
index 7fb2c22d4..1b52585c2 100644
--- a/cn/community/index.html
+++ b/cn/community/index.html
@@ -86,7 +86,7 @@
 </span><span class=hg-community-member__identity>Thespica</span></div></li><li class="td-landing-contributor hg-community-member"><a class="hg-community-member__surface hg-community-member__link" href=https://github.com/wanganjuan target=_blank rel="noopener noreferrer" aria-label="wanganjuan 的 GitHub 主页"><span class="td-landing-contributor__avatar hg-community-member__avatar" aria-hidden=true><span class=hg-community-member__initials>W</span><img src=https://hugegraph.apache.org/img/com [...]
 </span><span class=hg-community-member__identity>wanganjuan</span></a></li><li class="td-landing-contributor hg-community-member"><div class=hg-community-member__surface aria-label="Yi Zhang"><span class="td-landing-contributor__avatar hg-community-member__avatar" aria-hidden=true><span class=hg-community-member__initials>YZ</span>
 </span><span class=hg-community-member__identity>Yi Zhang</span></div></li><li class="td-landing-contributor hg-community-member"><a class="hg-community-member__surface hg-community-member__link" href=https://github.com/z7658329 target=_blank rel="noopener noreferrer" aria-label="z7658329 的 GitHub 主页"><span class="td-landing-contributor__avatar hg-community-member__avatar" aria-hidden=true><span class=hg-community-member__initials>Z</span><img src=https://hugegraph.apache.org/img/communi [...]
-</span><span class=hg-community-member__identity>z7658329</span></a></li></ul></section></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>参与社区</h2></header><div class=td-landing-card-grid style=--td-columns:2><article class=td-landing-card><div class=td-landing-card__media><i class="fa-solid fa-people-group" aria-hidden=true></i></div><h3> [...]
+</span><span class=hg-community-member__identity>z7658329</span></a></li></ul></section></div></section><section id=cards class="td-landing-section td-landing-cards-section" aria-labelledby=cards-title><div class=td-site-container><header class=td-landing-section__head><h2 id=cards-title>参与社区</h2></header><div class=td-landing-card-grid style=--td-columns:2><article class=td-landing-card><div class=td-landing-card__media><i class="fa-solid fa-people-group" aria-hidden=true></i></div><h3> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-0.12.0-release-notes/index.html b/cn/docs/changelog/hugegraph-0.12.0-release-notes/index.html
index 542b7f0a2..822c45d72 100644
--- a/cn/docs/changelog/hugegraph-0.12.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-0.12.0-release-notes/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -100,7 +100,7 @@
 <span>最后修改 2026-02-02 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/655c3fd93bf766c359056ecd99672ad379d6928c>BREAKING CHANGE: graduate as TLP & refactor a string of docs (#447) (655c3fd93)</a></span></div></div></section></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-aside-group--toc"><div class=td- [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#api--client>API & Client</a></li><li><a href= [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#api--client>API & Client</a></li><li><a href= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-1.0.0-release-notes/index.html b/cn/docs/changelog/hugegraph-1.0.0-release-notes/index.html
index 93e270c94..4ee0e8931 100644
--- a/cn/docs/changelog/hugegraph-1.0.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-1.0.0-release-notes/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -101,7 +101,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.2.0-release-notes/ aria-label="下一页 - HugeGraph 1.2.0 Release Notes" title=Release-1.2.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.2.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-s [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#oltp-api--client-更新>OLTP API & Client 更新</a>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#oltp-api--client-更新>OLTP API & Client 更新</a>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-1.2.0-release-notes/index.html b/cn/docs/changelog/hugegraph-1.2.0-release-notes/index.html
index 8a6ecfd70..5c9da7b33 100644
--- a/cn/docs/changelog/hugegraph-1.2.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-1.2.0-release-notes/index.html
@@ -74,7 +74,7 @@ Consider using Java 11 in hugegraph/hugegraph-toolchain/hugegraph-commons, also
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -106,7 +106,7 @@ Consider using Java 11 in hugegraph/hugegraph-toolchain/hugegraph-commons, also
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.3.0-release-notes/ aria-label="下一页 - HugeGraph 1.3.0 Release Notes" title=Release-1.3.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.3.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-s [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#java-version-statement>Java version statement [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#java-version-statement>Java version statement [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-1.3.0-release-notes/index.html b/cn/docs/changelog/hugegraph-1.3.0-release-notes/index.html
index 54e8595db..5b11a198f 100644
--- a/cn/docs/changelog/hugegraph-1.3.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-1.3.0-release-notes/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -104,7 +104,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.5.0-release-notes/ aria-label="下一页 - HugeGraph 1.5.0 Release Notes" title=Release-1.5.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.5.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-s [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-1.5.0-release-notes/index.html b/cn/docs/changelog/hugegraph-1.5.0-release-notes/index.html
index 0c844794b..725d8d5af 100644
--- a/cn/docs/changelog/hugegraph-1.5.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-1.5.0-release-notes/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -105,7 +105,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.7.0-release-notes/ aria-label="下一页 - HugeGraph 1.7.0 Release Notes" title=Release-1.7.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.7.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-s [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/hugegraph-1.7.0-release-notes/index.html b/cn/docs/changelog/hugegraph-1.7.0-release-notes/index.html
index cf2ee859b..396f33237 100644
--- a/cn/docs/changelog/hugegraph-1.7.0-release-notes/index.html
+++ b/cn/docs/changelog/hugegraph-1.7.0-release-notes/index.html
@@ -78,7 +78,7 @@ hugegraph API Changes BREAKING CHANGE: Disable legacy backends include MySQL/PG/
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -109,7 +109,7 @@ hugegraph API Changes BREAKING CHANGE: Disable legacy backends include MySQL/PG/
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/download/download/ aria-label="下一页 - 下载 Apache HugeGraph" title=Download data-td-pager-next><span class=td-pager__title dir=auto>Download</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-grou [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#运行环境版本说明>运行环境/版本说明</a></li><li><a href=#hugeg [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/changelog/index.html b/cn/docs/changelog/index.html
index 800c8a48b..ec3f50a0d 100644
--- a/cn/docs/changelog/index.html
+++ b/cn/docs/changelog/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -98,7 +98,7 @@
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/changelog/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/changelog/_index.md [...]
 <span>最后修改 2024-02-01 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/d2b63d937d9f6f0d49d597081acc58ec3d4d6966>doc: sync doc about enable auth for docker image (#324) (d2b63d937)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/guides/ aria-label="上一页 - 使用指南" title=使用指南 data-td-pager-prev><span class=td-pager__ar [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.0.0-release-notes/ aria-label="下一页 - HugeGraph 1.0.0 Release Notes" title=Release-1.0.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.0.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><b [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.0.0-release-notes/ aria-label="下一页 - HugeGraph 1.0.0 Release Notes" title=Release-1.0.0 data-td-pager-next><span class=td-pager__title dir=auto>Release-1.0.0</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><b [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/cla/index.html b/cn/docs/cla/index.html
index 357187ce3..e12581b06 100644
--- a/cn/docs/cla/index.html
+++ b/cn/docs/cla/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -100,7 +100,7 @@
 <span>最后修改 2026-09-04 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/d88167dd797efafea50cec59909d57849703fde5>docs: sync content for 1.7.0 updates (#470) (d88167dd7)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/ aria-label="上一页 - 在 IDEA 中配置 Server 开发环境" tit [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#apache-贡献者协议>Apache 贡献者协议</a></li></ul></nav></div></ [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#apache-贡献者协议>Apache 贡献者协议</a></li></ul></nav></div></ [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/gremlin-console/index.html b/cn/docs/clients/gremlin-console/index.html
index f47323a65..f34694b7d 100644
--- a/cn/docs/clients/gremlin-console/index.html
+++ b/cn/docs/clients/gremlin-console/index.html
@@ -1,8 +1,12 @@
-<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
-单机离线调用模式 Client/Server 请求模式 注:Gremlin-Console 只是便于用户快速上手体验,不建议在生产环境中使用。"><link rel=canonical href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/><link rel=alternate hreflang=en-US href=https://hugegraph.apache.org/docs/clients/gremlin-console/><link rel=alternate hreflang=zh-CN href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/><meta property="og:locale:alternate" content="en_US"><meta property="og:url" content="https://hugegraph.apache.org/cn/docs/clients/ [...]
-单机离线调用模式 Client/Server 请求模式 注:Gremlin-Console 只是便于用户快速上手体验,不建议在生产环境中使用。"><meta property="og:locale" content="zh_CN"><meta property="og:type" content="article"><meta property="article:section" content="docs"><meta property="article:modified_time" content="2026-09-06T20:07:51+05:30"><meta property="og:image" content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta itemprop=name content="Gremlin-Console"><meta itemprop=description content="Gremlin-Console 是由 Tinkerpop 自己 [...]
-单机离线调用模式 Client/Server 请求模式 注:Gremlin-Console 只是便于用户快速上手体验,不建议在生产环境中使用。"><meta itemprop=dateModified content="2026-09-06T20:07:51+05:30"><meta itemprop=wordCount content="1051"><meta itemprop=image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:card content="summary_large_image"><meta name=twitter:image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:title content="Gremlin-Console"><meta name=twitter:des [...]
-单机离线调用模式 Client/Server 请求模式 注:Gremlin-Console 只是便于用户快速上手体验,不建议在生产环境中使用。"><link rel=preload href=https://hugegraph.apache.org/scss/main.min.fa8bb553ea6f16a972e22510cefd5bf77b8474fbee1474dc452465ab36c84c0a.css as=style integrity="sha256-+ou1U+pvFqly4iUQzv1b93uEdPvuFHTcRSRlqzbITAo=" crossorigin=anonymous><link href=https://hugegraph.apache.org/scss/fontawesome.min.d1b0898e80994c0e0be2e673debfd8c2e5eb8c0b96d55c483e1be19cb01e5d10.css rel=stylesheet integrity="sha256-0bCJjoCZTA4L4uZz3r/YwuXrjA [...]
+<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
+单机离线调用模式 Client/Server 请求模式 Gremlin-Console 适合学习和调试。生产应用建议使用对应语言的客户端。
+1 单机离线调用模式 Server 发行包内的 Console 已包含 HugeGraph-Core JAR 和插件,可以直接执行 Groovy 脚本操作图,无需启动 Server。"><link rel=canonical href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/><link rel=alternate hreflang=en-US href=https://hugegraph.apache.org/docs/clients/gremlin-console/><link rel=alternate hreflang=zh-CN href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/><meta property="og:locale:alternate" content="en_US"><meta property="og:url" content="https://hugegraph.apache. [...]
+单机离线调用模式 Client/Server 请求模式 Gremlin-Console 适合学习和调试。生产应用建议使用对应语言的客户端。
+1 单机离线调用模式 Server 发行包内的 Console 已包含 HugeGraph-Core JAR 和插件,可以直接执行 Groovy 脚本操作图,无需启动 Server。"><meta property="og:locale" content="zh_CN"><meta property="og:type" content="article"><meta property="article:section" content="docs"><meta property="article:modified_time" content="2026-10-23T04:09:50+08:00"><meta property="og:image" content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta itemprop=name content="Gremlin-Console"><meta itemprop=description content="Gremlin-Con [...]
+单机离线调用模式 Client/Server 请求模式 Gremlin-Console 适合学习和调试。生产应用建议使用对应语言的客户端。
+1 单机离线调用模式 Server 发行包内的 Console 已包含 HugeGraph-Core JAR 和插件,可以直接执行 Groovy 脚本操作图,无需启动 Server。"><meta itemprop=dateModified content="2026-10-23T04:09:50+08:00"><meta itemprop=wordCount content="1006"><meta itemprop=image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:card content="summary_large_image"><meta name=twitter:image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:title content="Gremlin-Console"><m [...]
+单机离线调用模式 Client/Server 请求模式 Gremlin-Console 适合学习和调试。生产应用建议使用对应语言的客户端。
+1 单机离线调用模式 Server 发行包内的 Console 已包含 HugeGraph-Core JAR 和插件,可以直接执行 Groovy 脚本操作图,无需启动 Server。"><link rel=preload href=https://hugegraph.apache.org/scss/main.min.fa8bb553ea6f16a972e22510cefd5bf77b8474fbee1474dc452465ab36c84c0a.css as=style integrity="sha256-+ou1U+pvFqly4iUQzv1b93uEdPvuFHTcRSRlqzbITAo=" crossorigin=anonymous><link href=https://hugegraph.apache.org/scss/fontawesome.min.d1b0898e80994c0e0be2e673debfd8c2e5eb8c0b96d55c483e1be19cb01e5d10.css rel=stylesheet integrity="sha256-0bCJjo [...]
 <span class=td-nav-title>HugeGraph</span></a><div class="td-nav-links td-nav-menu-zone"><div class=td-nav-menu data-td-navbar-menu><a class="nav-link td-nav-menu__parent-link active" href=https://hugegraph.apache.org/cn/docs/ data-td-navbar-level=0 data-td-navbar-kind=link data-td-navbar-route aria-label=文档 data-td-navbar-region=desktop data-td-navbar-label=文档 data-td-navbar-external=false aria-controls=td-navbar-desktop-docs-0 aria-expanded=false><i class="fa-solid fa-book" aria-hidden= [...]
 <span class=td-navbar-entry__label>文档</span></a><div class=td-nav-menu__panel id=td-navbar-desktop-docs-0 data-td-navbar-panel hidden><a class=td-nav-menu__item-link href=https://hugegraph.apache.org/cn/docs/quickstart/ data-td-navbar-level=1 data-td-navbar-kind=link aria-label=开始 data-td-navbar-region=desktop data-td-navbar-label=开始 data-td-navbar-external=false><i class="fa-solid fa-rocket" aria-hidden=true></i>
 <span class=td-navbar-entry__label>开始</span></a>
@@ -74,7 +78,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -100,9 +104,9 @@
 <span class="td-page-actions__icon td-page-actions__icon--done"><i class="td-shell-icon td-shell-icon--check fa-solid fa-check" aria-hidden=true></i></span>
 </button>
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/clien [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/clients/gremlin-console/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/clien [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span class=na>backend</span><span class=o>=</span><span class=s>memory</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>然后输入下述命令:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class="td-code__utilities td-code__utilities--com [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>serializer</span><span class=o>=</span><span class=s>text</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>然后运行示例脚本。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=14><div class="td-code__utilities td-code__utilities--com [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln> 1</span><span class=cl>&gt; ./bin/gremlin-console.sh -- -i scripts/example.groovy
 </span></span><span class=line><span class=ln> 2</span><span class=cl>
 </span></span><span class=line><span class=ln> 3</span><span class=cl>         <span class=se>\,</span>,,/
@@ -116,7 +120,7 @@
 </span></span><span class=line><span class=ln>11</span><span class=cl>model load finished, <span class=nb>time</span> elapsed <span class=m>35</span> ms.
 </span></span><span class=line><span class=ln>12</span><span class=cl>&gt;&gt;&gt;&gt; query all vertices: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
 </span></span><span class=line><span class=ln>13</span><span class=cl>&gt;&gt;&gt;&gt; query all edges: <span class=nv>size</span><span class=o>=</span><span class=m>6</span>
-</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/ [...]
+</span></span><span class=line><span class=ln>14</span><span class=cl>gremlin&gt; </span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><blockquote><p>这里的 <code>--</code> 会被 getopts 解析为最后一个 option,这样后面的 options 就可以传入 Gremlin-Console 进行处理了。<code>-i</code> 代表 <code>Execute the specified script and leave the console open on completion</code>,更多的选项可以参考 Gremlin-Console 的<a href=https://github.com/apache/tinkerpop/blob/ [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln> 1</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>g</span><span class=o>.</span><span class=na>V</span><span class=o>()</span>
 </span></span><span class=line><span class=ln> 2</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>2</span><span class=o>:</span><span class=n>lop</span><span class=o>]</span>
 </span></span><span class=line><span class=ln> 3</span><span class=cl><span class=o>==&gt;</span><span class=n>v</span><span class=o>[</span><span class=mi>1</span><span class=o>:</span><span class=n>josh</span><span class=o>]</span>
@@ -131,50 +135,41 @@
 </span></span><span class=line><span class=ln>12</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>1</span><span class=o>&gt;&gt;</span><span class=nl>S1:</span><span class=n>vadas</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>knows</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>13</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>marko</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>marko</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
 </span></span><span class=line><span class=ln>14</span><span class=cl><span class=o>==&gt;</span><span class=n>e</span><span class=o>[</span><span class=nl>S1:</span><span class=n>peter</span><span class=o>&gt;</span><span class=mi>2</span><span class=o>&gt;&gt;</span><span class=nl>S2:</span><span class=n>lop</span><span class=o>][</span><span class=mi>1</span><span class=o>:</span><span class=n>peter</span><span class=o>-</span><span class=n>created</span><span class=o>-&gt;</span><spa [...]
-</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=2-clientserver-请求模式>2 Client/Server 请求模式<a class=td-heading-self-link href=#2-clientserver-%e8%af%b7%e6%b1%82%e6%a8%a1%e5%bc%8f ar [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=c># vim conf/gremlin-server.yaml</span><span class=w>
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=c># ......</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>channelizer</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=c># ......</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>确认 <code>host</code>、<code>port</code> 与 <code>remote.yaml</code> 一致,然后按照<a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>步骤</a>启动 HugeGraph-Server。</p><p>下面进入 Gremlin-Console:</p><div class="td-code td-code--untitled" i [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>&gt; ./bin/gremlin-console.sh
-</span></span><span class=line><span class=ln>2</span><span class=cl>
-</span></span><span class=line><span class=ln>3</span><span class=cl>         <span class=se>\,</span>,,/
-</span></span><span class=line><span class=ln>4</span><span class=cl>         <span class=o>(</span>o o<span class=o>)</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>-----oOOo-<span class=o>(</span>3<span class=o>)</span>-oOOo-----
-</span></span><span class=line><span class=ln>6</span><span class=cl>plugin activated: HugeGraph
-</span></span><span class=line><span class=ln>7</span><span class=cl>plugin activated: tinkerpop.server
-</span></span><span class=line><span class=ln>8</span><span class=cl>plugin activated: tinkerpop.utilities
-</span></span><span class=line><span class=ln>9</span><span class=cl>plugin activated: tinkerpop.tinkergraph</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>连接 Server,需在配置文件中指定连接参数,在 conf 目录下有一个默认的 <code>remote.yaml</code>:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-5 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=10><div class="td-code__utilities td-cod [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln> 1</span><span class=cl><span class=c># cat conf/remote.yaml</span><span class=w>
-</span></span></span><span class=line><span class=ln> 2</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 3</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
-</span></span></span><span class=line><span class=ln> 4</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 5</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 6</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=w>
-</span></span></span><span class=line><span class=ln> 7</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=p>,</span><span class=w>
-</span></span></span><span class=line><span class=ln> 8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span><span class=w>
-</span></span></span><span class=line><span class=ln> 9</span><span class=cl><span class=w>  </span>}<span class=w>
-</span></span></span><span class=line><span class=ln>10</span><span class=cl>}</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>如果 Server 开启了鉴权模式,需要在同一个文件中补上凭据:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hi [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>username</span><span class=p>:</span><span class=w> </span><span class=l>admin</span><span class=w>
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=l>pa</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p><code>conf</code> 目录下还提供了 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code>,它们使用相同的 host、port 和序列化器配置。</p><div class="td-code td-code--untitled" id=td-code-41dd [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=o>:</span><span class=n>remote</span> <span class=n>connect</span> <span class=n>tinkerpop</span><span class=o>.</span><sp [...]
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>==&gt;Configured localhost/</span><span class=mf>127.0</span><span class=o>.</span><span class=mf>0.1</span><span class=o>:</span><span class=mi>8182</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>Server 端的图以图空间限定名绑定,因此图空间 <code>DEFAULT</code> 下的图 <code>hugegraph</code> 绑定名为 <code>DEFAULT-hugegraph</code>,其 tr [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=kn>import</span> <span class=nn>org.apache.tinkerpop.gremlin.driver.Cluster</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>6</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=o>==&gt;</span><span class=mi>6</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> <span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>();</span> <span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><blockquote><p>注意:在 Client/Server 模式下,所 [...]
-<span>最后修改 2026-09-06 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/b61447d1aadf1062cf7ba57e4d3cf88461044546>doc(server): sync dist with master (#489) (b61447d1a)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/clients/hugegraph-client/ aria-label="上一页 - HugeGraph Java Client" title="HugeGraph Java Client" dat [...]
+</span></span><span class=line><span class=ln>15</span><span class=cl><span class=n>gremlin</span><span class=o>&gt;</span> </span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>更多的 Gremlin 语句请参考 <a href=http://tinkerpop.apache.org/docs/current/reference/>Tinkerpop 官网</a>。</p><h3 id=2-clientserver-请求模式>2 Client/Server 请求模式<a class=td-heading-self-link href=#2-clientserver-%e8%af%b7%e6%b1%82%e6%a8%a1%e5%bc%8f ar [...]
+保留文件中的序列化器配置,只修改地址,以及启用鉴权时需要的凭据。旧版配置可能引用已经不存在的序列化器类。</p><ol class=steps><li><p>准备连接配置并启动 Server。</p><p>检查 <code>conf/gremlin-server.yaml</code> 中的 <code>host</code>、<code>port</code>。默认的 <code>WsAndHttpChannelizer</code> 同时处理 WebSocket 和 HTTP 请求,无需修改。
+<code>conf/remote.yaml</code> 中的 <code>hosts</code> 应填写 Console 能访问的 Server 地址,<code>port</code> 应与 Gremlin 端口一致(默认为 <code>8182</code>,不是 REST 端口 <code>8080</code>)。
+按照<a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>快速上手</a>启动 Server。</p><p>当前 master 配置使用 GraphBinary V1 和 HugeGraph 类型注册器。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-3 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-41ddd794-fence-3 data-td-copy-mo [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>hosts</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>localhost]</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>port</span><span class=p>:</span><span class=w> </span><span class=m>8182</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=nt>serializer</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>className</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>serializeResultToString</span><span class=p>:</span><span class=w> </span><span class=kc>false</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>builder</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>ioRegistries</span><span class=p>:</span><span class=w> </span><span class=p>[</span><span class=l>org.apache.hugegraph.io.HugeGraphIoRegistry]</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>如果 Server 开启了鉴权,在同一个文件中填写实际凭据。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-f [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>username</span><span class=p>:</span><span class=w> </span><span class=l>admin</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>password</span><span class=p>:</span><span class=w> </span><span class=s2>&#34;replace-with-your-password&#34;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>随包的 <code>remote-objects.yaml</code> 和 <code>gremlin-driver-settings.yaml</code> 使用相同的序列化器配置;使用这些文件时也要保持一致。</p></li><li><p>从 Server 发行包目录启动 Console,并创建带 [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>./bin/gremlin-console.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>Server 端将默认图空间下的图绑定为 <code>DEFAULT-h [...]
+由于连字符 <code>-</code> 在 Groovy 中不能直接用作变量名,通过 Java Driver 连接时,使用 <code>.alias(['g': '__g_DEFAULT-hugegraph'])</code> 将其映射为 <code>g</code>。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-6 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=3><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-41ddd794-fence-6 data-td-copy-mode=all data-td-label- [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=kn>import</span> <span class=nn>org.apache.tinkerpop.gremlin.driver.Cluster</span>
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span> <span class=o>=</span> <span class=n>Cluster</span><span class=o>.</span><span class=na>open</span><span class=o>(</span><span class=s1>&#39;conf/remote.yaml&#39;</span><span class=o>)</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=n>client</span> <span class=o>=</span> <span class=n>cluster</span><span class=o>.</span><span class=na>connect</span><span class=o>().</span><span class=na>alias</span><span class=o>([</span><span class=s1>&#39;g&#39;</span><span class=o>:</span> <span class=s1>&#39;__g_DEFAULT-hugegraph&#39;</span><span class=o>])</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-liv [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().count()&#39;</span><span class=o>).</span><span class=na>all</s [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>submit</span><span class=o>(</span><span class=s1>&#39;g.V().toList().size()&#39;</span><span class=o>).</span><span class=na>all</span><span class=o>().</span><span class=na>get</span><span class=o>()[</span><span class=mi>0</span><span class=o>].</span><span class=na>object</span></span></span></code></pre></div></div><span class=visually-hidden role=stat [...]
+通过 Driver 的 <code>client.submit()</code> 提交脚本时,无需在语句前加 <code>:></code> 前缀。</p></li><li><p>使用结束后关闭客户端和集群连接。</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-8 data-td-code data-td-code-auto-id data-td-language=groovy data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-41ddd794-fence-8 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=n>client</span><span class=o>.</span><span class=na>close</span><span class=o>()</span>
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>cluster</span><span class=o>.</span><span class=na>close</span><span class=o>()</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div></li></ol><p>此外,也可以使用 Gremlin Console 内置的 <code>:remote</code> 命令连接:</p><div class="td-code td-code--untitled" id=td-code-41ddd794-fence-9 data-td-code data-td-code-auto-id data-td-language=groo [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-41ddd794-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=ln>1</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>connect</span> <span class=n>tinkerpop</span><span class=o>.</span><span class=na>server</span> <span class=n>conf</span><sp [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=s>/</span><span class=o>/</span> <span class=err>通过</span> <span class=n>Console</span> <span class=err>远程连接提交脚本时,前缀使用</span> <span class=o>:&gt;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=o>:</span><span class=n>remote</span> <span class=n>close</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>使用 <code>:remote</code> 连接时,以 <code>:></code> 开头的语句会被发送至远端 Server 执行,普通语句则在 Console 本地执行。</p><p>更多用法见 <a href=https://tinkerpop.apache.org/docs/current/reference/#gremlin-console>TinkerPop Gremlin Console 参考</a>。</p [...]
+<span>最后修改 2026-10-23 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/efa1d042316e3f18caef4a642a685f38d2ec596f>docs: refresh bilingual guides and screenshots in core modules (#545) (efa1d0423)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/clients/hugegraph-client/ aria-label="上一页 - HugeGraph Java Client" title [...]
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/ aria-label="下一页 - HugeGraph RESTful API" title="RESTful API" data-td-pager-next><span class=td-pager__title dir=auto>RESTful API</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shel [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-单机离线调用模式>1 单机离线调用模式</a></li><li><a href=#2- [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/language/hugegraph-example/>HugeGraph Examples</a></li></ul></div></div></div></div></div></ [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/language/hugegraph-example/>HugeGraph Examples</a></li></ul></div></div></div></div></div></ [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/gremlin-console/index.md b/cn/docs/clients/gremlin-console/index.md
index 968233d8f..623ccb37e 100644
--- a/cn/docs/clients/gremlin-console/index.md
+++ b/cn/docs/clients/gremlin-console/index.md
@@ -4,25 +4,25 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 
 ---
 
-Gremlin-Console 是由 Tinkerpop 自己开发的一个交互式客户端,用户可以使用该客户端对 Graph 做各种操作,主要有两种使用模式:
+Gremlin-Console 是 TinkerPop 的交互式客户端,支持离线操作图,也可以连接 Server 提交查询。
 
 - 单机离线调用模式
 - Client/Server 请求模式
 
-**注:Gremlin-Console 只是便于用户快速上手体验,不建议在生产环境中使用。**
+Gremlin-Console 适合学习和调试。生产应用建议使用对应语言的客户端。
 
 ### 1 单机离线调用模式
 
-由于 lib 目录下已经包含了 HugeCore 的 jar 包,且 HugeGraph-Server 已经作为插件注册到 Gremlin-Console 中,用户可以直接写 Groovy 脚本调用 HugeGraph-Core 的代码,然后交由 Gremlin-Console 内的解析引擎执行,就能在**不启动** Server 的情况下操作图。
+Server 发行包内的 Console 已包含 HugeGraph-Core JAR 和插件,可以直接执行 Groovy 脚本操作图,无需启动 Server。
 
-这里提供一个示例,首先修改 `hugegraph.properties` 配置使用 Memory 后端 (使用其他后端可能会出现一些初始化问题):
+先在 `hugegraph.properties` 中配置 Memory 后端。其他后端可能需要额外初始化。
 
 ```properties
 backend=memory
 serializer=text
 ```
 
-然后输入下述命令:
+然后运行示例脚本。
 
 ```bash
 > ./bin/gremlin-console.sh -- -i scripts/example.groovy
@@ -45,7 +45,7 @@ gremlin>
 
 其中 [`example.groovy`](https://github.com/apache/hugegraph/blob/master/hugegraph-server/hugegraph-dist/src/assembly/static/scripts/example.groovy) 是 scripts 目录下的一个示例脚本,该脚本插入了一些数据,并在最后查询图中顶点和边的数量。
 
-此时还可以继续输入 Gremlin 语句对图进行操作:
+脚本执行后,可以继续输入 Gremlin 语句。
 
 ```groovy
 gremlin> g.V()
@@ -69,76 +69,81 @@ gremlin>
 
 ### 2 Client/Server 请求模式
 
-Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。默认配置使用 `WsAndHttpChannelizer`,可同时处理 WebSocket 和 HTTP 请求,无需切换 Channelizer。
+Gremlin-Console 通过 WebSocket 连接 HugeGraph-Server。使用与 Server 同版本发行包中的 Console 和 `conf/remote.yaml`,
+保留文件中的序列化器配置,只修改地址,以及启用鉴权时需要的凭据。旧版配置可能引用已经不存在的序列化器类。
 
-```yaml
-# vim conf/gremlin-server.yaml
-# ......
-channelizer: org.apache.tinkerpop.gremlin.server.channel.WsAndHttpChannelizer
-# ......
-```
+1. 准备连接配置并启动 Server。
 
-确认 `host`、`port` 与 `remote.yaml` 一致,然后按照[步骤](/cn/docs/quickstart/hugegraph/hugegraph-server/)启动 HugeGraph-Server。
+   检查 `conf/gremlin-server.yaml` 中的 `host`、`port`。默认的 `WsAndHttpChannelizer` 同时处理 WebSocket 和 HTTP 请求,无需修改。
+   `conf/remote.yaml` 中的 `hosts` 应填写 Console 能访问的 Server 地址,`port` 应与 Gremlin 端口一致(默认为 `8182`,不是 REST 端口 `8080`)。
+   按照[快速上手](/cn/docs/quickstart/hugegraph/hugegraph-server/)启动 Server。
 
-下面进入 Gremlin-Console:
+   当前 master 配置使用 GraphBinary V1 和 HugeGraph 类型注册器。
 
-```bash
-> ./bin/gremlin-console.sh
+   ```yaml
+   hosts: [localhost]
+   port: 8182
+   serializer:
+     className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1
+     config:
+       serializeResultToString: false
+       builder: org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder
+       ioRegistries: [org.apache.hugegraph.io.HugeGraphIoRegistry]
+   ```
 
-         \,,,/
-         (o o)
------oOOo-(3)-oOOo-----
-plugin activated: HugeGraph
-plugin activated: tinkerpop.server
-plugin activated: tinkerpop.utilities
-plugin activated: tinkerpop.tinkergraph
-```
+   如果 Server 开启了鉴权,在同一个文件中填写实际凭据。
 
-连接 Server,需在配置文件中指定连接参数,在 conf 目录下有一个默认的 `remote.yaml`:
-
-```yaml
-# cat conf/remote.yaml
-hosts: [localhost]
-port: 8182
-serializer: {
-  className: org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV1d0,
-  config: {
-    serializeResultToString: false,
-    ioRegistries: [org.apache.hugegraph.io.HugeGraphIoRegistry]
-  }
-}
-```
+   ```yaml
+   username: admin
+   password: "replace-with-your-password"
+   ```
 
-如果 Server 开启了鉴权模式,需要在同一个文件中补上凭据:
+   随包的 `remote-objects.yaml` 和 `gremlin-driver-settings.yaml` 使用相同的序列化器配置;使用这些文件时也要保持一致。
 
-```yaml
-username: admin
-password: pa
-```
+1. 从 Server 发行包目录启动 Console,并创建带 traversal 别名的客户端。
 
-`conf` 目录下还提供了 `remote-objects.yaml` 和 `gremlin-driver-settings.yaml`,它们使用相同的 host、port 和序列化器配置。
+   ```bash
+   ./bin/gremlin-console.sh
+   ```
 
-```groovy
-gremlin> :remote connect tinkerpop.server conf/remote.yaml
-==>Configured localhost/127.0.0.1:8182
-```
+   Server 端将默认图空间下的图绑定为 `DEFAULT-hugegraph`,其 traversal source 绑定为 `__g_DEFAULT-hugegraph`。
+   由于连字符 `-` 在 Groovy 中不能直接用作变量名,通过 Java Driver 连接时,使用 `.alias(['g': '__g_DEFAULT-hugegraph'])` 将其映射为 `g`。
+
+   ```groovy
+   import org.apache.tinkerpop.gremlin.driver.Cluster
+   cluster = Cluster.open('conf/remote.yaml')
+   client = cluster.connect().alias(['g': '__g_DEFAULT-hugegraph'])
+   ```
+
+1. 通过客户端提交查询。
+
+   ```groovy
+   client.submit('g.V().count()').all().get()[0].object
+   client.submit('g.V().toList().size()').all().get()[0].object
+   ```
+
+   若启动 Server 时预加载了示例图,两条查询均返回 `6`(其他图返回其实际顶点数)。
+   通过 Driver 的 `client.submit()` 提交脚本时,无需在语句前加 `:>` 前缀。
+
+1. 使用结束后关闭客户端和集群连接。
+
+   ```groovy
+   client.close()
+   cluster.close()
+   ```
+{.steps}
 
-Server 端的图以图空间限定名绑定,因此图空间 `DEFAULT` 下的图 `hugegraph` 绑定名为 `DEFAULT-hugegraph`,其 traversal source 绑定名为 `__g_DEFAULT-hugegraph`。裸写 `hugegraph` 在 Server 端无法解析,而 `DEFAULT-hugegraph` 又不是合法的 Groovy 标识符,所以远程脚本需要通过别名访问 traversal source。如果启动 HugeGraph-Server 时预加载了示例图,查询方式如下:
+此外,也可以使用 Gremlin Console 内置的 `:remote` 命令连接:
 
 ```groovy
-gremlin> import org.apache.tinkerpop.gremlin.driver.Cluster
-gremlin> cluster = Cluster.open('conf/remote.yaml')
-gremlin> client = cluster.connect().alias(['g': '__g_DEFAULT-hugegraph'])
-gremlin> client.submit('g.V().count()').all().get()[0].object
-==>6
-gremlin> client.submit('g.V().toList().size()').all().get()[0].object
-==>6
-gremlin> client.close(); cluster.close()
+:remote connect tinkerpop.server conf/remote.yaml
+// 通过 Console 远程连接提交脚本时,前缀使用 :>
+:remote close
 ```
 
-> 注意:在 Client/Server 模式下,所有和 Server 有关的操作都要加上 `:> `,如果不加,表示在 console 本地操作。`:> ` 发送的脚本不带别名,因此只能使用 Server 自身已绑定的名称。
+使用 `:remote` 连接时,以 `:>` 开头的语句会被发送至远端 Server 执行,普通语句则在 Console 本地执行。
 
-更多关于 Gremlin-Console 的使用,请参考 [Tinkerpop 官网](http://tinkerpop.apache.org/docs/current/reference/)。
+更多用法见 [TinkerPop Gremlin Console 参考](https://tinkerpop.apache.org/docs/current/reference/#gremlin-console)。
 
 ---
 
diff --git a/cn/docs/clients/hugegraph-client/index.html b/cn/docs/clients/hugegraph-client/index.html
index 7d7aebc15..512b59444 100644
--- a/cn/docs/clients/hugegraph-client/index.html
+++ b/cn/docs/clients/hugegraph-client/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -215,7 +215,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-hugegraph-client>1 HugeGraph-Client</a></li [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/client/hugegraph-client/>Java 客户端</a></li><li class=td-shell-backlinks__item><a h [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/client/hugegraph-client/>Java 客户端</a></li><li class=td-shell-backlinks__item><a h [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/index.html b/cn/docs/clients/index.html
index 1e3b154cb..bcae4126e 100644
--- a/cn/docs/clients/index.html
+++ b/cn/docs/clients/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -98,7 +98,7 @@
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/clients/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/clients/_index.md tar [...]
 <span>最后修改 2026-09-20 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/a7dad55a26a84d778a77cb6fd0f00d4d8c17d887>feat: complete OINK site integration (#493) (a7dad55a2)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph-ai/rest-api/ aria-label="上一页 - HugeGraph-LLM REST API" title="REST API" data- [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/hugegraph-client/ aria-label="下一页 - HugeGraph Java Client" title="HugeGraph Java Client" data-td-pager-next><span class=td-pager__title dir=auto>HugeGraph Java Client</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/hugegraph-client/ aria-label="下一页 - HugeGraph Java Client" title="HugeGraph Java Client" data-td-pager-next><span class=td-pager__title dir=auto>HugeGraph Java Client</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/index.xml b/cn/docs/clients/index.xml
index 7201cc400..caacb4996 100644
--- a/cn/docs/clients/index.xml
+++ b/cn/docs/clients/index.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>客户端与 API on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/clients/</link><description>Recent content in 客户端与 API on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 02 Oct 2026 18:55:26 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/clients/index.xml" rel="s [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>客户端与 API on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/clients/</link><description>Recent content in 客户端与 API on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 23 Oct 2026 04:09:50 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/clients/index.xml" rel="s [...]
\ No newline at end of file
diff --git a/cn/docs/clients/restful-api/auth/index.html b/cn/docs/clients/restful-api/auth/index.html
index 8e6728cdc..3b974c601 100644
--- a/cn/docs/clients/restful-api/auth/index.html
+++ b/cn/docs/clients/restful-api/auth/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -569,7 +569,7 @@ P.gte(18)),properties 如果为 null 表示任意属性均可,如果属性
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#101-用户认证与权限控制>10.1 用户认证与权限控制</a></li><li><a h [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/cypher/index.html b/cn/docs/clients/restful-api/cypher/index.html
index ba4276819..ba05caa90 100644
--- a/cn/docs/clients/restful-api/cypher/index.html
+++ b/cn/docs/clients/restful-api/cypher/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -151,7 +151,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#91-cypher>9.1 Cypher</a></li></ul></li></ul>< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/language/>查询语言</a></li></ul></div></div></div></div></div></aside><div class="td-shell-toc-f [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/language/>查询语言</a></li></ul></div></div></div></div></div></aside><div class="td-shell-toc-f [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/edge/index.html b/cn/docs/clients/restful-api/edge/index.html
index 375650bb2..8ea06a4fd 100644
--- a/cn/docs/clients/restful-api/edge/index.html
+++ b/cn/docs/clients/restful-api/edge/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -379,7 +379,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/variable/ aria-label="下一页 - Variable API" title=Variable data-td-pager-next><span class=td-pager__title dir=auto>Variable</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside- [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#22-edge>2.2 Edge</a></li></ul></li></ul></nav [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#22-edge>2.2 Edge</a></li></ul></li></ul></nav [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/edgelabel/index.html b/cn/docs/clients/restful-api/edgelabel/index.html
index 2cac046e8..ffa5b7e87 100644
--- a/cn/docs/clients/restful-api/edgelabel/index.html
+++ b/cn/docs/clients/restful-api/edgelabel/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -279,7 +279,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/indexlabel/ aria-label="下一页 - IndexLabel API" title=IndexLabel data-td-pager-next><span class=td-pager__title dir=auto>IndexLabel</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shel [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#14-edgelabel>1.4 EdgeLabel</a></li></ul></li> [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#14-edgelabel>1.4 EdgeLabel</a></li></ul></li> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/graphs/index.html b/cn/docs/clients/restful-api/graphs/index.html
index 639e86420..646da29d6 100644
--- a/cn/docs/clients/restful-api/graphs/index.html
+++ b/cn/docs/clients/restful-api/graphs/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -358,7 +358,7 @@ Server 将句柄绑定到实际鉴权用户;token 本身不赋予权限。申
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#61-graphs>6.1 Graphs</a></li><li><a href=#62- [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/graphspace/index.html b/cn/docs/clients/restful-api/graphspace/index.html
index b009f38e0..0ba7b5de4 100644
--- a/cn/docs/clients/restful-api/graphspace/index.html
+++ b/cn/docs/clients/restful-api/graphspace/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -310,7 +310,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#20-graphspace>2.0 Graphspace</a></li></ul></l [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/auth/ title="Authentication(认证鉴权)REST 接口:管理用户、角色、权限和访问控制,实现细粒度的图数据安全机制。" [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/auth/ title="Authentication(认证鉴权)REST 接口:管理用户、角色、权限和访问控制,实现细粒度的图数据安全机制。" [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/gremlin/index.html b/cn/docs/clients/restful-api/gremlin/index.html
index cbf3cfd4b..4c3a9f154 100644
--- a/cn/docs/clients/restful-api/gremlin/index.html
+++ b/cn/docs/clients/restful-api/gremlin/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -177,7 +177,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#81-gremlin>8.1 Gremlin</a></li></ul></li></ul [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/task/ title="Task(任务管理)REST 接口:查询和管理异步任务的执行状态,如索引重建、图遍历等长时任务。">Task</a>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/task/ title="Task(任务管理)REST 接口:查询和管理异步任务的执行状态,如索引重建、图遍历等长时任务。">Task</a>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/index.html b/cn/docs/clients/restful-api/index.html
index a207b0fcc..0269b0b67 100644
--- a/cn/docs/clients/restful-api/index.html
+++ b/cn/docs/clients/restful-api/index.html
@@ -78,7 +78,7 @@ Server 启动后,可访问 http://localhost:8080/swagger-ui/index.html 查看
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -110,7 +110,7 @@ Server 启动后,可访问 http://localhost:8080/swagger-ui/index.html 查看
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphs/ aria-label="下一页 - Graphs API" title=Graphs data-td-pager-next><span class=td-pager__title dir=auto>Graphs</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc__title-bt [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/introduction/>系统介绍</a></li><li class=td-shell-backlinks__item><a href=https://hugegraph.apac [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/introduction/>系统介绍</a></li><li class=td-shell-backlinks__item><a href=https://hugegraph.apac [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/indexlabel/index.html b/cn/docs/clients/restful-api/indexlabel/index.html
index 4b3a34402..e87ef834c 100644
--- a/cn/docs/clients/restful-api/indexlabel/index.html
+++ b/cn/docs/clients/restful-api/indexlabel/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -211,7 +211,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/vertex/ aria-label="下一页 - Vertex API" title=Vertex data-td-pager-next><span class=td-pager__title dir=auto>Vertex</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#15-indexlabel>1.5 IndexLabel</a></li></ul></l [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#15-indexlabel>1.5 IndexLabel</a></li></ul></l [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/metrics/index.html b/cn/docs/clients/restful-api/metrics/index.html
index 0d6af27df..ecf9e99ae 100644
--- a/cn/docs/clients/restful-api/metrics/index.html
+++ b/cn/docs/clients/restful-api/metrics/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -1233,7 +1233,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/other/ aria-label="下一页 - Other API" title=Other data-td-pager-next><span class=td-pager__title dir=auto>Other</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-she [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#1-基础指标>1. 基础指标</a><ul><li><a href=#11-获取所有基础指标>1.1 获取 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#1-基础指标>1. 基础指标</a><ul><li><a href=#11-获取所有基础指标>1.1 获取 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/other/index.html b/cn/docs/clients/restful-api/other/index.html
index ce18918dd..32e82bcf9 100644
--- a/cn/docs/clients/restful-api/other/index.html
+++ b/cn/docs/clients/restful-api/other/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -233,7 +233,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#111-other>11.1 Other</a></li></ul></li></ul>< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphspace/ title="Graphspace(图空间)REST 接口:多租户与资源隔离的创建、查看、更新与删除,以及使用前置条件与 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/propertykey/index.html b/cn/docs/clients/restful-api/propertykey/index.html
index 92c218364..fd4c285f7 100644
--- a/cn/docs/clients/restful-api/propertykey/index.html
+++ b/cn/docs/clients/restful-api/propertykey/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -235,7 +235,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/vertexlabel/ aria-label="下一页 - VertexLabel API" title=VertexLabel data-td-pager-next><span class=td-pager__title dir=auto>VertexLabel</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td- [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#12-propertykey>1.2 PropertyKey</a></li></ul>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#12-propertykey>1.2 PropertyKey</a></li></ul>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/rank/index.html b/cn/docs/clients/restful-api/rank/index.html
index 0efacc003..14dc9fd1d 100644
--- a/cn/docs/clients/restful-api/rank/index.html
+++ b/cn/docs/clients/restful-api/rank/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -342,7 +342,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/metrics/ aria-label="下一页 - Metrics API" title=Metrics data-td-pager-next><span class=td-pager__title dir=auto>Metrics</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-grou [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#41-rank-api-概述>4.1 rank API 概述</a></li><li><a [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#41-rank-api-概述>4.1 rank API 概述</a></li><li><a [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/rebuild/index.html b/cn/docs/clients/restful-api/rebuild/index.html
index 7759be3bf..daf0e7a87 100644
--- a/cn/docs/clients/restful-api/rebuild/index.html
+++ b/cn/docs/clients/restful-api/rebuild/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -116,7 +116,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/rank/ aria-label="下一页 - Rank API" title=Rank data-td-pager-next><span class=td-pager__title dir=auto>Rank</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-a [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#16-rebuild>1.6 Rebuild</a></li></ul></li></ul [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#16-rebuild>1.6 Rebuild</a></li></ul></li></ul [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/schema/index.html b/cn/docs/clients/restful-api/schema/index.html
index 05028b176..2d4fb8a89 100644
--- a/cn/docs/clients/restful-api/schema/index.html
+++ b/cn/docs/clients/restful-api/schema/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -399,7 +399,10 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/propertykey/ aria-label="下一页 - PropertyKey API" title=PropertyKey data-td-pager-next><span class=td-pager__title dir=auto>PropertyKey</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td- [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#11-schema>1.1 Schema</a></li></ul></li></ul>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#11-schema>1.1 Schema</a></li></ul></li></ul>< [...]
+<span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
+<span class=td-shell-aside-group__title>反链</span>
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/>备份 & 恢复</a></li></ul></div></div></div></div></div></aside><div class [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/schema/index.md b/cn/docs/clients/restful-api/schema/index.md
index 20ead9423..e1eb9e335 100644
--- a/cn/docs/clients/restful-api/schema/index.md
+++ b/cn/docs/clients/restful-api/schema/index.md
@@ -324,3 +324,9 @@ e.g: GET http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema
     ]
 }
 ```
+
+---
+
+反链:
+
+- [备份 & 恢复](/cn/docs/guides/backup-restore/)
diff --git a/cn/docs/clients/restful-api/task/index.html b/cn/docs/clients/restful-api/task/index.html
index 0a916b95d..cb87b0433 100644
--- a/cn/docs/clients/restful-api/task/index.html
+++ b/cn/docs/clients/restful-api/task/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -175,7 +175,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#71-task>7.1 Task</a></li><li><a href=#72-algo [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/edgelabel/ title="EdgeLabel(边标签)REST 接口:定义边类型、源顶点和目标顶点的关系约束,构建图的连接规则。">E [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/edgelabel/ title="EdgeLabel(边标签)REST 接口:定义边类型、源顶点和目标顶点的关系约束,构建图的连接规则。">E [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/traverser/index.html b/cn/docs/clients/restful-api/traverser/index.html
index e58e74614..d22f5ae3b 100644
--- a/cn/docs/clients/restful-api/traverser/index.html
+++ b/cn/docs/clients/restful-api/traverser/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -1951,7 +1951,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/task/ aria-label="下一页 - Task API" title=Task data-td-pager-next><span class=td-pager__title dir=auto>Task</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-a [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#31-traverser-api-概述>3.1 traverser API 概述</a>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#31-traverser-api-概述>3.1 traverser API 概述</a>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/variable/index.html b/cn/docs/clients/restful-api/variable/index.html
index 77a5e3d13..be1147b56 100644
--- a/cn/docs/clients/restful-api/variable/index.html
+++ b/cn/docs/clients/restful-api/variable/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -121,7 +121,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/gremlin/ aria-label="下一页 - Gremlin API" title=Gremlin data-td-pager-next><span class=td-pager__title dir=auto>Gremlin</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-grou [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#51-variables>5.1 Variables</a></li></ul></li> [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#51-variables>5.1 Variables</a></li></ul></li> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/vertex/index.html b/cn/docs/clients/restful-api/vertex/index.html
index b78de35f2..4ebc88216 100644
--- a/cn/docs/clients/restful-api/vertex/index.html
+++ b/cn/docs/clients/restful-api/vertex/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -395,7 +395,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/edge/ aria-label="下一页 - Edge API" title=Edge data-td-pager-next><span class=td-pager__title dir=auto>Edge</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-a [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#vertex-api>2.1 Vertex</a><ul><li><a href=#create-vert [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#vertex-api>2.1 Vertex</a><ul><li><a href=#create-vert [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/clients/restful-api/vertexlabel/index.html b/cn/docs/clients/restful-api/vertexlabel/index.html
index 06df32daf..47d977755 100644
--- a/cn/docs/clients/restful-api/vertexlabel/index.html
+++ b/cn/docs/clients/restful-api/vertexlabel/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -275,7 +275,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/clients/restful-api/edgelabel/ aria-label="下一页 - EdgeLabel API" title=EdgeLabel data-td-pager-next><span class=td-pager__title dir=auto>EdgeLabel</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-as [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#13-vertexlabel>1.3 VertexLabel</a></li></ul>< [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#13-vertexlabel>1.3 VertexLabel</a></li></ul>< [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-authentication/index.html b/cn/docs/config/config-authentication/index.html
index 8112492a1..6122a5d2a 100644
--- a/cn/docs/config/config-authentication/index.html
+++ b/cn/docs/config/config-authentication/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
+<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
 <span class=td-nav-title>HugeGraph</span></a><div class="td-nav-links td-nav-menu-zone"><div class=td-nav-menu data-td-navbar-menu><a class="nav-link td-nav-menu__parent-link active" href=https://hugegraph.apache.org/cn/docs/ data-td-navbar-level=0 data-td-navbar-kind=link data-td-navbar-route aria-label=文档 data-td-navbar-region=desktop data-td-navbar-label=文档 data-td-navbar-external=false aria-controls=td-navbar-desktop-docs-0 aria-expanded=false><i class="fa-solid fa-book" aria-hidden= [...]
 <span class=td-navbar-entry__label>文档</span></a><div class=td-nav-menu__panel id=td-navbar-desktop-docs-0 data-td-navbar-panel hidden><a class=td-nav-menu__item-link href=https://hugegraph.apache.org/cn/docs/quickstart/ data-td-navbar-level=1 data-td-navbar-kind=link aria-label=开始 data-td-navbar-region=desktop data-td-navbar-label=开始 data-td-navbar-external=false><i class="fa-solid fa-rocket" aria-hidden=true></i>
 <span class=td-navbar-entry__label>开始</span></a>
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -96,20 +96,22 @@
 <span class="td-page-actions__icon td-page-actions__icon--done"><i class="td-shell-icon td-shell-icon--check fa-solid fa-check" aria-hidden=true></i></span>
 </button>
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/config/config-authentication/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/ [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/config/config-authentication/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/ [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=ln>1</span><span class=cl><span class=c1>// 场景:某用户只有北京地区的数据读取权限</span><span class=w>
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=n>user</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </span><span class=o>-</span><span class=n>belong</span><span class=o>-&gt;</span><span class=w> </span><span class=n>group</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>xx</span><span class=p>)</span><span class=w> </s [...]
+<code>audit-*.log</code>,部署时必须保留并限制这些日志的读取权限。<code>auth.audit_log_rate</code> 只限制每用户的日志输出速率,不是审计日志的启停开关。</p></div></div><p><code>StandardAuthenticator</code> 支持多用户认证和细粒度权限控制。也可以实现 <code>HugeAuthenticator</code> 接口来接入已有的用户系统。</p><p>用户认证使用 <a href=https://zh.wikipedia.org/wiki/HTTP%E5%9F%BA%E6%9C%AC%E8%AE%A4%E8%AF%81>HTTP Basic Authentication</a>。<code>Basic</code> 后面的值是 <code>用户名:密码</code> 的 Base64 编码。使用 curl 时可直接通过
+<code>-u</code> 传入凭据。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-1 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label-error=复制失败 aria-label=复制代码 title=复制代码>
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>curl -u <span class=s1>&#39;admin:&lt;password&gt;&#39;</span> <span class=se>\
 </span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><div class="td-callout td-callout--warning" role=note><div class=td-callout__title><i class="td-callout__icon fa-solid fa-triangle-exclamation" aria-hidden=true></i><span class=td-callout__label>警告</span></d [...]
-源码默认会生成 32 个随机字节并以 Base64 编码,但该值不会写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥:</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-co [...]
+核心配置默认会生成 32 个随机字节并以 Base64 编码,该默认值不会自行写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥。</p><p>Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-2 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class= [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span class=c1># 在每个 Server 节点的认证图配置中填写同一个值</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1>< [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>openssl rand -base64 <span class=m>32</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>由于默认值在每次启动时随机生成, [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.token_secret</span><span class=o>=</span><span class=s>&lt;本机生成的密钥&gt;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-3 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1>< [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>openssl rand -base64 <span class=m>32</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>token 的有效期由 <cod [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>authentication</span><span class=p>:</span><span class=w> </span>{<span class=w>
 </span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>authenticator</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.StandardAuthenticator,</span><span class=w>
 </span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>authenticationHandler</span><span class=p>:</span><span class=w> </span><span class=l>org.apache.hugegraph.auth.WsAndHttpBasicAuthHandler,</span><span class=w>
 </span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>  </span><span class=nt>config</span><span class=p>:</span><span class=w> </span>{<span class=nt>tokens</span><span class=p>:</span><span class=w> </span><span class=l>conf/rest-server.properties}</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>在 <code>rest-server.properties</code> 中配置认证器和权限数据存储图:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class="td-code__utilities td-code__utilities--compact"><button class=td [...]
+</span></span></span><span class=line><span class=ln>5</span><span class=cl>}</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>在 <code>conf/rest-server.properties</code> 中配置认证器和权限数据存储图。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-5 data-td-code data-td-code-auto-id data-td-language=properties data-td-line-count=9><div class="td-code__utilities td-code__utilities--compact"><button cla [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span class=na>auth.authenticator</span><span class=o>=</span><span class=s>org.apache.hugegraph.auth.StandardAuthenticator</span>
 </span></span><span class=line><span class=ln>2</span><span class=cl><span class=na>auth.graph_store</span><span class=o>=</span><span class=s>hugegraph</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=c1># Server 启动路径首次创建内置 admin 账号时使用,默认值为公开的 pa,生产部署前务必显式设置强密码</span>
@@ -118,37 +120,68 @@
 </span></span><span class=line><span class=ln>6</span><span class=cl>
 </span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># auth client config</span>
 </span></span><span class=line><span class=ln>8</span><span class=cl><span class=c1># 如果是分开部署 GraphServer 和 AuthServer,还需要指定下面的配置,地址填写 AuthServer 的 IP:RPC 端口</span>
-</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>其中,<code>graph_store</code>配置项是指使用哪一个图来存储用户信息,如果存在多个图的话,选取任意一个均可。</p><p>在配置文件<code>hugegraph{n}.properties</code>中配置<code>gremlin.graph</code>信息:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff- [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span class=na>gremlin.graph</span><span class=o>=</span><span class=s>org.apache.hugegraph.auth.HugeFactoryAuthProxy</span></span></span></code></pre></div></div><span class=visua [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=c1># stop the hugeGraph firstly</span>
-</span></span><span class=line><span class=ln>2</span><span class=cl>bin/stop-hugegraph.sh
-</span></span><span class=line><span class=ln>3</span><span class=cl>
-</span></span><span class=line><span class=ln>4</span><span class=cl><span class=c1># 初始化认证系统信息;已有后端数据会被保留</span>
-</span></span><span class=line><span class=ln>5</span><span class=cl>bin/init-store.sh
-</span></span><span class=line><span class=ln>6</span><span class=cl>
-</span></span><span class=line><span class=ln>7</span><span class=cl><span class=c1># start hugeGraph again</span>
-</span></span><span class=line><span class=ln>8</span><span class=cl>bin/start-hugegraph.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h3 id=使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式<a class=td-heading-self-link href=#%e4%bd%bf%e7%94%a8-docker-%e6%97%b6%e5%bc%80%e5%90%af%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h3><p>对于镜像 <code>hugegraph/hugegraph</code> 大于等于 <code>1.2.0</code> 的版本,我们可以在启动 <c [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker run -itd -e <span class=nv>PASSWORD</span><span class=o>=</span>xxx --name<span class=o>=</span>server -p 8080:8080 hugegraph/hugegraph:1.7.0</span></span></code></pre></div></div><span [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>version</span><span class=p>:</span><span class=w> </span><span class=s1>&#39;3&#39;</span><span class=w>
-</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>hugegraph/hugegraph:1.7.0</span><span class=w>
-</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
-</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>      </span>- <span class=m>8080</span><span class=p>:</span><span class=m>8080</span><span class=w>
-</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
-</span></span></span><span class=line><span class=ln>9</span><span class=cl><span class=w>      </span>- <span class=l>PASSWORD=xxx</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h4 id=3-进入容器后重新开启鉴权模式>3. 进入容器后重新开启鉴权模式<a class=td-heading-self-link href=#3-%e8%bf%9b%e5%85%a5%e5%ae%b9%e5%99%a8%e5%90%8e%e9%87%8d%e6%96%b0%e5%bc%80%e5%90%af%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h4><p>首先 [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker <span class=nb>exec</span> -it server bash
-</span></span><span class=line><span class=ln>2</span><span class=cl><span class=c1># 用于快速修改配置, 修改前的文件被保存在conf-bak文件夹下</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>之后参照 <a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#%e5%9f%ba%e4%ba%8e%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f%e5%90%af%e5%8a%a8>基于鉴权模式启动</a> 即可</p><template data-hg-authored-content=end></template><div class=td-page-end><section class=td-page-annot [...]
-<span>最后修改 2026-09-30 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/a8c6857943e0deb84b4bbdfde79a76a0e80d8de1>docs: sync core modules guides (#501) (a8c685794)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/config/config-option/ aria-label="上一页 - Server 完整配置手册" title="Server 完整配置手册" data-td-pager-prev><span cl [...]
+</span></span><span class=line><span class=ln>9</span><span class=cl><span class=c1>#auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p><code>auth.graph_store</code> 指定保存认证数据的图,名称必须与 <code>conf/graphs/</code> 中的图配置对应。</p><p>在每个受保护图的配置文件 <code>conf/graphs/&lt;graph>.properties</code> 中设置 <code>gremlin.graph</code>。</p><div class="td-code td-co [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-properties data-lang=properties><span class=line><span class=ln>1</span><span class=cl><span class=na>gremlin.graph</span><span class=o>=</span><span class=s>org.apache.hugegraph.auth.HugeFactoryAuthProxy</span></span></span></code></pre></div></div><span class=visua [...]
+HStore/PD 部署的管理员由 PD 启动路径创建,须按该部署的配置设置 <code>auth.admin_pa</code>,不要照搬本地后端的交互式初始化流程。</p><ol class=steps><li><p><strong>停止 Server。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-7 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-7 data-td-copy-mode=all data-td-label- [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/stop-hugegraph.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div></li><li><p><strong>初始化认证数据。</strong></p>< [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/init-store.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>首次创建 <code>admin</code> 时,按提示输入强密码。已有图数据会保留 [...]
+此命令补充后端与认证系统信息,不需要删除原有存储目录。</p></li><li><p><strong>启动并检查认证。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-9 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=3><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-9 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label-error=复制失败 aria-label [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/start-hugegraph.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>curl -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>curl 会提示输入密码。正确密码应返回 HTTP 200;不带凭据或使用错误密码应返回 HTTP 401。
+启动失败时先检查日志和认证图配置,不要通过清空数据来重试。</p></li></ol><h3 id=使用-docker-时开启鉴权模式>使用 Docker 时开启鉴权模式<a class=td-heading-self-link href=#%e4%bd%bf%e7%94%a8-docker-%e6%97%b6%e5%bc%80%e5%90%af%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h3><p>新容器在 Docker run 和 Compose 中选择一种方式。已经运行过的容器直接阅读<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#3-%e8%bf%9b%e5%85%a5%e5%ae%b9%e5%99%a8%e5%90%8e%e9%87%8d%e6%96%b0%e5%bc%80%e5%90%af%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f>既有容器</a>。</p [...]
+将占位符替换为实际镜像标签或 digest:</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-10 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-10 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label-error=复制失败 aria-label=复制代码 title=复制代码>
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>export</span> <span class=nv>HUGEGRAPH_IMAGE</span><span class=o>=</span><span class=s1>&#39;&lt;image:tag-or-digest&gt;&#39;</span>
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>read</span> -r -s -p <span class=s1>&#39;Admin password: &#39;</span> PASSWORD
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nb>printf</span> <span class=s1>&#39;\n&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nb>export</span> PASSWORD</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>提示输入管理员密码后执行启动命令。为保障凭据安全,请避免将密码以明文形式提交到共享 Compose 文件中。
+JWT 密钥仍按<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#%e9%85%8d%e7%bd%ae%e7%94%a8%e6%88%b7%e8%ae%a4%e8%af%81>上面的配置</a>持久保存到认证图配置;多节点必须使用同一个值。</p><h4 id=1-采用-docker-run>Docker run<a class=td-heading-self-link href=#1-%e9%87%87%e7%94%a8-docker-run aria-label=标题锚点></a></h4><p>创建一个新容器,并仅向本机开放 REST 端口。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-11 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class="td-c [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker run -d --name server <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  -p 127.0.0.1:8080:8080 <span class=se>\
+</span></span></span><span class=line><span class=ln>3</span><span class=cl>  -e PASSWORD <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  <span class=s2>&#34;</span><span class=nv>$HUGEGRAPH_IMAGE</span><span class=s2>&#34;</span>
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>入口脚本完成认证配置和首次初始化后启动 Server。接着阅读<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#%e6%a3%80%e6%9f%a5%e8%ae%a4%e8%af%81%e7%bb%93%e6%9e%9c>检查认证结果</a>。</p><h4 id=2-采用-docker-compose>Docker Compose<a class=td-heading-self-link href=#2- [...]
+在同一终端中启动服务。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-12 data-td-code data-td-code-auto-id data-td-language=yaml data-td-line-count=8><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-12 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label-error=复制失败 aria-label=复制代码 title=复制代码>
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><span class=line><span class=ln>1</span><span class=cl><span class=nt>services</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>2</span><span class=cl><span class=w>  </span><span class=nt>server</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>3</span><span class=cl><span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class=l>${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}</span><span class=w>
+</span></span></span><span class=line><span class=ln>4</span><span class=cl><span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class=l>server</span><span class=w>
+</span></span></span><span class=line><span class=ln>5</span><span class=cl><span class=w>    </span><span class=nt>ports</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>6</span><span class=cl><span class=w>      </span>- <span class=s2>&#34;127.0.0.1:8080:8080&#34;</span><span class=w>
+</span></span></span><span class=line><span class=ln>7</span><span class=cl><span class=w>    </span><span class=nt>environment</span><span class=p>:</span><span class=w>
+</span></span></span><span class=line><span class=ln>8</span><span class=cl><span class=w>      </span><span class=nt>PASSWORD</span><span class=p>:</span><span class=w> </span><span class=l>${PASSWORD:?Set PASSWORD}</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-13 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-cou [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-13-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker compose up -d
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nb>unset</span> PASSWORD</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>以后重新创建容器前,需要重新设置这些变量。保留已有数据卷,并按部署要求持久保存配置。
+接着阅读<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#%e6%a3%80%e6%9f%a5%e8%ae%a4%e8%af%81%e7%bb%93%e6%9e%9c>检查认证结果</a>。</p><h4 id=3-进入容器后重新开启鉴权模式>既有容器<a class=td-heading-self-link href=#3-%e8%bf%9b%e5%85%a5%e5%ae%b9%e5%99%a8%e5%90%8e%e9%87%8d%e6%96%b0%e5%bc%80%e5%90%af%e9%89%b4%e6%9d%83%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h4><p>此路径适用于原先未开启认证、使用本地持久化后端的官方 Server 容器。
+先备份数据,并确认配置、后端数据及 <code>conf-bak</code> 均位于容器挂载的持久卷中。
+官方镜像将 <code>/hugegraph-server</code> 声明为卷;自定义镜像应先检查挂载位置。
+HStore/PD 或外部认证服务使用各自的管理员初始化流程。</p><ol class=steps><li><p><strong>停止原容器,使用同一镜像和数据卷打开临时维护容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-14 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-14 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 d [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-14-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nv>SERVER_IMAGE</span><span class=o>=</span><span class=k>$(</span>docker inspect --format <span class=s1>&#39;{{.Image}}&#39;</span> server<span class=k>)</span>
+</span></span><span class=line><span class=ln>2</span><span class=cl>docker stop server
+</span></span><span class=line><span class=ln>3</span><span class=cl>docker run --rm -it --volumes-from server <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  --entrypoint bash <span class=s2>&#34;</span><span class=nv>$SERVER_IMAGE</span><span class=s2>&#34;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>原容器须保持停止,防止两个 JVM 同时打开本地数据库。<code>--entrypoint bash</code> 使维护容器只打开终端。</p></li><li><p><strong>在维护容器内修改配置并初始化。</strong></p><div class="td-code td-code--untitled" id=td-code-bbe [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-15-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nb>cd</span> /hugegraph-server
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/enable-auth.sh</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p><code>enable-auth.sh</code> 首次运行时将原配置保存到 <code>conf-bak</code>,然后修改默认 <code>hugegraph</code> 图和认证配置。
+如果 <code>conf-bak</code> 已存在,脚本会跳过修改,须按<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#standardauthenticator-%e6%a8%a1%e5%bc%8f>StandardAuthenticator 模式</a>检查三处配置。
+使用其他认证图时也应手动配置对应文件。
+按<a href=https://hugegraph.apache.org/cn/docs/config/config-authentication/#%e9%85%8d%e7%bd%ae%e7%94%a8%e6%88%b7%e8%ae%a4%e8%af%81>上面的配置</a>将强随机 JWT 密钥写入认证图配置,再运行初始化命令。</p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-16 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-bbebf2ff-fence-16 data [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-16-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/init-store.sh
+</span></span><span class=line><span class=ln>2</span><span class=cl>exit</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>按提示输入管理员密码,确认初始化成功后退出。</p></li><li><p><strong>在宿主机启动原容器。</strong></p><div class="td-code td-code--untitled" id=td-code-bbebf2ff-fence-17 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=1><div class="td-code__utilities td-code__utilities--compact"><button class [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-17-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>docker start server</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>不需要删除 <code>docker/init_complete</code>  [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-bbebf2ff-fence-18-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+</span></span><span class=line><span class=ln>3</span><span class=cl>curl -sS -o /dev/null -w <span class=s1>&#39;%{http_code}\n&#39;</span> -u admin <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>未携带凭据的请求预期返回 <code>401 Unauthorized</code>,输入正确密码的请求返回 <code>200 OK</code>(若输入错误密码则同样返回 <code>401</code>)。
+注:当前主线版本 URL 包含 <code>/graphspaces/DEFAULT</code>,1.7.0 等历史版本请省略 graphspace 前缀(直接使用 <code>/graphs/hugegraph/...</code>)。
+若未提供凭据仍返回 <code>200</code>,说明鉴权未成功启用,请检查配置并重启 Server。</p><template data-hg-authored-content=end></template><div class=td-page-end><section class=td-page-annotation data-td-page-annotation aria-label=页面信息><div class=td-page-meta__footer><div class="td-page-meta__item td-page-meta__lastmod"><span class=td-page-meta__icon><i class="fa-solid fa-clock-rotate-left" aria-hidden=true></i></span>
+<span>最后修改 2026-10-23 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/efa1d042316e3f18caef4a642a685f38d2ec596f>docs: refresh bilingual guides and screenshots in core modules (#545) (efa1d0423)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/config/config-option/ aria-label="上一页 - Server 完整配置手册" title="Server 完整配 [...]
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/config/config-https/ aria-label="下一页 - 配置 HugeGraphServer 使用 https 协议" title="配置 HTTPS" data-td-pager-next><span class=td-pager__title dir=auto>配置 HTTPS</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-s [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#配置用户认证>配置用户认证</a>< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.3.0-release-notes/>Release-1.3.0</a></li><li class=td-shell-backlinks_ [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/changelog/hugegraph-1.3.0-release-notes/>Release-1.3.0</a></li><li class=td-shell-backlinks_ [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-authentication/index.md b/cn/docs/config/config-authentication/index.md
index 0d86c8182..9cdc238c8 100644
--- a/cn/docs/config/config-authentication/index.md
+++ b/cn/docs/config/config-authentication/index.md
@@ -8,13 +8,11 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 
 HugeGraph 内置 `StandardAuthenticator`,支持多用户认证和基于“用户、用户组、操作、资源”的权限控制。
 
-`StandardAuthenticator` 模式的几个核心设计:
-- 初始化时创建超级管理员 (`admin`) 用户,后续通过超级管理员创建其它用户,新创建的用户被分配足够权限后,可以创建或管理更多的用户
-- 支持动态创建用户、用户组、资源,支持动态分配或取消权限
-- 用户可以属于一个或多个用户组,每个用户组可以拥有对任意个资源的操作权限,操作类型包括:读、写、删除、执行等种类
-- "资源" 描述了图数据库中的数据,比如符合某一类条件的顶点,每一个资源包括 `type`、`label`、`properties`三个要素,共有 18 种类型、任意 label、任意 properties 可组合形成的资源,一个资源的内部条件是且关系,多个资源之间的条件是或关系
+初始化会创建超级管理员 `admin`。管理员可创建用户、用户组及资源,并分配或撤销权限。用户通过所属组获得读、写、删除和执行等权限。
 
-举例说明:
+资源用 `type`、`label` 和 `properties` 描述可访问的数据。同一资源中的条件需同时满足,多个资源之间满足其一即可。
+
+下面的关系表示用户仅可读取北京地区的数据。
 
 ```java
 // 场景:某用户只有北京地区的数据读取权限
@@ -28,11 +26,13 @@ HugeGraph 目前默认**未启用**用户认证功能,需通过修改配置文
 > [!WARNING]
 > **生产环境必须启用鉴权**
 >
-> HugeGraph 默认不启用用户认证。生产环境必须启用认证与授权、设置非默认强管理员密码、启用并维护 Server IP 白名单,并按最小权限为用户授权;不得将 Gremlin、Cypher 等查询接口直接暴露到公网。Server 标准配置会将鉴权代理记录写入 `audit-*.log`,部署时必须保留并限制这些日志的读取权限。`auth.audit_log_rate` 只限制每用户的日志输出速率,不是审计日志的启停开关。
+> HugeGraph 默认不启用用户认证。生产环境必须启用认证与授权、设置非默认强管理员密码、启用并维护 Server IP 白名单,并按最小权限为用户授权;不得将 Gremlin、Cypher 等查询接口直接暴露到公网。Server 标准配置会将鉴权代理记录写入
+`audit-*.log`,部署时必须保留并限制这些日志的读取权限。`auth.audit_log_rate` 只限制每用户的日志输出速率,不是审计日志的启停开关。
 
 `StandardAuthenticator` 支持多用户认证和细粒度权限控制。也可以实现 `HugeAuthenticator` 接口来接入已有的用户系统。
 
-用户认证使用 [HTTP Basic Authentication](https://zh.wikipedia.org/wiki/HTTP%E5%9F%BA%E6%9C%AC%E8%AE%A4%E8%AF%81)。`Basic` 后面的值是 `用户名:密码` 的 Base64 编码。使用 curl 时可直接通过 `-u` 传入凭据:
+用户认证使用 [HTTP Basic Authentication](https://zh.wikipedia.org/wiki/HTTP%E5%9F%BA%E6%9C%AC%E8%AE%A4%E8%AF%81)。`Basic` 后面的值是 `用户名:密码` 的 Base64 编码。使用 curl 时可直接通过
+`-u` 传入凭据。
 
 ```bash
 curl -u 'admin:<password>' \
@@ -50,7 +50,7 @@ curl -u 'admin:<password>' \
 > HugeGraph-Server 1.5.0 之前的版本在鉴权模式下存在 JWT 相关安全隐患。使用受影响版本时必须升级,或按该版本要求修改 JWT token 的 `secretKey`。
 
 `auth.token_secret` 由认证数据图的配置读取。默认认证图名为 `hugegraph`,因此配置文件通常是 `conf/graphs/hugegraph.properties`;如果修改了 `auth.graph_store`,应改为对应图的 properties 文件。
-源码默认会生成 32 个随机字节并以 Base64 编码,但该值不会写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥:
+核心配置默认会生成 32 个随机字节并以 Base64 编码,该默认值不会自行写回配置文件;重启后或多个 Server 节点之间无法依赖各自生成的默认值保持一致。若需要令已有 token 在重启后继续有效,或让多个节点验证同一 token,请为认证图显式配置同一个强随机密钥。
 
 Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,密钥至少需要 32 字节;这是字节长度要求,不代表任意 32 字符串都具有足够随机性。下面的命令在本机生成 32 个随机字节并以 Base64 编码。
 
@@ -59,20 +59,20 @@ Server 将配置字符串按 UTF-8 编码后交给 JJWT 的 HS256 签名器,
 auth.token_secret=<本机生成的密钥>
 ```
 
-可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志:
+可在本机终端生成密钥,再通过安全方式填入认证图配置;不要把实际密钥提交到代码库或公开日志。
 
 ```bash
 openssl rand -base64 32
 ```
 
-由于默认值在每次启动时随机生成,当 token 需要在重启后继续有效、或者需要被多个服务节点接受时,必须显式配置该项。token 的有效期由 `auth.token_expire` 决定,默认为 86400 秒。
+token 的有效期由 `auth.token_expire` 决定,默认为 86400 秒。
 
 `auth.token_expire` 和 `auth.token_secret` 都属于 `auth.graph_store` 指定的认证数据图配置;`rest-server.properties` 中的同名项不会覆盖认证图配置。
 
 #### StandardAuthenticator 模式
-`StandardAuthenticator`模式是通过在数据库后端存储用户信息来支持用户认证和权限控制,该实现基于数据库存储的用户的名称与密码进行认证(密码已被加密),基于用户的角色来细粒度控制用户权限。下面是具体的配置流程(重启服务生效):
+`StandardAuthenticator` 在后端存储用户及密码哈希,并按用户角色控制访问。修改以下三处配置后,按[启动顺序](#基于鉴权模式启动)初始化并重启服务。
 
-在配置文件`gremlin-server.yaml`中配置`authenticator`及其`rest-server`文件路径:
+在 `conf/gremlin-server.yaml` 中配置认证器及 REST 配置路径。
 
 ```yaml
 authentication: {
@@ -82,7 +82,7 @@ authentication: {
 }
 ```
 
-在 `rest-server.properties` 中配置认证器和权限数据存储图:
+在 `conf/rest-server.properties` 中配置认证器和权限数据存储图。
 
 ```properties
 auth.authenticator=org.apache.hugegraph.auth.StandardAuthenticator
@@ -96,9 +96,9 @@ auth.graph_store=hugegraph
 #auth.remote_url=127.0.0.1:8899,127.0.0.1:8898,127.0.0.1:8897
 ```
 
-其中,`graph_store`配置项是指使用哪一个图来存储用户信息,如果存在多个图的话,选取任意一个均可。
+`auth.graph_store` 指定保存认证数据的图,名称必须与 `conf/graphs/` 中的图配置对应。
 
-在配置文件`hugegraph{n}.properties`中配置`gremlin.graph`信息:
+在每个受保护图的配置文件 `conf/graphs/<graph>.properties` 中设置 `gremlin.graph`。
 
 ```properties
 gremlin.graph=org.apache.hugegraph.auth.HugeFactoryAuthProxy
@@ -108,65 +108,155 @@ gremlin.graph=org.apache.hugegraph.auth.HugeFactoryAuthProxy
 
 ### 自定义用户认证系统
 
-如果需要支持更加灵活的用户系统,可自定义 authenticator 进行扩展,自定义 authenticator 实现接口`org.apache.hugegraph.auth.HugeAuthenticator`即可,然后修改配置文件中`authenticator`配置项指向该实现。
+实现 `org.apache.hugegraph.auth.HugeAuthenticator` 接口,再将两处 `authenticator` 配置指向该实现,即可接入已有用户系统。
 
 ### 基于鉴权模式启动
 
-首次执行 `init-store.sh` 时,如果尚未创建 `admin` 用户,命令会要求输入管理员密码。对于已经初始化的持久化后端,`init-store.sh` 会补充认证所需的系统信息,无需删除原有图数据。
+下面的顺序适用于本地持久化后端,例如 RocksDB。先完成上面的配置,再初始化认证数据。
+HStore/PD 部署的管理员由 PD 启动路径创建,须按该部署的配置设置 `auth.admin_pa`,不要照搬本地后端的交互式初始化流程。
 
-```bash
-# stop the hugeGraph firstly
-bin/stop-hugegraph.sh
+1. **停止 Server。**
 
-# 初始化认证系统信息;已有后端数据会被保留
-bin/init-store.sh
+   ```bash
+   bin/stop-hugegraph.sh
+   ```
 
-# start hugeGraph again
-bin/start-hugegraph.sh
+1. **初始化认证数据。**
 
-```
+   ```bash
+   bin/init-store.sh
+   ```
+
+   首次创建 `admin` 时,按提示输入强密码。已有图数据会保留;已有 `admin` 时不会重新设置其密码。
+   此命令补充后端与认证系统信息,不需要删除原有存储目录。
+
+1. **启动并检查认证。**
+
+   ```bash
+   bin/start-hugegraph.sh
+   curl -u admin \
+     http://localhost:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+   ```
+
+   curl 会提示输入密码。正确密码应返回 HTTP 200;不带凭据或使用错误密码应返回 HTTP 401。
+   启动失败时先检查日志和认证图配置,不要通过清空数据来重试。
+{.steps}
 
 ### 使用 Docker 时开启鉴权模式
 
-对于镜像 `hugegraph/hugegraph` 大于等于 `1.2.0` 的版本,我们可以在启动 `docker` 镜像的同时开启鉴权模式
+新容器在 Docker run 和 Compose 中选择一种方式。已经运行过的容器直接阅读[既有容器](#3-进入容器后重新开启鉴权模式)。
 
-具体做法如下:
+使用 Docker 部署时,官方镜像支持通过环境变量直接开启鉴权模式(适用于官方 Server 镜像 `/hugegraph-server` 布局)。
+将占位符替换为实际镜像标签或 digest:
 
-#### 1. 采用 docker run
+```bash
+export HUGEGRAPH_IMAGE='<image:tag-or-digest>'
+read -r -s -p 'Admin password: ' PASSWORD
+printf '\n'
+export PASSWORD
+```
+
+提示输入管理员密码后执行启动命令。为保障凭据安全,请避免将密码以明文形式提交到共享 Compose 文件中。
+JWT 密钥仍按[上面的配置](#配置用户认证)持久保存到认证图配置;多节点必须使用同一个值。
 
-在 `docker run` 中添加环境变量 `PASSWORD=xxx`(密码可以自由设置)即可开启鉴权模式::
+#### Docker run {#1-采用-docker-run}
+
+创建一个新容器,并仅向本机开放 REST 端口。
 
 ```bash
-docker run -itd -e PASSWORD=xxx --name=server -p 8080:8080 hugegraph/hugegraph:1.7.0
+docker run -d --name server \
+  -p 127.0.0.1:8080:8080 \
+  -e PASSWORD \
+  "$HUGEGRAPH_IMAGE"
+unset PASSWORD
 ```
 
-#### 2. 采用 docker-compose
+入口脚本完成认证配置和首次初始化后启动 Server。接着阅读[检查认证结果](#检查认证结果)。
+
+#### Docker Compose {#2-采用-docker-compose}
 
-使用 `docker-compose` 在环境变量中设置 `PASSWORD=xxx`即可
+将下面的内容保存为 `compose.yaml`。必填变量缺失时,Compose 会报错,避免意外启动无认证服务。
+在同一终端中启动服务。
 
 ```yaml
-version: '3'
 services:
   server:
-    image: hugegraph/hugegraph:1.7.0
+    image: ${HUGEGRAPH_IMAGE:?Set HUGEGRAPH_IMAGE}
     container_name: server
     ports:
-      - 8080:8080
+      - "127.0.0.1:8080:8080"
     environment:
-      - PASSWORD=xxx
+      PASSWORD: ${PASSWORD:?Set PASSWORD}
+```
+
+```bash
+docker compose up -d
+unset PASSWORD
 ```
 
-#### 3. 进入容器后重新开启鉴权模式
+以后重新创建容器前,需要重新设置这些变量。保留已有数据卷,并按部署要求持久保存配置。
+接着阅读[检查认证结果](#检查认证结果)。
+
+#### 既有容器 {#3-进入容器后重新开启鉴权模式}
+
+此路径适用于原先未开启认证、使用本地持久化后端的官方 Server 容器。
+先备份数据,并确认配置、后端数据及 `conf-bak` 均位于容器挂载的持久卷中。
+官方镜像将 `/hugegraph-server` 声明为卷;自定义镜像应先检查挂载位置。
+HStore/PD 或外部认证服务使用各自的管理员初始化流程。
+
+1. **停止原容器,使用同一镜像和数据卷打开临时维护容器。**
+
+   ```bash
+   SERVER_IMAGE=$(docker inspect --format '{{.Image}}' server)
+   docker stop server
+   docker run --rm -it --volumes-from server \
+     --entrypoint bash "$SERVER_IMAGE"
+   ```
+
+   原容器须保持停止,防止两个 JVM 同时打开本地数据库。`--entrypoint bash` 使维护容器只打开终端。
+
+1. **在维护容器内修改配置并初始化。**
+
+   ```bash
+   cd /hugegraph-server
+   bin/enable-auth.sh
+   ```
+
+   `enable-auth.sh` 首次运行时将原配置保存到 `conf-bak`,然后修改默认 `hugegraph` 图和认证配置。
+   如果 `conf-bak` 已存在,脚本会跳过修改,须按[StandardAuthenticator 模式](#standardauthenticator-模式)检查三处配置。
+   使用其他认证图时也应手动配置对应文件。
+   按[上面的配置](#配置用户认证)将强随机 JWT 密钥写入认证图配置,再运行初始化命令。
+
+   ```bash
+   bin/init-store.sh
+   exit
+   ```
+
+   按提示输入管理员密码,确认初始化成功后退出。
+
+1. **在宿主机启动原容器。**
+
+   ```bash
+   docker start server
+   ```
+
+   不需要删除 `docker/init_complete` 标记。后续 `PASSWORD` 环境变量的变化不会修改已存储的管理员密码。
+{.steps}
+
+#### 检查认证结果
 
-首先进入容器:
+等待 Server 启动后,在宿主机执行以下请求验证。`-u admin` 会交互式提示输入密码:
 
 ```bash
-docker exec -it server bash
-# 用于快速修改配置, 修改前的文件被保存在conf-bak文件夹下
-bin/enable-auth.sh
+curl -sS -o /dev/null -w '%{http_code}\n' \
+  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
+curl -sS -o /dev/null -w '%{http_code}\n' -u admin \
+  http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/schema/vertexlabels
 ```
 
-之后参照 [基于鉴权模式启动](#基于鉴权模式启动) 即可
+未携带凭据的请求预期返回 `401 Unauthorized`,输入正确密码的请求返回 `200 OK`(若输入错误密码则同样返回 `401`)。
+注:当前主线版本 URL 包含 `/graphspaces/DEFAULT`,1.7.0 等历史版本请省略 graphspace 前缀(直接使用 `/graphs/hugegraph/...`)。
+若未提供凭据仍返回 `200`,说明鉴权未成功启用,请检查配置并重启 Server。
 
 ---
 
diff --git a/cn/docs/config/config-backend-hbase/index.html b/cn/docs/config/config-backend-hbase/index.html
index 77735dd40..ac4edba3b 100644
--- a/cn/docs/config/config-backend-hbase/index.html
+++ b/cn/docs/config/config-backend-hbase/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -126,7 +126,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#支持的-hbase-版本>支持的 H [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-backend-hstore/index.html b/cn/docs/config/config-backend-hstore/index.html
index 1444599c1..344542538 100644
--- a/cn/docs/config/config-backend-hstore/index.html
+++ b/cn/docs/config/config-backend-hstore/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -127,7 +127,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-概述>1 概述</a></li><li><a href=#2-前置条件>2 前置条件< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-backend-rocksdb/index.html b/cn/docs/config/config-backend-rocksdb/index.html
index aa0410243..6563b6b17 100644
--- a/cn/docs/config/config-backend-rocksdb/index.html
+++ b/cn/docs/config/config-backend-rocksdb/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -152,7 +152,7 @@ WAL 且不做 sync,因为状态机可以通过快照加 raft 日志恢复,
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#选择后端>选择后端</a></li> [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li></ul></div></div></div></div></div></aside><div class="td-shell-to [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-guide/index.html b/cn/docs/config/config-guide/index.html
index 265ce0224..ef55901b6 100644
--- a/cn/docs/config/config-guide/index.html
+++ b/cn/docs/config/config-guide/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -197,7 +197,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-概述>1 概述</a></li><li><a href=#2-gremlin-serv [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/other/ title="Other(其他接口)REST 接口:提供版本查询、API 列表、异常堆栈开关、IP 白名单和 Arthas 诊断代 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/other/ title="Other(其他接口)REST 接口:提供版本查询、API 列表、异常堆栈开关、IP 白名单和 Arthas 诊断代 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-https/index.html b/cn/docs/config/config-https/index.html
index de9acf5e5..26f60d2f3 100644
--- a/cn/docs/config/config-https/index.html
+++ b/cn/docs/config/config-https/index.html
@@ -78,7 +78,7 @@ HTTPS 保护传输链路,但不限制调用者权限。生产环境必须使
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -146,13 +146,13 @@ HTTPS 保护传输链路,但不限制调用者权限。生产环境必须使
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-64e14729-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>keytool -export -alias serverkey -keystore server.keystore -file server.crt</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status>< [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-64e14729-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>keytool -import -alias serverkey -file server.crt -keystore client.truststore</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status [...]
 <span>最后修改 2026-10-12 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/6181c870599030a864303ffa74821925293d1192>feat: upgrade OINK to 1.2.0 and improve docs UX (#514) (6181c8705)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/config/config-authentication/ aria-label="上一页 - HugeGraph 内置用户权限与扩展权限配置及使用" title=权限配置  [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/ aria-label="下一页 - Backup Restore" title="备份 & 恢复" data-td-pager-next><span class=td-pager__title dir=auto>备份 & 恢复</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/ aria-label="下一页 - 备份与恢复" title="备份 & 恢复" data-td-pager-next><span class=td-pager__title dir=auto>备份 & 恢复</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#服务端配置>服务端配置</a></l [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li><li class=td-shell-backlinks__item><a href=https://hugegraph.apach [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/config/>Server 配置</a></li><li class=td-shell-backlinks__item><a href=https://hugegraph.apach [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/config-option/index.html b/cn/docs/config/config-option/index.html
index de3e4214a..ea1d20f1a 100644
--- a/cn/docs/config/config-option/index.html
+++ b/cn/docs/config/config-option/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -107,7 +107,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#gremlin-server-配置项>Gremlin Server 配置项</a></li [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/blog/2025/10/09/toplingdb-quick-start/>ToplingDB 快速上手</a></li><li class=td-shell-backlinks__item> [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/blog/2025/10/09/toplingdb-quick-start/>ToplingDB 快速上手</a></li><li class=td-shell-backlinks__item> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/index.html b/cn/docs/config/index.html
index 8fcc51d5d..43080f6fa 100644
--- a/cn/docs/config/index.html
+++ b/cn/docs/config/index.html
@@ -74,7 +74,7 @@ Server 配置指南 Server 配置选项 认证与授权 HTTPS 配置 后端配
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsconfig-children aria-label="收起章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tre [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -105,7 +105,7 @@ Server 配置指南 Server 配置选项 认证与授权 HTTPS 配置 后端配
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/config/config-guide/ aria-label="下一页 - Server 启动指南" title="Server 启动指南" data-td-pager-next><span class=td-pager__title dir=auto>Server 启动指南</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-gr [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#后端配置>后端配置</a></li></ul></nav></div></div></div></div> [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#后端配置>后端配置</a></li></ul></nav></div></div></div></div> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/config/index.xml b/cn/docs/config/index.xml
index 29be7992f..ef4d5862c 100644
--- a/cn/docs/config/index.xml
+++ b/cn/docs/config/index.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>HugeGraph-Server 配置 on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/config/</link><description>Recent content in HugeGraph-Server 配置 on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Sun, 18 Oct 2026 05:21:43 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/conf [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>HugeGraph-Server 配置 on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/config/</link><description>Recent content in HugeGraph-Server 配置 on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 23 Oct 2026 04:09:50 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/conf [...]
\ No newline at end of file
diff --git a/cn/docs/contribution-guidelines/committer-guidelines/index.html b/cn/docs/contribution-guidelines/committer-guidelines/index.html
index 72caf7a99..40f3eb6d9 100644
--- a/cn/docs/contribution-guidelines/committer-guidelines/index.html
+++ b/cn/docs/contribution-guidelines/committer-guidelines/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -276,7 +276,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/subscribe/ aria-label="下一页 - 订阅社区邮件列表" title=邮件列表 data-td-pager-next><span class=td-pager__title dir=auto>邮件列表</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group t [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#发起社区邮件讨论-discuss>发起社区邮件讨论 (DISCUSS)</a></li><li><a hr [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#发起社区邮件讨论-discuss>发起社区邮件讨论 (DISCUSS)</a></li><li><a hr [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/contribution-guidelines/contribute/index.html b/cn/docs/contribution-guidelines/contribute/index.html
index 9de840a4d..90f3d22f3 100644
--- a/cn/docs/contribution-guidelines/contribute/index.html
+++ b/cn/docs/contribution-guidelines/contribute/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -134,7 +134,7 @@ CI-friendly 版本在 <code>process-resources</code> 阶段展开,安装或发
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#选择贡献方式>选择贡献方式</a></li><li><a href=#准备仓库>准备仓库</a></li> [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/>在 IDEA 中配置 Server 开发环境</a></li><li clas [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/>在 IDEA 中配置 Server 开发环境</a></li><li clas [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/index.html b/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/index.html
index 7482b0831..774783dcb 100644
--- a/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/index.html
+++ b/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -140,7 +140,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#背景>背景</a></li><li><a href=#步骤>步骤</a></li><li> [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/contribution-guidelines/index.html b/cn/docs/contribution-guidelines/index.html
index 17fafd43a..73ee17c65 100644
--- a/cn/docs/contribution-guidelines/index.html
+++ b/cn/docs/contribution-guidelines/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -98,7 +98,7 @@
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/contr [...]
 <span>最后修改 2026-09-04 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/d88167dd797efafea50cec59909d57849703fde5>docs: sync content for 1.7.0 updates (#470) (d88167dd7)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/download/download/ aria-label="上一页 - 下载 Apache HugeGraph" title=Download data-td-pager-prev><span  [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/contribute/ aria-label="下一页 - 参与 HugeGraph 社区" title=贡献流程 data-td-pager-next><span class=td-pager__title dir=auto>贡献流程</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc_ [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/contribute/ aria-label="下一页 - 参与 HugeGraph 社区" title=贡献流程 data-td-pager-next><span class=td-pager__title dir=auto>贡献流程</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc_ [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/contribution-guidelines/subscribe/index.html b/cn/docs/contribution-guidelines/subscribe/index.html
index 33247a59f..5d309a17b 100644
--- a/cn/docs/contribution-guidelines/subscribe/index.html
+++ b/cn/docs/contribution-guidelines/subscribe/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -108,7 +108,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#订阅>订阅</a></li><li><a href=#退订>退订</a></li></ul></nav>< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/committer-guidelines/>Apache HugeGraph Committer 指南</a></li><li clas [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/committer-guidelines/>Apache HugeGraph Committer 指南</a></li><li clas [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/contribution-guidelines/validate-release/index.html b/cn/docs/contribution-guidelines/validate-release/index.html
index 1033955bf..e3cae1508 100644
--- a/cn/docs/contribution-guidelines/validate-release/index.html
+++ b/cn/docs/contribution-guidelines/validate-release/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -245,7 +245,7 @@ LICENSE 是 Apache 2.0, 且对应的项目中包含了 NOTICE, 则还需要更
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#自动化发版验证>自动化发版验证</a></li><li><a href=#验证阶段>验证阶段</a><ul [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/download/download/>Download</a></li></ul></div></div></div></div></div></aside><div class="t [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/download/download/>Download</a></li></ul></div></div></div></div></div></aside><div class="t [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/download/download/index.html b/cn/docs/download/download/index.html
index 5d927bb67..795b5ab70 100644
--- a/cn/docs/download/download/index.html
+++ b/cn/docs/download/download/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -108,7 +108,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#最新版本>最新版本</a></li><li><a href=#归档版本>归档版本</a>< [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-hstore/>安装/构建 HugeGraph-Store</a></li><li class=td-shell-back [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-hstore/>安装/构建 HugeGraph-Store</a></li><li class=td-shell-back [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/download/download/index.md b/cn/docs/download/download/index.md
index edea92955..fd1201910 100644
--- a/cn/docs/download/download/index.md
+++ b/cn/docs/download/download/index.md
@@ -480,3 +480,4 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 - [安装/构建 HugeGraph Server](/cn/docs/quickstart/hugegraph/hugegraph-server/)
 - [Hubble 基础与单机](/cn/docs/quickstart/toolchain/hugegraph-hubble/)
 - [使用 Loader 实时/流式导入数据](/cn/docs/quickstart/toolchain/hugegraph-loader/)
+- [使用 Tools 导出/管理图](/cn/docs/quickstart/toolchain/hugegraph-tools/)
diff --git a/cn/docs/guides/architectural/index.html b/cn/docs/guides/architectural/index.html
index 1376fc2c3..ce6084824 100644
--- a/cn/docs/guides/architectural/index.html
+++ b/cn/docs/guides/architectural/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -105,7 +105,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/desgin-concept/ aria-label="下一页 - HugeGraph 设计理念" title=设计理念(legacy) data-td-pager-next><span class=td-pager__title dir=auto>设计理念(legacy)</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-asi [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#全栈组件>全栈组件</a></li><li><a href=#生态接入>生态接入</a></li><li> [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#全栈组件>全栈组件</a></li><li><a href=#生态接入>生态接入</a></li><li> [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/backup-restore/index.html b/cn/docs/guides/backup-restore/index.html
index c8c2cbf84..c53210b35 100644
--- a/cn/docs/guides/backup-restore/index.html
+++ b/cn/docs/guides/backup-restore/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
+<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
 <span class=td-nav-title>HugeGraph</span></a><div class="td-nav-links td-nav-menu-zone"><div class=td-nav-menu data-td-navbar-menu><a class="nav-link td-nav-menu__parent-link active" href=https://hugegraph.apache.org/cn/docs/ data-td-navbar-level=0 data-td-navbar-kind=link data-td-navbar-route aria-label=文档 data-td-navbar-region=desktop data-td-navbar-label=文档 data-td-navbar-external=false aria-controls=td-navbar-desktop-docs-0 aria-expanded=false><i class="fa-solid fa-book" aria-hidden= [...]
 <span class=td-navbar-entry__label>文档</span></a><div class=td-nav-menu__panel id=td-navbar-desktop-docs-0 data-td-navbar-panel hidden><a class=td-nav-menu__item-link href=https://hugegraph.apache.org/cn/docs/quickstart/ data-td-navbar-level=1 data-td-navbar-kind=link aria-label=开始 data-td-navbar-region=desktop data-td-navbar-label=开始 data-td-navbar-external=false><i class="fa-solid fa-rocket" aria-hidden=true></i>
 <span class=td-navbar-entry__label>开始</span></a>
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -96,31 +96,59 @@
 <span class="td-page-actions__icon td-page-actions__icon--done"><i class="td-shell-icon td-shell-icon--check fa-solid fa-check" aria-hidden=true></i></span>
 </button>
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/ [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph backup -t all -d data</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>该命令将 http://127.0.0.1:808 [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph graph-mode-get</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>该命令用于查看当前图模式,包括:NONE、RESTORING、M [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph graph-mode-set -m RESTORING</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>该命令用于设置图模式,Restore  [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph restore -t all -d data</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>该命令将data目录下的全部元数据和图数据重新导 [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph graph-mode-set -m NONE</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>该命令用于恢复图模式为 NONE。</p><p> [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>GET http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></di [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=mi>200</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h6 id=response-body>Response Body<a c [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=p>{</span>
+<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/ [...]
+它们是 <a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a> 的命令,适合图迁移、升级后的恢复及图合并。</p><h4 id=backup>Backup<a class=td-heading-self-link href=#backup aria-label=标题锚点></a></h4><p>备份可在任意图模式下执行。建议在导出前暂停源图的写入操作,以确保 Schema、顶点和边的数据一致性(分批读取不提供全局事务快照)。
+注意:<code>backup -t all</code> 仅导出图的 Schema 和图数据,不包含系统配置文件与用户权限。</p><h4 id=restore>Restore<a class=td-heading-self-link href=#restore aria-label=标题锚点></a></h4><p>恢复数据前,需先根据目标图的状态切换恢复模式。日常读写处于 <code>NONE</code> 模式;注意:<code>LOADING</code> 模式不能用于 <code>restore</code>。</p><div class=td-table-scroll tabindex=0 role=region aria-label=可横向滚动的表格><table><thead><tr><th scope=col>目标</th><th scope=col>模式</th><th scope=col>Schema ID</th><th scope=col>顶点和边 ID</th></tr></thead><tbody><tr><td>恢复到没有 Schema [...]
+<code>AUTOMATIC</code> 和自定义顶点 ID 保留。合并会复用同名 Schema,先检查双方的定义是否兼容,以及保留的顶点 ID 是否冲突。
+它不提供任意 Schema 冲突或数据冲突的自动解决策略。先在独立目标图验证,再合并正式数据。</p><h2 id=使用方法>使用方法<a class=td-heading-self-link href=#%e4%bd%bf%e7%94%a8%e6%96%b9%e6%b3%95 aria-label=标题锚点></a></h2><p>准备与 Server 版本匹配的 <a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/hugegraph-tools>HugeGraph-Tools</a>,在 Tools 根目录执行以下命令。
+本例从 <code>8080</code> 的源图恢复到 <code>8081</code> 的空目标图。两个 Server 和目标图应已创建并启动;可将变量改成实际地址及图名。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-0 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=5><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-705ab766-fence-0 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label- [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl><span class=nv>SOURCE_URL</span><span class=o>=</span>http://127.0.0.1:8080
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>TARGET_URL</span><span class=o>=</span>http://127.0.0.1:8081
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=nv>SOURCE_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>4</span><span class=cl><span class=nv>TARGET_GRAPH</span><span class=o>=</span>hugegraph
+</span></span><span class=line><span class=ln>5</span><span class=cl><span class=nv>BACKUP_DIR</span><span class=o>=</span><span class=s2>&#34;</span><span class=nv>$PWD</span><span class=s2>/data/hugegraph-backup&#34;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>启用认证时,在每条 Tools 命令的子命令前加入 <code>--user &lt;user> --password &lt;password></code>,并使用具备对应图读写和模式管理权限的账号。
+详细参数及凭据使用方式见 <a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。</p><h4 id=backup-1>Backup<a class=td-heading-self-link href=#backup-1 aria-label=标题锚点></a></h4><p>暂停源图写入后,备份全部 Schema、顶点和边。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-1 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data- [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  backup -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>显式指定的 <code>-d</code> 就是备份目录,不会自动附加图名。为每次备份使用独立目录,避免混入旧文件。
+保留完整目录,包括压缩文件;Restore 可读取 Tools 支持的 JSON 备份格式。</p><h4 id=restore-1>Restore<a class=td-heading-self-link href=#restore-1 aria-label=标题锚点></a></h4><p>以下流程使用 <code>RESTORING</code>。合并时改为 <code>MERGING</code>,并先完成上面的兼容性检查。
+操作期间暂停目标图业务写入。</p><ol class=steps><li><p><span id=步骤1查看并设置图模式></span><strong>查看并记录原模式,再切换。</strong></p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-2 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-705ab766-fence-2 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl><span class=nv>ORIGINAL_MODE</span><span class=o>=</span>NONE
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> <span class=se>\
+</span></span></span><span class=line><span class=ln>4</span><span class=cl>  graph-mode-set -m RESTORING</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>正常业务图应处于 <code>NONE</code>。将查询返回的值填入 <code>ORIGINAL_MODE</code>,例如下方的 <code>NONE</code>。若另一项维护正在使用 <code>RESTORING</code>、<code>MERGING</code> 或 <code>LOADING</code>,先协调该任务,不要覆盖其模式。</p></li><li><p><span id=步骤2restore-数据></span><strong>恢复数据。</strong></p><d [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-3-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2 [...]
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  restore -t all -d <span class=s2>&#34;</span><span class=nv>$BACKUP_DIR</span><span class=s2>&#34;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>检查命令输出与各类型的导入结果。若发生错误,请先保留备份目录与日志,并检查目标图的数据状态。
+Restore 不会自动回滚已写入的数据,切勿在部分恢复的图上盲目重跑。</p></li><li><p><span id=步骤3恢复图模式></span><strong>还原原模式。</strong></p><p>使用第一步记录的 <code>ORIGINAL_MODE</code> 还原模式。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-4 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=2><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-705ab766-fence-4 data-td-copy-mode=all data [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-4-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> graph-mode-get</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>无论恢复成功还是失败,最后都必须将图模式还原为原有模式(通常为 <code>NONE</code>)。
+若恢复失败,先保留现场并排查日志,待重新准备目标图后再恢复业务写入。</p></li></ol><p>还原模式后,对比两端的顶点数和边数。</p><div class="td-code td-code--untitled" id=td-code-705ab766-fence-5 data-td-code data-td-code-auto-id data-td-language=bash data-td-line-count=4><div class="td-code__utilities td-code__utilities--compact"><button class=td-code__copy type=button hidden data-td-code-copy data-td-code-target=td-code-705ab766-fence-5 data-td-copy-mode=all data-td-label-copy=复制代码 data-td-label-copied=已复制 data-td-label-error=复制失败 aria-labe [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-5-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2 [...]
+</span></span><span class=line><span class=ln>2</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.V().count()&#39;</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$SOURCE_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$SOURCE_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span>
+</span></span><span class=line><span class=ln>4</span><span class=cl>bin/hugegraph --url <span class=s2>&#34;</span><span class=nv>$TARGET_URL</span><span class=s2>&#34;</span> --graph <span class=s2>&#34;</span><span class=nv>$TARGET_GRAPH</span><span class=s2>&#34;</span> gremlin-execute --script <span class=s1>&#39;g.E().count()&#39;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>两组计数结果应保持完全一致。建 [...]
+并抽样检查顶点和边的属性与端点关联,确保业务数据的完整性。</p><h4 id=帮助>帮助<a class=td-heading-self-link href=#%e5%b8%ae%e5%8a%a9 aria-label=标题锚点></a></h4><p>更多关于压缩、并发和分类型备份的参数说明,见 <a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/hugegraph-tools>Tools 参考</a>。
+在跨大版本恢复前,建议先在测试环境中验证备份文件的兼容性。</p><h2 id=backuprestore使用和实现的api说明>Backup/Restore使用和实现的API说明<a class=td-heading-self-link href=#backuprestore%e4%bd%bf%e7%94%a8%e5%92%8c%e5%ae%9e%e7%8e%b0%e7%9a%84api%e8%af%b4%e6%98%8e aria-label=标题锚点></a></h2><h4 id=backup-2>Backup<a class=td-heading-self-link href=#backup-2 aria-label=标题锚点></a></h4><p>Backup 使用 Schema、顶点和边的列表 GET API 导出数据。</p><h4 id=restore-2>Restore<a class=td-heading-self-link href=#restore-2 aria-label=标题锚点></a></h4><p>Restore 使用 Schema [...]
+<code>RESTORING</code> 允许指定 Schema ID;<code>MERGING</code> 不允许指定 Schema ID。两种模式均允许保留 <code>AUTOMATIC</code> 顶点 ID。
+普通 <code>NONE</code> 模式不接受这些恢复操作所需的 ID 设置。</p><h5 id=查看某个图的模式>查看某个图的模式<a class=td-heading-self-link href=#%e6%9f%a5%e7%9c%8b%e6%9f%90%e4%b8%aa%e5%9b%be%e7%9a%84%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h5><p>启用鉴权时需要图读取权限(<code>space_member</code> 或该图的所有者)。</p><h6 id=method--url>Method & Url<a class=td-heading-self-link href=#method--url aria-label=标题锚点></a></h6><div class="td-code td-code--untitled" id=td-code-705ab766-fence-6 data-td-code data-td-code-auto-id data-td-language=text data-t [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-6-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>GET http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></di [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-7-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=mi>200</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h6 id=response-body>Response Body<a c [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;NONE&#34;</span>
-</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><blockquote><p>合法的图模式包括:NONE,RESTORING,MERGING,LOADING</p></blockquote><h5 id=设置某个图的模式>设置某个图的模式<a class=td-heading-self-link href=#%e8%ae%be%e7%bd%ae%e6%9f%90%e4%b8%aa%e5%9b%be%e7%9a%84%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h5><p>启用鉴权时需要图空间管理权限(<code>space</code>);管理员可按 [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-8-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>PUT http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></di [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>&#34;RESTORING&#34;</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><blockquote><p>合法的图模式包括:NONE,RESTORING,MERGI [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=mi>200</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h6 id=response-body-1>Response Body< [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=p>{</span>
+</span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>合法图模式为 <code>NONE</code>、<code>RESTORING</code>、<code>MERGING</code> 和 <code>LOADING</code>。</p><h5 id=设置某个图的模式>设置某个图的模式<a class=td-heading-self-link href=#%e8%ae%be%e7%bd%ae%e6%9f%90%e4%b8%aa%e5%9b%be%e7%9a%84%e6%a8%a1%e5%bc%8f aria-label=标题锚点></a></h5><p>启用鉴权时需要图空间管理 [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-9-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>PUT http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></di [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-10-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>&#34;RESTORING&#34;</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>合法图模式为 <code>NONE</code>、<code>RESTORING [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-11-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=mi>200</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><h6 id=response-body-1>Response Body< [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-705ab766-fence-12-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-json data-lang=json><span class=line><span class=ln>1</span><span class=cl><span class=p>{</span>
 </span></span><span class=line><span class=ln>2</span><span class=cl>    <span class=nt>&#34;mode&#34;</span><span class=p>:</span> <span class=s2>&#34;RESTORING&#34;</span>
 </span></span><span class=line><span class=ln>3</span><span class=cl><span class=p>}</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><template data-hg-authored-content=end></template><div class=td-page-end><section class=td-page-annotation data-td-page-annotation aria-label=页面信息><div class=td-page-meta__footer><div class="td-page-meta__item td-page-meta__lastmod"><span class=td-page-meta__icon><i class [...]
-<span>最后修改 2026-10-12 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/6181c870599030a864303ffa74821925293d1192>feat: upgrade OINK to 1.2.0 and improve docs UX (#514) (6181c8705)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/config/config-https/ aria-label="上一页 - 配置 HugeGraphServer 使用 https 协议" title="配置 HTTPS" [...]
+<span>最后修改 2026-10-23 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/efa1d042316e3f18caef4a642a685f38d2ec596f>docs: refresh bilingual guides and screenshots in core modules (#545) (efa1d0423)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/config/config-https/ aria-label="上一页 - 配置 HugeGraphServer 使用 https 协议" t [...]
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/security/ aria-label="下一页 - 报告安全问题" title=安全公告 data-td-pager-next><span class=td-pager__title dir=auto>安全公告</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-aside-group- [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#描述>描述</a><ul><li></li></ul></li><li><a href=#使用方法>使用方 [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/guides/shared-foundation-migration/ title="调整 Java import 和插件实现,并准备 1.8.0 共享基础模块迁移所需的 Server [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/guides/shared-foundation-migration/ title="调整 Java import 和插件实现,并准备 1.8.0 共享基础模块迁移所需的 Server [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/backup-restore/index.md b/cn/docs/guides/backup-restore/index.md
index 403f0be88..77b1aa2dc 100644
--- a/cn/docs/guides/backup-restore/index.md
+++ b/cn/docs/guides/backup-restore/index.md
@@ -1,4 +1,4 @@
-# Backup Restore
+# 备份与恢复
 
 LLMS 索引: [llms.txt](/cn/llms.txt)
 
@@ -6,103 +6,123 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 
 ## 描述
 
-Backup 和 Restore 是备份图和恢复图的功能。备份和恢复的数据包括元数据(schema)和图数据(vertex 和 edge)。
+Backup 将一张图的 Schema、顶点和边导出为 JSON 数据,Restore 将这些数据导入目标图。
+它们是 [HugeGraph-Tools](/cn/docs/quickstart/toolchain/hugegraph-tools) 的命令,适合图迁移、升级后的恢复及图合并。
 
 #### Backup
 
-将 HugeGraph 系统中的一张图的元数据和图数据以 JSON 格式导出。
+备份可在任意图模式下执行。建议在导出前暂停源图的写入操作,以确保 Schema、顶点和边的数据一致性(分批读取不提供全局事务快照)。
+注意:`backup -t all` 仅导出图的 Schema 和图数据,不包含系统配置文件与用户权限。
 
 #### Restore
 
-将 Backup 导出的JSON格式的数据,重新导入到 HugeGraph 系统中的一个图中。
+恢复数据前,需先根据目标图的状态切换恢复模式。日常读写处于 `NONE` 模式;注意:`LOADING` 模式不能用于 `restore`。
 
-Restore 有两种模式:
+| 目标 | 模式 | Schema ID | 顶点和边 ID |
+|---|---|---|---|
+| 恢复到没有 Schema 和数据的新图 | `RESTORING` | 使用备份中的 ID | 使用备份中的 ID |
+| 合并到已有图 | `MERGING` | 使用目标图的 Schema ID,必要时新建 | 部分 ID 随目标 Schema 重算,见下文 |
 
-- Restoring 模式,将 Backup 导出的元数据和图数据原封不动的恢复到 HugeGraph 系统中。可用于图的备份和恢复,一般目标图是新图(没有元数据和图数据)。比如:
-    - 系统升级,先备份图,然后升级系统,最后将图恢复到新的系统中
-    - 图迁移,从一个 HugeGraph 系统中,使用 Backup 功能将图导出,然后使用 Restore 功能将图导入另一个 HugeGraph 系统中
-- Merging 模式,将 Backup 导出的元数据和图数据导入到另一个已经存在元数据或者图数据的图中,过程中元数据的 ID 可能发生改变,顶点和边的 ID 也会发生相应变化。
-    - 可用于合并图
+`MERGING` 中,`PRIMARY_KEY` 顶点 ID 按目标 label ID 重新生成,关联边的端点与 ID 随之调整。
+`AUTOMATIC` 和自定义顶点 ID 保留。合并会复用同名 Schema,先检查双方的定义是否兼容,以及保留的顶点 ID 是否冲突。
+它不提供任意 Schema 冲突或数据冲突的自动解决策略。先在独立目标图验证,再合并正式数据。
 
 ## 使用方法
 
-可以使用[hugegraph-tools](/cn/docs/quickstart/toolchain/hugegraph-tools)进行图的备份和恢复。
+准备与 Server 版本匹配的 [HugeGraph-Tools](/cn/docs/quickstart/toolchain/hugegraph-tools),在 Tools 根目录执行以下命令。
+本例从 `8080` 的源图恢复到 `8081` 的空目标图。两个 Server 和目标图应已创建并启动;可将变量改成实际地址及图名。
+
+```bash
+SOURCE_URL=http://127.0.0.1:8080
+TARGET_URL=http://127.0.0.1:8081
+SOURCE_GRAPH=hugegraph
+TARGET_GRAPH=hugegraph
+BACKUP_DIR="$PWD/data/hugegraph-backup"
+```
+
+启用认证时,在每条 Tools 命令的子命令前加入 `--user <user> --password <password>`,并使用具备对应图读写和模式管理权限的账号。
+详细参数及凭据使用方式见 [Tools 参考](/cn/docs/quickstart/toolchain/hugegraph-tools)。
 
 #### Backup
 
+暂停源图写入后,备份全部 Schema、顶点和边。
+
 ```bash
-bin/hugegraph backup -t all -d data
+bin/hugegraph --url "$SOURCE_URL" --graph "$SOURCE_GRAPH" \
+  backup -t all -d "$BACKUP_DIR"
 ```
 
-该命令将 http://127.0.0.1:8080(默认 --url)的 hugegraph 图的全部元数据和图数据备份到data目录下。
-
-> Backup 在任意图模式下都可以正常工作,它不会检查图模式
+显式指定的 `-d` 就是备份目录,不会自动附加图名。为每次备份使用独立目录,避免混入旧文件。
+保留完整目录,包括压缩文件;Restore 可读取 Tools 支持的 JSON 备份格式。
 
 #### Restore
 
-Restore 有两种模式: RESTORING 和 MERGING,恢复之前首先要根据需要设置图模式,图处于其他模式时 restore 命令会失败。
+以下流程使用 `RESTORING`。合并时改为 `MERGING`,并先完成上面的兼容性检查。
+操作期间暂停目标图业务写入。
 
-##### 步骤1:查看并设置图模式
 
-```bash
-bin/hugegraph graph-mode-get
-```
+1. <span id="步骤1查看并设置图模式"></span>**查看并记录原模式,再切换。**
 
-该命令用于查看当前图模式,包括:NONE、RESTORING、MERGING、LOADING。
+   ```bash
+   bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" graph-mode-get
+   ORIGINAL_MODE=NONE
+   bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" \
+     graph-mode-set -m RESTORING
+   ```
 
-```bash
-bin/hugegraph graph-mode-set -m RESTORING
-```
+   正常业务图应处于 `NONE`。将查询返回的值填入 `ORIGINAL_MODE`,例如下方的 `NONE`。若另一项维护正在使用 `RESTORING`、`MERGING` 或 `LOADING`,先协调该任务,不要覆盖其模式。
 
-该命令用于设置图模式,Restore 之前可以设置成 RESTORING 或者 MERGING 模式,例子中设置成 RESTORING。
+1. <span id="步骤2restore-数据"></span>**恢复数据。**
 
-##### 步骤2:Restore 数据
+   ```bash
+   bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" \
+     restore -t all -d "$BACKUP_DIR"
+   ```
 
-```bash
-bin/hugegraph restore -t all -d data
-```
+   检查命令输出与各类型的导入结果。若发生错误,请先保留备份目录与日志,并检查目标图的数据状态。
+   Restore 不会自动回滚已写入的数据,切勿在部分恢复的图上盲目重跑。
+
+1. <span id="步骤3恢复图模式"></span>**还原原模式。**
+
+   使用第一步记录的 `ORIGINAL_MODE` 还原模式。
+
+   ```bash
+   bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" graph-mode-set -m "$ORIGINAL_MODE"
+   bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" graph-mode-get
+   ```
 
-该命令将data目录下的全部元数据和图数据重新导入到 http://127.0.0.1:8080 的 hugegraph 图中。
+   无论恢复成功还是失败,最后都必须将图模式还原为原有模式(通常为 `NONE`)。
+   若恢复失败,先保留现场并排查日志,待重新准备目标图后再恢复业务写入。
+{.steps}
 
-##### 步骤3:恢复图模式
+还原模式后,对比两端的顶点数和边数。
 
 ```bash
-bin/hugegraph graph-mode-set -m NONE
+bin/hugegraph --url "$SOURCE_URL" --graph "$SOURCE_GRAPH" gremlin-execute --script 'g.V().count()'
+bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" gremlin-execute --script 'g.V().count()'
+bin/hugegraph --url "$SOURCE_URL" --graph "$SOURCE_GRAPH" gremlin-execute --script 'g.E().count()'
+bin/hugegraph --url "$TARGET_URL" --graph "$TARGET_GRAPH" gremlin-execute --script 'g.E().count()'
 ```
 
-该命令用于恢复图模式为 NONE。
-
-至此,一次完整的图备份和图恢复流程结束。
+两组计数结果应保持完全一致。建议进一步通过 [Schema API](/cn/docs/clients/restful-api/schema/) 核对元数据定义,
+并抽样检查顶点和边的属性与端点关联,确保业务数据的完整性。
 
 #### 帮助
 
-备份和恢复命令的详细使用方式可以参考[hugegraph-tools文档](/cn/docs/quickstart/toolchain/hugegraph-tools)。
+更多关于压缩、并发和分类型备份的参数说明,见 [Tools 参考](/cn/docs/quickstart/toolchain/hugegraph-tools)。
+在跨大版本恢复前,建议先在测试环境中验证备份文件的兼容性。
 
 ## Backup/Restore使用和实现的API说明
 
 #### Backup
 
-Backup 使用`元数据`和`图数据`的相应的 list(GET) API 导出,并未增加新的 API。
+Backup 使用 Schema、顶点和边的列表 GET API 导出数据。
 
 #### Restore
 
-Restore 使用`元数据`和`图数据`的相应的 create(POST) API 导入,并未增加新的 API。
-
-Restore 时存在两种不同的模式: Restoring 和 Merging,另外,还有常规模式 NONE(默认),区别如下:
-
-- None 模式,元数据和图数据的写入属于正常状态,可参见功能说明。特别的:
-    - 元数据(schema)创建时不允许指定 ID
-    - 图数据(vertex)在 id strategy 为 Automatic 时,不允许指定 ID
-- Restoring 模式,恢复到一个新图中,特别的:
-    - 元数据(schema)创建时允许指定 ID
-    - 图数据(vertex)在 id strategy 为 Automatic 时,允许指定 ID
-- Merging 模式,合并到一个已存在元数据和图数据的图中,特别的:
-    - 元数据(schema)创建时不允许指定 ID
-    - 图数据(vertex)在 id strategy 为 Automatic 时,允许指定 ID
-
-正常情况下,图模式为 None,当需要 Restore 图时,需要根据需要临时修改图模式为 Restoring 模式或者 Merging 模式,并在完成 Restore 时,恢复图模式为 None。
-
-实现的设置图模式的 RESTful API 如下:
+Restore 使用 Schema、顶点和边的创建 API 导入数据。模式对应的 ID 行为见[前面的选择表](#restore)。
+`RESTORING` 允许指定 Schema ID;`MERGING` 不允许指定 Schema ID。两种模式均允许保留 `AUTOMATIC` 顶点 ID。
+普通 `NONE` 模式不接受这些恢复操作所需的 ID 设置。
 
 ##### 查看某个图的模式
 
@@ -128,7 +148,7 @@ GET http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode
 }
 ```
 
-> 合法的图模式包括:NONE,RESTORING,MERGING,LOADING
+合法图模式为 `NONE`、`RESTORING`、`MERGING` 和 `LOADING`。
 
 ##### 设置某个图的模式
 
@@ -146,7 +166,7 @@ PUT http://localhost:8080/graphspaces/DEFAULT/graphs/{graph}/mode
 "RESTORING"
 ```
 
-> 合法的图模式包括:NONE,RESTORING,MERGING,LOADING
+合法图模式为 `NONE`、`RESTORING`、`MERGING` 和 `LOADING`。
 
 ###### Response Status
 
diff --git a/cn/docs/guides/custom-plugin/index.html b/cn/docs/guides/custom-plugin/index.html
index 5c518bee6..a99a6ab63 100644
--- a/cn/docs/guides/custom-plugin/index.html
+++ b/cn/docs/guides/custom-plugin/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -348,7 +348,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#背景>背景</a></li><li><a href=#可扩展维度>可扩展维度</a></l [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/guides/shared-foundation-migration/ title="调整 Java import 和插件实现,并准备 1.8.0 共享基础模块迁移所需的 Server [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/guides/shared-foundation-migration/ title="调整 Java import 和插件实现,并准备 1.8.0 共享基础模块迁移所需的 Server [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/desgin-concept/index.html b/cn/docs/guides/desgin-concept/index.html
index 867890179..eac37987d 100644
--- a/cn/docs/guides/desgin-concept/index.html
+++ b/cn/docs/guides/desgin-concept/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -181,7 +181,7 @@ RDF是W3C标准,而Property Graph是工业标准,受到广大图数据库厂
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/custom-plugin/ aria-label="下一页 - HugeGraph Plugin 机制及插件扩展流程" title="HugeGraph Plugin" data-td-pager-next><span class=td-pager__title dir=auto>HugeGraph Plugin</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><di [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-属性图模型>1. 属性图模型</a></li><li><a href=#2-图分区方案 [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-属性图模型>1. 属性图模型</a></li><li><a href=#2-图分区方案 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/faq/index.html b/cn/docs/guides/faq/index.html
index 751175094..e0147d543 100644
--- a/cn/docs/guides/faq/index.html
+++ b/cn/docs/guides/faq/index.html
@@ -1,156 +1,4 @@
-<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
-HugeGraph 支持多种部署模式,根据数据规模和场景选择:
-单机模式:Server + RocksDB,适合开发测试、Graph AI 和中小规模生产环境(≤ 2 TB) 分布式模式:HugeGraph-PD + HugeGraph-Store(HStore),用于需要水平扩展和多副本的部署,支持 ≤ 1 PB 的数据规模 1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用 1.5.x 或更早版本。
-启动服务时提示:xxx (core dumped) xxx
-请先确认 JDK 版本符合对应版本要求:HugeGraph 1.8.0+ 要求 Java 17,1.7.0 要求 Java 11。HugeGraph 不再支持 Java 8。
-启动服务成功了,但是操作图时有类似于"无法连接到后端或连接未打开"的提示
-RocksDB、HBase 等本地持久化后端首次启动前需要使用 init-store 初始化。HStore 由 PD、Store 管理,不执行该脚本。
-所有的后端在使用前都需要执行init-store吗,序列化的选择可以随意填写么?
-Memory 和 HStore 不执行 init-store;RocksDB、HBase 等本地持久化后端首次使用前需要初始化。序列化器必须与后端匹配,例如 RocksDB 使用 binary。
-执行init-store报错:Exception in thread "main" java.lang.UnsatisfiedLinkError: /tmp/librocksdbjni3226083071221514754.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found (required by /tmp/librocksdbjni3226083071221514754.so)
-RocksDB需要 gcc 4.3.0 (GLIBCXX_3.4.10) 及以上版本
-bin目录下包含start-hugegraph.sh、start-restserver.sh和start-gremlinserver.sh三个似乎与启动有关的脚本,到底该使用哪个
-当前发布包只保留 start-hugegraph.sh 作为 Server 启动脚本。GremlinServer 和 REST Server 由同一进程启动。
-配置了两个图,名字是hugegraph和hugegraph1,而启动服务的命令是start-hugegraph.sh,是只打开了hugegraph这个图吗
-脚本名称与图名无关。Server 默认从 conf/graphs 扫描并加载本地图配置,目录可在 conf/rest-server.properties 的 graphs 配置项中修改。graph.load_from_local_config 默认 false,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见服务端配置说明。
-服务启动成功后,使用curl查询所有顶点时返回乱码
-服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 gunzip 进行解压(curl http://example | gunzip),也可以用Firefox的postman或者Chrome浏览器的restlet插件发请求,会自动解压缩响应数据。
-使用顶点Id通过RESTful API查询顶点时返回空,但是顶点确实是存在的
-检查顶点Id的类型,如果是字符串类型,API的url中的id部分需要加上双引号,数字类型则不用加。
-已经根据需要给顶点Id加上了双引号,但是通过RESTful API查询顶点时仍然返回空
-检查顶点id中是否包含+、空格、/、?、%、&和=这些URL的保留字符,如果存在则需要进行编码。下表给出了编码值:
-1特殊字符 | 编码值 2--------| ---- 3+ | %2B 4空格 | %20 5/ | %2F 6? | %3F 7% | %25 8# | %23 9& | %26 10= | %3D 查询某一类别的顶点或边(query by label)时提示超时
-由于属于某一label的数据量可能比较多,请加上limit限制。
-通过RESTful API操作图是可以的,但是发送Gremlin语句就报错:Request Failed(500)
-可能是GremlinServer的配置有误,检查gremlin-server.yaml的host、port是否与rest-server.properties的gremlinserver.url匹配,如不匹配则修改,然后重启服务。
-使用Loader导数据出现Socket Timeout异常,然后导致Loader中断
-持续地导入数据会使Server的压力过大,然后导致有些请求超时。可以通过调整Loader的参数来适当缓解Server压力(如:重试次数,重试间隔,错误容忍数等),降低该问题出现频率。
-如何删除图中的全部数据
-管理员可调用 DELETE /graphspaces/{graphspace}/graphs/{graph}/clear?confirm_message=I&#39;m sure to delete all data。confirm_message 查询参数必须与该值完全一致,否则请求会被拒绝,详见 Graph API。该操作会清除 schema、顶点、边和索引。
-清空了数据库,并且执行了init-store,但是添加schema时提示"xxx has existed"
-HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Server的,否则残留的缓存会产生不一致。
-插入顶点或边的过程中报错:The max length of vertex id is 16384, but got xxx {yyy} 或 The max length of edge id is 65536, but got xxx {yyy}
-为了保证查询性能,目前的后端存储对id列的长度做了限制,顶点id不能超过16384字节,边id长度不能超过65536字节;索引id超过32字节时会转为哈希存储,而不是报错。
-是否支持嵌套属性,如果不支持,是否有什么替代方案
-嵌套属性目前暂不支持。替代方案:可以把嵌套属性作为单独的顶点拿出来,然后用边连接起来。
-一个EdgeLabel是否可以连接多对VertexLabel,比如"投资"关系,可以是"个人"投资"企业",也可以是"企业"投资"企业"
-可以。创建EdgeLabel时对每一对顶点标签各调用一次link(sourceLabel, targetLabel),所有配对都会被保留,因此同一个"投资"标签可以同时覆盖"个人"投资"企业"和"企业"投资"企业"。旧的sourceLabel()和targetLabel()构建方法已废弃,且只支持单一配对。
-通过RestAPI发送请求时提示HTTP 415 Unsupported Media Type
-请求头中需要指定Content-Type:application/json'><link rel=canonical href=https://hugegraph.apache.org/cn/docs/guides/faq/><link rel=alternate hreflang=en-US href=https://hugegraph.apache.org/docs/guides/faq/><link rel=alternate hreflang=zh-CN href=https://hugegraph.apache.org/cn/docs/guides/faq/><meta property="og:locale:alternate" content="en_US"><meta property="og:url" content="https://hugegraph.apache.org/cn/docs/guides/faq/"><meta property="og:site_name" content="Apache HugeGraph"><meta prope [...]
-HugeGraph 支持多种部署模式,根据数据规模和场景选择:
-单机模式:Server + RocksDB,适合开发测试、Graph AI 和中小规模生产环境(≤ 2 TB) 分布式模式:HugeGraph-PD + HugeGraph-Store(HStore),用于需要水平扩展和多副本的部署,支持 ≤ 1 PB 的数据规模 1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用 1.5.x 或更早版本。
-启动服务时提示:xxx (core dumped) xxx
-请先确认 JDK 版本符合对应版本要求:HugeGraph 1.8.0+ 要求 Java 17,1.7.0 要求 Java 11。HugeGraph 不再支持 Java 8。
-启动服务成功了,但是操作图时有类似于"无法连接到后端或连接未打开"的提示
-RocksDB、HBase 等本地持久化后端首次启动前需要使用 init-store 初始化。HStore 由 PD、Store 管理,不执行该脚本。
-所有的后端在使用前都需要执行init-store吗,序列化的选择可以随意填写么?
-Memory 和 HStore 不执行 init-store;RocksDB、HBase 等本地持久化后端首次使用前需要初始化。序列化器必须与后端匹配,例如 RocksDB 使用 binary。
-执行init-store报错:Exception in thread "main" java.lang.UnsatisfiedLinkError: /tmp/librocksdbjni3226083071221514754.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found (required by /tmp/librocksdbjni3226083071221514754.so)
-RocksDB需要 gcc 4.3.0 (GLIBCXX_3.4.10) 及以上版本
-bin目录下包含start-hugegraph.sh、start-restserver.sh和start-gremlinserver.sh三个似乎与启动有关的脚本,到底该使用哪个
-当前发布包只保留 start-hugegraph.sh 作为 Server 启动脚本。GremlinServer 和 REST Server 由同一进程启动。
-配置了两个图,名字是hugegraph和hugegraph1,而启动服务的命令是start-hugegraph.sh,是只打开了hugegraph这个图吗
-脚本名称与图名无关。Server 默认从 conf/graphs 扫描并加载本地图配置,目录可在 conf/rest-server.properties 的 graphs 配置项中修改。graph.load_from_local_config 默认 false,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见服务端配置说明。
-服务启动成功后,使用curl查询所有顶点时返回乱码
-服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 gunzip 进行解压(curl http://example | gunzip),也可以用Firefox的postman或者Chrome浏览器的restlet插件发请求,会自动解压缩响应数据。
-使用顶点Id通过RESTful API查询顶点时返回空,但是顶点确实是存在的
-检查顶点Id的类型,如果是字符串类型,API的url中的id部分需要加上双引号,数字类型则不用加。
-已经根据需要给顶点Id加上了双引号,但是通过RESTful API查询顶点时仍然返回空
-检查顶点id中是否包含+、空格、/、?、%、&和=这些URL的保留字符,如果存在则需要进行编码。下表给出了编码值:
-1特殊字符 | 编码值 2--------| ---- 3+ | %2B 4空格 | %20 5/ | %2F 6? | %3F 7% | %25 8# | %23 9& | %26 10= | %3D 查询某一类别的顶点或边(query by label)时提示超时
-由于属于某一label的数据量可能比较多,请加上limit限制。
-通过RESTful API操作图是可以的,但是发送Gremlin语句就报错:Request Failed(500)
-可能是GremlinServer的配置有误,检查gremlin-server.yaml的host、port是否与rest-server.properties的gremlinserver.url匹配,如不匹配则修改,然后重启服务。
-使用Loader导数据出现Socket Timeout异常,然后导致Loader中断
-持续地导入数据会使Server的压力过大,然后导致有些请求超时。可以通过调整Loader的参数来适当缓解Server压力(如:重试次数,重试间隔,错误容忍数等),降低该问题出现频率。
-如何删除图中的全部数据
-管理员可调用 DELETE /graphspaces/{graphspace}/graphs/{graph}/clear?confirm_message=I&#39;m sure to delete all data。confirm_message 查询参数必须与该值完全一致,否则请求会被拒绝,详见 Graph API。该操作会清除 schema、顶点、边和索引。
-清空了数据库,并且执行了init-store,但是添加schema时提示"xxx has existed"
-HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Server的,否则残留的缓存会产生不一致。
-插入顶点或边的过程中报错:The max length of vertex id is 16384, but got xxx {yyy} 或 The max length of edge id is 65536, but got xxx {yyy}
-为了保证查询性能,目前的后端存储对id列的长度做了限制,顶点id不能超过16384字节,边id长度不能超过65536字节;索引id超过32字节时会转为哈希存储,而不是报错。
-是否支持嵌套属性,如果不支持,是否有什么替代方案
-嵌套属性目前暂不支持。替代方案:可以把嵌套属性作为单独的顶点拿出来,然后用边连接起来。
-一个EdgeLabel是否可以连接多对VertexLabel,比如"投资"关系,可以是"个人"投资"企业",也可以是"企业"投资"企业"
-可以。创建EdgeLabel时对每一对顶点标签各调用一次link(sourceLabel, targetLabel),所有配对都会被保留,因此同一个"投资"标签可以同时覆盖"个人"投资"企业"和"企业"投资"企业"。旧的sourceLabel()和targetLabel()构建方法已废弃,且只支持单一配对。
-通过RestAPI发送请求时提示HTTP 415 Unsupported Media Type
-请求头中需要指定Content-Type:application/json'><meta property="og:locale" content="zh_CN"><meta property="og:type" content="article"><meta property="article:section" content="docs"><meta property="article:modified_time" content="2026-10-15T04:00:35+08:00"><meta property="og:image" content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta itemprop=name content="FAQ"><meta itemprop=description content='如何选择后端存储? 选 RocksDB 还是分布式存储?
-HugeGraph 支持多种部署模式,根据数据规模和场景选择:
-单机模式:Server + RocksDB,适合开发测试、Graph AI 和中小规模生产环境(≤ 2 TB) 分布式模式:HugeGraph-PD + HugeGraph-Store(HStore),用于需要水平扩展和多副本的部署,支持 ≤ 1 PB 的数据规模 1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用 1.5.x 或更早版本。
-启动服务时提示:xxx (core dumped) xxx
-请先确认 JDK 版本符合对应版本要求:HugeGraph 1.8.0+ 要求 Java 17,1.7.0 要求 Java 11。HugeGraph 不再支持 Java 8。
-启动服务成功了,但是操作图时有类似于"无法连接到后端或连接未打开"的提示
-RocksDB、HBase 等本地持久化后端首次启动前需要使用 init-store 初始化。HStore 由 PD、Store 管理,不执行该脚本。
-所有的后端在使用前都需要执行init-store吗,序列化的选择可以随意填写么?
-Memory 和 HStore 不执行 init-store;RocksDB、HBase 等本地持久化后端首次使用前需要初始化。序列化器必须与后端匹配,例如 RocksDB 使用 binary。
-执行init-store报错:Exception in thread "main" java.lang.UnsatisfiedLinkError: /tmp/librocksdbjni3226083071221514754.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found (required by /tmp/librocksdbjni3226083071221514754.so)
-RocksDB需要 gcc 4.3.0 (GLIBCXX_3.4.10) 及以上版本
-bin目录下包含start-hugegraph.sh、start-restserver.sh和start-gremlinserver.sh三个似乎与启动有关的脚本,到底该使用哪个
-当前发布包只保留 start-hugegraph.sh 作为 Server 启动脚本。GremlinServer 和 REST Server 由同一进程启动。
-配置了两个图,名字是hugegraph和hugegraph1,而启动服务的命令是start-hugegraph.sh,是只打开了hugegraph这个图吗
-脚本名称与图名无关。Server 默认从 conf/graphs 扫描并加载本地图配置,目录可在 conf/rest-server.properties 的 graphs 配置项中修改。graph.load_from_local_config 默认 false,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见服务端配置说明。
-服务启动成功后,使用curl查询所有顶点时返回乱码
-服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 gunzip 进行解压(curl http://example | gunzip),也可以用Firefox的postman或者Chrome浏览器的restlet插件发请求,会自动解压缩响应数据。
-使用顶点Id通过RESTful API查询顶点时返回空,但是顶点确实是存在的
-检查顶点Id的类型,如果是字符串类型,API的url中的id部分需要加上双引号,数字类型则不用加。
-已经根据需要给顶点Id加上了双引号,但是通过RESTful API查询顶点时仍然返回空
-检查顶点id中是否包含+、空格、/、?、%、&和=这些URL的保留字符,如果存在则需要进行编码。下表给出了编码值:
-1特殊字符 | 编码值 2--------| ---- 3+ | %2B 4空格 | %20 5/ | %2F 6? | %3F 7% | %25 8# | %23 9& | %26 10= | %3D 查询某一类别的顶点或边(query by label)时提示超时
-由于属于某一label的数据量可能比较多,请加上limit限制。
-通过RESTful API操作图是可以的,但是发送Gremlin语句就报错:Request Failed(500)
-可能是GremlinServer的配置有误,检查gremlin-server.yaml的host、port是否与rest-server.properties的gremlinserver.url匹配,如不匹配则修改,然后重启服务。
-使用Loader导数据出现Socket Timeout异常,然后导致Loader中断
-持续地导入数据会使Server的压力过大,然后导致有些请求超时。可以通过调整Loader的参数来适当缓解Server压力(如:重试次数,重试间隔,错误容忍数等),降低该问题出现频率。
-如何删除图中的全部数据
-管理员可调用 DELETE /graphspaces/{graphspace}/graphs/{graph}/clear?confirm_message=I&#39;m sure to delete all data。confirm_message 查询参数必须与该值完全一致,否则请求会被拒绝,详见 Graph API。该操作会清除 schema、顶点、边和索引。
-清空了数据库,并且执行了init-store,但是添加schema时提示"xxx has existed"
-HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Server的,否则残留的缓存会产生不一致。
-插入顶点或边的过程中报错:The max length of vertex id is 16384, but got xxx {yyy} 或 The max length of edge id is 65536, but got xxx {yyy}
-为了保证查询性能,目前的后端存储对id列的长度做了限制,顶点id不能超过16384字节,边id长度不能超过65536字节;索引id超过32字节时会转为哈希存储,而不是报错。
-是否支持嵌套属性,如果不支持,是否有什么替代方案
-嵌套属性目前暂不支持。替代方案:可以把嵌套属性作为单独的顶点拿出来,然后用边连接起来。
-一个EdgeLabel是否可以连接多对VertexLabel,比如"投资"关系,可以是"个人"投资"企业",也可以是"企业"投资"企业"
-可以。创建EdgeLabel时对每一对顶点标签各调用一次link(sourceLabel, targetLabel),所有配对都会被保留,因此同一个"投资"标签可以同时覆盖"个人"投资"企业"和"企业"投资"企业"。旧的sourceLabel()和targetLabel()构建方法已废弃,且只支持单一配对。
-通过RestAPI发送请求时提示HTTP 415 Unsupported Media Type
-请求头中需要指定Content-Type:application/json'><meta itemprop=dateModified content="2026-10-15T04:00:35+08:00"><meta itemprop=wordCount content="2440"><meta itemprop=image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:card content="summary_large_image"><meta name=twitter:image content="https://hugegraph.apache.org/img/social/hugegraph-apache.png"><meta name=twitter:title content="FAQ"><meta name=twitter:description content='如何选择后端存储? 选 RocksDB 还是分布式存储?
-HugeGraph 支持多种部署模式,根据数据规模和场景选择:
-单机模式:Server + RocksDB,适合开发测试、Graph AI 和中小规模生产环境(≤ 2 TB) 分布式模式:HugeGraph-PD + HugeGraph-Store(HStore),用于需要水平扩展和多副本的部署,支持 ≤ 1 PB 的数据规模 1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用 1.5.x 或更早版本。
-启动服务时提示:xxx (core dumped) xxx
-请先确认 JDK 版本符合对应版本要求:HugeGraph 1.8.0+ 要求 Java 17,1.7.0 要求 Java 11。HugeGraph 不再支持 Java 8。
-启动服务成功了,但是操作图时有类似于"无法连接到后端或连接未打开"的提示
-RocksDB、HBase 等本地持久化后端首次启动前需要使用 init-store 初始化。HStore 由 PD、Store 管理,不执行该脚本。
-所有的后端在使用前都需要执行init-store吗,序列化的选择可以随意填写么?
-Memory 和 HStore 不执行 init-store;RocksDB、HBase 等本地持久化后端首次使用前需要初始化。序列化器必须与后端匹配,例如 RocksDB 使用 binary。
-执行init-store报错:Exception in thread "main" java.lang.UnsatisfiedLinkError: /tmp/librocksdbjni3226083071221514754.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found (required by /tmp/librocksdbjni3226083071221514754.so)
-RocksDB需要 gcc 4.3.0 (GLIBCXX_3.4.10) 及以上版本
-bin目录下包含start-hugegraph.sh、start-restserver.sh和start-gremlinserver.sh三个似乎与启动有关的脚本,到底该使用哪个
-当前发布包只保留 start-hugegraph.sh 作为 Server 启动脚本。GremlinServer 和 REST Server 由同一进程启动。
-配置了两个图,名字是hugegraph和hugegraph1,而启动服务的命令是start-hugegraph.sh,是只打开了hugegraph这个图吗
-脚本名称与图名无关。Server 默认从 conf/graphs 扫描并加载本地图配置,目录可在 conf/rest-server.properties 的 graphs 配置项中修改。graph.load_from_local_config 默认 false,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见服务端配置说明。
-服务启动成功后,使用curl查询所有顶点时返回乱码
-服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 gunzip 进行解压(curl http://example | gunzip),也可以用Firefox的postman或者Chrome浏览器的restlet插件发请求,会自动解压缩响应数据。
-使用顶点Id通过RESTful API查询顶点时返回空,但是顶点确实是存在的
-检查顶点Id的类型,如果是字符串类型,API的url中的id部分需要加上双引号,数字类型则不用加。
-已经根据需要给顶点Id加上了双引号,但是通过RESTful API查询顶点时仍然返回空
-检查顶点id中是否包含+、空格、/、?、%、&和=这些URL的保留字符,如果存在则需要进行编码。下表给出了编码值:
-1特殊字符 | 编码值 2--------| ---- 3+ | %2B 4空格 | %20 5/ | %2F 6? | %3F 7% | %25 8# | %23 9& | %26 10= | %3D 查询某一类别的顶点或边(query by label)时提示超时
-由于属于某一label的数据量可能比较多,请加上limit限制。
-通过RESTful API操作图是可以的,但是发送Gremlin语句就报错:Request Failed(500)
-可能是GremlinServer的配置有误,检查gremlin-server.yaml的host、port是否与rest-server.properties的gremlinserver.url匹配,如不匹配则修改,然后重启服务。
-使用Loader导数据出现Socket Timeout异常,然后导致Loader中断
-持续地导入数据会使Server的压力过大,然后导致有些请求超时。可以通过调整Loader的参数来适当缓解Server压力(如:重试次数,重试间隔,错误容忍数等),降低该问题出现频率。
-如何删除图中的全部数据
-管理员可调用 DELETE /graphspaces/{graphspace}/graphs/{graph}/clear?confirm_message=I&#39;m sure to delete all data。confirm_message 查询参数必须与该值完全一致,否则请求会被拒绝,详见 Graph API。该操作会清除 schema、顶点、边和索引。
-清空了数据库,并且执行了init-store,但是添加schema时提示"xxx has existed"
-HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Server的,否则残留的缓存会产生不一致。
-插入顶点或边的过程中报错:The max length of vertex id is 16384, but got xxx {yyy} 或 The max length of edge id is 65536, but got xxx {yyy}
-为了保证查询性能,目前的后端存储对id列的长度做了限制,顶点id不能超过16384字节,边id长度不能超过65536字节;索引id超过32字节时会转为哈希存储,而不是报错。
-是否支持嵌套属性,如果不支持,是否有什么替代方案
-嵌套属性目前暂不支持。替代方案:可以把嵌套属性作为单独的顶点拿出来,然后用边连接起来。
-一个EdgeLabel是否可以连接多对VertexLabel,比如"投资"关系,可以是"个人"投资"企业",也可以是"企业"投资"企业"
-可以。创建EdgeLabel时对每一对顶点标签各调用一次link(sourceLabel, targetLabel),所有配对都会被保留,因此同一个"投资"标签可以同时覆盖"个人"投资"企业"和"企业"投资"企业"。旧的sourceLabel()和targetLabel()构建方法已废弃,且只支持单一配对。
-通过RestAPI发送请求时提示HTTP 415 Unsupported Media Type
-请求头中需要指定Content-Type:application/json'><link rel=preload href=https://hugegraph.apache.org/scss/main.min.fa8bb553ea6f16a972e22510cefd5bf77b8474fbee1474dc452465ab36c84c0a.css as=style integrity="sha256-+ou1U+pvFqly4iUQzv1b93uEdPvuFHTcRSRlqzbITAo=" crossorigin=anonymous><link href=https://hugegraph.apache.org/scss/fontawesome.min.d1b0898e80994c0e0be2e673debfd8c2e5eb8c0b96d55c483e1be19cb01e5d10.css rel=stylesheet integrity="sha256-0bCJjoCZTA4L4uZz3r/YwuXrjAuW1VxIPhvhnLAeXRA=" crossorigin=an [...]
+<!doctype html><html itemscope itemtype=http://schema.org/WebPage dir=ltr lang=zh-CN data-td-typography=technical data-td-preset=slate data-td-site-preset=slate data-td-theme-init><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=color-scheme content="light dark"><meta name=theme-color content="#f1f4f8" data-td-canvas-light=#f1f4f8 data-td-canvas-dark=#0b1119><style>html{background:#f1f4f8;color:#16222e}html[data-bs-the [...]
 <span class=td-nav-title>HugeGraph</span></a><div class="td-nav-links td-nav-menu-zone"><div class=td-nav-menu data-td-navbar-menu><a class="nav-link td-nav-menu__parent-link active" href=https://hugegraph.apache.org/cn/docs/ data-td-navbar-level=0 data-td-navbar-kind=link data-td-navbar-route aria-label=文档 data-td-navbar-region=desktop data-td-navbar-label=文档 data-td-navbar-external=false aria-controls=td-navbar-desktop-docs-0 aria-expanded=false><i class="fa-solid fa-book" aria-hidden= [...]
 <span class=td-navbar-entry__label>文档</span></a><div class=td-nav-menu__panel id=td-navbar-desktop-docs-0 data-td-navbar-panel hidden><a class=td-nav-menu__item-link href=https://hugegraph.apache.org/cn/docs/quickstart/ data-td-navbar-level=1 data-td-navbar-kind=link aria-label=开始 data-td-navbar-region=desktop data-td-navbar-label=开始 data-td-navbar-external=false><i class="fa-solid fa-rocket" aria-hidden=true></i>
 <span class=td-navbar-entry__label>开始</span></a>
@@ -183,7 +31,7 @@ HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Serve
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-navbar value=dark data-bs-theme-value=dark>
 <span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--moon fa-solid fa-moon" aria-hidden=true></i><span>暗色</span>
 </span></label><label class=td-appearance__mode><input class=td-appearance__input type=radio name=td-mode-navbar value=auto data-bs-theme-value=auto checked>
-<span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>跟随系统</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>浏览器未保存设置,此选择仅在当前页面有效。</p></dialog></div><div class="td-shell-keyboard td-nav-hover-menu" data-td-nav-hover><button type=button class="td-shell-iconbtn td-shell-keyboard__trigger" data-td-nav-hover-trigger data-td-nav-hover-open title=键盘快捷键 aria-la [...]
+<span class=td-appearance__segment><i class="td-shell-icon td-shell-icon--contrast fa-solid fa-circle-half-stroke" aria-hidden=true></i><span>跟随系统</span></span></label></div></fieldset><p class=td-appearance__note data-td-appearance-note hidden>浏览器未保存设置,此选择仅在当前页面有效。</p></dialog></div><div class="td-shell-keyboard td-nav-hover-menu" data-td-nav-hover><button type=button class="td-shell-iconbtn td-shell-keyboard__trigger" data-td-nav-hover-trigger data-td-nav-hover-open title=键盘快捷键 aria-la [...]
 <span class=td-shell-wordmark>HugeGraph</span>
 </a><button type=button class="td-shell-iconbtn td-shell-sidebar__search" data-td-shell-search-open title=搜索… aria-label=搜索… aria-controls=td-shell-search aria-expanded=false><i class="td-shell-icon td-shell-icon--search fa-solid fa-magnifying-glass" aria-hidden=true></i></button>
 <button type=button class="td-shell-iconbtn td-shell-sidebar__collapse" data-td-shell-sidebar-toggle title=收起侧栏 aria-label=收起侧栏><i class="td-shell-icon td-shell-icon--panel-left fa-solid fa-table-columns" aria-hidden=true></i></button></div><div class="td-shell-sidebar__header-row td-shell-sidebar__header-row--drawer-only"><button type=button class="td-shell-search-btn td-shell-search-btn--drawer" data-td-shell-search-open aria-controls=td-shell-search aria-expanded=false>
@@ -222,7 +70,7 @@ HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Serve
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -248,20 +96,21 @@ HugeGraphServer内是有缓存的,清空数据库的同时是需要重启Serve
 <span class="td-page-actions__icon td-page-actions__icon--done"><i class="td-shell-icon td-shell-icon--check fa-solid fa-check" aria-hidden=true></i></span>
 </button>
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/faq/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/faq.md targ [...]
-<code>false</code>,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见<a href=https://hugegraph.apache.org/cn/docs/config/config-guide/>服务端配置说明</a>。</p></li><li><p>服务启动成功后,使用<code>curl</code>查询所有顶点时返回乱码</p><p>服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 <code>gunzip</code> 进行解压(<code>curl http://example | gunzip</code>),也可以用<code>Firefox</code>的<code>postman</code>或者<code>Chrome</code>浏览器的<code>restlet</code>插件发请求,会自动解压缩响应数据。</p></li><li><p>使用顶点Id通过<code>RESTful API</code>查询顶点时返回空,但是顶点确实是存在的</p> [...]
-<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-2f84925e-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln> 1</span><span class=cl>特殊字符 | 编码值
-</span></span><span class=line><span class=ln> 2</span><span class=cl>--------| ----
-</span></span><span class=line><span class=ln> 3</span><span class=cl>+       | %2B
-</span></span><span class=line><span class=ln> 4</span><span class=cl>空格     | %20
-</span></span><span class=line><span class=ln> 5</span><span class=cl>/       | %2F
-</span></span><span class=line><span class=ln> 6</span><span class=cl>?       | %3F
-</span></span><span class=line><span class=ln> 7</span><span class=cl>%       | %25
-</span></span><span class=line><span class=ln> 8</span><span class=cl>#       | %23
-</span></span><span class=line><span class=ln> 9</span><span class=cl>&amp;       | %26
-</span></span><span class=line><span class=ln>10</span><span class=cl>=       | %3D</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div></li><li><p>查询某一类别的顶点或边(<code>query by label</code>)时提示超时</p><p>由于属于某一label的数据量可能比较多,请加上limit限制。</p></li><li><p>通过<code>RESTful API</code>操作图是可以的,但是发送<code>Gremlin</code>语句就报错:<code>Request Failed(500)</code></p><p>可能是<code>GremlinServer</code>的配置有误,检查<code>gremlin-server.yaml</c [...]
-<span>最后修改 2026-10-15 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/a5731b80f47fdfe469e5d378f7cc8c776dd44ae8>docs: require Java 17 starting with 1.8.0 (#508) (a5731b80f)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/guides/security/ aria-label="上一页 - 报告安全问题" title=安全公告 data-td-pager-prev><span class=td-pager [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/performance/ aria-label="下一页 - PERFORMANCE" title=PERFORMANCE data-td-pager-next><span class=td-pager__title dir=auto>PERFORMANCE</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc__title-btn da [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/faq/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/faq.md targ [...]
+部署步骤见 <a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>Server 快速开始</a>。</p><h3 id=core-dump>启动时出现 core dumped 怎么查<a class=td-heading-self-link href=#core-dump aria-label=标题锚点></a></h3><p>先执行 <code>java -version</code> 确认 JDK 版本:<strong>HugeGraph master 分支(以 1.8 为基线)要求 Java 17</strong>,<strong>1.7.0 要求 Java 11</strong>(已不再支持 Java 8)。
+若 JDK 版本正确,进一步查看 Server 日志及 JVM 崩溃日志(<code>hs_err_pid*.log</code>),排查是否由于系统架构不匹配、依赖的动态库(如 RocksDB JNI)缺失或系统内存不足引起。</p><h3 id=initialize-backend>哪些后端需要 init-store<a class=td-heading-self-link href=#initialize-backend aria-label=标题锚点></a></h3><p>使用 RocksDB 或 HBase 等本地持久化后端时,<strong>首次启动前必须执行 <code>bin/init-store.sh</code></strong> 进行初始化。Memory(内存后端)和 HStore(分布式后端)无需执行此脚本,HStore 的存储由 PD 和 Store 统一管理。</p><p>注意:<code>backend</code> 与 <code>serializer</code> 必须配套使用(例如 RocksDB 配套 <code>binary</ [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-2f84925e-fence-0-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>java.lang.UnsatisfiedLinkError: .../librocksdbjni....so:
+</span></span><span class=line><span class=ln>2</span><span class=cl>.../libstdc++.so.6: version `GLIBCXX_3.4.10&#39; not found</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>解决方法:核对发行包支持的系统架构,升级系统的 <code>libstdc++</code>(或安装较新的 GCC 运行库),或者直接使用官方提供的 Docker 镜像运行。</p><h3 id=start-script>应该使用哪个 Server 启动脚本<a class=td-heading-self-link href=#start-script aria-label=标题锚点></a></h3><p>当前发行包统一使用 <code>bin/start-h [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-2f84925e-fence-1-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-bash data-lang=bash><span class=line><span class=ln>1</span><span class=cl>curl --compressed <span class=se>\
+</span></span></span><span class=line><span class=ln>2</span><span class=cl>  <span class=s1>&#39;http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10&#39;</span></span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>若开启了认证,需同时传入凭据。若返回内容仍不符合预期,请检查 HTTP 状态码、<code>Content-Type</code> 与 <code>Content-Encoding</code>,不要把 JSON 报错直接管道传给 <code>gunzip</code>。</p><h3 id=vertex-id>按顶点 ID 查询却找 [...]
+<i class="fa-regular fa-copy" aria-hidden=true></i></button></div><div class=td-code__viewport id=td-code-2f84925e-fence-2-viewport data-td-code-viewport><div class=highlight><pre tabindex=0 class=chroma><code class=language-text data-lang=text><span class=line><span class=ln>1</span><span class=cl>DELETE /graphspaces/{graphspace}/graphs/{graph}/clear</span></span></code></pre></div></div><span class=visually-hidden role=status aria-live=polite data-td-code-status></span></div><p>请求需携带 < [...]
+若已手动清理底层,必须<strong>重启 Server</strong>。日常清理建议使用官方提供的 <a href=https://hugegraph.apache.org/cn/docs/clients/restful-api/graphs/#clear-graph>Clear 图 API</a>。</p><h2 id=modeling>建模与 ID<a class=td-heading-self-link href=#modeling aria-label=标题锚点></a></h2><h3 id=id-length>顶点或边 ID 超过长度限制<a class=td-heading-self-link href=#id-length aria-label=标题锚点></a></h3><p>为保证底层存储与索引性能,HugeGraph 对 ID 长度作了如下限制(按编码后的字节数计算):</p><ul><li><strong>顶点 ID</strong>:最长 16384 字节(16 KB);</li><li><strong>边 ID</strong>:最长 6 [...]
+例如“投资”关系可以同时连接“个人 → 企业”和“企业 → 企业”。旧版 <code>sourceLabel()</code> 与 <code>targetLabel()</code> 只支持单一配对,现已废弃。</p><p>其他问题可搜索 <a href=https://github.com/apache/hugegraph/issues>Server issues</a> 或 <a href=https://github.com/apache/hugegraph-toolchain/issues>Toolchain issues</a>。</p><template data-hg-authored-content=end></template><div class=td-page-end><section class=td-page-annotation data-td-page-annotation aria-label=页面信息><div class=td-page-meta__footer><div class="td-page-meta__item td-p [...]
+<span>最后修改 2026-10-23 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/efa1d042316e3f18caef4a642a685f38d2ec596f>docs: refresh bilingual guides and screenshots in core modules (#545) (efa1d0423)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/guides/security/ aria-label="上一页 - 报告安全问题" title=安全公告 data-td-pager-prev [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/performance/ aria-label="下一页 - PERFORMANCE" title=PERFORMANCE data-td-pager-next><span class=td-pager__title dir=auto>PERFORMANCE</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-she [...]
+<button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
+<span class=td-shell-aside-group__title>目录</span>
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#deployment>部署与启动</a><ul><li><a href=#choose-backend>如 [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/faq/index.md b/cn/docs/guides/faq/index.md
index e4526554d..273fe3461 100644
--- a/cn/docs/guides/faq/index.md
+++ b/cn/docs/guides/faq/index.md
@@ -4,98 +4,139 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 
 ---
 
-- 如何选择后端存储? 选 RocksDB 还是分布式存储?
+## 部署与启动 {#deployment}
 
-  HugeGraph 支持多种部署模式,根据数据规模和场景选择:
-  - **单机模式**:Server + RocksDB,适合开发测试、Graph AI 和中小规模生产环境(≤ 2 TB)
-  - **分布式模式**:HugeGraph-PD + HugeGraph-Store(HStore),用于需要水平扩展和多副本的部署,支持 ≤ 1 PB 的数据规模
+### 如何选择 RocksDB 或 HStore {#choose-backend}
 
-  1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用 1.5.x 或更早版本。
+开发测试或中小规模单机部署推荐选择 **Server + RocksDB**,部署轻便且性能优异。当数据规模较大(如 TB/PB 级)、需要水平扩容或多副本高可用时,推荐部署 **HStore 分布式集群**(PD + Store + Server)。
 
-- 启动服务时提示:`xxx (core dumped) xxx`
- 
-  请先确认 JDK 版本符合对应版本要求:HugeGraph 1.8.0+ 要求 Java 17,1.7.0 要求 Java 11。HugeGraph 不再支持 Java 8。
+1.7.0 支持 RocksDB、HStore、HBase 和 Memory。Cassandra、ScyllaDB、MySQL、PostgreSQL 等旧后端需使用低于 1.7.0 的版本。
+部署步骤见 [Server 快速开始](/cn/docs/quickstart/hugegraph/hugegraph-server/)。
 
-- 启动服务成功了,但是操作图时有类似于"无法连接到后端或连接未打开"的提示
+### 启动时出现 core dumped 怎么查 {#core-dump}
 
-  RocksDB、HBase 等本地持久化后端首次启动前需要使用 `init-store` 初始化。HStore 由 PD、Store 管理,不执行该脚本。
+先执行 `java -version` 确认 JDK 版本:**HugeGraph master 分支(以 1.8 为基线)要求 Java 17**,**1.7.0 要求 Java 11**(已不再支持 Java 8)。
+若 JDK 版本正确,进一步查看 Server 日志及 JVM 崩溃日志(`hs_err_pid*.log`),排查是否由于系统架构不匹配、依赖的动态库(如 RocksDB JNI)缺失或系统内存不足引起。
 
-- 所有的后端在使用前都需要执行`init-store`吗,序列化的选择可以随意填写么?
-  
-  Memory 和 HStore 不执行 `init-store`;RocksDB、HBase 等本地持久化后端首次使用前需要初始化。序列化器必须与后端匹配,例如 RocksDB 使用 `binary`。
+### 哪些后端需要 init-store {#initialize-backend}
 
-- 执行`init-store`报错:```Exception in thread "main" java.lang.UnsatisfiedLinkError: /tmp/librocksdbjni3226083071221514754.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.10' not found (required by /tmp/librocksdbjni3226083071221514754.so)```
+使用 RocksDB 或 HBase 等本地持久化后端时,**首次启动前必须执行 `bin/init-store.sh`** 进行初始化。Memory(内存后端)和 HStore(分布式后端)无需执行此脚本,HStore 的存储由 PD 和 Store 统一管理。
 
-  RocksDB需要 gcc 4.3.0 (GLIBCXX_3.4.10) 及以上版本
+注意:`backend` 与 `serializer` 必须配套使用(例如 RocksDB 配套 `binary`),不可随意替换。若服务启动后提示无法连接后端,请优先检查是否完成初始化以及后端存储配置是否正确。
 
-- `bin`目录下包含`start-hugegraph.sh`、`start-restserver.sh`和`start-gremlinserver.sh`三个似乎与启动有关的脚本,到底该使用哪个
+### init-store 报 GLIBCXX 版本缺失怎么办 {#native-library}
 
-  当前发布包只保留 `start-hugegraph.sh` 作为 Server 启动脚本。GremlinServer 和 REST Server 由同一进程启动。
+出现以下报错表示当前系统的 `libstdc++` 版本过低,缺少 RocksDB JNI 本地库所需的符号:
 
-- 配置了两个图,名字是`hugegraph`和`hugegraph1`,而启动服务的命令是`start-hugegraph.sh`,是只打开了`hugegraph`这个图吗
+```text
+java.lang.UnsatisfiedLinkError: .../librocksdbjni....so:
+.../libstdc++.so.6: version `GLIBCXX_3.4.10' not found
+```
 
-  脚本名称与图名无关。Server 默认从 `conf/graphs` 扫描并加载本地图配置,目录可在 `conf/rest-server.properties` 的 `graphs` 配置项中修改。`graph.load_from_local_config` 默认
-  `false`,控制构造阶段预加载,不能用于禁止启动时加载。每个本地图使用独立配置文件,配置变化后重启 Server。详见[服务端配置说明](/cn/docs/config/config-guide/)。
+解决方法:核对发行包支持的系统架构,升级系统的 `libstdc++`(或安装较新的 GCC 运行库),或者直接使用官方提供的 Docker 镜像运行。
 
-- 服务启动成功后,使用`curl`查询所有顶点时返回乱码
+### 应该使用哪个 Server 启动脚本 {#start-script}
 
-  服务端返回的批量顶点/边是压缩(gzip)过的,可以使用管道重定向至 `gunzip` 进行解压(`curl http://example | gunzip`),也可以用`Firefox`的`postman`或者`Chrome`浏览器的`restlet`插件发请求,会自动解压缩响应数据。
+当前发行包统一使用 `bin/start-hugegraph.sh`,GremlinServer 与 REST Server 会在同一个进程中启动。旧版本文档中的 `start-restserver.sh` 和 `start-gremlinserver.sh` 已废弃。
 
-- 使用顶点Id通过`RESTful API`查询顶点时返回空,但是顶点确实是存在的
+### 启动脚本会加载哪些图 {#load-graphs}
 
-  检查顶点Id的类型,如果是字符串类型,`API`的`url`中的id部分需要加上双引号,数字类型则不用加。
+脚本名称与加载的图无关。Server 默认会扫描并加载 `conf/graphs` 目录下的所有图配置(可在 `conf/rest-server.properties` 中的 `graphs` 修改该目录)。每张本地图使用独立的配置文件,修改配置后需重启 Server。
 
-- 已经根据需要给顶点Id加上了双引号,但是通过`RESTful API`查询顶点时仍然返回空
-  
-  检查顶点id中是否包含`+`、`空格`、`/`、`?`、`%`、`&`和`=`这些URL的保留字符,如果存在则需要进行编码。下表给出了编码值:
-  
-  ```text
-  特殊字符 | 编码值
-  --------| ----
-  +       | %2B
-  空格     | %20
-  /       | %2F
-  ?       | %3F
-  %       | %25
-  #       | %23
-  &       | %26
-  =       | %3D
-  ```
-  
-- 查询某一类别的顶点或边(`query by label`)时提示超时
+注:`graph.load_from_local_config` 默认为 `false`(控制构造阶段预加载),不能用来禁止启动时加载本地图。详见[服务端配置说明](/cn/docs/config/config-guide/)。
 
-  由于属于某一label的数据量可能比较多,请加上limit限制。
+## 连接与查询 {#queries}
 
-- 通过`RESTful API`操作图是可以的,但是发送`Gremlin`语句就报错:`Request Failed(500)`
+### curl 返回乱码怎么办 {#compressed-response}
 
-  可能是`GremlinServer`的配置有误,检查`gremlin-server.yaml`的`host`、`port`是否与`rest-server.properties`的`gremlinserver.url`匹配,如不匹配则修改,然后重启服务。
+批量顶点和边接口默认会返回 gzip 压缩数据。使用 curl 请求时加上 `--compressed` 参数即可自动解压:
 
-- 使用`Loader`导数据出现`Socket Timeout`异常,然后导致`Loader`中断
+```bash
+curl --compressed \
+  'http://127.0.0.1:8080/graphspaces/DEFAULT/graphs/hugegraph/graph/vertices?limit=10'
+```
 
-  持续地导入数据会使`Server`的压力过大,然后导致有些请求超时。可以通过调整`Loader`的参数来适当缓解`Server`压力(如:重试次数,重试间隔,错误容忍数等),降低该问题出现频率。
+若开启了认证,需同时传入凭据。若返回内容仍不符合预期,请检查 HTTP 状态码、`Content-Type` 与 `Content-Encoding`,不要把 JSON 报错直接管道传给 `gunzip`。
 
-- 如何删除图中的全部数据
+### 按顶点 ID 查询却找不到顶点 {#vertex-id}
 
-  管理员可调用 `DELETE /graphspaces/{graphspace}/graphs/{graph}/clear?confirm_message=I'm sure to delete all data`。`confirm_message` 查询参数必须与该值完全一致,否则请求会被拒绝,详见 [Graph API](../clients/restful-api/graphs)。该操作会清除 schema、顶点、边和索引。
+先从已有查询结果中确认 `id` 的实际格式和类型:**字符串 ID 需要 JSON 双引号,数值 ID 不需要**。例如字符串 ID `1:marko` 的 JSON 格式应为 `"1:marko"`。
 
-- 清空了数据库,并且执行了`init-store`,但是添加`schema`时提示"xxx has existed"
+在把 ID 放入 URL 路径时,必须对包含双引号在内的完整字符串进行 URL 编码。若 ID 含有特殊字符,不能仅补双引号而遗漏编码:
 
-  `HugeGraphServer`内是有缓存的,清空数据库的同时是需要重启`Server`的,否则残留的缓存会产生不一致。
+| 字符 | URL 编码 |
+| --- | --- |
+| `+` | `%2B` |
+| 空格 | `%20` |
+| `/` | `%2F` |
+| `?` | `%3F` |
+| `%` | `%25` |
+| `#` | `%23` |
+| `&` | `%26` |
+| `=` | `%3D` |
+| `"` | `%22` |
 
-- 插入顶点或边的过程中报错:`The max length of vertex id is 16384, but got xxx {yyy}` 或 `The max length of edge id is 65536, but got xxx {yyy}`
+### 按类型查询顶点或边时超时 {#label-timeout}
 
-  为了保证查询性能,目前的后端存储对id列的长度做了限制,顶点id不能超过16384字节,边id长度不能超过65536字节;索引id超过32字节时会转为哈希存储,而不是报错。
+当某个标签下的数据量很大时,全量扫描很容易耗尽资源导致超时。建议优化方式:
+1. 加上 `limit()` 限制返回记录数;
+2. 使用分页机制分批读取;
+3. 配合具体属性过滤,并确保对应属性已建立索引,避免全表扫描。
 
-- 是否支持嵌套属性,如果不支持,是否有什么替代方案
+### REST 请求正常,Gremlin 返回 500 {#gremlin-connection}
 
-  嵌套属性目前暂不支持。替代方案:可以把嵌套属性作为单独的顶点拿出来,然后用边连接起来。
+REST 接口正常仅说明 HTTP 入口可用,Gremlin 执行返回 500 通常有以下原因:
+1. **Gremlin Server 连接异常**:检查 `conf/rest-server.properties` 中的 `gremlinserver.url` 是否指向可达的 Gremlin 端口(默认 `8182`,对应 `conf/gremlin-server.yaml`);
+2. **语句语法或逻辑错误**:例如未加索引导致遍历被拦截;
+3. **认证凭据缺失或过期**。
 
-- 一个`EdgeLabel`是否可以连接多对`VertexLabel`,比如"投资"关系,可以是"个人"投资"企业",也可以是"企业"投资"企业"
+建议查看 `logs/hugegraph-server.log` 中的异常堆栈定位具体报错。
 
-  可以。创建`EdgeLabel`时对每一对顶点标签各调用一次`link(sourceLabel, targetLabel)`,所有配对都会被保留,因此同一个"投资"标签可以同时覆盖"个人"投资"企业"和"企业"投资"企业"。旧的`sourceLabel()`和`targetLabel()`构建方法已废弃,且只支持单一配对。
+### REST 请求返回 HTTP 415 {#content-type}
 
-- 通过`RestAPI`发送请求时提示`HTTP 415 Unsupported Media Type`
+发送带请求体的 POST/PUT 请求时,需在请求头中指定 `Content-Type: application/json`,并确保请求体是合法的 JSON 格式。
 
-  请求头中需要指定`Content-Type:application/json`
+## 导入与数据维护 {#data-management}
 
-其他问题可以在对应项目的 issue 区搜索,例如 [Server-Issues](https://github.com/apache/hugegraph/issues) / [Loader Issues](https://github.com/apache/hugegraph-toolchain/issues)
+### Loader 出现 Socket Timeout {#loader-timeout}
+
+导入超时通常由于单批次写入过大或并发压力过高导致。建议:
+1. 适当调小 `--batch-size`(如由 500 降为 200);
+2. 适当降低并发线程数;
+3. 调大 `--timeout` 并配置重试机制。参数说明见 [Loader 指南](/cn/docs/quickstart/toolchain/hugegraph-loader/)。
+
+### 如何清空一张图 {#clear-graph}
+
+管理员可调用以下接口清空指定图的 Schema、顶点、边和索引(执行前请务必确认目标图并做好备份):
+
+```text
+DELETE /graphspaces/{graphspace}/graphs/{graph}/clear
+```
+
+请求需携带 `confirm_message` 查询参数,值必须严格等于 `I'm sure to delete all data`(需进行 URL 编码)。完整调用方式见 [Graph API](/cn/docs/clients/restful-api/graphs/)。
+
+### 清理底层存储后,为什么仍提示 Schema 已存在 {#schema-cache}
+
+Server 在内存中维护了 Schema 缓存。如果直接绕过 Server 清理底层存储(如清空 RocksDB 目录或 HBase 表),Server 缓存与实际存储将出现不一致。
+若已手动清理底层,必须**重启 Server**。日常清理建议使用官方提供的 [Clear 图 API](/cn/docs/clients/restful-api/graphs/#clear-graph)。
+
+## 建模与 ID {#modeling}
+
+### 顶点或边 ID 超过长度限制 {#id-length}
+
+为保证底层存储与索引性能,HugeGraph 对 ID 长度作了如下限制(按编码后的字节数计算):
+- **顶点 ID**:最长 16384 字节(16 KB);
+- **边 ID**:最长 65536 字节(64 KB)。
+
+建议使用简洁的业务唯一标识作为主键,避免在 ID 中拼接大段文本。注:属性索引值超过 32 字节时会自动转为哈希存储,不会报错超长。
+
+### 是否支持嵌套属性 {#nested-properties}
+
+目前不支持嵌套属性(复杂对象或嵌套 Map)。如果需要表达多层级关系,建议将嵌套对象拆分成独立的顶点,通过边与主体顶点相连。
+
+### 一个边类型能连接多组顶点类型吗 {#edge-links}
+
+支持。创建 `EdgeLabel` 时,对每一组起点和终点类型分别调用一次 `link(sourceLabel, targetLabel)` 即可。
+例如“投资”关系可以同时连接“个人 → 企业”和“企业 → 企业”。旧版 `sourceLabel()` 与 `targetLabel()` 只支持单一配对,现已废弃。
+
+其他问题可搜索 [Server issues](https://github.com/apache/hugegraph/issues) 或 [Toolchain issues](https://github.com/apache/hugegraph-toolchain/issues)。
diff --git a/cn/docs/guides/hugegraph-docker-cluster/index.html b/cn/docs/guides/hugegraph-docker-cluster/index.html
index 59648b585..340dedf92 100644
--- a/cn/docs/guides/hugegraph-docker-cluster/index.html
+++ b/cn/docs/guides/hugegraph-docker-cluster/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -188,7 +188,7 @@ Compose 中 Server 服务的 <code>environment:</code> 里添加,自带的 Com
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#概述>概述</a></li><li><a href=#前置条件>前置条件</a></li><li><a h [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/index.html b/cn/docs/guides/index.html
index e0d8f38e3..0403231f2 100644
--- a/cn/docs/guides/index.html
+++ b/cn/docs/guides/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -98,7 +98,7 @@
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/_index.md targe [...]
 <span>最后修改 2026-09-04 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/d88167dd797efafea50cec59909d57849703fde5>docs: sync content for 1.7.0 updates (#470) (d88167dd7)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/performance/hugegraph-loader-performance/ aria-label="上一页 - HugeGraph-Loader Performance" title="H [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/ aria-label="下一页 - CHANGELOGS" title=CHANGELOGS data-td-pager-next><span class=td-pager__title dir=auto>CHANGELOGS</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc__title-btn data-td [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/changelog/ aria-label="下一页 - CHANGELOGS" title=CHANGELOGS data-td-pager-next><span class=td-pager__title dir=auto>CHANGELOGS</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button type=button class=td-shell-toc__title-btn data-td [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/index.md b/cn/docs/guides/index.md
index 618bb1573..64b900523 100644
--- a/cn/docs/guides/index.md
+++ b/cn/docs/guides/index.md
@@ -14,7 +14,7 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 - [HugeGraph 设计理念](/cn/docs/guides/desgin-concept/)
 - [HugeGraph Plugin 机制及插件扩展流程](/cn/docs/guides/custom-plugin/)
 - [HugeGraph工具链本地测试指南](/cn/docs/guides/toolchain-local-test/)
-- [Backup Restore](/cn/docs/guides/backup-restore/)
+- [备份与恢复](/cn/docs/guides/backup-restore/)
 - [HugeGraph Docker 集群部署指南](/cn/docs/guides/hugegraph-docker-cluster/)
 - [FAQ](/cn/docs/guides/faq/)
 - [报告安全问题](/cn/docs/guides/security/)
diff --git a/cn/docs/guides/index.xml b/cn/docs/guides/index.xml
index cdae59f55..c40d56989 100644
--- a/cn/docs/guides/index.xml
+++ b/cn/docs/guides/index.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>使用指南 on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/guides/</link><description>Recent content in 使用指南 on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Sun, 18 Oct 2026 05:21:43 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/guides/index.xml" rel="self" type= [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>使用指南 on Apache HugeGraph</title><link>https://hugegraph.apache.org/cn/docs/guides/</link><description>Recent content in 使用指南 on Apache HugeGraph</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Fri, 23 Oct 2026 04:09:50 +0800</lastBuildDate><atom:link href="https://hugegraph.apache.org/cn/docs/guides/index.xml" rel="self" type= [...]
\ No newline at end of file
diff --git a/cn/docs/guides/security/index.html b/cn/docs/guides/security/index.html
index 4b04044d0..d4d77fa0b 100644
--- a/cn/docs/guides/security/index.html
+++ b/cn/docs/guides/security/index.html
@@ -78,7 +78,7 @@ Server 标准配置将鉴权代理的审计记录写入 audit-*.log。部署时
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocs_navoperate-children aria-label="收起章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -105,14 +105,14 @@ Server 标准配置将鉴权代理的审计记录写入 audit-*.log。部署时
 </button>
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/guides/security/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/guides/securi [...]
-<span>最后修改 2026-09-30 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/a8c6857943e0deb84b4bbdfde79a76a0e80d8de1>docs: sync core modules guides (#501) (a8c685794)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/ aria-label="上一页 - Backup Restore" title="备份 & 恢复" data-td-pager-prev><span class= [...]
+<span>最后修改 2026-09-30 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/a8c6857943e0deb84b4bbdfde79a76a0e80d8de1>docs: sync core modules guides (#501) (a8c685794)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/guides/backup-restore/ aria-label="上一页 - 备份与恢复" title="备份 & 恢复" data-td-pager-prev><span class=td-pager_ [...]
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/faq/ aria-label="下一页 - FAQ" title=FAQ data-td-pager-next><span class=td-pager__title dir=auto>FAQ</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell-aside-group--toc"><div [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#报告-apache-hugegraph-的安全问题>报告 Apache HugeGraph 的安全问题</ [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/hugegraph/hugegraph-server/>安装/构建 HugeGraph Server</a></li></ul></div></div></div [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/shared-foundation-migration/index.html b/cn/docs/guides/shared-foundation-migration/index.html
index 4bba3fed5..71da21281 100644
--- a/cn/docs/guides/shared-foundation-migration/index.html
+++ b/cn/docs/guides/shared-foundation-migration/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -155,7 +155,7 @@ Loader 的 REST 边界和独立 client DTO 无需整体改为 struct。</p><p>To
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#先确定需要调整的部分>先确定需要调整的部分</a></li><li><a href=#共享代码现在由谁维护 [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/contribute/>贡献流程</a></li><li class=td-shell-backlinks__item><a href= [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/contribute/>贡献流程</a></li><li class=td-shell-backlinks__item><a href= [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/toolchain-local-test/index.html b/cn/docs/guides/toolchain-local-test/index.html
index 72e116cad..1dfe60546 100644
--- a/cn/docs/guides/toolchain-local-test/index.html
+++ b/cn/docs/guides/toolchain-local-test/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -309,7 +309,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#1-核心概念>1. 核心概念</a><ul><li><a href=#11-核心依赖hugegraph-s [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/>HugeGraph 工具链</a></li><li class=td-shell-backlinks__item><a href=https [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/quickstart/toolchain/>HugeGraph 工具链</a></li><li class=td-shell-backlinks__item><a href=https [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/guides/toplingdb/index.html b/cn/docs/guides/toplingdb/index.html
index ebf1c8e7d..a0f9b2967 100644
--- a/cn/docs/guides/toplingdb/index.html
+++ b/cn/docs/guides/toplingdb/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -137,7 +137,7 @@ PD 的 <code>bin/stop-hugegraph-pd.sh</code>,等待前一个进程退出后再
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#确认数据库所属组件>确认数据库所属组件</a></li><li><a href=#构建并准备标准发行包>构 [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/blog/hugegraph/toplingdb/>ToplingDB</a></li><li class=td-shell-backlinks__item><a href=https://hu [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/blog/hugegraph/toplingdb/>ToplingDB</a></li><li class=td-shell-backlinks__item><a href=https://hu [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/images/hubble/accounts.jpg b/cn/docs/images/hubble/accounts.jpg
index df8d31583..fb5cf939a 100644
Binary files a/cn/docs/images/hubble/accounts.jpg and b/cn/docs/images/hubble/accounts.jpg differ
diff --git a/cn/docs/images/hubble/algorithms.jpg b/cn/docs/images/hubble/algorithms.jpg
index b243901d3..027307349 100644
Binary files a/cn/docs/images/hubble/algorithms.jpg and b/cn/docs/images/hubble/algorithms.jpg differ
diff --git a/cn/docs/images/hubble/cluster-overview.jpg b/cn/docs/images/hubble/cluster-overview.jpg
index b99efc081..70336b88d 100644
Binary files a/cn/docs/images/hubble/cluster-overview.jpg and b/cn/docs/images/hubble/cluster-overview.jpg differ
diff --git a/cn/docs/images/hubble/graphspace.jpg b/cn/docs/images/hubble/graphspace.jpg
index 7b887affb..45eb97ba3 100644
Binary files a/cn/docs/images/hubble/graphspace.jpg and b/cn/docs/images/hubble/graphspace.jpg differ
diff --git a/cn/docs/images/hubble/members.jpg b/cn/docs/images/hubble/members.jpg
index 31d86bd6c..3402a7188 100644
Binary files a/cn/docs/images/hubble/members.jpg and b/cn/docs/images/hubble/members.jpg differ
diff --git a/cn/docs/images/hubble/overview.jpg b/cn/docs/images/hubble/overview.jpg
index de4db52d2..e9f0ee50f 100644
Binary files a/cn/docs/images/hubble/overview.jpg and b/cn/docs/images/hubble/overview.jpg differ
diff --git a/cn/docs/images/hubble/query.jpg b/cn/docs/images/hubble/query.jpg
index becd373fc..55dd1f433 100644
Binary files a/cn/docs/images/hubble/query.jpg and b/cn/docs/images/hubble/query.jpg differ
diff --git a/cn/docs/images/hubble/schema.jpg b/cn/docs/images/hubble/schema.jpg
index a868f3508..34e68c723 100644
Binary files a/cn/docs/images/hubble/schema.jpg and b/cn/docs/images/hubble/schema.jpg differ
diff --git a/cn/docs/images/hubble/store-node.jpg b/cn/docs/images/hubble/store-node.jpg
index 523e37ede..387ea5280 100644
Binary files a/cn/docs/images/hubble/store-node.jpg and b/cn/docs/images/hubble/store-node.jpg differ
diff --git a/cn/docs/images/hubble/text2gql-prompt.jpg b/cn/docs/images/hubble/text2gql-prompt.jpg
index 2a92dc199..6ae93bd6b 100644
Binary files a/cn/docs/images/hubble/text2gql-prompt.jpg and b/cn/docs/images/hubble/text2gql-prompt.jpg differ
diff --git a/cn/docs/images/hubble/text2gql-settings.jpg b/cn/docs/images/hubble/text2gql-settings.jpg
index a36dd2e55..d15df46f4 100644
Binary files a/cn/docs/images/hubble/text2gql-settings.jpg and b/cn/docs/images/hubble/text2gql-settings.jpg differ
diff --git a/cn/docs/images/hubble/text2gql.jpg b/cn/docs/images/hubble/text2gql.jpg
index f9f020bc0..c154ec221 100644
Binary files a/cn/docs/images/hubble/text2gql.jpg and b/cn/docs/images/hubble/text2gql.jpg differ
diff --git a/cn/docs/index.html b/cn/docs/index.html
index b561f6198..7ce93f149 100644
--- a/cn/docs/index.html
+++ b/cn/docs/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -117,7 +117,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#apache-hugegraph-文档>Apache HugeGraph 文档</a><ul><li><a [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/committer-guidelines/>Apache HugeGraph Committer 指南</a></li></ul></d [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/contribution-guidelines/committer-guidelines/>Apache HugeGraph Committer 指南</a></li></ul></d [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/introduction/index.html b/cn/docs/introduction/index.html
index fdbd6ba69..ec35f32d5 100644
--- a/cn/docs/introduction/index.html
+++ b/cn/docs/introduction/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocslanguage-children aria-label="展开章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -116,7 +116,7 @@
 <span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><a href=#什么是-apache-hugegraph>什么是 Apache HugeGraph?</a></li><l [...]
 <span class=td-shell-aside-group__icon aria-hidden=true><i class="td-shell-icon td-shell-icon--link fa-solid fa-link" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>反链</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/>Documentation</a></li></ul></div></div></div></div></div></aside><div class="td-shell-toc-f [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button><div id=td-shell-backlinks-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class=td-shell-backlinks__list><li class=td-shell-backlinks__item><a href=https://hugegraph.apache.org/cn/docs/>Documentation</a></li></ul></div></div></div></div></div></aside><div class="td-shell-toc-f [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/language/hugegraph-example/index.html b/cn/docs/language/hugegraph-example/index.html
index e3cc5cde7..f7dd13fa9 100644
--- a/cn/docs/language/hugegraph-example/index.html
+++ b/cn/docs/language/hugegraph-example/index.html
@@ -74,7 +74,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocslanguage-children aria-label="收起章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -179,7 +179,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/hugegraph-docker-cluster/ aria-label="下一页 - HugeGraph Docker 集群部署指南" title="Docker 集群" data-td-pager-next><span class=td-pager__title dir=auto>Docker 集群</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div clas [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-概述>1 概述</a></li><li><a href=#2-graph-schema [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#1-概述>1 概述</a></li><li><a href=#2-graph-schema [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/language/hugegraph-gremlin/index.html b/cn/docs/language/hugegraph-gremlin/index.html
index 7ddd1bcfd..1579ca501 100644
--- a/cn/docs/language/hugegraph-gremlin/index.html
+++ b/cn/docs/language/hugegraph-gremlin/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocslanguage-children aria-label="收起章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -101,7 +101,7 @@
 </a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/guides/architectural/ aria-label="下一页 - HugeGraph 架构概览" title=架构概览 data-td-pager-next><span class=td-pager__title dir=auto>架构概览</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-aside data-td-shell-aside><div class="td-shell-aside-group td-shell [...]
 <button type=button class="td-shell-tree__row td-shell-aside-group__head" data-td-shell-tree-toggle data-td-shell-aside-keep-open aria-expanded=true aria-controls=td-shell-aside-toc aria-label="收起章节: 目录" data-td-label-expand="展开章节: 目录" data-td-label-collapse="收起章节: 目录"><span class="td-shell-aside-group__icon td-shell-aside-group__icon--toc" aria-hidden=true><i class="td-shell-icon td-shell-icon--menu fa-solid fa-bars" aria-hidden=true></i></span>
 <span class=td-shell-aside-group__title>目录</span>
-<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#tinkerpop-features [...]
+<span class=td-shell-tree__chevron aria-hidden=true><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></span></button></div><div id=td-shell-aside-toc class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><div class=td-shell-toc__inner data-proofer-ignore><div class=td-shell-toc__body id=td-shell-toc-body><nav id=TableOfContents aria-label=目录><ul><li><ul><li><a href=#概述>概述</a></li><li><a href=#tinkerpop-features [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/language/index.html b/cn/docs/language/index.html
index fd7479c70..542eca619 100644
--- a/cn/docs/language/index.html
+++ b/cn/docs/language/index.html
@@ -70,7 +70,7 @@
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsquickstartclient-children aria-label="展开章节: HugeGraph Client" data-td-label-expand="展开章节: HugeGraph Client" data-td-label-collapse="收起章节: HugeGraph Client"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsquickstartclient-children class=td-shell-tree__children><div class=td-shell-tree__children- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocslanguage-children aria-label="收起章节: 查询语言" data-td-label-expand="展开章节: 查询语言" data-td-label-collapse="收起章节: 查询语言"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocslanguage-children class="td-shell-tree__children td-is-open"><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td- [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocs_navoperate-children aria-label="展开章节: 配置" data-td-label-expand="展开章节: 配置" data-td-label-collapse="收起章节: 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocs_navoperate-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-shell-tree__ [...]
-<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
+<button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsconfig-children aria-label="展开章节: Server 配置" data-td-label-expand="展开章节: Server 配置" data-td-label-collapse="收起章节: Server 配置"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsconfig-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell-tree__list td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformance-children aria-label="展开章节: PERFORMANCE" data-td-label-expand="展开章节: PERFORMANCE" data-td-label-collapse="收起章节: PERFORMANCE"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformance-children class=td-shell-tree__children><div class=td-shell-tree__children-inner><ul class="td-shell [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=false aria-controls=m-cndocsperformanceapi-performance-children aria-label="展开章节: HugeGraph-API 性能" data-td-label-expand="展开章节: HugeGraph-API 性能" data-td-label-collapse="收起章节: HugeGraph-API 性能"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformanceapi-performance-children class=td-shell-tree__children><div class=td-s [...]
 <button type=button class=td-shell-tree__chevron data-td-shell-tree-toggle aria-expanded=true aria-controls=m-cndocsperformancehugegraph-benchmark-056-children aria-label="收起章节: HugeGraph 基准测试" data-td-label-expand="展开章节: HugeGraph 基准测试" data-td-label-collapse="收起章节: HugeGraph 基准测试"><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><div id=m-cndocsperformancehugegraph-benchmark-056-children class="td-shell-tree__children td-is [...]
@@ -98,7 +98,7 @@
 <button type=button class=td-page-actions__toggle data-td-page-actions-toggle aria-expanded=false aria-controls=td-page-actions-menu title=操作 aria-label=操作><i class="td-shell-icon td-shell-icon--chevron-down fa-solid fa-angle-down" aria-hidden=true></i></button></div><ul class=td-page-actions__menu id=td-page-actions-menu data-td-page-actions-menu aria-label=操作><li><button type=button class=td-page-actions__item data-td-action=copy_markdown data-td-url=https://hugegraph.apache.org/cn/doc [...]
 <i class="fa-regular fa-copy" aria-hidden=true></i><span>复制 Markdown 文本</span></button></li><li><a class=td-page-actions__item data-td-action=view_markdown href=https://hugegraph.apache.org/cn/docs/language/index.md target=_blank rel=noopener><i class="fa-brands fa-markdown" aria-hidden=true></i><span>查阅 Markdown 源码</span></a></li><li><a class=td-page-actions__item data-td-action=view_history href=https://github.com/apache/hugegraph-doc/commits/master/content/cn/docs/language/_index.md t [...]
 <span>最后修改 2026-09-04 &#183; <a data-proofer-ignore href=https://github.com/apache/hugegraph-doc/commit/d88167dd797efafea50cec59909d57849703fde5>docs: sync content for 1.7.0 updates (#470) (d88167dd7)</a></span></div></div></section><nav class="td-pager d-print-none" data-td-pager aria-label="上一页 / 下一页"><a class="td-pager__link td-pager__link--prev" href=https://hugegraph.apache.org/cn/docs/quickstart/client/hugegraph-client-go/ aria-label="上一页 - HugeGraph Go 客户端快速入门" title="Go 客户端" data [...]
-</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/language/hugegraph-gremlin/ aria-label="下一页 - HugeGraph Gremlin" title="Gremlin Query Language" data-td-pager-next><span class=td-pager__title dir=auto>Gremlin Query Language</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button [...]
+</a><a class="td-pager__link td-pager__link--next" href=https://hugegraph.apache.org/cn/docs/language/hugegraph-gremlin/ aria-label="下一页 - HugeGraph Gremlin" title="Gremlin Query Language" data-td-pager-next><span class=td-pager__title dir=auto>Gremlin Query Language</span><span class=td-pager__arrow aria-hidden=true>→</span></a></nav></div></div></article></main><aside class="td-shell-toc d-print-none" aria-label=目录><div class=td-shell-toc__panel><div class=td-shell-toc__actions><button [...]
 <input type=search class=td-shell-search__input placeholder=搜索… autocomplete=off autocorrect=off autocapitalize=off spellcheck=false role=combobox aria-autocomplete=list aria-haspopup=listbox aria-controls=td-shell-search-results aria-expanded=false aria-label=搜索… enterkeyhint=go>
 <button type=button class=td-shell-search__esc data-td-shell-search-close aria-label=关闭>
 <kbd>esc</kbd></button></div><div id=td-shell-search-results class=td-shell-search__list role=listbox aria-label=搜索…></div><div class=visually-hidden role=status aria-live=polite aria-atomic=true data-td-shell-search-status></div><div class=td-shell-search__foot aria-hidden=true><span><kbd>↑</kbd><kbd>↓</kbd> 选择</span>
diff --git a/cn/docs/llms-full.txt b/cn/docs/llms-full.txt
index 39cf421d7..703e5b5f9 100644
--- a/cn/docs/llms-full.txt
+++ b/cn/docs/llms-full.txt
@@ -317,7 +317,8 @@ Server 安全检查(`-s true`)要求 Java 17 到 23 以及可读的 `conf/ja
 serializer:
   className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1
   config:
-    ioRegistries: [org.apache.hugegraph.structure.io.HugeGraphIoRegistry]
+    builder: org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder
+    ioRegistries: [org.apache.hugegraph.io.HugeGraphIoRegistry]
 ```
 
 ```yaml {tab="GraphSON (HTTP/兼容)"}
@@ -1075,6 +1076,7 @@ bin/stop-hugegraph.sh
 - [在 IDEA 中配置 Server 开发环境](/cn/docs/contribution-guidelines/hugegraph-server-idea-setup/)
 - [Download](/cn/docs/download/download/)
 - [架构概览](/cn/docs/guides/architectural/)
+- [FAQ](/cn/docs/guides/faq/)
 - [安全公告](/cn/docs/guides/security/)
 - [Toolchain本地测试](/cn/docs/guides/toolchain-local-test/)
 - [系统介绍](/cn/docs/introduction/)
@@ -1083,6 +1085,7 @@ bin/stop-hugegraph.sh
 - [安装/构建 HugeGraph-Store](/cn/docs/quickstart/hugegraph/hugegraph-hstore/)
 - [Hubble 基础与单机](/cn/docs/quickstart/toolchain/hugegraph-hubble/)
 - [使用 Loader 实时/流式导入数据](/cn/docs/quickstart/toolchain/hugegraph-loader/)
+- [使用 Tools 导出/管理图](/cn/docs/quickstart/toolchain/hugegraph-tools/)
 - [使用 SeaTunnel Sink 导入图数据](/cn/docs/quickstart/toolchain/import/hugegraph-seatunnel-connector/)
 
 
@@ -2425,7 +2428,7 @@ PD 启动脚本读取安装目录中的 `conf/application.yml`。请使用与安
 
 #### 4.1 配置项参考
 
-以下表格核对的是 server 主线提交 `2f827d6e8c9c62ae858f2fc122b3a192d015e2f4` 中的 `hg-pd-dist` 配置和 Java 默认注入值(三个 `raft.rpc-*` 配置项按 [apache/hugegraph#3368](https://github.com/apache/hugegraph/pull/3368) 核对),不是 1.7.0 发布标签的全部行为。1.7.0 二进制包请使用其标签对应的原始配置;主线源码构建包则以 [主线配置文件](https://github.com/apache/hugegraph/blob/master/hugegraph-pd/hg-pd-dist/src/assembly/static/conf/application.yml) 为准。
+以下表格列出主线配置及代码默认值,Raft 超时设置可参阅 [PDConfig 实现](https://github.com/apache/hugegraph/blob/master/hugegraph-pd/hg-pd-core/src/main/java/org/apache/hugegraph/pd/config/PDConfig.java)。1.7.0 二进制包请使用对应标签的原始配置;主线源码构建包则以 [主线配置文件](https://github.com/apache/hugegraph/blob/master/hugegraph-pd/hg-pd-dist/src/assembly/static/conf/application.yml) 为准。下文会单独说明与 1.7.0 的差异。
 
 **gRPC 与 REST**
 
@@ -3374,47 +3377,69 @@ Hubble 是 HugeGraph 的 Web 管理与图可视化界面。你可以在同一个
 并在图、表格和 JSON 视图之间自由切换。本文以 **单机 RocksDB Server + Hubble** 为例走通完整操作,无需预先部署 PD 或 Store。
 
 如需搭配 HStore 分布式集群使用,可先了解本文的基础操作,再参考 [HStore 分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)。
-文档内容以 Toolchain 与 Server 的 `master` 分支(当前版本均为 `1.8.0`)为准;Docker `latest` 为动态标签,实际部署建议使用固定版本。
+文档内容以 Toolchain 与 Server 的 `master` 分支(当前均以 1.8 为基线,尚未正式发布)为准;Docker `latest` 为动态标签,生产环境建议使用已发布的固定版本。
+
+本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。
 
 > [!WARNING]
 > 请勿将未配置防护的 Hubble 或 Server 直接暴露在公网上。生产环境请务必开启 HTTPS、容器网络隔离、
 > [认证与授权](/cn/docs/config/config-authentication/)及访问白名单。
 
+可按需快速跳转到对应操作;首次使用建议从启动单机环境开始:
+
+- [启动并加载示例](#启动单机组合)
+
+  启动两个服务,加载人物与软件示例图。
+- [查询与可视化](#gql-工作台查询与探索人物关系)
+
+  运行 Gremlin,再查看图、表格或 JSON 结果。
+- [导入自己的数据](#数据源管理把原始数据准备好)
+
+  准备 CSV,配置数据源、字段映射并验证导入结果。
+{.cards}
+
 ## 启动单机组合
 
 直接使用主仓库提供的 [docker/docker-compose.yml](https://github.com/apache/hugegraph/blob/master/docker/docker-compose.yml) 即可,
 无需自行编写 Compose 配置文件。该文件已内置编排了 RocksDB Server 与 Hubble,并配置好网络、健康检查及持久化数据卷;
 完整部署说明见同目录的 [README](https://github.com/apache/hugegraph/blob/master/docker/README.md)。
 
-```bash
-git clone --branch master --single-branch --depth 1 https://github.com/apache/hugegraph.git
-cd hugegraph/docker
-```
+1. **准备官方 Compose 配置。**
 
-若本地已有主仓库,直接进入其 `docker/` 目录即可。Compose 会自动挂载该目录下的
-[`conf/hubble/standalone.properties`](https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties),
-已预设 `pd.enabled=false` 与 `server.direct_url=http://server:8080`。两项服务处于同一 Docker 网络中通信,
-无需为每个图单独配置 Server 地址。请直接在 `docker/` 目录下启动,以确保相对配置路径有效。
+   ```bash
+   git clone --branch master --single-branch --depth 1 https://github.com/apache/hugegraph.git
+   cd hugegraph/docker
+   ```
 
-Hubble 默认只在宿主机回环地址开放 `8088`(由 `HUBBLE_PUBLISH_HOST` 环境变量控制,默认为 `127.0.0.1`);
-Server 默认对外发布 `8080`。若仅供本机试用,可将 Compose 中 Server 的 `ports` 改为 `127.0.0.1:8080:8080`,避免匿名端口暴露到外部网络。
+   若本地已有主仓库,直接进入其 `docker/` 目录即可。Compose 会自动挂载该目录下的
+   [`conf/hubble/standalone.properties`](https://github.com/apache/hugegraph/blob/master/docker/conf/hubble/standalone.properties),
+   已预设 `pd.enabled=false` 与 `server.direct_url=http://server:8080`。两项服务处于同一 Docker 网络中通信,
+   无需为每个图单独配置 Server 地址。请直接在 `docker/` 目录下启动,以确保相对配置路径有效。
 
-为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置:
+   Hubble 默认只在宿主机回环地址开放 `8088`(由 `HUBBLE_PUBLISH_HOST` 环境变量控制,默认为 `127.0.0.1`);
+   Server 默认对外发布 `8080`。若仅供本机试用,可将 Compose 中 Server 的 `ports` 改为 `127.0.0.1:8080:8080`,避免匿名端口暴露到外部网络。
 
-```bash
-export HUGEGRAPH_VERSION=latest
-export HUBBLE_IMAGE=hugegraph/hubble:latest
-export HUBBLE_DEMO_PROJECT="hubble-demo-$(date +%Y%m%d-%H%M%S)"
-docker compose ls
-docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml pull
-docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml up -d --wait
-docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml ps
-curl -fsS http://127.0.0.1:8080/versions
-```
+1. **启动并检查服务。**
+
+   为本次试用指定一个独立的项目名,后续命令在同一终端中沿用这些环境变量;另起终端时请重新设置。
+
+   ```bash
+   export HUGEGRAPH_VERSION=latest
+   export HUBBLE_IMAGE=hugegraph/hubble:latest
+   export HUBBLE_DEMO_PROJECT="hubble-demo-$(date +%Y%m%d-%H%M%S)"
+   docker compose ls
+   docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml pull
+   docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml up -d --wait
+   docker compose -p "$HUBBLE_DEMO_PROJECT" -f docker-compose.yml ps
+   curl -fsS http://127.0.0.1:8080/versions
+   ```
+
+1. **打开 Hubble。**
 
-服务启动完成后,在浏览器访问 <http://127.0.0.1:8088>。若未在 `.env` 中配置 `HUGEGRAPH_ADMIN_PASSWORD`,Server 默认允许匿名访问,
-Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在 `.env` 中配置管理员密码与 JWT 密钥,并使用 Server 账号登录(Hubble 无独立用户库)。
-个人中心与账号管理入口仅在开启认证且具备相应权限时展示。
+   服务启动完成后,在浏览器访问 <http://127.0.0.1:8088>。若未在 `.env` 中配置 `HUGEGRAPH_ADMIN_PASSWORD`,Server 默认允许匿名访问,
+   Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在 `.env` 中配置管理员密码与 JWT 密钥,并使用 Server 账号登录(Hubble 无独立用户库)。
+   个人中心与账号管理入口仅在开启认证且具备相应权限时展示。
+{.steps}
 
 `latest` 镜像便于快速体验最新功能,生产环境建议指定发布版本号或镜像 digest。正式发布包可前往 [下载页](/cn/docs/download/download/) 获取。
 
@@ -3425,7 +3450,7 @@ Hubble 会直接进入首页。若已启用认证,请根据 Docker README 在
 Compose 中的 `server-data` 与 `hubble-data` 卷分别持久化保存图数据与 Hubble 元数据;更多生产配置参见
 [Server 部署指南](/cn/docs/quickstart/hugegraph/hugegraph-server/)。
 
-## 首页:找到当前任务的入口
+## 首页与任务入口 {#首页找到当前任务的入口}
 
 首页按“图概览 → 图导入 → 图查询”组织核心工作流。左侧导航栏可随时切换各功能模块;
 顶部的图选择器用于切换当前操作的目标图,所有查询、Schema 操作和异步任务均作用于当前选中的图。
@@ -3448,12 +3473,12 @@ Compose 中的 `server-data` 与 `hubble-data` 卷分别持久化保存图数据
 图概览、Schema 和查询工作区如下,点击任一截图可查看原图。
 
 ```gallery
-![人物与软件示例的图概览](/cn/docs/images/hubble/overview.jpg) # 图概览:选择图并查看示例数据
-![顶点类型列表中的主键与数值 ID 策略](/cn/docs/images/hubble/schema.jpg) # Schema:查看顶点类型、主键与 ID 策略
-![Gremlin 路径查询与图结果](/cn/docs/images/hubble/query.jpg) # 图查询:执行 Gremlin 并探索图结果
+![人物与软件示例的图概览](/cn/docs/images/hubble/overview.jpg) # 图概览,选择图并查看示例数据
+![顶点类型列表中的主键与数值 ID 策略](/cn/docs/images/hubble/schema.jpg) # Schema,查看顶点类型、主键与 ID 策略
+![Gremlin 路径查询与图结果](/cn/docs/images/hubble/query.jpg) # 图查询,执行 Gremlin 并探索图结果
 ```
 
-## 图概览与图详情:先认识一张图
+## 认识图概览与图详情 {#图概览与图详情先认识一张图}
 
 在【图概览】中选择默认图 `hugegraph`。点击图卡片或详情,可查看该图的 Schema 结构与数据统计,并快速跳转到建模、数据导入或查询页面。
 
@@ -3463,7 +3488,7 @@ Compose 中的 `server-data` 与 `hubble-data` 卷分别持久化保存图数据
 若需新建图,可在页面点击新建按钮,填写图名称、可选别名并选择 Schema 模板或示例数据。连接信息由 Hubble 后端统一配置,
 无需重复填写 Server 主机与账号。用户自定义 Schema 模板属于 PD 模式功能,详见 [分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)。
 
-## Schema 建模:定义数据的形状
+## 定义 Schema {#schema-建模定义数据的形状}
 
 Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶点 ID 的生成策略与索引规则。
 在【元数据配置】中,可以通过列表视图维护定义,或通过图关系视图直观查看顶点与边的拓扑结构。
@@ -3475,22 +3500,22 @@ Schema 规定了图中允许存储的属性、顶点与边类型,并决定顶
 | 边类型 | 起点和终点类型、属性、边的频次及排序键 |
 | 顶点索引 / 边索引 | 索引类型与字段,匹配实际过滤和范围查询 |
 
-在人物与软件示例中:`person` 以 `name` 为主键生成 ID,`age` 与 `city` 允许为空;
+在人物与软件示例中,`person` 以 `name` 为主键生成 ID,`age` 与 `city` 允许为空;
 `software` 采用自定义数值 ID;边类型 `created` 连接人物与软件。模型定义与 [Loader 示例](/cn/docs/quickstart/toolchain/hugegraph-loader/) 保持一致。
 
 自主建模时,建议遵循 **属性 → 顶点类型 → 边类型 → 索引** 的顺序依次创建。
 删除类型或创建/重建索引操作通常会提交为后台异步任务,操作提交后可在【异步任务】中查看最终执行结果。
 
-## GQL 工作台:查询与探索人物关系
+## 在 GQL 工作台查询人物关系 {#gql-工作台查询与探索人物关系}
 
 进入【GQL 图遍历】,确认当前图为 `hugegraph`。工作台将查询编辑器与图展示区集成在一起,
-支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中执行人物属性查询:
+支持即时执行与异步执行、常用语句收藏,并可随时从执行历史中重载语句。先在 Gremlin 编辑器中查询人物属性。
 
 ```groovy
 g.V().hasLabel('person').valueMap()
 ```
 
-这条查询适合在表格或 JSON 视图核对属性。要观察人物与软件的关系,执行:
+这条查询适合在表格或 JSON 视图核对属性。也可以查询人物与软件的关系。
 
 ```groovy
 g.V().hasLabel('person').outE('created').inV().path()
@@ -3505,29 +3530,27 @@ Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前
 
 ### Text2GQL 自然语言查询 {#text2gql}
 
-> [!NOTE]
-> Text2GQL 后端能力(包括模型设置、内置/临时模型管理与 Prompt 模板)依赖包含
-> [apache/hugegraph-toolchain#824](https://github.com/apache/hugegraph-toolchain/pull/824) 的 Hubble 构建或后续发布版本;未合入该特性的旧版本仅提供预览占位,不包含模型设置页面。
-
 在【自然语言】输入框中用自然语言描述查询需求,Text2GQL 会结合当前图的 Schema 自动生成只读 Gremlin 或 Cypher 语句并执行查询。
 生成的语句支持二次编辑(执行前同样会进行只读安全校验)。切换至【异步】模式时,生成的查询与手写查询均可提交为后台异步任务。
 输入框会自动恢复当前图最近一次的查询输入(不会自动触发执行),执行记录中也会完整保留原始自然语言问题。
 
 ```gallery
-![Text2GQL 查询与图结果](/cn/docs/images/hubble/text2gql.jpg) # 查询工作台
+![未配置模型时的自然语言入口与手写 Gremlin 查询结果](/cn/docs/images/hubble/text2gql.jpg) # 查询工作台,模型尚未配置,结果来自手写查询
 ![内置模型设置](/cn/docs/images/hubble/text2gql-settings.jpg) # 模型设置
 ![Gremlin 与 Cypher Prompt 模板](/cn/docs/images/hubble/text2gql-prompt.jpg) # Text2GQL Prompt
 ```
 
+配图中的模型尚未配置,图结果来自手写 Gremlin;自然语言生成功能需要先连接可用模型。
+
 | 模型来源 | 配置与保存方式 |
 | --- | --- |
 | 使用内置模型 | 在【系统与运维 → 模型设置】统一配置,Key 加密存入 H2,不回传浏览器 |
 | 使用临时模型 | 在查询页填写 API 类别、Base URL、模型名称和临时 API Key;Key 只保留在前端内存中,刷新后清除 |
 
 使用 OpenAI、DeepSeek、GLM 等模型时选择【OpenAI 兼容接口】;使用本地运行的 Ollama 时选择【Ollama(本地)】(无认证时 Key 可留空)。
-注意:Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,`localhost` 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
+Base URL 必须能被 Hubble 后端服务正常访问(若 Hubble 运行在容器中,`localhost` 指向容器本身而非宿主机)。公网端点必须使用 HTTPS,HTTP 仅允许用于
 本地回环或私网模型;在【模型设置】中修改 Base URL 时,必须重新填写 Key 或清空已保存的 Key。
-全局内置模型仅由 `admin` 账号(PD 模式下为超级管理员)统一配置;未开启 Server 认证时,任何访问者均可配置。
+全局内置模型由具备模型设置管理权限的管理员统一配置;未开启 Server 认证时,任何访问者均可配置。
 
 在模型设置页面右上角打开 **Text2GQL Prompt**,可分别定制 Gremlin 与 Cypher 的生成规则及 Few-shot 示例。
 点击【应用】后需保存模型设置,模板将持久化存入 H2 数据库供内置模型与临时模型共享,生成时会自动附加当前图的 Schema。
@@ -3540,7 +3563,7 @@ Cypher 查询仅在 Server 后端支持时提供。快捷键会作用于当前
 
 页脚分别显示模型生成耗时与查询请求耗时;异步提交耗时仅代表任务入队耗时,不代表后台任务实际运行时间。
 
-## 内置图算法:用表单探索关系
+## 使用内置图算法 {#内置图算法用表单探索关系}
 
 不想从头编写遍历语句时,可以进入【内置图算法】,搜索算法并填写参数。
 邻居探索用于回答“这个点附近有什么”,路径算法用于寻找两个点的连接,相似度和排序算法用于比较或筛选顶点。
@@ -3556,9 +3579,9 @@ OLAP 批量算法需要 Computer 或 Vermeer 等外部计算环境。本例的
 参数校验通过后点击卡片右侧运行按钮,或在参数表单内使用快捷键,即可观察一跳邻居。
 
 ![内置邻居算法的参数与图结果](/cn/docs/images/hubble/algorithms.jpg)
-{width="2033" height="977"}
+{width="1600" height="1000"}
 
-## 异步任务:确认后台操作的最终结果
+## 查看异步任务的最终结果 {#异步任务确认后台操作的最终结果}
 
 【异步任务】集中显示当前图的后台任务,包括异步查询及部分 Schema、索引操作。
 可以按任务类型和状态筛选,查看任务 ID、创建时间与执行状态;成功查询可打开结果,失败任务可展开错误信息。
@@ -3567,13 +3590,13 @@ OLAP 批量算法需要 Computer 或 Vermeer 等外部计算环境。本例的
 例如把 `g.V().count()` 以异步方式提交后,先在列表确认成功,再查看返回的数量。
 “提交成功”只表示请求被接受,不表示计算或索引已完成。排查失败时,结合任务错误和 Server 日志定位原因。
 
-## 数据源管理:把原始数据准备好
+## 准备数据源 {#数据源管理把原始数据准备好}
 
 数据源负责“从哪里读、怎样解析”,可以被导入任务引用。Hubble 支持 FILE、HDFS、JDBC 和 Kafka;
-不同来源需要对应的路径、连接或订阅配置。FILE 最适合先体验:上传文件后,配置格式、分隔符、编码和表头,
+不同来源需要对应的路径、连接或订阅配置。首次体验可选择 FILE。上传文件后,配置格式、分隔符、编码和表头,
 检查读取的列名,再进入映射。上传限制和允许的扩展名由 Hubble 配置决定。
 
-为人物示例保存一个 UTF-8 文件 `people.csv`:
+为人物示例保存一个 UTF-8 文件 `people.csv`。
 
 ```csv
 name,age,city
@@ -3584,10 +3607,10 @@ docs_bob,32,Shanghai
 创建 FILE 数据源并上传它,选择 CSV(逗号分隔、默认 UTF-8),列名为 `name,age,city`。
 表头、分隔符和编码属于数据源配置,不在后面的映射步骤设置;源字段应与文件内容一致。
 
-## 数据导入:从字段映射到可查询的图
+## 映射字段并导入数据 {#数据导入从字段映射到可查询的图}
 
 【数据导入】把数据源中的行转换为顶点和边。任务创建采用四段配置,先明确目标,再选择字段和映射,最后决定执行时机。
-沿用上面的数据源,在 `DEFAULT` / `hugegraph` 中创建人物导入任务:
+沿用上面的数据源,在 `DEFAULT` / `hugegraph` 中创建人物导入任务。
 
 1. **基础信息** 选择目标图与刚创建的数据源,填写任务名。
 1. **源端字段** 选择 `name`、`age`、`city`,移到已选字段列表。
@@ -3600,7 +3623,7 @@ AUTOMATIC 由 Server 生成 ID,PRIMARY_KEY 根据映射的主键属性生成 I
 
 任务列表用于管理配置和执行入口,详情中的执行历史用于查看每次实例的状态、导入量与错误。
 Hubble 还提供周期调度和 Kafka 实时执行,调度方式需与数据源类型匹配。
-完成后返回 GQL 工作台验证:
+完成后返回 GQL 工作台查询新导入的数据。
 
 ```groovy
 g.V().hasLabel('person').has('name', within('docs_alice', 'docs_bob')).valueMap()
@@ -3626,7 +3649,7 @@ Hubble 使用 Server 的认证和账号,没有独立用户库。匿名访问
 
 连接支持默认角色接口的 Server 后,账号与空间访问可以分别管理。管理员管理全局账号,
 空间管理员只管理已授权空间的成员;普通成员不会获得账号管理或运维入口。
-以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力:
+以下四种预设属于 PD 模式,不表示旧版本或单机 Server 都提供同样的权限编辑能力。
 
 | 预设 | 范围与用途 |
 |---|---|
@@ -3641,10 +3664,10 @@ Hubble 使用 Server 的认证和账号,没有独立用户库。匿名访问
 旧 Server 未提供相应接口时,页面按能力隐藏或禁用操作,不应只凭按钮是否可见推断资源权限。
 更完整的空间管理见 [分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)。
 
-![认证模式下的账号列表(PD 模式示例)](/cn/docs/images/hubble/accounts.jpg)
-{width="2033" height="977"}
+![认证模式下的账号列表(单机模式示例)](/cn/docs/images/hubble/accounts.jpg)
+{width="1600" height="1000"}
 
-## 系统运维:检查单机 Server
+## 检查单机 Server {#系统运维检查单机-server}
 
 单机模式的【系统运维】提供【节点信息】,只显示 Server,不显示 PD / Store 节点或集群概览。
 节点列表可搜索、筛选健康状态并进入详情;详情用于查看可用的版本、系统、JVM、Server 后端等指标。
@@ -3682,7 +3705,7 @@ FILE 上传默认允许 `csv,txt`,单文件 1 GB、总量 10 GB;需要覆盖
 
 ## 停止试用环境或从源码构建
 
-不再需要示例时,在主仓库的 `docker/` 目录执行:
+清理测试环境时,在 `docker/` 目录下执行以下命令:
 
 ```bash
 docker compose -p "${HUBBLE_DEMO_PROJECT:?}" -f docker-compose.yml down --volumes
@@ -3691,19 +3714,21 @@ docker compose -p "${HUBBLE_DEMO_PROJECT:?}" -f docker-compose.yml down --volume
 这会删除该项目的容器、网络、命名卷与匿名卷,示例图和 Hubble 导入任务也会丢失。
 若想保留数据,下线时省略 `--volumes`,以后用同一项目名启动。
 
-需要与 master 精确一致的产物时,使用 JDK 17 和 Maven 从 Toolchain 构建。
-Maven 插件会安装所需的 Node/Yarn,无需预先安装;以下命令不执行测试:
+从当前 master 构建时,需要 **JDK 17、Maven 3.9+、Python 3.9+、稳定版 Node.js 24(至少 24.22.0)**,
+并通过 Corepack 使用仓库锁定的 **pnpm 12.14.0**。Maven 不再自动安装 Node/Yarn。
 
-```bash
-git clone --branch master --single-branch https://github.com/apache/hugegraph-toolchain.git
-cd hugegraph-toolchain
-mvn install -pl hugegraph-client,hugegraph-loader -am -Dmaven.javadoc.skip=true -DskipTests -ntp
-cd hugegraph-hubble
-mvn package -Dmaven.javadoc.skip=true -DskipTests -ntp
-cd apache-hugegraph-hubble-*
-# 编辑 conf/hugegraph-hubble.properties,设置正确的 Server URL
-bin/start-hubble.sh
-```
+1. 按 [Java 17 构建说明](https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md)
+   编译并安装 Server SDK 到独立 Maven 仓库。
+1. 按 [Hubble 源码构建步骤](https://github.com/apache/hugegraph-toolchain/blob/master/hugegraph-hubble/README.md)
+   安装 Python 依赖,再使用同一 Maven 仓库构建 Client、Loader 和 Hubble(跳过测试)。
+1. 进入构建生成的 `hugegraph-hubble/apache-hugegraph-hubble-*` 目录,配置 `conf/hugegraph-hubble.properties` 中的 Server 连接信息后启动:
+
+   ```bash
+   bin/start-hubble.sh -d
+   ```
+{.steps}
+
+当前 master 使用新的 H2 元数据库。升级时保留旧 Hubble 包及其数据,新版使用独立的数据目录;旧元数据不支持自动迁移,不能直接复用。
 
 打包配置默认绑定本机 `localhost:8088`。`bin/stop-hubble.sh` 会先请求正常停机,超时后才强制终止。
 需要开发与测试说明时,参考 [Toolchain 本地测试指南](/cn/docs/guides/toolchain-local-test/)。
@@ -3717,6 +3742,7 @@ bin/start-hubble.sh
 - [系统介绍](/cn/docs/introduction/)
 - [HugeGraph Examples](/cn/docs/language/hugegraph-example/)
 - [HugeGraph 工具链](/cn/docs/quickstart/toolchain/)
+- [使用 Tools 导出/管理图](/cn/docs/quickstart/toolchain/hugegraph-tools/)
 - [图可视化](/cn/docs/quickstart/toolchain/visualization/)
 - [Hubble 分布式补充](/cn/docs/quickstart/toolchain/visualization/hugegraph-hubble-hstore/)
 
@@ -3746,11 +3772,21 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 Docker `latest` 为动态标签,配图用于定位界面,实际版本以部署镜像的 digest 及构建信息为准。
 不同版本可提供的指标和权限接口有所区别。
 
+本文截图基于 HugeGraph Hubble 界面,中英文界面功能与操作一致。
+
 ## 连接分布式集群
 
 Hubble 仍通过 **Server 的图 API** 管理数据。区别在于,分布式模式通过 PD 发现 Server,
 同时从 PD 和 Store 获取集群信息;Hubble 不直接读写 Store 中的图数据。
 
+```mermaid
+flowchart LR
+    H[Hubble] -->|图 API| S[Server]
+    S -->|读写图数据| T[Store]
+    H -.->|服务发现与集群信息| P[PD]
+    H -.->|节点指标| T
+```
+
 1. **生成 Hubble 配置。** 按 Docker README 在主仓库的 `docker/` 目录准备 `.env`。
 
    ```bash
@@ -3774,7 +3810,7 @@ Hubble 仍通过 **Server 的图 API** 管理数据。区别在于,分布式
 
 若分别部署服务,参照 [PD 部署指南](/cn/docs/quickstart/hugegraph/hugegraph-pd/) 和
 [HStore 部署指南](/cn/docs/quickstart/hugegraph/hugegraph-hstore/);源码或二进制包启动的 Hubble 则编辑其
-`conf/hugegraph-hubble.properties`。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址:
+`conf/hugegraph-hubble.properties`。以下连接项与官方最小拓扑一致,其他部署请使用 Hubble 后端实际可达的地址。
 
 ```properties
 pd.enabled=true
@@ -3790,10 +3826,10 @@ pd.server=pd:8620
 | `pd.peers` | PD **gRPC** 地址;多个地址用逗号分隔。 | `127.0.0.1:8686` |
 | `pd.server` | 集群运维使用的 PD **REST** 地址,不是 gRPC peer 列表。 | `127.0.0.1:8620` |
 
-请注意区分两个端口:`8686` 为 gRPC 端口,`8620` 为 REST 端口,切勿混用;跨容器通信时请使用容器服务名或网络可达 IP,避免使用 `127.0.0.1`。
+请区分两个端口。`8686` 为 gRPC 端口,`8620` 为 REST 端口,切勿混用;跨容器通信时请使用容器服务名或网络可达 IP,避免使用 `127.0.0.1`。
 发行包默认配置中显式设为 `pd.enabled=false`;若未配置该项,代码默认值为 `true`,因此单机与分布式部署均建议显式声明该配置。
-修改配置后:源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 `docker/` 目录下重新创建 Hubble 容器以重新加载挂载配置
-(沿用启动时的项目名及所有 `-f` 参数):
+修改配置后,源码或二进制部署需重启 Hubble 服务;Docker Compose 部署则在 `docker/` 目录下重新创建 Hubble 容器以重新加载挂载配置
+(沿用启动时的项目名及所有 `-f` 参数)。
 
 ```bash
 docker compose -f docker-compose-hstore.yml up -d --force-recreate hubble
@@ -3824,7 +3860,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 列表只显示账号可访问的空间;看不到预期空间时,先检查成员权限,不要反复新建图。
 
 ![图空间创建表单与高级资源限制入口](/cn/docs/images/hubble/graphspace.jpg)
-{width="2048" height="984"}
+{width="1600" height="1000"}
 
 ### 复用 Schema 模板
 
@@ -3832,7 +3868,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 当一组业务图需要同样的顶点类型、边类型和索引时,可以先保存模板,再在创建图时选择它,减少重复建模。
 例如 `research` 中的用户模板用于该空间后续创建的图;切换到另一个空间后,应重新选择该空间的模板。
 
-用户模板与主篇的内置示例模板不同:内置模板用于快速体验预设模型,用户模板用于保存自己的模型并长期复用。
+主篇的内置示例模板用于快速体验预设模型。用户模板用于保存自己的模型并长期复用。
 模板本身不等于导入数据;是否加载示例数据是创建图时的另一个选择。
 开启 Server 认证时,创建用户模板需要所在空间的写权限,更新或删除还要求模板所有者或相应管理权限。
 匿名模式不进行按用户的权限与模板所有者检查。
@@ -3842,7 +3878,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 
 账号创建、登录和个人资料管理见[基础指南](/cn/docs/quickstart/toolchain/hugegraph-hubble/);
 分布式模式额外提供“管理 GraphSpace 成员”,在已有账号与指定空间之间分配权限。
-支持权限预设的 Server 提供以下常用选择:
+支持权限预设的 Server 提供以下常用选择。
 
 | 预设 | 适用对象 | 作用范围 |
 |---|---|---|
@@ -3857,7 +3893,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 认证配置见 [Server 认证与授权](/cn/docs/config/config-authentication/)。
 
 ![GraphSpace 成员与权限预设](/cn/docs/images/hubble/members.jpg)
-{width="2048" height="984"}
+{width="1600" height="1000"}
 
 ## 从集群概览定位异常
 
@@ -3865,7 +3901,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 概览中的 PD Leader、在线 Store 数、图数、分区数、副本数和数据量,帮助判断当前连接的规模及哪些节点需要关注。
 分区和副本描述数据分布;数据量是采集到的用量,不是图空间配置的存储上限。
 
-先看集群和来源状态,再进入异常节点:`UP` 表示本次采集的来源正常;`DEGRADED` 表示集群或部分来源异常;
+先看集群和来源状态,再进入异常节点。`UP` 表示本次采集的来源正常;`DEGRADED` 表示集群或部分来源异常;
 `DOWN` 表示相应探测未成功。拓扑可用而指标部分缺失时,仍可能正常查询图。
 页面会区分不支持、不可用、数据过期和采集失败,并显示采集时间;空值不是零,历史值也不等于当前状态。
 
@@ -3883,7 +3919,7 @@ GraphSpace(图空间)将图、Schema 模板和访问权限组织在同一个
 ![Store 节点的系统、磁盘、Raft 和分区指标](/cn/docs/images/hubble/store-node.jpg) # Store 详情,再检查节点指标
 ```
 
-PD Leader 与 Store 的 Leader 分区不是同一概念:前者协调集群元数据,后者负责相应数据分区的 Raft 组。
+PD Leader 与 Store 的 Leader 分区分别负责不同的工作。前者协调集群元数据,后者负责相应数据分区的 Raft 组。
 Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性检查;各版本可用的指标不同。
 
 开启 Server 认证时,集群运维读取要求超级管理员(`ADMIN` 级别),空间管理员和普通成员不会因此获得集群读取权限。
@@ -3893,7 +3929,7 @@ Hubble 展示上游提供的观测值,不代替完整的 Raft 副本一致性
 
 PD/Store 的运维凭据由 Hubble **后端**使用,与浏览器登录 Server 的账号分开。
 Compose 部署修改上文生成的宿主机 `docker/conf/hubble/hstore.local.properties`;其他部署修改 Hubble 包内配置文件。
-其中 PD 密码由脚本生成并与 `.env` 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置:
+其中 PD 密码由脚本生成并与 `.env` 中的密钥保持一致,Store 启用认证时再配置对应服务账号。不要把密码写进文档、截图或提交的配置。
 
 | 配置 | 随包默认值 | 设置方式 |
 |---|---|---|
@@ -3902,16 +3938,16 @@ Compose 部署修改上文生成的宿主机 `docker/conf/hubble/hstore.local.pr
 | `operations.store.allowed_targets` | `[http://127.0.0.1:8520,http://[::1]:8520]` | 列出信任的 Store 指标来源。 |
 {.td-table--wide}
 
-例如容器中的 Store 上报 `store:8520`,将白名单配置为:
+例如容器中的 Store 上报 `store:8520`,将白名单配置为以下内容。
 
 ```properties
 operations.store.allowed_targets=[http://store:8520]
 ```
 
 多节点集群中需列出所有允许访问的目标地址。每项必须是包含显式端口的 `http` 或 `https` 源地址(Origin),不可包含路径、凭据或通配符,
-且需与 PD 返回的 Store 指标目标完全一致。注意:仅在白名单中添加地址不会自动建立节点发现。
+且需与 PD 返回的 Store 指标目标完全一致。仅在白名单中添加地址不会自动建立节点发现。
 
-若集群拓扑可见但节点指标不完整,请依次排查:Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
+若集群拓扑可见但节点指标不完整,请依次检查 Hubble 后端到 PD REST 的网络连通性与认证凭据、PD 返回的 Store REST 与指标地址,
 以及目标地址是否已加入上述白名单。概览中的部分可用状态仅表示特定来源指标采集受阻,并不代表图 API 服务不可用。
 
 ---
@@ -3961,7 +3997,105 @@ LLMS 索引: [llms.txt](/cn/llms.txt)
 
 ---
 
-本文以 Toolchain `master`(当前版本为 `1.8.0`)为准。发布版和 Docker `latest` 可能与源码不同;使用时请核对版本,未发布的版本请按下文从源码构建。
+本文以 Toolchain `master` 分支(以 1.8 为基线,尚未正式发布)为准。发布版和 Docker `latest` 可能存在部分差异,使用未发布功能前请先核对版本。
+
+### 快速上手:本地文件导入 {#quick-local-file-import}
+
+下面通过一个最简示例体验 Loader 的基本导入流程:导入两个人和一条关系,并在 Hubble 中查询验证。
+请先[安装 Loader](#2-获取-hugegraph-loader) 并启动 [HugeGraph Server](/cn/docs/quickstart/hugegraph/hugegraph-server/)。
+以下命令均在 Loader 安装目录下执行,连接本地默认图 `hugegraph`。若 Server 已启用鉴权,在命令中追加 `--username` 与 `--password`(或 `--token`)。
+
+1. **创建数据文件**
+
+   两份 CSV 均不含表头,列名由下一步的映射文件指定。
+
+   ```bash
+   mkdir -p demo-loader
+   cat > demo-loader/people.csv <<'EOF'
+   docs-smoke-alice,29
+   docs-smoke-bob,31
+   EOF
+   cat > demo-loader/knows.csv <<'EOF'
+   docs-smoke-alice,docs-smoke-bob
+   EOF
+   ```
+
+1. **创建 Schema 和映射文件**
+
+   本例使用独立的 `docs_*` 名称,避免与内置的 `person` 数据冲突。
+   映射文件中的路径相对于运行 Loader 时的工作目录。
+
+   ```bash
+   cat > demo-loader/schema.groovy <<'EOF'
+   schema.propertyKey("docs_name").asText().ifNotExist().create()
+   schema.propertyKey("docs_age").asInt().ifNotExist().create()
+   schema.vertexLabel("docs_smoke_person").properties("docs_name", "docs_age")
+         .primaryKeys("docs_name").ifNotExist().create()
+   schema.edgeLabel("docs_smoke_knows").sourceLabel("docs_smoke_person")
+         .targetLabel("docs_smoke_person").ifNotExist().create()
+   EOF
+   cat > demo-loader/struct.json <<'EOF'
+   {
+     "version": "2.0",
+     "structs": [
+       {
+         "id": "people",
+         "input": {
+           "type": "FILE",
+           "path": "demo-loader/people.csv",
+           "format": "CSV",
+           "header": ["docs_name", "docs_age"]
+         },
+         "vertices": [{"label": "docs_smoke_person"}]
+       },
+       {
+         "id": "knows",
+         "input": {
+           "type": "FILE",
+           "path": "demo-loader/knows.csv",
+           "format": "CSV",
+           "header": ["source_name", "target_name"]
+         },
+         "edges": [{
+           "label": "docs_smoke_knows",
+           "source": ["source_name"],
+           "target": ["target_name"],
+           "field_mapping": {"source_name": "docs_name", "target_name": "docs_name"}
+         }]
+       }
+     ]
+   }
+   EOF
+   ```
+
+1. **执行导入**
+
+   保持在同一工作目录。Server 运行在其他地址时,修改主机和端口。
+
+   ```bash
+   bin/hugegraph-loader.sh \
+     --graphspace DEFAULT --graph hugegraph \
+     --file demo-loader/struct.json --schema demo-loader/schema.groovy \
+     --host 127.0.0.1 --port 8080
+   ```
+
+   首次成功导入后,统计应显示两个顶点、一条边。检查汇总中的成功数和失败数。
+
+1. **在 Hubble 中查询结果**
+
+   将 Hubble 连接到同一个 Server 和图,在 Gremlin 工作台分别执行以下查询。
+
+   ```groovy
+   g.V().hasLabel('docs_smoke_person').valueMap('docs_name', 'docs_age')
+   g.V().has('docs_smoke_person', 'docs_name', 'docs-smoke-alice')
+    .out('docs_smoke_knows').values('docs_name')
+   ```
+
+   第一条查询返回 Alice 的年龄 `29`、Bob 的年龄 `31`,第二条返回 `docs-smoke-bob`。
+{.steps}
+
+导入其他数据源时,继续阅读[映射文件参考](#33-编写数据源映射文件)。
+[内置完整示例](#4-完整示例)还包含软件顶点和边属性。
 
 ### 1 HugeGraph-Loader 概述
 
@@ -3977,15 +4111,11 @@ HugeGraph-Loader 是 HugeGraph 的数据导入组件,能够将多种数据源
 
 本地磁盘文件和 HDFS 文件支持断点续传。
 
-后面会具体说明。
-
 > **注意**:使用 HugeGraph-Loader 需要依赖 HugeGraph Server 服务,下载和启动 Server 请参考 [HugeGraph-Server 快速上手](/cn/docs/quickstart/hugegraph/hugegraph-server)
 > 
 > **测试指南**:如需在本地运行 Loader 测试,请参考 [工具链本地测试指南](/cn/docs/guides/toolchain-local-test)
 
-> **并发导入保护方案**:自 1.8.0 起,普通导入支持在同一 Server 实例上获取 owner 保护
-> (需配合返回 `protocol: 1` 的新版 Server 与对应 Loader;当前 `master` 分支暂未包含该协议)。
-> 旧版 Server 保持下文说明的原有导入行为。
+> **并发导入保护**:Toolchain master 分支的 Loader 已支持针对同一 Server 实例的 LOADING owner 保护。当配套 Server 的 `GET .../mode/owners` 返回 `protocol: 1` 时会自动生效;若 Server 无此接口,则保持原有导入行为。
 
 ### 2 获取 HugeGraph-Loader
 
@@ -4038,25 +4168,23 @@ services:
 
 #### 2.3 克隆源码编译安装
 
-克隆 `master` 分支:
+从 master 分支编译 Loader 需要 Java 17、Maven 3.6.3+ 与 Python 3.9+。直接克隆仓库并编译:
 
 ```bash
 git clone --branch master --single-branch https://github.com/apache/hugegraph-toolchain.git
-```
-
-编译生成 tar 包:
-
-```bash
 cd hugegraph-toolchain
-mvn clean package -pl hugegraph-loader -am -DskipTests -ntp
+mvn package -pl hugegraph-client,hugegraph-loader -am -DskipTests -ntp
+cd hugegraph-loader/apache-hugegraph-loader-*
 ```
 
+如需搭配开发阶段的 Server master SDK 编译,可参阅 [Java 17 迁移指引](https://github.com/apache/hugegraph-toolchain/blob/master/docs/java17-migration.md)。
+
 如需读取 Oracle 数据,按所用 Oracle/JDK 版本准备兼容的 JDBC 驱动 JAR,并放入解压后 Loader 的 `lib/` 目录。
 启动脚本会加载该目录中的 JAR;仅将驱动安装到 Maven 本地仓库并不会让运行中的 Loader 找到它。
 
 ### 3 使用流程
 
-使用 HugeGraph-Loader 的基本流程分为以下几步:
+导入数据前先准备图模型、数据文件和映射文件,再运行 Loader。
 
 - 编写图模型
 - 准备数据文件
@@ -4065,9 +4193,10 @@ mvn clean package -pl hugegraph-loader -am -DskipTests -ntp
 
 #### 3.1 编写图模型
 
-这一步是建模的过程,用户需要对自己已有的数据和想要创建的图模型有一个清晰的构想,然后编写 schema 建立图模型。
+先确定数据对应的顶点类型、边类型和属性,再编写 Schema。
 
-比如想创建一个拥有两类顶点及两类边的图,顶点是"人"和"软件",边是"人认识人"和"人创造软件",并且这些顶点和边都带有一些属性,比如顶点"人"有:"姓名"、"年龄"等属性, "软件"有:"名字"、"售卖价格"等属性;边"认识"有:"日期"属性等。
+以下示例包含 `person` 和 `software` 两类顶点,以及 `knows` 和 `created` 两类边。
+人有姓名、年龄和城市,软件有名称和价格,两类边都记录日期。
 
 <div style="text-align: center;">
   <img src="/docs/images/demo-graph-model.png" alt="由“认识”和“创建”边连接人物与软件顶点的示例图">
@@ -4075,7 +4204,7 @@ mvn clean package -pl hugegraph-loader -am -DskipTests -ntp
 </div>
 
 
... 13065 lines suppressed ...