DeepSeek Harness 插件打包：从本地项目到可交付包

dsh-b6-packaging/
├── dsh-hello-tool/
│   ├── package.json       # 官方不变式形状（scope 换成 @rex-local）
│   ├── tsconfig.json      # 镜像官方项目布局
│   └── src/index.ts       # name/inject/Config/apply named-export 插件
├── verify-manifest.ts     # constraints-lite：复刻 cookbook 不变式检查
├── load-composition.ts    # 真实 Loader + Include + cordis.yml 组合
└── cordis.yml             # 一行入口：按包名装载 dsh-hello-tool

node --import tsx E:/coding/rex-hugo/.tmp-research/dsh-b6-packaging/verify-manifest.ts
node --import tsx E:/coding/rex-hugo/.tmp-research/dsh-b6-packaging/load-composition.ts

import { Context } from '@deepseek-ai/cordis'
import { defineTool } from '@deepseek-ai/dsh-tools'
import z from '@deepseek-ai/schemastery'

export const name = 'hello-tool'
export const inject = ['tools']

export interface Config {
  /** Prefix for every generated greeting. */
  greeting: string
}

export const Config: z<Config> = z.object({
  greeting: z.string().required(),
})

export function apply(ctx: Context, config: Config): void {
  ctx.tools.register(defineTool({
    name: 'hello',
    description: `Return "${config.greeting}, <name>!".`,
    parameters: {
      name: { type: 'string', required: true, description: 'Name to greet' },
    },
    output: {
      schema: { type: 'string' },
      render: (_args, value) => [{ type: 'text', text: value }],
    },
    async execute(args) {
      return `${config.greeting}, ${args.name}!`
    },
  }))
}

export const name = 'tool-todo'
export const inject = ['tools']
...
export const Config: z<Config> = z.object({...})
...
export function apply(ctx: Context, config: Config): void {

Named exports preserve loader injection metadata.

PASS  private: true
PASS  type: module
PASS  main: lib/index.js
PASS  types: lib/types/index.d.ts
PASS  exports["."].types
PASS  exports["."].default
PASS  files contains lib/index.js
PASS  files contains lib/types d.ts
PASS  every peer mirrored in devDependencies
PASS  @deepseek-ai/cordis is peer + dev
PASS  every dsh peer mirrored in devDependencies
PASS  name is scoped lowercase
PASS  no src in files
MANIFEST_CONSTRAINTS_LITE=ALL_PASS

await ctx.plugin(Loader)
  ctx.loader.builtins.include = Include
  const modules = new Map<string, unknown>([
    ['@rex-local/dsh-hello-tool', HelloTool],
  ])
  ctx.loader.internal = {
    version: 'v2',
    async import(specifier: string) {
      if (!modules.has(specifier)) throw new Error(`unexpected Loader import: ${specifier}`)
      return modules.get(specifier)
    },
  } as unknown as NonNullable<typeof ctx.loader.internal>

  const configPath = join(import.meta.dirname, 'cordis.yml')
  await ctx.loader.create({
    name: 'cordis:include',
    config: { path: pathToFileURL(configPath).href },
  })
  await ctx.loader.await()

=== loader composition ===
  loadedEntries=["@rex-local/dsh-hello-tool"]
  toolSchemas=[{"name":"hello","description":"Return \"Aloha, <name>!\".","parameters":{"type":"object","properties":{"name":{"type":"string","description":"Name to greet"}},"required":["name"]}}]
  helloRegistered=true
  execute={"isError":false,"value":"Aloha, Rex!","content":[{"type":"text","text":"Aloha, Rex!"}]}
LOADER_COMPOSITION=PASS

{
  "name": "@deepseek-ai/dsh-tool-todo",
  "type": "module",
  "main": "lib/index.js",
  "types": "lib/types/index.d.ts",
  "exports": {
    ".": {
      "types": "./lib/types/index.d.ts",
      "default": "./lib/index.js"
    }
  },
  "files": ["lib/index.js", "lib/invariant.js", "lib/types/**/*.js", "lib/types/**/*.d.ts"],
  "peerDependencies": {
    "@deepseek-ai/dsh-tools": "workspace:^",
    "@deepseek-ai/cordis": "workspace:^"
  },
  "devDependencies": {
    "@deepseek-ai/dsh-tools": "workspace:^",
    "@deepseek-ai/cordis": "workspace:^"
  }
}

{
  "extends": "../../../tsconfig.base.json",
  "compilerOptions": {
    "rootDir": "src",
    "outDir": "lib/types"
  },
  "include": ["src"],
  "references": [
    { "path": "../../../vendor/cosmokit" },
    { "path": "../../../vendor/cordis" },
    { "path": "../../core/tools" }
  ]
}

- insert:
    - id: llm
      name: '@deepseek-ai/dsh-llm'
    - id: sandbox
      name: '@deepseek-ai/dsh-sandbox-local'

A patch replaces the targeted row's whole `config` rather than merging into
it, so a row whose value differs by mode does NOT live here ...
Row order carries no load semantics (activation is service-availability
driven); the grouping is for readers.

pnpm install        # registers the workspace
pnpm run doc-sync
pnpm run constraints && pnpm run typecheck && pnpm run lint
pnpm run build && pnpm run hygiene