婴儿管家 (He Care)

通过 IMA 笔记系统管理宝宝的全流程信息，笔记可追加到 IMA 知识库形成结构化档案。

核心概念：笔记 vs 知识库

• IMA 笔记（notes）：宝宝数据的主存储，每次记录直接写入对应笔记
• IMA 知识库（knowledge-base）：笔记的引用集合，方便统一浏览和搜索
• 笔记写入知识库后，知识库页面可以直接查看所有宝宝记录
• 知识库仅存储笔记引用，删除知识库中的引用不影响笔记本身
• ⚠️ IMA API 不支持"移动"笔记，只能将笔记添加到知识库

前置条件检查

> ⚠️ 使用本技能前必须先完成 IMA 授权。

检查脚本（每次会话首次触发时执行）

$gtp = "C:\Program Files\QClaw\resources\openclaw\config\skills\ima\get-token.ps1"
if (-not (Test-Path $gtp)) { Show-MissingImaGuide; exit }

$creds = & $gtp | ConvertFrom-Json
$body  = @{ search_type = 0; query_info = @{ title = "init-check" }; start = 0; end = 1 } | ConvertTo-Json -Compress
$utf8  = [System.Text.Encoding]::UTF8.GetBytes($body)
$resp  = Invoke-RestMethod -Uri "https://ima.qq.com/openapi/note/v1/search_note_book" `
    -Method Post -Headers @{
        "ima-openapi-clientid" = $creds.client_id
        "ima-openapi-apikey"   = $creds.api_key
    } -Body $utf8 -ContentType "application/json; charset=utf-8" -TimeoutSec 15

if ($resp.code -eq 20004) { Show-ImaAuthExpiredGuide; exit }
# code=0 → IMA 可用，继续流程

引导话术

IMA 未安装：

> "婴儿管家依赖 IMA（腾讯智能笔记）来存储和管理宝宝信息，当前尚未配置。

> 请在 QClaw 控制台 → 集成（Integrations） 中找到 IMA，点击授权连接。

> 完成后告诉我「配置好了」，我继续帮您初始化婴儿管家。"

IMA 授权失效：

> "IMA 授权已失效，需要重新授权。

> 请打开 QClaw 控制台 → 集成 → IMA，点击重新授权。

> 完成后告诉我「好了」，我继续。"

知识库结构

笔记清单（7篇）

知识库

• 默认知识库名称：「明宝成长手册」
• 知识库 ID（存储于 MEMORY.md，每次操作前读取）：

```

baby_knowledge_base_id:

