Back to home

ConradLu2740

pa-dsh

ProactiveAgent × DeepSeek Harness 插件组:把主动记忆 + 主动建议接入 DSH(6 个 cordis 插件,引擎零重写)

Stars
1
Language
JavaScript
Created
Aug 13, 2026
Updated
Aug 14, 2026

Introduction

pa-dsh — ProactiveAgent × DeepSeek Harness 插件组

ProactiveAgent(主动记忆 + 主动建议系统) 做成 DeepSeek Harness(dsh)的 cordis 插件组。引擎零重写,全部复用 @proactive-agent/core,通过 cordis 服务注入。

架构

graph TB
    subgraph dsh[DeepSeek Harness 宿主]
        EV[会话事件流 session/event]
        TOOLS[工具注册 ctx.tools]
        PROMPT[系统提示词 systemPrompt]
        SKILLS[技能目录 ctx.skills]
        SESSIONS[会话 Store ctx.sessions]
    end

    CORE[dsh-proactive-core<br/>paCore 服务<br/>@proactive-agent/core 进程内单例]

    MEM[dsh-proactive-memory<br/>memory_capture / recall / stats<br/>+ persona 提示词段]
    SUG[dsh-proactive-suggest<br/>事件 → evaluateNow 五触发器<br/>+ suggest_now 工具]
    INJ[dsh-proactive-injector<br/>建议箱通知投递<br/>suggest_list / accept / dismiss]
    DAI[dsh-proactive-daily<br/>每日 09:30 定时评估<br/>daily_review 工具]
    SKI[dsh-proactive-skills<br/>sop 记忆 → pa-sop-N skills]

    CORE -. paCore 服务注入 .-> MEM
    CORE -. paCore 服务注入 .-> SUG
    CORE -. paCore 服务注入 .-> INJ
    CORE -. paCore 服务注入 .-> DAI
    CORE -. paCore 服务注入 .-> SKI

    EV -- session/created/turn/end/disposed --> SUG
    SUG -- pa/suggestion 事件 --> INJ
    INJ -- session.append 通知 --> SESSIONS
    MEM -- persona 段 --> PROMPT
    SUG -- suggest_now --> TOOLS
    INJ -- 建议箱工具 --> TOOLS
    DAI -- daily_review --> TOOLS
    SKI -- registerProvider --> SKILLS
    SUG -- 建议落库 --> CORE
    INJ -- accept/dismiss 反馈 --> CORE

事件流:dsh 会话事件(session/createdsession_start 存量推送;turn/endsession_mid 强信号建议;session/disposedsession_end 完整评估;suggest_nowmanual;每日定时 → timer)→ suggest 插件评估 → pa/suggestion 事件 → injector 投递建议箱通知 → 用户接受/忽略 → 反馈回流 core(状态、类型权重持久化)。

插件一览(已发布 npm,v0.1.0)

职责
@proactive-agent/dsh-proactive-core引擎单例宿主:唯一 import @proactive-agent/core,以 paCore 服务提供 memory/suggest
@proactive-agent/dsh-proactive-memory原生记忆工具(capture/recall/stats)+ 用户画像提示词段
@proactive-agent/dsh-proactive-suggest主动建议引擎:session 事件 → evaluateNow 五触发器
@proactive-agent/dsh-proactive-injector建议箱 + 反馈闭环(suggest_list/accept/dismiss)
@proactive-agent/dsh-proactive-daily每日 09:30 定时回顾 + daily_review 工具
@proactive-agent/dsh-proactive-skillssop 记忆 → dsh skills(pa-sop-N 动态目录)

安装到 dsh profile(官方 bundle 形态,推荐)

# 一条命令:自动安装 6 包 + 应用 cordis.patch.yml 层
dsh plugin --profile web add @proactive-agent/dsh

细粒度安装(高级,逐个启用)

cd ~/.dsh/profiles/web
pnpm add @proactive-agent/dsh-proactive-core @proactive-agent/dsh-proactive-memory @proactive-agent/dsh-proactive-suggest @proactive-agent/dsh-proactive-injector @proactive-agent/dsh-proactive-daily @proactive-agent/dsh-proactive-skills

~/.dsh/profiles/web/cordis.patch.yml 添加(pa-core 必须排最前,内容同 bundle 包的 cordis.patch.yml):

- insert:
    - id: pa-core
      name: '@proactive-agent/dsh-proactive-core'
      config: {}
    - id: pa-memory
      name: '@proactive-agent/dsh-proactive-memory'
      config: { personaOrder: 5 }
    - id: pa-suggest
      name: '@proactive-agent/dsh-proactive-suggest'
      config: {}
    - id: pa-injector
      name: '@proactive-agent/dsh-proactive-injector'
      config: { notifyOnSuggestion: true }
    - id: pa-daily
      name: '@proactive-agent/dsh-proactive-daily'
      config: { dailyAt: '09:30' }
    - id: pa-skills
      name: '@proactive-agent/dsh-proactive-skills'
      config: { maxSkills: 10 }

重启 dsh 即生效。记忆库默认 ~/.proma-proactive/(与 Claude Code 版 PA 共享)。

开发

pnpm install
node scripts/build.mjs          # esbuild 构建全部插件到 packages/*/lib/

发布到 npm(在你终端运行,2FA 为 WebAuthn)

bash scripts/publish.sh          # patch 版本(可 minor / major),含 bundle 聚合包

每个包发布时按 Enter 打开浏览器 → 指纹授权。随后升级 dsh profile:

cd ~/.dsh/profiles/web && pnpm add @proactive-agent/dsh-proactive-xxx@新版本

文档

  • PROPOSAL.md — 12 节完整方案(架构、触发器映射、分阶段实施)
  • IMPLEMENTATION.md — 实施总结、验证链路、踩坑记录、已知待办