IsingQ Toolkit

English | 简体中文

IsingQ Toolkit — это локальный инструмент для агентов, публично поддерживаемый компанией Beijing Ising Intelligent Technology Co., Ltd. Он помогает агенту выражать задачи планирования, маршрутизации, формирования портфеля, оптимизации графов и другие задачи в виде QUBO, а после подтверждения пользователем отправляет их на решение в облако 玉盘·伊辛云 с использованием личного IsingQ API Key пользователя.

• Моделирование-подсказки, генерация QUBO, проверка и запись результатов выполняются на компьютере пользователя.

• Только подтверждённая пользователем матрица отправляется в IsingQ по HTTPS.

• Поддерживаются WorkBuddy, Codex, Claude Code, Cursor, VS Code, Trae и DeepSeek Harness.

• Стандартный MCP предоставляет 7 инструментов и 13 локальных Resources; нативный Plugin для DSH предоставляет 9 инструментов.

• API облачной платформы в настоящее время поддерживает до 2048 бинарных переменных QUBO.

Перед началом: получение IsingQ API Key

Для реального решения задач необходимо использовать личный IsingQ API Key. Запросы к базе знаний, моделирование-подсказки и проверка QUBO не требуют API Key.

1. Откройте 玉盘·伊辛云 и зарегистрируйтесь или войдите в личный аккаунт.

2. На платформе перейдите в Настройки → API.

3. Нажмите Создать API, укажите понятное имя API и завершите создание.

4. При установке сохраните API Key через защищённое системное поле ввода.

Путь создания на платформе также описан в разделе «Настройки» Политики конфиденциальности сайта 玉盘·伊辛云.

Не отправляйте API Key в диалог с агентом, параметры команд, MCP JSON, Issue или журналы. Если Key случайно утёк, вернитесь в Настройки → API облачной платформы, удалите соответствующую запись и создайте новую.

Рекомендуемая установка: пусть агент прочитает Skill

Отправьте следующий текст текущему агенту:

请从 https://github.com/ising-tech/isingq-toolkit 读取 skills/install-isingq-mcp/SKILL.zh-CN.md，严格遵循该 Skill，帮我安装 IsingQ MCP，并且只接入当前 Agent。不要在对话中索要或显示我的 API Key；需要 Key 时使用系统安全输入框。安装完成后，等我重启 Agent，再验证是否加载出 7 个 MCP 工具。

Установка Skill выбирает текущую операционную систему и текущего агента и не настраивает все агенты только потому, что на компьютере установлены другие. Для Trae необходимо импортировать stdio JSON, выведенный Skill, на страницу настроек MCP.

Установка считается успешной, если выполнено:

• Программа установлена и прошла проверку хеша.

• На компьютере уже есть действующий API Key.

• Текущий агент зарегистрировал MCP.

• После перезапуска стандартный MCP загружает 7 инструментов, или нативный Plugin DSH загружает 9 инструментов.

Установка из исходного кода GitHub

Текущий публичный репозиторий можно тестировать напрямую. Требуется Node.js 18 или новее:

git clone https://github.com/ising-tech/isingq-toolkit.git
cd isingq-toolkit
npm ci
npm install -g .
isingq-mcp setup
isingq-mcp self-check --json

isingq-mcp setup принимает API Key без эха на экране. Затем настраивается только реально используемый агент:

isingq-mcp configure-host --name workbuddy

--name поддерживает workbuddy, codex, claude-code, cursor, vscode и generic. Для Trae или других Host можно получить стандартную конфигурацию и импортировать её вручную:

isingq-mcp config --json

Универсальная stdio-конфигурация выглядит так:

{
  "mcpServers": {
    "isingq": {
      "command": "isingq-mcp",
      "args": ["serve"]
    }
  }
}

После настройки полностью закройте и перезапустите агента.

npm, Release и DSH

Если установлен Node.js 18 или новее, установка и настройка выполняются напрямую через npm/npx:

