mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-06 17:27:31 +00:00
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:
@ -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 同步) | — |
|
||||
|
||||
|
||||
@ -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 二进制的发布锁定仍待发布流程完成,解析不到时显式警告 |
|
||||
|
||||
@ -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 仍明确未实现的设计项
|
||||
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
# HomeAgent 生产部署手册(homed / waiter)
|
||||
# HologramAgent 生产部署手册(homed / waiter)
|
||||
|
||||
> 适用范围:本机(`.60`)的 `homeagent.service`,以及两台设备桥宿主上的
|
||||
> `waiter-remote.service`。
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
# HomeAgent 遗留问题清单
|
||||
# HologramAgent 遗留问题清单
|
||||
|
||||
> **本文定位(2026-09-25 重写)**:只写**仍未完成、且经源码/实测核实确属本仓库**的问题。
|
||||
>
|
||||
|
||||
@ -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/` 与
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
**日期**:2026-10-04
|
||||
**分支**:`feat/context-overflow-l4`(未 push)
|
||||
**状态**:HomeAgent 已停机(inactive + disabled)
|
||||
**状态**:HologramAgent 已停机(inactive + disabled)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -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}/…
|
||||
检测类型 = 末位数字检测、本福特定律、…
|
||||
技能安装方式 = 本地安装
|
||||
|
||||
Reference in New Issue
Block a user