AgentSkillsCN

note-management

笔记管理技能，借助Blinko API实现个人笔记与灵光闪现的高效管理。支持创建闪念、笔记、待办事项，搜索笔记、分享笔记，以及每日回顾等功能。当用户询问关于笔记、记录想法、闪念、备忘、待办事项，或需要搜索笔记、查找记录等问题时，可选用此技能。通过Python脚本直接调用Blinko HTTP API。

SKILL.md
--- frontmatter
name: note-management
description: >-
  笔记管理技能，使用 Blinko API 进行个人笔记和闪念的管理。
  支持创建闪念、笔记、待办事项，搜索笔记，分享笔记，每日回顾等功能。
  当用户询问笔记、记录想法、闪念、备忘、待办、搜索笔记、查找记录等问题时使用此技能。
  通过 Python 脚本直接调用 Blinko HTTP API。
license: MIT
compatibility: >-
  需要设置 BLINKO_DOMAIN 和 BLINKO_TOKEN 环境变量。
  Python 3.10+ 和 uv 包管理器。
metadata:
  author: copilot-tools
  version: "3.0.0"
allowed-tools: Bash(uv:*) Bash(python:*) Read

笔记管理技能

使用 Python 脚本直接调用 Blinko API 管理个人笔记和闪念。

可用命令

命令功能使用场景
flash <内容>创建闪念 (type 0)快速记录想法、灵感
note <内容>创建笔记 (type 1)详细记录内容、备忘
todo <内容>创建待办 (type 2)记录待办事项、任务
search <关键词>搜索笔记查找之前的记录
share <笔记ID>分享笔记分享笔记并获取链接
unshare <笔记ID>取消分享取消笔记分享
review每日回顾获取今日待回顾笔记
clear-recycle清空回收站永久删除已删除的笔记

使用方法

基础命令

bash
# 切换到 skill 目录
cd .github/skills/note-management

# 创建闪念
uv run scripts/blinko.py flash "快速记一个想法"

# 创建笔记
uv run scripts/blinko.py note "详细的会议纪要..."

# 创建待办
uv run scripts/blinko.py todo "明天要完成的任务"

# 搜索笔记
uv run scripts/blinko.py search "项目" --size 10

# 分享笔记
uv run scripts/blinko.py share 123 --password 666666

# 每日回顾
uv run scripts/blinko.py review

# 清空回收站 (需确认)
uv run scripts/blinko.py clear-recycle --force

创建闪念

当用户说 "记录一下..."、"快速记一个想法..."、"闪念..." 时：

bash
uv run scripts/blinko.py flash "用户的想法内容"

创建笔记

当用户说 "帮我记住..."、"创建一条笔记..."、"详细记录..." 时：

bash
uv run scripts/blinko.py note "用户的笔记内容"

创建待办

当用户说 "添加待办..."、"记一个任务..."、"todo..." 时：

bash
uv run scripts/blinko.py todo "用户的待办内容"

搜索笔记

当用户说 "找一下我之前记的..."、"搜索笔记..."、"我之前写过..." 时：

bash
# 基础搜索
uv run scripts/blinko.py search "关键词"

# 指定返回数量
uv run scripts/blinko.py search "关键词" --size 10

# 按类型过滤 (flash/note/todo/all)
uv run scripts/blinko.py search "关键词" --type flash

# 精确匹配 (禁用 AI 搜索)
uv run scripts/blinko.py search "关键词" --exact

# 显示详细信息
uv run scripts/blinko.py search "关键词" --verbose

分享笔记

当用户说 "分享这条笔记..."、"取消分享..." 时：

bash
# 分享笔记
uv run scripts/blinko.py share 笔记ID

# 带密码分享
uv run scripts/blinko.py share 笔记ID --password 666666

# 取消分享
uv run scripts/blinko.py unshare 笔记ID

每日回顾

当用户说 "今天要回顾什么..."、"每日回顾..." 时：

bash
uv run scripts/blinko.py review

JSON 输出

所有命令都支持 --json 参数输出 JSON 格式，便于程序处理：

bash
uv run scripts/blinko.py flash "内容" --json
uv run scripts/blinko.py search "关键词" --json

配置要求

环境变量

设置以下环境变量：

powershell
# Windows PowerShell (永久)
[Environment]::SetEnvironmentVariable("BLINKO_DOMAIN", "http://your-blinko-server:1111", "User")
[Environment]::SetEnvironmentVariable("BLINKO_TOKEN", "your-api-key", "User")
bash
# Linux/macOS
export BLINKO_DOMAIN="http://your-blinko-server:1111"
export BLINKO_TOKEN="your-api-key"

BLINKO_DOMAIN 格式

支持多种格式：

  • •纯域名: myblinko.com, localhost:3000
  • •完整 URL: https://myblinko.com, http://localhost:3000

常见场景

用户问题执行命令
"快速记录一个想法"uv run scripts/blinko.py flash "想法内容"
"记录一下今天的会议内容"uv run scripts/blinko.py note "会议内容"
"添加一个待办：明天开会"uv run scripts/blinko.py todo "明天开会"
"我之前记过关于XX的内容"uv run scripts/blinko.py search "XX"
"分享笔记 123 给朋友"uv run scripts/blinko.py share 123
"今天有什么要回顾的"uv run scripts/blinko.py review
"清空回收站"uv run scripts/blinko.py clear-recycle --force

文件结构

code
note-management/
├── SKILL.md              # 技能定义 (本文件)
├── scripts/
│   ├── blinko.py         # 主命令行工具
│   └── blinko_client.py  # Blinko API 客户端
└── references/
    └── REFERENCE.md      # API 参考文档

详细文档