863683348/dsh-project

README excerpt

DSH - DeepSeek Harness DSH（DeepSeek Harness）是一个面向 DeepSeek agent 运行场景的轻量 Python 插件宿主。它把一次 agent run 拆成标准事件，让插件在请求发出前、工具执行前等关键节点介入，实现策略控制、成本预算、审计和二次开发。 项目当前内置 guardrails （工具守卫与 Token 预算）和 session prompt （Codex 风格会话提示）两个插件。核心实现仅依赖 Python 标准库，不需要安装额外运行时依赖。 特性 - 事件驱动插件模型： run.start 、 request.before 、 request.after 、 tool call.before 、 tool call.after 、 run.end - 插件可拦截请求或工具调用：返回 EventResult(blocked=True, reason=...) 即可阻止 - 内置 guardrails 插件： - 工具白名单 / 黑名单 - 单工具调用次数上限 - 单次运行工具总调用次数上限 - prompt / completion / total 三种 Token 预算 - 内置 session prompt 插件：自动生成 Codex 风格 system prompt，并跨 run 保留会话历史与 Token 用量 - 真实 DeepSeek HTTP backend，另有 FakeBackend 用于测试和离线 demo - CLI 开箱即用： dsh demo 、 dsh session 、 dsh list-plugins - 纯标准库实现，可直接测试、直接跑 demo，之后再接真实 API 快速开始 项目使用 src 布局，Python 版本要求 =3.10 。 安装后运行 不安装直接运行 dsh demo 会执行一次脚本化的 agent run，演示 web search 被放行、 shell exec 被策略拦截、 write file 因总调用上限被拦截。 查看内置插件： 启动 Codex 风格交互会话（离线演示）： 也可以只跑一轮： guardrails 插件 guardrails 是首个内置插件，解决 agent 运行中最常见的两类问题：失控的工具调用和不可控的 Token 成本。 配置项 配置 说明 allowed tools 白名单；为空表示不启用白名单 denied tools 黑名单；命中后直接拦截 max tool calls 单工具调用次数上限，例如 {"web search": 10} max total tool calls 单次运行工具总调用次数上限 max prompt tokens 单次请求 prompt Token 上限 max completion t…

Category