@aliyunrds/ctxdb 1.0.4 → 1.0.6

package/dist/setup/skills/contextdb-knowledge/SKILL.md

@@ -1,18 +1,18 @@
 ---
 name: contextdb-knowledge
-description: contextdb 知识库高频操作（查询 / 浏览 KB / 上传文档）和命令速查。当用户提到"查知识库 / 查 KB / 搜知识库 / 查 KB chunks / 上传到 KB / 灌进知识库 / 列出知识库 / 列出 KB / 看文档 / 建知识库 / 建 KB"等场景时使用。配套 contextdb-memory 处理长期记忆。
+description: contextdb 知识库高频操作（查询 / 浏览 KB / 上传或更新文档）和命令速查。当用户提到"查知识库 / 查 KB / 搜知识库 / 查 KB chunks / 上传到 KB / 灌进知识库 / 更新 KB 文档 / 列出知识库 / 列出 KB / 看文档 / 建知识库 / 建 KB"等场景时使用。配套 contextdb-memory 处理长期记忆。
 ---
 
 # contextdb Knowledge Base 操作
 
 ## 1. 什么时候用这个 skill
 
-用户在做"查/灌/列知识库"的任何动作时进这个 skill。触发关键词：**查知识库 / 查 KB / 搜知识库 / 查 KB chunks / 上传到 KB / 灌进知识库 / 列出知识库 / 列出 KB / 看文档 / 建知识库**。
+用户在做"查/灌/列/更新知识库"的任何动作时进这个 skill。触发关键词：**查知识库 / 查 KB / 搜知识库 / 查 KB chunks / 上传到 KB / 灌进知识库 / 更新 KB 文档 / 列出知识库 / 列出 KB / 看文档 / 建知识库**。
 
 - 用户想**找已有 KB 里的内容** → §2 recipe 1
 - 用户**不知道有哪些 KB** → §2 recipe 2
 - 用户想**了解某个 KB 收了哪些文档** → §2 recipe 3
-- 用户要**写入/上传内容** → §2 recipe 4/5
+- 用户要**写入/上传/更新内容** → §2 recipe 4/5
 
 配套 skill：**contextdb-memory**（长期记忆操作）。两者用同一份 `~/.ctxdb/ctxdb.json` 配置和同一个 `--agent` 路由。
 
@@ -101,6 +101,8 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 
 **何时不适用**：要上传的内容是字符串而非本地文件 → recipe 4。
 
+> **同名文档更新**：同一 KB、同一 `--file-path` 下，以相同文档名再次上传，服务端按更新（替换）语义处理；继续调用对应的 `kb upload-text` / `kb upload-file` 命令即可（`upload-file` 必要时用 `--doc-name` 保持文档名不变）。
+
 ## 3. 命令速查
 
 `--agent=<name>` 必填；详细解析链见 §6。其他 advanced flag 见 §6。
@@ -178,7 +180,7 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 | 参数 | 说明 |
 |------|------|
 | `--doc-name` | （`upload-file`）服务端文档名，默认取本地文件名 |
-| `--file-path` | 服务端逻辑路径（归档/分类用） |
+| `--file-path` | KB 内的逻辑父目录，不包含文档名/文件名 |
 | `--wait` | 等到 ingest 成功、失败或达到原有超时；用于迁移旧的默认等待行为 |
 | `--no-wait` | 兼容参数；与新的“受理后立即返回”默认行为相同 |
 
@@ -205,7 +207,7 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude|opencode|hermes>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
 5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置

package/dist/setup/skills/contextdb-memory/SKILL.md

@@ -171,7 +171,7 @@ ctxdb memory delete <memory-id> --agent={{agent}}
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude|opencode|hermes>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
 5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置

package/dist/workers/version-check.js

@@ -4,7 +4,7 @@ import {
   recordVersionCheckFailure,
   recordVersionCheckSuccess,
   releaseVersionCheckLock
-} from "../chunk-BQA7YSXT.js";
+} from "../chunk-Z6OHSEF2.js";
 
 // src/workers/version-check.ts
 import { fileURLToPath } from "url";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliyunrds/ctxdb",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "description": "Unified access layer for RDS ContextDatabase: `ctxdb` CLI (memory + KB ops), one-shot `setup --agent <qoder|qoderwork|codex|claude|opencode|hermes>` installer, per-agent config, hooks/plugins, and SKILL.md.",
   "license": "Apache-2.0",
@@ -32,7 +32,7 @@
   "dependencies": {
     "semver": "^7.8.5",
     "yaml": "^2.9.0",
-    "@aliyunrds/ctxdb-shared": "~0.0.5"
+    "@aliyunrds/ctxdb-shared": "~0.0.6"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",