refactor(docs): 核心仓文档与介绍站展示名改名为 HologramAgent

只改仓库内文件的纯展示品牌名与已随批 2 落地的安装路径;运行时契约、仓库 URL、
域名、环境变量、可执行名、插件名一律不动。

一、纯展示名(HomeAgent → HologramAgent,共 44 处 / 18 个文件)
- README.md 4、README_EN.md 4(标题、client 变体说明、Windows 安装包名、AGPL 段)
- docs/ 8 个文件 14 处(git-branching 1、ci-cd-runbook 1、commondev-design 3、
  commondev-agent-runtime-design 4、deploy-runbook 1、legacy-issues 1、
  prod-migration-checklist 1、triple-extract-attention 2)
- assets/docs/ 6 个文件 14 处(zh/en 的 OVERVIEW 2+2、ARCHITECTURE 2+2、
  PLUGIN_DEV 3+3)
- assets/branding/mascot-xiaozhai-guide.md 2 处(身份行、标志名)
- site/index.html 6 处(title、meta description、og:title、logo alt、页头字、
  插件卡片文案 "HologramAgent 接入 AgentMail")

二、安装路径对齐批 2 产物(共 10 处)
- /usr/lib/homeagent → /usr/lib/hologram(7 处:README 2、README_EN 2、
  multimodal-space 3)
- /usr/share/doc/homeagent → /usr/share/doc/hologramagent(3 处:README 1、
  README_EN 1、multimodal-space 1;注意 Doc 路径带 agent 后缀)
- site/index.html 的 19 处 HomeAgent 里,13 处是 github.com/JianFeeeee/HomeAgent
  仓库 URL,属红线整串保留;只改 URL 之外的展示文案(其余 13 处零改动)

三、明确不改(红线 / 一致性冲突)
- site/index.html 的 23 个 github.com/JianFeeeee/homeagentsdk 外链(21 条
  example + 2 条纯仓库),SDK 仓改名属批 4-b,一个未动
- 核心仓仓库 URL、sdk./introduce.homeagent.jianfgit.xyz 域名、HOMEAGENT_ 前缀、
  homed/waiter/hmapdev、.hmap、homeagent-mail-bridge 等插件名、third_party/、
  internal/ 与 cmd/ 全部零改动
- ~/.homeagent 路径本批保持原样:cmd/waiter/main.go:109、daemon.go:290 硬编码
  仍为 .homeagent,全仓无 .hologram 命中;照规格改文档会指向程序不用的目录,
  需与代码侧那条线一起改(遗留项,已单独上报)

判据:文档区展示名残留归零(44 文件)、红线计数与 base e3584bb 逐项相同、
三条变异均被咬住且还原后复绿。
This commit is contained in:
JianFeeeee
2026-10-21 17:00:30 +08:00
parent 2b4b29a995
commit 931c803421
19 changed files with 54 additions and 54 deletions

View File

@ -8,7 +8,7 @@
| 仓 | 位置 | 流水线 | 触发 |
| --- | --- | --- | --- |
| 主仓 HomeAgent | `github.com/JianFeeeee/HomeAgent`(公开) | `ci.yml` + `release.yml` | push / PR、`release/**` push |
| 主仓 HologramAgent | `github.com/JianFeeeee/HomeAgent`(公开) | `ci.yml` + `release.yml` | push / PR、`release/**` push |
| SDK 仓 homeagentsdk | `github.com/JianFeeeee/homeagentsdk`(公开) | `release.yml` | `release/**` push |
| gitcode 镜像 | 同名仓库 | 无(由主仓 Release 的 sync job 同步) | — |

View File

