Metadata-Version: 2.4
Name: wucai-cli
Version: 26.3.50
Summary: WuCai (五彩) CLI — web highlight, clipping, and diary tool
License-Expression: MIT-0
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# wucai-cli

[![License: MIT-0](https://img.shields.io/badge/License-MIT--0-brightgreen.svg)](https://opensource.org/licenses/MIT-0)
[![PyPI - Version](https://img.shields.io/pypi/v/wucai-cli.svg)](https://pypi.org/project/wucai-cli)

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

## 安装

```bash
pip install wucai-cli
```

## 配置

设置环境变量：

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

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

| 区域 | Token 页面 |
|---|---|
| **CN** | [marker.dotalk.cn](https://marker.dotalk.cn/#/personSetting/openapi) |
| **EU** | [eu.wucainote.com](https://eu.wucainote.com/#/personSetting/openapi) |
| **US** | [us.wucainote.com](https://us.wucainote.com/#/personSetting/openapi) |

> 拷贝以 `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` | 更新页面笔记 |

## 使用示例

```bash
# 查看今日划线
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 天。如需查询更早内容，请指定具体日期。

## 相关链接

- [官方网站](https://doc.wucai.site/) · [Global](https://wucainote.com/)
- [GitHub 仓库](https://github.com/makediff/wucai-openclaw)

## License

MIT-0 (MIT No Attribution)
