AI 简明手册
DeepSeek Harness 源码解读 · 持久化与基建Web、命令行与 SDK 怎样共享一个内核

专题篇章 · 持久化与基建源码解读

Web、命令行与 SDK 怎样共享一个内核

先看全局

多个入口共享同一内核，入口层只增加 cordis.yml 与协议桥。跨 wire 使用 Typert，从类型图生成 schema 与客户端类型。

沿地图找代码

三份入口配置内核插件相同

三份入口配置内核插件相同，差异仅在服务器与协议桥。Python SDK 与 JSON-RPC 入口同源。JSON-RPC 和 ACP 禁 console logger，stdout 是传输线。

[repo]

Typert 只导出 @Remote 方法

Typert 只导出 @Remote 方法，构建时生成 schema、descriptor 和客户端类型。通用 schema 生成器无法表达类型合并与活对象生命周期，故自研。

[repo]

建议阅读顺序

  • 加聊天机器人入口，哪些不用写： 内核插件、会话持久化、压缩、工具全部照抄现有配置。

  • 机器人桥有无 stdout 互斥： 无，但有速率和长度限制，事件流须节流合并。

这张地图没覆盖什么

  • 本页结论对应 revision 0a53fb55bea101816fa226bb964ae2bed71c343b。文件位置、命名和默认行为可能随版本变化，引用实现细节时应同时记录 commit。

来源与核验

  1. [repo] DeepSeek Harness 官方源码（固定 revision）
  2. [official] DeepSeek Harness 官方介绍

Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31