Metadata-Version: 2.4
Name: agentstracer
Version: 1.0.3
Summary: Review, score, and curate your coding agent conversation traces locally
Author: kaiaiagent
License-Expression: MIT
Project-URL: Homepage, https://github.com/cyijun/agentstracer
Project-URL: Repository, https://github.com/cyijun/agentstracer
Keywords: claude-code,codex,gemini-cli,opencode,openclaw,dataset,conversations
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# AgentsTrace (Local-Only Fork)

原版：[kaiaiagent/clawtrace](https://github.com/kaiaiagent/clawtrace)

---

## 快速开始

### 安装

```bash
pip install agentstracer
```

或从源码安装：

```bash
git clone https://github.com/cyijun/agentstracer.git
cd agentstracer
pip install -e .
```

### 基本使用

```bash
# 1. 配置导出源（claude/kimi/codex/gemini/all）
agentstracer config --source all

# 2. 导出对话记录
agentstracer export --no-push -o my_conversations.jsonl
```

### 私人使用（保留 API Keys）

```bash
# 禁用 secrets 脱敏（仅建议本地私人使用）
agentstracer config --no-secrets-redaction

# 导出（包含原始 API keys）
agentstracer export --no-push -o my_data.jsonl

# ⚠️ 警告：此文件包含明文 API keys，请勿分享！
```

### 其他命令

```bash
# 列出发现的项目
agentstracer list

# 启动本地 Web UI
agentstracer serve

# 查看配置
agentstracer config
```

---

## 支持的 AI 工具

| 工具 | 数据位置 | 状态 |
|------|---------|------|
| Claude Code | `~/.claude/projects/` | ✅ |
| Kimi CLI | `~/.kimi/sessions/` | ✅ |
| Codex CLI | `~/.codex/sessions/` | ✅ |
| OpenCode | `~/.local/share/opencode/` | ✅ |
| OpenClaw | `~/.openclaw/` | ✅ |
| Gemini CLI | `~/.gemini/tmp/` | ✅ |

---

## 导出格式

**JSONL**（每行一个 JSON 对象）：

```jsonl
{"session_id": "abc-123", "model": "kimi-k2", "messages": [...], ...}
{"session_id": "def-456", "model": "claude-3-7", "messages": [...], ...}
```

### 主要字段

| 字段 | 说明 |
|------|------|
| `session_id` | 会话唯一标识 |
| `model` | AI 模型名称 |
| `project` | 项目名称（已脱敏） |
| `source` | 来源（claude/kimi/codex等） |
| `start_time` / `end_time` | ISO 8601 时间 |
| `messages` | 对话消息列表 |
| `stats` | 统计信息 |

### messages 结构

```json
{
  "role": "user|assistant",
  "content": "消息内容",
  "thinking": "思考过程（assistant）",
  "timestamp": "2024-01-01T12:00:00Z",
  "tool_uses": [{
    "tool": "bash",
    "input": {"command": "ls -la"},
    "output": {"text": "..."},
    "status": "success"
  }]
}
```

---

## 关于本版本

这是 [AgentsTrace](https://github.com/kaiaiagent/clawtrace) 的修改版本，专注于**本地隐私保护**和**纯离线使用**。

### 主要修改点

#### 1. 移除所有网络功能
- ❌ 云上传功能
- ❌ Skill 下载功能
- ❌ 浏览器自动打开
- ❌ 所有 urllib 网络请求

#### 2. 可选禁用 Secrets 脱敏
- 新增 `--no-secrets-redaction` 配置
- 私人使用时保留 API keys
- 路径/用户名脱敏始终启用

#### 3. 安全审查
- ✅ 无 `eval()` / `exec()` / `compile()`
- ✅ 无动态代码执行
- ✅ 无反序列化风险
- ✅ 路径遍历已防护

### 与原版对比

| 功能 | 原版 | 本版本 |
|------|------|--------|
| 云上传 | ✅ | ❌ 已移除 |
| Skill 下载 | ✅ | ❌ 已移除 |
| 可选禁用脱敏 | ❌ | ✅ 支持 |
| 适用场景 | 分享数据集 | 私人本地分析 |

---

## 许可证

MIT License - 详见 [LICENSE](LICENSE)

Copyright (c) 2024 kaiaiagent (Original Author)  
Copyright (c) 2024 cyijun (Modified Version)
