电力系统仿真 InterPSS-Project/ipss-agent

iPSS Agent

InterPSS Agentic Power System Simulation Agent，用于交流潮流计算、基于直流法的故障分析，以及报告生成，包括 NERC TPL-001-5 风格。本仓库提供面向智能体的技能，供 OpenAI Codex Desktop 和 DeepSeek Harness 使用（构建与命令行细节见 Setup.md；DSH 插件见 InstallDSHPlugin.md）。批量运行的规范技能是 .agents/skills/ipss-sim/SKILL.md。（详见批量对话用户指南）：

ipss-agent-chat

它也作为 DSH 插件集成进 DeepSeek Harness。你可以在本地沙箱里，按传统的分步方式运行电力系统仿真（DSH 插件用户指南）：

ipss-dsh-plugin

仿真结果可以用单线图可视化：

ipss-dsh-diagram

环境搭建

前置条件： Java JDK 21、Maven（或自带的 mvnw wrapper）。

让 Codex、Claude Code 或 DeepSeek Harness 克隆并构建 ipss-agent：

Install(Update) and setup ipss-agent from https://github.com/InterPSS-Project/ipss-agent

取决于你的网速，下载依赖并构建命令行可能要花一些时间。

在项目根目录构建 Java 命令行：

./mvnw -q clean package

这会生成 target/ipss-agent-cmd-1.0.0-uber.jar。完整目录结构、测试与配置见 Setup.md。

用一个示例算例目录测试环境：

init # for the first time installation
/ipss-sim data/ieee/Ieee118Bus/ "IEEE 118-Bus Test Case"

DSH 插件搭建

安装 DeepSeek Harness（推荐桌面版）。让 DeepSeek Harness 安装 InterPSS DSH 插件：

Install(update) InterPSS DSH plugin

在 DSH 里把 iPSS Agent 文件夹作为工作区打开。之后你就可以按 DSH 插件用户指南运行电力系统仿真工作流，或直接对话。

用户指南

- InterPSS DSH 插件用户指南 dsh_plugin_user_guide.md
- InterPSS 单线图用户指南 oneline_diagram_user_guide.md
- InterPSS 潮流调整用户指南 loadflow-adjustment-user-guide.md
- 发电机 OptAdj（再调度）方法 gen_opt_adjustment.md / 技能 $ipss-case-optadj
- iPSS Agent 对话（批量）用户指南 batch_chat_user_guide.md

教程视频

- 1 安装 InterPSS DSH 插件并运行 /ipss-sim
- 2 在 GUI 或对话模式中运行 InterPSS
- 3 运行潮流调整
- 4 使用或创建单线图

发布说明

- 最新：Release-V0.7.15.md（@deepseek-ai/dsh-interpss 0.7.15）
- 更早版本：docs/release_note/

参考

| 主题 | 文档 |
| 布局、构建、JAR、智能体技能 | Setup.md |
| IpssCmd（Java 命令行）用法 | IpssCmd.md |
| Markdown 报告生成器 | GenReport.md |
| DeepSeek Harness DSH 插件 | InstallDSHPlugin.md |
| InterPSS 聊天工具 | docs/interpss-tools.md |