实时代码反馈NexusAgentX/dsh-lens

dsh-lens

为 DeepSeek Harness 提供实时代码反馈：在智能体编写代码时进行 LSP、linter、formatter、类型检查和结构分析。

当前版本：dsh-lens@0.2.0。

英文 | 中文

功能简介

这是 pi-lens 的宿主原生移植版。分析引擎仍保留在 pi-lens 中；本插件是 DeepSeek Harness 适配器。

在每次 write / edit / bash 变更时，它都会运行与 pi-lens 在 Pi 中所用相同的流水线：

1. 格式化队列 / 安全自动修复
2. LSP 文件同步与诊断
3. ast-grep、tree-sitter、事实规则和语言扫描器
4. 对可能受影响的邻近文件进行级联诊断
5. 在下一轮模型请求中注入回合结束阻断项和提示项

它还注册了完整的面向智能体的工具集、/lens-* 命令、捆绑的 pi-lens 技能，以及一个 WebUI 芯片/停靠面板。

独立 CLI（审查图，与 pi-lens build-graph 相同）：

npx dsh-lens build-graph --cwd .
npx dsh-lens status

安装

dsh plugin --profile web add dsh-lens

或从 git 安装：

dsh plugin --profile web add github:NexusAgentX/dsh-lens

不要再针对同一工作区附加 pi-lens-mcp / 官方 MCP 封装的 pi-lens——那会导致语言服务器被重复启动。

工具

始终可用：

- lens_diagnostics — 缓存的 / 项目诊断状态（delta / all / full）
- lsp_diagnostics — 文件或目录范围的 LSP 诊断
- symbol_search — 排序后的标识符搜索
- module_report / project_report
- read_symbol / read_enclosing

同样已注册（dsh 没有动态工具 API，因此它们会一直可见）：

- ast_grep_search / ast_grep_replace / ast_grep_outline / ast_grep_dump
- lsp_navigation
- lens_diagnostic_mark
- pi_lens_activate_tools — 在 dsh 上是空操作目录；所有工具均已激活

官方的 lsp 工具保持不变。简单跳转请使用它；完整的 IDE 功能请使用 lsp_navigation。

lens_diagnostics、ast_grep_search 和 symbol_search 会以搜索卡片形式呈现，并支持文件跟随。

命令

| 命令 | 作用 |
|---|---|
| /lens-toggle | 为当前会话启用或禁用该流水线 |
| /lens-context-toggle | 保持工具/LSP/格式化开启，但停止向下一回合注入内容 |
| /lens-widget-toggle | 显示或隐藏 WebUI 芯片和停靠面板 |
| /lens-health | 会话健康状况、LSP 列表、级联、事件循环、噪声规则 |
| /lens-perf | 进程 + 全机器范围的 p50/p99 阶段排名 |
| /lens-tools | 按来源分组的安装器状态 |
| /lens-tdi | 技术债务指数 |
| /lens-map | 写出 HTML 依赖图；芯片会获得一个“打开地图”操作 |
| /lens-allow-edit  | 一次性读取保护豁免 |

WebUI

在官方 dsh web 配置下，该插件附带一个浏览器端部分（dsh.client）：

- 会话头部芯片（conversation.session.header.actions）
- 输入框停靠面板（conversation.input.dock）
- 官方原语：Menu、Tooltip、StateDot、chevron、CSS modules、zh/en 语言环境

该芯片读取 lens 会话投影，该投影由 tool/result、turn/end 和 /lens-widget-toggle 上的 widget-state 折叠而成。它不会追加自定义会话事件，因此持久化不会拒绝该日志。

技能

当 ctx.skills 存在时，会注册四个上游 pi-lens 技能：

- pi-lens-ast-grep
- pi-lens-lsp-navigation
- pi-lens-write-ast-grep-rule
- pi-lens-write-tree-sitter-rule

配置

与 pi-lens 相同的文件：

- 项目：.pi-lens.json
- 全局：~/.pi-lens/config.json

Cordis 条目上的插件配置（省略某个键以保留 .pi-lens.json / 环境变量）：

- id: dsh-lens
name: dsh-lens
config:
cwd: /path/to/workspace
enabled: true
contextInjection: true
lsp: true
format: true
immediateFormat: false
autofix: true
tests: true
delta: true
guard: false
opengrep: true
readGuard: true
turnSummary: false
actionableWarnings: false
actionableWarningActions: false
actionableWarningAutofix: false
actionableWarningAll: false

布尔键映射到与 pi-lens 相同的标志（--no-lsp、--lens-guard、--immediate-format……）。

宿主限制

dsh 在派发前冻结工具参数，因此 Pi 的进行中编辑自动补丁无法重写 old_string。dsh 已经拥有自己的编辑前读取观察策略。

以下 Pi 宿主界面未被克隆：TUI 页脚、交互式 LSP 安装提示、会话分叉 / 跨进程提示、官方 Settings 卡片（apiproxy 允许列表），以及 /lens-booboo（仍在上游推迟中）。

许可证

MIT

灵感来自 pi-lens（MIT）。参见 NOTICE。

中文

给 DeepSeek Harness 用的实时代码反馈插件。分析引擎还是 pi-lens，这里是 dsh 宿主适配：写文件后跑 format / LSP / linter / 结构规则，并把 blocker 注回下一轮。

当前版本：dsh-lens@0.2.0。

dsh plugin --profile web add dsh-lens

Web profile 会装上会话标题旁的 lens 芯片和输入框上面的 dock（官方 Menu / Tooltip / StateDot）。/lens-widget-toggle 可隐藏。/lens-health、/lens-perf、/lens-tools 与上游报告对齐。

不要和 pi-lens-mcp 同时挂同一批 workspace，会双开语言服务器。

配置继续用 .pi-lens.json / ~/.pi-lens/config.json，也可以在 Cordis 条目里写 lsp / format / guard 等开关。