JianFeeeee e8d07cd8a0 docs(plan): dshplgadapter 规划书 —— 按外部插件形态重写 ...

## 方向

把 dsh（DeepSeek Harness）的 Cordis 插件生态接入 HologramAgent，
参考原型是刚迁出的 clawhubadapter（两者同构：兼容层 + sidecar + 转译注册）。

## 本文件在被推翻过一次，纠正记在正文里

初版结论是「必须做成内置插件」，依据是「外部插件发不了事件，所以
skill 移交只能靠概率」。该依据实测被推翻：

  · 外部插件自带 skill 由 pluginmgr 在安装/启动时移交，与插件发不发事件无关
  · clawhubadapter 已实际迁成外部插件并端到端跑通

所以 v2 改成外部插件，并把原因写进 §0 结论 2（保留纠错痕迹，
下次有人拿旧结论当依据时会看到为什么它不成立）。

## 内容的依据

全部来自实测，不凭记忆：

  dsh 0.2.1-rc.2 / cordis 4.0.5 / dsh-tools 的 defineTool 签名
  /opt/agentmail/plugins/dsh-mail-bridge/src/index.ts（2586 行生产代码，
  是 dsh 插件侧 API 最可靠的文档）
  third_party/hologramagentsdk 的 capability-boundary.md 与 proc_main.go.tmpl
  （外部插件实际拿到什么能力，全在那一个文件里）

## 最该先做的一件事

不是写代码，是探针 0.1：验证 fd 3 做协议通道。

理由：dsh 生态插件大量用 console.log，而子进程 stdout 是 JSON-RPC 通道。
本仓为这个坑付过代价（生产累计 1038 条「非法 JSON 帧」报错，定位真因
花了一整轮）。clawhubadapter 靠「模拟器把 logger 接到 stderr」躲过去，
但那只管模拟器内的调用，插件直接 process.stdout.write 仍会漏。
这条不解决就不该进阶段 1。

2026-11-04 15:24:00 +08:00

..

zh

docs(plan): dshplgadapter 规划书 —— 按外部插件形态重写

2026-11-04 15:24:00 +08:00

git-branching.md

feat(security): 插件按工具声明内容策略 + 目录名统一

2026-11-03 09:51:11 +08:00