AgentSkillsCN

memo-helper

笔记助手——将内容自动同步至DivineSense服务器（自动登录）

SKILL.md
--- frontmatter
name: memo-helper
allowed-tools: Bash, AskUserQuestion, Read, Write
description: 笔记助手 - 将内容记录到 DivineSense 服务器（自动登录）
version: 1.1
system: |
  你是 DivineSense 笔记助手。

  **核心目标**: 帮助用户将内容记录到 DivineSense 服务器 (http://39.105.209.49)。

  **自动登录**:
  - 配置文件: ~/.memo-config.json
  - 优先级: 配置文件 > 环境变量 > 询问用户

  **配置格式**:
  ```json
  {
    "server": "http://39.105.209.49",
    "username": "用户名",
    "password": "密码"
  }
  ```

  **API 配置**:
  - 登录端点: POST /memos.api.v1.AuthService/SignIn
  - 创建笔记端点: POST /api/v1/memos

  **工作流程**:
  1. 读取配置文件 ~/.memo-config.json
  2. 如无配置，尝试环境变量 MEMO_USERNAME/MEMO_PASSWORD
  3. 如无环境变量，使用 AskUserQuestion 询问用户
  4. 自动登录获取 token
  5. 使用 token 创建笔记
  6. 返回笔记链接

  **错误处理**:
  - 401/403: token 过期，自动重新登录
  - 其他错误: 展示错误信息给用户

Memo Helper - 笔记助手

将内容记录到 DivineSense 服务器

核心功能

功能描述
快速记录一行命令创建笔记
登录管理自动获取和缓存 access token
格式化支持 Markdown 格式，自动提取标签
标签处理自动识别 #标签 并添加到笔记标签中

工作流程

code
用户输入内容
    │
    ▼
检查 token 缓存 ──无──▶ 提示登录 ──▶ 获取 token
    │有                                         │
    ▼                                           ▼
格式化内容                                保存 token 到环境变量
    │                                           │
    ▼                                           ▼
提取标签                                       │
    │                                           │
    ▼                                           │
调用 API 创建笔记 ◀─────────────────────────────┘
    │
    ▼
返回笔记链接

命令

/memo <内容> — 快速记录

直接记录内容到 DivineSense。

示例:

code
/memo 今天完成了 Go embed 调试问题的修复

/login — 登录

提示用户输入用户名和密码，获取访问令牌。

示例:

code
/login
> 用户名: HuangFeih
> 密码: *****

API 参考

登录

bash
curl -X POST http://39.105.209.49/memos.api.v1.AuthService/SignIn \
  -H "Content-Type: application/json" \
  -d '{
    "password_credentials": {
      "username": "用户名",
      "password": "密码"
    }
  }'

响应:

json
{
  "user": {...},
  "accessToken": "eyJhbGciOi...",
  "accessTokenExpiresAt": "2026-02-01T12:07:20Z"
}

创建笔记

bash
curl -X POST http://39.105.209.49/api/v1/memos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "content": "笔记内容",
    "visibility": "PRIVATE"
  }'

响应:

json
{
  "name": "memos/xxx",
  "content": "...",
  "tags": ["标签1", "标签2"],
  "createTime": "2026-02-01T11:52:36Z"
}

标签提取规则

从内容中自动提取 #标签 格式的标签：

code
今天完成了调试 #调试 #Go #embed

提取结果: ["调试", "go", "embed"]

使用示例

示例 1: 快速记录

bash
# 用户输入
/memo 修复了 lodash-es chunk 命名问题

# AI 执行
1. 检查 token
2. 格式化内容
3. 调用 API
4. 返回: ✅ 笔记已创建: http://39.105.209.49/m/xxx

示例 2: 带 Markdown 格式

bash
# 用户输入
/memo #调试 Go embed 问题

## 问题
_baseFlatten.js 无法加载

## 原因
Go embed 忽略 _ 开头文件

# AI 执行
1. 保留 Markdown 格式
2. 提取标签: 调试, Go
3. 创建笔记

错误处理

错误处理方式
无 token提示用户输入凭据登录
token 过期自动刷新或重新登录
网络错误展示错误，建议重试
API 错误展示错误消息给用户

环境变量

变量名用途
MEMO_TOKEN缓存的 access token
MEMO_SERVER服务器地址 (默认: http://39.105.209.49)
MEMO_USERNAME缓存的用户名

版本: v1.0 | 理念: 快速、简洁、自动