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/created → session_start 存量推送;turn/end →
session_mid 强信号建议;session/disposed → session_end 完整评估;suggest_now →
manual;每日定时 → 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-skills | sop 记忆 → 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— 实施总结、验证链路、踩坑记录、已知待办