docs: god - 明确从 Chat 到 Work 的能力递进 (#209)

2026-11-02 12:56:17 +00:00 · 2026-10-23 00:12:04 +08:00
parent e1b71fc29d
commit 3d7198bd35
7 changed files with 53 additions and 27 deletions
@@ -9,14 +9,14 @@
 | 文件 | 职责 |
 |---|---|
 | `getting-started-README.md` | 入门索引 |
-| `god.md` | 《道成了肉身》：以经文题名组织、可全文复制给网页版 AI 的 Pi CLI 安装配置提示词 |
+| `god.md` | 《道成了肉身》：以经文题名组织、由网页 Chat 引导准备 Pi 并验证基础 Work 通路的完整提示词 |
 | `first-project.md` | 可选的本地项目闭环练习 |
 | `getting-started-AGENTS.md` | 本组维护规则 |

 ## 修改规则

 - 根`README.md`是唯一主页；`getting-started-README.md`只做导航，不复制完整教程。
- `god.md` 本身就是给网页版 AI 的完整提示词：指导用户从现状检查到 CLI 安装、模型配置和安全的本机工具验证；用户复制全文后由 AI 一轮一步引导，并在 Agent 能力验收后停止。不另维护重复的提示词区块或项目开发步骤。
+- `god.md` 本身就是给网页版 Chat AI 的完整提示词：先引导用户检查现状、准备 Pi 和连接模型，再让用户在本机 Pi 中发起安全的工具验证；网页 AI 只核对用户回报，不能冒充本机执行。Chat/Work 是使用方式的教学分类，不是 Pi 的正式模式；区分模型回答与工具执行，完成基础通路验收后停止，不承诺所有任务自动化，不另维护重复提示词或项目开发步骤。
 - `god.md` 的叙事题名与经文引文仅用已核验的《圣经》和合本简体（CUVS）原句，注明书卷、章节、版本与原页；连续节录须注明，不拼接或改写经文。保留原语境，技术对应另作说明，不以引用或比喻增加执行授权、权限或效果承诺。标题变化保留必要旧锚点，并同步读者入口。
 - 安装方式、Node.js 版本要求、系统支持和 provider 流程以 Pi 当前官方文档与安装入口为准；链接及命令须明确系统、终端、影响和成功判断。官方资料未说明的内容标为未知，不猜测。
 - 区分 `pi --version`、模型授权/可用和项目任务完成；不把 CLI 安装说成模型已接通或项目环境已就绪。
@@ -2,15 +2,15 @@

 ## 字多不看

- [道成了肉身：Pi CLI 安装配置提示词](god.md)全文可复制到网页版 Chat AI；AI 会逐步引导用户检查并安装 Pi、配置模型、验证本机工具，达标后停止。
- `pi --version` 只证明 CLI 可用；模型回答与本机工具调用还需分别验证，项目依赖和第一个项目则是独立的后续事项。
+- [道成了肉身：Pi CLI 安装配置提示词](god.md)全文可复制到网页版 Chat AI：先通过对话获得准备指导，再由本机 Pi 调用工具，建立从 Chat 走向 Work 的基础通路。
+- `pi --version` 只证明 CLI 可用；模型回答不等于 Work 执行能力，必须另看真实工具调用。项目依赖和第一个项目仍是独立的后续事项。
 - [第一个项目](first-project.md)是可选练习，不是安装条件。

 ## 快速导航

 | 文档 | 定位 |
 |:---|:---|
-| <a id="learning-map"></a>[道成了肉身：Pi CLI 安装配置提示词](god.md) | 可全文复制给网页版 AI 的安装配置提示词：按条件检查、分平台安装、模型配置和本机工具验收；达标即停止。 |
+| <a id="learning-map"></a>[道成了肉身：Pi CLI 安装配置提示词](god.md) | 从 Chat 引导准备 Pi，到接通模型并验证基础 Work 执行能力；区分对话、工具调用与任务完成，达标即停止。 |
 | <a id="first-project"></a>[第一个项目（可选练习）](first-project.md) | 用本地待办清单练习需求、运行、验收和 Git 保存。 |
 | <a id="vibe-coding-experience"></a>[Vibe Coding 经验](context/gongfa/README.md#doc-vibe-coding-experience) | 功法文集：理解人机分工、验证和质量边界。 |

@@ -19,7 +19,7 @@

 ### 细粒度目录

- [道成了肉身：Pi CLI 安装配置提示词](god.md) - 全文复制给网页版 AI，逐步引导本机安装并配置 Pi CLI；包含官方来源、条件依赖和完成验收。
+- [道成了肉身：Pi CLI 安装配置提示词](god.md) - 全文复制给网页版 Chat AI，准备 Pi 并接通模型，再以实际工具调用验证基础 Work 能力；包含官方来源、条件依赖和完成验收。
 - [第一个项目（可选练习）](first-project.md) - 用本地待办清单练习运行、验收和 Git 保存。
 - [Vibe Coding 经验](context/gongfa/README.md#doc-vibe-coding-experience) - 功法文集：理解人机分工、验证和质量边界。

@@ -28,9 +28,9 @@
 ## 使用方式

 - 完全新手将[道成了肉身：Pi CLI 安装配置提示词](god.md)全文复制到可用的网页版 AI，由 AI 从系统检查开始；已有 Pi 的用户先运行 `pi --version`，成功就不必重装。
- 安装、模型和本机工具问题由 AI 按提示词逐步处理；项目工具配置不属于安装提示词范围。
+- 网页 Chat AI 负责安装引导和核对回报，用户在本机 Pi 中发起工具验证；网页 AI 不冒充已操作用户设备，项目工具配置不属于本篇范围。
 - 需要固定练习时再做[第一个项目](first-project.md)；想了解通用协作原则时按需读[Vibe Coding 经验](context/gongfa/README.md#doc-vibe-coding-experience)。

 ## 正文

-本组文件的 Pi CLI 检查、安装、模型配置和本机工具验收统一维护于可全文复制的[道成了肉身：Pi CLI 安装配置提示词](god.md)。文档本身就是给网页版 AI 的操作指令，不另附重复提示词；项目练习继续独立且可选。
+本组文件的 Pi CLI 检查、安装、模型配置和本机工具验收统一维护于可全文复制的[道成了肉身：Pi CLI 安装配置提示词](god.md)。文档本身就是从 Chat 引导走向基础 Work 验证的完整提示词，不另附重复提示词；只读命令检查不证明所有工作已自动化，项目练习继续独立且可选。
@@ -9,9 +9,19 @@
 >
 > ——《约翰福音》1:14，[和合本CUVS](https://www.biblegateway.com/passage/?search=John%201%3A14&version=CUVS)

-Pi CLI 安装配置与安全能力验证的网页版 AI 单步引导提示词。
+从 Chat 引导走向 Work 基础能力验证的 Pi CLI 安装配置提示词。

-这节经文原指基督的道成肉身。本文只借其叙事意象，说明从模型回答到工具行动的技术过程，不把 AI 认作神，也不把软件组件与圣父、圣子、圣灵一一对应。
+**本文说明（非经文）：**
+
+Chat 模式，让你获得与神对话的能力；Work 模式，让神的能力为你所用。
+
+先从易于获取、门槛较低的 Chat 模式入手，通过对话获得答案与指导；再借助 Pi 接通模型和工具，进入 Work 模式，让 AI 在授权范围内直接执行任务。
+
+这一转变的核心，是从“AI 给出答案，人手工落实”，跨越到“AI 通过工具执行，用户检查结果”，实现从手工时代到自动化时代的跃迁。这里的跃迁指执行方式的变化，不是保证所有工作都会自动成功。
+
+Chat 与 Work 是本文对两种使用方式的分类，不是 Pi 官方新增的按钮、命令或运行模式。Chat 以答案和指导为产出，操作仍由用户落实；Work 由模型通过已授权工具产生实际动作。分界在于工具执行，而不在于网页还是终端。自动化不意味着无需用户授权、无需验收，或所有任务都能无人值守完成。
+
+开篇所引《约翰福音》1:14 原指基督的道成肉身。本文只借其叙事意象，说明从模型回答到工具行动的技术过程，不把 AI 认作神，也不把软件组件与圣父、圣子、圣灵一一对应。

 模型理解输入并生成工具请求；Pi 将请求交给工具执行，再把真实结果反馈给模型。计算机承载程序运行，Pi 本身就是 Agent Harness；规则、知识与扩展是在其上按需配置的资源，不会使模型全知全能。使用云端模型也不表示模型本体被安装进本机。

@@ -23,17 +33,19 @@ Pi CLI 安装配置与安全能力验证的网页版 AI 单步引导提示词。

 ## 字多不看

- 默认用户当前没有可用的本地 Agent，但可能已经安装了 Pi；先检查，不盲目重装。
- 引导目标是让用户在选定的系统和终端中安装并配置 Pi CLI，使其能连接一个用户有权使用的模型，并实际完成一次安全的本机工具调用。
- `pi --version` 只证明 CLI 可用；模型授权、模型回答和本机工具调用是不同的验收信号。
- 本提示词结束于 Pi Agent 能力验证，不指导用户完成项目任务；项目依赖按具体项目另行决定。
+- 本篇先用网页 Chat 引导完成准备，再由本机 Pi 验证基础 Work 执行能力；不是换一个聊天窗口，也不是增加一个模式开关。
+- 默认用户当前没有可用的本地 Agent，但可能已经安装了 Pi；先检查，跳过已有能力，不盲目重装。
+- `pi --version` 只证明 CLI 可用；模型回答只证明对话能力已接通；真实本机工具调用才是基础 Work 执行能力的证据。
+- 本提示词结束于基础通路的建立与验证，不指导用户完成项目任务；一次命令检查不证明文件读写、所有工具或业务工作都已自动化。项目依赖按具体项目另行决定。
 - 常规安装/更新和云端模型需要网络；已安装 CLI 的 `pi --version` 是本地检查，准备好的本地模型在无需远端服务时可能离线工作。安装源与模型服务分开；不要预设 WSL、Git、Python、编辑器、代理或项目依赖是通用前提。

 ## 你的任务与完成标准

 你是网页版 Chat AI，负责指导用户在自己的设备上完成 Pi CLI 的安装和首次配置。你不能读取或操作用户的终端；所有本机结果都必须由用户实际运行并回报。不得声称你已替用户运行、检查或验证命令。

-只有满足以下条件，才报告“本机 Agent 能力已验证”：
+Chat 引导阶段由你提供检查、安装和认证指导，用户在本机执行并回报脱敏结果。进入工具验证时，把本文的只读要求交给用户，让用户在本机 Pi 对话中发起；实际执行者是本机 Pi 及其工具。你只根据用户回报核对证据，不把网页 AI 的说明或自称完成当作本机执行。
+
+只有满足以下条件，才报告“本机 Agent 能力已验证（基础通路已建立；仅本机命令工具）”：

 1. 用户在计划使用的终端运行 `pi --version`，看到版本号。
 2. 用户在 Pi 中完成所选云端或本地模型路线的必要授权/配置，`/model` 能选中可用模型，且模型对一个不要求修改文件的简单问题作出回答。
@@ -55,6 +67,8 @@ Pi CLI 安装配置与安全能力验证的网页版 AI 单步引导提示词。

 经文原在讨论教会聚会的秩序。以下借其题名强调单步引导；具体检查与命令仍按用户的环境和实际结果推进。

+本节约束网页版 Chat AI 的安装引导。用户在 Pi 中发起的工具验证由本机 Pi 执行；这不允许网页 AI 冒充已读取或操作用户设备，也不增加任何执行授权。
+
 1. **先了解环境，再给命令。**第一轮只确认用户使用的操作系统和终端，然后等待；不要在同一条回复附命令或后续步骤。若用户不清楚，下一轮再帮助识别或打开合适终端。确认环境后，另起一轮引导运行 `pi --version`。
 2. **每轮只做一步。**每次只给一个检查或一条命令，说明在哪个终端运行、目的、可能影响和成功信号，然后停下来等用户实际结果。不要一次贴出所有平台命令或长命令串。
 3. **只按结果推进。**已有 CLI 就跳过安装；命令未找到先做只读 PATH/安装位置检查。不要因为模型未授权而重装 CLI，也不要因安装问题转去改代理。
@@ -69,7 +83,9 @@ Pi CLI 安装配置与安全能力验证的网页版 AI 单步引导提示词。

 ## 依赖图与引导阶段

-图中的路线按条件推进，不要求用户重复已完成的阶段。M0–M4 属于 Pi CLI 安装与 Agent 能力建立；最后的本机工具检查是完成验收的一部分。
+本图展示从 Chat 引导到基础 Work 验证的准备路线，不要求用户重复已完成的阶段。M0–M3 准备并验证 Pi 运行载体；M4.1 验证模型回答，仍属于对话能力；M4.2 以真实工具调用验证基础执行能力。
+
+图中“本机 Agent 能力已验证”仅指本篇限定的基础通路，不代表文件读写、全部工具或业务任务的自动化已经验证。

 ```mermaid
 flowchart TD
@@ -92,7 +108,8 @@ flowchart TD
 | M1：选择路线 | 仅在没有可用 CLI 且用户决定安装时进入；确定原生系统/已使用的 WSL、官方安装器/npm/已有 Nix 路线及网络条件。 | 用户知道所选路线会用到的依赖和可能副作用，并决定继续。 |
 | M2：安装 CLI | 按所选系统给出对应官方命令；每个安装器提示由用户阅读和决定。 | 安装器报告完成；安装成功本身还不是最终验收。 |
 | M3：验证 CLI | 在准备使用 Pi 的同一终端运行版本检查。 | `pi --version` 输出版本号。 |
-| M4：模型与 Agent 能力 | 在 Pi 本地完成提供方授权/配置、选择模型、测试回答；再用 Pi 的本机工具做一次只读调用。 | 用户观察到真实模型回答和真实本机工具调用结果。 |
+| M4.1：对话能力 | 在 Pi 本地完成提供方授权/配置、选择模型并测试回答。 | 用户观察到真实模型回答；尚无工具执行证据。 |
+| M4.2：基础 Work 能力 | 用户在本机 Pi 中发起限定的只读工具检查。 | 用户看到实际本机工具调用及其结果；只验证本次命令工具。 |

 <a id="准备与系统要求"></a>
 <a id="milestone-0"></a>
@@ -222,7 +239,9 @@ pi --version

 经文原在说明教会中恩赐、职事与功用的分别。本阶段的技术说明区分模型回答与工具行动：模型能回应，不等于本机工具已经可用；能调用工具，也不保证任务结果正确。先接通模型，再分别察验回答与工具调用，不因其中一项成功就宣称全部能力就绪。

-#### 选择并授权模型
+<a id="选择并授权模型"></a>
+
+#### M4.1：验证对话能力（选择并授权模型）

 先问用户希望使用哪条路线，以及是否已有可用的提供方授权或本地模型；不要默认替用户选择付费或需额外注册的服务。

@@ -246,9 +265,12 @@ pi --version

 **模型成功信号：**用户确认 Pi 在所选模型下对简单问题返回实际回答。仅 CLI 通过而模型没有回答时，仍未完成 Agent 配置；根据实际报错排查提供方、授权或网络，不要重新安装 CLI。

-<a id="安全地检查本机工具"></a>
+这一结果只证明 Pi 中的对话能力已接通，尚不能报告基础 Work 能力已验证。接下来要观察真实工具执行，而不是再问一次模型是否具备工具能力。

-#### 凡事察验（安全地检查本机工具）
+<a id="安全地检查本机工具"></a>
+<a id="凡事察验安全地检查本机工具"></a>
+
+#### M4.2：凡事察验（验证基础 Work 能力）

 > “凡事察验”
 >
@@ -256,6 +278,8 @@ pi --version

 这句话原在关于圣灵感动与先知讲论的劝勉中。本文借用“察验”组织工具验证：要看真实调用及其结果，不把模型自称完成当作证据。下面的固定文本检查只验证本机命令工具，不证明文件读写、其他工具、整体任务效果或权限隔离已经验证。

+这一步是本文从 Chat 走向基础 Work 的转折：不再由用户复制 AI 给出的命令到 shell 执行，而是由本机 Pi 的工具执行限定动作，用户检查调用记录与结果。网页 Chat AI 仍只负责引导和核对用户回报。
+
 模型能回答后，提醒用户尽量在一个自己选择的空目录或非敏感目录启动 Pi，避免把敏感文件或陌生项目指令带入本次测试。**这只降低当前工作目录和项目上下文风险，不是沙箱，也不限制 Pi 通过工具访问当前账户可访问的其他路径（参见[Pi 官方安全说明](https://pi.dev/docs/latest/security)）。**不要因空目录而放宽命令审阅，也不要向网页 AI 披露本机路径。然后让用户在 Pi 对话中发送以下只读要求：

 ```text
@@ -271,7 +295,7 @@ pi --version
 - **macOS/Linux/WSL：**根据 Pi 的实际错误确认当前系统是否提供可发现的 Bash。只在用户同意且确有需要时指导配置，不猜测路径。
 - 如果用户不需要本机命令能力或选择不配置，报告“CLI 与模型已可用，但本机命令工具未验证/不可用”，不要宣称完整 Agent 能力已就绪。

-完成 M4 后，简要报告每项实际证据：目标系统/终端（不含隐私路径）、`pi --version` 是否通过、模型回答是否通过、本机工具调用是否通过、仍未解决的问题。然后停止。
+完成 M4 后，简要报告每项实际证据：目标系统/终端（不含隐私路径）、`pi --version` 是否通过、M4.1 模型回答是否通过、M4.2 本机工具调用是否通过、仍未解决的问题。三项检查均通过时，说明“基础通路已建立：模型能够回应，本机命令工具能够执行”；同时注明尚未验证文件读写、其他工具或业务任务的自动化。然后停止。

 <a id="post-install-use"></a>
 <a id="milestone-5"></a>
@@ -279,7 +303,9 @@ pi --version

 ## 完成后：本提示词的边界

-安装、模型回答和本机工具检查完成后，本次引导即结束。不要继续创建项目或安装项目工具；后续项目练习是独立选择，可参考[第一个项目](first-project.md)。旧锚点 `milestone-5` 与 `post-install-use` 仅保留兼容跳转，不表示本提示词包含项目实施步骤。
+只有安装、模型回答和本机工具三项检查均通过，才能说明从 Chat 走向 Work 的基础通路已经建立：模型能够回应，本机命令工具能够执行；这不是“所有工作已经自动化”的证明。若用户提前停止，或其中一项未通过，只报告已完成与未完成的能力，不宣称基础通路已建立。
+
+接下来，每一种具体工作的自动化，都需要对应的工具、授权与结果验收。本文不继续创建项目或安装项目工具；后续项目练习是独立选择，可参考[第一个项目](first-project.md)。旧锚点 `milestone-5` 与 `post-install-use` 仅保留兼容跳转，不表示本提示词包含项目实施步骤。

 ## 常见问题

@@ -50,7 +50,7 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链
 - .github/context/README.md：知识库总索引，提供新手、开发者、思维模型和 AI Agent 读取路径。
 - .github/getting-started-README.md：入门索引，链接可全文复制给网页版 AI 的 Pi CLI 安装配置提示词与可选项目练习；通用Vibe Coding经验正文见 .github/context/gongfa/README.md#doc-vibe-coding-experience。
 - .github/context/gongfa/README.md#doc-vibe-coding-experience：Vibe Coding 的核心经验入口，包含通用语言能力、人机分工、机器门禁和入门铁律。
- .github/god.md：《道成了肉身》，以《圣经》和合本原句组织叙事、区分经文原义与技术说明的 Pi CLI 安装配置提示词；可全文复制给网页版 AI，逐步引导现状检查、分平台安装、模型配置和本机工具验证；达到 Agent 能力验收后停止，不展开项目任务。
+- .github/god.md：《道成了肉身》，以《圣经》和合本原句组织叙事、区分经文原义与技术说明的 Pi CLI 安装配置提示词；先由网页 Chat 引导准备 Pi 和连接模型，再由本机 Pi 的实际工具调用验证基础 Work 通路。Chat/Work 是使用方式分类，不是 Pi 的正式模式；模型回答不等于工具执行，一次命令检查不证明所有工作自动化，验收后停止，不展开项目任务。
 - 原 Codex 全局配置基线及安装/恢复脚本已按用户要求移除；历史 Codex 研究资料仅保存在本机副本，不作为 Pi 安装路线。
 - .github/first-project.md：可选的本地待办清单练习，用于走通需求、实现、运行、验收和 Git 保存。
 - .github/context/gongfa/README.md：按理解、求解、设计、实现、验证、转化和内容身份导航的统一功法文集。
@@ -66,12 +66,12 @@ reading_paths:
 selection_rules:
  faqi: 需要理解 Vibe Coding 工具/依赖分类、重要性分级或效能边界时，读法器体系说明，再核生成总表与登记事实。
  gongfa: 需要认知模型、问题求解、工程准则、架构模板、方法、流程、门禁或研究转化时统一读取；文集与独立功法记录分开。
-  getting-started: 需要把 Pi CLI 安装配置提示词复制给网页版 AI，逐步引导本机检查、安装、模型配置及 Agent 能力验收时读取；项目练习独立可选，通用经验链接到功法。
+  getting-started: 需要先由网页 Chat 引导准备 Pi、接通模型，再通过本机工具调用验证基础 Work 通路时读取；项目练习独立可选，通用经验链接到功法。
 documents:
  getting-started:
  - path: .github/god.md
    title: 道成了肉身：Pi CLI 安装配置提示词
-    role: 可全文复制到网页版 AI，逐步引导本机现状检查、分平台安装、模型授权及本机工具验证，并在 Agent 能力验收后停止
+    role: 可全文复制到网页版 Chat AI，逐步引导本机准备和模型授权，再由本机 Pi 的真实工具调用验证基础 Work 通路；区分对话能力、执行证据与业务任务完成，验收后停止
  - path: .github/first-project.md
    title: 第一个项目
    role: 可选的本地练习：走通需求、实现、运行、验收和 Git 保存