前言¶
DSH（DeepSeek Harness）采用插件化架构，允许开发者根据需求扩展功能。在使用 DeepSeek 进行代码开发时，语法错误、类型缺失或 Lint 问题容易被忽略。dsh-lens 旨在解决这个问题，它充当代码的“医生”，在后台自动执行检查，并将诊断结果以卡片形式展示在聊天输入旁，同时将问题直接反馈给 AI 助手，无需手动复制粘贴或具备深厚的技术背景。
插件介绍¶
dsh-lens 是一款 DeepSeek Harness 代码自动检查插件，由用户 hajimixiaojie 维护，开源协议为 MIT。该插件隶属于模型推理类别，专注于为 DSH 提供实时的代码健康监测能力。
核心功能¶
该插件提供以下能力：
1. 代码健康检查：对代码进行持续的监控与评估。
2. 自动检查：支持语法、类型和 Lint 规则的自动检测。
3. 诊断卡片：在聊天输入框旁显示检查结果，直观呈现问题。
4. AI 交互：将检测到的问题自动分享给 AI 助手，辅助修复。
5. 低门槛：配置简单，无需技术背景即可使用。
安装与启用¶
安装过程分为四步，请依次执行。
1. 检查 DSH 安装状态¶
首先确认 DSH 是否已安装。在终端中运行以下命令：
dsh --version
若成功，会输出版本号（如 0.1.0-rc.6）；若提示 command not found，则需要先安装 DSH。
2. 安装插件¶
使用官方提供的命令安装插件：
dsh plugin --profile web add npm:@dsh-lens/dsh-lens
此命令会从 npm 仓库下载并安装插件。
3. 确认安装成功¶
运行以下命令检查插件列表：
dsh plugin --profile web list
在输出列表中确认存在 @dsh-lens/dsh-lens 即可。
4. 重启 DSH¶
关闭当前的 DSH 窗口或页面，重新打开 DSH。插件将在启动后自动生效，无需额外配置。
典型用法¶
安装完成后，插件会自动运行。以下是一个触发检查的演示步骤：
1. 打开一个包含 tsconfig.json 的 TypeScript 项目。
2. 打开任意 .ts 文件，故意写错一行代码，例如将类型写错：
const x: number = "hello";
- 保存文件。
- 查看聊天输入框上方，会出现一个诊断卡片，显示类似“1 个问题 / 1 issue”的信息。
注意：如果项目根目录没有
tsconfig.json，插件将不会对该项目进行代码检查。
适用场景与前置条件¶
- 适用场景：需要在使用 DeepSeek AI 进行代码生成或辅助开发时，实时监控代码质量的开发者。
- 前置条件：
- DSH 已安装并正常运行。
- 需要打开终端窗口以执行安装命令。
- 环境需安装 Node.js 版本 >= 20。
- 被检查的 TypeScript 项目根目录需存在
tsconfig.json文件。
总结¶
dsh-lens 通过在 DSH 环境中集成自动化的代码诊断能力，降低了代码错误进入生产环境的概率。它不修改文件内容，仅通过只读端点提供诊断信息，确保了开发流程的稳定性。如需查看源码或提交问题，可访问其 GitHub 仓库。
