Python · 开源 · Apache-2.0

用 DeepSeek API 做 Agent？
安全、状态、成本——这个内核帮你解决了

调 API 和造一个可靠的本地 Agent 之间有一道鸿沟。
DeepSeek Runtime 就是填平这道沟的运行内核——fork 了就能用。

git clone https://github.com/7colorai/deepseek_runtime.git

pip install -e . → deepseek-runtime doctor

调 API 和造 Agent 之间的鸿沟

直接调 API 一行代码就够了，但要让 Agent 安全可靠地跑起来，你需要解决这些问题

安全性

Agent 可能执行危险命令（rm -rf / 怎么办？）——沙箱隔离 + 权限策略 + 变更回滚，三层防护

多步推理

Agent 需要"思考→行动→观察"的循环，不是一问一答——ReAct 循环，最多 8 步深度推理

证据记录

怎么证明 Agent 调用了 API，又不泄露你的 API Key？——哈希脱敏 + 指纹记录

成本控制

花了多少 Token，缓存命中了多少，花得值不值？——内置 Token 统计 + 缓存分析 + 成本估算

断点续传

中断了能从哪一步继续，而不是重头再来？——会话状态持久化，随时恢复

可观测性

本地健康检查，一条命令体检不需要 API Key——deepseek-runtime doctor --json

六层架构

每层都是独立文件，每个文件不超过 500 行，适合 fork 后按需增删

CLI deepseek-runtime doctor / run 命令入口
运行时 ReAct 循环：思考→行动→观察 最多 8 步深度推理
会话层 SessionState / Store 短期记忆
安全层 Sandbox / Policy / ChangeManager 围栏+权限+回滚
客户端 DeepSeekClient: HTTP + 指纹 + 流式解析 优雅地跟 API 打交道
证据层 Hash / Redact / 指纹 不泄露隐私
可观测性 Token / 缓存 / 成本汇总 花了多少钱
诊断 本地健康检查：Python / API Key / 存储 不用 API Key 也能体检

快速开始

git clone https://github.com/7colorai/deepseek_runtime.git
python3 -m pip install -e .
deepseek-runtime doctor --json # 体检，不需要 API Key
deepseek-runtime run --workspace . "描述这个项目的结构"