hitsword
/
wx-cli
mirror of https://github.com/jackwener/wx-cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs(readme): explain how to fetch more than 500 messages (#13) 

Clarify that the 500-message behavior is only a default limit, not a hard cap.
Document `-n/--limit` examples for history, search, and export in both README and SKILL.
feat/appmsg-url
郭立lee 2026-04-18 16:01:15 +09:00 committed by GitHub
parent 697d3fc720
commit f0dcd4ea05
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
README.md
View File

@ -145,11 +145,15 @@ wx unread # 有未读消息的会话
wx unread --filter private,group # 只看真人未读（过滤公众号/折叠入口） wx unread --filter private,group # 只看真人未读（过滤公众号/折叠入口）
wx new-messages # 上次检查后的新消息（增量） wx new-messages # 上次检查后的新消息（增量）
wx history "张三" # 最近 50 条记录 wx history "张三" # 最近 50 条记录
wx history "张三" -n 2000 # 拉更多历史消息
wx history "AI群" --since 2026-04-01 --until 2026-04-15 wx history "AI群" --since 2026-04-01 --until 2026-04-15
wx search "关键词" # 全库搜索 wx search "关键词" # 全库搜索
wx search "关键词" -n 500 # 放宽搜索结果条数
wx search "会议" --in "工作群" --since 2026-01-01 wx search "会议" --in "工作群" --since 2026-01-01
``` ```
`history` / `search` / `export` 都支持 `-n` / `--limit` 指定条数。默认值只是为了避免一次性输出过多消息，不是硬上限。
会话/消息输出里都带 `chat_type` 字段，取值为 `private` / `group` / `official_account` / `folded`。`official_account` 涵盖公众号、订阅号、服务号及 `mphelper` / `qqsafe` 等系统通知；`folded` 对应微信里的"订阅号折叠"和"折叠群聊"两个聚合入口。 会话/消息输出里都带 `chat_type` 字段，取值为 `private` / `group` / `official_account` / `folded`。`official_account` 涵盖公众号、订阅号、服务号及 `mphelper` / `qqsafe` 等系统通知；`folded` 对应微信里的"订阅号折叠"和"折叠群聊"两个聚合入口。
### 联系人 & 群组 ### 联系人 & 群组
@ -174,6 +178,7 @@ wx stats "AI群" --since 2026-01-01 # 指定时间范围
```bash ```bash
wx export "张三" --format markdown -o chat.md wx export "张三" --format markdown -o chat.md
wx export "张三" -n 2000 --format markdown -o chat.md
wx export "AI群" --since 2026-01-01 --format json wx export "AI群" --since 2026-01-01 --format json
``` ```

7
SKILL.md
View File

@ -115,13 +115,17 @@ wx new-messages --json # JSON 输出，适合 agent 解析
# 聊天记录（支持昵称/备注名） # 聊天记录（支持昵称/备注名）
wx history "张三" wx history "张三"
wx history "张三" -n 2000
wx history "AI群" --since 2026-04-01 --until 2026-04-15 -n 100 wx history "AI群" --since 2026-04-01 --until 2026-04-15 -n 100
# 全库搜索 # 全库搜索
wx search "关键词" wx search "关键词"
wx search "关键词" -n 500
wx search "会议" --in "工作群" --since 2026-01-01 wx search "会议" --in "工作群" --since 2026-01-01
``` ```
`history` / `search` / `export` 都支持 `-n` / `--limit` 指定返回条数。默认值只是为了避免一次输出过多，不是硬上限。
`sessions` / `unread` / `history` / `new-messages` / `stats` 的输出都带 `chat_type` 字段，agent 可据此分流： `sessions` / `unread` / `history` / `new-messages` / `stats` 的输出都带 `chat_type` 字段，agent 可据此分流：
| 取值 | 含义 | username 特征 | | 取值 | 含义 | username 特征 |
@ -166,6 +170,7 @@ wx stats "AI群" --since 2026-01-01
```bash ```bash
# 导出为 Markdown（默认） # 导出为 Markdown（默认）
wx export "张三" --format markdown -o chat.md wx export "张三" --format markdown -o chat.md
wx export "张三" -n 2000 --format markdown -o chat.md
# 导出为 JSON # 导出为 JSON
wx export "AI群" --since 2026-01-01 --format json -o chat.json wx export "AI群" --since 2026-01-01 --format json -o chat.json
@ -216,3 +221,5 @@ CHAT 参数支持昵称、备注名、微信 ID，模糊匹配。不确定准确
**daemon 无响应**：`wx daemon stop` 后重新调用任意命令自动重启。 **daemon 无响应**：`wx daemon stop` 后重新调用任意命令自动重启。
**找不到聊天**：用 `wx contacts --query` 确认昵称/备注名，或用微信 ID 直接查询。 **找不到聊天**：用 `wx contacts --query` 确认昵称/备注名，或用微信 ID 直接查询。
**为什么只能获取 500 条消息？**：这是默认输出条数，不是硬限制。显式传 `-n` 即可，例如 `wx history "张三" -n 2000` 或 `wx export "张三" -n 2000 -o chat.md`。