HomeAgent

jianf/HomeAgent

Fork 0

mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-09-27 21:03:16 +00:00

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	78806efa0f	fix(kbtree): 修客户端脚本三处实测暴露的缺陷都是本机装好后逐条跑命令发现的，不是设想： 1. token 找不到：脚本找 `scripts/../config.json`，而实际文件在 `<skill>/config/config.json`。症状极具迷惑性——「明明配了 token 却说没找到」。改为两种布局都试，并在注释里写明为什么不能只写一种。 2. `-h` 也要 token：帮助段排在 token 检查之后，`kb_tree.sh -h` 会被拦下报「未找到访问令牌」。把 help 提到最前。 3. `-q` 被当成命令名：`kb_tree.sh -q 并发`（不给子命令）报「未知命令: -q」，而这是很自然的写法。改为：第一个参数是选项时不取作子命令，解析完选项后再定——有 -q 走 search，没有走 tree。另外把 curl -f 换成 -w + 自行判状态码：-f 在 4xx 时只吐一行 `curl: (22) 404`，把响应体丢掉，而 404 响应体里恰是「现有分类」清单，是排查时最需要的。现在 401/404 都会给出可行动的中文提示，退出码 0/2/3/4/5/7/8 各有语义。	2026-09-26 14:47:32 +08:00
JianFeeeee	5a889007d7	docs(kbtree): 补客户端封装脚本 + 本机部署交接说明 SKILL.md 里原本只有 curl 示例，agent 用起来要自己拼 URL 与鉴权头。补 scripts/kb_tree.sh（照 dify-ops 的做法把脚本随 skill 分发）： - 子命令 tree/categories/counts/search，选项 -q/-c/-d/-i/-l - token 读取顺序：KB_TOKEN 环境变量 → config/config.json。故意不接受命令行传 token（会进 shell 历史与 ps 输出） - 预检端口：不通时直接说明「服务未上线」并给出上线步骤，而不是抛 curl: (7) Connection refused 让用户自己猜 - 错误翻译成人话：401 → 令牌无效；404 → 附上服务端返回的现有分类（用 curl -w 而非 -f，否则 404 响应体里最有用的那份清单会被丢掉） - 退出码：0 成功 / 2 参数 / 3 令牌 / 4 分类不存在 / 5 HTTP / 7 连不上 / 8 请求失败 DEPLOY.md 是给部署方的交接单：本机 kbtree 代码已合入 main 且 skill/token 已就位，但运行中的二进制里没有 kbtree（14:35 有人换过一版二进制），故替换与重启留给部署方。含备份/替换/验证步骤、回滚方式、端口与 token 说明。 token 与 config.json 不入库（config/ 目录留空），安装时由部署方从配置库 config_kbtree 表读取后写入本机。	2026-09-26 14:43:46 +08:00

Author

SHA1

Message

Date

JianFeeeee

78806efa0f

fix(kbtree): 修客户端脚本三处实测暴露的缺陷

都是本机装好后逐条跑命令发现的，不是设想：

1. **token 找不到**：脚本找 `scripts/../config.json`，而实际文件在
   `<skill>/config/config.json`。症状极具迷惑性——「明明配了 token 却说
   没找到」。改为两种布局都试，并在注释里写明为什么不能只写一种。
2. **`-h` 也要 token**：帮助段排在 token 检查之后，`kb_tree.sh -h` 会被
   拦下报「未找到访问令牌」。把 help 提到最前。
3. **`-q` 被当成命令名**：`kb_tree.sh -q 并发`（不给子命令）报
   「未知命令: -q」，而这是很自然的写法。改为：第一个参数是选项时不取作
   子命令，解析完选项后再定——有 -q 走 search，没有走 tree。

另外把 curl -f 换成 -w + 自行判状态码：-f 在 4xx 时只吐一行
`curl: (22) 404`，把响应体丢掉，而 404 响应体里恰是「现有分类」清单，
是排查时最需要的。现在 401/404 都会给出可行动的中文提示，
退出码 0/2/3/4/5/7/8 各有语义。

2026-09-26 14:47:32 +08:00

JianFeeeee

5a889007d7

docs(kbtree): 补客户端封装脚本 + 本机部署交接说明

SKILL.md 里原本只有 curl 示例，agent 用起来要自己拼 URL 与鉴权头。
补 scripts/kb_tree.sh（照 dify-ops 的做法把脚本随 skill 分发）：

- 子命令 tree/categories/counts/search，选项 -q/-c/-d/-i/-l
- token 读取顺序：KB_TOKEN 环境变量 → config/config.json。
  **故意不接受命令行传 token**（会进 shell 历史与 ps 输出）
- 预检端口：不通时直接说明「服务未上线」并给出上线步骤，
  而不是抛 curl: (7) Connection refused 让用户自己猜
- 错误翻译成人话：401 → 令牌无效；404 → 附上服务端返回的现有分类
  （用 curl -w 而非 -f，否则 404 响应体里最有用的那份清单会被丢掉）
- 退出码：0 成功 / 2 参数 / 3 令牌 / 4 分类不存在 / 5 HTTP / 7 连不上 / 8 请求失败

DEPLOY.md 是给部署方的交接单：本机 kbtree 代码已合入 main 且 skill/token
已就位，但**运行中的二进制里没有 kbtree**（14:35 有人换过一版二进制），
故替换与重启留给部署方。含备份/替换/验证步骤、回滚方式、端口与 token 说明。

token 与 config.json **不入库**（config/ 目录留空），安装时由部署方从
配置库 config_kbtree 表读取后写入本机。

2026-09-26 14:43:46 +08:00

2 Commits