NewMe AI 部署指南

操作初始化

复制下面这句话,粘贴到 WorkBuddy 或豆包并发送。

请打开 https://www.newme.net.cn/MiaoPlay/prompt.html#ai-execution,跳过页面顶部的用户操作说明,按「AI 执行」章节开始部署。先让我选择自动模式或手动模式,等我选择后再开始。如果无法读取网页,请告诉我。

AI 执行

开始前:选择执行模式

开始部署前,先问用户:“你想用哪种模式部署?手动模式(默认,每一步都由你确认),或自动模式(连续执行到部署完成)。”等用户明确选择模式或确认使用默认模式后,再开始部署。

两种模式都以用户指定的部署范围为准。正式发布到妙游需要用户明确指定已预览的版本。

确认当前会话能否运行本地终端命令并读写已授权目录。只能聊天时,每次提供一条可复制的命令,等待用户反馈结果后继续。已有项目时使用用户指定的项目。若无法确定项目名或远端地址,请向用户询问。

在对话中报告执行进度

保留原有编号。每个小步骤执行并验证成功后,在该项前加绿色对号 ✅,并用一句话说明验证结果,例如「✅ 第1步 (2). 已创建并删除临时文件,写权限验证通过」。该大步骤的所有必做小步骤都通过后,再给大步骤标题加 ✅。

等待用户操作或确认时用 ⏸️,失败时用 ❌ 并说明原因。手动模式在等待确认时展示最新进度,自动模式在报告进度后继续执行已授权的步骤。如果对话支持更新清单,就更新同一份清单,否则每完成一项发送一条结果。

第1步:配置并验证本地 NewMe 工作目录

(1). 先确认本地 NewMe 工作目录。若用户已授权当前工作区作为 NewMe 目录,直接核对其路径。否则优先使用客户端的「选择文件夹」或「打开工作区」,让用户在系统文件夹选择框中点选。如果 AI 无法代为弹出选择框,请指引用户在客户端手动打开;如果客户端没有此功能,请用户粘贴完整路径,或明确同意使用默认目录(Windows 为 %USERPROFILE%\NewMe,macOS 和 Linux 为 ~/NewMe)。用户取消选择时暂停本步,等待重新选择或提供路径。之后在实际执行命令的环境中验证路径和权限;若使用 WSL,按其中的 Linux 环境处理。

(2). 目录不存在时创建它。通过创建并删除临时文件验证当前会话有写权限,并报告实际路径。若无法访问,请引导用户授权该目录或选择其他可写目录。只能聊天时,给用户命令在本机执行。验证通过后再设置当前工作区。

(3). 将已验证的 NewMe 目录设为当前 AI 会话的工作区。如果客户端支持选择工作文件夹,请打开该目录并确认实际路径。手动模式先等待用户确认。如果只能运行终端命令,每次执行时都显式指定工作目录,避免依赖上一次终端调用的目录状态。进入具体项目后,将项目子目录设为 Git 命令的工作目录,并在首次提交或推送前核对仓库根目录和远端地址。

第2步:接通 NewMe Git

(1). 运行 git --version 和 ssh -V。在 Windows PowerShell 用 Get-Command ssh-keygen,在 macOS 或 Linux 用 command -v ssh-keygen,确认密钥工具可用。

(2). 仅安装缺少的工具。Windows 缺少 Git 时,使用 winget install --id Git.Git -e --source winget,或引导用户从 Git for Windows 官方页面安装。缺少 SSH 工具时,在 Windows 可选功能中添加 OpenSSH Client,或在管理员 PowerShell 中运行 Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0。macOS 缺少 Git 时可运行 xcode-select --install 安装 Apple 命令行开发工具。SSH 先检查系统提供的客户端。Linux 和 WSL 按发行版使用包管理器,例如 Ubuntu 或 Debian 使用 sudo apt install git openssh-client,Fedora 使用 sudo dnf install git openssh-clients。手动模式逐项确认安装。自动模式连续完成已授权的安装,遇到系统授权弹窗时标记 ⏸️,等待用户处理。

(3). 在同一系统的新终端窗口复查三个命令。全部可用后标记 ✅,再优先复用已用于 NewMe Git 的专用 SSH 密钥。Ed25519 和 RSA 均可复用,后续用对应密钥验证仓库连接。如果没有 NewMe 专用密钥,默认新建一把 Ed25519 密钥。只复制 .pub 公钥,私钥和口令留在本机。

(4). 登记公钥。AI 读取并复制本次生成或复用的 .pub 公钥整行到剪贴板。将「复制公钥并打开设置页」作为一个操作,另提供「先暂停」。手动模式先确认这一步,自动模式直接执行已授权的操作。无论剪贴板操作是否报告成功,都从实际的 .pub 文件读取公钥,并在对话中用单独的纯文本代码块显示完整一行,不省略字符,也不添加命令、编号或提示符。若聊天界面提供代码块的复制按钮,提示用户点击;若没有按钮或粘贴为空,请用户手动选中整行复制。只显示公钥。剪贴板写入未核验时,提示用户用实际粘贴结果确认。 同时显示实际 .pub 文件的完整绝对路径。在确认界面提供「打开公钥所在的文件夹」操作。用户选择后,在其本机文件管理器中打开公钥的父目录,支持时选中该公钥文件,随后继续等待用户确认登记。打开前验证公钥路径存在。客户端不支持可点击的本地操作时,请给出文件夹的完整路径和适合当前系统的打开方法。WSL 或远程环境需确认用户能从本机访问该路径。先在 NewMe 首页登录自己的账号,再用同一浏览器打开 SSH 密钥设置页。如果仍跳到 Git 登录页,请回 NewMe 首页确认登录状态,再重新打开设置页。点击「添加密钥」,填写容易识别的名称(例如「我的笔记本」),在密钥内容框粘贴整行公钥,再点击「添加密钥」保存。只使用 .pub 文件的内容。

