mcpField
M
midnight-environment-setup

midnight-environment-setup

github.com/kali-decoder开发18122 次安装1 天前更新
代码仓库

关于 midnight-environment-setup

midnight-environment-setup 是用于准备 Midnight 开发环境的 AI Agent 技能。它检查并安装 Compact、配置 PATH、通过 Docker 启动 proof server，并指导设置 VS Code 扩展，同时逐步验证操作。

主要功能

  1. 01检测系统与开发工具
  2. 02安装并更新 Compact
  3. 03配置并验证 PATH
  4. 04通过 Docker 启动 proof server
  5. 05指导安装 VS Code 扩展
  6. 06逐步验证环境设置

适用场景

  1. 01准备 Midnight 开发机器
  2. 02编译合约前安装 Compact
  3. 03为应用开发启动 proof server

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kali-decoder/midnight-skills --skill midnight-environment-setup

安装后在 Claude Code 中输入/midnight-environment-setup确认已加载。

详细介绍

技能：Midnight 环境设置

目标

自动为用户准备完整的 Midnight 开发环境。

如果尚未安装所需工具，则在尝试构建、编译或部署任何 Midnight 应用程序之前，始终应先执行此技能。

职责

AI 助手应尝试自动完成每个安装步骤。

只有当某个步骤因权限限制、操作系统限制、无法访问图形界面或无法访问终端而无法完成时，助手才应请用户手动完成该特定步骤。

切勿立即粘贴安装文档。

步骤 1 — 检测环境

确定：

  • 操作系统
  • Shell（bash/zsh）
  • Docker 是否可用
  • VS Code 是否可用
  • Compact 是否已安装
  • 当前 PATH
  • 现有编译器版本

可能有用的命令：

uname -a
which compact
compact --version
compact compile --version
docker --version
code --version
echo $SHELL

步骤 2 — 安装 Compact

如果尚未安装 Compact：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh

等待安装完成。

步骤 3 — 刷新 PATH

确定 Shell。

如果是 zsh：

source ~/.zshrc

如果是 bash：

source ~/.bashrc

如果仍找不到 Compact，请追加：

export PATH="$HOME/.compact/bin:$PATH"

再次重新加载 Shell。

步骤 4 — 更新编译器

始终安装最新编译器。

compact update

步骤 5 — 验证安装

运行

compact --version

compact compile --version

which compact

只有所有命令均无错误地执行，才视为安装成功。

步骤 6 — Docker

检查 Docker 是否可用。

如果 Docker 不可用：

说明必须手动安装 Docker Desktop。

https://www.docker.com/products/docker-desktop/

暂停操作，直到 Docker 正在运行。

步骤 7 — 启动证明服务

运行

docker run -p 6300:6300 midnightntwrk/proof-server:latest midnight-proof-server -v

确认日志显示：

Listening on http://localhost:6300

如果端口 6300 已被占用，请使用以下命令重试：

docker run -p 6301:6300 midnightntwrk/proof-server:latest midnight-proof-server -v

告知用户，应用程序现在必须使用端口 6301。

步骤 8 — VS Code 扩展

如果已安装 VS Code：

指导用户安装 Compact VS Code 扩展（VSIX 软件包）。

除非环境明确支持通过图形界面操作，否则 AI Agent 无法可靠地安装 VS Code 扩展。

提供简明说明：

  1. 下载 Compact VSIX 软件包。
  2. 打开 VS Code。
  3. 选择“扩展”。
  4. 选择“从 VSIX 安装”。
  5. 选择下载的文件。

最终验证清单

确认：

  • 已安装 Compact
  • 已安装最新编译器
  • 已配置 PATH
  • Docker 正在运行
  • 证明服务正在运行
  • 已安装 VS Code 扩展（或已告知用户）

故障排除

compact：找不到命令

重新加载 Shell。

如有需要：

export PATH="$HOME/.compact/bin:$PATH"
source ~/.zshrc

或

source ~/.bashrc

Docker 未运行

请用户启动 Docker Desktop，并等待引擎完全启动。

端口 6300 已被占用

使用：

docker run -p 6301:6300 midnightntwrk/proof-server:latest midnight-proof-server -v

并将应用程序配置为使用：

http://localhost:6301

Agent 行为

始终优先选择自动化，而非解释。

只有在因权限、图形界面或操作系统限制而无法自动化时，才要求用户手动操作。

每次自动操作后，都要先验证是否成功，再继续下一步。

切勿在未检查输出的情况下假定命令已成功执行。

目标是为用户准备好可正常工作的 Midnight 开发环境，以便构建、编译和部署 DApp。

作者：Kali-Decoder

评论

支持 Markdown