0 Fork 0

Files

T

Chinesezjc b86c2f351c Merge remote-tracking branch 'origin/master' into codex/disable-telemetry-default

Resolve three conflicts:

- packages/bundle/base/tests/base.spec.ts: keep both assertion sets — this
  branch's telemetry-otel mode expression and master's subagent rows plus
  manifest dependencies.
- packages/session/session-telemetry-otel/tests/otel.spec.ts: keep master's
  per-mode sharing disclosure test, but select FULL explicitly instead of
  relying on an omitted mode, because the default is now DISABLED; the
  default-construction test keeps asserting disabled delivery and gains a
  case pinning that an omitted mode reports 'disabled' sharing.
- scripts/snapshots/translation-prompt-v4/request-response.expected.json:
  re-recorded from the merged READMEs rather than hand-merging the embedded
  document text.

2026-08-11 15:57:02 +08:00

4.1 KiB

Raw Blame History

DeepSeek Harness

English | 中文

DeepSeek Harness（dsh）是一款基于 DeepSeek Harness SDK 构建的开源 coding agent（智能体）。

它采用了一切皆插件的架构。

内测声明

DeepSeek Harness 正处于内部测试阶段，功能和接口可能发生变化。

Session Log 默认留在本地。设置 DSH_TELEMETRY_MODE=FEEDBACK_ONLY 可仅在提交反馈时共享 Session Log，设置 DSH_TELEMETRY_MODE=FULL 可持续上传；FULL 同时会启用 dsh-sdk 命令遥测，上报匿名 ID、命令结果以及脱敏后的项目配置。请通过内部企业微信群反馈问题和建议。

从源码运行

克隆本仓库，完成依赖安装和 API 密钥配置，然后运行：

pnpm dsh web

使用 DeepSeek Harness

Web UI

请从仓库根目录启动推荐的本地界面：

pnpm dsh web

该命令会先构建仓库，再启动 Web UI。Web UI 默认通过 http://127.0.0.1:3080 提供服务。

Profile

源码 CLI（命令行界面）会启动 profile：按序叠放的插件组合包 patch 层，之上再叠加你在 $DSH_HOME/profiles/<name> 中的自有覆盖层：

pnpm dsh --profile web                       # the browser UI
pnpm dsh plugin --profile tui add <package>  # install a plugin into a custom profile
pnpm dsh --profile tui                       # boot it

profile 布局、层语义与配置输出命令详见 CLI（命令行界面）参考。

Headless

运行一项任务，打印最终答案后退出：

pnpm dsh --profile headless "summarize this workspace"

自动化与 SDK

在源码检出中通过环境变量或根目录 .env 设置 DEEPSEEK_API_KEY，然后启动 ACP（Agent Client Protocol）自动化服务器：

pnpm run demo:acp

Python SDK 驱动随附的 JSON-RPC 运行时。示例涵盖可运行的 headless、ACP、JSON-RPC、Code Mode 和自指组合。

为什么选择 DeepSeek Harness

内置功能涵盖文件读取、编辑与搜索、shell 和持久 PTY 执行、可复用 skill（技能）、任务跟踪、目标、计划、待办事项与后台任务、subagent 与工作流、沙箱与审批、设置与凭据、可持久化、恢复、fork 与查询的会话、LSP 与 Web 访问、上下文压缩（context compaction），以及遥测。每个组合只选用适合其使用方式的能力子集。Web UI 包含 Plan Mode。

一切皆插件。 模型、工具、策略、存储、上下文管理和界面均为可组合的 Cordis 插件，部署方无需 fork agent loop（智能体循环）即可扩展或替换行为。底层设计见架构文档。
运行可重建。 凡是模型可见的内容，都会记录在权威会话流中；持久化、恢复／fork／查询、回放、遥测和 UI 均从同一组事件派生。参见会话日志架构。
Code Mode（需显式启用）。 它会提供 run_code 工具和生成的 TypeScript SDK，只有程序输出会重新进入模型上下文。参见 Code Mode。
自指 Cordis 工具需显式启用。 这些工具可让 agent 检查自身的实时运行时，并在运行中挂载或卸载插件。参见 Cordis 工具。

社区

扫描二维码，或打开 DeepSeek Harness 微信社区申请页面申请加入。

开发

请先阅读开发指南；修改包之前，请阅读架构文档。

面向 agent：遵循 AGENTS.md。

DeepSeek Harness 目前处于内测阶段。

许可证

BSD 3-Clause

第三方依赖及其许可证在 THIRD_PARTY_NOTICES.md 中披露。

4.1 KiB Raw Blame History Unescape Escape