Merge branch 'master' into graphspace

Author: imbajin

.github/workflows/validate-release.yml

@@ -10,7 +10,7 @@ on:
       gpg_user:
         required: true
         description: current release manager (gpg username)
-        default: 'Junzhi Peng'
+        default: 'pengjunzhi'
 
   push:
     branches:
@@ -244,7 +244,7 @@ jobs:
       - name: 7. Validate Binary Packages
         run: |
           cd dist/${{ inputs.release_version }} || exit
-          CATEGORY_X="\bGPL|\bLGPL|Sleepycat License|BSD-4-Clause|\bBCL\b|JSR-275|Amazon Software License|\bRSAL\b|\bQPL\b|\bSSPL|\bCPOL|\bNPL1|Creative Commons Non-Commercial|JSON"
+          CATEGORY_X="\bGPL|\bLGPL|Sleepycat License|BSD-4-Clause|\bBCL\b|JSR-275|Amazon Software License|\bRSAL\b|\bQPL\b|\bSSPL|\bCPOL|\bNPL1|Creative Commons Non-Commercial|JSON\.org"
           for i in *.tar.gz; do
             if [[ "$i" == *-src.tar.gz ]]; then
               # skip source packages

content/cn/docs/changelog/hugegraph-1.7.0-release-notes.md

@@ -3,3 +3,9 @@ title: "HugeGraph Computing (OLAP)"
 linkTitle: "HugeGraph Computing (OLAP)"
 weight: 4
 ---
