前言¶

在 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 天，可能由部署層統一留存。
- 只看應用層：數據庫審計、網絡設備、操作系統日誌不在檢查範圍內。
- 不校驗不可篡改性：這需要看存儲層設計。
- 法律合規：使用者必須遵守所在地區法律法規，對使用本項目造成的任何後果自行承擔責任。