convez.ai
AgenteProdutividadeAvançado
shaoyang01

Work Journal Agent

shaoyang01/work-journal-agent

Agrega evidências de codificação em diários estruturados do Obsidian

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent local-first que integra Codex, Claude Code e OpenCode em notas diárias do Obsidian, consolidando requisitos, discussões, conclusões e artefatos de código. Automatiza a geração de diários de trabalho estruturados a partir de múltiplas fontes de IA, com suporte a síntese por IA (DeepSeek) ou regras locais.

Instalação

$npx convez-ai shaoyang01/work-journal-agent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.12.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar automaticamente notas diárias sintetizando trabalho em múltiplos agents de IA
  • Consolidar requisitos, decisões técnicas e artefatos produzidos em um único lugar
  • Manter histórico local-first de sessões Codex, Claude Code e ferramentas similares

Veredito

Solução madura e bem pensada para quem trabalha com múltiplos agents de IA e precisa de rastreabilidade estruturada. Excelente automação de síntese, mas requer setup inicial e Obsidian instalado; público é especializado (desenvolvedores usando agents locais).

README

A tradução para o português deste README ainda está na fila.

work-journal-agent

本地优先的工作日志代理,用来把 Codex、OpenCode、Claude Code、手动标记和 Git 证据整理成 Obsidian 工作笔记。

它的目标不是保存完整聊天记录,而是沉淀任务资产:原始需求、讨论方案、最终结论、产出和后续。

适合谁

  • 同时使用 Codex、OpenCode、Claude Code 或其他本地 Agent 工具。
  • 希望每天自动生成 Obsidian 工作记录。
  • 希望在多台个人设备上安装使用,同时也能分享给别人。

安装

内部试用 macOS 版可以直接下载 Release 里的 DMG:

  1. 打开 GitHub Releases。
  2. 下载 Work-Journal-Agent-版本号.dmg。
  3. 打开 DMG,把 Work Journal Agent.app 拖到 Applications。
  4. 首次打开如果提示无法验证开发者,请在 系统设置 -> 隐私与安全性 中允许打开。
  5. 点击顶部菜单栏 WJ 图标,进入设置窗口配置 Obsidian、Agent 数据源和 DeepSeek。

这个 DMG 是未公证的内部试用包,适合同事先体验;正式分发前还需要 Apple Developer 签名和 notarization。

macOS 最简单方式:在 Finder 里双击:

Install.command

它会自动安装工具,并用中文询问 Obsidian 路径、是否启用 DeepSeek、是否配置 Claude Code hooks、是否安装后台自动写入器。

源码目录内也可以运行启动脚本:

macOS/Linux:

./scripts/install.sh

Windows PowerShell:

.\scripts\start.ps1

如果想接受默认值快速初始化:

./scripts/install.sh --yes

开发安装:

python -m pip install -e .

如果你使用 uv:

uv tool install .

安装后会得到两个等价命令:

wj --help
work-journal-agent --help

配置

安装后也可以直接运行配置向导:

wj setup

配置向导会询问:

  • 配置文件路径。
  • inbox JSONL 路径。
  • Obsidian vault 路径。
  • Daily / Tasks 目录名。
  • 是否写独立任务笔记。
  • Knowledge 目录名。
  • 是否生成或更新知识专题笔记。
  • 是否启用 DeepSeek AI 分析;启用时会继续询问 API Key,并保存到本机私有 secrets.env。
  • 如果不启用 DeepSeek,则使用本地规则摘要。
  • 是否启用 Codex 采集;启用后会询问 sessions 根目录。
  • 是否启用 Claude Code 采集 hooks;启用后才会询问 settings.json 路径。
  • 是否启用 OpenCode 采集插件;启用后才会询问插件保存路径。
  • 是否启用 Kun Agent 采集;启用后会询问 Kun 本地数据目录和项目根目录。
  • 是否启用 ZCode 采集;启用后会询问 ZCode 本地数据目录。

