KouShare-dl 是ぜ一いち个使用しよう Cobra 开发的てき用よう于从 “蔻享学がく术” 视频网站下か载视频和课件的てき命令めいれい行ぎょう工具こうぐ。

您可以在常つね见的操作そうさ系けい统（Windows，macOS 和わ Linux 等とう）里さと使用しよう该命令れい行ぎょう工具こうぐ。该工具ぐ已やめ被ひ发布至いたり公有こうゆう领域，因いん此您可か以按照あきら您的想そう法ほう自由じゆう使用しよう它，如对它进行ぎょう修おさむ改あらため、重じゅう新しん发布等とう操作そうさ。

• 功こう能のう
  • 它目前ぜん具有ぐゆう如下功こう能のう
  • 它无法ほう做到的てき事情じじょう
  • "功こう能のう支持しじ"表ひょう格かく
• 编译
• 使用しよう方法ほうほう
• 命令めいれい简介
• 示しめせ例れい
  • 一いち、登とう录账户与注ちゅう销登陆
    • 1.1 登とう录蔻享とおる账户
    • 1.2 注ちゅう销登录状态
  • 二に、查看视频或ある直播じきまき信しん息いき
  • 三さん、下しも载视频
    • 3.1 使用しよう默だま认参数すう下か载视频
    • 3.2 下か载视频至指定してい文ぶん件けん夹
    • 3.3 下か载某个专题的所有しょゆう视频
    • 3.4 下か载不同どう清きよし晰度的てき视频
    • 3.5 批量下か载指定してい的てき视频
  • 四よん、录制直ちょく播与下か载快速そく回かい放ひ
    • 4.1 对指定してい直播じきまき间进行ぎょう录制
    • 4.2 合ごう并录制せい的てき视频片へん段だん
    • 4.3 下か载直播间快速かいそく回かい放ひ视频
  • 五ご、下しも载课件けん
    • 5.1 下か载单个课件けん和わ专题课件
    • 5.2 优化 pdf 文ぶん件けん【实验性せい功こう能のう】
  • 六ろく、清きよし理り临时文ぶん件けん
• FAQ
  • KouShare-dl 下か载视频时是ぜ并行下か载吗？
  • 下しも载专题视频时因いん网络波は动导致下载中断ちゅうだん该怎么办？
  • 下しも载视频的过程中ちゅう遇ぐう到いた因いん被ひ占うらない用よう而导致文件けん重じゅう命名めいめい失しつ败的错误应该如何いか处理？
• 鸣谢
• 许可证合规性

• 登とう录蔻享とおる账户，且一周内免登录

• 获取视频或ある直播じきまき的てき详细信しん息いき

• 下しも载单个蔻享とおる视频或ある整せい个专题的视频

• 下しも载清晰度为标清きよし、高こう清和きよかず超ちょう清きよし的てき视频（需要じゅよう登とう录）

• 下しも载已やめ购买且在有效ゆうこう期き内ない的まと付づけ费视频（需要じゅよう登とう录）

• 批量下か载指定してい的てき视频

• 继续上じょう一次的视频下载

• 定てい时录制せい直ちょく播间

• 继续上じょう一いち次じ的てき直播じきまき间录制せい

• 下しも载直播间的てき快速かいそく回かい放ひ🚀

• 下しも载单个课件けん或ある整せい个专题的课件

• 下しも载未购买的てき付づけ费视频

（✔️表示ひょうじ支持しじ该功能のう，❌表示ひょうじ不ふ支持しじ该功能のう，➖表示ひょうじ该功能のう不ふ存在そんざい，⭕表示ひょうじ部分ぶぶん支持しじ该功能のう）

您可以下いか载 Releases 中なか的てき二に进制文ぶん件けんks.exe或あるks后きさき直接ちょくせつ使用しよう，也可以下いか载源代だい码自行ぎょう编译。

go build -o ks.exe -trimpath -ldflags "-s -w -buildid=" ks.go

go build -o ks -trimpath -ldflags "-s -w -buildid=" ks.go

您需要じゅよう通どおり过命令れい行ぎょう或ある终端进入该程序じょ所在しょざい的てき文ぶん件けん夹，才能さいのう执行相しょう关命令めいれい。

