@kadaliao/geektime-downloader 1.1.4 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # 更新日志
2
2
 
3
+ ## [1.1.1] - 2026-01-05
4
+
5
+ ### 技术改进
6
+ - 改进代码块清洗逻辑,支持识别 SimpleBar/高亮容器并恢复成标准 `<pre><code>` 结构,PDF/EPUB 中的代码片段可完整显示
7
+
8
+ ### 文档更新
9
+ - README 增加“代码块还原”特性说明
10
+
3
11
  ## [1.1.0] - 2025-12-29
4
12
 
5
13
  ### 新增功能
package/README.md CHANGED
@@ -11,6 +11,7 @@
11
11
  - 🔗 **智能合并**:自动将所有章节合并为一个文件,以专栏名称命名(可选)
12
12
  - ⚙️ **灵活配置**:命令行参数或配置文件,任选其一
13
13
  - 🎨 **友好界面**:彩色进度提示,实时显示下载状态
14
+ - 🧾 **代码块还原**:自动识别滚动容器/高亮组件,还原成标准代码块
14
15
 
15
16
  ## 🚀 快速开始
16
17
 
@@ -35,16 +36,36 @@ npx @kadaliao/geektime-downloader \
35
36
  ```json
36
37
  {
37
38
  "cookie": "你的完整 cookie 字符串",
39
+ "cookieFile": "./cookies.json",
38
40
  "columnUrl": "https://time.geekbang.org/column/article/200822"
39
41
  }
40
42
  ```
41
43
 
44
+ > `cookieFile` 可选,用于直接引用浏览器导出的 `cookies.json`。
45
+
42
46
  2. 运行命令:
43
47
 
44
48
  ```bash
45
49
  npx @kadaliao/geektime-downloader
46
50
  ```
47
51
 
52
+ ### 方式三:cookies.json 文件导入
53
+
54
+ 适合从浏览器或插件导出的 JSON Cookie(如 Chrome 的 Cookie-Editor 导出):
55
+
56
+ 1. 在浏览器中登录极客时间,使用插件或 DevTools 导出 `cookies.json`
57
+ 2. 将文件放在当前目录(文件名必须是 `cookies.json`),程序会自动检测
58
+ 或者运行时显式指定:`--cookie-file ./cookies.json`
59
+ 3. 其他参数与前两种方式一致
60
+
61
+ 示例:
62
+
63
+ ```bash
64
+ npx @kadaliao/geektime-downloader \
65
+ --url "https://time.geekbang.org/column/article/200822" \
66
+ --cookie-file ./cookies.json
67
+ ```
68
+
48
69
  ## 📖 使用说明
49
70
 
50
71
  ### 获取 Cookie
@@ -79,6 +100,7 @@ geektime-dl [选项]
79
100
  -V, --version 显示版本号
80
101
  -u, --url <url> 专栏文章URL(任意一篇)
81
102
  -c, --cookie <cookie> Cookie字符串(用于认证)
103
+ --cookie-file <path> 从 JSON 文件导入 Cookie(如 cookies.json)
82
104
  -o, --output <dir> 输出目录 (默认: "./downloads")
83
105
  -f, --format <format> 输出格式: pdf, epub, both (默认: "pdf")
84
106
  --headless <boolean> 无头模式 (默认: true)
@@ -119,6 +141,14 @@ npx @kadaliao/geektime-downloader \
119
141
  -c "your_cookie"
120
142
  ```
121
143
 
144
+ **使用 cookies.json(自动检测或手动指定)**
145
+
146
+ ```bash
147
+ npx @kadaliao/geektime-downloader \
148
+ -u "https://time.geekbang.org/column/article/200822" \
149
+ --cookie-file ./cookies.json
150
+ ```
151
+
122
152
  **下载为 EPUB 格式**
123
153
 
124
154
  ```bash
@@ -1,4 +1,5 @@
1
1
  {
2
2
  "cookie": "你的完整 cookie 字符串",
3
+ "cookieFile": "./cookies.json",
3
4
  "columnUrl": "https://time.geekbang.org/column/article/200822"
4
5
  }
