DeepSeek Harness (DSH) 生态强调通过插件扩展能力。在开发与调试过程中，智能体需要查看日志来定位问题，但直接读取全部日志会超出上下文窗口限制。dsh-loglens 旨在解决这一问题，它为 Harness 提供了一套有界、光标感知的日志检查工具，并在 Web 界面中渲染紧凑的日志快照。
插件定位¶
dsh-loglens 是一个 DeepSeek Harness 插件，由 Monicaxixi 维护。它不充当通用的日志查看器，而是为模型提供一组工具，用于读取、解析和重置日志光标。
核心能力¶
该插件通过四个面向模型的原生工具实现核心功能：
- 有界窗口与源管理：支持文件源和配置的 Shell 命令。文件读取基于字节偏移和 inode 检查；命令输出在内存中限制大小。模型接收配置好的源 ID，而非任意命令或路径。
- 数据处理：支持解析有界窗口、归一化日志严重性、分组重复条目、生成问题指纹。
- 状态管理：使用光标跟踪增量读取进度，状态以原子方式存储在
.dsh/.loglens/state.json中。 - 工具列表：
logs_list：列出配置源和当前光标状态。logs_read：读取有界窗口，返回归一化、指纹化的紧凑快照。logs_raw：根据事件 ID 或指纹查找，获取缓存的原始事件。logs_reset_cursor：重置特定源的光标，重新开始增量读取。
安装与启用¶
安装插件到指定的 Harness 配置文件：
dsh plugin --profile headless add github:Monicaxixi/dsh-loglens
dsh plugin --profile web add github:Monicaxixi/dsh-loglens
安装完成后需要重启对应的配置文件。在被检查的项目根目录添加 .dsh/logs.yml 文件。插件不会在配置源之前读取日志。
使用注意¶
- 数据限制：输出、缓存和返回的事件均为有界，防止上下文溢出。
- 依赖：主机包没有额外的运行时依赖；浏览器包声明 React 为 peer dependency。
- 安全性：命令以 Harness 进程权限运行。不要在命令行参数或
.dsh/logs.yml中放入密钥。如果配置文件包含私有路径或凭证，不要提交到版本控制。 - 指纹设置：指纹识别功能会替换时间戳、UUID 等易变字段，在敏感日志上启用前请审查相关设置。