以Windows平台ひらだい为例，若わか可か执行程こうてい序じょks.exe位くらい于C:\Users\lenovo\Downloads\路みち径みち下か，您每次じ使用しよう时需要じゅよう通どおり过快捷とし键Win+R打だ开“运行”对话框かまち，输入CMD后きさき回かい车打开命令れい行ぎょう窗まど口こう。在ざい命令めいれい行ぎょう窗まど口中くちじゅう输入以下いか命令めいれい：

cd C:\Users\lenovo\Downloads\
ks version

若わか出で现KouShare-dl v0.9.1字じ样，则说明あきら可か以正常つね使用しよう。接せっ下か来らい您可以继续输入にゅう KouShare-dl 程ほど序じょ的てき命令めいれい来らい进行交互こうご。比ひ如，输入ks help并回车，您就可か以看到いた KouShare-dl 程ほど序じょ的てき帮助信しん息いき了りょう。

KouShare-dl 程ほど序じょ的てき命令めいれい具有ぐゆう下面かめん的てき格式かくしき：

  ks [command] <flag>

其中[command]为必选命令めいれい，<flag>为可选参数すう。

可か使用しよう的てき command 命令めいれい：

  clean       清きよし除じょ指定してい目め录下的てき所有しょゆうtmp临时文ぶん件けん
  help        查看某ぼう个具体ぐたい命令めいれい的てき更さら多た帮助信しん息いき
  info        获取视频或ある直播じきまき的てき基本きほん信しん息いき
  login       通どおり过短信たんしん验证码获取“蔻享学がく术”登とう陆凭证
  logout      退出たいしゅつ登とう陆
  merge       合あい并下载的视频片へん段だん文ぶん件けん
  record      录制指定してい直ちょく播间ID的てき直播じきまき，命令めいれい别名为live
  save        保存ほぞん指定していvid的てき视频（vid为视频网址し里さと最さい后きさき面めん的てき一いち串くし数字すうじ），命令めいれい别名为video
  slide       下か载指定していvid的てき视频对应的てき课件
  upgrade     升ます级为最新さいしん版本はんぽん
  version     输出版本はんぽん号ごう，并检查最新しん版本はんぽん

可か使用しよう的てき flag 参さん数すう：

  -@, --at          指定してい时间，格式かくしき为"2006-01-02 15:04:05"
  -a, --autoMerge   指定してい是ぜ否いや自じ动合并下载的视频片へん段だん文ぶん件けん
  -h, --help        查看帮助信しん息いき
  -n, --name        指定してい输出文ぶん件けん的てき名字みょうじ
      --password    指定してい直播じきまき间密码
  -p, --path        指定してい保存ほぞん文ぶん件けん的てき路ろ径みち（若わか不ふ指定してい，则默认为该程序じょ当とう前ぜん所在しょざい的てき路ろ径みち）
  -p, --path        指定してい清しん理り临时文ぶん件けん的てき路ろ径みち（若わか不ふ指定してい，则默认为该程序じょ当とう前ぜん所在しょざい的てき路ろ径みち）
  -P, --proxy       指定してい使用しよう的てきhttp/https/socks5代理だいり服ふく务地址し
  -q, --quality     指定してい下か载视频的清きよし晰度（high为超清きよし，standard为高清きよし，low为标清きよし，不ふ指定してい则默认为超ちょう清きよし）
  -q, --quiet       指定してい是ぜ否いや不ふ输出清きよし理り过程中ちゅう的てき信しん息いき
      --qpdf-bin    指定していqpdf的てきbin文ぶん件けん夹所在しょざい的てき路ろ径みち（注ちゅう：该flag无简写うつし形式けいしき）
  -r, --replay      指定してい是ぜ否ひ下か载直播间快速かいそく回かい放ひ视频
  -s, --series      指定してい是ぜ否ひ下か载整个专题的文ぶん件けん
      --nocolor     指定してい是ぜ否いや不ふ使用しよう彩色さいしき输出
  -v, --version     查看版本はんぽん号ごう
  -v, --vidPrefix   指定してい是ぜ否ひ使用しようvid作さく为保存ほぞん视频文ぶん件名けんめい的てき前ぜん缀

