前言¶
DeepSeek Harness (DSH) 采用了“一切皆插件”的架构理念。当智能体需要分析一个新项目时,了解其代码规模和技术栈是第一步。手动统计文件数量和行数效率低下,dsh-code-stats 插件旨在解决这一问题,提供快速、准确的代码统计能力。
插件介绍¶
dsh-code-stats 是一个由 uckkk 维护的客户端插件。它扫描指定目录,统计文件数量与代码行数,按编程语言分组,并列出最大的文件。该工具基于纯 Node.js 实现,不依赖任何外部网络服务。
核心功能¶
- 基础统计:统计文件数与代码行数。
- 分组展示:按语言分组展示代码分布。
- 清单导出:列出项目中的最大文件。
- 语言支持:支持 30+ 种语言扩展名识别,包括 JS、TS、Python、Go、Rust、Java、JSON、YAML、Markdown 等。
- 智能过滤:自动跳过
node_modules、.git等目录,以及二进制文件、图片、压缩包、锁文件等。
安装与启用¶
安装插件并启用它,需要在 profile 的配置文件中进行相应设置。
- 安装插件:
dsh plugin add dsh-code-stats
- 在 profile 的
package.json中,将"dsh-code-stats"加入dsh.profile.bundles数组中。
典型用法¶
安装完成后,在会话中调用插件注册的工具 code_stats。例如,扫描 /workspace 目录:
code_stats(root="/workspace")
该调用会返回项目的语言分布情况以及最大文件清单。
适用场景与注意¶
该插件适合用于快速了解项目规模、技术构成或代码库健康度检查。由于是纯本地 Node 实现,无网络交互,速度较快。但插件代码会在本机运行,请在安装前审阅源码与许可证(MIT)。
参考资料¶
- 插件目录:https://www.skillhub.cn/plugins/uckkk/dsh-code-stats
- GitHub 仓库:https://github.com/uckkk/dsh-code-stats