手动配置方式如下。

复制配置模板:

mkdir -p ~/.config/work-journal-agent
cp config/config.example.toml ~/.config/work-journal-agent/config.toml

Windows 可以放到:

%APPDATA%\work-journal-agent\config.toml

最小配置:

[storage]
inbox_path = "~/.local/share/work-journal-agent/inbox/events.jsonl"
output_dir = "./out"

[obsidian]
vault_path = "/path/to/your/ObsidianVault"
daily_dir = "Daily"
task_dir = "Tasks"
write_task_notes = false

vault_path 留空时,会写到 storage.output_dir,方便先试跑。

手动记录事件

日常临时记一条,优先用短命令:

wj note "今天完成了 work-journal-agent 的自动采集和后台写入"

更完整的事件命令仍然保留:

wj event add \
  --source codex \
  --type conclusion \
  --summary "确定采用 Claude hooks + JSONL inbox 方案" \
  --decision "第一版先做本地 CLI,不做后台服务"

记录文件产出:

wj event add \
  --source manual \
  --type note \
  --summary "补充 README 安装说明" \
  --file README.md

生成每日笔记

正常情况下不需要手动运行,macOS 会通过 launchd 后台定期执行:

wj sync

它会先导入已启用来源的当天事件,包括 Codex session、OpenCode 本地事件、Kun Agent 本地数据和 ZCode 本地会话,再生成今天的 Obsidian Daily。Knowledge 不会在 wj sync 中生成,避免日报和知识沉淀共用一次长时间等待。

手动预览:

wj sync --date 2026-06-11 --dry-run

写入 Obsidian 或 fallback 输出目录:

wj sync --date 2026-06-11

实验性代码库知识生成默认关闭。只有同时开启 [ai].knowledge_enabled 和 [obsidian].write_knowledge_notes 后,才会单独生成 Knowledge:

wj generate-knowledge --date 2026-06-11

当前建议保持关闭,等知识沉淀策略明确后再启用。

需求确认与菜单栏 App

如果 Daily 里出现文件路径式标题,或同一个需求跨 Claude/Codex 多轮方案、实现、review,可以用 macOS 顶部菜单栏 App 直接弹出原生确认窗口:

scripts/install-menubar.sh

安装后顶部状态栏会出现 WJ。点击菜单可以:

  • 打开今日需求确认窗口
  • 同步最新事件
  • 生成今日日报
  • 打开设置窗口
  • 打开本地数据目录和日志

如果只想生成一个可双击的本机测试版,不安装到 ~/Applications,可以构建到 dist/:

scripts/build-local-app.sh

然后在 Finder 里双击:

dist/Work Journal Agent.app

这个本机测试版会绑定当前仓库路径,并调用当前仓库下的 Python CLI。移动仓库后需要重新构建。

构建可分享的内部试用 DMG:

scripts/build-dmg.sh

产物会写到:

dist/Work-Journal-Agent-版本号.dmg

DMG 内的 App 会内置当前版本源码,不要求试用者先 clone 仓库;但仍依赖试用者本机有 python3。

菜单栏 App 不启动本地 HTTP 服务,也不打开浏览器。它通过 CLI JSON 通道调用本地核心逻辑:

wj requirements payload --date 2026-06-12
wj requirements save --date 2026-06-12
wj app config
wj app config-save
wj app status

确认窗口会列出当天候选需求,支持改标题、确认、标记待确认或忽略。保存后会写入本机:

~/.local/share/work-journal-agent/requirements/threads.json
~/.local/share/work-journal-agent/requirements/daily/YYYY-MM-DD.json
~/.local/share/work-journal-agent/state/status.json

后续 wj generate-daily 会优先使用已确认的需求标题。

本地 HTML 确认页仍保留为调试入口,需要时可手动启动:

wj requirements review --date 2026-06-12

OpenCode 采集

安装向导默认会询问是否配置 OpenCode 采集插件。启用后会生成:

