curtainsmall/dsh-electro-lab

curtainsmall/dsh-electro-lab

DSH 电气电子计算插件:所有计算都通过专用工具完成,基于 SI 基本单位的自描述复数值对象;附带隔离的计算智能体预设与记录面板,每次求解落盘存档。

工具与能力

DeepSeek Harness ElectroLab

面向 DeepSeek Harness 的电气与电子计算插件。

English

目录

安装

dsh plugin --profile web add dsh-electro-lab

ElectroLab 模式

插件以智能体预设的形式工作:启动会话时选择 ElectroLab 模式,用自然语言提出任何电气或电子问题即可。该会话被隔离在插件工具内,没有 shell、文件系统与网络,因此答案中的每个数字都来自引擎;条件不足时,智能体会停下来询问。

全部计算都在一台确定性的引擎内完成。智能体把类型化值写入槽、调用 38 个内置求解器之一,再把结果读回;引擎在计算边界换算单位,并把每一步记录成一条可回读的记录。

原语作用
set把一个类型化值写入槽
get读回一个槽
call运行一个已注册求解器并存下结果
solver_info在调用前返回求解器的签名
record_question / record_analyse / record_answer把一次求解括成一条记录

目录覆盖表达式代数、数列求和、传递函数、数字信号处理与 DFT、信号质量、电路、电子学、射频与史密斯圆图、传输线、噪声与滤波器设计。

记录

已结算的记录列在客户端面板的 「记录」页,每 5 秒刷新;从未封口的记录会标记为未完成。点开一条记录即进入时间线:每次写入、读取、调用与失败各一张可折叠卡片,值为 JSON 树,工具栏与标题固定、仅时间线滚动。列表支持多选与删除。

一条记录就是一次求解的过程:每一步都能独立阅读,被中断的求解会在宿主重启后从它的记录继续。

文章生成

每条记录都可以写成一篇独立的解题文章。宿主 LLM 依据轨迹撰写——问题、条件、分析、带参数与结果的求解步骤、最终答案——以模型自己的口吻呈现,正文绝不提及本插件。

格式产物
Markdown平铺的 .md 文件,从不编译
LaTeXXeLaTeX 文档,由 LaTeX 驱动编译为 PDF

设置对话框会记住文章语言、输出目录与文件名。编译需要 latexmk 或 MiKTeX 的 texify,并需要 xelatex 引擎;对话框在宿主每次启动时检查一次工具链,没有可用驱动时「生成」按钮会禁用并给出原因。任务可取消,其进度对话框可最小化为角落胶囊、在页面切换间存活;生成的文件或其目录可以从该对话框直接打开。

外部求解器

除内置目录外,你还可以注册自己的求解器,经 http 访问。声明存放在 ~/.dsh-electro-lab/external-solvers.jsonl,在引擎启动时编译进 solver 注册表,因此 solver_info 与 call 对它与内置求解器一视同仁。

声明途径方式
面板「外部求解器」页:列出、添加、编辑、启用、停用、删除
智能体external_solver_add、external_solver_update、external_solver_delete
文件直接编辑归档

声明包含名称、描述、参数、显式的 returns 形状与端点,可以用面板的引导式表单填写。更改在宿主重启后生效,在此之前面板会显示待重启提示。

对端收到 { "requestId": …, "args": … } 的 POST 后,以 { "requestId": …, "result": … } 应答;要报告失败则返回 { "requestId": …, "error": "…" }。参数与结果都是类型化值,因此单位以 SI 数字传输,而不是符号或单位词。

完整契约见引擎手册 §6;external-solvers-example/ 是可运行的对端与逐字段注册指南。

配置

设置含义
DSH_ELECTRO_LAB_HOME插件主目录,默认 ~/.dsh-electro-lab
DSH_ELECTRO_LAB_LOG_LEVELdebug、info、warn、error 或 off;默认 info

主目录存放记录、声明归档、插件状态,以及每次宿主运行一个日志文件。两者都在引擎手册中说明:存储与日志。

文档

文档内容
引擎手册 · English类型化值、原语、求解器目录、外部求解器、存储、日志
external-solvers-example · English可运行的回显对端与逐字段注册指南
参与贡献 · English环境搭建、提交规范、发布流程

许可

MIT © 2026 curtainsmall