DeepSeek-Harness-Sharp 首版发布

[forestbat]

DeepSeek-Harness-Sharp (DSH-Sharp) 发布说明

• 本项目是受 DeepSeek Harness(DSH) 理念影响，开发的一个C#重制版，但并非完全复现DSH功能，有作者本人的一些想法(下面说明，这里不赘述)。
• 本项目不附带任何官方背景，与 DeepSeek 官方无隶属或背书关系，无产品化团队，问题响应与长期维护不做承诺。
• 这是一个尚在演进中的个人实现，功能、性能与稳定性只进行过自测，覆盖面有限，缺陷挂一漏万，距离“产品级”还有明显距离，欢迎批判性使用。
• 欢迎大家指出错误；如果它恰好对你有用，那是我们的荣幸，而不是它足够好。

如何安装

• Linux / macOS：curl -fsSL https://raw.githubusercontent.com/forestbat/DeepSeek-Harness-Sharp/master/scripts/install.sh | bash
  • curl -fsSL https://raw.githubusercontent.com/forestbat/DeepSeek-Harness-Sharp/master/scripts/install.sh | DSHSH_VERSION=v0.1.0-aot bash 可选择安装AOT版本（默认为JIT）。
• Windows：irm https://raw.githubusercontent.com/forestbat/DeepSeek-Harness-Sharp/master/scripts/install.ps1 | iex
  • $env:DSHSH_VERSION='v0.1.0-aot'; irm https://raw.githubusercontent.com/forestbat/DeepSeek-Harness-Sharp/master/scripts/install.ps1 | iex 可选择安装AOT版本（默认为JIT）。
• 安装程序会注册 dshsh 命令，运行该命令即可启动TUI。
• 可用 DSHSH_HOME（安装目录）、DSHSH_BASE_URL（Release 基址/镜像）、DSHSH_PROXY（下载代理）、DSHSH_LOCAL_ARCHIVE（本地归档，离线安装）覆盖默认行为。

使用方法

本项目目前支持Headless（无头）、TUI（终端交互）和Avalonia GUI三个入口，后两个均支持GPU渲染加速。

• TUI启动参数：
  • dshsh (tui)：启动TUI，其中tui参数可选，除非带二级命令。
  • dshsh (tui) --gpu：以GPU渲染方式启动TUI，目前只支持OpenGL，尚未支持Vulkan。
  • dshsh headless "<任务>"：以无头方式完成一个任务。
• TUI会话管理：
  • 本项目使用类tmux方式（守护进程+伪终端）管理会话，因此不需要用tmux等终端复用器包裹TUI进程也可实现保活。
  • 目前的伪终端管理共分三级，Pty/Session/Pane，Pty是伪终端进程，Session是用户会话，Pane是分屏，可以对应tmux的Session/Window/Pane，一个Pty之下可以有多个Session。
  • dsh tui list：列出所有Pty，用户可以选择其中一个attach进去。
  • dsh tui attach <id> 接管特定的Pty。注意：目前Pty不能被直接访问，attach pty会自动选择其中第一个被创建的session。
  • TUI的前缀键为Ctrl+X，目前尚不支持自定义前缀键。
  • 在TUI内部输入/detach命令或Ctrl+X D快捷键，即可分离出会话。
  • 在TUI内部输入Ctrl+X W，即可查看pty、session和pane的总览并切换session。
  • pane 视图可在守护进程内列出、读取与投递内容（list/read/send），这样LLM就可以看到不同分屏内进程的状态。
  • 注意：同一个session的pane共享同一个输入区域，按Ctrl+X ←/→可换屏。
• 桌面 GUI：
  • 由内置插件 @deepseek-ai/dsh-gui 负责逻辑，双击dsh-gui.exe即可打开。
  • GUI 与 TUI 共用同一份配置、会话、命令与审批链路。
  • 左侧栏显示运行中的会话，用户可为新会话指定默认工作区。
