docs: god - 按现状复用授权与模型验证证据 (#230)

.github/getting-started-AGENTS.md

@@ -19,7 +19,7 @@
 - `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 排版，标题、段落和链接直接渲染；仅命令和对话示例保留独立代码块，不用外层围栏包住全文。整篇使用 GitHub 文件页右上角的原生全文复制按钮。移除折叠标签、HTML 锚点和页内章节链接；入站链接及历史重定向直接指向 `god.md`，文集链接不生成失效片段。修改时保留经文、操作流程、安全边界和完成标准。经文仅用已核验的《圣经》和合本简体（CUVS）原句，注明书卷、章节、版本与原页；连续节录须注明，不拼接或改写。保留原语境，技术对应另作说明，不以引用或比喻增加执行授权、权限或效果承诺。
 - 安装方式、Node.js 版本要求、系统支持和 provider 流程以 Pi 当前官方文档与安装入口为准；链接及命令须明确系统、终端、影响和成功判断。官方资料未说明的内容标为未知，不猜测。
-- 区分 `pi --version`、模型授权/可用和项目任务完成；不把 CLI 安装说成模型已接通或项目环境已就绪。模型授权前，M4.0 先说明目录资源加载、会话保存与信任提示的影响，再引导用户在目标终端用 `pi` 进入交互界面；`/login`、`/model` 和问题在 Pi 输入框而非系统终端或网页版 AI 输入。已有目标目录的 Pi 会话直接复用，M4.2 不要求重新启动；空目录不是沙箱。
+- 区分 `pi --version`、模型授权/可用和项目任务完成；不把 CLI 安装说成模型已接通或项目环境已就绪。模型授权前，M4.0 先说明目录资源加载、会话保存与信任提示的影响，再引导用户在目标终端用 `pi` 进入交互界面；`/login`、`/model` 和问题在 Pi 输入框而非系统终端或网页版 AI 输入。已有目标目录的 Pi 会话直接复用，M4.2 不要求重新启动；空目录不是沙箱。M4.1 复用目标环境、路线与模型均未变化且无新失败信号的 GPT 成功回答，不重复登录或提问；已配置但无回答时仍须实际验证，只有缺少授权或实际鉴权失败才处理登录，不能将网络超时、限额或模型不可用直接归因于凭据失效，不为常规验证退出账号、删除或覆盖凭据。
 - 不把 WSL、Git、Python、编辑器、代理或项目依赖设为 Pi CLI 安装的通用前置条件。Windows 原生 Git Bash 是内置 Bash 工具的命令环境，不是 CLI 安装本身的要求。
 - 可达网络是 Pi 安装/更新和 OpenAI 云端 GPT 路线的基础条件；提示词按用户选择的订阅 OAuth 或 API Key 路线确认实际目标可达，再安装或登录。普通网络可达时跳过代理；只在具体官方分发源或模型服务确实不可达时，才逐步处理网络配置。FlClash 与历史服务商注册链接仅为条件路线，须标明来源和未核验边界；注册链接不是个人订阅链接，个人订阅 URL 属于凭据，只能由用户在本机 FlClash 导入。用户选择 FlClash 路线后，默认目标配置为开启 TUN、系统代理和全局模式；启用前说明流量路由范围、隐私与网络影响、权限和恢复路径，等待用户确认；用户拒绝时不得报告该路线已完成。不默认购买服务。关闭 TLS 或使用非官方源一律不作为排障方案。
 - 不要求用户把密码、API Key、Token、cookie、订阅链接或私钥贴给网页 AI。Pi 以启动账户权限运行，不是安全沙箱；提醒用户不要用管理员/root 启动并审阅实际命令与改动。

.github/god.md

@@ -132,7 +132,15 @@ pi
 
 ### M4.1：验证对话能力
 
-本提示词的云端主路线是 OpenAI GPT；Pi 的 `/login` 可使用两条不同的登录路线：ChatGPT 订阅 OAuth 与 OpenAI API Key。先询问用户希望使用且有权使用哪条路线；若不确定，说明订阅 OAuth 使用其账号可用的订阅额度，API Key 则使用单独的 API 账户与计费，再等用户选择。模型可用性、额度与费用按用户账号、Pi 当前提供方列表和 OpenAI 规则核对；两条路线彼此独立，不静默切换。[ChatGPT 网页订阅不等于 OpenAI API 额度](https://help.openai.com/en/articles/9039756-managing-billing-for-chatgpt-and-the-api-platform)。
+本提示词的云端主路线是 OpenAI GPT；Pi 的 `/login` 可使用两条不同的登录路线：ChatGPT 订阅 OAuth 与 OpenAI API Key。先询问用户希望使用且有权使用哪条路线；已明确的选择直接复用，不重复询问。若不确定，说明订阅 OAuth 使用其账号可用的订阅额度，API Key 则使用单独的 API 账户与计费，再等用户选择。模型可用性、额度与费用按用户账号、Pi 当前提供方列表和 OpenAI 规则核对；两条路线彼此独立，不静默切换。[ChatGPT 网页订阅不等于 OpenAI API 额度](https://help.openai.com/en/articles/9039756-managing-billing-for-chatgpt-and-the-api-platform)。
+
+进入本节不等于必须重新登录。先按用户回报的现状分支处理；只复用目标环境、用户选定路线和模型均未变化且没有新失败信号的证据：
+
+- **已有实际 OpenAI GPT 成功回答：**复用证据，直接进入 M4.2，不重复 `/login`、模型选择或同类提问。
+- **已配置但尚无成功回答：**先在 `/model` 核对所选路线实际可用的 GPT，再做本节末尾的简单提问；列表有模型或界面显示已授权，都不等于真实调用成功。
+- **尚未授权或出现实际鉴权失败：**按下文所选路线登录。网络超时、限额或模型不可用先按对应错误排查，不直接当成凭据失效。用户要更换账号或路线时，先说明影响并等待明确决定；不要为常规验证先 `/logout`、删除 `auth.json` 或覆盖既有凭据。
+
+以下登录步骤仅在确需授权时使用：
 
 - **ChatGPT 订阅 OAuth：**若用户的 ChatGPT 账号可使用此路线，且当前 Pi 的 `/login` 列出 `OpenAI (ChatGPT subscription)`，选择它在本机完成授权（provider ID：`openai-codex`），再用 `/model` 查看此路线实际提供的模型。订阅额度和可用模型以当前账号与提供方显示为准；这不是 OpenAI API Key，也不提供 API 额度。若登录列表没有该项，先核对当前 Pi 版本与官方资料，不静默更新，也不把订阅当作 API 权限；可选 API Key 路线须由用户明确选择且确有 API 访问权限，否则说明阻塞并等待决定。
 - **OpenAI API Key：**仅在用户明确选择且有 API 访问权限时，在本机 `/login` 选择 OpenAI API Key 路线并按 Pi 当前界面授权；API 计费按 API 账户规则单独核对。不得要求用户把密钥贴给网页 AI，也不得静默改用其他提供方。
@@ -141,7 +149,7 @@ pi
 
 网络检查按用户选定的登录路线及实际错误处理。API 端点检查只用于 API Key 路线；只有用户选 API Key 路线且确有 API 端点连通问题时，才可用 POSIX shell 的 `curl --connect-timeout 5 --max-time 15 -i https://api.openai.com/v1/models` 或 PowerShell 的 `curl.exe --connect-timeout 5 --max-time 15 -i https://api.openai.com/v1/models` 做无凭据端点检查；不要在测试命令里加入 API Key 或 Authorization。订阅 OAuth 路线不使用 `api.openai.com/v1/models` 探测，按 Pi 当前登录流程和该路线的脱敏错误核对。收到 HTTP 响应（包括认证错误）只说明 API 端点有响应，不证明账户认证或 GPT 模型可用；真实验证仍须由 Pi 完成所选路线的授权并取得模型回答。Pi 官方 Providers 文档说明 Pi 会将已存凭据保存在 `auth.json`；其中可能包含 API Key 或 OAuth Token，须保持私密，绝不贴给网页 AI、提交、上传、复制到项目文件、脚本、shell 配置或截图，也不要把 `auth.json` 发给任何人。额外安装、下载或开放服务前说明影响并等用户决定。
 
-完成 OpenAI GPT 主路线（ChatGPT 订阅 OAuth 或 OpenAI API Key）的授权后，让用户用 `/model` 选择该路线实际可用的 GPT 模型，并提出一个无需修改文件的简单问题。真实模型回答才是 M4.1 的 OpenAI GPT 成功信号；CLI 已安装、浏览器可访问 OpenAI 或 FlClash 显示已连接，都不单独证明模型已接通。若用户只完成本地模型路线，按前述规则单独记录，不静默切回 OpenAI GPT。按所选路线的授权状态、账户可用性和脱敏网络错误排障，不重新安装 CLI。
+尚无可复用成功回答时，先完成必要授权和所选路线的 GPT 模型确认，再让用户提出一个无需修改文件的简单问题；授权、`/model` 确认/选择和提问分轮处理，已完成的动作不重复。真实模型回答才是 M4.1 的 OpenAI GPT 成功信号；CLI 已安装、浏览器可访问 OpenAI 或 FlClash 显示已连接，都不单独证明模型已接通。若用户只完成本地模型路线，按前述规则单独记录，不静默切回 OpenAI GPT。按所选路线的授权状态、账户可用性和脱敏网络错误排障，不重新安装 CLI。
 
 ### M4.2：凡事察验（完成一次实际工具使用验证）
 

.github/test-source-archive.py

@@ -312,6 +312,15 @@ class SourceArchiveTest(unittest.TestCase):
             '`/login`、`/model` 和问题均在 Pi 输入框中输入，不是在系统终端或网页版 Chat AI 中运行。',
             '沿用 M4.1 已验证模型的 Pi 会话，不为工具验证重新启动',
             '不自动批准目录信任提示',
+            '进入本节不等于必须重新登录。',
+            '目标环境、用户选定路线和模型均未变化且没有新失败信号',
+            '直接进入 M4.2，不重复 `/login`、模型选择或同类提问',
+            '先在 `/model` 核对所选路线实际可用的 GPT，再做本节末尾的简单提问',
+            '列表有模型或界面显示已授权，都不等于真实调用成功',
+            '网络超时、限额或模型不可用先按对应错误排查，不直接当成凭据失效',
+            '不要为常规验证先 `/logout`、删除 `auth.json` 或覆盖既有凭据',
+            '以下登录步骤仅在确需授权时使用',
+            '已完成的动作不重复',
             'Pi 的 `/login` 可使用两条不同的登录路线',
             '`OpenAI (ChatGPT subscription)`',
             '`openai-codex`',
@@ -338,6 +347,7 @@ class SourceArchiveTest(unittest.TestCase):
                 self.assertIn(contract, prompt)
         self.assertNotIn('确认环境后，让用户在计划使用 Pi 的终端单独运行：', 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)
         self.assertNotIn('curl.exe -I https://github.com', prompt)
         self.assertNotIn('curl -i https://api.openai.com/v1/models', prompt)