dsh-turn-meta

English | 中文

DeepSeek Harness 的可选每步轮次元数据注入。agent 每一轮的每个进入步骤追加一条紧凑、带来源归属的头部：会话、当前 turn/step、本 turn 内真实用户消息数与工具结果数、此前完成的 turn 数。

[turn-meta] session=<id> turn=<turn> step=<step> user_msgs=<a> tool_results=<b> prior_turns=<p>

该包同时是最小化的"第一个插件"模板：以最小表面积展示所有 Harness 插件共用的接缝——具名导出函数插件（name / inject / Config / apply）、schemastery 配置校验、一个带 { prepend: true } 的 ctx.on('agent/pre-step', …) 钩子、以及拥有持久消息形状的 ./invariant 伴生插件。

装入 profile

插件按需启用。加入 cordis.patch.yml overlay（或以 --patch 传入）：

- insert:
    - id: turn-meta
      name: '@deepseek-ai/dsh-turn-meta'
      config:
        enabled: true
        minStep: 1

或独立使用：从已安装的 dsh profile 符号链接依赖后运行冒烟：

node tests/smoke.mjs

smoke.mjs 直接驱动真实 TypeScript 源码（Node ≥ 23 类型剥离）对已安装 dsh 发行版运行；需能从包目录 node_modules 解析 @deepseek-ai/{cordis,dsh-agent,dsh-llm,dsh-session,schemastery}。

验证状态

• 对已安装 dsh 发行版的运行时冒烟：6/6 断言通过（注入、头部文本精确、禁用配置、非法配置加载失败、销毁、proposed 计数）。
• monorepo CI 闸门（vitest 全套、覆盖率、typecheck、doc-sync）需要 deepseek-harness workspace 安装；预期通过但此处未运行。该包同样位于 harness 仓库的 packages/context/turn-meta，待官方开放外部贡献。

许可证

MIT