Files
ShadowsocksX-NG/ShadowsocksX-NG2/App/AgentLogTail.swift
T
Qiu Yuzhou a6825aaafa feat(ng2): diagnostics log viewer and redacted export (#34)
主窗口诊断区(spec #21 D5/D11):

- RuntimeLog 增加事件接收缝,GUI 侧接入 RuntimeEventStore 内存环形缓冲
  (容量 500),wrapper 侧不变(stderr → agent.log 收敛)
- 主窗口侧栏新增「服务器/诊断」分区切换;诊断区日志查看器双源:GUI 事件
  实时呈现 + agent.log 尾部(1s 轮询),均可复制
- DiagnosticReportBuilder 显式触发的脱敏诊断导出:只含状态、存在性、权限、
  大小/时间、数量与脱敏元数据;不读 Keychain 与契约/目录内容;原始错误
  detail 不入导出,家目录前缀改写为「~」;服务器地址与备注不进入任何输出
- 投毒夹具测试验证导出不含任何敏感类目(密码/插件参数/地址/备注/token/JSON)

Closes #34
2026-09-20 22:41:28 +08:00

25 lines
1.2 KiB
Swift

import Foundation
/// agent.log 尾部读取(issue #34,够诊断即可):只取文件末尾有限字节并按行
/// 对齐,供主窗口日志查看器呈现。内容只进查看器,永不进入诊断导出(D5 的
/// 导出类目不含日志正文:wrapper/sslocal 的原始输出不经本产品脱敏管线)。
enum AgentLogTail {
/// 文件缺失或不可读返回 nil;内容按 UTF-8 宽容解码,起始半行丢弃。
static func readLastLines(of url: URL, maxBytes: Int = 64 * 1024) -> String? {
guard let handle = try? FileHandle(forReadingFrom: url) else { return nil }
defer { try? handle.close() }
let size = (try? handle.seekToEnd()) ?? 0
let window = min(UInt64(max(1, maxBytes)), size)
try? handle.seek(toOffset: size - window)
let data = (try? handle.read(upToCount: Int(window))) ?? Data()
guard !data.isEmpty else { return nil }
// 窗口边界可能切断多字节字符:有意宽容解码,坏字节替换而非丢弃整段。
// swiftlint:disable:next optional_data_string_conversion
var text = String(decoding: data, as: UTF8.self)
if window < size, let firstNewline = text.firstIndex(of: "\n") {
text.removeSubrange(text.startIndex...firstNewline)
}
return text
}
}