配置 QBoson 凭据

使用本插件前，需要准备 QBoson 用户 ID 和 SDK Code。

登录或注册玻色量子 Ising® 专用量子计算云平台。
进入 SDK 下载页面。
在页面中获取你的：
- QBOSON_USER_ID
- QBOSON_SDK_CODE

在 Windows 中，将 QBoson 凭据写入下面这个文件：

C:\Users\\.dsh\.credentials.yaml

如果 .dsh 目录或 .credentials.yaml 文件不存在，直接新建即可。也可以在 PowerShell 中执行：

New-Item -ItemType Directory -Force "$HOME\.dsh" | Out-Null
notepad "$HOME\.dsh\.credentials.yaml"

在文件中写入：

refs:
    QBOSON_USER_ID: "QBoson User ID"
    QBOSON_SDK_CODE: "QBoson SDK Code"

保存文件即可。插件会通过 DeepSeek Harness 的 credentials Service 读取这两个值，并在启动 Kaiwu worker 时用于 License 初始化。

使用

向 Agent 提供已经完成建模的 Ising Matrix，例如：

使用 solve_ising 求解下面的 Ising Matrix：

[
  [0,-1,0,-1,-1,0,0,-1,-1,0],
  [-1,0,-1,0,0,-1,-1,-1,0,0],
  [0,-1,0,-1,-1,0,0,0,-1,0],
  [-1,0,-1,0,0,-1,-1,0,-1,0],
  [-1,0,-1,0,0,-1,0,-1,0,-1],
  [0,-1,0,-1,-1,0,0,0,-1,-1],
  [0,-1,0,-1,0,0,0,0,0,-1],
  [-1,-1,0,0,-1,0,0,0,-1,0],
  [-1,0,-1,-1,0,-1,0,-1,0,-1],
  [0,0,0,0,-1,-1,-1,0,-1,0]
]

Tool 输入：

{
  "ising_matrix": [
    [0.0, -1.0, 0.5],
    [-1.0, 0.0, 0.2],
    [0.5, 0.2, 0.0]
  ]
}

输入验证包括：

Matrix 非空；
Matrix 为二维数组；
行列维度一致；
所有元素均为有限数值。

Kaiwu 求解调用：

optimizer = CIMOptimizer(
    task_name=task_name,
    wait=True,
    interval=interval,
    project_no=project_no,
    task_mode=TaskMode.OPTIMIZATION,
)

solutions = optimizer.solve(
    matrix,
    negtail_flip=False,
    sort_solutions=True,
)

hamiltonians = optimizer.get_hamiltonian()

Tool 输出：

{
  "dimension": 10,
  "solutions": [
    {
      "spins": [-1, 1, -1, 1, 1, -1, -1, -1, 1, 1],
      "hamiltonian": -30.0
    }
  ],
  "solver_time_us": 5707040.0,
  "task_name": "ising_dsh_0123456789ab"
}

结果按 Hamiltonian 从低到高排列。每个 spin solution 的长度与 Matrix dimension 一致，spin 值属于 {-1,+1}。

求解配置

以下配置可通过启动 Harness 的进程环境设置：

KAIWU_PROJECT_NO
KAIWU_CHECKPOINT_DIR        默认 ~/.qboson-ising-dsh/checkpoints
KAIWU_TASK_NAME_PREFIX      默认 ising_dsh
KAIWU_CIM_INTERVAL_MINUTES  默认 1
ISING_DSH_TIMEOUT_MS        默认 3600000
ISING_DSH_GRACE_MS          默认 5000
ISING_DSH_LOG_PATH          默认 ~/.qboson-ising-dsh/logs/worker.log
ISING_DSH_LOG_LEVEL         默认 INFO

运行时管理配置：

QBOSON_ISING_RUNTIME_DIR    插件私有运行时目录
QBOSON_ISING_PYTHON         指定兼容的 Python 3.10 解释器
QBOSON_KAIWU_SPEC           Kaiwu 安装规格，默认 kaiwu

QBOSON_ISING_PYTHON 指向的解释器需要为 Python 3.10，并能够导入 kaiwu。

dsh-qboson-ising-solver

安裝

說明文件

配置 QBoson 凭据

使用

求解配置