网页版

这是 Agent 工坊的网页版：装在自己电脑上的网页应用，不是网站，不用部署服务器。下载后双击启动，在浏览器里用聊天的方式把一个 Agent 产品的点子推导成需求和方案。

想跟着课程弄清楚这个项目是怎么实现的，请用教学版。

怎么用

1. 下载下面的 agent-workshop-web.zip，解压。
2. 双击 启动界面.command，浏览器会自动打开引擎界面。第一次会多花一两分钟准备环境；电脑上没有 Python 3.10+ 时，它会帮你下载安装器。
3. 在「模型设置」里选服务商、粘贴 API Key，点「测试连接并保存」。推荐 DeepSeek；用 GPT 的选「OpenAI（GPT）」，走中转的选「OpenAI 格式的中转或其他服务」并填上接口地址。
4. 在「新建产品」里像聊天一样说出想法，之后看方案、回答问题、试玩，再导出交接包。

用的时候别关启动它的那个终端窗口，用完直接关掉即可。

第一次双击提示「无法打开」

启动文件没有经过苹果签名，从浏览器下载后第一次双击，macOS 会拦下来。放行一次，以后双击就正常了：

1. 在弹窗里点「完成」，不要点「移到废纸篓」。
2. 打开「系统设置」→ 左栏「隐私与安全性」，右边往下翻到「安全性」。
3. 那里会有一行「已阻止"启动界面.command"……」，点旁边的「仍要打开」。没看到这一行的话，先回去再双击一次启动文件，再回来看。
4. 输入开机密码（或按指纹），在再次弹出的窗口里点「仍要打开」。

macOS 14 及更早的版本：按住 Control 键点启动文件，选「打开」，再点「打开」。

能做什么

• 对话式新建产品：AI 追问给谁用、怎么用、什么不能做，整理成需求草稿让你确认。
• 待确认问题改成大白话，一题一题地答；拿不准可以点「帮我想想」。
• 试玩：你扮演使用者，看产品按方案大概会怎么回应。
• 加新需求、版本历史、导出交接包。
• 检查外部项目：选一个本地文件夹，得到差距报告。

---

更新于 2026-10-31

教学版（课堂用）

这是 Agent 工坊的教学版：还没有网页界面，用来上课。课上用 AI 编程工具打开项目，让它先讲清楚项目里有什么，再带着一步步走完整个流程，看清每一步是怎么实现的。

课堂上怎么用

1. 下载下面的学生包 agent-workshop-teaching.zip，解压。

2. 用 Codex、Claude Code、Kimi Code、pi 这类能读写本地文件、能运行命令的 AI 编程工具打开解压出来的文件夹。

3. 对它说：

   请先全局阅读这个项目，告诉我里面都有什么，然后按《使用引导.md》带我一步步做，每一步做完停下来等我说继续。
   

4. AI 会按这个顺序带你走：介绍项目 → 准备环境 → 你自己在 .env 里填 API Key（推荐 DeepSeek；用 GPT 也可以，OpenAI 官方或 OpenAI 格式的中转都行；不要把 Key 发进聊天）→ 出方案 → 回答待确认问题 → 写代码骨架 → 验收。

命令都由 AI 在终端里运行，不用双击启动文件，也就不会遇到 macOS「无法打开」的拦截。

里面有什么

位置	是什么
AGENTS.md / CLAUDE.md	给 AI 的课堂说明：怎么介绍项目、每一步怎么走、哪些事不能做
BLUEPRINT.md	五步推导：需求拆解 → 领域建模 → 组件选型 → 架构设计 → 代码生成
s01–s17	17 个 Harness 组件，每个都有说明和能运行的 code.py
blueprint/	推导引擎（Python）：拆需求、按规则选组件、出方案、审稿、检查项目
使用引导.md	产品循环的完整流程，AI 按它一步步做
scaffold/、skills/	生产骨架模板和领域技能

熟悉之后想直接在网页上用，换成网页版。

---

更新于 2026-10-31