Agent Skills
返回列表
SoulCore 长期记忆助手（本地版）

SoulCore 长期记忆助手（本地版）

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5f341547/soulcore-memory-chat-router。

技能介绍

要解决什么问题

多轮对话里，模型默认只看见当前上下文，长期偏好、事实与项目背景往往在换会话或窗口变长后丢失。若你希望 Agent 在本地可控的环境里读写记忆，而不是把整段历史塞进 prompt，就需要一套明确的后端契约：健康检查、对话入口，以及可 pin、导出、导入的记忆 API。

技能如何工作

本技能是 qclaw-skill FastAPI 后端 上的薄路由层；平台若只导入一个 SKILL.md，以根目录文件为入口，细节见 qclaw-thin-skill/SKILL.md 与 references/api_spec.md。

推荐调用顺序：

  1. GET /v1/health — 确认服务可用，并读取 auth_enabled
  2. POST /v1/chat — 主对话通道
  3. 按需调用记忆与诊断接口

记忆相关能力包括：POST /v1/memory/write、POST /v1/memory/recall、GET /v1/memory/list，以及 pin / delete / export / import；排障可用 GET /v1/diagnostics/last。本地默认后端为 http://127.0.0.1:8000，云端需替换为实际部署地址；本地可用 start_local.bat 或 start_local.ps1 -Mode noauth 启动后端。

鉴权规则：auth_enabled=false 时无需 x-api-key；为 true 时请求头需带 x-api-key。

适用边界与注意点

  • 401：核对密钥与 auth_enabled 是否一致。
  • 422：检查请求体字段，修正后最多重试一次。
  • 5xx / 超时：应做降级回复，避免无限重试。

本技能描述的是 HTTP 契约与调用顺序，不包含记忆排序、向量检索等后端实现细节；那些以 qclaw-skill 仓库与 API 规范为准。

使用场景

  • 在自托管 qclaw-skill 上跑 Agent，新开会话前用 `POST /v1/memory/recall` 拉回用户偏好与项目背景再调 `POST /v1/chat`
  • 平台只允许导入一个 SKILL.md，按文档先 `GET /v1/health` 判断 `auth_enabled`，再带或不带 `x-api-key` 接入对话与记忆接口
  • 需要把某台机器上的记忆快照迁到另一环境，通过 `GET /v1/memory/export` 与 `POST /v1/memory/import` 完成备份与恢复
  • 对话或写入记忆返回 422/5xx 时，用 `GET /v1/diagnostics/last` 对照最近一次请求状态并修正 payload 后单次重试

适合人员

  • 在 Windows 本机用 `start_local.bat` 或 PowerShell 启动 qclaw 后端、要把健康检查与记忆 API 接到自有 Agent 的集成工程师
  • 数据不出内网、需在本地 `127.0.0.1:8000` 上 pin 关键记忆并 delete 误写入条目的隐私敏感团队
  • 维护多环境部署、需用 memory list 核对条目并用 export/import 做版本化迁移的运维或平台负责人
  • 为 qclaw-thin-skill 写调用方逻辑、必须遵守 401/422 与超时降级策略以避免无限重试的后端或 Agent 开发者