mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
2cde2a9032
Conflict resolution notes: - package.json/run-gates: both sides' new doc-sync gates kept (master's scoped-events/readme gates + this branch's website-api/website-yaml); js-yaml devDeps deduped (master added them independently). - pnpm-workspace/knip: website AND python/sdk-runtime entries kept. - doc-typecheck/verify-type-equiv: master's condensed headers kept, website glob retained in both scan scopes. - vendor/cordis/src/fiber.ts: master's lifecycle-hardening code taken; this branch's richer FiberState JSDoc reapplied on top. vendor/README.md logs both local modifications (hardening = 6, JSDoc enrichment = 7). - pnpm-lock: regenerated from master's side (pnpm install). Post-merge sync the gates forced (the system working as designed): - verify-website-yaml caught 4 stale plugin names from master's package reorg (dsh-stdio-agent -> dsh-stdio-demo, dsh-acp-agent -> dsh-acp-demo); 8 references fixed across guide/ and develop/. - gen-website-api picked up master's 6 new services automatically (ctx.approval/permission/sandbox/sessionQuery/skills/tasks -> 6 new pages + sidebar); api/index.md hub updated to list them. - AGENTS.md budget ceiling 1370 -> 1400: the website rows (layout line + two command lines) and master's own growth collided with the old ceiling; all three website rows are load-bearing (new top-level dir, new CI command).
1.6 KiB
1.6 KiB
介绍
DeepSeek Harness 是一个插件化的 Agent 开发框架，基于 Cordis 微内核构建。它的核心理念是：一切皆插件。
它是什么
Harness 将一个 AI Agent（智能体） 所需要的所有能力——LLM 调用、工具执行、会话管理、子任务分配——全部构建为可组合的插件。你通过一个 cordis.yml 配置文件来声明加载哪些插件、使用什么参数，就能组装出一个完整的 Agent。
# 选择 LLM 后端
- name: '@deepseek-ai/dsh-llm-deepseek'
config:
apiKey: !!js process.env.DEEPSEEK_API_KEY
# 选择应用模板
- name: '@deepseek-ai/dsh-stdio-demo'
config:
model: deepseek-v4-flash
适合谁
应用使用者
如果你只是想用一个现成的 Agent 应用（如编程助手、对话代理），你需要的全部操作就是：
- 复制一个 example 模板
- 填写 API key
- 运行
不需要写任何代码。详见 快速开始。
插件开发者
如果你想为 Agent 添加新能力——一个自定义 tool、一个新的 LLM 适配器、一个新的执行后端——你需要编写一个插件。Harness 提供了清晰的扩展接口和类型安全的开发体验。详见 开发。
核心特性
- 只需要配置 —
cordis.yml决定能力集合，换模型、加工具只需改一行 - 随时替换 (HMR) — 开发时修改插件代码，无需重启进程
技术栈
- 运行时: Node.js >= 24
- 语言: TypeScript (ESM)
- 框架: Cordis
- 包管理: pnpm workspaces