需要じゅよう注意ちゅうい的てき是ぜ，对于每ごと个 command 命令めいれい，仅有部分ぶぶん flag 参さん数すう是ぜ可用かよう且有效ゆうこう的てき。可か以通过ks help [command]来らい查看某ぼう个命令めいれい的てき详细描述及其可用かよう的てき flag 参さん数すう。

登とう录蔻享とおる账户并不是ぜ使用しよう流りゅう程ほど中なか的てき必须操作そうさ，但ただし登とう录蔻享とおる账户后きさき可か以下いか载更高清こうせ晰度的てき免めん费视频和下か载已购买的てき付づけ费视频，获取视频的てき基本きほん信しん息いき时还可か以获取と到いた更さら多た详细的てき内容ないよう。

使用しよう下面かめん的てき命令めいれい登とう录蔻享とおる账户：

ks login [phone number]

其中[phone number]参まいり数すう为 11 位い手しゅ机つくえ号ごう码。该命令めいれい执行后きさき，手て机つくえ会かい收おさむ到いた 6 位い短信たんしん验证码，在ざい命令めいれい行ぎょう中ちゅう继续输入短信たんしん验证码后回かい车即可か登とう录。登とう录成功せいこう后きさき会かい在ざい当とう前ぜん路みち径みち下か生成せいせい一个用于保存登录凭证的 Token 隐藏文ぶん件けん，Token 有效ゆうこう期き为一周いっしゅう，因いん此一周内无需再次登录即可保持登录状态。

重じゅう复运行ぎょう该命令めいれい会かい自じ动更新しん登とう陆凭证。登とう录凭证过期き后きさき重おも新しん登とう陆即可か。

如果想そう注ちゅう销登录状态，可か以使用しよう这条命令めいれい：

ks logout

手て动删除じょ程ほど序じょ所在しょざい路ろ径みち下か的てき.token文ぶん件けん与あずか该命令めいれい的てき执行效果こうか相しょう同どう。

查看视频信しん息いき使用しようks info [vid]命令めいれい。info命令めいれい没ぼつ有ゆう flag 。

执行该命令めいれい后きさき会かい返かえし回かい指定してい vid 的てき视频的てき详细信しん息いき，包括ほうかつ标题、讲者、单位、日にち期き、时长、体からだ积、类别、专题、分ぶん组以及视频简介かい等とう。

几点说明：

• 非ひ登とう录状态下，“体からだ积”仅展示てんじ标清清せいせい晰度下か的てき视频大小だいしょう；登とう录状态下，“体からだ积”展示てんじ最高さいこう清きよし晰度下か的てき视频大小だいしょう。

• 若わか“体からだ积”为0MB [未知みち]，则说明あかり该视频是未み购买的てき（或ある未み在ざい购买有效ゆうこう期き内的ないてき）付づけ费视频，此时 KouShare-dl 无法获取该视频的体たい积信息いき。

• 若わか“专题”不ふ为空，说明该视频是属ぞく于某个专题的视频，比ひ如某精せい品ひん公おおやけ开课中ちゅう的てき一いち节课。

您可以试一试下面的例子：

ks info 7304

建けん议下载视频和课件前ぜん使用しようinfo命令めいれい确认视频的てき信しん息いき是ぜ否いや正せい确。

查看直播じきまき信しん息いき使用しようks info [roomID]命令めいれい。执行该命令めいれい后きさき会かい返かえし回かい指定してい roomID 的てき直播じきまき间的详细信しん息いき，包括ほうかつ标题、直播じきまき状じょう态、主しゅ办方、开播时间、有ゆう无回放ひ、浏览次数じすう、专题以及最新さいしん通知つうち等とう。

您可以试一试下面的例子：

ks info 341215

建けん议录制せい直播じきまき和わ下か载快速そく回かい放ひ前ぜん使用しようinfo命令めいれい确认直播じきまき的てき信しん息いき是ぜ否いや正せい确。

每まい个蔻享とおる学がく术视频都有ゆう唯一ゆいいつ对应的てき id，即そく vid。 在ざい蔻享学がく术网站进入いれ某ぼう个视频的播放页面后きさき，该页面めん网址的てき最さい后きさき的てき数字すうじ部分ぶぶん即そく为该视频的てき vid。例れい如，在ざい下面かめん的てき网址中ちゅう，7412是ぜ该视频的 vid。

