HomeAgent

jianf/HomeAgent

Fork 0

mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-11-06 09:17:31 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	82d08ebc45	docs(plan): 修正 dshplgadapter 规划书的仓库引用 + 补交接须知 ## 原稿的四类引用错误（交给别人会直接卡住） ① 说 clawhubadapter 在 internal/plugins/ —— 已迁出，那里没有了（a0077a2） ② 指向 /home/program/clawhubadapter-plugin/ —— 本机路径，别人打不开 ③ 指向 /opt/agentmail/plugins/dsh-mail-bridge/ —— 本机生产拷贝 ④ ★ 完全没提 deepseek-ai/deepseek-harness —— 漏掉唯一的 dsh 官方文档源第 ④ 条最严重：dsh / dsh-tools / cordis 三个包的 package.json 的 repository 字段全指向那个 monorepo（公开，master，2026-11-03 仍在更新），里面有 docs/cordis-tutorial/01..07 的七步中文教程、tool-execution-pipeline （tools/execute 异步链的权威说明）、cordis-primer、api/、cookbook/ —— 正是阶段 1-3 的直接依据，原稿一条都没有。 ## 现在的引用（逐个实测 HTTP 200） github.com/JianFeeeee/HologramAgent 内核仓 github.com/JianFeeeee/hologramagentsdk SDK 仓 github.com/JianFeeeee/clawhubadapter 参考插件（原型） github.com/deepseek-ai/deepseek-harness dsh 官方 github.com/QIKO0721/dsh-mail-bridge mail-bridge 公开镜像只剩两处本机路径，且都写了适用条件、标明不是阻塞项（dsh 的 ~/.dsh/profiles 固定布局；mail-bridge 的本机生产拷贝）。 ## 新增 §9 交接须知给没有本机环境、没有上下文的人： · 9.1 需要的 6 样东西 + 哪些阻塞（只有 mail-bridge 一项依赖特定机器） · 9.2 开工前的环境自检命令（含期望输出） · 9.3 三条别再踩的坑（go build 不成立 / NewPluginFactory / stdout 只能 JSON） · 9.5 一个前置决策：dsh 插件能跑任意 Node 代码 = 给本机执行权限，必须在阶段 1 前决定，不能"先跑通再说" · 9.6 已验证 vs 推测的诚实标注 9.6 是本轮最重要的补充。四条"推测"（裸 Context 承载插件、fd3 通道、 defineTool schema 无损转换、异步链不死锁）就是阶段 0 存在的理由 —— 不标出来，接手人会把推测当事实，直接跳到阶段 1。 ## 结构校验表格 0 处列数不一致；代码围栏 38 个（偶数，配对完整）；766 行。	2026-11-04 15:49:40 +08:00
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

Author

SHA1

Message

Date

JianFeeeee

82d08ebc45

docs(plan): 修正 dshplgadapter 规划书的仓库引用 + 补交接须知

## 原稿的四类引用错误（交给别人会直接卡住）

  ① 说 clawhubadapter 在 internal/plugins/ —— 已迁出，那里没有了（a0077a2）
  ② 指向 /home/program/clawhubadapter-plugin/ —— 本机路径，别人打不开
  ③ 指向 /opt/agentmail/plugins/dsh-mail-bridge/ —— 本机生产拷贝
  ④ ★ 完全没提 deepseek-ai/deepseek-harness —— 漏掉唯一的 dsh 官方文档源

第 ④ 条最严重：dsh / dsh-tools / cordis 三个包的 package.json 的
repository 字段全指向那个 monorepo（公开，master，2026-11-03 仍在更新），
里面有 docs/cordis-tutorial/01..07 的**七步中文教程**、tool-execution-pipeline
（tools/execute 异步链的权威说明）、cordis-primer、api/、cookbook/ ——
正是阶段 1-3 的直接依据，原稿一条都没有。

## 现在的引用（逐个实测 HTTP 200）

  github.com/JianFeeeee/HologramAgent          内核仓
  github.com/JianFeeeee/hologramagentsdk       SDK 仓
  github.com/JianFeeeee/clawhubadapter         参考插件（原型）
  github.com/deepseek-ai/deepseek-harness      dsh 官方
  github.com/QIKO0721/dsh-mail-bridge          mail-bridge 公开镜像

只剩两处本机路径，且都写了适用条件、标明不是阻塞项
（dsh 的 ~/.dsh/profiles 固定布局；mail-bridge 的本机生产拷贝）。

## 新增 §9 交接须知

给没有本机环境、没有上下文的人：

  · 9.1 需要的 6 样东西 + 哪些阻塞（只有 mail-bridge 一项依赖特定机器）
  · 9.2 开工前的环境自检命令（含期望输出）
  · 9.3 三条别再踩的坑（go build 不成立 / NewPluginFactory / stdout 只能 JSON）
  · 9.5 一个前置决策：dsh 插件能跑任意 Node 代码 = 给本机执行权限，
        必须在阶段 1 前决定，不能"先跑通再说"
  · 9.6 已验证 vs 推测的诚实标注

9.6 是本轮最重要的补充。四条"推测"（裸 Context 承载插件、fd3 通道、
defineTool schema 无损转换、异步链不死锁）就是阶段 0 存在的理由 ——
不标出来，接手人会把推测当事实，直接跳到阶段 1。

## 结构校验

表格 0 处列数不一致；代码围栏 38 个（偶数，配对完整）；766 行。

2026-11-04 15:49:40 +08:00

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

2 Commits