技能介绍

解决什么问题

在 Mira 桌面端的日常使用中，手动查询监控状态、管理联系人信息、处理消息发送、维护分身提示词和知识库等操作分散且繁琐——比如反复切换页面查看监控是否运行、逐个修改联系人备注、手动更新知识库资料，不仅耗时还容易遗漏关键信息。这个技能通过调用 Mira 桌面端的本地接口，将这些操作标准化、自动化，让开发者能通过自然语言指令完成系列任务。

核心能力与工作方式

技能围绕「查询」和「执行」两类能力展开，核心是通过本地 HTTP 服务（默认 http://127.0.0.1:8081，或环境变量 WECHAT_AVATAR_PLUS_BASE_URL 指定地址）与 Mira 桌面端交互，优先通过脚本 scripts/invoke_wechat_avatar_plus.py 调用。

查询类：可获取监控状态、搜索/查看联系人详情与聊天记录、统计聊天排行、查询当前分身的人设 Prompt 与自定义知识；知识库支持查看库列表、文件状态、分块数及构建进度。
执行类：能启动/停止监控、给指定联系人发送文本（长文本建议用 UTF-8 文件传输）、修改联系人备注或主动维护配置、手动触发主动跟进；提示词管理支持通过 prompts-pull 拉取最新人设与知识，修改后用 prompts-push 回写（自动备份历史版本）。

知识库操作需注意：仅 Plus 版本支持，文本类资料用 kb-add-text/kb-upsert-text，本地文件/目录用 kb-add-file/kb-add-folder，构建需先执行 kb-build 再通过 kb-build-wait 等待完成，删除文件前需用 kb-status 确认目标。

适用边界与注意点

需确保 Mira 桌面端已运行且本地服务端口可访问，若默认端口失败，需按顺序尝试 8092、8080 等常见端口（可在「回复设置->高级参数->运行时」查看实际端口）。
优先通过脚本调用，除非脚本无法满足需求，否则不建议直接手写 HTTP 请求；调用时以联系人名称为主，contact_id 仅作为备用主键。
知识库仅支持文本类资料，含图片的文档需先提取文本再入库；非 Plus 用户使用知识库功能会触发权限错误，需先确认授权状态。