@wolffycode/dsh-engine-suite

Readme

# @wolffycode/dsh-engine-suite

一个安装包、一个统一 Harness Session/Workspace 和两个外部 Agent 引擎：GLM-only 的 Claude CLI 与 Codex CLI。插件不修改 `deepseek-harness` 源码，不复制 Harness 历史或 Workspace。

## 当前能力

- `claude-cli`：Claude SDK stream-json，GLM model policy，模型发现、文本/工具/权限/命令/历史/恢复；
- `codex-cli`：Codex app-server JSON-RPC，thread resume，model discovery，隔离 runtime；
- Engine → Provider → Model → Reasoning 选择与 EngineProfile；
- Session attach、空白 Session 引擎切换、native session/thread binding；
- Skill/MCP 显式资产、credentialRef、child Agent policy 和本地认证 delegation bridge；
- 不向 CLI 注入 Harness System Prompt、Tool Schema 或 Harness/cross-engine agent map；
- Provider key 不落盘、不输出；Claude 真实验证只允许 GLM，并拒绝 Opus。

Claude 源码在 `src/claude/`，通用桥在 `src/agent/`，Codex 源码在 `src/codex/`。不存在旧的 Claude `launch.ts` 或 `runtime.ts` 文件。

## 从 GitHub 安装

本插件不通过 npm 分发。使用固定的 GitHub Release tag 安装到目标 Profile：

```bash
dsh plugin --profile web add github:WolffyCode/deepseek-harness-plugin#v0.1.0
```

安装或更新 Profile Bundle 后需要重启对应的 DeepSeek Harness 进程。安装命令会把仓库声明的 `@wolffycode/dsh-engine-suite` Bundle 加入 Profile；不要使用浮动的 `main` 分支代替发布 tag。

## 源码开发与验证

本仓库是单包 pnpm workspace，`pnpm-workspace.yaml` 固定 `autoInstallPeers: false`，只允许 `esbuild` 执行安装脚本，`packageManager` 固定为 `pnpm@11.11.0`。`pnpm-lock.yaml` 与该设置一致，开发用 peer 依赖和 Typert generator 显式锁定在当前 Harness 发布线，因此安装、typecheck、build 和 test 不依赖父仓库 workspace 或 symlink。发布包直接提交生成后的 `lib` artifacts；Typert Remote 由发布的 generator 和仓库内的 protocol 编译 fixture 在临时 workspace 中生成。

```bash
pnpm install
npm run typecheck
npm test
npm run build
pnpm test
pnpm pack --dry-run
git diff --check
```

依赖安装、typecheck、build 和 test 不读取父目录 `deepseek-harness`。Typert 生成步骤使用发布的 `@deepseek-ai/dsh-typert-generator`，并在一次性临时 workspace 中使用仓库内的 protocol 编译 fixture；临时目录在成功或失败后都会删除。

## pnpm 404 根因

旧配置把 `@deepseek-ai/dsh-session` 的 peer 下限写成 `>=0.0.1-rc.1`。pnpm 因此会选择仍声明已删除 `@deepseek-ai/dsh-type-meta` 的旧 `dsh-session`，自动安装时向 npm 请求该不存在的包并得到 404。另一个问题是锁文件的 `autoInstallPeers: false` 没有被独立 workspace 配置声明，默认 pnpm 设置会造成 frozen lockfile mismatch。

现在 peer 下限统一为 `0.1.1-rc.2`，单包 workspace 显式关闭 peer 自动安装，开发依赖和锁文件都来自当前发布线；这修复根因，不通过改用 npm test、跳过安装或隐藏失败规避。

## 外部 smoke

真实 Claude E2E 要求配置的 Provider 同时提供 Anthropic Messages API 的 `GET /v1/models` 和 `POST /v1/messages`、认证环境变量、可执行的本地 `claude` CLI，以及 GLM model；不做 OpenAI 伪适配。Preflight 明确返回 `endpoint-mismatch`、`auth`、`network` 或 `protocol` 分类；只有缺少必需外部环境变量时真实 E2E 才显式 skip，Provider endpoint mismatch 不得 skip。

真实 Provider 的结果必须以本次运行的 preflight 为准；不能用历史响应或只通过 `GET /v1/models` 推断 Claude CLI 可用。只实现 `/v1/models` 或仅提供 OpenAI 路由不能通过 Claude CLI 验证。

```bash
DSH_CLAUDE_REAL_BASE_URI=... \
DSH_CLAUDE_REAL_AUTH_TOKEN=... \
DSH_CLAUDE_REAL_MODEL=glm-5.3 \
DSH_CLAUDE_REAL_EXECUTABLE=claude \
npm run test:claude-real
```

认证 token 只通过当前进程环境和内存传递；验证诊断会脱敏，token 不写入 runtime 文件，也不出现在测试或脚本输出中。真实验证模型必须是 GLM，任何 Opus model 都会在请求前拒绝。

真实 Codex Smoke 需要 endpoint、API key 和本地 `codex app-server`，key 只通过环境变量传入：

```bash
DSH_DEBUG_CODEX_BASE_URI=... \
DSH_DEBUG_CODEX_API_KEY="$CODEX_KEY" \
npm run verify:codex
```

截至 2026-08-29，本地无凭据门禁 `pnpm test` 为 **231 tests / 227 pass / 0 fail / 4 external skips**；`pnpm typecheck`、`pnpm build`、`pnpm pack --dry-run`、clean-temp package install/pack smoke 和 `git diff --check` 均通过。4 个 skip 都是显式外部 E2E：2 个需要真实 Claude Provider，2 个需要真实跨引擎 Provider；它们不计为 pass，带凭据的真实 Claude、MCP/Skill、跨引擎和浏览器 E2E 必须单独执行。