https://www.koushare.com/video/videodetail/7412

下しも载视频使用しようks save [vid] <flags>命令めいれい。与あずかsave对应的てき flag 有ゆう三さん个：

多た个 flag 可か以不分ぶん顺序地ち叠加使用しよう，但ただしBool类型的てき flag 宜むべ放ひ在ざい最さい后きさき使用しよう。关于命令めいれい中ちゅう flag 的てき详细使用しよう语法，可か以参考さんこう这里的てき描述。

使用しようsave时不加か任にん何なん flag ，程ほど序じょ就会使用しようsave的てき所有しょゆう flag 的てき默だま认值进行下か载。

例れい如，在ざい登とう录状态下要よう默だま认下载 vid 为7552的てき视频，可か以运行ぎょう下面かめん这条命令めいれい：

  ks save 7552

该命令めいれい执行完かん毕后，程ほど序じょ所在しょざい的てき路ろ径みち下か会かい出で现一个.mp4格式かくしき的てき超ちょう清きよし视频文ぶん件けん，这就是ぜ下か载下来らい的てき vid 为7552的てき蔻享视频。

save命令めいれい的てき别名是ぜvideo，因いん此ks save 7552和わks video 7552的てき功こう能のう是ぜ相しょう同どう的てき。

若わか要よう指定してい保存ほぞん视频的てき位置いち，可か以加上じょう-p参さん数すう，并为其指定してい一いち个新值（如D:\temp\）以覆盖默认值（当とう前ぜん所在しょざい路ろ径みち），如下所しょ示しめせ：

  ks save 7552 -p D:\temp\

这里的てき-p是これ--path的てき简写形式けいしき，而-p D:\temp\与あずか--path=D:\temp\是ぜ等とう价的，因いん此上一条命令也可以等价地修改为：

ks save 7552 --path=D:\temp\

若わか指定してい的てき文ぶん件けん夹不存在そんざい，程ほど序じょ会かい创建该文件けん夹以保存ほぞん视频。若わか遇ぐう到いたAccess is denied的てき错误提示ていじ，则说明あかり权限不足ふそく，此时您需要よう使用しよう更さら高だか的てき权限来らい运行 KouShare-dl。

专题下か载需要よう指定してい-s参さん数すう，-s或ある--series参まいり数すう是ぜBool型かた flag，使用しよう时无需指定してい具体ぐたい的てき值。

您需要よう知道ともみち所要しょよう下か载的专题视频中ちゅう任意にんい一いち个视频的 vid。以“中ちゅう物ぶつ院いん研究生けんきゅうせい院いん精せい品ひん公おおやけ开课之の《高等こうとう量子力学りょうしりきがく》公おおやけ开课程ほど”专题为例，可か以使用しよう下面かめん这条命令めいれい下か载该专题的てき所有しょゆう视频：

ks save 7304 -s

程ほど序じょ会かい使用しよう该专题的名字みょうじ创建一个文件夹用以存放下载的视频。7304是ぜ该专题第一いち个视频的 vid，可か被ひ替がえ换为该专题任意にんい视频的てき vid。

若わか要よう同どう时指定してい保存ほぞん视频的てき位置いち（如D:\temp\），可か以运行ぎょう该命令れい：

ks save 7552 -p D:\tmp\ -s

使用しよう-q或ある--quality参さん数すう来らい指定してい下か载视频的清きよし晰度。该 flag 的てき值只有ゆうhigh（超ちょう清きよし）、standard（高こう清きよし）和わlow（标清）三さん种。示しめせ例れい如下：

ks save 7304 -q high

ks save 7304 -q standard

ks save 7304 --quality=low

需要じゅよう注意ちゅうい的てき是ぜ：

• 非ひ登とう录状态下，-q和わ--quality参まいり数すう无效。这是因いん为非登とう录状态下仅能下か载标清きよし视频。
• 若わか您指定してい的てき该 flag 的てき值并不在ふざい以上いじょう三さん种值之これ内ない，程ほど序じょ会かい判定はんてい要よう下した载的清きよし晰度为标清きよし。
• 登とう录状态下，若わか您要下か载的视频没ぼつ有ゆう您指定してい的てき清きよし晰度，程ほど序じょ会かい选择次じ于您指定してい清しん晰度的てき清きよし晰度进行视频的てき下か载。

