小黑日报助手

Agent 与工具接口说明

小黑数据能力

适合提供给可信 Agent 的只读能力包括:

  • 查询指定日期的工作概览;

  • 查询时间线原始记录;

  • 查询历史报告;

  • 查询热力图与工作节奏;

  • 查询应用使用统计;

  • 读取用户主动维护的个人资料。

写入工作记录属于状态变更,必须由用户明确提出或确认。第三方 Agent 不应把推测当作记录写入。

通知发布 API

支持的 Agent 可通过本地服务向小黑发布通知。通知应包含清楚的来源、标题、摘要、类型和可定位的目标;不得发送垃圾通知、冒充系统消息或在未经允许时携带敏感信息。任务完成、等待确认与定时提醒应使用不同类型,便于客户端采用正确的消费和保留策略。

接口安全

  • 优先仅绑定本机地址;

  • 使用客户端生成或展示的鉴权信息;

  • 限制调用频率和数据范围;

  • 记录必要的请求日志但不记录密钥和完整敏感正文;

  • 对写入、删除和外部操作实施确认;

  • 停用 Agent 后同步关闭服务或撤销凭据。

最后更新于 2026-09-09 15:26:18