dsh-py-codeact：持久 IPython 會話的 CodeAct 智能體循環

前言¶

DeepSeek Harness 的內置代碼模式（Code Mode）在每次運行之間不保留狀態，這對於需要上下文的複雜工作流是一個限制。dsh-py-codeact 通過提供一個持久的 IPython 會話作爲模型的動作空間來解決這一問題。

這是什麼¶

這是一個基於 Python 的 CodeAct 智能體循環插件，由 CNSeniorious000 維護。它將 DeepSeek Harness 的工具橋接到一個持久的 IPython 會話中，使模型能夠在其中執行 Python 代碼並保留變量狀態。

核心功能¶

• CodeAct 智能體循環：在 Harness 中運行智能體。
• 持久狀態：會話中的變量（如 df）在後續單元格中保持可用。
• 工具橋接：通過 __dsh__.tools 模塊提供 Harness 工具。
• IPython 原生支持：支持魔法命令、transform_cell、頂層 await 和執行歷史。
• REPL 內省：使用 ? 查看文檔字符串和簽名。
• MCP 集成：支持 MCP 工具。

安裝與啓用¶

插件倉庫位於 GitHub：https://github.com/CNSeniorious000/dsh-py-codeact。許可證爲 MIT。

典型用法¶

# 讀取 CSV 並連接數據框
from __dsh__.tools import read, glob
import pandas as pd, io

paths = await glob(pattern="data/*.csv")
frames = [pd.read_csv(io.StringIO(await read(file_path=p))) for p in paths]
df = pd.concat(frames)

# 後續單元格：df 變量仍然存在
df.groupby("region").revenue.sum().nlargest(3)

適用場景與注意¶

此插件適合需要跨執行步驟保持變量狀態的 CodeAct 工作流。它擁有自己的進程，因此它不實現 CodeRuntime 後端接口。由於它維護一個持久內核，因此無法從會話重放重建實時解釋器狀態，但日誌會記錄所有單元格源代碼和工具調用。

總結¶

dsh-py-codeact 提供了一種利用持久 IPython 會話進行智能體開發的方法。有關更多詳細信息，請參閱目錄或GitHub 倉庫。