refactor: 全面改名为 HologramAgent + 提示词技术内容下沉到 skill/工具描述 + 修 21 处乱码

## ① 全面改名 HomeAgent → HologramAgent 仓库已改名，但代码与文档里仍有大量旧名。本次按"用户能看到的优先"全量替换： - 用户可见：登录页标题/页脚、默认人格第一句、CLI 状态输出、启动日志、 plugin_install 的工具描述、AI 图片插件的 User-Agent - 文档与脚本：README、assets/docs、docs/zh、deploy/*.sh、.github/workflows - 鸿蒙工程：cmd/ohos/HomeAgent → cmd/ohos/HologramAgent（git mv）目录内的 module/app 描述同步；**证书路径原样保留** （default_HomeAgent_xxx.cer/p7b/p12 是签名材料的实际文件名，改了会找不到证书） - 插件元数据：plugin.json 的 author ★ 必须保持原样的两处（改了会坏）： · legacySeededPromptSignature = "你是 HomeAgent 的看板娘「小宅」…" —— 那是识别历史播种人格卡的**原文锚点**，改了就识别不出旧数据 · 公开 SDK 的 ProxyAuthHomeAgent = "homeagent" —— 那是 SDK 契约里的值，属独立仓库，本仓不改 ## ② 修 21 处乱码（U+FFFD）这些是历史编辑留下的编码破坏，全在注释里，例如：「赌注重下��遍」→「赌注重下一遍」「「不��滤」」 →「「不过滤」」「**待��退场**」→「**待退场**」 ★ 保留 providers/chineseclip/tokenizer.go 里的 2 处：那是**故意**用 U+FFFD 演示"非法 UTF-8 字节被归一成 U+FFFD"，不是乱码。 ## ③ 提示词技术内容下沉（用户：技术性内容应该收敛到 skill 与 -help 中）实测系统提示词 2309 字，其中两段几乎全是**模型无法据以行动的实现细节**：【工具执行顺序】1272 字（ParallelSafe 声明、批内降级、batchRunnable 判据…）【三层记忆】 1069 字（L1/L2/L3 编号、消费式删除、向量空间、指纹…）收敛后 **2309 → 1723 字（-25%）**，保留的全是"模型据此做什么不同的事"：工具顺序：默认并行 / 不要依赖先后 / 同通道保序 / 写类工具可能串行三层记忆：时序里能看最近 / doc_query 把历史事件按原始时间戳插回时序 / 关系用 memory_recall / 成文知识用 knowledge_search 判断口径写进判据：新加一段提示词前先问"模型会据此做什么不同的事"，答不上来就该进 skill 或工具描述。 ## 判据 prompt_memory_test.go 新增 2 条： - TestSystemPromptHasNoImplementationJargon 黑名单：ParallelSafe / batchRunnable / 消费式 / DenseCosine / fingerprint / 向量空间 / 批内降级 / 自激 - TestSystemPromptStaysCompact：上限 2000 字（当前 1723）变异：把 "ParallelSafe 声明、批内降级" 加回工具顺序段 ⇒ 第一条立刻红。 ## 验证 - go build ./... / go vet ./... 干净 - go test ./... -count=1：58 包 0 失败 - make check-client-versions：客户端与内核版本一致
2026-11-06 01:07:35 +00:00 · 2026-10-22 20:49:44 +08:00
parent 6bea130639
commit f256098c9f
204 changed files with 310 additions and 252 deletions
--- a/cmd/gui/DESIGN-NOTES.md
+++ b/cmd/gui/DESIGN-NOTES.md
@ -1,4 +1,4 @@
-# HomeAgent GUI 设计说明与外部借鉴
+# HologramAgent GUI 设计说明与外部借鉴

 本文件记录 GUI（`cmd/gui`）在设计过程中**明确借鉴的外部实现**，以及本仓自行做出的设计决策。

