@tianpeng1995/worklog-cli
v2.0.7
Published
极简的个人工作管理知识库 CLI
Maintainers
tianpeng1995Readme
worklog-cli
npm 包: @tianpeng1995/worklog-cli
极简的个人工作管理知识库 CLI，基于 Obsidian 双向链接构建知识网络。
只需记住一件事：打开今天的文件，写。
✨ 特性
- Obsidian 原生 — 基于双向链接，日记 → 项目 → 资源形成知识网络
- 多工具支持 — 支持 Claude Code、Codex、Cursor，初始化时可选择
- 自动 Git 记录 —
/worklog:log自动拉取今日提交，自动链接项目 - 渐进式归档 — 日记是临时池，周末整理到资源，形成个人知识库
- Canvas 支持 — 支持可视化架构图画布
📦 安装
npm install -g @tianpeng1995/worklog-cli推荐使用 Obsidian 打开知识库目录。
🚀 快速开始
# 初始化知识库
worklog init ~/projects/my-worklog
# 用 Obsidian 打开
obsidian ~/projects/my-worklog初始化会自动：
- 创建目录结构（日记/、项目/、资源/、画布/）
- 交互选择要安装的 AI 工具（Claude Code、Codex、Cursor）
- 安装对应工具的技能文件
- 创建今日日记
📁 目录结构
my-worklog/
├── 日记/ ← 每天一个文件，链接到项目和资源
├── 项目/ ← 项目文档，反向链接自动显示相关日记
├── 资源/ ← 可复用知识点，反向链接自动显示来源
├── 画布/ ← Canvas 架构图
└── CLAUDE.md ← 知识库指引🔗 知识网络
worklog 利用 Obsidian 双向链接，让笔记自然形成网络：
日记 项目 资源
───────────────── ───────────────── ─────────────────
2026-04-03 api-golang MongoDB
工作记录: 技术栈: 要点:
- 登录功能 → [[api-golang]] - Go - 连接池配置...
- 学到... → [[MongoDB]] - gRPC - 索引优化...
↓
反向链接:
- 2026-04-03
- 2026-04-02单向链接，自动反向：
- 在日记中写
[[api-golang]] - api-golang 文档底部自动显示"反向链接：2026-04-03"
🔁 工作流
| 时间 | 动作 |
|------|------|
| 上班 | 打开今天的日记，写任务、记进展 |
| 下班 | /worklog:log 写日报，自动链接到项目 |
| 随时 | /worklog:note xxx 快速记笔记 |
| 周末 | /worklog:summarize 整理笔记到资源 |
📝 命令详解
/worklog:log — 写日报
下班前运行：
- 多选 git 提交
- 输入其他工作
- 自动识别项目，添加双向链接
## 工作记录
- 实现登录功能 → [[api-golang]]
- 修复支付 bug → [[octopus]]
- 参加周会/worklog:project — 同步项目文档
在项目目录运行，分析代码库，生成项目文档。
项目文档不包含"开发记录"——由反向链接自动展示。
/worklog:note — 快速笔记
随时记一个想法或知识点，追加到今天的日记。
/worklog:summarize — 整理本周笔记
周末运行，从日记中提取笔记，整理到资源，建立双向链接。
🔄 更新
worklog update❓ FAQ
为什么推荐 Obsidian？
worklog 利用 Obsidian 的双向链接特性：
- 日记中的
[[项目名]]自动链接到项目文档 - 项目文档底部自动显示相关日记（反向链接）
- 形成自然的知识网络，无需手动维护
可以用其他编辑器吗？
可以，但会失去双向链接的便利性。VS Code、Typora 只能看到纯文本。
支持哪些 AI 工具？
- Claude Code — 技能安装到
~/.claude/commands/worklog/ - Codex — 技能安装到
~/.codex/prompts/ - Cursor — 技能安装到
<知识库>/.cursor/commands/