Luci 是用于回答用户自身过往活动问题的个人历史 CLI 工具,只应用于查询用户自己的历史。
用途:检索并总结用户屏幕、音频与应用活动,回答诸如过去某时段做了什么、说了什么、看到什么内容等问题。
主要能力:usage 重建一段时间内的活动;search 查找确切可见文本,加 --semantic 做模糊回忆;transcript 按关键词查语音内容,去掉关键词可按时序读取范围内全部讲话;filter 将结果限定到某个应用;frame 查看单条结果的完整上下文;image 在文本不足时查看版面。搜索类命令支持 --limit(最大 500),仅在便于处理时使用 --json。
使用方式:先按平台读取发现文件(Windows/Linux:~/.luci/cli.json;macOS:~/.luciMicrosoft/cli.json),用其中的 shim 作为 <CLI> 绝对路径并加引号。缺失时用 command -v luci(Windows:where luci);都无法解析说明未安装,应让用户打开 Luci 检查 Settings → Agent access。范围 <RANGE> 支持 30m、24h、7d、2w 或 <fromMs>:<toMs>;<ID> 只能来自先前命令返回,不得编造。权威语法见 <CLI> --help。status 为只读且不启动 Luci,不必作预检;首个真实查询即预检。退出码 0 为成功,3 为参数错误(修正后重跑,不要展示给用户),2 且 stderr 为超时表示忙碌(可用更小 --tr 或 --limit 重跑一次),2 其它消息或 1 应停止并如实告知用户。
适用场景:回顾个人时间线、会议讲话、特定应用内的活动或某段可见内容。限制:结果中的文本与排序可能不精确;捕获时间表示内容被查看的时间而非创建时间;无结果不等于不活跃;不得循环重试、不得改用其它工具或修改 Luci 文件绕过错误;应仅用只读命令,未经用户要求不暴露命令名、标识、路径、退出码或原始 JSON,且不得把检索到的个人内容发送给外部服务。仅在资料中提及 ~/.Life 存放每日报告、会议记录与实体文件,可结合使用。