@ -678,9 +678,9 @@ commondev_pi_plugin_update source?, scope # ✅ 已实现(PI_CODING_A
---
### 3.6 ★ LLM 源:默认用 HomeAgent 内部配置,支持添加与选默认
### 3.6 ★ LLM 源:默认用 HologramAgent 内部配置,支持添加与选默认
[已定 2026-10-13 用户拍板]插件内置 pi **默认使用 HomeAgent 内部配置的 llms 源**,
[已定 2026-10-13 用户拍板]插件内置 pi **默认使用 HologramAgent 内部配置的 llms 源**,
**支持添加其他源**,且**支持在插件中配置默认用哪个源**。
#### 3.6.1 源的真实位置 [已核]
@ -746,7 +746,7 @@ commondev_pi_source_add name, base_url, api_key, model, [adapter, context_w
commondev_pi_source_list [--with-key] # 列出来源(默认**不返回** key)
commondev_pi_source_remove name
commondev_pi_source_default name, [model] # 写 settings.json 的 defaultProvider/defaultModel
commondev_pi_source_import from_kernel # 把 HomeAgent 内部配置的源批量导入
commondev_pi_source_import from_kernel # 把 HologramAgent 内部配置的源批量导入
# —— 其他 pi 配置面(同一套纪律)——
commondev_pi_config_get key, scope=plugin|project, workdir?
@ -828,7 +828,7 @@ commondev_pi_mcp_add/remove/list # → mcp.json
| **U2** | 远端环境缺失时的**安装形态** | 默认只**输出可复制命令**供人去跑;由插件代装需显式授权(§3.4)。环境缺失时**先询问用户,不擅自安装** |
| **U3** | pi 进程**常驻保活** 还是**用完即弃**(靠 session-id 保连续) | ✅ **已定:常驻**(刀 1 已如此:sidecar 持续存活并复用同一会话,`branch_close` 才收) |
| **U4** | steer 的**语义降级**取舍 | (i) 接受降级,但把"断点"写进台账供主管复查 |
| **U5** | skill 的**分发目标** | 双投:主管侧(HomeAgent `<data_dir>/skills/`)+ 执行侧(工作区 `.pi/skills/`) |
| **U5** | skill 的**分发目标** | 双投:主管侧(HologramAgent `<data_dir>/skills/`)+ 执行侧(工作区 `.pi/skills/`) |
| **U6** | 「工程对话」的**用户可寻址名** | ✅ 已实现:sidecar 接收 `--session-name`,agent_up 返回并记账 `session_name` |
| **U7** | **独立 node/pi 的获取方式** | ✅ **已定:随包分发**(不首次下载、不依赖用户装) |
| **U8** | 内层 pi 的**版本锁定** | 部分实现:`pi_version` 已从 sidecar 回显并记账;随包独立 pi 二进制的发布锁定仍待发布流程完成,解析不到时显式警告 |

View File

@ -55,7 +55,7 @@
| 角色 | 是谁 | 职责 |
|---|---|---|
| **人(用户)** | 老板 | 只与「开发主管」对接,不直接指挥执行 agent |
| **开发主管** | 长期驻留的 HomeAgent 主 agent | 拆任务、**定义判据**、复审、决定合入 |
| **开发主管** | 长期驻留的 HologramAgent 主 agent | 拆任务、**定义判据**、复审、决定合入 |
| **执行 agent** | 按任务拉起的编码 agent(pi / dsh) | 在某棵工作树里干活 |
| **commondev 插件** | 新增 Go 插件 | 仓库/凭据/分支/PR/测试执行,全部机械化操作 |
@ -255,7 +255,7 @@ commondev_agent_down 收尾(幂等全清,不留孤儿)
commondev_pi_plugin_install ★ 为内置 pi 装插件(scope=project 临时 / plugin 全局)
commondev_pi_plugin_remove 卸载(同 scope 语义)
commondev_pi_plugin_list 列出已装(分 scope)
commondev_pi_source_import ★ 把 HomeAgent 内部配置的 LLM 源导入内置 pi
commondev_pi_source_import ★ 把 HologramAgent 内部配置的 LLM 源导入内置 pi
commondev_pi_source_add 添加一个源(直接写 pi 的 models.json/auth.json)
commondev_pi_source_list 列出可用源(默认**不返回** api_key)
commondev_pi_source_default ★ 指定内置 pi 默认用哪个源(写 settings.json)
@ -1078,7 +1078,7 @@ HA_E2E_LLM=1 HA_E2E_API_KEY="$K" HA_E2E_REAL_DB=/home/newqqagent/config.db \
- `commondev_test_run` / `commondev_test_mutate`:早期清单的两个单阶段入口已保留;`commondev_review_submit` 是两阶段一键入口。
- `commondev_pi_plugin_*` 与细化稿的 `commondev_pi_package_*`:两套命名均注册为兼容别名;底层调用同一套 `pi install/remove/list/update`。
- `commondev_project_open`:续篇早期别名已补,底层复用 `project_add`。
- skill 双投不是运行时插件行为:主管侧 skill 由 HomeAgent 发布,执行侧 skill 由工作目录/发布包注入;插件不擅自把代码写进用户全局目录。
- skill 双投不是运行时插件行为:主管侧 skill 由 HologramAgent 发布,执行侧 skill 由工作目录/发布包注入;插件不擅自把代码写进用户全局目录。
### 14.3 仍明确未实现的设计项

View File

@ -1,4 +1,4 @@
# HomeAgent 生产部署手册(homed / waiter)
# HologramAgent 生产部署手册(homed / waiter)
> 适用范围:本机(`.60`)的 `homeagent.service`,以及两台设备桥宿主上的
> `waiter-remote.service`。

View File

@ -1,4 +1,4 @@
# HomeAgent 遗留问题清单
# HologramAgent 遗留问题清单
> **本文定位(2026-09-25 重写)**:只写**仍未完成、且经源码/实测核实确属本仓库**的问题。
>

View File

@ -168,16 +168,16 @@ core.memory.multimodal_space.options.model_dir = ${HA_DATA}/models/chinese-clip-
| 内容 | 包内路径 |
|---|---|
| Chinese-CLIP 产物(754MB) | `/usr/lib/homeagent/models/chinese-clip-vit-b16-onnx/` |
| ONNX Runtime(24MB) | `/usr/lib/homeagent/onnxruntime/libonnxruntime.so` |
| 许可证 | `/usr/share/doc/homeagent/licenses/`(Apache-2.0、MIT、ThirdPartyNotices、模型来源) |
| Chinese-CLIP 产物(754MB) | `/usr/lib/hologram/models/chinese-clip-vit-b16-onnx/` |
| ONNX Runtime(24MB) | `/usr/lib/hologram/onnxruntime/libonnxruntime.so` |
| 许可证 | `/usr/share/doc/hologramagent/licenses/`(Apache-2.0、MIT、ThirdPartyNotices、模型来源) |
- `deploy/packaging/package-linux.sh` 的 `stage_multimodal_assets()` 在打 server/full 前
会校验产物 `SHA256SUMS`、逐文件非空、运行库架构与目标一致;**缺一即失败**,
不生成「默认启用但装完不能用」的假包。`client` 包不含(它不跑 homed)。
- 安装时 `setup.sh` 把包内模型目录软链到 `<dataDir>/models/chinese-clip-vit-b16-onnx`
(既不复制 754MB,也保持 dataDir 可迁移;已存在的自定义目录绝不覆盖)。
- 服务单元设 `Environment=ONNXRUNTIME_DIR=/usr/lib/homeagent/onnxruntime`;
- 服务单元设 `Environment=ONNXRUNTIME_DIR=/usr/lib/hologram/onnxruntime`;
provider 的查找顺序是 `ONNXRUNTIME_DIR` → `ONNX_ML_DIR` → 包内路径 →
`/opt/onnxruntime` → `/usr/local/lib` → `/usr/lib`。
- 构建机需自备产物:`build/model-assets/chinese-clip-vit-b16-onnx/` 与

View File

@ -2,7 +2,7 @@
**日期**:2026-10-04
**分支**:`feat/context-overflow-l4`(未 push)
**状态**:HomeAgent 已停机(inactive + disabled)
**状态**:HologramAgent 已停机(inactive + disabled)
---

View File

@ -677,7 +677,7 @@ ha-c(运维域) 67 条 维度名 10 种 179 字段 只1次 4 (36%)
| 能跨域泛化? | **否**(域外零字段) |
| 实际可用性 | **运维域内可用;通用域不可用** |
而 HomeAgent 是**通用 Agent** —— 生产库里 72% 是不属于任何单一"域"的叙述句。
而 HologramAgent 是**通用 Agent** —— 生产库里 72% 是不属于任何单一"域"的叙述句。
所以「按域训模型」这条路对它**不成立**:域划分不出来,
而混域会互相撕裂(0.918 → 0.637)。
@ -717,7 +717,7 @@ ha-c(运维域) 67 条 维度名 10 种 179 字段 只1次 4 (36%)
这些是只有语义能区分的:
```
插件名称 = 从零开发 HomeAgent QQ 插件
插件名称 = 从零开发 HologramAgent QQ 插件
脚本路径 = ${REPO}/…
检测类型 = 末位数字检测、本福特定律、…
技能安装方式 = 本地安装