第六章实战初稿读者视角自审

日期：2026-10-17。正文：认识 Foggy，准备第一个问数项目。状态：已自审，待用户审阅；第七章尚未开始。

阅读检查与修改

• 承接第五章的系统分工，进入具体产品后只解释 TM、QM、DSL、Runtime、Launcher、CLI、Skill 各自做什么，不重复第三章的语义层原理。
• 补上 Launcher 的含义，区分 Codex 提供 LLM 能力、Skill 提供操作指导、Runtime 执行语义定义，避免读者以为启动 Runtime 还必须另配 AI Provider。
• 项目范围保持一张表，Chinook 的金额和状态另行确认；没有将技术篇的分转元、有效发票状态或人民币口径搬进新样例。
• 正文保留给 Codex 的任务、关键命令、实际输出摘要和验收。安装与校验脚本放配套目录；明确首次启动顺序与已有环境复查的区别。
• CLI 0.1.24 的 Python 最低要求来自实际 wheel 元数据；本机现有 Skill 含定制，正文不声称安装的是未经修改的 0.1.18 正式包。
• 第六章停在环境、数据源与表发现，表关系和口径留第七章，语义模型与首次问数留第八章。结尾不重复项目范围与组件清单。

实际验证范围

独立 CLI 0.1.24 安装、Launcher 0.1.24 的 JAR/脚本/manifest 校验、Java 17 启动、CLI readiness/capabilities、Chinook 副本连接、Namespace 绑定、命名与绑定两种方式的 11 张表发现均通过。运行进程仅监听 127.0.0.1:18067。

停止并重启本项目进程后，未重新注册或绑定，连接与表发现再次通过。注册文件路径由实际启动参数和 diagnostics 确认。准备脚本遇到的 SQLite 共享读取问题已修正并复查。

本轮没有创建 TM/QM、执行语义查询、接入 Console/FAP 或验证业务身份权限。首次安装 Skill 的两条命令是给新读者的说明，本机已有安装未覆盖；没有另起干净 Codex 会话验证全新安装发现。证据与完整步骤见环境复跑说明。

开篇与桌面端入口调整（2026-10-18）

• 开头先说明 Foggy 的定位和独立服务用法，再给术语表，随后进入 Chinook 与工具；消除先要求使用工具、后介绍引擎的倒置。
• 官方 Windows 桌面端文档确认本地 Codex/PowerShell 路线；Work 本地访问文档确认文件与 shell 工具可用时可调用本机 CLI。正文将 ChatGPT 桌面端方案限定为具备本地执行能力的任务，不默认所有聊天都有终端能力。
• 现有实测仍标为 Codex；未切换客户端、重启 Runtime 或声称 ChatGPT Work 已单独验收。只调整正文，后续工具主线尚未整体替换。

精简 Runtime 与 Launcher 的呈现（2026-10-18）

术语表合并为“Foggy 服务（Runtime）”，用一句话说明“下载 Launcher 发行包，启动后得到 Runtime 服务”。后文操作说明统一称“Foggy 服务”，保留版本名和响应字段原名，避免读者误以为要部署两个组件。本次仅修改文案，命令与运行环境未变。

改为读者与 AI 协作流程（2026-10-18）

按用户要求，正文不展开终端种类、组件补丁版本和安装命令，改为“读者准备 → 发给 Codex 的任务 → Codex 行动与预期结果 → 本次验收”。Python、Java 只保留必要要求，原始命令与环境事实仍在配套说明中。

工具选用说明改为作者已有订阅、利用订阅额度减少额外 API 开销，不写成减少模型实际消耗的 token 或无限使用。补充 DeepSeek Harness 等具备本地文件与命令能力的工具可采用同类流程，未将其与 Foggy 的兼容性写成已实测。依据为 OpenAI 订阅说明、DeepSeek 官方仓库及 terminal 组件说明。

读回检查保留原件路径、练习副本、固定版本、数据源名、Namespace、失败处理、11 张表和证据入口；没有新增环境操作，也未进入第七章。

补齐没有 Skill 时的首次入口（2026-10-18）

正文补稳定清单固定链接与最新发布页，不再假定读者已有 Skill 或 CLI。任务先读取清单、下载校验并阅读 Skill，再通过包内指引准备 CLI、安装 Skill 和下载服务资源，避免“先装 CLI 才能获得安装 CLI 指引”的循环。

首次安装按当前推荐稳定组合选择资源，安装后记录固定版本；0.1.24 只保留为已执行的教学记录与固定复跑入口。现场核对稳定清单及 GitHub latest 发布元数据，二者当前均指向 Skill 0.1.18；实际下载 Skill ZIP、校验 SHA256，并确认包内指引包含 CLI、Launcher 与稳定清单链接。没有虚构不带版本号的 ZIP 别名，也没有更新当前环境。

精简发给 AI 的任务（2026-10-18）

提示词只保留稳定入口、按 Skill 准备环境、数据库位置与使用副本、连接并列出表、暂不建模。安装顺序、依赖、校验和异常处理交由 Skill 指导，不要求读者复述操作手册。表格中的数据源名和 Namespace 标为实测示例，避免把未指定的名称误写成所有读者必然得到的结果。未修改脚本或环境。

从没有数据库文件开始（2026-10-18）

按用户反馈，正文不再假定读者已下载 Chinook。读者只选练习目录并发送任务，Codex 从官方项目下载指定 SQLite 样例、保留原件并使用副本接入；同步调整职责说明和预期结果表。示例目录改为简短的 D:\ai-data，实际环境与既有执行记录不迁移。

保留简短任务，补回执行过程（2026-10-18）

按用户反馈，提示词仍保持简短；正文在提示词后增加六步处理过程，讲清 stable.json、Skill、CLI、服务资源、启动验证及 Chinook 接入的先后关系。将原操作表改为四项结果核对表，避免处理过程和表格重复。下载链路与验证方式沿用已有核对和实测记录，未新增安装或运行操作。

第六章整体读者复审（2026-10-18）

• 与第五章收尾衔接：进入具体引擎与小型项目，不再重复方案选择；开头只交代本章边界，后续章节安排集中在结尾。
• 合并重复：读者准备改为选目录，Skill 获取入口直接放入简短提示词，详细处理过程集中在提示词之后。移除重复的下载流程概述和组件职责复述。
• 提示词保持两项任务及两个公开入口：按 Skill 准备环境，下载并接入 Chinook，连接并列出表，暂不建模。
• 六步处理过程完整保留，补明下载并读取 Skill 后，再按指引安装 CLI 和 Skill；继续交代服务资源下载、启动就绪、capabilities、数据源连接与 Namespace 绑定、表发现和结果汇报。
• 项目范围表的验收明确为整个项目的后续目标；本章结果表只检查环境与数据接入。保留全新安装流程与本次沿用已有 Skill 的事实区别。
• 保留表清单和既有执行证据，不重复安装日志、版本选取细节。环境与脚本未改，未重新执行服务检查，也未进入第七章。

已从头读回，检查段落顺序、简短提示词、处理步骤、结果范围及本地引用。