介绍
# get-tldr
使用 get-tldr.com API 快速、确定性地总结链接内容的技能。
使用模式(针对代理): - 当用户说类似“get-tldr <link>”或“get-tldr”后跟 URL 时触发。 - 该技能将调用捆绑的脚本 `get_tldr.py`,并将 URL 作为唯一参数。 - 重要:API 响应本身就是摘要;该技能绝不能进一步总结或更改内容——只需提取 JSON 中“summary”元素的值并对其进行格式化以提高可读性。提取整个 summary 属性,不要遗漏任何内容。 - 重要:如果来自 API 的响应 JSON 中的 summary 元素已经是 markdown 格式,则直接返回该 markdown 格式。不要遗漏任何内容,也不要更改文本。确保其未包裹在代码块中,如果是,请移除包裹的代码块,以便其正确渲染为 markdown,而不是代码块。
包含的文件: - get_tldr.py — 小型 Python 脚本(位于技能文件夹中),使用所需的 X-API-Key 标头将 {"input": "<URL>"} 发布到 https://www.get-tldr.com/api/v1/summarize,并将 JSON 响应打印到 stdout。该脚本从 ~/.config/get-tldr/config.json(首选)读取 API 密钥和可选的日志文件路径,或者回退到技能文件夹中的 GET_TLDR_API_KEY 环境变量或 .env 文件。如果未配置日志文件,脚本默认为 ~/.config/get-tldr/skill.log。
维护者注意事项: - 在 ~/.config/get-tldr/config.json 创建具有以下结构(JSON)的配置文件:
``` { "api_token": "<your_key_here>", "logfile": "/path/to/logfile.log" } ```
- 脚本将使用配置中的“api_token”字段。如果配置文件缺失,脚本将回退到 GET_TLDR_API_KEY 环境变量或技能文件夹中的 .env 文件。 - 重要:不要再次总结 API 响应;该技能应仅格式化响应以提高可读性,并且不得更改内容。