package/cookies.json ADDED
@@ -0,0 +1,405 @@
1
+ [
2
+ {
3
+ "domain": ".geekbang.org",
4
+ "expirationDate": 1802165134.81866,
5
+ "hostOnly": false,
6
+ "httpOnly": false,
7
+ "name": "_ga",
8
+ "path": "/",
9
+ "sameSite": "lax",
10
+ "secure": false,
11
+ "session": false,
12
+ "storeId": "0",
13
+ "value": "GA1.2.1648405688.1766916648"
14
+ },
15
+ {
16
+ "domain": ".geekbang.org",
17
+ "expirationDate": 1769586682,
18
+ "hostOnly": false,
19
+ "httpOnly": true,
20
+ "name": "GCID",
21
+ "path": "/",
22
+ "sameSite": "lax",
23
+ "secure": true,
24
+ "session": false,
25
+ "storeId": "0",
26
+ "value": "1d46ebd-6c7173c-59663d7-fd4e791"
27
+ },
28
+ {
29
+ "domain": ".geekbang.org",
30
+ "expirationDate": 1798530682,
31
+ "hostOnly": false,
32
+ "httpOnly": false,
33
+ "name": "LF_ID",
34
+ "path": "/",
35
+ "sameSite": "lax",
36
+ "secure": false,
37
+ "session": false,
38
+ "storeId": "0",
39
+ "value": "1d46ebd-6c7173c-59663d7-fd4e791"
40
+ },
41
+ {
42
+ "domain": ".geekbang.org",
43
+ "expirationDate": 1769586685,
44
+ "hostOnly": false,
45
+ "httpOnly": false,
46
+ "name": "GRID",
47
+ "path": "/",
48
+ "sameSite": "lax",
49
+ "secure": false,
50
+ "session": false,
51
+ "storeId": "0",
52
+ "value": "1d46ebd-6c7173c-59663d7-fd4e791"
53
+ },
54
+ {
55
+ "domain": ".geekbang.org",
56
+ "expirationDate": 1767691534,
57
+ "hostOnly": false,
58
+ "httpOnly": false,
59
+ "name": "_gid",
60
+ "path": "/",
61
+ "sameSite": "lax",
62
+ "secure": false,
63
+ "session": false,
64
+ "storeId": "0",
65
+ "value": "GA1.2.1820569978.1767435725"
66
+ },
67
+ {
68
+ "domain": "time.geekbang.org",
69
+ "expirationDate": -1,
70
+ "hostOnly": true,
71
+ "httpOnly": false,
72
+ "name": "gksskpitn",
73
+ "path": "/",
74
+ "sameSite": "lax",
75
+ "secure": false,
76
+ "session": false,
77
+ "storeId": "0",
78
+ "value": "9b0672ab-e2c6-441d-b051-ce0da17a63cd"
79
+ },
80
+ {
81
+ "domain": ".time.geekbang.org",
82
+ "expirationDate": 1799141134,
83
+ "hostOnly": false,
84
+ "httpOnly": false,
85
+ "name": "Hm_lvt_022f847c4e3acd44d4a2481d9187f1e6",
86
+ "path": "/",
87
+ "sameSite": "lax",
88
+ "secure": false,
89
+ "session": false,
90
+ "storeId": "0",
91
+ "value": "1767435725,1767515602,1767517524,1767585217"
92
+ },
93
+ {
94
+ "domain": ".time.geekbang.org",
95
+ "expirationDate": -1,
96
+ "hostOnly": false,
97
+ "httpOnly": false,
98
+ "name": "HMACCOUNT",
99
+ "path": "/",
100
+ "sameSite": "lax",
101
+ "secure": false,
102
+ "session": false,
103
+ "storeId": "0",
104
+ "value": "C2A664F7AA602889"
105
+ },
106
+ {
107
+ "domain": ".geekbang.org",
108
+ "expirationDate": 1799141134,
109
+ "hostOnly": false,
110
+ "httpOnly": false,
111
+ "name": "Hm_lvt_59c4ff31a9ee6263811b23eb921a5083",
112
+ "path": "/",
113
+ "sameSite": "lax",
114
+ "secure": false,
115
+ "session": false,
116
+ "storeId": "0",
117
+ "value": "1767435725,1767515602,1767517524,1767585217"
118
+ },
119
+ {
120
+ "domain": ".geekbang.org",
121
+ "expirationDate": -1,
122
+ "hostOnly": false,
123
+ "httpOnly": false,
124
+ "name": "gk_process_ev",
125
+ "path": "/",
126
+ "sameSite": "lax",
127
+ "secure": false,
128
+ "session": false,
129
+ "storeId": "0",
130
+ "value": "{%22count%22:2%2C%22utime%22:1767585230765%2C%22referrer%22:%22https://time.geekbang.org/%22%2C%22target%22:%22page_geektime_login%22}"
131
+ },
132
+ {
133
+ "domain": ".geekbang.org",
134
+ "expirationDate": 1770177230,
135
+ "hostOnly": false,
136
+ "httpOnly": true,
137
+ "name": "GCESS",
138
+ "path": "/",
139
+ "sameSite": "lax",
140
+ "secure": true,
141
+ "session": false,
142
+ "storeId": "0",
143
+ "value": "BgoEAAAAAAQEAI0nAA0BAQcEnK5tCQMEzjVbaQsCBgAIAQMFBAAAAAABCB1ZEAAAAAAACQEBDAEBAgTONVtpBgTltUAP"
144
+ },
145
+ {
146
+ "domain": ".geekbang.org",
147
+ "expirationDate": 1802159754,
148
+ "hostOnly": false,
149
+ "httpOnly": false,
150
+ "name": "_ga_JW698SFNND",
151
+ "path": "/",
152
+ "sameSite": "lax",
153
+ "secure": false,
154
+ "session": false,
155
+ "storeId": "0",
156
+ "value": "GS2.2.s1767599652$o8$g1$t1767599754$j59$l0$h0"
157
+ },
158
+ {
159
+ "domain": ".geekbang.org",
160
+ "expirationDate": 1783151754,
161
+ "hostOnly": false,
162
+ "httpOnly": false,
163
+ "name": "tfstk",
164
+ "path": "/",
165
+ "sameSite": "strict",
166
+ "secure": true,
167
+ "session": false,
168
+ "storeId": "0",
169
+ "value": "golnANqttlsj5gSwigPBLCmU1aptAWN7A0C827EyQlr6RXKQ9_kollnKpeiLE7mic8rLeXngr03S2UNpd8zubD2-eWhoC_0jPXLQweNIR7NyDndxE2gQNTuMxvh37VzK7y7ULdFwgzltIndvM2S5gHWyDvIIE0a7z7zUUurwSzzba9Pr4lyaurIUa7oySlzYuwrzU8yN7rra47yE4V8gPlzUa7or7F4SsRx0m7Pi_3p4NUMS90lg-JqqSK1laN4CDogEB_5zZy2hI2rGa_lsUXaY4oAGbl3rlYyiZCC_NVHmqYowz_roQrm0kDdNt7kZjj2q5nfQxAoIZWeXZa4inVont0-lK0mZlxNET31LAYuZalhey_qqHqNg5bK1TuDZUXeQNM-3SX0mZYjz9OW21n577UhNFTwU5PqAX_WW31JTUHTMStTTLPaCDFYGFaeU5PqvSFXVsJz_RiC.."
170
+ },
171
+ {
172
+ "domain": ".geekbang.org",
173
+ "expirationDate": 1802159763,
174
+ "hostOnly": false,
175
+ "httpOnly": false,
176
+ "name": "_ga_MTX5SQH9CV",
177
+ "path": "/",
178
+ "sameSite": "lax",
179
+ "secure": false,
180
+ "session": false,
181
+ "storeId": "0",
182
+ "value": "GS2.2.s1767599763$o1$g0$t1767599763$j60$l0$h0"
183
+ },
184
+ {
185
+ "domain": "account.geekbang.org",
186
+ "expirationDate": -1,
187
+ "hostOnly": true,
188
+ "httpOnly": false,
189
+ "name": "gksskpitn",
190
+ "path": "/",
191
+ "sameSite": "lax",
192
+ "secure": false,
193
+ "session": false,
194
+ "storeId": "0",
195
+ "value": "423dc5f5-b42c-4e26-87ff-71f16c270209"
196
+ },
197
+ {
198
+ "domain": "u.geekbang.org",
199
+ "expirationDate": -1,
200
+ "hostOnly": true,
201
+ "httpOnly": false,
202
+ "name": "gksskpitn",
203
+ "path": "/",
204
+ "sameSite": "lax",
205
+ "secure": false,
206
+ "session": false,
207
+ "storeId": "0",
208
+ "value": "1f1a1bea-b54b-4390-b9d7-3c09c6003628"
209
+ },
210
+ {
211
+ "domain": "tips.geekbang.org",
212
+ "expirationDate": -1,
213
+ "hostOnly": true,
214
+ "httpOnly": false,
215
+ "name": "gksskpitn",
216
+ "path": "/",
217
+ "sameSite": "lax",
218
+ "secure": false,
219
+ "session": false,
220
+ "storeId": "0",
221
+ "value": "d4a48a20-12aa-425e-8109-099a237fd77c"
222
+ },
223
+ {
224
+ "domain": "time.geekbang.org",
225
+ "expirationDate": 1767606923.387977,
226
+ "hostOnly": true,
227
+ "httpOnly": true,
228
+ "name": "acw_tc",
229
+ "path": "/",
230
+ "sameSite": "lax",
231
+ "secure": false,
232
+ "session": false,
233
+ "storeId": "0",
234
+ "value": "0bdd344617676051234043340e1ccc33db16483d6cec5f3f4522ec71fbb9df"
235
+ },
236
+ {
237
+ "domain": ".hm.baidu.com",
238
+ "expirationDate": 1802165124.074986,
239
+ "hostOnly": false,
240
+ "httpOnly": false,
241
+ "name": "HMACCOUNT_BFESS",
242
+ "path": "/",
243
+ "sameSite": "no_restriction",
244
+ "secure": true,
245
+ "session": false,
246
+ "storeId": "0",
247
+ "value": "34A689ACBBE70F05"
248
+ },
249
+ {
250
+ "domain": "account.geekbang.org",
251
+ "expirationDate": 1767606924.378361,
252
+ "hostOnly": true,
253
+ "httpOnly": true,
254
+ "name": "acw_tc",
255
+ "path": "/",
256
+ "sameSite": "lax",
257
+ "secure": false,
258
+ "session": false,
259
+ "storeId": "0",
260
+ "value": "0bdd344617676051242572391e1cacede9cf2c0299298753ad8dcfac84f179"
261
+ },
262
+ {
263
+ "domain": "u.geekbang.org",
264
+ "expirationDate": 1767606924.47026,
265
+ "hostOnly": true,
266
+ "httpOnly": true,
267
+ "name": "acw_tc",
268
+ "path": "/",
269
+ "sameSite": "lax",
270
+ "secure": false,
271
+ "session": false,
272
+ "storeId": "0",
273
+ "value": "0bdd344617676051244602725e1c86619b6e580dfd45c49b16532e463e33a1"
274
+ },
275
+ {
276
+ "domain": ".geekbang.org",
277
+ "expirationDate": 1767605184,
278
+ "hostOnly": false,
279
+ "httpOnly": false,
280
+ "name": "_gat",
281
+ "path": "/",
282
+ "sameSite": "lax",
283
+ "secure": false,
284
+ "session": false,
285
+ "storeId": "0",
286
+ "value": "1"
287
+ },
288
+ {
289
+ "domain": "tips.geekbang.org",
290
+ "expirationDate": 1767606926.771909,
291
+ "hostOnly": true,
292
+ "httpOnly": true,
293
+ "name": "acw_tc",
294
+ "path": "/",
295
+ "sameSite": "lax",
296
+ "secure": false,
297
+ "session": false,
298
+ "storeId": "0",
299
+ "value": "0bdd344617676051266773343e1ca7387fe6fec5c4f74d4697985f529b7b32"
300
+ },
301
+ {
302
+ "domain": ".geekbang.org",
303
+ "expirationDate": -1,
304
+ "hostOnly": false,
305
+ "httpOnly": false,
306
+ "name": "Hm_lpvt_59c4ff31a9ee6263811b23eb921a5083",
307
+ "path": "/",
308
+ "sameSite": "lax",
309
+ "secure": false,
310
+ "session": false,
311
+ "storeId": "0",
312
+ "value": "1767605135"
313
+ },
314
+ {
315
+ "domain": ".time.geekbang.org",
316
+ "expirationDate": -1,
317
+ "hostOnly": false,
318
+ "httpOnly": false,
319
+ "name": "Hm_lpvt_022f847c4e3acd44d4a2481d9187f1e6",
320
+ "path": "/",
321
+ "sameSite": "lax",
322
+ "secure": false,
323
+ "session": false,
324
+ "storeId": "0",
325
+ "value": "1767605135"
326
+ },
327
+ {
328
+ "domain": "account.geekbang.org",
329
+ "expirationDate": -1,
330
+ "hostOnly": true,
331
+ "httpOnly": false,
332
+ "name": "SERVERID",
333
+ "path": "/",
334
+ "sameSite": "lax",
335
+ "secure": false,
336
+ "session": false,
337
+ "storeId": "0",
338
+ "value": "3431a294a18c59fc8f5805662e2bd51e|1767605134|1767601458"
339
+ },
340
+ {
341
+ "domain": "u.geekbang.org",
342
+ "expirationDate": -1,
343
+ "hostOnly": true,
344
+ "httpOnly": false,
345
+ "name": "SERVERID",
346
+ "path": "/",
347
+ "sameSite": "lax",
348
+ "secure": false,
349
+ "session": false,
350
+ "storeId": "0",
351
+ "value": "1fa1f330efedec1559b3abbcb6e30f50|1767605134|1767601458"
352
+ },
353
+ {
354
+ "domain": ".time.geekbang.org",
355
+ "expirationDate": 1768209934,
356
+ "hostOnly": false,
357
+ "httpOnly": false,
358
+ "name": "__tea_cache_tokens_20000743",
359
+ "path": "/",
360
+ "sameSite": "lax",
361
+ "secure": false,
362
+ "session": false,
363
+ "storeId": "0",
364
+ "value": "{%22web_id%22:%227588849213623017997%22%2C%22user_unique_id%22:%221071389%22%2C%22timestamp%22:1767605134787%2C%22_type_%22:%22default%22}"
365
+ },
366
+ {
367
+ "domain": ".geekbang.org",
368
+ "expirationDate": 1802165135.489075,
369
+ "hostOnly": false,
370
+ "httpOnly": false,
371
+ "name": "_ga_03JGDGP9Y3",
372
+ "path": "/",
373
+ "sameSite": "lax",
374
+ "secure": false,
375
+ "session": false,
376
+ "storeId": "0",
377
+ "value": "GS2.2.s1767599645$o13$g1$t1767605135$j50$l0$h0"
378
+ },
379
+ {
380
+ "domain": "tips.geekbang.org",
381
+ "expirationDate": -1,
382
+ "hostOnly": true,
383
+ "httpOnly": false,
384
+ "name": "SERVERID",
385
+ "path": "/",
386
+ "sameSite": "lax",
387
+ "secure": false,
388
+ "session": false,
389
+ "storeId": "0",
390
+ "value": "3431a294a18c59fc8f5805662e2bd51e|1767605136|1767601460"
391
+ },
392
+ {
393
+ "domain": "time.geekbang.org",
394
+ "expirationDate": -1,
395
+ "hostOnly": true,
396
+ "httpOnly": false,
397
+ "name": "SERVERID",
398
+ "path": "/",
399
+ "sameSite": "lax",
400
+ "secure": false,
401
+ "session": false,
402
+ "storeId": "0",
403
+ "value": "3431a294a18c59fc8f5805662e2bd51e|1767605137|1767599643"
404
+ }
405
+ ]