DeepSeek Harness plugin

isingq-toolkit

Native DeepSeek Harness plugin for IsingQ guided QUBO modeling and solving

Jump to install

Source facts

Repository
ising-tech/isingq-toolkit
Latest update
Aug 21, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Package path
packages/dsh-plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
packages/dsh-plugin/package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/ising-tech/isingq-toolkit/tree/HEAD/packages/dsh-plugin
Plugin: isingq-toolkit
Author: ising-tech

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@ising-tech/isingq-dsh-plugin

Native IsingQ integration for DeepSeek Harness. The Plugin registers nine typed tools in the DSH process and reuses @ising-tech/isingq-core for QUBO guidance, validation, public knowledge, HTTPS solving, and local result records.

[中文说明](#中文说明)

Install

Install the Plugin into the DSH Profile you actually use:

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

Replace <profile> with the real Profile name, restart that Profile, and confirm that nine isingq_* tools are available. Do not enable this native Plugin and an IsingQ MCP bridge in the same Profile.

Configure an API Key

1. Sign in or register at IsingQ Cloud. 2. Open Settings → API → Create API and create a personal API Key. 3. Ask the Agent to call isingq_api_key_setup, then enter the Key in the operating system's private prompt.

The API Key is stored in a private local file and used only for HTTPS authentication with the IsingQ API. It does not enter Agent chat, tool arguments, DSH Profile configuration, issues, or logs.

Solve safely

Before isingq_solve_start, the Agent must show the variable mapping, objective, constraints, penalties, matrix summary, and SHA-256, then obtain your explicit confirmation.

Once the DSH Host permits isingq_solve_start, the Plugin creates the remote task immediately. It does not open a second operating-system solve prompt; any additional confirmation is controlled by the Host's tool-permission policy.

Tools

ToolPurposeNetwork
isingq_api_key_setupConfigure or replace the local API Key through a private OS promptNo
isingq_knowledge_getRead versioned public IsingQ knowledgeNo
isingq_modeling_guide_getGet QUBO modeling and constraint guidanceNo
isingq_qubo_validateValidate a QUBO and produce a matrix summaryNo
isingq_solve_startSubmit a confirmed QUBO solve taskYes
isingq_solve_pollQuery task status once and save the resultYes
isingq_solve_result_getRead a locally stored solve resultNo
isingq_resource_listList local public knowledge resourcesNo
isingq_resource_readRead one local public knowledge resourceNo

Data boundary

Modeling guidance, QUBO validation, public knowledge, and result records stay on the user's computer. A QUBO matrix is sent to IsingQ only after the confirmed solve tool is called.

API requests use HTTPS. Matrix upload uses a short-lived signature and does not carry the personal API Key. The Key remains outside Agent-visible inputs and outputs.

Compatibility

  • Node.js 18 or later.
  • Minimum supported DeepSeek Harness baseline: 0.1.0-rc.7.
  • @deepseek-ai/dsh-tools peer range: >=0.1.0-rc.7 <0.2.0-0.
  • Current development validation version: 0.1.0-rc.8.

The peer range permits later compatible 0.1 releases, but versions newer than the current validation baseline are not automatically claimed as runtime-verified.

Troubleshooting

  • Tools are missing: verify the target Profile, remove any duplicate IsingQ MCP bridge, then restart that Profile.
  • API Key is missing: call isingq_api_key_setup; never paste the Key into Agent chat.
  • Installation reports a peer conflict: confirm that DSH is within the documented 0.1 compatibility range.

---

中文说明

这是面向 DeepSeek Harness 的 IsingQ 原生 Plugin。它在 DSH 进程内注册 9 个 typed tools,并复用 @ising-tech/isingq-core 提供 QUBO 建模引导、校验、公开知识、HTTPS 求解和本地结果记录。

安装

安装到实际使用的 DSH Profile:

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

<profile> 替换为真实 Profile 名,重启该 Profile 后确认出现 9 个 isingq_* 工具。不要在同一个 Profile 中同时启用该原生 Plugin 和 IsingQ MCP Bridge。

配置 API Key

1. 登录或注册玉盘·伊辛云。 2. 进入 设置 → API → 创建API,创建个人 API Key。 3. 让 Agent 调用 isingq_api_key_setup,在操作系统私密输入框中填写 Key。

API Key 保存在本机私有文件中,只用于 IsingQ API 的 HTTPS 鉴权。它不会进入 Agent 对话、工具参数、DSH Profile 配置、Issue 或日志。

安全求解

调用 isingq_solve_start 前,Agent 必须展示变量映射、目标函数、约束、Penalty、矩阵摘要和 SHA-256,并取得你的明确确认。

DSH Host 放行 isingq_solve_start 后,Plugin 会立即创建远端任务,不再弹出第二个操作系统求解确认框。是否增加确认由 Host 的工具权限策略决定。

工具

工具作用是否联网
isingq_api_key_setup通过操作系统私密输入框配置或更换 API Key
isingq_knowledge_get查询版本化的 IsingQ 公开知识
isingq_modeling_guide_get获取 QUBO 建模与约束引导
isingq_qubo_validate校验 QUBO 并生成矩阵摘要
isingq_solve_start提交已经确认的 QUBO 求解任务
isingq_solve_poll查询一次任务状态并保存结果
isingq_solve_result_get读取本机保存的求解结果
isingq_resource_list列出本机公开知识资源
isingq_resource_read读取一项本机公开知识资源

数据边界

建模引导、QUBO 校验、公开知识和结果记录在用户电脑上完成。只有用户确认并调用求解工具后,QUBO 矩阵才会提交到 IsingQ。

API 请求使用 HTTPS。矩阵上传使用短期签名,不携带个人 API Key;Key 不会进入 Agent 可见的输入或输出。

兼容性

  • Node.js 18 或更高版本。
  • DeepSeek Harness 最低兼容基线:0.1.0-rc.7
  • @deepseek-ai/dsh-tools peer range:>=0.1.0-rc.7 <0.2.0-0
  • 当前开发验证版本:0.1.0-rc.8

该范围允许后续兼容的 0.1 版本安装,但不会把高于当前验证基线的版本自动描述为已经完成运行验证。

故障排查

  • 没有出现工具:确认目标 Profile,移除重复的 IsingQ MCP Bridge,再重启该 Profile。
  • 缺少 API Key:调用 isingq_api_key_setup,不要把 Key 粘贴到 Agent 对话。
  • 安装出现 peer 冲突:确认 DSH 位于文档声明的 0.1 兼容范围内。