7.0 KiB

Raw Blame History

name	description
小黑日报助手数据查询	查询小黑日报助手的本地数据服务。支持工作时间线、工作报告、时段热力图、应用使用时长等维度的数据查询。当用户询问"今天做了什么"、"查询日报"、"工作效率分析"、"最近的工作时间线"、"看看我这几天的工作"、"热力图"、"各应用使用时长"等问题时自动触发。

小黑日报助手数据查询

概述

小黑日报助手是一个本地运行的 HTTP 数据服务（http://198.120.0.250:8088），提供了工作时间追踪、日报生成、时段热力图、应用使用时长统计等数据查询能力。本 Skill 封装了该服务的接口，让 Agent 能够通过自然语言理解用户意图后调用对应接口。

执行规则

强制规则

每次收到用户查询请求前，必须先调用 GET http://198.120.0.250:8088/ 拉取最新 API 文档（该接口返回 Markdown）。所有后续接口调用必须以最新文档为准，绝对不可依赖记忆。
解析 Markdown 文档后，动态选择接口并构造请求。
使用 fetch_webpage 工具发起所有 HTTP 请求。

响应格式

所有业务接口统一返回 JSON：

{
  "code": 0,
  "message": "success",
  "data": null
}

字段	说明
`code`	0 = 成功；400 = 参数错误；404 = 接口不存在；500 = 服务器错误
`message`	提示信息
`data`	业务数据，结构因接口而异

日期时间参数约定

支持 YYYY-MM-DD（日期精度，自动覆盖 00:00~23:59）和 YYYY-MM-DD HH:mm:ss（秒精度）
未传参数时：时间线/报告/应用时长默认查询今天；热力图默认查询近 7 天
本 Skill 统一使用 YYYY-MM-DD 日期精度格式

接口速查

以下为当前已知接口列表，最终以 GET / 实时拉取的 Markdown 文档为准。

接口	路径	用途	默认时间范围
文档	`GET /`	获取最新 API 文档（Markdown）	-
工作时间线	`GET /api/timeline`	查询工作记录列表	今天
工作报告	`GET /api/report`	查询日报/周报/月报	今天
时段热力图	`GET /api/heat-map`	查询每日 24 小时工作分布	近 7 天
应用使用时长	`GET /api/app-usage`	查询各应用使用时长排行	今天

接口 2：查询工作时间线

GET /api/timeline?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD

data 字段：id, startTime(ISO8601), endTime(ISO8601), category(开发/会议等), summary(内容摘要), details, confidence(AI置信度), source(screenshot/manual), createdAt, updatedAt

接口 3：查询工作报告

GET /api/report?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD

data 字段：id, type(daily/weekly/monthly), title, content(Markdown), startDate, endDate, style, status(completed/pending/failed), language, createdAt, updatedAt

接口 4：查询时段热力图

GET /api/heat-map?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD

data 字段：date, hourlyCounts(长度为24的number[]), focusMinutes(专注时长分钟), totalRecords(非闲置记录总数), topCategory, activePeriod(活跃时段如"09:00 — 18:00")

接口 5：查询应用使用时长

GET /api/app-usage?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD

data 字段：appName, totalDurationSec(秒), firstUsedAt(ISO8601), lastUsedAt(ISO8601)。按 totalDurationSec 降序排列。

工作流程

完整执行步骤

用户提问 → 解析意图与时间范围
         → GET / 拉取最新 API 文档
         → 匹配合适的接口
         → 构造 GET 请求（拼接 query 参数）
         → fetch_webpage 发送请求
         → 解析 JSON 响应
         → 用中文总结数据，呈现给用户

Step 1: 解析用户意图

从用户问题中识别查询类型：

用户表述	接口
"今天做了什么"、"工作时间线"、"工作记录"	`/api/timeline`
"日报"、"周报"、"报告"、"今天报告写了什么"	`/api/report`
"热力图"、"效率分析"、"哪个时段最忙"、"工作分布"	`/api/heat-map`
"哪些应用"、"应用使用排行"、"哪个APP用的最久"	`/api/app-usage`

可以从一帧提示中识别多类意图，并行调用多个接口。

Step 2: 解析时间范围

"今天" → 不传参数（接口默认今天）
"昨天" → startDate=YYYY-MM-DD(昨天)&endDate=YYYY-MM-DD(昨天)
"最近3天" → startDate=3天前&endDate=今天
"上周" → startDate=上周一&endDate=上周日
"5月15号" → startDate=2026-05-15&endDate=2026-05-15
"5月1号到5月15号" → startDate=2026-05-01&endDate=2026-05-15

日期计算规则：所有日期统一使用 YYYY-MM-DD 格式。如用户说话时未指定年份，默认为当前年（基于对话 session 的 current date 推断）。

Step 3: 拉取最新文档

GET http://198.120.0.250:8088/

用 fetch_webpage 工具请求，拿到 Markdown 文档后解析接口列表。

Step 4: 调用业务接口

示例：

# 查询今天的工作时间线
GET http://198.120.0.250:8088/api/timeline

# 查询 5月1日到5月15日的工作报告
GET http://198.120.0.250:8088/api/report?startDate=2026-05-01&endDate=2026-05-15

用 fetch_webpage 工具，传入对应 URL 和描述性 query。

Step 5: 呈现结果

将返回的 JSON 数据用中文自然语言总结呈现。原则：

工作时间线：按时间段列出，标注分类和摘要
工作报告：显示 Markdown 内容（如果多篇，逐篇列出标题和摘要）
热力图：描述峰值时段和活跃分布
应用时长：按使用时长降序列出并标注占比

错误处理

错误码	处理方式
400	检查日期格式是否正确（须为 `YYYY-MM-DD`）
404	接口不存在 → 重新拉取 `GET /` 确认接口列表
500	向用户说明服务器内部错误，建议稍后重试
网络不通	向用户说明无法连接 `198.120.0.250:8088`，请确认服务是否运行

示例对话

用户："我今天做了什么？"

Agent 行为：

fetch_webpage("http://198.120.0.250:8088/") → 拿到 API 文档
识别意图：工作时间线 → /api/timeline
识别时间："今天" → 不传参数
fetch_webpage("http://198.120.0.250:8088/api/timeline") → 拿到 data
呈现：

📊 今天的工作时间线

时间分类内容

09:00-09:30 开发修复登录页 bug

09:30-10:00 会议每日站会

...

时间	分类	内容
09:00-09:30	开发	修复登录页 bug
09:30-10:00	会议	每日站会
...

用户："看看我最近一周的效率怎么样"