mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-06 17:27:31 +00:00
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:客户端与内核版本一致
This commit is contained in:
@ -1,16 +1,16 @@
|
||||
---
|
||||
name: knowledge-base
|
||||
description: 按分类树检索 HomeAgent 知识库。当需要查阅项目知识、架构约定、历史决策,或用户提到"知识库/knowledge/知识库有哪些/这个项目的约定是什么"时使用。支持树形导航、分类内检索、以图搜知识。
|
||||
description: 按分类树检索 HologramAgent 知识库。当需要查阅项目知识、架构约定、历史决策,或用户提到"知识库/knowledge/知识库有哪些/这个项目的约定是什么"时使用。支持树形导航、分类内检索、以图搜知识。
|
||||
version: 1.1.0
|
||||
author: HomeAgent
|
||||
author: HologramAgent
|
||||
---
|
||||
|
||||
## Usage
|
||||
|
||||
先看树定位分类,再做定向检索。接口由 HomeAgent 的 `kbtree` 插件提供,
|
||||
先看树定位分类,再做定向检索。接口由 HologramAgent 的 `kbtree` 插件提供,
|
||||
只读、需 token。详见下方"接入"。
|
||||
|
||||
HomeAgent 知识库按**分类树**组织(`tech/go/并发`、`life/sleep` …)。
|
||||
HologramAgent 知识库按**分类树**组织(`tech/go/并发`、`life/sleep` …)。
|
||||
|
||||
### 何时用
|
||||
|
||||
@ -102,7 +102,7 @@ curl -s -H "$AUTH" "$BASE/search?q=goroutine&limit=5"
|
||||
若知识条目挂了图片,它在**多模态统一空间**里有向量,能被图片本身检索到。
|
||||
前提是宿主已接入多模态向量 provider(否则只是记录了媒体,不参与召回)。
|
||||
|
||||
判断是否就绪:HomeAgent 自身的知识库接口会返回稠密路状态
|
||||
判断是否就绪:HologramAgent 自身的知识库接口会返回稠密路状态
|
||||
(`dense.enabled` / `dense.ready` / `dense.total`)。若为未启用,
|
||||
**不要承诺"能以图搜"**。
|
||||
|
||||
@ -132,13 +132,13 @@ curl -s -H "$AUTH" "$BASE/search?q=goroutine&limit=5"
|
||||
- **分类不存在返回 404**,并在 `categories` 字段里附上现有分类 —— 用它自查
|
||||
拼写。
|
||||
- **`items=0` 只是不要正文**,`total_count` 仍准确,可用于判断规模。
|
||||
- **本服务只读**。写方法返回 405。要写知识请用 HomeAgent 主 agent 的
|
||||
- **本服务只读**。写方法返回 405。要写知识请用 HologramAgent 主 agent 的
|
||||
`knowledge_create`(或 WebUI 界面),不要试图绕过它直接写这个接口。
|
||||
- 知识名里不能有 `..`、空格(会被规范成 `_`)、点开头的段。
|
||||
|
||||
### 写入
|
||||
|
||||
本服务不提供写入。若你在 HomeAgent 主 agent 内部,写入用内核工具:
|
||||
本服务不提供写入。若你在 HologramAgent 主 agent 内部,写入用内核工具:
|
||||
|
||||
```
|
||||
knowledge_create name="tech/go/调度" content="正文..."
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
#!/usr/bin/env bash
|
||||
# kbtree 客户端:按分类树检索 HomeAgent 知识库。
|
||||
# kbtree 客户端:按分类树检索 HologramAgent 知识库。
|
||||
#
|
||||
# 由 knowledge-base skill 调用(agent 读 SKILL.md 后按需调本脚本)。
|
||||
# 也可人工使用:
|
||||
@ -88,7 +88,7 @@ if ! (exec 3<>"/dev/tcp/${HOSTPORT%%:*}/${HOSTPORT##*:}") 2>/dev/null; then
|
||||
cat >&2 <<EOF
|
||||
kbtree: 连不上 $BASE(端口未监听)。
|
||||
|
||||
最常见原因——**服务还没上线**。kbtree 是 HomeAgent 的内置插件,
|
||||
最常见原因——**服务还没上线**。kbtree 是 HologramAgent 的内置插件,
|
||||
需要二进制里含它才会启动。若 homed 是在合入该插件之前构建/部署的,
|
||||
就一直没有这个服务。上线后验证:
|
||||
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "knowledge-base",
|
||||
"description": "按分类树检索 HomeAgent 知识库:树形导航、分类内检索、以图搜知识",
|
||||
"description": "按分类树检索 HologramAgent 知识库:树形导航、分类内检索、以图搜知识",
|
||||
"version": "1.1.0",
|
||||
"author": "HomeAgent"
|
||||
"author": "HologramAgent"
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user