npx @ising-tech/isingq-mcp setup
npx @ising-tech/isingq-mcp configure-host --name generic --npx

Замените generic на реально используемый workbuddy, codex, claude-code, cursor или vscode; для Trae оставьте generic и импортируйте выведенный stdio JSON.

Пользователи, не желающие устанавливать Node.js, могут скачать фиксированную версию программы для своей системы из GitHub Releases и проверить её с помощью SHA256SUMS. Поддерживаются macOS arm64/x64, Linux arm64/x64 и Windows x64.

DeepSeek Harness использует нативный Plugin и не требует MCP Bridge:

dsh plugin --profile <profile> add @ising-tech/isingq-dsh-plugin

Не включайте одновременно нативный Plugin IsingQ и старый MCP Bridge в одном DSH Profile.

Как использовать

После установки и перезапуска просто опишите задачу агенту — запоминать имена инструментов не нужно:

请把下面的排程问题建成 QUBO。先解释变量、目标函数、约束和 Penalty，等我确认后再调用 IsingQ 求解：

任务 A、B 只能选择一个；选择 A 的收益为 8，选择 B 的收益为 5。

Агент должен сначала выполнить моделирование и проверку, показать отображение переменных, целевую функцию, ограничения, Penalty, сводку матрицы и SHA-256. Только после вашего явного подтверждения и подтверждения через системное окно будет отправлен запрос на решение.

Также можно запрашивать локальную публичную базу знаний:

玉盘·伊辛云目前提供什么能力？请给出知识版本、来源和表述边界。

Возможности инструментов

Результат решения сохраняется в двух формах:

• energy провайдера IsingQ: E(s) = -1/2 · Σ_i Σ_j J_ij s_i s_j - Σ_i h_i s_i.

• objective, пересчитанный MCP по QUBO: f(x) = offset + Σ_i Q_ii x_i + Σ_{i<j} Q_ij x_i x_j.

Они могут не совпадать из-за преобразования переменных, постоянных членов или различий в масштабе коэффициентов. Минимальная energy также не означает автоматически бизнес-целесообразность, глобальную оптимальность или производительность конкретного оборудования.

Данные и безопасность

• API Key хранится только в приватном локальном файле и не попадает в параметры инструментов или диалог.

• Моделирование-подсказки, проверка QUBO и запросы публичной базы знаний выполняются локально.

• Только isingq_solve_start отправляет матрицу решения после подтверждения пользователя.

• API-запросы используют HTTPS; загрузка матрицы использует краткосрочную подпись и не содержит личный API Key.

• Локальные записи сохраняют модель, ID задачи и результат, но не сохраняют API Key.

Дополнительные границы описаны в Security Policy.

Обновление и несколько агентов

• Для обновления повторно выполните установочный Skill или переустановите npm/Release.

• Существующий API Key и локальные записи решений сохраняются.

• На каждом компьютере достаточно установить одну копию программы; разные агенты просто регистрируют одну и ту же локальную программу.

• После обновления конфигурации необходимо полностью перезапустить соответствующего агента.

Если возникли проблемы

• Нет API Key: перейдите в Настройки → API → Создать API на 玉盘·伊辛云.

• У агента не появились инструменты: после настройки полностью перезапустите агента и подтвердите его запрос доверия к MCP.

• Песочница агента запрещает запись: разрешите только явные каталоги установки и каталог конфигурации пользователя; не помещайте API Key в каталог проекта.

• Trae не подключается автоматически: выполните isingq-mcp config --json и импортируйте через страницу настроек MCP в Trae.

• Виден только NDJSON-ответ: это лишь означает, что процесс доступен; интеграция завершена только когда в агенте видны 7 нативных инструментов.

Документация для разработчиков

Архитектура, границы пакетов, контракт данных QUBO, процесс сборки и Release описаны в docs/DEVELOPMENT.md.

Этот проект использует Apache License 2.0. Эта лицензия не предоставляет прав на товарные знаки, связанные с IsingQ или Ising Intelligent.