2026/9/14 2:54:42
FEATURED · 精选文章 
screenpipe 如何生成可复核的顾问工时报告activity-summary 搜索佐证【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe本文解决一个具体任务独立顾问或自由职业者需要向客户提交一份可复核的工时报告——活跃时长有权威数值、每个工作块有屏幕/音频证据、模糊时段被明确标出而不是被硬塞进某个项目。screenpipe 在本机持续记录屏幕与音频并提供本地 APIlocalhost:3030/activity-summary给出时段的活跃时间数值/search在同一时间窗内提供项目术语、文档标题、会议等佐证内容。文档给出的定位是“defensible draft report”——一份可辩护的报告草稿而不是未经审阅就直接发出的工时单。适用前提screenpipe 已在本机安装并正在运行且你只记录自己授权的设备不要在没有授权和明确政策的情况下捕捉客户的设备或员工。准备先约定报告范围与隐私设置consultant time tracking 建议用一个最小试点开始维度建议人员一名顾问用自己的设备工作一个客户或项目周期一到两周产出日期、活跃分钟数、工作块、交付物、不确定时间验收顾问审阅客户认可详细程度有用在开始记录之前先和客户约定项目范围、工作时间、排除的应用、保留期以及客户收到的是叙述性细节还是仅合计。然后在应用里打开Settings → Privacy把密码管理器、个人聊天、银行、健康类应用、无关客户以及其他不需要进入报告的敏感界面加入排除。这一步决定报告里不会混入不该出现的内容是“可复核”的基础之一。跑一小段工作并确认采集正常正式出报告前先录 15–30 分钟有代表性的工作确认 timeline 中包含预期的应用、音频只在需要时才被采集。这一步失败的话后面所有数值都没有意义。确认本地 API 可用/health是唯一不需要鉴权的端点curl http://localhost:3030/health如果刚启动时接口返回空数据API reference 给出的解释是采集尚未完成处理等待 1–2 分钟后重试。用 /activity-summary 取权威活跃时间受保护端点需要 API 鉴权。每个 shell 获取一次本地 keyexport SCREENPIPE_API_KEY$(npx -y screenpipelatest auth token)也可以在Settings → Privacy → API security里查看该 key。如果请求来自直接调用 API 的脚本还需固定加上请求头X-Screenpipe-Client: api用于把请求标识为外部 API 客户端不要把 agent 名、客户名或 prompt 放进这个头。对目标时段请求汇总curl -H Authorization: Bearer $SCREENPIPE_API_KEY \ http://localhost:3030/activity-summary?start_time4hagoend_timenowstart_time/end_time接受4h ago、now这类相对值也接受 ISO 8601 UTC 时间戳。文档的建议相对范围适合首次测试当报告必须对齐精确的日历或计费窗口时改用 ISO 8601 UTC。按 OpenAPI 定义返回体包含apps每个应用的name、minutes、frame_count、first_seen、last_seen、recent_texts、audio_summary、total_frames和time_range体积约 200–500 tokens适合喂给模型做归类。使用规则只有一条但很关键用/activity-summary的数值作为活跃时间的权威来源让模型只对这些块按客户/项目归类绝不从帧数、OCR 行数或搜索结果数量反推工时。如果你的脚本要对很多时段做纯工时扫描还可以把include_key_texts、include_apps或include_windows设为false省略对应部分降低 token 开销默认值不变见 changelog。用同一时间窗的 /search 收集佐证拿到数值后在完全相同的时间窗内搜索项目术语、文档标题、会议与交付物作为每个工作块的证据curl -H Authorization: Bearer $SCREENPIPE_API_KEY \ http://localhost:3030/search?qproject-or-client-codecontent_typeallstart_time4hagoend_timenowlimit50q里的project-or-client-code替换成你自己的项目代号或客户名。content_typeall会跨 accessibility 文本、OCR 回退文本、音频转录、输入事件、应用名、窗口标题和浏览器 URL 搜索。常用收窄参数完整清单见 API recipes参数用途app_name限定某个桌面应用browser_url对已捕获浏览器元数据做精确或归一化匹配URL 子串搜索要用qspeaker_name找某个人说了什么start_time/end_time限定会议、工作块相对值或 ISO 8601 UTClimit/offset分页把搜索结果当作“这个块在做什么”的佐证而不是时间来源。分不出归属的块放进 “unassigned / needs review”不要为了报告好看而强行贴标签。把数据整理成可复核的报告文档提供了一份可以直接复制的报告 prompt要求把观察到的事实与推断出的项目标签分开Create a draft client work report from the supplied activity summary and search results. Rules: - use activity-summary values for numeric time totals - group work into coherent blocks, not individual frames - separate observed facts from inferred project labels - put ambiguous time in needs review - exclude personal or unrelated-client content - list deliverables and decisions only when the source data supports them Output: 1. total active time 2. table of work blocks: time, project, activity, supporting app or document 3. deliverables and decisions 4. needs-review items报告生成后按文档的审阅步骤走把合计与日历和已知的休息时段对照删掉无关细节修正项目标签对估计值做明确标注。确认无误后把审阅结果导出到你惯用的 timesheet 或附到发票上——“share the smallest useful report”即只交付最小的、能站得住脚的信息量。可选多份报告稳定后再用 pipe 固化当连续几份手工报告的时间合计与项目标签都正确之后可以在Pipes → My Pipes → create your own pipe里粘贴以下描述让 screenpipe 生成一个手动 pipeCreate a manual pipe that writes a local client work report. use/activity-summaryfor numeric totals, bounded/searchresults for context, put ambiguous time in needs review, and never send or invoice automatically.生成完成后回到Pipes → My Pipes运行一次并检查它的 Markdown 产物与执行日志确认空数据窗口会产出显式的 no-data 报告。生成的自动化就是~/.screenpipe/pipes/下的一个pipe.md文件可以检查和纳入版本管理。文档明确提醒不要一开始就自动化发送报告、创建发票、写入客户系统或把每个推断块同步到工时工具日程daily/weekly schedule也应加在若干份报告稳定之后。如果客户更关心产出与下一步而不是小时数可以改用 weekly client report 的工作流outcome、decisions、risks参数细节和更多搜索组合继续参考 API recipes。报告的本质边界不变它是本地数据生成的、经人工审阅的草稿发送与否始终由你在正常渠道里决定。【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
screenpipe 如何生成可复核的顾问工时报告（activity-summary + 搜索佐证）？
screenpipe 如何生成可复核的顾问工时报告activity-summary 搜索佐证【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe本文解决一个具体任务独立顾问或自由职业者需要向客户提交一份可复核的工时报告——活跃时长有权威数值、每个工作块有屏幕/音频证据、模糊时段被明确标出而不是被硬塞进某个项目。screenpipe 在本机持续记录屏幕与音频并提供本地 APIlocalhost:3030/activity-summary给出时段的活跃时间数值/search在同一时间窗内提供项目术语、文档标题、会议等佐证内容。文档给出的定位是“defensible draft report”——一份可辩护的报告草稿而不是未经审阅就直接发出的工时单。适用前提screenpipe 已在本机安装并正在运行且你只记录自己授权的设备不要在没有授权和明确政策的情况下捕捉客户的设备或员工。准备先约定报告范围与隐私设置consultant time tracking 建议用一个最小试点开始维度建议人员一名顾问用自己的设备工作一个客户或项目周期一到两周产出日期、活跃分钟数、工作块、交付物、不确定时间验收顾问审阅客户认可详细程度有用在开始记录之前先和客户约定项目范围、工作时间、排除的应用、保留期以及客户收到的是叙述性细节还是仅合计。然后在应用里打开Settings → Privacy把密码管理器、个人聊天、银行、健康类应用、无关客户以及其他不需要进入报告的敏感界面加入排除。这一步决定报告里不会混入不该出现的内容是“可复核”的基础之一。跑一小段工作并确认采集正常正式出报告前先录 15–30 分钟有代表性的工作确认 timeline 中包含预期的应用、音频只在需要时才被采集。这一步失败的话后面所有数值都没有意义。确认本地 API 可用/health是唯一不需要鉴权的端点curl http://localhost:3030/health如果刚启动时接口返回空数据API reference 给出的解释是采集尚未完成处理等待 1–2 分钟后重试。用 /activity-summary 取权威活跃时间受保护端点需要 API 鉴权。每个 shell 获取一次本地 keyexport SCREENPIPE_API_KEY$(npx -y screenpipelatest auth token)也可以在Settings → Privacy → API security里查看该 key。如果请求来自直接调用 API 的脚本还需固定加上请求头X-Screenpipe-Client: api用于把请求标识为外部 API 客户端不要把 agent 名、客户名或 prompt 放进这个头。对目标时段请求汇总curl -H Authorization: Bearer $SCREENPIPE_API_KEY \ http://localhost:3030/activity-summary?start_time4hagoend_timenowstart_time/end_time接受4h ago、now这类相对值也接受 ISO 8601 UTC 时间戳。文档的建议相对范围适合首次测试当报告必须对齐精确的日历或计费窗口时改用 ISO 8601 UTC。按 OpenAPI 定义返回体包含apps每个应用的name、minutes、frame_count、first_seen、last_seen、recent_texts、audio_summary、total_frames和time_range体积约 200–500 tokens适合喂给模型做归类。使用规则只有一条但很关键用/activity-summary的数值作为活跃时间的权威来源让模型只对这些块按客户/项目归类绝不从帧数、OCR 行数或搜索结果数量反推工时。如果你的脚本要对很多时段做纯工时扫描还可以把include_key_texts、include_apps或include_windows设为false省略对应部分降低 token 开销默认值不变见 changelog。用同一时间窗的 /search 收集佐证拿到数值后在完全相同的时间窗内搜索项目术语、文档标题、会议与交付物作为每个工作块的证据curl -H Authorization: Bearer $SCREENPIPE_API_KEY \ http://localhost:3030/search?qproject-or-client-codecontent_typeallstart_time4hagoend_timenowlimit50q里的project-or-client-code替换成你自己的项目代号或客户名。content_typeall会跨 accessibility 文本、OCR 回退文本、音频转录、输入事件、应用名、窗口标题和浏览器 URL 搜索。常用收窄参数完整清单见 API recipes参数用途app_name限定某个桌面应用browser_url对已捕获浏览器元数据做精确或归一化匹配URL 子串搜索要用qspeaker_name找某个人说了什么start_time/end_time限定会议、工作块相对值或 ISO 8601 UTClimit/offset分页把搜索结果当作“这个块在做什么”的佐证而不是时间来源。分不出归属的块放进 “unassigned / needs review”不要为了报告好看而强行贴标签。把数据整理成可复核的报告文档提供了一份可以直接复制的报告 prompt要求把观察到的事实与推断出的项目标签分开Create a draft client work report from the supplied activity summary and search results. Rules: - use activity-summary values for numeric time totals - group work into coherent blocks, not individual frames - separate observed facts from inferred project labels - put ambiguous time in needs review - exclude personal or unrelated-client content - list deliverables and decisions only when the source data supports them Output: 1. total active time 2. table of work blocks: time, project, activity, supporting app or document 3. deliverables and decisions 4. needs-review items报告生成后按文档的审阅步骤走把合计与日历和已知的休息时段对照删掉无关细节修正项目标签对估计值做明确标注。确认无误后把审阅结果导出到你惯用的 timesheet 或附到发票上——“share the smallest useful report”即只交付最小的、能站得住脚的信息量。可选多份报告稳定后再用 pipe 固化当连续几份手工报告的时间合计与项目标签都正确之后可以在Pipes → My Pipes → create your own pipe里粘贴以下描述让 screenpipe 生成一个手动 pipeCreate a manual pipe that writes a local client work report. use/activity-summaryfor numeric totals, bounded/searchresults for context, put ambiguous time in needs review, and never send or invoice automatically.生成完成后回到Pipes → My Pipes运行一次并检查它的 Markdown 产物与执行日志确认空数据窗口会产出显式的 no-data 报告。生成的自动化就是~/.screenpipe/pipes/下的一个pipe.md文件可以检查和纳入版本管理。文档明确提醒不要一开始就自动化发送报告、创建发票、写入客户系统或把每个推断块同步到工时工具日程daily/weekly schedule也应加在若干份报告稳定之后。如果客户更关心产出与下一步而不是小时数可以改用 weekly client report 的工作流outcome、decisions、risks参数细节和更多搜索组合继续参考 API recipes。报告的本质边界不变它是本地数据生成的、经人工审阅的草稿发送与否始终由你在正常渠道里决定。【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
