ising-tech/isingq-toolkit

README 摘要

IsingQ Toolkit 让 Agent 帮助你完成 QUBO 建模、校验并调用 IsingQ 求解 简体中文 · English · 快速开始 · 获取 API Key IsingQ Toolkit 是北京伊辛智能科技有限公司公开维护的本地 Agent 工具。 你可以直接描述排程、路径规划、投资组合或图优化问题，由 Agent 协助构建 QUBO，并使用你自己的 IsingQ API Key 发起求解。 - 建模引导、QUBO 校验和结果记录在用户电脑上完成。 - 只有调用求解工具时，矩阵才会通过 HTTPS 提交给 IsingQ。 - API Key 保存在本机私有文件中，不进入 Agent 对话或 MCP 配置。 - 支持标准 MCP、Codex Plugin 和 DeepSeek Harness 原生 Plugin。 快速开始 不熟悉终端或 MCP 配置时，把下面这段话发送给当前 Agent： 安装 Skill 会根据当前 Agent 和操作系统选择一种接入方式，不会自动修改电脑上的其他 Agent。Host 不支持自动注册时，Skill 会输出可手工导入的 stdio JSON。 完成接入后应能在标准 MCP Host 中看到 7 个 isingq 工具。DSH 原生 Plugin 提供 9 个工具。 安装演示 第一次求解 知识查询、建模引导和 QUBO 校验不需要 API Key。只有提交真实求解任务时才需要个人 IsingQ API Key。 1. 登录或注册玉盘·伊辛云。 2. 进入 设置 → API → 创建API ，创建便于识别的个人 API Key。 3. 让 Agent 调用 isingq api key setup ，在系统安全输入框中填写 Key。 4. 直接向 Agent 描述需要建模的问题。 不要把 API Key 发到 Agent 对话、命令参数、MCP JSON、Issue 或日志中。如果 Key 意外泄露，请在云平台删除对应记录并重新创建。 可以从这个示例开始： Agent 应先展示变量映射、目标函数、约束、Penalty、矩阵摘要和 SHA-256。你确认后，Agent 才应调用 isingq solve start 。 该工具被 Host 放行后会立即创建远端任务。MCP 不再弹出额外的操作系统求解确认框；Host 是否再次确认取决于它自身的工具权限设置。 还能做什么 除了求解，Toolkit 还包含本地公开知识和 QUBO 建模指导。例如： 云平台 API 当前支持最高 2048 个 QUBO 二进制变量。具体任务是否适合当前规模，仍取决于建模方式和约束展开结果。 支持范围 接入方式 适用范围 是否需要 Node.js 标准 MCP WorkBuddy、Claude Code、Cursor、VS Code 等 …

分类