anyuer678/dsh-logtimeline

Plugin插件 Native原生 ⭐ 3 GPL-3.0 Sessions & Context会话与上下文

使用中文自然语言时间表达式查询本地日志文件 — LogTimeline for DeepSeek Harness。

Project Overview项目介绍

dsh-logtimeline is a native plugin built exclusively for DeepSeek Harness (DSH) that adds a log_query tool for DSH agents. It enables agents to query local log files using natural-language Chinese time expressions, like "yesterday afternoon" or "3 hours ago". Users can install it either by cloning the repository and adding it locally via the DSH CLI, or install it one-click through the DSH community plugin market once it is listed. It requires an existing DSH profile (either web or headless) and Python 3.9+ installed on the host machine to run.

The plugin supports parsing multiple types of time inputs, including absolute dates, relative times, fuzzy windows, and explicit hour ranges, each returned with a confidence score. It automatically detects timestamp formats, handles UTF-8 and GBK encoding, and streams logs to avoid loading full large files into memory. It outputs structured JSON results with resolved time ranges, line matches, and level statistics that agents can use directly for reasoning, which eliminates the need for agents to parse unstructured terminal output. This makes it ideal for developers debugging applications that generate large log files.

This is a community-maintained plugin that is not affiliated with DeepSeek, and it is released under the GPL-3.0 open source license. It runs fully offline by default, makes no outbound network calls, does not store or exfiltrate any log data, and only reads file paths explicitly passed to it by the agent. All log analysis operations are done locally, so sensitive log content never leaves your machine. The project is not validated to production-grade standards, so it is not suitable for use in production or critical environments, and all usage risk is assumed by the user.

这是一个专为 DeepSeek Harness 开发的原生插件,核心功能是支持编码代理通过中文自然语言时间表达式查询本地日志文件。它可以解析绝对日期、相对时间、模糊时段和指定小时范围等多种中文时间表达,自动过滤匹配时间范围的日志行,同时统计不同错误级别的日志数量,输出结构化结果供代理直接推理使用。

编码代理在开发调试过程中,经常需要查询特定时间点前后的日志内容,通用日志工具需要用户手动编写grep命令和计算时间戳,使用门槛较高,这个插件简化了整个查询流程。用户只需要向代理说明要查询的时间和日志路径,插件就会自动完成时间解析和日志过滤,适合开发人员日常调试时快速定位特定时段的日志问题。

该插件遵循 GPL-3.0 协议开源,默认全程离线运行,不需要第三方API密钥,也不会将日志内容外传,所有分析都在本地完成。使用前需要提前安装Python 3.9+环境,插件目前是社区维护的非生产级项目,不适合用于生产或关键环境,使用风险由用户自行承担。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dshmarket

把 anyuer678/dsh-logtimeline 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🐳 dsh-logtimeline

Tests

Query local log files with Chinese natural-language time expressions — LogTimeline for DeepSeek Harness.

简体中文 | English

License Upstream Awesome DSH Plugin Tests Offline


Ask 「昨天下午」「3小时前」「凌晨12点」「上周三 14:00-15:00」 — get the matching log lines, the resolved time range, and ERROR/WARN/INFO level stats. Fully offline. Logs never leave the machine.

Why

Coding agents constantly need to answer "what happened around 3pm yesterday?". Generic log tools make you hand-write grep pipelines and timestamp math. log_query resolves the fuzzy Chinese time expression for you and returns structured, machine-readable matches the agent can reason over directly — no parsing prose out of terminal output.

Features

🕐 Chinese time parsing Absolute dates (2026-07-03, 7月3日 09:15), relative (3小时前, 昨天, 上周三), fuzzy windows (下午, 凌晨), hour ranges (14:00-15:00) — each with a confidence score
📄 Multi-format logs Auto-detected timestamp formats, UTF-8/GBK encoding fallback, streaming filter (no full-file load, ~2.4s per 300k lines)
🔒 Offline by default Zero third-party Python dependencies; log contents never leave the machine
🧩 Structured output Canonical JSON (time_range, filter, lines, stats) rendered as readable text for the model, spill-safe under the harness's 50KB inline budget

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-subagent-agy 下一个 Next wanbinyu-harness-toolbox →