# DeepJIT [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 JIT 编译插件。 [English](README.md) | 中文 ## 概述 DeepJIT 持续采集 agent 执行 trace，挖掘反复出现的"热点"流程，用 LLM 编译为 可复用的 **skill**（markdown）或 **flow**（步骤模板），并自动回馈给运行中的 dsh，无需重启。适合经常重复相似多工具工作流、希望 dsh 把它们沉淀为可复用资产的人。 ``` trace ──► SQLite ──► 热点挖掘 ──► LLM 编译 ──► skill / flow ──► dsh ``` - 产物存放在 `~/.dsh/deepjit/`，自动热加载进 dsh。 - JIT 不编译自己的工具，避免自噬循环。 - 生命周期（编译器式）：AOT pass 对照实时工具注册表校验 flow 并常量折叠字面参数； 分层（tiering）把高频可靠的 skill 升级为 flow、对不可靠 flow 去优化；GC 剪枝过期产物。 ## 兼容性 | 项 | 值 | |---|---| | DSH 版本 | `@deepseek-ai/dsh` `0.1.1-rc.2`（运行级验证） | | DSH mainline | `cd5ef814`（2026-08-28 静态核对，所用 API 无变化） | | 验证 commit | `5869674`（2026-08-13） | | Node | `^22.19 \|\| >=24` | | 适用 profile | `headless`、`web` | dsh 处于预发布阶段，API 可能变化；依赖 pin 到 `@deepseek-ai/*` `0.1.0-rc.6`。 ## 安装 / 卸载 ```sh # 从 npm 安装（发布为 @fly3366/deepjit） dsh plugin --profile web add @fly3366/deepjit # 或 git 直装（无需 npm 发布） dsh plugin --profile web add github:fly3366/DeepJIT # 从某个 profile 移除 dsh plugin --profile web remove @fly3366/deepjit # 彻底删除本地数据 rm -rf ~/.dsh/deepjit ``` ## 快速开始 ```sh dsh plugin --profile headless add github:fly3366/DeepJIT DEEPSEEK_API_KEY=... dsh --profile headless "读取 package.json 和 tsconfig.json 并总结" # 重复类似任务，deepjit 会自动挖掘并编译热点流程 dsh --profile headless "用 deepjit_status 列出已编译产物" ``` ## 配置 在 `cordis.patch.yml` 或 profile patch 中覆盖。主要配置项（完整列表见 [`src/config.ts`](src/config.ts)）： | 配置 | 默认 | 说明 | |---|---|---| | `enabled` | `true` | 总开关 | | `summarizeIntervalMs` | `600000` | JIT 周期（挖掘+编译） | | `minRepeat` | `3` | 热点序列最少出现次数 | | `argumentAware` | `false` | 挖掘序列中加入排序后的参数键签名 | | `compileCandidates` | `1` | 每次编译生成 N 个候选取最优；越大质量越好、LLM 调用越多 | | `minFlowSteps` | `2` | 可编译流程的最少工具步数 | | `minPatternValue` | `6` | 触发编译的最小价值分（`count × steps`） | | `flushBatchSize` | `200` | 每批写入 SQLite 的 trace 行数 | | `maxPendingCalls` | `10000` | 内存 pending/raw 映射上限（约束内存） | | `minerMaxRows` | `20000` | 每会话每挖掘周期最多读取的 trace 行数 | | `transcriptMaxRows` | `2000` | 每次编译转录最多读取的工具行数 | | `gcEnabled` / `gcStaleMs` / `gcProtectMs` | `true` / 14天 / 1天 | GC：宽限期后禁用超过 `gcStaleMs` 未用的产物 | | `dryRun` | `false` | 产物以禁用态发布，需经 `deepjit_status` 手动启用 | | `traceRetentionMs` / `patternRetentionMs` | 7天 / 7天 | 剪枝超期的 trace 行 / 未编译 pattern | | `deoptMinUses` / `deoptMaxSuccessRate` | `5` / `0.5` | 使用≥N 次且成功率≤此值的 flow 被禁用（去优化） | | `qualityMinUses` / `minQuality` | `5` / `0` | 使用≥N 次且质量分 remove deepjit`，再 `rm -rf ~/.dsh/deepjit`。 ## 开发 ```sh npm install && npm test # node:test，Node 类型剥离原生运行 npm run typecheck && npm run build ``` 见 [CONTRIBUTING.md](CONTRIBUTING.md)、[AGENTS.md](AGENTS.md)。 ## 相关工作 "即时编译重复工作流"的思路与 best-of-N 编译选择借鉴自 [JIT-Agent — Scaling Harness Intelligence via Just-in-Time Harness Evolution](https://arxiv.org/abs/2608.25593) （[bingreeky/JIT](https://github.com/bingreeky/JIT)）。DeepJIT 将该 harness 演化概念 适配为在运行的 dsh 会话内在线编译重复工具流为 skill/flow，而非合成整个 harness。 ## 许可与安全 [MIT](LICENSE)。安全问题请按 [SECURITY.md](SECURITY.md) 私下报告。