DeepSeek Harness 插件

isingq-toolkit

Native DeepSeek Harness plugin for IsingQ guided QUBO modeling and solving(英文原文)

跳到安装方式

来源信息

GitHub 仓库
ising-tech/isingq-toolkit
最近更新
2026年8月21日
分类
工具与能力
GitHub stars
0
载体类型
plugin
包路径
packages/dsh-plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
packages/dsh-plugin/package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/ising-tech/isingq-toolkit/tree/HEAD/packages/dsh-plugin
插件名:isingq-toolkit
作者:ising-tech

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

@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 兼容范围内。