休息了將近十天左右，代碼的東西一點(diǎn)都沒(méi)摸，完全脫離出代碼的世界，有時(shí)覺(jué)得程序員不應(yīng)該總沉浸于自己的代碼世界，這段時(shí)間走走看看，把腦子打開(kāi)去體會(huì)更多的東西，感受到以前自?shī)首詷?lè)的那種渺小，人應(yīng)該有張有弛的，什么事情都不能過(guò)度，該做什么的時(shí)候絕對(duì)不要想著不該去想的東西，活在當(dāng)下，才是幸福。
新的一年，要開(kāi)始工作了，今天看看自己的電腦，感覺(jué)好亂，想把所有的資料全扔進(jìn)Total commander里，也想寫一些插件來(lái)做一些額外的工作，比如把電影音樂(lè)打上tag或?qū)懮显u(píng)論待以后方便查看等，先存一篇文章，以后有空的時(shí)候動(dòng)手做這些事情的時(shí)候也許有用。
/////////////////////////////////////////////////////////////////////////////////////////////////////////////華麗分割線
應(yīng)nevermind版主之約，寫了插件開(kāi)發(fā)的一個(gè)Guild，簡(jiǎn)單介紹了如何為TC開(kāi)發(fā)一個(gè)插件以及插件的基本工作過(guò)程，僅僅是一個(gè)入門介紹，詳細(xì)的編程細(xì)節(jié)需要從網(wǎng)上下載幫助，下面文章中都給出了下載地址。
首先聲明，本文撰寫背景是TC 6.03a，6.5會(huì)加入新的插件內(nèi)容，但估計(jì)向下兼容應(yīng)該是沒(méi)有問(wèn)題的。
眾所周知，TC的插件現(xiàn)在分為3類，Lister插件（.wlx）、FileSystem插件（.wfx）和Packer插件（.wcx）（另外還有傳說(shuō)中6.5新加的Content插件（.wdx），現(xiàn)在還不見(jiàn)廬山真面目，先按下不表）。盡管擴(kuò)展名穿上了不同的馬甲，但其本質(zhì)都是一樣的，都是Windows的DLL動(dòng)態(tài)鏈接庫(kù)，我們需要做的僅僅是按照TC的規(guī)范，實(shí)現(xiàn)其給定的DLL接口函數(shù)，最后把 dll擴(kuò)展名改成相應(yīng)擴(kuò)展名就萬(wàn)事大吉了（使用不同的擴(kuò)展名，只不過(guò)使其容易區(qū)分而已）。
1. 開(kāi)發(fā)方法、環(huán)境和工具
如前所述，TC插件本質(zhì)上都是Windows的DLL動(dòng)態(tài)鏈接庫(kù)，其開(kāi)發(fā)方法和普通的DLL程序開(kāi)發(fā)并沒(méi)有什么不同，任何一個(gè)可用來(lái)開(kāi)發(fā)DLL的環(huán)境和工具都可以用來(lái)開(kāi)發(fā)TC插件。
因此，寫TC插件首先得熟悉DLL的編寫，更高一點(diǎn)的要求是熟悉一些常用的Windows API，對(duì)于一個(gè)程序員老手來(lái)說(shuō)應(yīng)該是很容易的事情，而用什么開(kāi)發(fā)環(huán)境和工具都是次要的。但是對(duì)于新手，筆者推薦使用VC或者Delphi來(lái)編寫，一方面的原因是TC作者提供的函數(shù)頭文件聲明只有C/C++和Pascal，可以省卻改寫成別的語(yǔ)言的麻煩；另一方面原因是TC作者給的幫助、例子，甚至網(wǎng)上公開(kāi)源碼的插件大都是基于此兩種環(huán)境的，而有一個(gè)可參考的源碼例子能在很大程度上提供編寫幫助。另外由于TC作者提供的例子（VC環(huán)境下）已經(jīng)搭建起了 插件的整個(gè)框架，我們甚至可以直接在此例子上修改開(kāi)發(fā)。
Lister插件的官方源碼例子：http://ghisler.fileburst.com/lsplugins/listplugsample.zip。
FS插件的官方源碼例子：http://ghisler.fileburst.com/fsplugins/sampleplugin.zip。
其它第3方插件的源碼例子可以從以下各個(gè)插件站點(diǎn)找到：
http://www.ghisler.com/plugins.htm
http://www.totalcmd.net
http://clubtotal.free.fr
2. Lister 插件
首先說(shuō)明一下Lister插件的工作過(guò)程：默認(rèn)快捷鍵情況下，當(dāng)在TC中對(duì)一個(gè)文件按下F3或者Ctrl+Q的時(shí)候，TC會(huì)檢查wincmd.ini中[ListerPlugins]一節(jié)，以下是個(gè)例子：
[ListerPlugins]
0=%COMMANDER_PATH%\plugins\Imagine\Imagine.wlx
0_detect="MULTIMEDIA"
1=%COMMANDER_PATH%\plugins\FlashView\FlashView.wlx
1_detect="([0]="F" & [1]="W" & [2]="S")|([0]="C" & [1]="W" & [2]="S")"
TC會(huì)順序檢查該節(jié)中每個(gè)插件對(duì)應(yīng)的x_detect字段，該字段實(shí)際上是一個(gè)邏輯判斷表達(dá)式，如果此表達(dá)式結(jié)果為真，TC就會(huì)Load該插件并調(diào)用其ListLoad函數(shù)，否則檢查下一個(gè)插件。如果插件對(duì)應(yīng)的x_detect字段根本就不存在，TC會(huì)調(diào) 用插件的ListGetDetectString函數(shù)，如果此函數(shù)存在，TC會(huì)將函數(shù)的返回結(jié)果保存在x_detect字段中再檢查，如果此函數(shù)仍然不存在，則TC就直接調(diào)用插件的ListLoad函數(shù)。最后，如果調(diào)用了ListLoad函數(shù)，還要判斷該 函數(shù)的返回值，如果該值是一個(gè)Windows句柄，則插件調(diào)用成功；若返回值為0（NULL），則調(diào)用失敗，繼續(xù)檢查下一個(gè)插件。
Lister插件的詳細(xì)接口函數(shù)介紹可以從網(wǎng)上下到：http://ghisler.fileburst.com/lsplugins/listplughelp1.2.zip。
實(shí)際上，Lister插件必需的函數(shù)只有ListLoad一個(gè)，它是插件的核心實(shí)現(xiàn)函數(shù)。插件必須在此函數(shù)中讀入文件內(nèi)容，創(chuàng)建一個(gè)窗口并顯示文件內(nèi)容，最后返回這個(gè)窗口的句柄，Lister會(huì)獲得并Subclass該句柄，并在Lister內(nèi)顯示。
其余的接口函數(shù)都是可選函數(shù)，但其中有兩個(gè)比較重要的函數(shù)：ListGetDetectString和ListCloseWindow，這兩個(gè)函數(shù)與ListLoad一起構(gòu)成了插件的主干部分。
ListGetDetectString雖然是可選函數(shù)，但是我強(qiáng)烈建議實(shí)現(xiàn)這個(gè)函數(shù)，這對(duì)Lister的效率有很大的影響。從Lister工作過(guò)程可以看出，這個(gè)函數(shù)僅僅是在插件第一次被調(diào)用時(shí)才被調(diào)用，功能是返回一個(gè)檢測(cè)字符串以填寫x_detec t字段，在此之后，Lister都將只檢查此字段以決定是否調(diào)用插件。因此，一個(gè)好的檢測(cè)字符串可以讓Lister迅速判斷插件是否適用于顯示文件，如果沒(méi)有這個(gè)，Lister每次顯示文件都將不得不把插件一個(gè)個(gè)都Load進(jìn)來(lái)、分配空間、調(diào)用ListL oad，直到找到一個(gè)合適的，這個(gè)速度可是偏離了Lister快速查看的本意。例如：檢測(cè)字符串是“ext="HTM" | ext="HTML"”，這時(shí)TC只需要根據(jù)文件擴(kuò)展名是否是htm或html就可以直接判斷該插件是否適合，而無(wú)需讀入任何文件，這就是為什么在插件眾多的時(shí)候，Lister仍然能很快顯示的原因。當(dāng)然，在某些情況下，確實(shí)難以給出一個(gè)合適的檢測(cè)字符串，這就要求ListL oad函數(shù)在文件類型判斷上的速度應(yīng)該盡可能快。
ListColseWindow是在用戶關(guān)閉Lister或在Lister中顯示另一個(gè)文件時(shí)被調(diào)用，如果此函數(shù)不存在，Lister將直接調(diào)用DestroyWindow()關(guān)閉插件窗口。通常情況下，我們需要在這里做窗口關(guān)閉時(shí)的善后工作，包括釋放 資源等等。
除以上3個(gè)函數(shù)外，其它的幾個(gè)可選函數(shù)都涉及一些具體的附加功能，取決于具體需求。
2. FileSystem插件
與Lister插件不同，當(dāng)用戶安裝一個(gè)FS插件時(shí)，該插件就會(huì)被第一次Load進(jìn)來(lái)，并調(diào)用FsGetDefRootName以獲得插件名稱，也是該FS根目錄的名字，如果這個(gè)函數(shù)不存在，TC會(huì)直接使用wfx文件的名字做插件名稱（去掉文件擴(kuò)展名） ，該名稱會(huì)保存在wincmd.ini文件[FileSystemPlugins]一節(jié)，下面是個(gè)例子：
[FileSystemPlugins]
Linux-drives=%COMMANDER_PATH%\plugins\ex2fs\ex2fs.wfx
Calendar=%COMMANDER_PATH%\plugins\calendar\calendar.wfx
Shared files=%COMMANDER_PATH%\plugins\netmon\NetMon.wfx
這樣，當(dāng)用戶進(jìn)入網(wǎng)上鄰居時(shí)，TC不需要Load插件就可以把所有插件列出來(lái)，插件只有在用戶試圖進(jìn)入FS插件目錄時(shí)才真正被Load進(jìn)來(lái)。
大致結(jié)構(gòu)上，F(xiàn)S插件需要提供的接口函數(shù)與一個(gè)真正文件系統(tǒng)的基本函數(shù)有些類似。其必需的函數(shù)有4個(gè)：FsInit、FsFindFirst、FsFindNext和 FsFindClose，是不是看了很眼熟，就和平時(shí)列舉一個(gè)目錄下所有文件所用的函數(shù) 結(jié)構(gòu)一樣。顧名思義，F(xiàn)sInit是用于插件初始化的函數(shù)，同時(shí)TC會(huì)傳給插件3個(gè)TC提供給FS插件調(diào)用的callback函數(shù)地址（下面會(huì)介紹）；FsFindFirst和FsFindNext用于列舉一個(gè)目錄下所有的文件；FsFindClose用 于終止FsFindFirst/FsFindNext的文件列舉。有了這4個(gè)函數(shù)，就構(gòu)成了最小的FS插件，就可以瀏覽FS插件的各個(gè)目錄了。
有了文件目錄結(jié)構(gòu)后，就到了根據(jù)需要提供各種文件功能的時(shí)候了，包括刪除文件FsDeleteFile；刪除目錄FsRemoveDir；建立目錄 FsMkDir；執(zhí)行文件FsExecuteFile；設(shè)置文件屬性FsSetAttr；設(shè)置文件時(shí)間Fs SetTime；拷貝文件FsGetFile/FsPutFile/FsRenMovFile。大致上都和普通文件操作功能差不多，需要說(shuō)明的是拷貝文件，由于FS插件的特殊性，拷貝文件分成了3種情況：FsGetFile是從FS中往本地硬盤拷貝；FsPutFile是從本地硬盤往FS拷貝；FsRenMovFile是 在FS內(nèi)部拷貝、移動(dòng)或重命名文件。
此外，根據(jù)FS插件的需要，TC還提供了3個(gè)callback函數(shù)以供其調(diào)用：
1) ProgressProc，用于顯示一個(gè)進(jìn)度條，例如拷貝文件時(shí)的進(jìn)度條。
2) LogProc，用于顯示FTP工具欄，插件可以在工具欄中顯示log信息，并寫入log文件。如果顯示了FTP工具欄，點(diǎn)擊“斷開(kāi)連接”按鈕時(shí)還將調(diào)用插件的FsDisconnect函數(shù)。
3) RequestProc，用于顯示一個(gè)輸入對(duì)話框，例如要求用戶輸入用戶名和密碼等等。
最后，F(xiàn)S插件還可以實(shí)現(xiàn)一個(gè)函數(shù)FsStatusInfo，如果這個(gè)函數(shù)被實(shí)現(xiàn)，TC在調(diào)用插件的任何函數(shù)（除了FsInit和FsDisconnect）之前和之后都將調(diào)用此函數(shù)，以方便插件釋放資源等等操作。
FS插件的詳細(xì)接口函數(shù)介紹可以從網(wǎng)上下載：http://ghisler.fileburst.com/fsplugins/fspluginhelp1.3.zip。
2. FileSystem插件
與Lister插件不同，當(dāng)用戶安裝一個(gè)FS插件時(shí)，該插件就會(huì)被第一次Load進(jìn)來(lái)，并調(diào)用FsGetDefRootName以獲得插件名稱，也是該FS根目錄的名字，如果這個(gè)函數(shù)不存在，TC會(huì)直接使用wfx文件的名字做插件名稱（去掉文件擴(kuò)展名） ，該名稱會(huì)保存在wincmd.ini文件[FileSystemPlugins]一節(jié)，下面是個(gè)例子：
[FileSystemPlugins]
Linux-drives=%COMMANDER_PATH%\plugins\ex2fs\ex2fs.wfx
Calendar=%COMMANDER_PATH%\plugins\calendar\calendar.wfx
Shared files=%COMMANDER_PATH%\plugins\netmon\NetMon.wfx
這樣，當(dāng)用戶進(jìn)入網(wǎng)上鄰居時(shí)，TC不需要Load插件就可以把所有插件列出來(lái)，插件只有在用戶試圖進(jìn)入FS插件目錄時(shí)才真正被Load進(jìn)來(lái)。
大致結(jié)構(gòu)上，F(xiàn)S插件需要提供的接口函數(shù)與一個(gè)真正文件系統(tǒng)的基本函數(shù)有些類似。其必需的函數(shù)有4個(gè)：FsInit、FsFindFirst、FsFindNext和 FsFindClose，是不是看了很眼熟，就和平時(shí)列舉一個(gè)目錄下所有文件所用的函數(shù) 結(jié)構(gòu)一樣。顧名思義，F(xiàn)sInit是用于插件初始化的函數(shù)，同時(shí)TC會(huì)傳給插件3個(gè)TC提供給FS插件調(diào)用的callback函數(shù)地址（下面會(huì)介紹）；FsFindFirst和FsFindNext用于列舉一個(gè)目錄下所有的文件；FsFindClose用 于終止FsFindFirst/FsFindNext的文件列舉。有了這4個(gè)函數(shù)，就構(gòu)成了最小的FS插件，就可以瀏覽FS插件的各個(gè)目錄了。
有了文件目錄結(jié)構(gòu)后，就到了根據(jù)需要提供各種文件功能的時(shí)候了，包括刪除文件FsDeleteFile；刪除目錄FsRemoveDir；建立目錄 FsMkDir；執(zhí)行文件FsExecuteFile；設(shè)置文件屬性FsSetAttr；設(shè)置文件時(shí)間Fs SetTime；拷貝文件FsGetFile/FsPutFile/FsRenMovFile。大致上都和普通文件操作功能差不多，需要說(shuō)明的是拷貝文件，由于FS插件的特殊性，拷貝文件分成了3種情況：FsGetFile是從FS中往本地硬盤拷貝；FsPutFile是從本地硬盤往FS拷貝；FsRenMovFile是 在FS內(nèi)部拷貝、移動(dòng)或重命名文件。
此外，根據(jù)FS插件的需要，TC還提供了3個(gè)callback函數(shù)以供其調(diào)用：
1) ProgressProc，用于顯示一個(gè)進(jìn)度條，例如拷貝文件時(shí)的進(jìn)度條。
2) LogProc，用于顯示FTP工具欄，插件可以在工具欄中顯示log信息，并寫入log文件。如果顯示了FTP工具欄，點(diǎn)擊“斷開(kāi)連接”按鈕時(shí)還將調(diào)用插件的FsDisconnect函數(shù)。
3) RequestProc，用于顯示一個(gè)輸入對(duì)話框，例如要求用戶輸入用戶名和密碼等等。
最后，F(xiàn)S插件還可以實(shí)現(xiàn)一個(gè)函數(shù)FsStatusInfo，如果這個(gè)函數(shù)被實(shí)現(xiàn)，TC在調(diào)用插件的任何函數(shù)（除了FsInit和FsDisconnect）之前和之后都將調(diào)用此函數(shù)，以方便插件釋放資源等等操作。
FS插件的詳細(xì)接口函數(shù)介紹可以從網(wǎng)上下載：http://ghisler.fileburst.com/fsplugins/fspluginhelp1.3.zip。