+
+## 🚀 最佳实践：优先使用 DeepWiki 智能文档
+
+> 为解决静态文档可能过时的问题，我们提供了 **实时更新、内容更全面** 的 DeepWiki。它相当于一个拥有项目最新知识的专家，非常适合**所有开发者**在开始项目前阅读和咨询。
+
+**👉 强烈推荐访问并对话：**[**incubator-hugegraph-computer**](https://deepwiki.com/apache/incubator-hugegraph-computer)

content/cn/docs/quickstart/computing/_index.md

@@ -16,6 +16,126 @@ master 是负责通信、转发、汇总的节点，计算量和占用资源量
 
 ### 1.2 运行方法
 
+1. **方案一：Docker Compose（推荐）**
+
+确保docker-compose.yaml存在于您的项目根目录中。如果没有，以下是一个示例：
+
+```yaml
+services:
+  vermeer-master:
+    image: hugegraph/vermeer
+    container_name: vermeer-master
+    volumes:
+      - ~/.config:/go/bin/config # Change here to your actual config path
+    command: --env=master
+    networks:
+      vermeer_network:
+        ipv4_address: 172.20.0.10 # Assign a static IP for the master
+
+  vermeer-worker:
+    image: hugegraph/vermeer
+    container_name: vermeer-worker
+    volumes:
+      - ~/:/go/bin/config # Change here to your actual config path
+    command: --env=worker
+    networks:
+      vermeer_network:
+        ipv4_address: 172.20.0.11 # Assign a static IP for the worker
+
+networks:
+  vermeer_network:
+    driver: bridge
+    ipam:
+      config:
+        - subnet: 172.20.0.0/24 # Define the subnet for your network
+```
+
+修改 docker-compose.yaml
+- **Volume**：例如将两处 ~/:/go/bin/config 改为 /home/user/config:/go/bin/config（或您自己的配置目录）。
+- **Subnet**：根据实际情况修改子网IP。请注意，每个容器需要访问的端口在config文件中指定，具体请参照项目`config`文件夹下内容。
+
+在项目目录构建镜像并启动（或者先用 docker build 再 docker-compose up）
+
+```shell
+# 构建镜像（在项目根 vermeer 目录）
+docker build -t hugegraph/vermeer .
+
+# 启动（在 vermeer 根目录）
+docker-compose up -d
+# 或使用新版 CLI：
+# docker compose up -d
+```
+
+查看日志 / 停止 / 删除：
+
+```shell
+docker-compose logs -f
+docker-compose down
+```
+
+2. **方案二：通过 docker run 单独启动（手动创建网络并分配静态 IP）**
+
+确保CONFIG_DIR对Docker进程具有适当的读取/执行权限。
+
+构建镜像：
+
+```shell
+docker build -t hugegraph/vermeer .
+```
+
+创建自定义 bridge 网络（一次性操作）：
+
+```shell
+docker network create --driver bridge \
+  --subnet 172.20.0.0/24 \
+  vermeer_network
+```
+
+运行 master（调整 CONFIG_DIR 为您的绝对配置路径，可以根据实际情况调整IP）：
+
+```shell
+CONFIG_DIR=/home/user/config
+
+docker run -d \
+  --name vermeer-master \
+  --network vermeer_network --ip 172.20.0.10 \
+  -v ${CONFIG_DIR}:/go/bin/config \
+  hugegraph/vermeer \
+  --env=master
+```
+
+运行 worker：
+
+```shell
+docker run -d \
+  --name vermeer-worker \
+  --network vermeer_network --ip 172.20.0.11 \
+  -v ${CONFIG_DIR}:/go/bin/config \
+  hugegraph/vermeer \
+  --env=worker
+```
+
+查看日志 / 停止 / 删除：
+
+```shell
+docker logs -f vermeer-master
+docker logs -f vermeer-worker
+
+docker stop vermeer-master vermeer-worker
+docker rm vermeer-master vermeer-worker
+
+# 删除自定义网络（如果需要）
+docker network rm vermeer_network
+```
+
+3. **方案三：从源码构建**
+
+构建。具体请参照 [Vermeer Readme](https://github.com/apache/incubator-hugegraph-computer/tree/master/vermeer)。
+
+```shell
+go build
+```
+
 在进入文件夹目录后输入 `./vermeer --env=master` 或 `./vermeer --env=worker01`
 
 ## 二、任务创建类 rest api
@@ -33,24 +153,81 @@ master 是负责通信、转发、汇总的节点，计算量和占用资源量
 
 具体参数参考 Vermeer 参数列表文档。
 
-request 示例：
+vermeer提供三种加载方式：
+
+1. 从本地加载
+
+可以预先获取数据集，例如 twitter-2010 数据集。获取方式：https://snap.stanford.edu/data/twitter-2010.html，第一个 twitter-2010.txt.gz 即可。
+
+**request 示例：**
 
 ```javascript
 POST http://localhost:8688/tasks/create
 {
  "task_type": "load",
  "graph": "testdb",
  "params": {
- "load.parallel": "50",
- "load.type": "local",
- "load.vertex_files": "{\"localhost\":\"data/twitter-2010.v_[0,99]\"}",
- "load.edge_files": "{\"localhost\":\"data/twitter-2010.e_[0,99]\"}",
- "load.use_out_degree": "1",
- "load.use_outedge": "1"
+  "load.parallel": "50",
+  "load.type": "local",
+  "load.vertex_files": "{\"localhost\":\"data/twitter-2010.v_[0,99]\"}",
+  "load.edge_files": "{\"localhost\":\"data/twitter-2010.e_[0,99]\"}",
+  "load.use_out_degree": "1",
+  "load.use_outedge": "1"
  }
 }
 ```
 
+2. 从hugegraph加载
+
+**request 示例：**
+
+⚠️ 安全警告：切勿在配置文件或代码中存储真实密码。请改用环境变量或安全的凭据管理系统。
+
+```javascript
+POST http://localhost:8688/tasks/create
+{
+  "task_type": "load",
+  "graph": "testdb",
+  "params": {
+    "load.parallel": "50",
+    "load.type": "hugegraph",
+    "load.hg_pd_peers": "[\"<your-hugegraph-ip>:8686\"]",
+    "load.hugegraph_name": "DEFAULT/hugegraph2/g",
+    "load.hugegraph_username": "admin",
+    "load.hugegraph_password": "<your-password-here>",
+    "load.use_out_degree": "1",
+    "load.use_outedge": "1"
+  }
+}
+```
+
+3. 从hdfs加载
+
+**request 示例：**
+
+```javascript
+POST http://localhost:8688/tasks/create
+{
+  "task_type": "load",
+  "graph": "testdb",
+  "params": {
+    "load.parallel": "50",
+    "load.type": "hdfs",
+    "load.hdfs_namenode": "name_node1:9000",
+    "load.hdfs_conf_path": "/path/to/conf",
+    "load.krb_realm": "EXAMPLE.COM",
+    "load.krb_name": "user@EXAMPLE.COM",
+    "load.krb_keytab_path": "/path/to/keytab",
+    "load.krb_conf_path": "/path/to/krb5.conf",
+    "load.hdfs_use_krb": "1",
+    "load.vertex_files": "/data/graph/vertices",
+    "load.edge_files": "/data/graph/edges",
+    "load.use_out_degree": "1",
+    "load.use_outedge": "1"
+  }
+}
+```
+
 ### 2.3 输出计算结果
 
 所有的 vermeer 计算任务均支持多种结果输出方式，可自定义输出方式：local、hdfs、afs 或 hugegraph，在发送请求时的 params 参数下加入对应参数，即可生效。指定 output.need_statistics 为 1 时，支持计算结果统计信息输出，结果会写在接口任务信息内。统计模式算子目前支持 "count" 和 "modularity" 。但仅针对社区发现算法适用。
@@ -66,13 +243,13 @@ POST http://localhost:8688/tasks/create
  "graph": "testdb",
  "params": {
  "compute.algorithm": "pagerank",
- "compute.parallel":"10",
- "compute.max_step":"10",
- "output.type":"local",
- "output.parallel":"1",
- "output.file_path":"result/pagerank"
- 	}
- }
+ "compute.parallel": "10",
+ "compute.max_step": "10",
+ "output.type": "local",
+ "output.parallel": "1",
+ "output.file_path": "result/pagerank"
+  }
+}
 ```
 
 ## 三、支持的算法

content/cn/docs/quickstart/computing/hugegraph-vermeer.md

@@ -7,6 +7,12 @@ weight: 3
 [![License](https://img.shields.io/badge/license-Apache%202-0E78BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/apache/incubator-hugegraph-ai)
 
+## 🚀 最佳实践：优先使用 DeepWiki 智能文档
+
+> 为解决静态文档可能过时的问题，我们提供了 **实时更新、内容更全面** 的 DeepWiki。它相当于一个拥有项目最新知识的专家，非常适合**所有开发者**在开始项目前阅读和咨询。
+
+**👉 强烈推荐访问并对话：**[**incubator-hugegraph-ai**](https://deepwiki.com/apache/incubator-hugegraph-ai)
+
 `hugegraph-ai` 整合了 [HugeGraph](https://github.com/apache/hugegraph) 与人工智能功能，为开发者构建 AI 驱动的图应用提供全面支持。
 
 ## ✨ 核心功能

content/cn/docs/quickstart/hugegraph-ai/_index.md

@@ -3,3 +3,9 @@ title: "HugeGraph (OLTP)"
 linkTitle: "HugeGraph (OLTP)"
 weight: 1
 ---
+
+## 🚀 最佳实践：优先使用 DeepWiki 智能文档
+
+> 为解决静态文档可能过时的问题，我们提供了 **实时更新、内容更全面** 的 DeepWiki。它相当于一个拥有项目最新知识的专家，非常适合**所有开发者**在开始项目前阅读和咨询。
+
+**👉 强烈推荐访问并对话：**[**incubator-hugegraph**](https://deepwiki.com/apache/incubator-hugegraph)

content/cn/docs/quickstart/hugegraph/_index.md

@@ -5,3 +5,9 @@ weight: 2
 ---
 
 > **测试指南**：如需在本地运行工具链测试，请参考 [HugeGraph 工具链本地测试指南](/cn/docs/guides/toolchain-local-test)
+
+## 🚀 最佳实践：优先使用 DeepWiki 智能文档
+
+> 为解决静态文档可能过时的问题，我们提供了 **实时更新、内容更全面** 的 DeepWiki。它相当于一个拥有项目最新知识的专家，非常适合**所有开发者**在开始项目前阅读和咨询。
+
+**👉 强烈推荐访问并对话：**[**incubator-hugegraph-toolchain**](https://deepwiki.com/apache/incubator-hugegraph-toolchain)