• 配置：~/.dsh/settings.yaml（Windows 为 %USERPROFILE%\.dsh\settings.yaml），首次运行生成带注释模板；--home/DSH_HOME 可指定独立配置根。
• 本项目支持添加和卸载插件（否则“学习DeepSeek Harness”就是一句空话），插件安装和开发规范，参见示例工程DeepSeek-Harness-Sharp\templates。
  • src/ 下的模块是作者预置的插件包，与用户自己编写的插件在标准上完全同级，只有依赖关系，没有地位差别。

---

模块的职责

注意：src/下的模块中，带Plugin.cs的就是插件，不带的不是，所以下文不会继续强调谁是插件。

运行时与内核

• Dsh.Runtime：DI 容器、服务/效应/事件与日志等基础设施（用以取代Cordis，不作为插件存在）。
• Dsh.Core：Agent 循环与注册表、会话与回合模型。
• Dsh.Boot：启动装配、配置读取（settings.yaml）、插件入口与 CLI 路由（启动入口，不作为插件存在）。
• Dsh.Persistence：JSONL 会话持久化与分块读写。
• Dsh.SessionQuery：会话全文检索，TUI中命令为 /session-query。
• Dsh.Telemetry：事件级遥测与埋点。
• Dsh.Sdk：对外 SDK 线格式与记录类型（AOT 下由源生成上下文提供元数据）。
• Dsh.Toon：支持 TOON 编解码以代替 JSON，默认关闭，启用后LLM可以使用 TOON 格式生成工具调用/接受 TOON 格式输入，节省token。
• Dsh.Account：GUI负责从这里登录DeepSeek账号，默认走官方地址，私有部署只通过插件参数覆盖。

模型与提供者

• Dsh.Llm：提供各种LLM的支持（500+模型），目前通过models.dev开源项目接入市面已知的LLM供应商，不作为插件存在。
  • 为什么不作为插件存在？其实理论上符号规则库或世界模型也可以操作Dsh.Runtime/Cordis，但现在市面上根本没有可以公开使用的世界模型，所以目前没有动力把Dsh.Llm作为插件拆出来。
  • 支持 OpenAI Compatible API 和 Anthropic Messages API，可以自定义私有部署的模型接入。

工具与执行环境

• Dsh.Interaction：顾名思义，负责和用户交互的部分，含有命令与菜单模型、diff 卡片等交互效果。
• Dsh.Tools：Bash/Pwsh/Edit/文件系统等基础工具（envs 过滤 DSH_*、workdir 校验、空参数归一）。
• Dsh.Jobs：本地后台任务与可持久化的长时命令。
• Dsh.E2b：E2B 沙箱运行时与工具（目前用沙箱的场合不多，未着重开发）。
• Dsh.Mcp：MCP 服务器接入，若会话过期（例如 MCP 服务器重启）会自动换句柄重握手。
• Dsh.Lsp：LSP 服务接入（目前用LSP的场合不多，未着重开发）。
• Dsh.Acp：ACP 客户端/服务端与 socket 服务（只有基础通信能力，未针对具体的Agent进行适配）。
• Dsh.A2A：A2A协议(Agent2Agent)的服务端+客户端实现，可从其他Agent接受消息，也可给其他Agent派发任务。
• Dsh.Web：网页抓取与搜索工具。
• Dsh.Checkpoints：基于 shadow git 的检查点与回滚机制，因为占空间比较大，默认处于禁用状态，未经进一步开发和测试。
• Dsh.IdeHistory：若项目文件夹是VSCode / JetBrains IDE的工程，则可利用它们的历史记录，以节省CheckPoints的大空间消耗。
• Dsh.Ptc：对应DSH的PTC模式，生成程序化工具调用。
• Dsh.Workflow：工作流与 Ralph 循环工具。
  • 注意：工作流与 PTC 具有共通性，因此这两个模块共用同一 C# 宿主，脚本由 Dsh.Ptc 的 PtcProgramCompiler 编译（Roslyn）后执行。
• Dsh.Skills：技能发现与 /skill 命令（文件系统技能提供者）。
• Dsh.Inspection / Dsh.Presets：对应DSH的创造模式。

会话与协作