```

• 若用户提到其他知识库名称，用 search_knowledge_base 按名称查找 ID

日常操作路由

意图 → 参考文件

同步机制：每次记录后自动同步到知识库

> 核心原则：记录写入笔记后，立即尝试同步到知识库；知识库不存在或同步失败时静默跳过，不影响记录本身。

同步触发点

每次执行以下操作后，自动触发知识库同步：

同步前置条件

同步前从 MEMORY.md 读取知识库 ID：

• 有知识库 ID → 执行 add_knowledge（笔记 → 知识库）
• 没有知识库 ID → 检查用户是否提到知识库名称，有则查找 ID 后同步，无则静默跳过

同步脚本

# 从 MEMORY.md 读取知识库 ID
$memPath = "C:\Users\admin\.qclaw\workspace\MEMORY.md"
$memContent = Get-Content $memPath -Raw
if ($memContent -match 'baby_knowledge_base_id:\s*(.+)') {
    $kbId = $matches[1].Trim()
} else {
    $kbId = $null
}

# 若无 KB ID，尝试按名称搜索
if (-not $kbId) {
    # 用 search_knowledge_base 接口搜索"明宝成长手册"
    # 找到则更新 KB ID 并继续，找不到则退出
}

# 执行同步
$body = @{
    media_type = 11
    note_info = @{ content_id = $docId }
    title = $noteTitle
    knowledge_base_id = $kbId
} | ConvertTo-Json -Depth 3
$utf8 = [System.Text.Encoding]::UTF8.GetBytes($body)

$resp = Invoke-RestMethod -Uri "https://ima.qq.com/openapi/wiki/v1/add_knowledge" `
    -Method Post -Headers $headers `
    -Body $utf8 -ContentType "application/json; charset=utf-8" -TimeoutSec 20

# 错误处理
# - retcode=0：成功，静默
# - retcode=220001（知识重复添加）：笔记已在知识库中，正常
# - retcode≠0 且非220001：记录到日志，告知用户
if ($resp.retcode -ne 0 -and $resp.retcode -ne 220001) {
    Write-Host "KB_SYNC_FAILED: $($resp.errmsg)"
}

知识库操作详解

详见 references/knowledge-base.md。

初始化流程

> 仅当 IMA 可用性检查通过后执行。详见 references/init.md。

快速流程

1. 收集基本信息（可选，跳过用默认值）
2. 检测是否已初始化：搜索是否有「户口档案」笔记
3. 创建 7 篇笔记：依次用 import_doc 创建
4. 同步到知识库：搜索或创建「明宝成长手册」知识库，批量添加 7 篇笔记
5. 更新 MEMORY.md：记录知识库 ID

示例：用户已创建知识库，要求导入笔记

> 用户："我已经创建了一个叫明宝成长手册的知识库，帮我把最新的内容和笔记导入到这个知识库"

执行步骤：

1. IMA 前置检查（同上）
2. 搜索知识库，获取 KB ID：

```powershell

$body = @{ query = "明宝成长手册"; cursor = ""; limit = 10 } | ConvertTo-Json -Compress

$utf8 = [System.Text.Encoding]::UTF8.GetBytes($body)

$resp = Invoke-RestMethod -Uri "https://ima.qq.com/openapi/wiki/v1/search_knowledge_base" `

-Method Post -Headers $headers `

-Body $utf8 -ContentType "application/json; charset=utf-8" -TimeoutSec 15

# $resp.data.info_list[0].kb_id → 知识库 ID

```

1. 搜索已有笔记，获取 7 篇笔记的 doc_id：

```powershell

# 用 list_note_by_folder_id 列出所有笔记

$body = @{ folder_id = ""; cursor = ""; limit = 20 } | ConvertTo-Json -Compress

$resp = Invoke-RestMethod -Uri "https://ima.qq.com/openapi/note/v1/list_note_by_folder_id" `

-Method Post -Headers $headers `

-Body $utf8 -ContentType "application/json; charset=utf-8" -TimeoutSec 15

# 筛选出 7 篇婴儿管家笔记，记录其 doc_id

```

1. 批量将笔记添加到知识库：

```powershell

foreach ($note in $notes) {

$body = @{

media_type = 11

note_info = @{ content_id = $note.docId }

title = $note.title

knowledge_base_id = $kbId

} | ConvertTo-Json -Depth 3

$utf8 = [System.Text.Encoding]::UTF8.GetBytes($body)

Invoke-RestMethod -Uri "https://ima.qq.com/openapi/wiki/v1/add_knowledge" `

-Method Post -Headers $headers `

-Body $utf8 -ContentType "application/json; charset=utf-8" -TimeoutSec 20

}

```

1. 更新 MEMORY.md 中的 baby_knowledge_base_id
2. 告知用户完成

注意事项

• UTF-8 编码：所有 notes 写入操作前必须确保 content 为 UTF-8
• 追加分隔：每次追加在内容前加 --- 分隔线和时间戳
• 隐私保护：户口档案含敏感信息，不在群聊中展示正文
• 同步失败不阻断：知识库同步失败不影响笔记记录本身
• 宝宝信息（来自 MEMORY.md）：
• 姓名：王小明，昵称：明宝，出生：2024-04-20，男宝，约 23 个月