Skip to content

Commit a0d5879

Browse files
baixiangerclaude
andcommitted
Update SKILL.md: add export/import/logout, fix install path, add --chrome
- Install: npm/bun global install (removed hardcoded local path) - Added: export/import for VPS/Docker token transfer - Added: logout command - Added: --chrome flag and CHROME_PATH env var - Trimmed to 182 lines (under 500 limit) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent e835d0a commit a0d5879

1 file changed

Lines changed: 71 additions & 128 deletions

File tree

SKILL.md

Lines changed: 71 additions & 128 deletions
Original file line numberDiff line numberDiff line change
@@ -25,42 +25,37 @@ snowball fund 110011 --growth # 基金收益
2525

2626
## 安装
2727

28-
需要 [Bun](https://bun.sh) 运行时。
29-
3028
```bash
31-
cd /Users/baixianger/Desktop/omika.AI/snowball-cli
32-
bun install
29+
npm install -g snowball-cli #
30+
bun add -g snowball-cli
3331
```
3432

35-
运行命令:`bun run index.ts <命令> [参数]`
36-
37-
全局安装后:`snowball <命令> [参数]`
38-
3933
## 登录(仅在需要时)
4034

41-
大部分命令需要雪球登录态(`xq_a_token`)。上面列出的 `quote``market``fund` 无需登录。
35+
大部分命令需要雪球登录态。上面列出的 `quote``market``fund` 无需登录。
36+
37+
```bash
38+
snowball login # 终端内二维码,用雪球 App 扫码
39+
snowball login --manual # 在 Chrome 窗口中扫码
40+
snowball login --chrome /path/to/x # 指定 Chrome/Chromium 路径
41+
snowball token "xq_a_token=x; u=x" # 手动粘贴 cookie
42+
```
4243

43-
**登录方式(推荐顺序):**
44+
设置 `CHROME_PATH` 环境变量可以省去每次 `--chrome`
4445

45-
1. **二维码登录(默认)** — 终端内显示二维码,用雪球 App 扫码确认:
46-
```bash
47-
snowball login
48-
```
49-
原理:启动 Chrome → 访问 xueqiu.com 通过 WAF → 调用 API 生成二维码 → 终端渲染 → 轮询扫码状态 → 过期自动刷新(最多 3 次)→ 失败降级为手动模式。
46+
**跨机器传输 token(VPS / Docker):**
5047

51-
2. **手动扫码** — 在 Chrome 窗口中扫码:
52-
```bash
53-
snowball login --manual
54-
```
48+
```bash
49+
snowball export # 导出 token 为 base64
50+
snowball import <base64> # 导入 token
51+
ssh vps "snowball import $(snowball export)" # 一行搞定
52+
```
5553

56-
3. **粘贴 Cookie** — 从浏览器开发者工具复制:
57-
```bash
58-
snowball token "xq_a_token=xxx; u=xxx"
59-
```
54+
**管理 token:**
6055

61-
Token 保存在 `~/.snowball-cli/token.json`,通常有效数天。检查状态:
6256
```bash
63-
snowball status # 显示来源、时间,自动验证是否仍然有效
57+
snowball status # 验证 token 是否有效
58+
snowball logout # 删除 token
6459
```
6560

6661
## 代码格式
@@ -69,171 +64,119 @@ snowball status # 显示来源、时间,自动验证是否仍然有效
6964
|---|---|---|
7065
| `SHxxxxxx` | 上交所 | `SH600519`(贵州茅台) |
7166
| `SZxxxxxx` | 深交所 | `SZ000858`(五粮液)、`SZ300750`(宁德时代) |
72-
| `SH000xxx` | 上证指数 | `SH000001`(上证综指)`SH000300`(沪深300) |
73-
| `SZ399xxx` | 深证指数 | `SZ399001`(深证成指)`SZ399006`(创业板指) |
74-
| `xxxxx` | 港股 | `01810`(小米)`00700`(腾讯) |
75-
| `XXXX` | 美股 | `AAPL`(苹果)`TSLA`(特斯拉) |
67+
| `SH000xxx` | 上证指数 | `SH000001`(上证综指) |
68+
| `SZ399xxx` | 深证指数 | `SZ399001`(深证成指) |
69+
| `xxxxx` | 港股 | `01810`(小米) |
70+
| `XXXX` | 美股 | `AAPL`(苹果) |
7671

7772
基金代码为纯数字:`110011``005827`
7873

7974
## 命令参考
8075

81-
### 行情数据(quote 和 market 无需登录)
76+
### 行情(quote 和 market 无需登录)
8277

8378
```bash
84-
snowball quote SH600519 # 实时行情(无需登录)
79+
snowball quote SH600519 # 实时行情
8580
snowball quote SH600519 SZ000858 AAPL # 批量查询
86-
snowball quote SH600519 --detail # 详细:PE、PB、股息率、52 周高低
87-
snowball market # 大盘指数总览(无需登录)
81+
snowball quote SH600519 --detail # PE、PB、股息率、52 周高低
82+
snowball market # 大盘指数总览
8883
snowball pankou SH600519 # 盘口 / 买卖五档
8984
snowball kline SH600519 # 日 K 线,默认 120 根
90-
snowball kline SH600519 --period week --count 52 # 周线一年
85+
snowball kline SH600519 --period week --count 52
9186
snowball minute SH600519 # 分时图
9287
```
9388

94-
K 线周期:`1m` `5m` `15m` `30m` `60m` `120m` `day` `week` `month` `quarter` `year`
95-
9689
### 财务报表
9790

9891
```bash
99-
snowball income SH600519 # 利润表(默认最近 5 期)
100-
snowball balance SH600519 --count 10 # 资产负债表(最近 10 期)
92+
snowball income SH600519 --count 10 # 利润表
93+
snowball balance SH600519 # 资产负债表
10194
snowball cashflow SH600519 # 现金流量表
102-
snowball indicator SH600519 # 关键指标(ROE、毛利率等)
103-
snowball business SH600519 # 营收构成(按业务/地区分拆)
104-
snowball forecast SH600519 # 机构盈利预测
95+
snowball indicator SH600519 # 关键指标
96+
snowball business SH600519 # 营收构成
97+
snowball forecast SH600519 # 盈利预测
10598
```
10699

107100
### 公司资料(F10)
108101

109102
```bash
110103
snowball company SH600519 # 公司简介
111-
snowball holders SH600519 # 股东人数变化
112104
snowball holders SH600519 --top # 十大股东
113-
snowball bonus SH600519 # 分红送转历史
114-
snowball industry SH600519 # 行业与概念板块
105+
snowball bonus SH600519 # 分红送转
106+
snowball industry SH600519 # 行业与概念
115107
snowball org SH600519 # 机构持仓变动
116108
```
117109

118110
### 资金流向
119111

120112
```bash
121-
snowball flow SH600519 # 日内资金流向
122-
snowball flow SH600519 --history # 历史每日资金流向
123-
snowball assort SH600519 # 按单量分布(大/中/小单)
124-
snowball margin SH600519 # 融资融券数据
113+
snowball flow SH600519 --history # 历史资金流向
114+
snowball assort SH600519 # 大/中/小单分布
115+
snowball margin SH600519 # 融资融券
125116
snowball block SH600519 # 大宗交易
126117
```
127118

128119
### 社交与资讯
129120

130121
```bash
131-
snowball trending # 今日热帖
132-
snowball trending week --count 20 # 本周热帖
133-
snowball trending month # 本月热帖
134-
snowball live # 7x24 实时快讯
135-
snowball live --important # 仅重要快讯
136-
snowball feed # 头条信息流
137-
snowball feed a-shares --count 30 # 沪深信息流
138-
snowball hot # 热门股票(默认 A 股)
139-
snowball hot us # 热门美股
140-
snowball kol SH600519 # 讨论该股的大 V
141-
snowball user <用户ID> --count 20 # 指定用户最新帖子
142-
snowball profile <用户ID> # 用户主页信息
143-
snowball post <帖子ID> # 单条帖子详情
122+
snowball trending day --count 10 # 今日热帖
123+
snowball live --important # 重要快讯
124+
snowball feed a-shares # 沪深信息流
125+
snowball hot cn # 热门 A 股
126+
snowball kol SH600519 # 个股大 V
127+
snowball user <用户ID> --count 10 # 用户帖子
128+
snowball profile <用户ID> # 用户主页
129+
snowball post <帖子ID> # 帖子详情
144130
```
145131

146-
信息流分类:`headlines`(头条)`today`(今日话题)`a-shares`(沪深)`us`(美股)`hk`(港股)`funds`(基金)`private`(私募)
147-
148-
### 搜索与发现
132+
### 搜索与基金
149133

150134
```bash
151135
snowball search 茅台 # 搜索股票
152-
snowball search-user 价投 --count 10 # 搜索用户
153-
snowball screen # 选股器(默认沪市)
154-
snowball screen HK --count 50 # 港股选股
155-
```
156-
157-
### 基金(经蛋卷 API,无需登录)
158-
159-
```bash
160-
snowball fund 110011 # 基金详情
161-
snowball fund 110011 --nav # 净值历史
162-
snowball fund 110011 --growth # 收益走势
163-
```
164-
165-
## 输出格式
166-
167-
所有命令输出 JSON,用 `jq` 过滤:
168-
169-
```bash
170-
snowball quote SH600519 | jq '.[0].current' # 当前价格
171-
snowball kline SH600519 | jq '.item | length' # K 线根数
172-
snowball income SH600519 | jq '.[0].report_name' # 最新报告期
173-
snowball trending | jq '.[].author' # 热帖作者列表
136+
snowball search-user 价投 # 搜索用户
137+
snowball screen SH # 选股器
138+
snowball fund 110011 --nav # 基金净值(无需登录)
174139
```
175140

176141
## Agent 工作流
177142

178143
### 早盘简报
179144

180145
```bash
181-
snowball market # 指数快照
182-
snowball live --important --count 10 # 隔夜要闻
183-
snowball hot cn # 今日热门股
184-
snowball trending --count 5 # 社区热议
185-
```
186-
187-
### 个股深度研究
188-
189-
```bash
190-
snowball search 贵州茅台 # 查找代码
191-
snowball quote SH600519 --detail # 估值快照
192-
snowball kline SH600519 --period week --count 104 # 两年周线
193-
snowball income SH600519 --count 10 # 10 期利润表
194-
snowball indicator SH600519 --count 10 # 关键财务指标
195-
snowball business SH600519 # 营收构成
196-
snowball holders SH600519 --top # 十大股东
197-
snowball org SH600519 # 机构动向
198-
snowball flow SH600519 --history # 资金流向趋势
199-
snowball forecast SH600519 # 机构一致预期
146+
snowball market
147+
snowball live --important --count 10
148+
snowball trending --count 5
200149
```
201150

202-
### 大 V 舆情分析
151+
### 个股研究
203152

204153
```bash
205-
snowball kol SH600519 --count 20 # 找到讨论该股的大 V
206-
snowball profile <大V的ID> # 查看大 V 资质
207-
snowball user <大V的ID> --count 20 # 读最近发帖
208-
snowball trending week # 本周社区热门话题
209-
snowball search-user "价值投资" --count 10 # 搜索价投大 V
154+
snowball quote SH600519 --detail
155+
snowball income SH600519 --count 8
156+
snowball indicator SH600519 --count 8
157+
snowball holders SH600519 --top
158+
snowball flow SH600519 --history
159+
snowball forecast SH600519
210160
```
211161

212-
### 基金对比
162+
### 大 V 舆情
213163

214164
```bash
215-
snowball fund 110011 # 易方达中小盘
216-
snowball fund 110011 --growth # 收益走势
217-
snowball fund 005827 # 易方达蓝筹精选
218-
snowball fund 005827 --growth # 收益走势
165+
snowball kol SH600519 --count 10
166+
snowball user <ID> --count 10
167+
snowball profile <ID>
219168
```
220169

221170
## 认证要求速查
222171

223172
| 无需登录 | 需要登录 |
224173
|---|---|
225-
| `quote`(基础行情) | `quote --detail` |
226-
| `market` | `pankou` `kline` `minute` |
227-
| `fund` `fund --nav` `fund --growth` | 所有财务报表命令 |
228-
| | 所有公司资料 / F10 命令 |
229-
| | 所有资金流向命令 |
230-
| | 所有社交 / 资讯命令 |
231-
| | `search` `search-user` `screen` |
174+
| `quote` `market` | `quote --detail` `pankou` `kline` `minute` |
175+
| `fund` `fund --nav` `fund --growth` | 所有财务 / F10 / 资金 / 社交命令 |
232176

233177
## 常见问题
234178

235-
- **「Not logged in」** — 运行 `snowball login``snowball token <cookie>`
236-
- **HTTP 403 / WAF** — 雪球反爬检测,等几分钟或重新登录刷新 Cookie
237-
- **二维码过期** — CLI 会自动刷新,最多重试 3 次
238-
- **API 报错** — 返回 `{ error_code, error_description }`,最常见原因是 token 过期
239-
- **Token 一般有效数天**,批量操作前先 `snowball status` 确认
179+
- **「Not logged in」**`snowball login``snowball token <cookie>`
180+
- **HTTP 403 / WAF** — 等几分钟或重新登录
181+
- **Chrome not found** — 设置 `CHROME_PATH``--chrome`
182+
- **Token 过期**`snowball status` 检查,过期重新 `login`

0 commit comments

Comments
 (0)