moneka123/deepseek-harness-plugin-dev-guide

README 摘要

DeepSeek Harness 插件开发技术规范与实现参考 面向 使用 AI Agent 开发 DeepSeek Harness 插件的开发者 。本文档集为人类开发者提供任务约束、源码核对路径与验收标准，也为 AI 编程 Agent 提供可执行的工程上下文，帮助双方以可验证、可维护的方式扩展 Harness。 简介 本仓库目录提供一套用于 人类开发者借助 AI 编程 Agent 开发 DeepSeek Harness 插件 的技术规范与实现参考。它不是对 API 的静态摘录，而是一份可直接提供给 Agent 作为任务上下文的工程化工作指南；源码、类型、实际导出和测试始终是最终事实来源。 文档覆盖以下核心问题： - 如何在 tools 、 systemPrompt 、 agent 、 llm 与 jobs 等扩展点之间作出合适选择； - 如何基于 Cordis Fiber 、 ctx.effect() 与 disposer 建立可取消、可卸载、可热重载的资源生命周期； - 如何使用动态 Cordis 运行时完成 define / run / stop / undefine ，并理解 Host / Client 双端沙箱与浏览器审批的编排边界； - 如何通过 Bundle、Patch、 cordis.patch.yml 与 Profile 管理配置覆盖、打包安装、升级和卸载； - 如何识别 node:vm 非安全沙箱、工具隐藏不等于授权、凭据最小化等安全限制； - 如何用 P0～P2 分级测试、HMR 卸载验证和 --dump-config 审计完成交付验收。 适用对象： - 使用 AI 编程 Agent 设计、实现、审查或维护 DeepSeek Harness 插件的开发者； - 需要在真实仓库中执行明确任务、核对源码并完成验证的 AI 编程 Agent； - 需要理解 Cordis、Bundle、Patch 与 Profile 装配关系，并对最终交付负责的集成维护者。 文档导航与推荐阅读顺序 本目录包含四份相互关联的核心文档： 文档 用途 何时阅读 AGENTS.md 插件开发总则：扩展策略、生命周期、配置、安全、测试与验收要求。 开始任何插件任务前必读。 REFERENCE.md 扩展点与运行时参考： tools 、 systemPrompt 、 agent 、 llm 、事件、服务、MCP、Session 等。 选择扩展机制、核对调用约定或设计接口时阅读。 INSTALLATION.md Bundle / Package / Profile / Patch 的关系，以及打包、安装、升级、卸载和配置审计流程。 交付、部署、升级或排查配置装配问题时阅读。 DYNAMIC-PLUGINS.md 动态 Cordis Package 指南： define 、 r…

分类