Files
HomeAgent/docs
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
..