Get Physics Done (GPD)

由物理学家构建，为物理学家服务

Get Physics Done (GPD) 是由 Physical Superintelligence PBC (PSI) 开发并作为社区贡献发布的一款用于物理研究的开源 AI 副驾驶工具。GPD 能够帮助你将研究课题转化为结构化的工作流：界定问题、规划工作、推导结果、验证结果以及打包输出。

https://github.com/user-attachments/assets/e79f8153-c0bd-484f-b69e-da8f142649e0

快速上手 · 支持的运行时环境 · 工作流 · 命令 · 模型 · 高级 CLI 工具 · 系统要求

适用对象

GPD 专为无法通过手动提示词（Prompting）可靠处理的高难度物理研究问题而设计。

它适用于需要严谨验证、结构化研究记忆、多步骤分析工作、复杂数值研究以及文稿撰写或审阅的长周期项目。

我们欢迎通过 GitHub Issues 或 Pull Requests 提供贡献与反馈；如果 GPD 对你的工作有所帮助，请为该仓库加星（Star），并分享给可能需要的同事。

快速上手

安装 GPD：

npx get-physics-done

安装后的后续步骤

安装程序会将 GPD 添加到你的运行时配置中，但不会自动为你启动运行时。

1. 在你的常规系统终端中打开选定的运行时（如 Claude Code 使用 claude，Gemini CLI 使用 gemini，Codex 使用 codex，OpenCode 使用 opencode）。
2. 首先运行其帮助命令：Claude Code / Gemini CLI 使用 /gpd:help，Codex 使用 $gpd-help，OpenCode 使用 /gpd-help。
3. 对于全新的研究项目，使用 new-project；对于现有的文件夹或项目，使用 map-research。

为获得最佳性能，请在常规系统终端中执行此安装步骤及后续运行时操作，而不是在 VS Code、Cursor 或其他 AI 运行时的命令/聊天界面内执行。

然后，根据你的起始需求选择以下路径：

起始点	首条命令	用途
全新研究项目	new-project	启动一个新的 GPD 研究工作流。
现有研究文件夹或代码库	map-research	在规划前映射现有的工作内容。
配置工作流和模型默认值	settings	设置工作流开关、层级模型和研究偏好。

使用 支持的运行时环境 中所示的特定运行时命令语法，例如 /gpd:settings 或 /gpd:set-profile review。

如果你从现有工作开始，请在运行 new-project 之前先运行 map-research，以映射形式体系、计算、约定、验证状态和待解决的问题。

典型的 new-project 工作流：

/gpd:new-project -> /gpd:discuss-phase 1 -> /gpd:plan-phase 1 -> /gpd:execute-phase 1 -> /gpd:verify-work 1

安装选项

标志	含义
--claude, --codex, --gemini, --opencode	选择一个运行时。同时也支持 --claude-code 和 --gemini-cli。
--all	选择所有支持的运行时。
--local, -l	仅使用当前项目。
--global, -g	使用全局运行时配置目录。
--uninstall	从选定的运行时配置中卸载，而非安装。
--reinstall	将匹配的已标记 GitHub 源码重新安装到 ~/GPD/venv。
--upgrade	从 GitHub main 分支的最新源码升级 ~/GPD/venv。
--target-dir	覆盖运行时配置目录；除非路径解析为该运行时的规范全局配置目录，否则默认为本地范围。
--force-statusline	在安装期间替换现有的运行时状态栏。
--help, -h	显示引导程序帮助。

普通安装程序会固定在匹配的已标记版本上。仅当你明确需要最新的未发布 main 源码时，才使用 --upgrade。

显式安装未发布的 GitHub main 快照：

npx -y github:psi-oss/get-physics-done --upgrade

支持的运行时环境

GPD 目前可安装到四个 AI 运行时中。若要在安装时预选其中一个，请使用对应的 npx 标志；若要一次性安装所有环境，请使用 --all：

运行时	npx 标志	帮助命令	启动命令
Claude Code	--claude	/gpd:help	/gpd:new-project
Codex	--codex	$gpd-help	$gpd-new-project
Gemini CLI	--gemini	/gpd:help	/gpd:new-project
OpenCode	--opencode	/gpd-help	/gpd-new-project

每个运行时使用各自的命令前缀，但工作流在四个环境中完全一致。安装 GPD 后，从系统终端正常打开选定的运行时，并使用上述命令即可。

注意：

• Claude Code 特别说明：GPD 会写入 .claude/settings.json 以处理钩子（hooks）和状态栏。对于本地安装，MCP 服务器会被添加到项目的 .mcp.json 中。