diff --git a/.github/getting-started-AGENTS.md b/.github/getting-started-AGENTS.md index a662a633..8bff89bd 100644 --- a/.github/getting-started-AGENTS.md +++ b/.github/getting-started-AGENTS.md @@ -16,7 +16,7 @@ ## 修改规则 - 根`README.md`是唯一主页；`getting-started-README.md`只做导航，不复制完整教程。 -- `god.md` 本身就是给网页版 Chat AI 的完整提示词：文件头要求用户全文复制并逐轮互动；网页 AI 首轮先简短说明路线并询问操作系统，用户不熟悉终端时指导打开本机终端（Android 使用 Termux）；Android/Termux 按 Pi 官方 Termux 指南引导，不套用桌面安装命令。再从 M0 引导到 M4，按需检查/安装 Pi CLI、准备网络、连接 OpenAI GPT、验证本机 Bash；若 CLI 已验证可用则跳过安装专用网络检查与安装步骤。安装阶段只核对当前安装路线所需目标，不逐项探测未触发的安装源；短网络探测须设置连接和总时限，并说明超时不等于不可达；OpenAI 模型网络检查仅在 M4.1 按所选登录路线与实际故障执行；Pi 的 OpenAI GPT 路线区分 ChatGPT 订阅 OAuth（provider `openai-codex`）和 OpenAI API Key，不得将 ChatGPT 订阅等同 API 额度；用户另选本地模型时按请求可另行指导，但不计作 OpenAI GPT 验证或满足完成标准第 2 项；仅 API Key 路线可探测 `api.openai.com`，订阅 OAuth 不用该端点代测。安装路线默认优先对应系统的官方安装器，且每轮只展示一条当前路线。必须等全部完成标准有真实证据后才报告完成，不得停在版本号、模型回答或单次命令检查。网页 AI 只核对用户回报，不能冒充本机执行。Chat/Work 是使用方式的教学分类，不是 Pi 的正式模式；本文完成范围限 Pi CLI、OpenAI GPT 与本机 Bash 通路，不承诺所有扩展、项目任务或自动化，不另维护重复提示词或项目开发步骤。 +- `god.md` 本身就是给网页版 Chat AI 的完整提示词：文件头要求用户全文复制并逐轮互动；网页 AI 首轮简短说明路线；系统不明时才问系统，已提供的系统/终端信息直接复用；实际终端未确认或未就绪时指导打开/确认本机终端（Android 使用 Termux），若用户尚无检查结果且系统、实际终端已明确且已打开，可直接安排 M0 只读版本检查；已回报版本号则复用证据并跳过；Android/Termux 按 Pi 官方 Termux 指南引导，不套用桌面安装命令。再从 M0 引导到 M4，按需检查/安装 Pi CLI、准备网络、连接 OpenAI GPT、验证本机 Bash；若 CLI 已验证可用则跳过安装专用网络检查与安装步骤。安装阶段只核对当前安装路线所需目标，不逐项探测未触发的安装源；短网络探测须设置连接和总时限，并说明超时不等于不可达；OpenAI 模型网络检查仅在 M4.1 按所选登录路线与实际故障执行；Pi 的 OpenAI GPT 路线区分 ChatGPT 订阅 OAuth（provider `openai-codex`）和 OpenAI API Key，不得将 ChatGPT 订阅等同 API 额度；用户另选本地模型时按请求可另行指导，但不计作 OpenAI GPT 验证或满足完成标准第 2 项；仅 API Key 路线可探测 `api.openai.com`，订阅 OAuth 不用该端点代测。安装路线默认优先对应系统的官方安装器，且每轮只展示一条当前路线。必须等全部完成标准有真实证据后才报告完成，不得停在版本号、模型回答或单次命令检查。网页 AI 只核对用户回报，不能冒充本机执行。Chat/Work 是使用方式的教学分类，不是 Pi 的正式模式；本文完成范围限 Pi CLI、OpenAI GPT 与本机 Bash 通路，不承诺所有扩展、项目任务或自动化，不另维护重复提示词或项目开发步骤。 - `god.md` 将完整提示词放进单个默认展开的 Markdown 代码块，便于整体复制。移除折叠标签、HTML 锚点和页内章节链接；入站链接及历史重定向直接指向 `god.md`，文集链接不生成失效片段。修改时使用比正文内部示例更长的外层围栏，并保留经文、操作流程、安全边界和完成标准。经文仅用已核验的《圣经》和合本简体（CUVS）原句，注明书卷、章节、版本与原页；连续节录须注明，不拼接或改写。保留原语境，技术对应另作说明，不以引用或比喻增加执行授权、权限或效果承诺。 - 安装方式、Node.js 版本要求、系统支持和 provider 流程以 Pi 当前官方文档与安装入口为准；链接及命令须明确系统、终端、影响和成功判断。官方资料未说明的内容标为未知，不猜测。 - 区分 `pi --version`、模型授权/可用和项目任务完成；不把 CLI 安装说成模型已接通或项目环境已就绪。 diff --git a/.github/god.md b/.github/god.md index 1ffb7496..3f28be4b 100644 --- a/.github/god.md +++ b/.github/god.md @@ -11,7 +11,7 @@ **本文目的：**帮助初学者借助网页版 Chat AI，按需检查或安装并验证 Pi CLI，再完成 OpenAI GPT 与本机 Bash 的配置和使用验证；实际操作由用户在本机完成。 -- 把本文全文交给网页版 Chat AI：首轮只问系统，之后每轮只引导一个本机动作并等你回报。 +- 把本文全文交给网页版 Chat AI：系统不明时首轮只问系统；已知的系统/终端信息不重复问，之后每轮只引导一个本机动作并等你回报。 - 若不熟悉终端，先按系统指导打开本机终端（Android 使用 Termux）；在计划使用的终端运行 `pi --version`。有版本号就跳过 Pi 安装和安装网络检查。 - 命令未找到时，仅在近期安装/更新 Pi 或修改 PATH 后重开终端重试一次；再核对既有安装。状态或渠道不明就暂停，不盲目重装。 - 确认没有可复用安装后，先说明影响并等你明确决定；只检查本系统官方安装路线所需网络，目标不可达且你选择代理时才处理代理，再按该路线安装。 @@ -21,7 +21,7 @@ ## 给网页版 Chat AI 的任务 -用户将本代码块全文复制给网页版 Chat AI。用户首次粘贴后，先简短说明路线，然后只询问操作系统；第一轮不发命令、安装脚本或代理配置，也不发链接或网络测试。首轮可直接这样回复： +用户将本代码块全文复制给网页版 Chat AI。用户首次粘贴后，先简短说明路线，并复用用户已提供的信息，不重复追问。若系统不明，只问系统；此时首轮不发命令、安装脚本、代理配置、链接或网络测试。若系统已明但实际终端未确认或未就绪，只引导打开或确认对应终端并等待；若用户尚无 `pi --version` 检查结果，且系统和实际终端均已明确、终端已打开，可直接安排 M0 的只读检查并等待结果；已回报版本号则复用证据并跳过。系统不明时可直接这样回复： > 我会先确认你准备使用的系统和终端，再检查 Pi 是否已可用；已安装就不重装。你现在使用 Windows、macOS、Linux 还是 Android/Termux？如果不知道终端怎么打开，告诉我即可。 @@ -39,7 +39,7 @@ ## M0：检查现状 -先询问用户使用 Windows、macOS、Linux 还是 Android/Termux，并等待回答；告诉用户不知道终端或还没打开都没关系。若用户回答 Android/Termux，不套用下方 Linux/macOS/Windows 命令，改按[Pi 官方 Termux 指南](https://pi.dev/docs/latest/termux)逐轮引导。核对 Termux 来源：官方指南推荐 GitHub 或 F-Droid，不使用已弃用的 Google Play 版本；若来源不明或用户仍使用该版本，先暂停核对，不盲目重装或迁移。Termux 包升级、依赖安装或共享存储授权前，说明具体影响并等用户明确决定；共享存储仅在确需访问 Android 文件时配置。其他未列平台先核对对应官方文档；没有明确路线就说明暂不能按本文引导。若用户不知道“终端”是什么或如何打开，解释它是输入命令的系统应用，再按其系统引导打开本机终端：Windows 使用 PowerShell（可从 Windows Terminal 进入），不默认使用 WSL；macOS 打开 Terminal；Linux 使用当前桌面环境的终端，若找不到再询问发行版/桌面环境；Android 使用 Termux；若尚未安装，说明其官方来源与安装影响、等待用户明确决定，这一步只准备终端，不代表 Pi 已安装；若来源不明，先按上文官方路线核对并等待用户决定。若用户已有终端，先确认实际 shell；Windows 原生 PowerShell 与 WSL/Linux shell 是不同环境，命令须按实际终端选择。终端就绪后才检查现状。不要为安装 Pi 默认要求 WSL、Git、Python、编辑器、代理或项目依赖。 +若用户尚未明确使用 Windows、macOS、Linux 还是 Android/Termux，才询问系统并等待回答；已明确的系统或终端信息直接复用，不重复追问。告诉用户不知道终端或还没打开都没关系。若用户回答 Android/Termux，不套用下方 Linux/macOS/Windows 命令，改按[Pi 官方 Termux 指南](https://pi.dev/docs/latest/termux)逐轮引导。核对 Termux 来源：官方指南推荐 GitHub 或 F-Droid，不使用已弃用的 Google Play 版本；若来源不明或用户仍使用该版本，先暂停核对，不盲目重装或迁移。Termux 包升级、依赖安装或共享存储授权前，说明具体影响并等用户明确决定；共享存储仅在确需访问 Android 文件时配置。其他未列平台先核对对应官方文档；没有明确路线就说明暂不能按本文引导。若用户不知道“终端”是什么或如何打开，解释它是输入命令的系统应用，再按其系统引导打开本机终端：Windows 使用 PowerShell（可从 Windows Terminal 进入），不默认使用 WSL；macOS 打开 Terminal；Linux 使用当前桌面环境的终端，若找不到再询问发行版/桌面环境；Android 使用 Termux；若尚未安装，说明其官方来源与安装影响、等待用户明确决定，这一步只准备终端，不代表 Pi 已安装；若来源不明，先按上文官方路线核对并等待用户决定。若用户已有终端，先确认实际 shell；Windows 原生 PowerShell 与 WSL/Linux shell 是不同环境，命令须按实际终端选择。终端就绪后才检查现状。不要为安装 Pi 默认要求 WSL、Git、Python、编辑器、代理或项目依赖。 确认环境后，让用户在计划使用 Pi 的终端单独运行： diff --git a/.github/test-source-archive.py b/.github/test-source-archive.py index d0d8452b..35eb86c1 100644 --- a/.github/test-source-archive.py +++ b/.github/test-source-archive.py @@ -240,14 +240,15 @@ class SourceArchiveTest(unittest.TestCase): for contract in ( '## 字多不看', '**本文目的：**帮助初学者借助网页版 Chat AI，按需检查或安装并验证 Pi CLI，再完成 OpenAI GPT 与本机 Bash 的配置和使用验证；实际操作由用户在本机完成。', - '把本文全文交给网页版 Chat AI：首轮只问系统，之后每轮只引导一个本机动作并等你回报。', + '把本文全文交给网页版 Chat AI：系统不明时首轮只问系统；已知的系统/终端信息不重复问，之后每轮只引导一个本机动作并等你回报。', '有版本号就跳过 Pi 安装和安装网络检查', '状态或渠道不明就暂停，不盲目重装。', '目标不可达且你选择代理时才处理代理', '版本号只证明 CLI 可用；OpenAI GPT 与本机 Bash 的配置及使用验证随后另行完成。', - '用户首次粘贴后，先简短说明路线，然后只询问操作系统', - '第一轮不发命令、安装脚本或代理配置', - '也不发链接或网络测试', + '用户首次粘贴后，先简短说明路线，并复用用户已提供的信息，不重复追问。', + '若系统不明，只问系统；此时首轮不发命令、安装脚本、代理配置、链接或网络测试。', + '若系统已明但实际终端未确认或未就绪，只引导打开或确认对应终端并等待', + '若用户尚无 `pi --version` 检查结果，且系统和实际终端均已明确、终端已打开，可直接安排 M0 的只读检查并等待结果；已回报版本号则复用证据并跳过。', '我会先确认你准备使用的系统和终端，再检查 Pi 是否已可用；已安装就不重装。你现在使用 Windows、macOS、Linux 还是 Android/Termux？如果不知道终端怎么打开，告诉我即可。', 'Android/Termux，不套用下方 Linux/macOS/Windows 命令', 'https://pi.dev/docs/latest/termux',