@ -12,11 +12,11 @@
 ### PiDeck（`C:\Users\21989\AppData\Local\Programs\PiDeck`）

 **PiDeck 是本机安装的一个第三方 Electron 应用**（其前端依赖
-`@deepseek-ai/dsh-web-frontend`）。HomeAgent GUI 在交互设计上参考了它的以下
+`@deepseek-ai/dsh-web-frontend`）。HologramAgent GUI 在交互设计上参考了它的以下
 做法。参考方式为**阅读其打包产物 `app.asar` 中的 CSS 实现**，理解其设计意图后
-在 HomeAgent 的样式体系中独立重写 —— 未复制其代码，也未使用其资源文件。
+在 HologramAgent 的样式体系中独立重写 —— 未复制其代码，也未使用其资源文件。

-| 借鉴项 | PiDeck 的实现 | HomeAgent 的落地 | 动机 |
+| 借鉴项 | PiDeck 的实现 | HologramAgent 的落地 | 动机 |
 |---|---|---|---|
 | **加载 / 思考动画** | `@keyframes _dsh-state-dot-chase`（三点透明度递减 `1 → .6 → .35 → .15`）与 `tool-activity-dot`（上浮 + 缩放） | `renderer/style.css` 的 `haDots` / `haDotFloat` | 旧实现是 `border + rotate` 的经典 spinner。旋转语义上暗示"在加载某个确定的东西"，而 agent 思考本身没有进度可转；且在 15px 的消息气泡里转圈糊成一团 |
 | **运行态呼吸光晕** | `.turn-row--running:before` —— 一层几乎看不见的 accent 底色（`color-mix(... 3%)`）以 `2.2s` 周期做 `opacity: 0 → 1 → 0` 呼吸 | `.msg-bubble.msg-running::before` | 单看气泡里的几个点，视线要缩到一小块；光晕铺在整条消息上，余光就能感知"agent 正在回" |
@ -24,20 +24,20 @@
 | **组合键处理** | ——（PiDeck 为 Web 应用，不涉及系统级输入注入） | —— | —— |

 **关于分组卡的规则差异**：PiDeck 的分组策略我们理解为"折叠成组"，
-HomeAgent 额外加了一条规则 —— **只有 1 个工具时保持单卡**（组卡没意义，
+HologramAgent 额外加了一条规则 —— **只有 1 个工具时保持单卡**（组卡没意义，
 反而多一层点击）。这是本地决策，不是 PiDeck 的做法。

 ---

 ## 本仓自行做出的设计（未借鉴）

-以下几项与 PiDeck 无关，是为 HomeAgent 自身场景做的决定：
+以下几项与 PiDeck 无关，是为 HologramAgent 自身场景做的决定：

 - **SSE 取代 EventSource**：需要自定义 `X-API-Key` 与 `Last-Event-ID` 请求头，
  浏览器原生 `EventSource` 不支持。
 - **增量聊天渲染**（`applyIncrementalChatRender`）：按 `data-msgkey` 复用 DOM
  节点。性能问题由本仓实测定位（旧实现 200 条消息单次全量重建 235ms）。
- **设备令牌注入**（`isDeviceTokenPath` / `deviceApiKey`）：HomeAgent 服务端
+- **设备令牌注入**（`isDeviceTokenPath` / `deviceApiKey`）：HologramAgent 服务端
  `/api/v1/device/` 命名空间下并存两套鉴权（`requireAPI` 认 cookie、
  `requireToken` 只认 `X-API-Key`），需要客户端主动带令牌。
 - **静默启动的"创建后隐藏"**：不创建窗口会导致渲染进程不启动（SSE、设备桥
