Tether
deepseek-harness 的 C# 重实现 · 基于 Cordis 插件架构
Tether 是 deepseek-harness（dsh）的 C# 重实现：一个建立在 Cordis 插件框架之上的 agent harness——一切皆插件。
架构分层
TS 版 dsh 把 agent 运行时构建在 vendored Cordis 核心之上。Tether 用 C# 复刻同一插件架构，分为两层：
Cordis.*— 与 agent 无关的通用插件框架层。负责上下文生命周期、依赖注入图、事件总线与热重载。-
Tether.*— agent harness 产品层。能力严格按 Service Definition（Seam 接口）、Provider（实现）和 Consumer（工具/消费者）三角色解耦，进程入口只负责装配插件树。
Tether 以 dsh 的调用方可观察语义为复刻目标，但采用符合 .NET 生态的包划分、强类型设计与现代化异步模型。
名字由来
harness 是挽具，tether 是拴住它的那根绳；插件核心 Cordis（拉丁语“心的”）本身就是“索”的双关。
文档导航
1. 入门 (Guide)
快速开始 →
环境要求、构建测试与免密钥 ReplayLlm 运行体验。
配置模型与提供方 →
接入 DeepSeek 官方 API、OpenAI 兼容端点与凭据配置。
插件市场指南 →
浏览内置与扩展插件、逐行启停、配置修改、源码获取与一键恢复原版。
2. 教学 (Tutorial 课程)
16 周源码教学课程 →
循序渐进的系统教学模块：从第一次运行走到综合实践。
Cordis 7章动手教程 →
从零编写插件、掌握生命周期、服务注入、事件系统到接入真实 Harness。
Cordis 论文故事 →
给 5 岁小孩也能讲的时空可组合性：88 页论文，由浅入深全程图解。
3. 开发 (Develop)
开发一个 Tool →
基于 AIFunction 与 IToolRegistry 编写可供大模型调用的工具。
插件配置与校验 →
强类型 POCO、DataAnnotations 校验与 Fail-Loud 原则。
能力三层拆分实战 →
Seam 纯接口、Provider 实现与 Tools 消费者的标准工程模式。
插件与 Context →
Context 三合一、Effect 作用域与注册即回收纪律。
插件项目与定制开发 →
插件工程结构、SDK 编译构建、AI 辅助定制、plugin_project 工具与发布门禁。
4. 参考 (Reference) 与手册 (Cookbook)
架构总览 →
两层划分、真实依赖图、既定技术选型与已知风险。
能力服务对照表 →
dsh ctx.* 键与 Tether 能力服务的逐行对照清单。
Agent 生命周期 →
收件箱、turn/step 括号结构、取消令牌与中断恢复。
原生桌面壳 →
PhotinoX 单进程微壳架构，与命令行完全互通主目录与 Profile。
自我演化系统 →
从想法到热上线的自产插件回路：受限离线构建、影子验证与代际账本。
Cookbook：新增 Tool →
实战手册：快速为现有系统扩展模型工具。
Cookbook：新增 LLM 适配器 →
实战手册：实现 IChatClient 并封装为模型提供方插件。
Cookbook：新增能力包 →
实战手册：从零新建标准三角色能力程序集。
项目规划与事实来源
文档站不维护静态的实现进度清单，以 GitHub 为唯一事实来源：
- dsh 能力对齐矩阵：固定基线、能力 owner、差异和验收义务。
- Milestones：版本规划（v0.1 Event-sourced headless core → v0.7 Web application parity）。
- Issues：具体任务与依赖项。
致谢
- deepseek-harness — 产品架构蓝本
- Cordis（Koishi 生态）— 插件框架蓝本