wucai-cli 26.3.50

WuCai (五彩) CLI — web highlight, clipping, and diary tool

wucai-cli

五彩 (WuCai) 命令行工具 — 从终端管理你的网页划线、剪藏与日记。

安装

pip install wucai-cli

配置

设置环境变量：

export WUCAI_API_TOKEN="wct-你的Token"
export WUCAI_REGION="cn"   # cn(中国区) | eu(欧洲区) | us(美国区)

Token 获取地址（需登录对应区域账号）：

区域	Token 页面
CN	marker.dotalk.cn
EU	eu.wucainote.com
US	us.wucainote.com

拷贝以 wct- 开头的 OpenClaw 专用 Token，不要错拷贝成普通 API Key。

命令

命令	说明
wucai list-highlights	查看最新划线
wucai list-articles	查看文章列表
wucai list-diary	查看日记
wucai search-highlights	搜索划线内容
wucai search-articles	搜索文章标题/笔记
wucai get-article	获取文章详情
wucai append-diary	追加日记
wucai set-status	修改文章状态
wucai trash	移入回收站
wucai update-note	更新页面笔记

使用示例

# 查看今日划线
wucai list-highlights

# 查看最近 48 小时划线（仅文章）
wucai list-highlights --range 48h --type 1

# 搜索划线内容
wucai search-highlights --query "machine learning"

# 查看本周文章（带高亮内容）
wucai list-articles --range week --with-highlights

# 通过 URL 获取文章详情
wucai get-article --url "https://example.com/article"

# 追加日记
wucai append-diary --content "今天学到了新东西"

# 修改文章状态为归档
wucai set-status --note-idx <id> --status archive

# 人类可读输出
wucai list-highlights -o text

通用参数

参数	说明
--range	时间范围：today / yesterday / week / 24h / 48h / 7d / YYYY-MM-DD / start:end
--page-size	每页数量（默认 12）
--cursor	游标翻页
-o / --output	输出格式：json（紧凑）/ pretty（缩进）/ text（人类可读）

14 天限制：所有时间查询跨度不得超过 14 天。如需查询更早内容，请指定具体日期。

相关链接

• 官方网站 · Global
• GitHub 仓库

License

MIT-0 (MIT No Attribution)