DSH Plugins
返回列表
🖥️

dsh-logger-channels

客户端 更新于 2026.10.14

在终端中运行以下命令:

dsh plugin install xuan25/dsh-logger-channels

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install xuan25/dsh-logger-channels,即可从 https://github.com/xuan25/dsh-logger-channels 安装该日志通道插件。

插件介绍

在 DSH 配置里跑插件时,框架与各插件通过 ctx.logger 写日志,但这些记录往往只留在宿主进程的内存缓冲里,运维侧看不到实时输出,排查问题只能猜或改代码加打印。dsh-logger-channels 给 profile 装上「可见的日志出口」:用命名通道把同一条日志流接到你选定的目的地。

核心能力是多种通道类型与按通道过滤:支持 stderr、stdout,以及按文件大小轮转落盘;每个通道可设最低级别阈值(遵循 cordis 的 0=error、1=info、2=warn、3=debug 编号)。每条记录一行、字段顺序固定(UTC 时间戳、启动序号、级别、logger 名、正文),Error 会带出栈信息,并可配置行长截断与 ANSI 着色。

插件本身不提供工具面,也不自带配置文件;通道在进程环境变量 LOGGER_CHANNELS_* 中声明,也可用 cordis patch 层覆盖(优先级:patch > 环境 > 内置默认)。文件通道会在超限时轮转并保留若干代;单通道写失败不会拖垮进程,只会静默停写该通道。

适合需要在本机或容器里直接看日志的开发者与运维:本地调试走 stderr,长期留存走轮转文件。若 profile 的 stdout 已承载结构化协议,应避免再开 stdout 通道,由你自行协调流归属。

使用场景

  • 本地或容器内调试时把 ctx.logger 实时打到 stderr
  • 需要按级别过滤并将日志长期写入轮转文件
  • 多插件 profile 运行时统一汇聚框架与插件日志

适合人员

  • 维护 DSH profile 的开发者
  • 在生产或测试环境运行 profile 的运维
  • 需要看见插件运行时日志的插件作者