save 命令めいれい的てき子こ命令めいれい batch 可用かよう于自定てい义批量りょう下か载指定してい vid 的てき视频，格式かくしき如下：

ks save batch [vid1,vid2,vid3,...] <flag>

例れい如：

ks save batch [2233,59119,58206] -p="C:\Users\lenovo\Downloads" -v

KouShare-dl 会かい按顺序じょ下か载指定してい vid 的てき视频。

每まい个蔻享とおる直播じきまき间都有ゆう唯一ゆいいつ对应的てき id，即そく roomID。 在ざい蔻享学がく术网站进入いれ某ぼう个直播间的てき页面后きさき，该页面めん网址的てき最さい后きさき的てき数字すうじ部分ぶぶん即そく为该直播じきまき间的房ぼう间号。例れい如，在ざい下面かめん的てき网址中ちゅう，676216是ぜ该直播间的てき roomID。

https://www.koushare.com/lives/room/676216

录制直播じきまき使用しようks record [roomID] <flags>命令めいれい。与あずかrecord对应的てき flag 有ゆう三さん个：

合ごう并下载的.ts视频片へん段だん使用しようks merge <directory> <flags> 命令めいれい。与あずかmerge对应的てき flag 有ゆう一いち个：

录制直播じきまき时不需要じゅよう处于登とう录状态下。假かり如您想おもえ要よう录制房ぼう间号为751111的てき直播じきまき间，可か以运行ぎょう该命令れい：

  ks record 751111 -a

执行命令めいれい后きさき程ほど序じょ会かい立りつ即そく开始录制。但ただし如果此时尚ひさし未み开播，您会收おさむ到いた“直播じきまき尚ひさし未み开始”的てき提示ていじ，随ずい后きさき程ほど序じょ会かい自じ动倒计时至いたり开播时间，倒たおせ计时结束后きさき将はた自じ动开始はじめ录制。除じょ了りょう录制直播じきまき外がい，该命令めいれい也可用よう于查看み回まわ放ひ视频是ぜ否ひ上じょう线等信しん息いき。

record命令めいれい的てき别名是ぜlive，所以ゆえん ks record 751111 -a和わ ks live 751111 -a的てき功こう能のう是ぜ相しょう同どう的てき。

如果直播じきまき尚ひさし未み开始，但ただし您知道どう准じゅん确的开播时间，那な么可以用-@参まいり数すう指定してい开播时间，如：

  ks record 751111 -@="2021-07-15 18:30:00" -a

运行这条命令めいれい后きさき会かい立りつ即そく启动倒たおせ计时，到いた指定してい的てき开播时间后きさき KouShare-dl 会かい以1080p的てき清きよし晰度自じ动开始はじめ录制直播じきまき，直播じきまき结束时会自じ动停止ていし录制。

注ちゅう：若わか到いた指定してい的てき开播时间后きさき直播じきまき间仍未み开播，程ほど序じょ会かい自じ动退出たいしゅつ。

若わか某ぼう个直播间需要じゅよう密みつ码才能さいのう访问，则需要よう使用しよう --password 标志指定してい正せい确的访问密みつ码后才能さいのう对该直ちょく播间使用しよう record 命令めいれい。

在ざい观看直ちょく播时，直播じきまき视频是ぜ以一个个小文おぶみ件けん（即そく一些时长较短的视频片段）的てき方式ほうしき传输给用户的。在ざい上うえ一いち个示例れい中ちゅう，指定してい-a参まいり数すう后きさき，KouShare-dl 会かい自じ动合并下载的直播じきまき视频片へん段だん为一个.ts文ぶん件けん（一种视频文件，可か被ひ视频播放器き直接ちょくせつ播放）。

有ゆう时直播じきまき时间过长，自じ动合并后得え到いた的てき文ぶん件けん体たい积较大だい，不便ふべん于传输，可か以在录制直播じきまき时不指定してい-a参さん数すう，这样下か载下来らい的てき直播じきまき片へん段だん不ふ会かい自じ动合并。您可以在传输后きさき使用しようmerge命令めいれい手しゅ动合并.ts视频片へん段だん：

  ks merge <directory> <flags>

