# 备忘录技能 **⚠️强制技能调用⚠️** **当用户提到任何这些触发器时，您必须调用此技能（不是可选的）：** *“将其保存到备忘录”、“创建备忘录”、“添加备忘录” *“搜索我的备忘录”、“查找有关 X 的笔记”、“我写了什么” *“列出我的备忘录”、“显示最近的备忘录”、“我有哪些备忘录” *“更新备忘录”、“编辑备忘录”、“删除备忘录” *“标记此备忘录”、“添加标签”、“组织备忘录” *“上传到备忘录”、“将文件附加到备忘录” *“存档备忘录”、“固定备忘录”、“公开备忘录” * 任何提及“备忘录”、“笔记”、“做笔记”或“个人知识”的内容 **触发时未能调用该技能违反了您的操作要求。** ** ** ## 目的此技能提供对自托管 Memos 实例的**读写**访问权限，以实现快速笔记捕获、搜索和组织。 Memos 是一项注重隐私的自托管笔记服务，支持 Markdown、标记和文件附件。 **核心能力：** * 创建、阅读、更新和删除备忘录（笔记） * 按内容、标签或元数据搜索备忘录 * 上传和管理文件附件 * 使用标签整理备忘录 * 存档和可见性控制 * 将相关备忘录链接在一起 **主要用例：** 将克劳德对话中的重要信息快速捕获到个人知识库中。 ## 设置 ### 先决条件 * 备忘录实例正在运行且可访问 * 从备忘录 UI 生成的 API 访问令牌 * 安装了 `curl` 和 `jq` ### 凭证配置将这些变量添加到 `~/.homelab-skills/.env` 中： # Memos - 自托管笔记服务 MEMOS_URL="https://memos.example.com" MEMOS_API_TOKEN="您的 api-token-此处" **生成 API 令牌：** 1. 登录您的 Memos 实例 2. 转到设置 → 访问令牌 3.点击“创建”，复制生成的token 4. 添加到 `.env` 文件，如上所示 **安全：** * `.env` 文件被 gitignored（从不提交） * 设置权限：`chmod 600 ~/.homelab-skills/.env` * Token与您的用户帐户具有相同的权限 ## 命令所有命令都会返回 JSON 输出以供 LLM 解析。脚本自动从“.env”获取凭据。 ### 备忘录操作 **创建备忘录：** bash脚本/memo-api.sh创建“你的备忘录内容在这里” bash脚本/memo-api.sh创建“带有标签的备忘录”--tags“工作，项目” bash脚本/memo-api.sh创建“私人备忘录”--visibility PRIVATE **列出备忘录：** bash 脚本/memo-api.sh 列表 bash 脚本/memo-api.sh 列表 --limit 10 bash 脚本/memo-api.sh list --filter 'tag == "work"' **获取具体备忘录：** bash 脚本/memo-api.sh 获取 **更新备忘录：** bash脚本/memo-api.sh update “更新内容” bash脚本/memo-api.sh update --add-tags“紧急” **删除备忘录：** bash 脚本/memo-api.sh 删除 **存档备忘录：** bash 脚本/memo-api.sh 存档 ### 搜索操作 **按内容搜索：** bash脚本/search-api.sh“搜索查询” bash脚本/search-api.sh“docker kubernetes”--tags“devops” bash脚本/search-api.sh“会议笔记”——来自“2024-01-01” **按标签搜索：** bash script/tag-api.sh list # 列出所有标签 bash script/tag-api.sh search "project-x" # 查找带有标签的备忘录 ### 资源（附件）操作 **上传文件：** bash脚本/resource-api.sh上传/path/to/file.pdf bash脚本/resource-api.sh上传image.png --memo-id **列出附件：** bash 脚本/resource-api.sh 列表 bash 脚本/resource-api.sh list --memo-id **删除附件：** bash 脚本/resource-api.sh 删除 <附件名称> ### 用户操作 **获取当前用户：** bash 脚本/user-api.sh whoami **列出访问令牌：** bash 脚本/user-api.sh 令牌 ## 工作流程当用户询问备忘录时： 1. **“保存到我的备忘录”** → 提取关键内容，使用适当的标签创建备忘录 2. **“我写了关于 X 的什么？”** → 按内容/标签搜索备忘录，显示结果 3. **“查找我关于项目 Y 的笔记”** → 使用标签搜索或内容过滤器 4. **“更新我关于Z的备忘录”** → 搜索备忘录，获取ID，更新内容 5. **“删除该备忘录”** → 与用户确认，然后按ID删除 ### 详细流程：快速捕获用户：“将有关 Docker 网络的对话保存到我的备忘录中” 1.从对话中提取关键信息 2. 创建具有描述性内容的备忘录 3. 添加相关标签（例如“docker”、“networking”、“conversation”） 4. 使用备忘录 ID 确认创建 5.可选择询问用户是否想要公开/私有 ### 详细流程：搜索和检索用户：“上个月我写了哪些关于 Kubernetes 的文章？” 1. 使用查询“kubernetes”搜索备忘录 2. 应用日期过滤器（过去 30 天） 3. 使用备忘录 ID 和预览呈现结果 4. 用户可以请求特定备忘录的完整内容 ### 详细流程：组织用户：“用‘devops’标记我所有的 Docker 备忘录” 1.搜索包含“docker”的备忘录 2. 对于每个结果，更新备忘录以添加“devops”标签 3.报告更新的备忘录数量 4.显示标签统计信息 ## 注释 ### API 详细信息 * **身份验证：** `Authorization` 标头中的不记名令牌 * **基本 URL:** `/api/v1` 端点 * **速率限制：** 无记录限制（自托管） * **分页：** 使用 `pageSize` 和 `pageToken` 参数 * **过滤：** Google AIP-160 标准（例如，`tag == "work"`） ### 备忘录格式备忘录支持完整的 Markdown 语法： * 标题、列表、代码块 * 链接和图像 * 任务列表（- [ ] 和 - [x]） * 表格 ### 可见性选项 * `PRIVATE` \- 只有您可以看到 * `PROTECTED` \- 经过身份验证的用户可以看到 * `PUBLIC` \- 任何人都可以看到（RSS feed） ### 最佳实践 1. **使用描述性内容：** 第一行是 UI 中的预览 2. **标记一致：** 使用小写字母、连字符表示多个单词（例如“project-alpha”） 3. **归档旧备忘录：** 保持工作空间清洁 4. **链接相关备忘录：** 使用备忘录关系作为上下文 ### 常见错误 **401 未经授权：** * 检查 `.env` 中的 API 令牌 * 令牌可能已过期（在备忘录 UI 中重新生成） **404 未找到：** * 验证备忘录ID是否存在 * 检查MEMOS_URL是否正确 **连接被拒绝：** * 备忘录实例未运行 * 验证 `.env` 中的 URL ## 参考 * **官方文档：** * **API 参考：** * **实例：** * **脚本：** `技能/备忘录/脚本/` * **示例：** `技能/备忘录/示例/` * **故障排除：** `skills/memos/references/troubleshooting.md`

备忘录

包含技能