cotrace#

基于 Pieces OS + Cotrace 的工作轨迹自动采集能力。用于获取用户的实际工作活动数据。

注意：工具返回的时间戳为 UTC 格式（以 Z 结尾）。展示给用户时需转换为本地时区。如果用户使用中文，可假定为北京时间（UTC+8）。

触发条件#

• 用户说"帮我看看最近做了什么"
• 用户说"查一下我今天的工作记录"
• 需要获取用户实际工作活动数据时

排除场景#

• 任务创建/更新/汇报 → 转到 auwomo-task
• 发消息 → 转到 auwomo-message
• Cotrace 未安装或不可用 → 引导安装（见 references/install.md）

健康检查#

执行以下命令确认 Cotrace 服务可用：

bash

ftc health cotrace

如果输出不包含 "ok":true，参考 install.md 排查。

工作流程#

1. 查询摘要：用 get_workstream_summaries 按时间范围搜索工作记录
2. 获取详情：用 get_workstream_summaries_details 根据返回的 ID 获取完整内容（含 AI 标注）

命令速查表#

1. 查询工作摘要#

bash

echo '{"tool":"get_workstream_summaries","args":{"created":{"from":"<ISO_START>","to":"<ISO_END>"}}}' | ftc call cotrace

created.from 和 created.to 均为可选（ISO 8601 格式），按需使用。

2. 获取详细内容#

bash

echo '{"tool":"get_workstream_summaries_details","args":{"identifiers":["<UUID_1>","<UUID_2>"]}}' | ftc call cotrace

示例#

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

bash

# 1. 查询今天的记录
echo '{"tool":"get_workstream_summaries","args":{"created":{"from":"2026-05-13T00:00:00Z","to":"2026-05-13T23:59:59Z"}}}' | ftc call cotrace

# 2. 获取详细内容
echo '{"tool":"get_workstream_summaries_details","args":{"identifiers":["<返回的ID>"]}}' | ftc call cotrace

参考文档路由#

场景文档首次安装配置install.md健康检查失败 / 服务不可用install.md