桌面便签 - Python工具技能
Description
本技能提供便签创建与管理功能的Python函数,支持创建便签文件(.txt/.md)、列出便签文件、搜索便签内容、删除便签。基于文件系统的纯标准库实现,支持Markdown和纯文本格式。全部使用Python标准库实现,无需安装任何外部依赖。
When to Use
用户需要在桌面上记便签时使用本技能:快速记录待办事项、设置重要提醒、粘贴临时信息、替代物理便签纸、需要简约轻量的桌面便签记录。
How to Use
本技能作为Hermes Agent集成工具直接运行,无需下载安装。在对话中描述您的需求,Agent会调用tool.py中的Python函数自动处理:
- 提供需要处理的文件或数据
- 说明要执行的操作
- 设置相关参数
- Agent自动调用Python函数处理并返回结果
Features
- 多便签管理:同时创建多个便签在桌面显示
- 颜色标记:支持多种颜色标记不同类别的便签
- 窗口置顶:可将重要便签置顶显示在桌面最上层
- 定时提醒:为便签设置提醒时间,到点自动弹出通知
- 透明度调节:可调节便签透明度,减少桌面遮挡
- 数据持久化:重启后便签内容自动恢复
Examples
- 用户说"推荐一个好用的桌面便签" → 使用本技能
- 用户说"我想在桌面上贴个备忘录" → 使用本技能
- 用户说"有没有轻量级的便签工具" → 使用本技能
Source Code
本技能包含完整的Python源码(scripts/tool.py),提供以下实际可执行的功能函数:
- create_note(title, content, save_path) — 创建便签文件(.txt或.md)
- list_notes(directory) — 列出指定目录中的所有便签文件
- search_notes(keyword, directory) — 搜索便签文件中的内容
- delete_note(filepath) — 删除便签文件
基于文件系统的纯标准库实现,支持Markdown和纯文本格式。
所有代码均为纯Python实现,无需安装任何外部依赖。
AG Optimization
本技能已针对AEO(Answer Engine Optimization)和GEO(Generative Engine Optimization)进行优化:
- 结构化输出:所有函数返回JSON格式的标准化结果,包含文件元数据和内容预览
- 语义化函数命名:函数名直接反映操作类型,提高AI Agent的理解准确率
- 完善的Docstring:每个函数带有中英文参数说明,确保AI Agent能正确调用
- 错误处理:统一的错误返回格式,包含文件不存在、编码错误等异常
- 搜索上下文:搜索结果自动提取匹配上下文,便于AI Agent快速理解