tool-journal

让工具重试不再重复执行,崩溃后也能安全恢复

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 基础设施 🍴 复刻 17 🐛 待处理 7 👀 关注 12
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 361
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无付费版本

项目预览

tool-journal 项目界面预览图
图片来源:项目官网

项目数据

分类基础设施
开发团队RaycarlLei
定价模式🏷️完全免费
价格说明开源免费,无付费版本
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai-infrastructure,durable-execution,fault-injection,idempotency,sqlite,typescript
GitHub 星标★ 361
上线时间2026-09-07 00:00:00
代码更新2026-10-14
仓库体积222 KB
本站数据更新2026-11-03
维护状态较活跃
收录时间2026-09-18
浏览次数2

项目介绍

tool-journal 是一个面向可重试工具调用的 TypeScript 执行日志库,核心解决 AI Agent 或自动化流程中工具调用因崩溃、超时、重试导致的状态不一致问题。它把每次工具执行记录到 SQLite,提供持久化存储与租约(lease)机制,确保同一任务不会被并发重复执行;通过显式的“不确定状态”标记,让调用方能区分“确定失败”“确定成功”和“可能已执行但结果未知”,从而做出安全的重试决策。项目还内置故障注入与可复现的崩溃测试,帮助开发者在本地验证重试逻辑和幂等性。适合需要可靠工具编排、任务恢复和精确一次语义的 AI 基础设施场景,用轻量 SQLite 替代复杂分布式协调服务。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-18 · 当前星标 ★ 361

核心亮点

  • 用 SQLite 做持久化执行日志,零外部依赖即可获得崩溃恢复能力
  • 租约 fencing 机制防止并发重复执行,保证同一任务只有一个执行者
  • 显式区分不确定状态,避免盲目重试导致副作用重复

不足之处

  • 项目处于早期,星标仅 142,生态和文档成熟度有限
  • 基于 SQLite 单机方案,多节点横向扩展需自行设计

适用场景

  • AI Agent 调用外部工具(如发邮件、下单)时保证精确一次执行
  • 需要断点续跑和崩溃恢复的自动化工作流
  • 本地开发中模拟工具调用失败,验证重试与幂等策略

替代项目

Temporal、Restate、DBOS

上一篇:brinicle

下一篇:5.0-Ai-Engineering-Toolkit

同类项目推荐

ChatMock 开源

用 Codex 引擎替换 OpenAI API,一行配置即享新能力

OpenAI & Ollama compatible API powered by Codex

★ 1564 2026-08-09
Uptime Kuma 开源

自托管开源监控工具,界面友好

A fancy self-hosted monitoring tool

★ 93209 2026-08-19
hoop 开源

一个网关统一管住 MCP、LLM、数据库和容器的访问策略

Open-source enforcement at runtime that masks sensitive data and blocks destructive ···

★ 842 2026-09-16
vLLM-Hook 开源

给 vLLM 装上状态探针,编程控制模型内部,实现监控与干预。

Repo for vLLM Hook, an vLLM plug-in for programming internal states of models deploy···

★ 170 2026-08-12
ComfyUI-Installer 开源

Linux 上一键装好 ComfyUI,省去手动配环境的麻烦。

Easily install ComfyUI on a Linux system. Installs completely inside a Python venv.

★ 54 2026-08-09
dockit 开源

用大白话聊数据库,AI 帮你查 Elasticsearch、MongoDB 等,可视化监控一把梭。

Agentic desktop GUI client for Elasticsearch, OpenSearch, DynamoDB, MongoDB & EasySe···

★ 1142 2026-08-09
ai 开源

用 Stripe 打通 AI 产品从开发到收费的全流程,快速上线赚钱。

One-stop shop for building AI-powered products and businesses with Stripe.

★ 2033 2026-08-09
aibrix 开源

在 K8s 上跑大模型推理,省钱又弹性

Cost-efficient and pluggable Infrastructure components for GenAI inference

★ 5178 2026-10-14
llm.report 开源

记录 OpenAI 调用日志,分析成本,优化提示词

llm.report is an open-source logging and analytics platform for OpenAI: Log your Cha···

★ 1020 2026-08-09