• Dsh.Subagent：子代理编排，目前分为Headless和Interaction两档，后一档具有完整的Session功能（用户直接开设的主会话即为Interaction），前一档则是为multi-agent系统节约配置的轻量档位，相当于一个保留用户控制的async/await任务。
• Dsh.Board：子代理共享的看板，提高协作效率，减少token浪费。
• Dsh.Goal：目标（goal）状态机、权威判定与折叠。
• Dsh.PlanMode：计划模式控制器与相关命令。
• Dsh.Compaction：上下文压缩（ /compact 命令）与会话自动命名（会根据首条用户消息或首条LLM消息为会话重命名，也可能在回合结束触发，先到者先得）。
• Dsh.Memory：项目记忆功能，会自动（用户也可以直接要求）保存当前工作区的记忆，留待后续工作；默认是个md文件，可选支持MongoDB。
• Dsh.AgentInstructions：AGENTS.md 等指令文本的装载，按不同的会话工作区解析。

终端与界面

• Dsh.Pty：负责PTY（伪终端）会话与守护进程、attach 隧道、终端鼠标解析与注入等流程，是DSH-Sharp终端实现的基础。
• Dsh.PtyTerminal：PTY 终端后端与滚动缓冲渲染。
• Dsh.Tui：与其说是TUI，不如说是终端模拟器。
• Dsh.Gui：Avalonia 桌面界面，作为内置插件与 TUI 共用内核。
• Dsh.Plugins.*：插件管理能力的实现，不作为插件存在。

---

多做了什么

• 添加原生 TUI；由于使用 .NET 实现，TUI 单进程常驻内存约 10MB，GUI 单进程也只有50-100MB，大大节省了性能。
• TUI 以自定义终端模拟器方式实现，无保活问题，可支持GPU渲染，各分屏(Pane)之间可以互相访问，增强协作性。
• 插件规范较简单，提供现成模板，可见的未来不会受破坏。
• 支持 JIT 和 AOT 发布，适应不同的运行要求，兼顾安全性。
• 支持 A2A 协议，可以和其他Agent互联互通。
• GUI 同时支持 Windows 和 Linux Desktop(GNOME/KDE)。
• 利用既有编辑器生态体系，如VSCode / JetBrains IDE。
• 支持 TOON 格式。

---

准备做什么（或者说，不足之处）

• 因为个人能力所限，未在 MacOS 上进行完整测试，拟使用 GitHub Actions 解决环境问题。
• 继续改进 TUI 的渲染和进程管理问题，支持 Vulkan，扩展能力并规避 libEGL 限制。
• 改进 CI 工作流。
• 推出 TimeStamp 机制，可以回退到用户发出的具体某条消息（包括上下文和文件系统），以及消息撤回功能。
• GUI 的美观性。
• TUI 颜色配置功能。
• 改进 AOT 相关的逻辑。
• 持续注意模块之间的耦合，随时准备解耦。
• 现有流行 Agent 的有用功能，及用户要求添加的其他功能（作为一个 vibe coding 一个月就敢往外发的“产品”，功能和美观度还是相当欠缺的）。
• Harness 进化的可能（我怎么知道？）。

---

暂时不打算做什么

• Office 支持：OfficeCLI 工具已经可以满足一般 Office 处理的要求，没必要单独做个插件。

  • 如果你需要跨平台 C# Office 二次开发，也可以看看OfficeIMO，该库不需要 MS Office COM 组件。

• WebUI：我一直觉得 DSH 自带的 WebUI 属于一个吃浏览器的赶工产物（新出的官方 GUI 也是个套壳浏览器），在已有 Avalonia GUI 的前提下，暂时没有做 WebUI 的想法。

---

鸣谢

• 感谢 DeepSeek 团队提供廉价的 LLM 及新的 Harness 开发理念，否则这个项目就没有问世的可能。
• 本项目开发的主力模型是 DeepSeek v4.1 Flash，虽然也用到了 Kimi K3 但我真不太想夸它，额度太贵且速度太慢，而且在 C#/.NET 编写上可能弱于 DeepSeek。
• 感谢 LLM 和 .NET 开发社区的朋友们，给出了很多有用的建议。

希望这个项目的未来越来越好！