《堂匪总录》是一部清代广西地方军事档案汇编，主要记载咸丰至同治年间广西各地堂匪活动及清军剿办经过。原书以繁体竖排刊印，内容按地域分卷，收录大量匪首姓名、堂号名称及军事行动细节，呈现晚清广西社会动荡的微观图景。

全书采用档案体例编排，每卷聚焦特定府县，以“堂名 匪首 事迹”为基本单元。如桂林府卷记载三义堂、义胜堂等团伙活动，柳州府卷详述聚义堂、典明堂等组织规模。这种体例既保留原始文书特征，又体现清代地方治理中对民间秘密结社的系统性登记。

文本包含丰富的历史信息。匪首名号多带地域标识，如“永福寨沙人”“宣化马津村土匪”，反映堂匪成员的本土化特征。堂号命名规律明显，胜字堂、义字堂占比极高，凸显底层社会对武力与道义的双重推崇。军事行动记录细致到具体日期、兵力人数、行军路线，如“咸丰四年闰七月客匪刘洪桂纠长发数千人由贺县分扰上林”。

清军剿匪策略在书中有多层次呈现。官方既采用武力镇压——“代理来宾县巢鸿志求抚易名良远”，也实施招安分化——“团总谭四招之荣亦自愿投诚就抚”。跨区域协作频繁，如“署泗城府陈变埏击退”“署思恩府熊寿山会剿”，体现清代广西军政网络的联动机制。

书中大量出现特殊术语。“米饭主”指提供庇护的地方势力，“拜台”是堂会入盟仪式，“旗号”象征军事编制。这些术语构成晚清广西秘密社会的语言密码。地名系统尤其复杂，涉及土州、墟市、关隘等多层次地理单元，如“下雷土州”“大黎里”“三江口”，折射出广西多民族聚居区的行政复杂性。

文献价值突出表现在三个方面。其一，保存了正史未载的底层社会史料，如匪首黄狗儿晚“踞六陈墟”的细节；其二，记录清廷对边疆地区的控制手段，如“署西林县黄其华率同潞城团练会剿”；其三，反映太平天国时期广西地方权力的重组过程，如“石达开围攻兴义府”的关联记载。

文本存在若干时代局限。编纂立场完全站在官方视角，将堂匪统称为“贼股”；部分记载存在格式性重复，如“X年X月窜入X地”的套语；地名、人名因抄刻致异体字频现，如“雒容”又作“洛容”。这些特征既构成研读障碍，也成为考辨清代文书制度的原始素材。

作为区域性军事档案，该书填补了太平天国史研究的基层视角。它揭示出“堂匪”现象不仅是军事问题，更是晚清广西社会结构失序的缩影。书中关于团练武装、土司势力、跨省流寇的记载，为理解近代中国边疆治理提供重要参证。