Factory Log最新版

官方版无广告32

Factory Log 是 macOS 平台编程智能体工作量统计工具，专门用来可视化 AI编程智能体执行的各项操作，生成按天、按周的时间线，统计工时在各个项目上的分配情况。

更新日期：

2026年10月7日

分类标签：

AI编程Factory Log

语言：

中文

平台：

4.56MB0 人已下载手机查看

Factory Log 是 macOS 平台编程智能体工作量统计工具，专门用来可视化 AI编程智能体执行的各项操作，生成按天、按周的时间线，统计工时在各个项目上的分配情况。Codex、Cursor、Claude Code 这类编程智能体完成任务时输出一行工作报告，信息会实时写入本地日志文件，立刻在应用界面展示。

当AI代理一天之内跨多个项目编码，事后很难复盘到底完成了哪些工作。Factory Log 由代理自行上报工作记录，全部日志保存在本机普通文件里，不会读取你的源代码、代码差异和终端输出。

下载与系统要求

获取 Factory-Log-1.2.0.zip，解压后将应用拖入「应用程序」文件夹。

系统最低要求：macOS 15 Sequoia 及以上，Apple芯片、Intel Mac均可运行。

首次打开与更新

App带有Apple Developer ID签名并且经过公证，首次打开macOS会弹出互联网下载应用确认弹窗，直接点击打开即可。

如果工作电脑无法写入系统 /Applications，可放置在个人目录内的应用文件夹。

更新机制：每日自动访问GitHub检测新版本，发现更新会展示更新日志，一键安装重启。

手动检查：Factory Log →「检查更新…」。

关闭自动更新检查，终端执行：

defaults write dev.factorylog.app AppUpdaterAutomaticChecks -bool false

工作原理与设置

代理不会直接和App通信，代理调用一条轻量命令 factorylog，向本地日志文件追加记录，App监听日志文件实现实时展示。配置分为三步：

安装命令行工具
App把factorylog复制到~/.local/bin，自动检测shell环境PATH。zsh环境可一键把目录写入~/.zshenv。
连接编程智能体
Codex：一键写入~/.codex/AGENTS.md，并在codex配置中添加日志目录沙盒写入权限。
Cursor：向~/.cursor/rules添加规则。
指令会定义代理什么时候上报工作，以及禁止上报哪些敏感内容。
测试代理上报
代理仅记录实际改动类工作：功能开发、bug修复、文档编写。单纯提问、解释内容不会写入日志。
内置「发送测试报告」，无需运行代理即可验证整套链路。

新增代理入口：设置 → 集成。

兼容更多编程智能体

任何支持执行shell命令的AI代理都可以接入，复制预设指令粘贴到代理常驻配置文件：

Claude Code：~/.claude/CLAUDE.md
Gemini CLI：~/.gemini/GEMINI.md
大部分代理读取项目根目录 AGENTS.md

沙盒运行的代理，需要授予写入 ~/Library/Application Support/Factory Log 的权限。

排查：报告不显示

按顺序逐项排查：

终端执行 command -v factorylog，校验命令是否被shell识别。找不到就添加PATH。
zsh示例：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshenv

修改后重启代理，加载新环境变量。
2. 设置→集成发送测试报告，测试成功则问题出在代理配置。
3. 新建代理会话，代理仅在会话启动时读取指令；Cursor需要重启加载新规则。
4. Codex沙盒权限：手动编辑~/.codex/config.toml，将日志路径加入可写根目录

[sandbox_workspace_write]
writable_roots = ["/Users/you/Library/Application Support/Factory Log"]

确认是真正改动任务，单纯问答、解释内容不会记录。

核心功能

当日/昨日视图：展示活跃时长、涉及项目、已完成任务。时间线泳道图按项目区分，鼠标悬停查看任务详情。任务列表按最新排序，进行中任务标记状态，可关闭并填写最终结果。
项目一句话回顾：完成的工作日，可借助本地Ollama模型自动生成项目总结；无本地模型时展示任务标题。
周总览：一行代表一天，会话色块按项目着色；附带本周工时环形图、交付清单，支持翻阅历史周。
长期洞察视图：7/30/90天/全时段项目工时统计、26周热力图，点击项目查看每日节奏与全部历史任务。
实时更新：监听本地日志，新任务自动出现，无需手动刷新。
隐藏项目：右键隐藏不重要项目，设置面板恢复；代理配置目录内的工作默认不展示。
快捷键操作
⌘1~⌘4 切换「今天/昨天/周/洞察」视图；方向键切换日志与摘要、翻周；Esc返回上一级。