pa-dsh
已验证 · 实测可装 ConradLu2740
功能简介
ProactiveAgent插件组:主动记忆+建议接入DSH,6个插件,引擎零重写
可用 — 实测通过,早期项目
ProactiveAgent插件组:主动记忆+建议接入DSH,6个插件,引擎零重写 实测能干净安装、正常启动。早期项目,但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
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— 实施总结、验证链路、踩坑记录、已知待办
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 pa-dsh」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:ConradLu2740/pa-dsh Headless(CLI)profile:
dsh plugin --profile headless add github:ConradLu2740/pa-dsh 实测报告
验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。
使用场景
给 agent 一套记忆、知识库或检索层,让它不再跨会话丢上下文。
适合谁
跑长项目、想让 agent 记住决策、文档和偏好而不用每次重讲的人。
二次开发建议
记忆/检索后端是缝——插新存储、调蒸馏策略,或加引用与审计轨迹。