From a7d7d852bc5e0c7908fbb13ca3ef31b58d6088aa Mon Sep 17 00:00:00 2001 From: kentyhuang Date: Fri, 24 Jul 2026 16:41:22 +0800 Subject: [PATCH] docs(install): fix repo URL to TencentCloud/, clarify system_admin scope, drop external_id from user create example --- INSTALL.md | 14 +++++++------- INSTALL_CN.md | 7 ++++--- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 5b06bcb..debc38d 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -19,7 +19,7 @@ consume team memory / knowledge / skills through the proxy: ```bash # 1) Fetch the scripts -git clone https://github.com/Tencent/TencentDB-Agent-Memory.git +git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) Prepare .env (fill in real LLM values) @@ -73,11 +73,11 @@ Open **** in your browser (Panel UI). - The first visit asks for a `user_key` — use the admin one printed at the end of `start-all.sh` (stored in `deploy/global-images/.admin-key`, a `sk-mem-...` string) -- Once logged in you are `system_admin`, but at this stage admin can - **only manage sub-users** — it **cannot directly own business assets - (Team / Agent / Task / Skill)** because the business APIs enforce - `owner_user_id === caller` and `system_admin` isn't yet in the allow-list - (this restriction will be lifted in a future release). +- Once logged in you are `system_admin`. It can **create Teams and + sub-users**, but at this stage **cannot directly create other business + assets such as Agent / Wiki / Skill** (the business APIs enforce + `owner_user_id === caller`, and `system_admin` isn't yet in the + allow-list; this restriction will be lifted in a future release). - **Correct pattern**: admin creates a `normal` user → copy that user's `user_key` → log out → log back in as the new user → everything from here on (Team / Agent / Task) is owned by the new user. @@ -99,7 +99,7 @@ curl -sS -X POST http://localhost:8420/v3/meta/user/create \ -H "x-tdai-user-key: $ADMIN_KEY" \ -H "x-tdai-service-id: default" \ -H "Content-Type: application/json" \ - -d '{"username":"you","external_id":"you"}' | jq + -d '{"username":"you"}' | jq ``` The response body's `data.default_user_key` (`sk-mem-...`) is the login diff --git a/INSTALL_CN.md b/INSTALL_CN.md index 46976ee..f36a379 100644 --- a/INSTALL_CN.md +++ b/INSTALL_CN.md @@ -16,7 +16,7 @@ ```bash # 1) 拿脚本 -git clone https://github.com/Tencent/TencentDB-Agent-Memory.git +git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) 准备 .env(把 LLM 相关字段填成真值) @@ -67,7 +67,7 @@ $EDITOR .env - 第一次访问会看到登录页,用 `start-all.sh` 结尾打印的 admin `user_key` (即 `deploy/global-images/.admin-key` 文件里那串 `sk-mem-...`)登录 -- admin 登录后能**创建子用户**,但目前**不能直接创建 Team / Agent / Task +- admin 登录后能**创建 Team 和子用户**,但目前**不能直接创建 Agent / Wiki / Skill 等业务资产**(业务侧 API 会做 `owner_user_id === caller` 校验, system_admin 目前不在允许列表里;这层增强会在后续版本放开) - **正确姿势**:admin 建一把 `normal` 用户 → 复制新用户的 `user_key` → @@ -90,7 +90,7 @@ curl -sS -X POST http://localhost:8420/v3/meta/user/create \ -H "x-tdai-user-key: $ADMIN_KEY" \ -H "x-tdai-service-id: default" \ -H "Content-Type: application/json" \ - -d '{"username":"you","external_id":"you"}' | jq + -d '{"username":"you"}' | jq ``` 返回体里 `data.default_user_key`(`sk-mem-...`)就是新用户的登录 key, @@ -194,6 +194,7 @@ curl -s http://localhost:8420/health | jq .services.pipelineWorker 所以列表为空。正确做法:先按第 1.5 步建一个业务用户,用它的 `default_user_key` 作为 `ANTHROPIC_AUTH_TOKEN`。同时那个用户名下必须先在面板里建过 Team/Agent。 + **Q: 面板显示"Panel API 8125 未启动"?** `docker ps` 检查 `tdai-memory-hub` 是不是 healthy;不 healthy 看 `docker logs tdai-memory-hub` 找报错(大概率是 `REMOTE_INSTANCE_URL` /