其中<directory>参まいり数すう为存放ひ视频片かた段だん文ぶん件けん的てき文ぶん件けん夹的路ろ径みち，若わか为空则默认为程ほど序じょ当とう前ぜん所在しょざい路ろ径みち。

示しめせ例れい如下：

ks merge

ks merge D:\temp\直じき播录制せい -n 课程.ts

ks merge -n output.ts

示しめせ例れい： 使用しようks live 447482 命令めいれい得え到いた“快速かいそく回かい放ひ视频已上いじょう线”的てき信しん息いき：

$ ks live 447482

直播じきまき已やめ结束。快速かいそく回かい放ひ视频已上いじょう线，访问 https://www.koushare.com/lives/room/447482 观看快速かいそく回かい放ひ或ある使用しよう“ks record 447482 --replay”命令めいれい下か载快速そく回かい放ひ视频。

使用しようks live 447482 -r 或あるks record 447482 --replay命令めいれい即そく可か下か载快速そく回かい放ひ视频：

$ ks live 447482 -r

开始下か载快速そく回かい放ひ视频...
2126692489_2083434824_1.ts?start=0 ...
2126692489_2083434824_1.ts?start=1752160 ...
2126692489_2083434824_1.ts?start=3504696 ...
 ...
快速かいそく回かい放ひ视频下か载完成かんせい。

可か使用しよう-p指定してい保存ほぞん快速かいそく回かい放ひ视频的てき路ろ径みち，如：

ks live 447482 -r -p "C:\Users\lenovo\Desktop"

ks live 447482 -r --path="C:\Users\lenovo\Desktop"

下しも载课件けん使用しようks slide [vid] <flags>命令めいれい。与あずかslide对应的てき flag 有ゆう三さん个：

下しも载课件けん时不需要じゅよう处于登とう录状态下。假かり如您想おもえ要よう下した载为 vid 为7405的てき视频关联的てき课件，可か以运行ぎょう该命令れい：

ks slide 7405

使用しようinfo命令めいれい查看 vid 为7405的てき视频信しん息いき，可か以发现该视频的てき“专题”不ふ为空，说明该视频还有ゆう其它相しょう关视频。

假かり如您想そう下か载这个专题视频的所有しょゆう课件，可か以使用しよう-s参さん数すう：

ks slide 7405 -s

同どう样地，7405可か以被替がえ换为同どう专题任意にんい视频的てき vid。

该功能のう当とう前ぜん并不稳定，不ふ推荐使用しよう。

如果想おもえ要よう使用しよう--qpdf-bin标志，需先下か载 qpdf包つつみ 并进行ぎょう解かい压操作そうさ，然しか后きさき在ざい命令めいれい行ぎょう或ある终端中ちゅう指定してい qpdf 包つつみ的てき bin 文ぶん件けん夹所在しょざい的てき路ろ径みち，如：

ks slide 7405 --qpdf-bin=C:\Downloads\qpdf-10.1.0\bin\

使用しよう ks clean 命令めいれい可か以清理り当とう前目まえめ录或指定してい路ろ径みち下か的てき所有しょゆう下か载过程ほど中ちゅう产生的てき tmp 文ぶん件けん。与あずか clean 对应的てき flag 有ゆう两个：

不ふ是ぜ并行下か载。

再さい次つぎ运行您上一次使用的下载命令，KouShare-dl 会かい自じ动跳过已下か载完成かんせい的てき视频，并继续完成かんせい您的下か载。 录制直播じきまき意外いがい中断ちゅうだん时同理り。

错误信しん息いき通常つうじょう为：rename 文ぶん件名けんめい.tmp 文ぶん件名けんめい.mp4: The process cannot access the file because it is being used by another process.您可以耐心しん等とう待まち至いたり下か载结束たば后きさき，手て动将重じゅう命名めいめい失しつ败的.tmp文ぶん件けん的てき后きさき缀改为.mp4；或ある者もの重おも新しん运行您上一次使用的下载命令，KouShare-dl 会かい再さい次つぎ尝试重じゅう命名めいめい这些.tmp文ぶん件けん。

特とく别感谢 JetBrains 提供ていきょう的てき GoLand 等とう IDE 的てき授权。 特とく别感谢为 KouShare-dl 预览版本はんぽん测试各かく项功能のう的てき小しょう伙伴们。