@handsupmin/gc-tree 0.8.19 → 1.0.1

package/docs/usage.zh.md

@@ -4,7 +4,7 @@
 
 ## 概述
 
-标准的 `gctree` 工作流如下：初始化 gc-tree、选择提供商、对默认的 `main` gc-branch 执行 onboard、解析所需上下文、在工作需要独立空间时创建新的 gc-branch、将代码仓库映射到正确的 gc-branch，以及在后续使用有引导的更新流程进行持久化变更。
+标准的 `gctree` 工作流如下：初始化 gc-tree、选择提供商、对默认的 `main` gc-branch 执行 onboard、解析所需上下文、在工作需要独立空间时创建新的 gc-branch、将代码仓库映射到正确的 gc-branch、在后续使用有引导的流程更新持久化上下文，并在需要刷新 CLI 和已安装 provider 集成时运行 `gctree update`。
 
 ## 标准工作流
 
@@ -19,7 +19,8 @@
 9. 使用 `gctree checkout` 创建或切换 gc-branch
 10. 仅对空的 gc-branch 运行 `gctree onboard`
 11. 使用仓库作用范围映射，使 gc-branch 只在其适用的地方生效
-12. 使用 `gctree update-global-context` 进行后续的持久化变更
+12. 使用 `gctree update-global-context` 进行后续的持久化上下文变更
+13. 使用 `gctree update` 更新 gc-tree 本身并重新安装已安装的 provider
 
 ## 核心命令
 
@@ -41,6 +42,7 @@
 | `gctree update-global-context` | 为活跃的 gc-branch 启动有引导的持久化更新。 |
 | `gctree update-gc` / `gctree ugc` | `gctree update-global-context` 的别名。 |
 | `gctree scaffold --host <codex\|claude-code>` | 在单个仓库或工作区中安装本地 provider override。 |
+| `gctree update` | 将 gctree 更新到最新 npm 版本，并重新安装所有已有 provider。 |
 | `gctree uninstall --yes` | 删除 `~/.gctree` 和全局 gctree 激活。 |
 
 ## resolve 返回的内容
@@ -51,40 +53,22 @@
 gctree resolve --query "auth token rotation policy"
 ```
 
-```json
-{
-  "gc_branch": "main",
-  "query": "auth token rotation policy",
-  "status": "matched",
-  "matches": [
-    {
-      "id": "auth",
-      "title": "Auth & Session Conventions",
-      "path": "docs/auth.md",
-      "score": 4,
-      "summary": "JWT rotation on every request, refresh tokens in httpOnly cookies, 15-min access token TTL",
-      "excerpt": "## Auth Flow\nAccess token: 15-min TTL, rotated on every authenticated request...",
-      "commands": {
-        "show_doc": "gctree show-doc --id \"auth\" --home \"~/.gctree\" --branch \"main\"",
-        "related": "gctree related --id \"auth\" --home \"~/.gctree\" --branch \"main\""
-      }
-    }
-  ]
-}
+```
+[gc-tree] 1 matching doc  gc-branch="main"  repo="my-repo"
+[Auth & Session Conventions] JWT rotation on every request, refresh tokens in httpOnly cookies, 15-min access token TTL
+[Auth & Session Conventions] show full doc: gctree show-doc --id "auth" --branch "main"
 ```
 
 推荐的流程是：
 
 1. `resolve` → 紧凑索引
-2. `related` → 某个匹配周围的 supporting docs
-3. `show-doc` → 仅在需要时读取完整 markdown
+2. `show-doc` → 仅在需要时读取完整 markdown
 
 Graceful degradation 也是显式的：
 
-- 空 gc-branch → `status: "empty_branch"`
-- 被排除的 repo → `status: "excluded"`
-- 无匹配结果 → `status: "no_match"`
-- 文档 ID 不存在 → `status: "doc_not_found"`
+- 空 gc-branch → 纯文本提示：该 gc-branch 为空
+- 被排除的 repo → 纯文本提示：该 repo 已被排除
+- 无匹配结果 → 纯文本提示：没有匹配项
 
 ## 仓库作用范围示例流程
 
@@ -128,7 +112,7 @@ gctree init
 ## 多分支示例流程
 
 ```bash
-gctree checkout -b client-b
+gctree checkout -b project-b
 gctree onboard
 gctree resolve --query "billing retry policy"
 ```
@@ -151,13 +135,21 @@ gctree ugc
 1. 将该仓库映射到 gc-branch
 2. 然后运行 `update-global-context`，添加关于该仓库用途及重要性的持久化知识
 
+## 工具更新示例流程
+
+```bash
+gctree update
+```
+
+这会将 `@handsupmin/gc-tree` 更新到最新 npm 版本，并重新安装通过 `gctree init` 或 `gctree scaffold` 已安装的所有 provider。当新的 hook、command、skill 或集成片段发布时，可以用它进行维护更新。
+
 ## 集成模式
 
 ### Codex CLI / Claude Code CLI
 
 `gctree init` 会安装全局 provider hook 表面。`gctree scaffold` 则在某个仓库需要自己的 markdown 片段或本地命令表面时，将本地 override 安装到目标目录中。
 
-UserPromptSubmit hook 只注入紧凑的 pre-task context：found/no-match 状态以及匹配文档的标题/ID。默认不内联摘要或长 excerpt；需要时用 `gctree resolve --id <id>` 打开完整文档。
+UserPromptSubmit hook 会在每次提示词前将匹配文档的摘要直接注入上下文——让 AI 看到的是真实的模式和命令，而不只是标题。当摘要过短或过于笼统时，hook 会回退到文档正文的摘录。完整文档随时可通过 `gctree resolve --id <id>` 按需获取。
 
 ```bash
 gctree scaffold --host codex --target /path/to/repo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@handsupmin/gc-tree",
-  "version": "0.8.19",
+  "version": "1.0.1",
   "description": "Global Context Tree, a lightweight branch-aware global context orchestrator for AI coding tools",
   "type": "module",
   "private": false,
@@ -27,9 +27,7 @@
     "eval:multi-repo:verbose": "node --import tsx tests/eval/multi-repo.ts --verbose",
     "eval:autoresearch": "node --import tsx tests/eval/autoresearch.ts",
     "eval:multilingual": "node --import tsx tests/eval/multilingual.ts",
-    "eval:multilingual:verbose": "node --import tsx tests/eval/multilingual.ts --verbose",
-    "eval:real-docs": "node --import tsx tests/eval/real-docs.ts",
-    "eval:real-docs:verbose": "node --import tsx tests/eval/real-docs.ts --verbose"
+    "eval:multilingual:verbose": "node --import tsx tests/eval/multilingual.ts --verbose"
   },
   "engines": {
     "node": ">=20"