名称: get-tldr
描述: 使用 get-tldr.com 的摘要 API 返回摘要,无需进一步总结;此技能应格式化 API 输出以提升可读性,但不得更改其内容。
一个快速、确定性的技能,用于通过 get-tldr.com API 总结链接内容。
使用模式(针对代理):
- 当用户说出类似 "get-tldr <链接>" 或 "get-tldr" 后跟 URL 时触发。
- 该技能将调用捆绑的脚本 get_tldr.py,并将 URL 作为唯一参数传入。
- 重要:API 响应本身已是摘要;此技能不得进一步总结或修改内容——仅提取 JSON 中 "summary" 元素的值并格式化以提升可读性。请获取整个 summary 属性,不要省略任何内容。
- 重要:如果 API 响应 JSON 中的 summary 元素已采用 Markdown 格式,则直接返回格式化后的 Markdown。不要省略任何内容,也不要更改文本。确保其未被包裹在代码块中;如果被包裹,请移除包裹的代码块,以便正确渲染为 Markdown 而非代码块。
包含的文件:
- get_tldr.py — 一个位于技能文件夹中的小型 Python 脚本,它将 {"input": "<URL>"} 发送至 https://www.get-tldr.com/api/v1/summarize,并使用必需的 X-API-Key 请求头,然后将 JSON 响应打印到标准输出。脚本从 ~/.config/get-tldr/config.json(首选)读取 API 密钥和可选的日志文件路径,或回退到 GET_TLDR_API_KEY 环境变量或技能文件夹中的 .env 文件。如果未配置日志文件,脚本默认使用 ~/.config/get-tldr/skill.log。
维护者须知:
- 在 ~/.config/get-tldr/config.json 创建配置文件,结构如下(JSON):
{
"api_token": "<你的密钥>",
"logfile": "/路径/到/日志文件.log"
}
GET_TLDR_API_KEY 环境变量或技能文件夹中的 .env 文件。