前言¶

在使用 DeepSeek Harness 构建智能体时，让模型准确理解代码结构（尤其是 TypeScript/JavaScript 的类型系统）通常需要智能体主动调用 LSP 工具。DSH TypeLens 插件解决了这个问题，它通过本地分析，在文件读取和编辑后自动补充类型声明和诊断信息，使智能体无需手动干预即可获取上下文。

这是什么¶

DSH TypeLens 是一个自动化的有界类型上下文和编辑诊断插件。它由 fantasyce 维护，旨在为 DeepSeek Harness 提供本地优先的类型支持。插件通过在 DSH 的请求流中追加类型声明和诊断结果，消除了智能体记忆调用 LSP 工具的需求。

核心功能¶

DSH TypeLens 提供以下核心能力：

• 自动类型上下文与诊断：在文件读取后，仅追加理解可见代码所需的完整类型声明；在文件编辑后，追加有界的 TypeScript 诊断信息，并将新错误优先显示。
• 本地分析与隐私：分析过程完全在本地进行，无出站请求，分析状态和计数器仅驻留在内存中，不持久化源代码分析状态。
• 原生 DSH 集成：提供显式的工具接口，并在 DSH Web 的 Settings → TypeLens 中提供健康检查、自动行为调整、限制设置以及内存缓存和计数器的重置功能。
• 有界与故障开放：对工作区、文件大小、超时、深度、结果、缓存和令牌进行限制。即使分析失败，也会保持故障开放模式，不会将成功的文件操作转为失败。
• 多语言支持：支持 TypeScript、TSX、JavaScript、JSX、Vue 和 Svelte。

安装与启用¶

安装前请确保系统已安装 dsh 和 pnpm。

dsh --version
pnpm --version

使用官方插件管理命令安装：

dsh plugin --profile web add dsh-typelens
dsh plugin --profile headless add dsh-typelens

安装完成后，重启受影响的 DSH Profile，然后使用以下命令验证配置是否生效：

dsh --profile web --dump-config

在 DSH Web 中，进入 Settings → TypeLens 即可查看健康状态、调整自动行为和限制参数，或重置内存中的缓存和计数器。

典型用法¶

DSH TypeLens 提供了四个原生工具供智能体调用：

• typelens_lookup_type：查找与文件相关的命名声明。
• typelens_list_types：列出与文件相关的有界声明。
• typelens_check：运行有界的文件和项目诊断。
• typelens_explain：检查有效的配置、健康状态、断路器状态和源无关的计数器。

这些工具返回的路径均为工作区相对路径。

适用场景与注意¶

DSH TypeLens 适合需要在 DeepSeek Harness 中处理 TypeScript、JavaScript、Vue 或 Svelte 项目的开发者。插件以当前 DSH 进程的权限运行，建议在安装前检查源码与许可证。

插件仅持久化经过验证的设置，位于 $DSH_HOME/typelens/settings，且仅允许所有者权限。分析上下文和诊断信息会附加到智能体步骤中，并成为下一个 DSH 模型请求的一部分，因此遵循模型提供商的隐私政策。

结语¶

DSH TypeLens 为 DeepSeek Harness 提供了标准化的类型上下文和诊断能力，通过本地化、有界的分析策略，提升了智能体在代码编辑任务中的准确性和可靠性。