--- a/cmd/gui/endpoint-align.test.mjs
+++ b/cmd/gui/endpoint-align.test.mjs
@ -166,7 +166,7 @@ check(
 // ── 5) 页面不得再引用公网 CDN ───────────────────────────────────────
 //
 // 与服务端 starmap_vendor_test.go 同一判据（那里钉 WebUI，这里钉 GUI）。
-// HomeAgent 支持离线/内网部署，而前端有 4 个硬依赖在公网上时，
+// HologramAgent 支持离线/内网部署，而前端有 4 个硬依赖在公网上时，
 // 断网/出口受限环境下星图必坏、且用户无从修复。

 const htmlSrc = readFileSync(join(here, "renderer", "index.html"), "utf8");
--- a/cmd/gui/main.js
+++ b/cmd/gui/main.js
@ -185,7 +185,7 @@ async function adoptSlSession(url) {
 }

 // 带 Electron cookie jar 的 fetch（跟随外部网关 302 → login 域 → 回跳，最多 6 跳），
-// 使 POST /api/v1/login 真正触达内层 HomeAgent 并取回 homeagent_session。
+// 使 POST /api/v1/login 真正触达内层 HologramAgent 并取回 homeagent_session。
 async function sessionFetch(initUrl, opts) {
  const { session } = require("electron");
  let url = initUrl;
@ -430,7 +430,7 @@ function createWindow(show = true) {
    height: 860,
    minWidth: 900,
    minHeight: 600,
-    title: "HomeAgent",
+    title: "HologramAgent",
    frame: false,
    show: false, // 一律先不显示，由 ready-to-show 决定
    icon: path.join(__dirname, "icon.ico"),
@ -806,7 +806,7 @@ ipcMain.handle("webui:openLogin", (_, { url, username, password }) => {
    parent: mainWindow,
    modal: true,
    autoHideMenuBar: true,
-    title: "HomeAgent - 网关联机登录",
+    title: "HologramAgent - 网关联机登录",
    webPreferences: { contextIsolation: true, nodeIntegration: false },
  });
  const u = encodeURIComponent(username || "");
@ -1456,7 +1456,7 @@ async function connectDeviceBridgeOnce(cfg) {
    op: "hello",
    device: {
      device_id: deviceBridgeId,
-      name: "HomeAgent GUI",
+      name: "HologramAgent GUI",
      kind: "computer",
      authorized: authorized,
      caps: [
@ -1986,8 +1986,8 @@ function executeHomeagentCmd(capability, reqId) {
      const h = Math.min(parseInt(area.height || 600, 10) - 40, 560);
      const html = /<\/?[a-z][\s\S]*>/i.test(raw)
        ? raw
-        : "<div style='font-family:sans-serif;display:flex;flex-direction:column;justify-content:center;align-items:center;height:100%;padding:24px;box-sizing:border-box'><h1 style='margin:0 0 16px;color:#ff7fac'>HomeAgent</h1><p style='font-size:16px;line-height:1.6;white-space:pre-wrap;word-break:break-all'>" +
-          String(raw || "HomeAgent 远程屏幕提示").replace(/</g, "&lt;") +
+        : "<div style='font-family:sans-serif;display:flex;flex-direction:column;justify-content:center;align-items:center;height:100%;padding:24px;box-sizing:border-box'><h1 style='margin:0 0 16px;color:#ff7fac'>HologramAgent</h1><p style='font-size:16px;line-height:1.6;white-space:pre-wrap;word-break:break-all'>" +
+          String(raw || "HologramAgent 远程屏幕提示").replace(/</g, "&lt;") +
          "</p></div>";
      try {
        if (screensueWin && !screensueWin.isDestroyed()) screensueWin.destroy();
@ -1999,7 +1999,7 @@ function executeHomeagentCmd(capability, reqId) {
          alwaysOnTop: true,
          frame: false,
          resizable: true,
-          title: "HomeAgent · screensue",
+          title: "HologramAgent · screensue",
          webPreferences: { nodeIntegration: false, contextIsolation: true },
        });
        screensueWin.setAlwaysOnTop(true, "screen-saver");
@ -3223,7 +3223,7 @@ async function setDeviceAuthorized(authorized) {
        op: "hello",
        device: {
          device_id: deviceBridgeId,
-          name: "HomeAgent GUI",
+          name: "HologramAgent GUI",
          kind: "computer",
          authorized: !!authorized,
          caps: [
@ -3291,7 +3291,7 @@ function buildTrayMenuTemplate() {
  const electron = require("electron");
  const TMenu = electron.Menu;
  const tpl = [];
-  tpl.push({ label: "HomeAgent", enabled: true });
+  tpl.push({ label: "HologramAgent", enabled: true });
  tpl.push({ type: "separator" });
  // 远程连接状态（缓存避免每次读文件）
  const connLabel = trayConnCache.connLabel || "未连接";
@ -3404,7 +3404,7 @@ function initTray() {
      img = nImg.createEmpty();
    }
    tray = new Tray(img);
-    tray.setToolTip("HomeAgent - 个人智能管家");
+    tray.setToolTip("HologramAgent - 个人智能管家");
    rebuildTrayMenu();
    tray.on("double-click", () => showMainWindow());
    console.log("[tray] READY: " + (tray ? "tray-created" : "null"));
@ -3525,7 +3525,7 @@ app.whenReady().then(async () => {
  // 「启动时不显示主窗口，驻留托盘后台运行」，但主进程从来没读过它 ——
  // whenReady 无条件 createWindow()，于是必然弹窗。
  //
-  // 实测（本机，prefs.silentStart=true）：窗口标题 HomeAgent 照样出现。
+  // 实测（本机，prefs.silentStart=true）：窗口标题 HologramAgent 照样出现。
  //
  // 与 applyAutoLaunch 里的 openAsHidden 是两回事：那个是告诉 OS「开机自启
  // 时如何启动」（仅 Windows/macOS 生效），这里是本进程自己决定要不要显示，
@ -3605,7 +3605,7 @@ let notifSeq = 0;
 ipcMain.handle("notify:show", (_, payload) => {
  try {
    const p = payload || {};
-    const title = String(p.title || "HomeAgent");
+    const title = String(p.title || "HologramAgent");
    const body = String(p.body || "");
    if (!body) return { ok: false, error: "empty body" };
    if (!Notification.isSupported()) return { ok: false, error: "unsupported" };
@ -3721,10 +3721,10 @@ function saveGuiPrefs(p) {
 }

 // Electron LoginItem 写入的注册表项名是「electron.app.<exe 名>」。
-// 产物改名过（HomeAgent.exe → homeagent-gui.exe）就会多出一条旧项，
+// 产物改名过（HologramAgent.exe → homeagent-gui.exe）就会多出一条旧项，
 // 且 setLoginItemSettings 不会清理它们 ⇒ 开机启动两次同一个 exe。
 // 实测本机 Run 键里确实同时存在：
-//   electron.app.HomeAgent     = "E:\program\homeagent\...\homeagent-gui.exe"
+//   electron.app.HologramAgent     = "E:\program\homeagent\...\homeagent-gui.exe"
 //   electron.app.homeagent-gui =  E:\program\homeagent\...\homeagent-gui.exe
 // 两条指向同一 exe，所以表面看是两个自启动，实际是同一份的重复。
 //
--- a/cmd/gui/package.json
+++ b/cmd/gui/package.json
@ -3,7 +3,7 @@
  "version": "1.4.0",
  "author": "JianFeeeee <jianfeeeee@homeagent.local>",
  "homepage": "https://github.com/JianFeeeee/HologramAgent",
-  "description": "HomeAgent Desktop GUI - Multi-connection management dashboard",
+  "description": "HologramAgent Desktop GUI - Multi-connection management dashboard",
  "main": "main.js",
  "scripts": {
    "start": "electron . --no-sandbox",
@ -25,7 +25,7 @@
  },
  "build": {
    "appId": "com.homeagent.gui",
-    "productName": "HomeAgent",
+    "productName": "HologramAgent",
    "linux": {
      "target": [
        "deb",
--- a/cmd/gui/renderer/app.js
+++ b/cmd/gui/renderer/app.js
@ -741,7 +741,7 @@ async function api(p, o) {

 // 从服务端发现设备网关地址（自动链接的权威来源）。
 //
-// 失败不报错：老版本 HomeAgent 没有这个端点，回退到本地推导即可
+// 失败不报错：老版本 HologramAgent 没有这个端点，回退到本地推导即可
 // （见 renderDeviceChannel 里的 state.discoveredGateway || 旧口径）。
 //
 // 优先 url_portal（门户同源形态）：GUI 主进程连 WS 走系统解析器，
@ -1083,7 +1083,7 @@ async function refreshAll() {
            // 服务端列表未含本机（可能离线），仍展示本地状态
            state.devices.push({
              device_id: dbinfo.deviceId,
-              name: "HomeAgent GUI",
+              name: "HologramAgent GUI",
              kind: "computer",
              authorized: dbinfo.authorized,
              online: false,
@ -1555,7 +1555,7 @@ function renderOverview() {
          b.commit && b.commit !== "unknown" ? String(b.commit).slice(0, 7) : "";
        return (
          "v" + escHtml(v) +
-          '<div class="stat-sub">' + escHtml(b.kernel_name || "HomeAgent") +
+          '<div class="stat-sub">' + escHtml(b.kernel_name || "HologramAgent") +
          (sha ? " · " + escHtml(sha) : "") + "</div>"
        );
      })(),
@ -1819,8 +1819,8 @@ function buildChatLayout() {
      "</h2>" +
      "<p>" +
      __(
-        "连接 HomeAgent 服务端后即可开始对话。请在设置中添加后端连接。",
-        "Connect to a HomeAgent server to start chatting. Add a backend connection in Settings.",
+        "连接 HologramAgent 服务端后即可开始对话。请在设置中添加后端连接。",
+        "Connect to a HologramAgent server to start chatting. Add a backend connection in Settings.",
      ) +
      "</p>" +
      '<button class="btn btn-primary" onclick="goSettingsConn()">' +
@ -1853,7 +1853,7 @@ function buildChatLayout() {
  if (state.messages.length === 0) {
    html +=
      '<div class="empty-state" style="flex:1;display:flex;align-items:center;justify-content:center"><p>' +
-      __("开始与您的 HomeAgent 聊天吧", "Start chatting with your HomeAgent") +
+      __("开始与您的 HologramAgent 聊天吧", "Start chatting with your HologramAgent") +
      "</p></div>";
  }
  html +=
@ -2229,7 +2229,7 @@ function renderChat() {
  if (msgs.length === 0) {
    html =
      '<div class="empty-state" style="flex:1;display:flex;align-items:center;justify-content:center"><p>' +
-      __("开始与您的 HomeAgent 聊天吧", "Start chatting with your HomeAgent") +
+      __("开始与您的 HologramAgent 聊天吧", "Start chatting with your HologramAgent") +
      "</p></div>";
  } else {
    msgs.forEach((m, i) => {
@ -5963,7 +5963,7 @@ function renderGuiPrefs() {
    sw(
      "autoLaunch",
      __("开机自启", "Auto launch on start"),
-      __("登录后自动启动 HomeAgent（静默）", "Start silently at login"),
+      __("登录后自动启动 HologramAgent（静默）", "Start silently at login"),
      "saveGuiPrefs('autoLaunch', this.checked)",
    ) +
    sw(
@ -6041,7 +6041,7 @@ function renderConnSection() {
    "</h3>" +
    "<label>" +
    __("名称", "Name") +
-    '</label><input id="conn-name" placeholder="My HomeAgent">' +
+    '</label><input id="conn-name" placeholder="My HologramAgent">' +
    "<label>" +
    __("连接类型", "Type") +
    '</label><select id="conn-type" onchange="toggleConnType()">' +
@ -6734,7 +6734,7 @@ async function connectFetchSSE(url) {
              String(p.content || "").slice(0, 40);
            notifyTurnOnce(
              _sig,
-              "HomeAgent",
+              "HologramAgent",
              String(p.content || "").slice(0, 160) || __("（空回复）", "(empty reply)"),
            );
            endChatTurn();
@ -7329,8 +7329,8 @@ function renderDevices() {
    html +=
      '<p style="color:var(--text-muted)">' +
      __(
-        "暂无设备接入。设备通过 WebSocket 连接到设备网关（默认经 HomeAgent 反代到 devices.<基域名>，或直连 127.0.0.1:9890/api/v1/device/ws），携带 token 后 hello 登记、bind 授权。",
-        "No devices yet. Devices connect via WebSocket (proxied by HomeAgent at devices.<base-domain>, or directly 127.0.0.1:9890/api/v1/device/ws), hello to register, bind to authorize.",
+        "暂无设备接入。设备通过 WebSocket 连接到设备网关（默认经 HologramAgent 反代到 devices.<基域名>，或直连 127.0.0.1:9890/api/v1/device/ws），携带 token 后 hello 登记、bind 授权。",
+        "No devices yet. Devices connect via WebSocket (proxied by HologramAgent at devices.<base-domain>, or directly 127.0.0.1:9890/api/v1/device/ws), hello to register, bind to authorize.",
      ) +
      "</p>";
  } else {
--- a/cmd/gui/renderer/index.html
+++ b/cmd/gui/renderer/index.html
@ -3,7 +3,7 @@
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>HomeAgent</title>
+    <title>HologramAgent</title>
    <link rel="icon" type="image/svg+xml" href="icon.svg" />
    <link rel="stylesheet" href="style.css" />
    <!--
@ -11,7 +11,7 @@

      为什么（与服务端 webui 插件同一条理由，见
      internal/plugins/webui/starmap_vendor_test.go 的注释）：
-      HomeAgent 明确支持离线/内网部署，而前端原本有 4 个硬依赖在公网上
+      HologramAgent 明确支持离线/内网部署，而前端原本有 4 个硬依赖在公网上
      （cdnjs/jsdelivr）。真实现象是「服务端 curl 同一批 URL 返回 200，
      但用户点星图看到『3D 星图不可用（CDN 加载失败）』」——不是服务端的问题，
      是客户端访问不到公共 CDN（内网/出口受限/断网）。
@ -108,7 +108,7 @@
    <div id="app">
      <!-- 左侧图标栏：主页=对话，其余为二级页面 -->
      <aside class="rail" id="rail">
-        <div class="rail-logo"><img src="icon.svg" alt="HomeAgent" /></div>
+        <div class="rail-logo"><img src="icon.svg" alt="HologramAgent" /></div>
        <button
          class="rail-btn active"
          id="rail-chat"
@ -318,7 +318,7 @@

      <div class="main">
        <div class="topbar">
-          <h1>HomeAgent</h1>
+          <h1>HologramAgent</h1>
          <span
            class="conn-indicator"
            id="conn-indicator"
--- a/cmd/gui/silent-start.test.mjs
+++ b/cmd/gui/silent-start.test.mjs
@ -6,7 +6,7 @@
 // 文案写着「启动时不显示主窗口，驻留托盘后台运行」，但主进程从来没读过它
 // —— whenReady 无条件 createWindow()，于是必然弹窗。
 //
-// 实测（本机，prefs.silentStart=true）：窗口标题 HomeAgent 照样出现。
+// 实测（本机，prefs.silentStart=true）：窗口标题 HologramAgent 照样出现。
 //
 // 本判据钉住三件事：
 //   1. whenReady 真的读 silentStart 并据此决定 show