Moonbit 实现的终端剪贴板历史 cli 工具
$ mtuck list
#0 刚刚 ×3 [url] https://github.com/moonbitlang/moon
★ #1 1 分钟前 ×1 [text] cargo test --workspace
#2 15 分钟前 ×1 [secret] post••••••••
#3 1 小时前 ×1 [text] 会议纪要:下周一对齐| 痛点 | mtuck 的做法 |
|---|---|
| 复制了 A,复制 B 之后 A 丢了 | watch 常驻记录,list 随时查看 |
| 想找十分钟前复制的那条命令 | 按编号、-q 子串搜索、按类型/固定筛选 |
| 复制内容太多,历史文件越滚越大 | 去重合并、上限淘汰、固定条目永不过期 |
| 复制了密码,担心被明文保存 | 自动识别为 secret 并打码,-f 才看原文 |
| 想在脚本里用历史内容 | --json 输出、copy 写回、管道友好的纯文本 |
| 平台 | 需要的东西 |
|---|---|
| macOS | 无(走 AppKit NSPasteboard) |
| Windows | 无(走 Win32 剪贴板 API) |
| Linux / Wayland | wl-clipboard(wl-copy / wl-paste) |
| Linux / X11 | xclip 或 xsel |
# Debian / Ubuntu
sudo apt install xclip # 或 wl-clipboard
# Fedora
sudo dnf install xclip # 或 wl-clipboard
# Arch
sudo pacman -S xclip # 或 wl-clipboardgit clone https://github.com/SundayT1998/moonbit-language-clipboard_history_cli.git
cd moonbit-language-clipboard_history_cli
moon update
moon build --release --target nativeinstall -m 755 _build/native/release/build/cmd/main/main.exe ~/.local/bin/mtuckmtuck watch # 终端 1:开始记录(保持运行,Ctrl-C 退出)
# …… 正常复制粘贴 ……
mtuck list # 终端 2:看看记了什么
mtuck show 0 # 看最新一条的完整内容
mtuck copy 3 # 把第 3 条写回系统剪贴板,然后直接 Ctrl-V
mtuck list -q moon # 按子串搜索监听剪贴板中(每 1000ms 检查一次,Ctrl-C 退出)
已有 12 条历史
+ [text] git log --oneline -20
+ [url] https://mooncakes.io/docs/moonbit-community/proton_clipboard
+ [secret] ghp•••••••• (40 字符)| 命令 | 别名 | 作用 |
|---|---|---|
| mtuck watch | 持续监听剪贴板并写入历史,Ctrl-C 退出 | |
| mtuck list | ls | 列出历史条目 |
| mtuck show <n> | 打印第 n 条的完整内容 | |
| mtuck copy <n> | cp | 把第 n 条写回系统剪贴板 |
| mtuck pin <n> | 固定条目:不被上限淘汰、不参与去重合并 | |
| mtuck unpin <n> | 取消固定 | |
| mtuck rm <n> | remove | 删除条目 |
| mtuck clear | 清空历史(默认保留固定条目) | |
| mtuck stats | 查看条目数、固定数、疑似密钥数、总字符、类型分布 | |
| mtuck help | -h / --help | 帮助 |
| mtuck version | --version | 版本号 |
| 选项 | 适用命令 | 说明 |
|---|---|---|
| -n, --limit <k> | list | 最多显示 k 条(默认 20,0 表示全部) |
| -i, --interval <ms> | watch | 轮询间隔毫秒(1–60000,默认 400;-n 在 watch 下不生效) |
| -f, --full | list / show | 显示完整内容:不截断、不给密钥打码 |
| -f | clear | 连固定条目一起删 |
| -p, --pinned | list | 只看固定条目 |
| -q, --query <s> | list | 子串过滤(区分大小写) |
| --json | list / stats | 输出 JSON,便于脚本消费 |
| 变量 | 默认值 | 说明 |
|---|---|---|
| MTUCK_DIR | ~/.local/share/mtuck | 历史文件所在目录 |
| HOME | — | 未设置 MTUCK_DIR 时用来推导默认目录 |
★ 标 编号 相对时间 ×复制次数 [类型] 预览
★ #1 2 分钟前 ×3 [url] https://example.com$ mtuck list --json -n 2
[{"index":0,"ts":1731600000000,"hits":3,"pinned":false,"kind":"url","secret":false,"text":"https://example.com"},
{"index":1,"ts":1731599000000,"hits":1,"pinned":true,"kind":"text","secret":false,"text":"npm run build"}]
$ mtuck stats --json
{"total":42,"pinned":2,"secret":3,"chars":8123,"path":"/home/me/.local/share/mtuck/history.tsv","kinds":{"text":30,"url":9,"secret":3}}mtuck list --json -n 0 | jq -r '.[] | select(.kind=="url") | .text'
mtuck list --json -n 0 | jq -r '.[] | select(.pinned) | .text'
# 按当前剪贴板内容反查来源
mtuck list -q "$(xclip -o -selection clipboard)"| 码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 运行期错误(读写剪贴板失败、写历史失败等) |
| 2 | 用法错误(未知命令、下标看不懂、条目不存在) |
系统剪贴板 ──读取──> Watcher ──变化?──> History.push ──落盘──> history.tsv
│ │
macOS/Windows 用变更计数 去重合并 / 类型判定 / 打码 / 上限淘汰
Linux 读文本比对| 类型 | 判定规则 | 默认是否打码 |
|---|---|---|
| url | http(s)://、ftp://、file://、mailto: 等 | 否 |
| dsn | 其他 scheme://… 形式,如 postgres://host/db | 否 |
| jwt | eyJ… 开头且含三个 . 段 | 是 |
| secret | 私钥块;password=/api_key=/token= 等赋值;authorization / bearer 头;sk-/ghp_/AKIA 等裸密钥前缀;任意 scheme://user:pass@host | 是 |
| text | 其他 | 否 |
| empty | 空内容 | 否 |
ts hits pinned kind is_secret textalias mt='mtuck list -n 0'
alias mtls='mtuck list'mtuck list -n 0 --json | jq -r '.[] | select(.kind=="url") | "\(.index)\t\(.text)"'mtuck list -q "kubectl" -n 1 # 找到那条
mtuck pin 0 # 固定它
mtuck list -p # 以后只看固定条目mtuck clear # 保留固定条目
mtuck clear -f # 全清# 把最新一条复制内容输出到标准输出
mtuck show last
# 拿来当作另一个命令的参数
git commit -m "$(mtuck show last)"<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>dev.mtuck.watch</string>
<key>ProgramArguments</key>
<array><string>/Users/me/.local/bin/mtuck</string><string>watch</string></array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
<key>StandardOutPath</key><string>/tmp/mtuck-watch.log</string>
<key>StandardErrorPath</key><string>/tmp/mtuck-watch.log</string>
</dict>
</plist>launchctl load ~/Library/LaunchAgents/dev.mtuck.watch.plist[Unit]
Description=mtuck clipboard history watcher
[Service]
ExecStart=%h/.local/bin/mtuck watch
Restart=always
Environment=MTUCK_DIR=%h/.local/share/mtuck
[Install]
WantedBy=default.targetsystemctl --user daemon-reload
systemctl --user enable --now mtuck-watchschtasks /Create /SC ONLOGON /TN "mtuck watch" /TR "C:\tools\mtuck.exe watch" /RL LIMITED.
├── cmd/main/ # 可执行入口:参数解析、各子命令、读写历史文件
│ ├── args.mbt # 命令行解析与 help
│ ├── commands.mbt # watch/list/show/copy/pin/rm/clear/stats
│ ├── resolve.mbt # "last" / "1,3" / "2-5" 下标解析
│ ├── format.mbt # 相对时间、JSON 转义、毫秒时间戳
│ └── store_io.mbt # 历史文件路径与安全落盘
├── history/ # 纯逻辑,无 I/O:可任意后端测试
│ ├── store.mbt # History 模型:去重、固定、上限淘汰
│ ├── kind.mbt # 类型判定与打码
│ └── codec.mbt # TSV 编解码
├── watch/ # 事件源:剪贴板轮询器 + 变更计数快路径
└── platform/ # 平台小能力:macOS/Windows 原生变更计数(C stub)moon check --target native # 类型检查
moon test --target native # 跑测试(当前 18 个)
moon fmt # 格式化
moon info # 更新 .mbti 接口文件,检查对外 API 是否变化git config core.hooksPath .githooks # 每次 commit 自动 moon checkInstall
Download zipMoonbit 实现的终端剪贴板历史 cli 工具