docs: 删除迁移期临时文档,现行内容搬进正式文档

用户指出迁移评估那批是**过程性临时文档**,迁移已完成就该退场。

## 删除(38 个文件)
- docs/zh/架构迁移评估.md(1621 行)—— 评估稿。开头的「❗现网正在发生的问题」
  (output_send 永远成功 / cgo 超时泄漏 26 次 / stage 污染)**全部已修复**,
  留着是误导性告警。其 §三「目标架构」已被 ARCHITECTURE.md 完整覆盖
  (且后者更细,含子进程生命周期管理)。
- docs/zh/plugin-interface-matrix.md(428 行)—— 迁移基线矩阵。
- docs/zh/experiments/(36 文件)—— 18 项可行性实验,验证的是"该不该迁移",
  迁移早已完成;实测无任何构建/测试依赖它。

## 现行内容先搬走(不能随临时文档一起丢)
- plugin-interface-matrix §九「接口扩展规则」→ 搬进 docs/git-branching.md 新增 §八
  (只增不减/签名不改、新增必须"插件调用内核实现"方向、hmapdev 模板必须同步接线
  否则全体插件编译失败、"接口纯追加"≠"无需重编"、合回 main 的同步清单)。
- git-branching §六 原写「接口冻结是合回门禁」—— 冻结是**迁移期**约束,v1.1.x 起
  已到期,改为标注失效并指向 §八。

## 引用清理
8 处引用全部改指现行文档:plan.md ×3、两篇设计文档各 ×1、
4 处源码注释(proc/shm.go、proc/process.go、dynamic_proc.go、entry_dispatch_test.go、
proc/bench_test.go)。仅 third_party(SDK 独立仓)保留 1 处,不动。

## 验证
- `go build ./...` 通过;`go test ./internal/plugin/...` 两个包全绿
- 本项目文档**断链 0**(另 2 处断链在 oh_modules 第三方依赖内)
This commit is contained in:
JianFeeeee
2026-09-19 19:22:48 +08:00
parent 4aed6c445a
commit d2733da0ba
47 changed files with 76 additions and 4094 deletions

14
plan.md
View File

@ -607,12 +607,12 @@ CLI 本机自执行命令已有 cmd 插件,不做反向操控 CLI。
## 11. 插件架构缺陷修复 + 子进程化迁移评估
> 完整评估文档:[`docs/zh/架构迁移评估.md`](docs/zh/架构迁移评估.md)
> —— **先读其第零章「给接手者的阅读指引」**,该文档是增量写成的,前六章部分结论已被后续推翻。
> 可复跑实验:[`docs/zh/experiments/plugin-arch/`](docs/zh/experiments/plugin-arch/)(18 项,`./run.sh`)
> 迁移**已于 v1.0.0 完成并上生产**。评估稿、可行性实验(18 项)与迁移基线矩阵
> 均为迁移期临时文档,已随迁移完成一并删除(见 git 历史)。
> 现状架构见 [`assets/docs/zh/ARCHITECTURE.md`](assets/docs/zh/ARCHITECTURE.md) 的「插件系统」;
> 当前运行态的事实以源码为准(`internal/plugin/`)。
>
> **本节 11.1~11.6 是修复项的唯一权威编号。** 评估文档中出现的 `0.x` / `A-F`
> 仅为历史分组,勿用于实施。本节只列可执行项与决策状态;论证与数据见评估文档。
> **本节 11.1~11.6 保留为历史工单**,各条勾选状态即当时的完成情况。
### 11.0-pre 三个易被误解的前提(动手前必读)
@ -933,8 +933,8 @@ context 累积导致的内存增长。
> 三项合入门禁**已全部通过**:`make test` 零失败、`go vet ./...` 无告警、
> `git diff main -- third_party/homeagent-sdk/sdk/` 为空(接口冻结不变量)。
>
> 迁移的执行记录(Part 0~6 过程稿)已随迁移完成而删除;论证与实验数据仍见
> `docs/zh/架构迁移评估.md`。
> 迁移的执行记录、评估稿与可行性实验均已随迁移完成而删除(见 git 历史);
> 现状以 `assets/docs/zh/ARCHITECTURE.md` 与源码为准。
### 12.1 ✅ 已完成:合并到 main + 发布分支(2026-09-03 ~ 09-06)