前言¶
在 DeepSeek Harness (DSH) 的生态中，插件是扩展能力的主要方式。日志是安全审计的基础，但开发者常在配置轮转时只关注“够用”，而忽略“法定”时长。例如，将日志库的 maxDays 设为 7 天，排障时够用，但半年后发生安全事件时，依据《网络安全法》要求留存不少于 6 个月的规定，日志已被轮转删除，导致合规失效。
dsh-cn-log-retention 旨在解决这类问题。这是一个 DSH 插件，用于检查应用层的日志留存是否满足法定 6 个月的要求。
核心功能¶
该插件主要检查以下内容：
1. 检查日志是否开启。
2. 检查日志是否记录了该记的。
3. 检查日志是否留够法定 6 个月。
4. 检查留存期是否小于 180 天（高）。
5. 检查日志级别是否被关闭（高）。
6. 检查日志里是否打印了口令或令牌的值（高）。
7. 检查是否存在日志方案（中）。
安装¶
使用官方命令安装：
dsh plugin --profile web add @deepwhale-cn/dsh-cn-log-retention
使用方法¶
安装完成后，可以通过以下命令使用：
# 查看检出效果
dsh-cn-log-retention --demo
# 列出规则和依据
dsh-cn-log-retention --list-rules
# 生成 HTML 报告
dsh-cn-log-retention --html r.html
注意事项¶
使用该插件时，需要了解其边界：
- 不做缺项判定：没有轮转配置不代表日志没留 180 天，可能由部署层统一留存。
- 只看应用层：数据库审计、网络设备、操作系统日志不在检查范围内。
- 不校验不可篡改性：这需要看存储层设计。
- 法律合规：使用者必须遵守所在地区法律法规，对使用本项目造成的任何后果自行承担责任。
