Monicaxixi/dsh-loglens

dsh-loglens

用于有界、游标感知日志检查的 DeepSeek Harness 插件。有关最小的安装和可用性检查，请参阅
TESTING.md。

dsh-loglens 是用于 DeepSeek Harness 的 dsh-plugin，而不是通用日志查看器或 Codex Skill。它向 Harness 配置文件添加有界、游标感知的日志工具，并在 Harness Web 对话 UI 中渲染紧凑的日志快照。

从 GitHub 安装

将公共插件安装到 Harness 配置文件中：

dsh plugin --profile headless add github:Monicaxixi/dsh-loglens
dsh plugin --profile web add github:Monicaxixi/dsh-loglens

安装后重启配置文件。然后在被检查的项目中添加 .dsh/logs.yml。该插件暴露 logs_list、logs_read、logs_raw 和 logs_reset_cursor；在配置源之前，它不会读取日志。

dsh-loglens 是一个小型 DeepSeek Harness 插件，用于有界、可重复的日志检查。它暴露四个面向模型的工具：

- logs_list — 已配置的源和游标状态。
- logs_read — 解析有界窗口，规范化严重级别，对重复项分组，对问题进行指纹识别，并返回紧凑快照。
- logs_raw — 仅在显式事件 id 或指纹查找之后，检索缓存的原始事件。
- logs_reset_cursor — 为一个源重新开始增量读取。

该实现支持文件源和已配置的 shell 命令。文件读取使用字节偏移量和 inode 检查；命令输出在内存中设有上限。模型接收的是源 id，而绝不是任意命令或路径。状态默认以原子方式存储在 .dsh/.loglens/state.json 下，并且仅包含有界缓存事件。

本地设置

cp .dsh/logs.yml.example .dsh/logs.yml
corepack pnpm install
corepack pnpm test
corepack pnpm run build

Host bundle 没有额外的运行时依赖。浏览器 bundle 将 React 声明为 peer dependency，并以 Harness window.__ModuleLoader__ 格式输出。Node 22 可以使用 --experimental-strip-types 直接运行 TypeScript 测试。

要将此检出安装到本地 Harness 配置文件中：

dsh plugin --profile headless add /absolute/path/to/dsh-loglens
dsh --profile headless --help

该包的 dsh.bundle.patch 添加 Host 插件条目。其 dsh.client 元数据由 Web 客户端模块名册发现；浏览器条目有意不挂载在 headless/TUI Host 配置文件中。

此工作区将本地 Harness 检出及其测试配置文件放在插件旁边：

- ./vendor/deepseek-harness — 官方 Harness 源代码检出和构建。
- ./runtime/dsh-loglens-home/profiles/headless — 隔离的 headless 配置文件。
- ./runtime/dsh-loglens-home/profiles/web — 隔离的 Web 配置文件。
根级 package.json、pnpm-lock.yaml、tsconfig*.json、tsdown.config.ts 和 cordis.patch.yml 是 pnpm、TypeScript、tsdown 和 Harness 所需的包/构建入口文件。它们被有意保留在项目根目录；生成的依赖保留在 node_modules/ 和 Harness 检出目录自身的 node_modules/ 中。

要直接运行已检入的本地 Harness：

DSH_HOME="$PWD/runtime/dsh-loglens-home" \
node "$PWD/vendor/deepseek-harness/apps/cli/lib/bin.js" \
--profile headless --help

Harness 宿主集成

宿主入口点是 src/plugin.ts（同时也作为包的默认导出）。它加载 .dsh/logs.yml，构造服务，通过 ctx.tools.register 注册四个工具，并在 logs_read 之后追加一个紧凑的 loglens/snapshot 会话事件。当宿主的常规会话持久化启用时，该事件是持久化的。

该插件使用官方工具上下文结构：每个定义都有 name、description、parameters、output.schema、output.render 和 execute(args, exec)。在具有类型化会话事件的宿主包中，使用 src/client.ts 中的事件数据形状将该事件添加到宿主的 SessionEventMap：

"loglens/snapshot": {
viewId: string;
snapshot: LogLensCardSnapshot;
}

官方 Web Client 入口点是 src/client.ts。它注册一个 loglens 对话节点和一个带键的 conversation.chat.node 渲染器。它默认使用 React 的 createElement，并接受一个可选的兼容工厂用于测试。它显示统计信息、分组问题、最近事件和可展开的堆栈帧；原始内容保留在 logs_raw 之后。

配置

.dsh/logs.yml 使用一个刻意精简的 YAML 子集：映射、标量字符串/数字/布尔值以及注释。列表被拒绝，以便配置保持可预测。相对文件路径从项目根目录解析。参见 .dsh/logs.yml.example。

指纹识别会替换易变的 timestamps、UUIDs、ids、临时路径和长数值。异常指纹包含异常类型/消息以及前几个有意义的堆栈帧。它刻意保持保守：应用程序特定的字段可能保留在消息中，在敏感日志上启用此功能之前应进行审查。

安全与限制

只有源 id 会暴露给模型工具参数。命令是由管理员编写的配置，并在 Harness 进程环境中运行。输出、最近事件、原始缓存、分组数量和返回的原始事件都受到限制。不要将机密放入命令行参数中，如果 .dsh/logs.yml 包含私有路径或凭据，也不要提交它。

使用的官方 Harness 约定
该适配器遵循 development、architecture、tool API README 以及 conversation node cookbook 中记录的公共 Harness 包约定。