Agent Mentor:从请求课程到导出 · 第 5 / 5 节

第 5 课:课程的导出

本课目标:

  • 把请求说法对应到导出格式:可打印页面、PDF 或抽认卡。
  • 找到导出的文件,把它们变成 PDF 或 Anki 卡组。
  • 判断一份导出何时过期、需要重新运行。

先修条件:一门你自己生成的课程 | 上一篇 << 04 课程的维护

阅读站住在你的机器上,课程有时得离开它

一趟没有笔记本电脑的长途飞行。一位想要课程但不想装环境的朋友。一个已经跑在 Anki 里的手机抽认卡习惯。阅读站跟不去任何一个地方,它只在你自己的电脑上供页。为此,skill 的最后一个操作把课程变成能出门的普通文件:一张可读的单页,或一副抽认卡。

讲解

三种说法,三种结果1。“导出这门课程”同时产出两种格式。“导出成 PDF”或“打印它”产出可打印页面。“做抽认卡”或“把它变成 Anki 卡片”产出卡片文件。agent 把文件写进你课程旁边的 exports 文件夹,并告诉你确切路径1。什么都不会上传;导出和本课程里的其他一切一样,是本地的1

可打印页面是一个 HTML 文件,也就是存成文件的网页。双击它就在浏览器里打开,不需要阅读站在运行1。从那里开始,浏览器本身就是 PDF 工厂:打印,然后“存储为 PDF”1。同一个文件既可以当离线副本,也可以当一份单文件版本发给别人。对方需要的是浏览器,不是这个 skill。

卡片文件是一个 CSV(一种纯文本表格文件),内容是课程的词汇表,随时可导入 Anki,也就是那款间隔重复抽认卡应用1。在 Anki 里:File,然后 Import,选中卡片文件,把正反面字段对应好,它就成了一副卡组1。一条区分让两个复习世界互不混淆:第 3 课里 agent 的“考考我”会话跑在本地记录上,包含你的交互块;Anki 卡组是术语的便携副本,恰好用在 agent 不在的地方:手机上、离线时、你已有的习惯里。

导出有一个日后容易坑人的性质:导出是课程在你运行那一刻的快照1。它此后不看管课程。用第 4 课的请求改了一节课,导出的页面仍显示旧文本,直到你再导出一次。随之而来的习惯只有一行:改完,就重新导出。

本课有意不放交互块:三种说法对两种格式的对应没有可探查的隐藏机制;下面的填空示例覆盖了唯一值得练的判断(过期),真正的检查是练习,在你真实的文件夹里。

完整示例(跟着做)

你:“导出我的数据透视表课程。”

agent:“已导出。文件在 exports 文件夹的 pivot-tables 下:课程的可打印单页,以及词汇表的 Anki 卡片文件。”

页面: 你双击文件。整门课程在浏览器里渲染出来:每一节课,一张长页。你按打印,选“存储为 PDF”,PDF 落进你的下载目录。这份副本从此不怕没电,也经得起朋友测试:发过去,对方打开,无需任何安装。

卡片: 你打开 Anki,File,然后 Import,选中卡片文件。Anki 问哪一列是正面、哪一列是背面:术语在正面,释义在背面。十二个术语成了一副卡组;你的手机现在能在排队时考你。

一周后,你用一条维护请求修好了第 4 课。桌面上的 PDF 仍显示旧的第 4 课,快照不会自己更新。再说一次“导出我的数据透视表课程”;发出去的那份要紧的话,就覆盖它。

你来试试(填空示例)

填出每条请求产出的格式,以及事后要检查的一件事:

“打印它” → ____ ;之后检查:____ “做抽认卡” → ____ ;之后检查:____ “导出这门课程” → ____ ;之后检查:____

答案: “打印它” → 可打印页面;在需要离线之前,先检查它能在你的浏览器里打开。“做抽认卡” → 卡片文件;在 Anki 导入时检查正反面对应。“导出这门课程” → 两者;检查回报的路径,并确认两个文件的日期是现在,而不是你上次修改之前。这就是本课讲解里的快照规则。

小结 + 下一步

你现在能把课程搬出阅读站:一句话要可打印页面,一句话要抽认卡,一句话两者都要;浏览器打印出 PDF;Anki 导入成卡组;每次修改后重新导出,因为导出是快照。至此,skill 的五个操作收拢完毕:请求、练习、复习、更新、导出,五个都是发给你自己 agent 的句子。下一条值得发出的请求与这个工具无关:它是第 1 课那条四要素课程请求,主题就是当初让你装上它的那一个。

Footnotes

  1. Export-course workflow contract 2 3 4 5 6 7 8

练习

01

导出一门你拥有的课程。确认两个文件都存在于 agent 回报的路径,在浏览器里打开可打印页面,并用浏览器的打印对话框产出 PDF。

第 1 级(热身)
完成标准 · 本地勾选
02

把第 4 课和第 5 课连成闭环:通过维护请求给课程做一处小修改,重新导出,确认新页面带着这处修改。用 Anki 的话,导入卡片文件并复习五张卡;不用的话,把 PDF 发给某个人或另一台设备,确认打开无恙。

第 2 级(进阶)
完成标准 · 本地勾选