AI 工程笔记
经 AI Skill Hub 精选评估，AI 工程笔记 获评「推荐使用」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.5 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
AI 工程笔记 依赖 TypeScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 TypeScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 AI 工程笔记 的版本更新，及时通知重要功能变化。
📋 工具概览
生成 LLM 文本，支持 Claude Code 和 Codex 会话
AI 工程笔记 是一款基于 TypeScript 开发的开源工具，专注于 Bun、CLI、SQLite 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
生成 LLM 文本，支持 Claude Code 和 Codex 会话
AI 工程笔记 是一款基于 TypeScript 开发的开源工具，专注于 Bun、CLI、SQLite 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：npm 全局安装 npm install -g engineering-notebook # 方式二：npx 直接运行（无需安装） npx engineering-notebook --help # 方式三：项目依赖安装 npm install engineering-notebook # 方式四：从源码运行 git clone https://github.com/prime-radiant-inc/engineering-notebook cd engineering-notebook npm install npm start
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
engineering-notebook --help
# 基本用法
engineering-notebook [options] <input>
# Node.js 代码中使用
const engineering_notebook = require('engineering-notebook');
const result = await engineering_notebook.run(options);
console.log(result);
# engineering-notebook 配置说明 # 查看配置选项 engineering-notebook --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export ENGINEERING_NOTEBOOK_CONFIG="/path/to/config.yml"
Engineering Notebook
A CLI tool that ingests Claude Code and Codex session transcripts, generates LLM-powered daily summaries, and serves a web UI for browsing your engineering journal.
Think of it as an automatic engineering diary — it watches your AI coding sessions and distills them into a searchable, browsable narrative of what you built, what problems you hit, and what decisions you made.
2. Generate journal summaries (requires ANTHROPIC_API_KEY)
engineering-notebook summarize --all
Install
Requires Bun v1.1+.
git clone https://github.com/prime-radiant-inc/engineering-notebook.git
cd engineering-notebook
bun install
bun link # makes `engineering-notebook` available globallyQuick Start
```sh
Usage
Configuration
Config lives at ~/.config/engineering-notebook/config.json:
{
"sources": ["~/.claude/projects", "~/.codex/sessions"],
"exclude": ["-private-tmp*", "*-skill-test-*"],
"db_path": "~/.config/engineering-notebook/notebook.db",
"port": 3000,
"day_start_hour": 5,
"summary_instructions": "",
"remote_sources": [],
"auto_sync_interval": 60
}| Field | Description | Default |
|---|---|---|
sources | Directories to scan for session files | ["~/.claude/projects", "~/.codex/sessions"] |
exclude | Glob patterns for directories to skip | ["-private-tmp*", "*-skill-test-*"] |
db_path | SQLite database location | ~/.config/engineering-notebook/notebook.db |
port | Web server port | 3000 |
day_start_hour | Hour (0-23) when a "day" starts (for grouping late-night sessions with the previous day) | 5 |
summary_instructions | Custom instructions appended to the LLM summarization prompt | "" |
remote_sources | SSH remote sources to sync before ingesting | [] |
auto_sync_interval | Seconds between auto-syncs when serving | 60 |
- 需要 engineering-notebook 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要 engineering-notebook 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +Apache-2.0 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：AI 工程笔记 的核心功能完整，质量良好。对于AI 技术爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | engineering-notebook |
| 原始描述 | 开源AI工具：A Bun CLI that ingests Claude Code and Codex session transcripts, generates LLM-。⭐180 · TypeScript |
| Topics | BunCLISQLiteTypeScript |
| GitHub | https://github.com/prime-radiant-inc/engineering-notebook |
| License | Apache-2.0 |
| 语言 | TypeScript |
收录时间：2026-06-06 · 更新时间：2026-06-06 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。