~/.config/opencode/plugins/work-journal-agent.js

OpenCode 启动时会自动加载这个插件,插件会把消息、工具执行、文件变更、session diff 等事件写入 work-journal-agent。重复运行 wj setup 会刷新这个插件文件。

导入当天 OpenCode 本地事件:

wj opencode import --date 2026-06-11

默认读取:

~/.local/share/opencode/storage

也可以指定路径:

wj opencode import --storage-root /path/to/opencode/storage

如果你写 OpenCode 插件,可以把插件事件 JSON 通过 stdin 交给:

wj opencode hook

采集器只保存工作日志需要的摘要、文件列表、工具名和会话标识;不会把 OpenCode diff 的 before/after 全量内容写入 inbox。

卸载时会删除由 work-journal-agent 生成的 OpenCode 插件:

wj uninstall

如果安装时用了自定义插件路径,卸载时可以指定:

wj uninstall --opencode-plugin /path/to/work-journal-agent.js

Kun Agent 采集

Kun Agent 采集默认关闭。开启后,wj sync 会读取 Kun 本地 threads 和当前项目的 .kunsdd 文档,导入用户需求、结论、工具/文件事件和需求文档摘要。采集器使用稳定 key 去重,重复运行不会重复写入 inbox。

配置文件示例:

[sources.kun]
enabled = true
storage_root = "~/.kun/data"
project_root = "/path/to/project"

也可以在顶部菜单栏 App 的设置窗口里开启 Kun,配置 Kun 本地数据目录和 Kun 项目根目录。

手动导入当天 Kun 事件:

wj kun import --date 2026-06-11

如果 Kun 安装路径不同,可以显式指定:

wj kun import --storage-root /path/to/kun --project-root /path/to/project

ZCode 采集

ZCode 采集默认会在检测到 ~/.zcode/cli 时启用。采集器只读本地 sqlite 数据库,导入用户需求、助手结论、工具执行和 session 文件变更摘要;不会读取完整 rollout 请求体,避免把 system prompt、headers 和完整上下文写入 inbox。

配置文件示例:

[sources.zcode]
enabled = true
storage_root = "~/.zcode/cli"

也可以在顶部菜单栏 App 的设置窗口里开启 ZCode,配置 ZCode 本地数据目录。

手动导入当天 ZCode 事件:

wj zcode import --date 2026-06-11

如果 ZCode 安装路径不同,可以显式指定:

wj zcode import --storage-root /path/to/.zcode/cli

后台自动写入

macOS 下配置向导会询问是否安装后台自动写入器。开启后会创建:

~/Library/LaunchAgents/com.shaoyang01.work-journal-agent.daily.plist

默认每 60 分钟刷新一次今天的 Daily,电脑重启并登录后会自动恢复。 如果启用了 DeepSeek,后台任务会自动加载:

~/.config/work-journal-agent/secrets.env

这个文件权限会设置为 600,不要提交到 Git。

DeepSeek AI 分析

安装向导会询问是否启用 DeepSeek AI 分析:

是否启用 DeepSeek AI 分析,让它帮助整理每日工作摘要

如果选择启用,可以直接输入 API Key。它会写入本机私有文件:

~/.config/work-journal-agent/secrets.env

如果机器上已经有 DEEPSEEK_API_KEY 环境变量,也可以在安装器询问 API Key 时直接回车使用现有环境变量。

export DEEPSEEK_API_KEY="你的 key"

配置文件中对应开关:

[ai]
enabled = true
provider = "deepseek"
base_url = "https://api.deepseek.com"
model = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"
timeout_seconds = 180
cache_enabled = true
cache_retention_days = 7
cluster_review_enabled = true
cluster_review_timeout_seconds = 240
cluster_review_min_confidence = 0.75
knowledge_enabled = false

