🧠 Memory Hub

AI 记忆 & Skill 统一管理
-
记忆 Memories
-
技能 Skills
-
接入客户端
连接中…
服务状态

接入客户端

ID名称类型设备最近活跃
点击「创建」查看客户端列表
提示：API Key 仅在创建时显示一次，请立即复制保存。

快速测试

等待请求…

API 文档

GET/api/v1/memories查询记忆

query 参数：namespace、type、q（关键字）、limit、offset、client_id（管理员）

curl -H "Authorization: Bearer $KEY" \
  "http://localhost:8080/api/v1/memories?type=note&q=项目"
POST/api/v1/memories创建记忆 
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"namespace":"global","type":"fact","title":"服务器 IP","content":"后端部署在 10.0.0.5","tags":["运维"]}' \
  http://localhost:8080/api/v1/memories
PUT/api/v1/memories/:id更新记忆 
curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"content":"服务器 IP 已变更为 10.0.0.8"}' \
  http://localhost:8080/api/v1/memories/1
DELETE/api/v1/memories/:id删除记忆 
curl -X DELETE -H "Authorization: Bearer $KEY" http://localhost:8080/api/v1/memories/1
GET/api/v1/skills查询技能库（全局共享） 
curl -H "Authorization: Bearer $KEY" "http://localhost:8080/api/v1/skills?q=sql"
POST/api/v1/skills创建 Skill 
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name":"json-格式化","description":"统一 JSON 输出格式","version":"1.0.0","content":"总是输出紧凑 JSON。"}' \
  http://localhost:8080/api/v1/skills
POST/api/v1/import/files上传文件导入（SOUL.md/CLAUDE.md/AGENTS.md/SKILL.md…） 
curl -X POST -H "Authorization: Bearer $KEY" \
  -F "files=@C:/Users/me/.workbuddy/SOUL.md" \
  -F "files=@C:/Users/me/.workbuddy/MEMORY.md" \
  http://localhost:8080/api/v1/import/files
POST/api/v1/import/directory扫描服务器本地目录导入（管理员） 
curl -X POST -H "Authorization: Bearer $ADMIN_KEY" -H "Content-Type: application/json" \
  -d '{"path":"C:/Users/me/.workbuddy"}' \
  http://localhost:8080/api/v1/import/directory
GET/api/v1/export?format=json|md导出全部记忆与技能 
curl -H "Authorization: Bearer $KEY" \
  "http://localhost:8080/api/v1/export?format=md" -o memory-backup.md
POST/api/v1/export/directory导出并重建 .workbuddy 目录结构（管理员） 
curl -X POST -H "Authorization: Bearer $ADMIN_KEY" -H "Content-Type: application/json" \
  -d '{"path":"D:/memory-backup","overwrite":true}' \
  http://localhost:8080/api/v1/export/directory
POST/api/v1/clients创建接入客户端（管理员，分配 API Key） 
curl -X POST -H "Authorization: Bearer $ADMIN_KEY" -H "Content-Type: application/json" \
  -d '{"name":"我的Mac","type":"claude-code","device":"macbook-pro"}' \
  http://localhost:8080/api/v1/clients

客户端接入示例

在 Claude Code / Codex / 任何 AI 客户端 中，把它作为「记忆工具」接入：

# 读取记忆
curl -H "Authorization: Bearer $MY_KEY" \
  "http://YOUR_SERVER:8080/api/v1/memories?namespace=global"

# 记一条新记忆（例如：学习到一个新偏好）
curl -X POST -H "Authorization: Bearer $MY_KEY" -H "Content-Type: application/json" \
  -d '{"namespace":"global","type":"preference","title":"喜欢简洁回复","content":"用户偏好：回答直接给结论，不要客套。"}' \
  http://YOUR_SERVER:8080/api/v1/memories