重构分享站:统一说明文字、合并行业对比页、移除旧 explainers

- 页面从 11 页缩减为 9 页,三个独立产品源码页合并为一张行业对比表
- 四个演示页说明文字重写:每页说清和上一级的区别、机制为什么相同
- 开场从 AiWork vs Codex 具体现象切入,工具页从 fs.readFileSync 引入契约层
- Loop 基本逻辑页说明这是真实可跑的原型,解释 await runTool 卡住的是什么
- 结尾页改为「收件箱统一三条路径」,回扣到 AiWork 的立即插入
- 新增 CompareSlide 组件,对比 AiWork / Codex / Claude Code / OpenAI Responses API
- 删除 ProductSlide 配置式组件,改为独立页面
- 关键事件卡片加标题标签,补 mode-tabs 激活态和 compare-table 样式
- 删除 explainers/ 下四个旧文件
- 更新 README.md 和 async-agent-lab/README.md
This commit is contained in:
魏天炜
2026-11-12 16:24:22 +08:00
parent 5dabea54ab
commit 6011f501aa
12 changed files with 208 additions and 2309 deletions

View File

@@ -1,28 +1,37 @@
# Agent 为什么能边问边做
本地 HTML 主讲稿。讲解页先介绍 Agent Loop 和基础工具。四张案例页均可切换「源码与说明」与「现场运行」,运行模式左侧显示对话与问答,右侧以角色标签展示事件轨迹。页面顺序见[分享方案](docs/presentation-plan.md)。
约 30 分钟内部技术分享的演示站。四个递进级别,每级只改一件事,每次都能在请求时序里看到变化的那个点。
## 启动
使用 Node.js 24 和 pnpm。在 `.env.local` 中配置 `EASTMONEY_API_KEY`。本机已有配置时直接启动。
需要 Node.js 24 和 pnpm。复制 `.env.example` 为 `.env.local`,填入 `EASTMONEY_API_KEY`:
```bash
cd /Users/appgroup/Documents/ChatGPT/super-agent-loop/async-agent-lab
pnpm install --frozen-lockfile
pnpm start
```
打开 [本地主讲稿](http://127.0.0.1:8791/)。用左右方向键、底部按钮或目录翻页。内容按窗口宽度排版,源码、候选项和轨迹随页面滚动。点「全屏」进入投屏模式。打开详情后用 Esc 关闭。演示页可独立启动、停止或重跑,切到源码对照页再返回时会保留当前运行和答复草稿。
打开 [http://127.0.0.1:8791/](http://127.0.0.1:8791/)。用左右方向键或底部按钮翻页,点「全屏」进入投屏模式。
- **同步 Bash**:沿 `tool_call_id` 从 Git 结果追到下一次请求。
- **后台 Bash**:沿 `job_1` 看启动回执、进程退出和完成通知。点请求事件可以展开对应的 `user` 消息及实际序列化请求体。
- **阻塞提问**:让问题卡停几秒,观察请求数。提交后展开下一次请求,核对原 `tool` 消息里的答案。
- **异步提问**:先等到「继续取证」亮起,再提交下周计划。候选默认全选,取消若干项后提交。点「打开 weekly-report.md」查看磁盘上实际写出的周报。
## 四个演示级别
每个演示页可以切换「源码与说明」和「现场运行」两种模式。运行时左侧显示对话和问答交互,右侧显示事件轨迹。
- **第 1 级·同步 Bash**:沿 `tool_call_id` 从 Bash 返回追到下一次请求,观察两次请求之间的空白。
- **第 2 级·后台 Bash**:沿 `job_1` 看启动回执、进程退出、完成通知进入请求。测试跑着,模型继续工作。
- **第 3 级·阻塞提问**:让问题卡停几秒,观察请求数不动。提交后核对请求里的 `tool` 消息。
- **第 4 级·异步提问**:先别答,看取证请求继续出现。答完两道题后打开 `weekly-report.md`,核对两份答案各自进了哪段。
## 取证与网关
取证用上海时间的本周工作日范围,截止到运行时或周五结束。读取 Codex 和 OpenCode 的本地会话数据库及 DSH 会话缓存,按 Git common directory 归并 worktree。默认以本机 AiWork 仓库的 `git config user.email` 过滤作者。可通过 `AIWORK_REPO` 指定 AiWork 路径,通过逗号分隔的 `WEEKLY_AUTHOR_EMAILS` 指定已确认的作者邮箱。Bash 支持本场演示用的 `weekly-evidence`、`git log` 和 `git show <sha>`。每次启动的独立目录位于 `.runs/`,周报由 `write` 写入该次运行目录。
取证用上海时间的本周工作日范围。读取 Codex 和 OpenCode 的本地会话数据库及 DSH 会话缓存,按 Git common directory 归并 worktree。默认以本机 AiWork 仓库的 `git config user.email` 过滤作者。可通过 `AIWORK_REPO` 指定路径,通过逗号分隔的 `WEEKLY_AUTHOR_EMAILS` 指定作者邮箱。每次运行的独立目录在 `.runs/`,周报写入该次运行目录。
服务监听本机回环地址。请求走东财 AI 网关的 OpenAI Chat Completions 流式接口,模型为 `DeepSeek-V4.1-Flash-1017`。模型窗口 1,000,000,最大输出 384,000,支持 text/image。本场使用文本工具调用。
请求走东财 AI 网关,模型为 `DeepSeek-V4.1-Flash-1017`(OpenAI Chat Completions 流式接口)。网关对单个令牌限速 50 次/分钟,不要并发开多个演示。
开发时可分别运行 `pnpm server` 与 `pnpm dev`(Vite 5178 代理至 8791)。运行 `pnpm typecheck` 检查类型。此前的订单原型见[原型讲稿](docs/share.md)。
## 开发
```bash
pnpm server # 仅启动后端(端口 8791)
pnpm dev # 仅启动 Vite 开发服务器(端口 5178,代理至 8791)
pnpm typecheck
```