符号计算器 11350613/SymPy-Calculate

SymPy-Calculate

一个 DeepSeek Harness 智能体预设，基于 minimal。它增加了一个无状态工具 sympy_calculate，在全新进程里运行完整的 Python 脚本，针对本地 SymPy 开发检出。

安全： sympy_calculate 以当前用户权限、继承当前环境执行任意 Python。它没有沙箱。只在你信任其模型和权限策略的会话里启用。

亮点

- 每次调用受 120 秒超时限制；stdout 和 stderr 各自上限 2,000,000 字符。

要求

| 要求 | 版本 / 说明 |
| DeepSeek Harness | 0.2.0-rc.2 |
| Node.js | ^22.19.0 或 >=24.0.0 |
| pnpm | 11.7.0；缺失时用 npm install -g pnpm@11.7.0 安装 |
| git | SymPy 检出需要；HTTPS 安装可选 |
| Python | 3.x，需有 venv 和 pip |
| SymPy | 本地检出；默认根目录 ~/sympy-dev/sympy |
| 平台 | 仅在 Ubuntu 24.04.4 LTS 上测试过 |

在随附的配置档里，只安装到 web。该预设需要 web 包提供的 agent-preset-registry 服务；在 headless、sdk、sdk-minimal 或 acp 里无法选中它。自定义配置档只要提供 agent-preset-registry，就能使用它。

设置 SymPy

工具使用这个检出根目录和解释器候选：

~/sympy-dev/sympy
~/sympy-dev/sympy/venv/bin/python
~/sympy-dev/sympy/venv/bin/python3

在 Ubuntu 上，如果缺少 venv 工具，先安装：

sudo apt install -y python3-venv python3-pip

然后创建检出：

mkdir -p ~/sympy-dev
git clone https://github.com/sympy/sympy.git ~/sympy-dev/sympy
Optional: use the exact tested SymPy revision.
git -C ~/sympy-dev/sympy checkout 6aabf6ac9eddd1c5141ff9a3a35dcb53a7b02228
python3 -m venv ~/sympy-dev/sympy/venv
~/sympy-dev/sympy/venv/bin/python -m pip install -e ~/sympy-dev/sympy
echo 'venv/' >> ~/sympy-dev/sympy/.git/info/exclude

可编辑安装也会装上 SymPy 的外部依赖 mpmath。安装插件前先确认检出：

~/sympy-dev/sympy/venv/bin/python -c "import sympy; print(sympy.__version__)"

要用别的检出或解释器，就在启动 DeepSeek Harness 的环境里设置这两个变量：

| 变量 | 默认值 | 含义 |
| SYMPY_ROOT | ~/sympy-dev/sympy | 检出根目录；也是 PYTHONPATH |
| SYMPY_PYTHON | <root>/venv/bin/python，然后是 python3 | Python 解释器 |

安装

安装到 web 配置档。命令固定 v1.0.4，即测试过的插件版本。如果 dsh 已在你的 PATH 上，把 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 前缀换成 dsh。

HTTPS tarball，推荐，因为不需要 GitHub SSH key：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add \
https://codeload.github.com/11350613/SymPy-Calculate/tar.gz/v1.0.4

其他安装方式：GitHub 简写，或 DeepSeek Harness 源码检出

已经配置好 GitHub SSH 访问时，可以用 Git 简写：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add \
github:11350613/SymPy-Calculate#v1.0.4

从源码检出安装时，用 pnpm dsh，并优先使用 tarball 形式：

pnpm dsh plugin --profile web add \
https://codeload.github.com/11350613/SymPy-Calculate/tar.gz/v1.0.4

启动或重启 web 配置档，然后在创建会话时选择 SymPy Calculate。

验证

检查 bundle 和预设是否已写入合成后的配置：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config \
| grep "SymPy Calculate"

然后启动 UI，确认 SymPy Calculate 出现在预设选择器中，且没有错误标记：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --no-open

用法

sympy_calculate 需要一段完整脚本：

{
"code": "from sympy import \n\nx = symbols('x')\nprint(integrate(x2 / (1 + x4), (x, -oo, oo)))\n"
}

输出：

sqrt(2)pi/2

每次调用都会启动新的解释器，并付出 SymPy 导入开销，所以请把相关的计算合并到一个脚本里，不要拆成很多次小调用。stdout 和 stderr 会合并返回；退出码非零时，会作为工具错误返回。

故障排查

| 现象 | 解决办法 |
| sympy_calculate: no Python interpreter under ... | 按上面的步骤完成 SymPy 安装，或者在启动 dsh 之前导出 SYMPY_ROOT / SYMPY_PYTHON。 |
| 卸载插件 | npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove dsh-sympy-calculate |

测试环境

- SymPy-Calculate 版本：v1.0.4
- Ubuntu 24.04.4 LTS
- DeepSeek Harness 提交：deepseek-ai/deepseek-harness@639ed01
- SymPy 提交：sympy/sympy@6aabf6a

问题反馈

Bug 报告和功能请求：<https://github.com/11350613/SymPy-Calculate/issues>

许可证

MIT。见 LICENSE。