@wingeek/artisan

A CLI for builders — 结构化工作日志 + 多平台内容发布，本地优先。

安装

# 使用 bunx（推荐，免安装）
bunx @wingeek/artisan

# 使用 npx
npx @wingeek/artisan

# 全局安装
bun install -g @wingeek/artisan
# 或
npm install -g @wingeek/artisan

# 从源码
git clone https://github.com/wingeek/artisan.git
cd artisan && bun install

快速开始

# 欢迎界面
artisan

# 查看帮助
artisan --help
artisan worklog --help
artisan publish --help

命令一览

worklog — 从 git 提交生成结构化工作日志

# 在项目中安装 post-commit 钩子（自动收集提交）
artisan worklog init
artisan worklog init /path/to/repo --with-submodules

# 查看今日收集了多少提交
artisan worklog status
artisan worklog status --date 2026-06-09

# 生成工作日志
artisan worklog generate                          # 纯文本输出
artisan worklog generate --format md              # Markdown 输出
artisan worklog generate --since 2026-06-01       # 指定日期范围
artisan worklog generate --repo my-project        # 按仓库筛选

# AI 摘要模式（用 Claude 生成总结）
artisan worklog generate --ai
artisan worklog generate --ai --ai-model claude-sonnet-4-6
artisan worklog generate --ai --instructions "用中文总结，突出业务价值"

# 生成后直接导入 publish（一键从 worklog 到可发布内容）
artisan worklog generate --ai --publish --tags "weekly,dev"

数据存储： ~/.artisan/worklog/commits.jsonl

publish — 多平台内容发布

完整工作流：import → adapt → preview → push

# 导入现有文章
artisan publish import ./my-article.md
artisan publish import ./my-article.md --title "自定义标题" --tags "tech,bim"

# 创建新文章（打开编辑器）
artisan publish new --title "我的文章" --tags "build-in-public"

# 终端内编辑（TUI 编辑器，自动保存）
artisan publish edit <docId>

# 查看所有文章
artisan publish list
artisan publish list --tag tech --limit 10

多平台适配

# 适配到指定渠道（生成渠道专用格式）
artisan publish adapt <docId> --channel juejin
artisan publish adapt <docId> --channel wechat
artisan publish adapt <docId> --channel twitter
artisan publish adapt <docId> --channel github-pages

预览与发布

# 终端预览
artisan publish preview <docId> --channel juejin

# 浏览器预览（HTML 渲染 + 操作栏：复制内容 / 打开平台后台）
artisan publish preview <docId> --channel juejin --open

# 一键发布（适配 + 推送）
artisan publish push <docId> --channel juejin

支持渠道

| 渠道 | 适配行为 | 发布行为 | |------|---------|---------| | juejin (掘金) | 去 frontmatter、加标签 | 复制到剪贴板 + 打开掘金编辑器 | | wechat (公众号) | 代码块转缩进、标签 footer | 复制到剪贴板 + 打开 mdnice | | twitter (X) | 提取摘要、280 字线程 | 复制到剪贴板 + 打开 X 发布 | | github-pages | 添加 Jekyll frontmatter | 生成文件到 docs 目录 |

数据存储： ~/.artisan/publish/ (SQLite)

典型工作流

日常开发日志

# 一次性：在项目里安装钩子
cd my-project && artisan worklog init

# 之后正常 git commit，提交会自动记录

# 下班前看一眼今天干了什么
artisan worklog status

# 周末生成周报
artisan worklog generate --since $(date -d '7 days ago' +%Y-%m-%d) --format md --ai

Build in Public 发布

# 写好一篇文章
artisan publish new --title "Week 1: 从零开始的独立实验" --tags "bip,indie-hacker"

# 适配多平台
artisan publish adapt <docId> --channel juejin
artisan publish adapt <docId> --channel wechat
artisan publish adapt <docId> --channel twitter

# 预览确认后发布
artisan publish preview <docId> --channel juejin --open
artisan publish push <docId> --channel juejin

worklog → publish 联动

# 一键：从 git 提交生成 AI 摘要 → 导入 publish store
artisan worklog generate --ai --publish --tags "weekly,bip"
# 然后正常走 adapt → preview → push 流程

开发

# 开发模式（文件变更自动重启）
bun dev

# 运行测试
bun test

技术栈

• Bun — 运行时
• Cliffy — CLI 框架
• OpenTUI — 终端 UI
• SQLite — 本地存储
• Claude API — AI 摘要生成