DeepSeek Harness (DSH) 生态目前已有性能监控（如 OTel / Prometheus）类插件，但在安全审计与会话取证方面存在空白。auditrail 作为一个 DSH Bundle 插件，旨在填补这一缺口，通过记录完整的工具调用链路、标记高风险操作、提供隐私掩码存储以及会话回放功能，为智能体运行环境提供安全基线保障。
核心能力¶
该插件通过订阅 DSH 的 session/event 和 tools/* 流，对每一次工具调用进行全量记录。
-
完整的审计链记录
记录每一个事件的关键信息：执行者（session/actor）、时间戳与序号、执行的命令（工具名与掩码后的参数摘要）、涉及的文件、目标网络地址、执行结果状态以及耗时。它合并了tool_call、tool_result和tool_dispatch事件，形成一条完整的调用链。 -
敏感操作标记
内置规则引擎，检测高风险操作模式，例如rm -rf、curl | sh、密钥/敏感材料操作、破坏性 Git/DB 操作、数据外发请求以及提权行为。系统会为受影响的记录附加严重程度和规则标签。 -
SQLite (WAL) 持久化与隐私掩码
使用 SQLite 的 WAL 模式进行持久化存储，利用哈希链保证数据篡改可检测。默认情况下，所有存储内容均进行掩码和截断处理，不保存原始敏感数据。配置redact可调整掩码策略。 -
查询与导出
支持按时间窗口、会话、工具、最小严重程度、敏感规则标签等维度筛选记录。导出格式支持 JSON 报告、Markdown 报告以及符合dsh-audit-trail/compliance/1schema 的 JSONL 格式。 -
终端会话回放
将审计记录渲染为纯文本的时间线，支持暂停、步进、跳转和播放速度控制，无需浏览器即可在终端中复现会话执行过程。 -
模型工具链
向模型提供四个专用工具：audit_query（查询审计数据）、audit_export（导出报告）、audit_playback（回放会话）和audit_policy（管理规则）。
安装与启用¶
安装前请确保环境满足依赖要求。
前置条件：
- Node.js >= 22.13
- @deepseek-ai/cordis >= 4
- @deepseek-ai/dsh-tools >= 0.0.1-rc.1
安装步骤：
1、通过本地开发包安装（推荐开发调试）：
dsh plugin --profile <name> add /path/to/dsh-plugin/auditrail
2、通过打包文件安装（生产环境）：
# 假设已生成 tarball
dsh plugin --profile <name> add ./dsh-audit-trail-0.1.0.tgz
安装后，插件会自动通过 cordis.patch.yml 层挂载到 DSH 进程中。
典型用法¶
1. 模型工具调用
在 DSH 会话中，模型可以直接调用以下工具进行审计操作：
- audit_query：检索符合特定条件的审计记录。
- audit_export：将查询结果导出为指定格式（JSON/Markdown）。
- audit_playback：执行会话回放。
- audit_policy：管理敏感操作规则的启用与禁用。
2. 命令行工具
使用独立的 auditrail CLI 连接同一数据库进行操作（无需启动 DSH Harness）：
auditrail <command> [options]
注意事项¶
- 运行权限：插件以当前 DSH 进程的权限运行，需确保数据库文件路径可写。
- 数据安全：默认不保存原始敏感数据，需根据安全需求调整
redact配置。 - 许可证：本项目采用 MIT 许可证，使用前请检查源码。
总结¶
auditrail 为 DSH 生态提供了从性能监控到安全审计的补全。通过 SQLite 哈希链存储与隐私掩码，它能在记录详尽的同时保护数据安全，适合需要对智能体操作进行合规审查与风险溯源的开发者。
