DeepSeek Harness: 依赖驱动加载与自动重载

function buildDependencyGraph(plugins: Plugin[]) {
  const graph = new DAG()
  for (const plugin of plugins) {
    graph.addNode(plugin.name)
    for (const dep of plugin.inject) {
      graph.addEdge(dep, plugin.name)
    }
  }
  return graph
}

插件声明:
  core:    inject = []
  tools:   inject = ['core']
  llm:     inject = ['core']
  my-tool: inject = ['tools', 'llm']

依赖图:
  core → tools → my-tool
  core → llm   → my-tool

拓扑排序结果: [core, tools, llm, my-tool]

// 插件 A: inject = ['tools'] — tools 尚未注册
// → Fiber state: pending

// 稍后，tools 插件加载并注册服务
// → 插件 A 的 Fiber 自动转为 active，调用 apply

export function apply(ctx: Context) {
  if (someCondition) {
    ctx.provide('optional-service', impl)
    // 此时依赖 optional-service 的 pending 插件会自动激活
  }
}

[warn] plugin my-plugin has unsatisfied dependency: nonexistent-service
[warn] my-plugin will remain in pending state

pnpm dsh web --patch --watch

tools 插件 HMR 重载 → 依赖 tools 的 my-tool 也重载

core 重载 → tools 重载 → my-tool 重载 → ... (整条依赖链重载)

export function apply(ctx: Context) {
  const childCtx = ctx.extend({
    // 覆盖或新增服务
  })
  
  childCtx.plugin({
    name: 'child-plugin',
    apply(innerCtx) {
      // innerCtx 继承 ctx 的服务
    }
  })
}

父 ctx: { tools, llm, sessions }
子 ctx: { tools(覆盖), cache(新增) }

子 ctx 可见: { tools(覆盖版), llm, sessions, cache }

// ❌ 过深嵌套
ctx.extend().extend().extend().extend()

// ✅ 适度嵌套
const sessionCtx = ctx.extend({ session })

export function apply(ctx: Context) {
  ctx.on('config/updated', (newConfig) => {
    if (newConfig.debug !== ctx.config.debug) {
      ctx.logger.level = newConfig.debug ? 'debug' : 'info'
    }
  })
}

plugins:
  my-plugin:
    config:
      debug: true  # 用户通过 Web UI 修改，自动持久化

// ✅ 幂等：每次 apply 都注册同样的工具
export function apply(ctx: Context) {
  ctx.tools.register(fileCountTool)
}

// ❌ 非幂等：apply 会累积副作用
let counter = 0
export function apply(ctx: Context) {
  counter++  // 重载后 counter 会递增
}

// ❌ 全局状态：HMR 重载后旧状态残留
const globalCache = new Map()

// ✅ 闭包状态：每次 apply 创建新状态
export function apply(ctx: Context) {
  const cache = new Map()
  ctx.effect(() => () => cache.clear())
}

export function apply(ctx: Context) {
  const ws = new WebSocket('ws://localhost:8080')
  
  // ✅ 注册清理
  ctx.effect(() => () => ws.close())
  
  // ❌ 忘记清理 → 重载后旧连接泄漏
}

# 1. 启动带 HMR 的开发模式
pnpm dsh web --patch --watch

# 2. 正常编写代码，保存后自动重载
# 终端输出:
# [hmr] file changed: src/index.ts
# [hmr] disposing my-plugin (old)
# [hmr] loading my-plugin (new)
# [my-plugin] plugin reloaded

# 3. 检查重载日志，确认无清理错误

// 在 apply 开头加调试日志
export function apply(ctx: Context) {
  ctx.logger.info('apply called at', new Date().toISOString())
  // ...
}
// 如果看到 apply 被意外调用多次，说明 HMR 级联重载