如果 AI 能操作已登录的浏览器,且用户已授权登记公钥,可以代填并提交。手动模式须先确认。需要登录、验证码或缺少浏览器权限时,标记 ⏸️ 并让用户操作,完成后继续下一项验证。

如果由用户添加公钥,复制后必须停在第2步 (4).,自动模式也一样。标记 ⏸️,在确认问题里给出两个可点击的链接,请用户先在 NewMe 首页登录,再用同一浏览器打开 SSH 密钥设置页,点击「添加密钥」,填写名称、粘贴公钥并保存。请用户回到密钥列表,确认刚填写的名称已出现,再回来选择「我已在 NewMe Git 保存公钥,并在列表中看到它,请验证仓库连接」。同时提供「保存时遇到问题」和「稍后继续」。收到明确确认后才执行 (5).。如果 AI 已获授权代填提交,先确认密钥出现在列表中,再按所选模式继续。

(5). 公钥保存后,从目标仓库页面取得实际 SSH 地址和端口。首次连接时先核对管理员提供的 SSH 主机指纹。仅对此次验证设置 GIT_SSH_COMMAND,使用 ssh -F none -o IdentitiesOnly=yes -o IdentityAgent=none -i "本次公钥对应的私钥路径",再运行 git ls-remote "仓库的 SSH 地址"。按当前终端设置临时环境变量,验证结束后恢复原值。私钥仅由本机 SSH 客户端使用。

命令退出状态为 0 即可标记 ✅。空仓库可能没有输出。此项验证 SSH 密钥和仓库读取权限,写入权限在首次推送时验证。若出现 Permission denied (publickey),检查公钥是否保存到正确账号、指定私钥是否与公钥配对,以及 SSH 地址和端口是否正确,然后重试。

第3步:建立或接入本地项目

先列出已授权的 NewMe 工作目录下可识别的项目,询问同步范围:「同步所有项目(默认)」「同步一个项目」「新建项目」或「先暂停」。选择单个项目时,请用户从列表中指定。选择所有项目时,列出各项目的目标仓库、分支及缺少的配置,收到明确确认后再逐个检查并同步。某个项目遇到冲突、权限不足或缺少远端时,单独报告并继续其他已确认项目。批量同步只推送到 NewMe Git,妙游发布按项目确认。

(1). 在已验证的 NewMe 工作目录中,为每个项目使用独立子目录和 Git 仓库。已有远端就克隆,新项目先创建空远端再关联本地仓库。

(2). 只修改我指定的项目,保留已有改动,运行项目已有检查并告诉我如何预览。

第4步:同步到服务器

快捷指令:同步工作目录。收到这句话后,扫描已授权的 NewMe 工作目录,列出可识别的本地项目。以用户已确认的 Git 账号为准,例如 memo。核对每个项目的远端与账号归属;已存在的仓库标为「待同步」,确认不存在的标为「待创建」,计划在该账号下建立同名私有空仓库。无法核实的标为「待核实」。

先展示本地项目、远端仓库、目标分支 main 和计划操作。两种执行模式都须等用户确认这份清单后,才可建库和推送。建库使用经核对的浏览器会话或有建库权限的 API 凭据;只有 SSH 权限时,请用户先建库。推送前核对 SSH 身份,遇到分支不匹配、历史冲突或远端领先时暂停该项目,禁止强推。完成后逐个报告仓库链接和提交 SHA。

快捷指令:同步服务器。用户单独发送「同步服务器」或「同步到服务器」时,立即启动本步骤。默认处理已确认范围内的所有本地项目。自动模式直接提交并推送已授权项目,手动模式按既定规则逐步确认。尚未确定同步范围、Git 用户名、远端或分支时,先补齐信息。

从本地仓库读取远端地址,只推送到已核对的 NewMe Git 仓库。推送前确认指定 SSH 密钥对应的服务端账号与用户确认的 Git 用户名一致。身份不符、远端领先或有冲突时暂停该项目并报告。逐个汇报分支和提交 SHA;此指令不发布到妙游。

(1). 执行同步时,检查差异、分支和远端地址,排除 .env、密钥、令牌及无关文件。

(2). 提交并推送,禁止强推。同步后告诉我仓库链接、分支和提交 SHA。遇到冲突或权限问题时,说明卡在哪一步。

第5步:预览并按需发布到妙游

(1). 我说“准备发布到妙游”时,从已同步的指定提交打包试玩文件。ZIP 根目录或唯一外层目录须有 index.html,资源使用相对路径,解包后最多 50 MiB、256 个条目。

(2). 引导我在 https://www.newme.net.cn/MiaoPlay/ 上传草稿并预览。已绑定 Gitea 且需要服务器手动同步时,整理仓库地址、提交 SHA 和产物路径交给管理员。

(3). 只有我明确要求发布某个已预览的版本时,才引导我点“发布到大厅”,或通过已验证的发布入口执行。发布后检查未登录访客能否打开作品,并告诉我公开链接和对应的提交 SHA。

第一次可以这样说

请读取 https://www.newme.net.cn/MiaoPlay/prompt.html 并按指南部署我的 memory-match 项目,完成后让我预览。