DeepSeek Harness 实战：写一个可替换的能力 菜鸟教程
上一章节讲了三角色的概念，这一篇我们将按照官方教程把它写成代码。 我们要实现一个叫 myCap 的能力：输入一段文本，输出全部大写，它小到一眼看懂，又完整覆盖 Definition、Provider、Consumer 三个包。 三步走：Service Definition（抽象类 + 类型）→ Service Provi……
包含标签 deepseek 的文章
DeepSeek Harness 工具执行流水线与权限门禁 菜鸟教程
前面几章节我们学会了用 defineTool 注册工具，也学会了用事件系统监听各种扩展点。 但现在有个疑问：模型发出一条工具调用之后，到工具真正执行、结果回到模型，中间到底走了哪些环节？ 本章节我们将讲清楚 dsh 的「工具执行流水线」，以及如何用钩子插件实现权限门禁。 一句话：一次工具调用会按固定顺序经过多个环节……
DeepSeek Harness 开发第一个工具：defineTool 菜鸟教程
工具是 Agent 用来干活的函数，模型看到工具定义后决定调用。 本章节我们将用 defineTool 写出第一个工具 greet，并让模型真的调用它。 工具是什么 工具（tool）是一个描述清晰的函数，包含名称、说明、参数和输出格式。 模型在生成回复时，可以根据这些信息发起调用。 在 dsh 里，工具通过 ctx.tools.register 注册到工具注册表。 defineTool 的完……
DeepSeek Harness 插件生命周期：Fiber 状态机 菜鸟教程
之前章节我们已经注册过监听器、注册过工具、也写过 ctx.effect()。 你有没有想过：一个插件究竟从什么时刻开始「运行」，又在什么时刻开始「卸载」？ 本章节介绍 Cordis 插件模型与生命周期状态机，也就是 Fiber 状态机。 Fiber 是什么 每个被加载的插件都拥有一个 Fiber 作用域。 Fiber 可以理解成插件实例的执行单元，……
DeepSeek Harness 插件配置：Config 与 Schemastery 菜鸟教程
greet 工具把问候语写死在代码里，不同部署想换就得改代码。 本章节让插件接受 cordis.yml 传入的配置，做到"配置与代码分离"。 导出 Config 类型与同名 schema 在插件中导出一个 Config 接口和同名的 Schemastery schema。 默认值直接写在 schema 字段上。 实例 // 文件路径：scratch-plugin/src/my-plu……
DeepSeek Harness 服务与依赖：Service 基类与类型声明 菜鸟教程
前几个章节我们一直在用 ctx.tools、ctx.llm、ctx.agents 这些内置服务。 这一章节我们从服务提供方的视角出发，看如何用 Service 基类自己提供一个命名服务，并让消费方获得完整的类型提示。 什么是服务 在 Harness 中，tools、llm、agents 都是服务。 服务是挂载在 ctx 上的命名能力……
DeepSeek Harness 服务隔离与作用域 菜鸟教程
本章节我们将介绍同一个服务，怎么让不同插件组看到不同实例。 这背后是 Cordis 的 服务隔离（service isolation）与 agent 作用域（scope）机制。 服务隔离：isolate cordis.yml 支持服务隔离：同一个服务可以有多个实例，不同插件组看到不同实例。 关键词是 isolate 配置，配合 group 插件把插件分成组。 实例 #……
DeepSeek Harness 模型配置 菜鸟教程
DeepSeek Harness 可以使用 DeepSeek 官方的配置，也可以使用第三方模型。 提供方类型 是什么 凭据要求 适用场景 DeepSeek DeepSeek 官方端点 DeepSeek API 密钥（只写） 默认、最快上手 目录提供方 已安装目录里的提供方，如 Anthropic、OpenAI 各家 API 密钥；原生认证的需各自凭据 接入已收录的主流厂商 自定义提供方 自建端点，如公司网关、自建服……
DeepSeek Harness 沙箱与审批：让 Agent 危险动作可控 菜鸟教程
上一章节讲了工具执行流水线，其中两个环节最让人关心：沙箱怎么约束命令，审批怎么决定「能不能做」。 本章节将深入 ctx.sandbox 与 ctx.approval 两个服务，讲清它们各自的分工与故障关闭原则。 一句话：沙箱管「命令跑在什么边界里」，审批管「这个具体操作是否被允许」，两者都默认失败关闭。 先看整体：沙箱决策 + 审批流程 下……
DeepSeek Harness 第一个插件 菜鸟教程
在 Harness 中，插件是一个导出 apply 函数的 TypeScript 模块。 框架在加载插件时调用 apply，并传入一个 ctx（上下文对象）。 我们通过 ctx 注册能力，比如事件监听、工具、LLM 适配器。 ctx（Context）是框架传给每个插件的上下文对象。 ctx 既是注册能力的入口，也记录了插件注册的一切资源。 创建本地项目 我们需……