DeepSeek 只会收到已经筛选压缩过的任务事件,不会上传完整 Codex/Claude/OpenCode 聊天全文。AI 结果默认按天缓存在 ~/.local/share/work-journal-agent/ai-cache/YYYY-MM-DD.json,保留最近 7 天;如果任务没有新增事件,会复用缓存而不重复调用 DeepSeek。

启用 cluster_review_enabled 后,今日需求确认和生成 Daily 前都会先让 DeepSeek 审查规则聚类结果。带 session_id 的 agent 事件会先按会话拆开,再由 DeepSeek 判断哪些会话属于同一需求;高置信度建议会自动合并同一任务或拆分误合并任务;低置信度、返回异常或调用失败时保持本地规则聚类结果,确认页和日报仍会正常生成。cluster_review_timeout_seconds 只控制需求聚类复核,普通摘要仍使用 timeout_seconds。

DeepSeek 摘要还会识别重要产出:把“修改了哪些文件”提升为“真正完成了什么”,并在 Daily 中展示影响、验证证据和关键产物路径。旧缓存或旧模型只返回 outputs 时,会自动按旧字段回退展示。

Knowledge 生成功能目前是实验性能力,默认关闭。只有开启 [ai].knowledge_enabled = true 且 [obsidian].write_knowledge_notes = true 时,wj generate-knowledge 才会调用 DeepSeek;关闭时不会调用 DeepSeek,也不会执行本地 Knowledge 兜底写入。

已经安装过之后,也可以只配置 DeepSeek:

wj ai setup

它会询问 API Key,并自动完成:

  • 写入 ~/.config/work-journal-agent/secrets.env
  • 开启配置文件里的 [ai].enabled
  • 重新安装后台自动同步任务

关闭 DeepSeek 辅助总结:

wj ai disable

手动安装或重装:

wj schedule install --every-minutes 60

查看状态:

wj schedule status

卸载后台任务:

wj schedule uninstall

Codex 自动采集

Codex 当前通过本地 session 日志导入,不需要 hook:

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl

后台 wj sync 会自动导入当天新增的 Codex 用户需求、最终回复和 patch 文件事件。导入使用稳定 key 去重,重复运行不会重复写入 inbox。

本地验证

PYTHONPATH=src python -m unittest discover -s tests

Claude Code Hooks

安装 CLI 后,可以在 Claude Code settings 中配置 hook。

macOS/Linux 示例:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/work-journal-agent/hooks/claude/hook.sh UserPromptSubmit"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/work-journal-agent/hooks/claude/hook.sh PostToolUse"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/work-journal-agent/hooks/claude/hook.sh Stop"
          }
        ]
      }
    ]
  }
}

Windows PowerShell 示例:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -ExecutionPolicy Bypass -File C:\\path\\to\\work-journal-agent\\hooks\\claude\\hook.ps1 UserPromptSubmit"
          }
        ]
      }
    ]
  }
}

hook 只写轻量事件,不会把 transcript 全量写入 Obsidian。

卸载

macOS 最简单方式:在 Finder 里双击:

Uninstall.command

它会询问是否同时删除配置和历史数据。

macOS/Linux:

./scripts/uninstall.sh

Windows PowerShell:

.\scripts\uninstall.ps1

默认卸载会移除:

  • launchd 后台任务。
  • Claude Code settings 里的 work-journal-agent hooks。
  • Python 包安装。

默认保留配置和历史数据。需要一起删除时:

./scripts/uninstall.sh --remove-config --remove-data

多设备使用建议

  • 项目代码用 Git 同步。
  • 每台设备维护自己的 ~/.config/work-journal-agent/config.toml。
  • Obsidian vault 可以用 iCloud、Syncthing、Git 或 Obsidian Sync 同步。
  • inbox 默认在本机用户目录,不建议提交到仓库。

当前边界

第一版使用确定性规则归并任务:

  • 同一天。
  • 同 repo/cwd。
  • 文件重叠或关键词重叠。

暂不做云端服务、Notion/飞书输出和 GUI。

Ver o original no GitHub

Bom para

Relacionados