docs: god - 清理 M0 终端准备说明 (#232)

2026-11-02 10:46:29 +00:00 · 2026-10-24 07:10:34 +08:00
parent 7d2772c8b6
commit 4f7e247eaf
3 changed files with 22 additions and 2 deletions
@@ -16,7 +16,7 @@
 ## 修改规则

 - 根`README.md`是唯一主页；`getting-started-README.md`只做导航，不复制完整教程。
- `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` 本身就是给网页版 Chat AI 的完整提示词：文件头要求用户全文复制并逐轮互动；网页 AI 首轮简短说明路线；系统不明时才问系统，已提供的系统/终端信息直接复用；实际终端未确认或未就绪时指导打开/确认本机终端（Android 使用 Termux；仅在 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 排版，标题、段落和链接直接渲染；仅命令和对话示例保留独立代码块，不用外层围栏包住全文。整篇使用 GitHub 文件页右上角的原生全文复制按钮。移除折叠标签、HTML 锚点和页内章节链接；入站链接及历史重定向直接指向 `god.md`，文集链接不生成失效片段。修改时保留经文、操作流程、安全边界和完成标准。经文仅用已核验的《圣经》和合本简体（CUVS）原句，注明书卷、章节、版本与原页；连续节录须注明，不拼接或改写。保留原语境，技术对应另作说明，不以引用或比喻增加执行授权、权限或效果承诺。
 - 安装方式、Node.js 版本要求、系统支持和 provider 流程以 Pi 当前官方文档与安装入口为准；链接及命令须明确系统、终端、影响和成功判断。官方资料未说明的内容标为未知，不猜测。
 - 区分 `pi --version`、模型授权/可用和项目任务完成；不把 CLI 安装说成模型已接通或项目环境已就绪。模型授权前，M4.0 先说明目录资源加载、会话保存与信任提示的影响，再引导用户在目标终端用 `pi` 进入交互界面；`/login`、`/model` 和问题在 Pi 输入框而非系统终端或网页版 AI 输入。已有目标目录的 Pi 会话直接复用，M4.2 不要求重新启动；空目录不是沙箱。M4.1 复用目标环境、路线与模型均未变化且无新失败信号的 GPT 成功回答，不重复登录或提问；已配置但无回答时仍须实际验证，只有缺少授权或实际鉴权失败才处理登录，不能将网络超时、限额或模型不可用直接归因于凭据失效，不为常规验证退出账号、删除或覆盖凭据。
@@ -38,7 +38,24 @@

 ## 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。若 Android 用户尚未安装 Termux，说明其官方来源与安装影响，并等待用户明确决定；这一步只准备终端，不代表 Pi 已安装。若 Termux 来源不明，先按上文官方路线核对并等待用户决定。
+
+若用户已有终端，先确认实际 shell；Windows 原生 PowerShell 与 WSL/Linux shell 是不同环境，命令须按实际终端选择。终端就绪后才检查现状。不要为安装 Pi 默认要求 WSL、Git、Python、编辑器、代理或项目依赖。

 若用户已在计划使用 Pi 的终端回报 `pi --version` 结果，直接复用：版本号记作 M3，跳过安装专用 M1/M2；错误结果按下文对应分支处理（只有下文条件满足时才重试）。只有该终端尚无检查结果时，确认环境后，让用户单独运行：

@@ -258,6 +258,8 @@ class SourceArchiveTest(unittest.TestCase):
            '已弃用的 Google Play 版本',
            'Termux 包升级、依赖安装或共享存储授权前',
            '共享存储仅在确需访问 Android 文件时配置',
+            '若 Android 用户尚未安装 Termux，说明其官方来源与安装影响，并等待用户明确决定',
+            '若 Termux 来源不明，先按上文官方路线核对并等待用户决定。',
            '这一步只准备终端，不代表 Pi 已安装',
            'Android/Termux 路线按 M0 链接的官方 Termux 指南处理',
            'Termux 包管理器安装 Node.js 和 Git',
@@ -352,6 +354,7 @@ class SourceArchiveTest(unittest.TestCase):
            with self.subTest(prompt_contract=contract):
                self.assertIn(contract, prompt)
        self.assertNotIn('确认环境后，让用户在计划使用 Pi 的终端单独运行：', prompt)
+        self.assertNotIn('若尚未安装，说明其官方来源与安装影响', prompt)
        self.assertNotIn('先确认用户有权使用 OpenAI API', prompt)
        self.assertNotIn('完成 OpenAI GPT 主路线（ChatGPT 订阅 OAuth 或 OpenAI API Key）的授权后，让用户用 `/model` 选择该路线实际可用的 GPT 模型，并提出一个无需修改文件的简单问题。', prompt)
        self.assertNotIn('curl -I https://github.com', prompt)