SuperAPI AI 工具集

making-tinyoffice-links

办公与效率

查看项目

更新于 10-18 18:11

技能介绍

Making Tiny Little Office links 是一个用于生成 Tiny Little Office(tinylittleoffice.com)分享链接的技能。Tiny Little Office 把整份文档保存在 URL 的 # 片段中;浏览器不会把 # 后面的内容发送给服务器。用户按 TLO 文本(Markdown 加少量扩展)编写文档,再把它进行百分号编码并生成链接,接收者打开后会在自己的副本上编辑,地址栏随每次编辑更新为新版本。

用途与文档类型 该技能适用于生成体积较小的可分享文档链接,覆盖写作、提纲、演示、表格、计算、绘图、图表、动画、日历和行程等场景。技能附带的对照表列出各应用及其参考文件:write 用于信件、备忘录、简历、发票、合同等;outline 用于嵌套想法,同一棵树可展示为幻灯片、思维导图或组织架构图;deck 用于幻灯片,并支持 poster、zine、booklet、brochure、comic、badges 等格式;sheet 用于带公式的表格与柱状图、折线图、饼图、桑基图、命名单元格模型;calc 用于命名求和、单位换算与 y=f(x) 图形;draw 用于 8px 网格上的方框箭头与像素画;diagram 用于 mind、org、family、lanes、timeline、venn、seating、net 等类型;anim 用于带关键帧的绘图;cal 用于事件、重复、时区及甘特图视图;trip 用于带经纬度和注释的地图站点。另有 api.md 覆盖文件下载(view=pdf|pptx|xlsx 等)、加密短链接、JS API 与 npm CLI、密码密封链接及官方 lint 的完整检查清单;editors.md 列出浏览器中驱动编辑器的键盘快捷键。

主要能力 技能提供脚本 scripts/tlo.py,支持 link、read、repair、lint 等子命令。生成链接的示例为:python3 scripts/tlo.py link deck talk.tlo --title "My talk" --by "Muninn"。URL 输出到 stdout,问题与长度警告输出到 stderr。read 子命令可读回链接中的文本(压缩或明文均可),也能读取被聊天客户端处理坏的链接;repair 打印干净链接。脚本生成的压缩形式为 #/v1/<app>/<flag><payload>,对 TLO 文本按 TLO 固定的词典压缩,再使用 base64url 编码,其中 62 用 - 表示,并每 300 字符插入一个 +,以免即时通讯应用断链;站点本身用 ~ 表示 62,也能读取 -;但部分聊天客户端会把 ~ 百分号编码成 %257E,导致链接打开为空,因此脚本默认写 -,--tilde 可复现站点自身输出。压缩形式比明文短 35–50%。--title 与 --by 写入文档头部;--plain 生成可读的 /<app>/#title=…&doc=… 形式,站点打开后也会压缩。

使用方式 使用流程:先按需求从对照表选择应用,只读该应用对应的参考文件;把 TLO 写入草稿文件,最好复制参考示例再修改,而不是从零开始;用脚本构建链接并运行离线 lint;修正所有问题后重建;最后交付链接。链接短于 2,000 字符时,以 Markdown 链接加简短说明给出;更长时,把裸 URL 单独放入围栏代码块,避免聊天渲染器截断或破坏链接,并让链接独占一行,防止后续引号或括号被并入。应告知对方:链接即文档,编辑会产生新链接,任何持有链接的人都能读取。

限制与注意事项 链接是副本,不存在共享实时文档;登记表或表单场景需让对方把编辑后的链接发回;短链接一旦生成即冻结。二维码最多容纳 2,953 字符,加密短链接最多 12,272 字符;超过 2,000 字符时部分聊天应用会截断。TLO 对空白敏感:每级嵌套两个空格,段落不要硬换行,每个换行都会保留。每张幻灯片只放一个内容,含围栏(图表、图示、表格)的幻灯片只显示该围栏,同页项目符号会被丢弃。维恩图和座位列表用逗号分隔,数字中不要写千分位逗号。图表中的名称要短(2–4 个词),连接端点必须与列出的名称完全一致。应使用围栏嵌入其他文档,而不是链接第二个 TLO URL。脚本的 lint 是官方检查的离线子集,覆盖 fence-bullets、title-long、title-list、body-over、edge-end、edge-unused、net-colon、comma-number、label-long、doc-link、length 等,速度快且无需网络,但不测量渲染文本、不计算公式;在 Node 可用且允许运行第三方 npm 代码时,npx tinylittleoffice lint <link> 与 measure 可运行真实布局代码,并捕获公式错误、标签溢出和精确溢出。若问题持续存在,应修改 TLO 内容而非 URL,并重新阅读对应应用的参考规则。URL 参数放在 # 之后而非 ? 之后,可选参数包括 by(制作者,未验证声明)与 view(pdf、png、html、md、tlo、pptx、xlsx、ics、embed、show 等)。