chore: 根目录清理(第二轮)—— 移除过程文档、本机脚本、临时产物 (#3)

★ 上一轮清理被合并覆盖:GUI 分支含 DESKTOP-PET-NOTES.md /
SERVER-HANDOFF.md / GUI-PLAN.md,合并时取了我方版本,
但我方 main 已是 squash 产物 ⇒ 三个文件复活。
而我当时只核对了 benchmark.md 一个就宣布成功 —— 判断依据不足。

本轮逐个文件验证(不再抽样)。

删除(零代码引用)
  DESKTOP-PET-NOTES.md    外部产品(Coopanion)拆解笔记
  SERVER-HANDOFF.md       给服务端的待办清单,已过时
  napcat-design-dna.json  设计 DNA 数据
  tmp_jinabench.py        临时脚本
  tmp_benchmark/          临时跑分程序

归位(不是删)
  plan.md        → docs/zh/legacy-issues.md  (遗留问题清单,有价值)
  GUI-PLAN.md    → cmd/gui/GUI-PLAN.md      (含坐标换算/koffi 踩坑)
                   根目录那份与 cmd/gui/ 已有副本字节相同(285b84dd…),删前者
  deploy-plan.sh     → deploy/scripts/
  deploy-waiter.sh   → deploy/scripts/
  deploy-sdk-site.sh → deploy/scripts/

脱敏(deploy-plan.sh 与 deploy-sdk-site.sh 含本机路径)
  /home/newqqagent      → ${HA_DATA}
  /home/program/TrueAgent → ${REPO}
  /home/program         → ${HOME_DIR}

引用同步:27 处(docs/zh/deploy-runbook.md、toolcall-parallel-execution-plan.md、
scripts/capability-bench/PLAN.md、三个脚本自身的用法注释、ci.yml 注释)

根目录现状:仅 README.md / README_EN.md / LICENSE / Makefile /
go.mod / go.sum / .gitignore / .golangci.yml / .mailmap / .pi-lens.json

验证:go build ✅  三个 sh 的 bash -n ✅
     go test -short ./internal/... ./pkg/... ./cmd/... 全绿
     根目录文件清单逐个核对(10 项,全为门面/配置)

Co-authored-by: pi <pi@local>
This commit is contained in:
JianFeeeee
2026-10-05 11:44:04 +08:00
committed by GitHub
parent 2946391ba3
commit 7901651946
14 changed files with 164 additions and 1695 deletions

View File

@ -53,7 +53,7 @@ cmp -s /tmp/d1 /tmp/d2; echo $? # ⇒ 1(cmp 未被污染)
```
为什么这比“偶尔报错”危险得多:它让**部署判据变成假绿灯**。
2026-09-29 实测:`deploy-sdk-site.sh --check` 对着两份**确实不同**的
2026-09-29 实测:`deploy/scripts/deploy-sdk-site.sh --check` 对着两份**确实不同**的
`index.html`(本地 `f8898cfc…` / 线上 `cc615cfa…`)报「✓ 逐字节一致」,
于是永远判定「无需部署」——站点改完再也不会被更新,而且看不出来。
已在 `547d28d` 修掉(钉绝对路径 + 启动自检)。
@ -112,9 +112,9 @@ ls -l /tmp/homed-ort-new # 与 /usr/local/bin/homed
### 1.3 部署
```bash
bash deploy-plan.sh check # 只读
NEW_BIN=/tmp/homed-ort-new bash deploy-plan.sh deploy # 需输入 yes
bash deploy-plan.sh rollback # 回滚
bash deploy/scripts/deploy-plan.sh check # 只读
NEW_BIN=/tmp/homed-ort-new bash deploy/scripts/deploy-plan.sh deploy # 需输入 yes
bash deploy/scripts/deploy-plan.sh rollback # 回滚
```
- `check`:服务状态、onnxruntime 标签、`libonnxruntime.so`、模型资产、适配器清单
@ -235,10 +235,10 @@ md5sum ${HA_DATA}/adapters/*.lua | md5sum
### 2.2 更新
```bash
bash deploy-waiter.sh check # 两台一起,只读
bash deploy-waiter.sh deploy 192.168.2.106 # 需输入 yes
bash deploy-waiter.sh deploy 192.168.2.30 # 上一台验证通过后再做
bash deploy-waiter.sh rollback <ip>
bash deploy/scripts/deploy-waiter.sh check # 两台一起,只读
bash deploy/scripts/deploy-waiter.sh deploy 192.168.2.106 # 需输入 yes
bash deploy/scripts/deploy-waiter.sh deploy 192.168.2.30 # 上一台验证通过后再做
bash deploy/scripts/deploy-waiter.sh rollback <ip>
```
**逐台更新,不要并行** —— 两台都连同一网关,同时重启会同时断链。
@ -370,7 +370,7 @@ stage handler 入口自动加锁 + 锁不可重入所致,**插件侧问题**
## 5. 部署站点(SDK 文档站 / introduce)
`deploy-sdk-site.sh` 覆盖两个静态站,**与 homed / waiter 是独立部署单元**。
`deploy/scripts/deploy-sdk-site.sh` 覆盖两个静态站,**与 homed / waiter 是独立部署单元**。
| 站 | 本地源 | 线上位置 | 构建 |
| --- | --- | --- | --- |
@ -385,9 +385,9 @@ introduce 是**零构建**的 —— `site/` 里就是成品,脚本部署时**
### 5.1 用法
```bash
bash deploy-sdk-site.sh --check # 只核对差异,不动线上
bash deploy-sdk-site.sh # 构建 + 部署 + 验证
bash deploy-sdk-site.sh --rollback .sdk-bak-<时间戳> # 回滚
bash deploy/scripts/deploy-sdk-site.sh --check # 只核对差异,不动线上
bash deploy/scripts/deploy-sdk-site.sh # 构建 + 部署 + 验证
bash deploy/scripts/deploy-sdk-site.sh --rollback .sdk-bak-<时间戳> # 回滚
```
`--check` 逐字节比对本地与线上,两个站都一致时可直接跳过部署。
@ -441,7 +441,7 @@ cd third_party/homeagent-sdk
# 3) 重新生成(含 docs/api/* 与 llms.txt 同步)
tools/apidoc/build.sh
# 4) 部署并验证
bash ../../deploy-sdk-site.sh
bash deploy/scripts/deploy-sdk-site.sh
```
验证线上是否真的可访问(**别只看本地产物**):