qi-coding-agent 0.1.1__tar.gz → 0.2.1__tar.gz

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qi-coding-agent
-Version: 0.1.1
+Version: 0.2.1
 Summary: 编码 agent 框架:单 agent core + 扩展(MCP / 多 agent / web)
 Project-URL: Homepage, https://github.com/viewnah/qi
 Project-URL: Repository, https://github.com/viewnah/qi
@@ -61,6 +61,7 @@ qi doctor                           # 冒烟:配置 / 凭证 / 扩展 / 包声
 第一次用,**在界面里两步**就能跑起来:
 
 ```bash
+cd /path/to/folder      # 先切到你要处理的项目目录(qi 的工作目录 = 启动时的目录)
 qi                      # 裸 qi 就是界面(装完直接敲)
 ```
 
@@ -69,6 +70,7 @@ qi                      # 裸 qi 就是界面(装完直接敲)
 ```text
 /login                  # 选 provider(预置都在列表里)→ 遮罩输入 API key → 写 ~/.qi/agent/auth.json
 /model                  # 选模型(只列解析得出凭证的;刚才没有模型时 /login 会顺带选中第一个)
+                        #   选择器里按 ctrl+s = **存为默认**;不按就只对本次会话生效
 ```
 
 然后直接说你要做什么。三种跑法:
@@ -103,7 +105,7 @@ qi 的能力可以按需加装 —— 命令、快捷键、工具、事件钩子
 qi install <来源> [-l]  # 装:调 pip(本地目录只登记)+ 把声明写进 settings.packages(带 -l 写项目)
 qi list                 # 看装了哪些(含目录通道),并与声明双向比对
 qi doctor               # 「声明了没装」「装了没声明」都报出来,并给出可复制的装法
-qi remove <来源>        # 只移除声明(不卸包),并把 pip uninstall 命令打出来
+qi remove <来源>        # 移除声明;没有别的作用域还声明它就连包一起卸(--force 强制卸)
 qi -e <目录>            # 本次运行临时加载一个扩展目录(TUI 与无头都生效,只本进程)
 ```
 

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/README.md

@@ -31,6 +31,7 @@ qi doctor                           # 冒烟:配置 / 凭证 / 扩展 / 包声
 第一次用,**在界面里两步**就能跑起来:
 
 ```bash
+cd /path/to/folder      # 先切到你要处理的项目目录(qi 的工作目录 = 启动时的目录)
 qi                      # 裸 qi 就是界面(装完直接敲)
 ```
 
@@ -39,6 +40,7 @@ qi                      # 裸 qi 就是界面(装完直接敲)
 ```text
 /login                  # 选 provider(预置都在列表里)→ 遮罩输入 API key → 写 ~/.qi/agent/auth.json
 /model                  # 选模型(只列解析得出凭证的;刚才没有模型时 /login 会顺带选中第一个)
+                        #   选择器里按 ctrl+s = **存为默认**;不按就只对本次会话生效
 ```
 
 然后直接说你要做什么。三种跑法:
@@ -73,7 +75,7 @@ qi 的能力可以按需加装 —— 命令、快捷键、工具、事件钩子
 qi install <来源> [-l]  # 装:调 pip(本地目录只登记)+ 把声明写进 settings.packages(带 -l 写项目)
 qi list                 # 看装了哪些(含目录通道),并与声明双向比对
 qi doctor               # 「声明了没装」「装了没声明」都报出来,并给出可复制的装法
-qi remove <来源>        # 只移除声明(不卸包),并把 pip uninstall 命令打出来
+qi remove <来源>        # 移除声明;没有别的作用域还声明它就连包一起卸(--force 强制卸)
 qi -e <目录>            # 本次运行临时加载一个扩展目录(TUI 与无头都生效,只本进程)
 ```
 

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/design/development.md

@@ -16,7 +16,7 @@ uv sync
 `uv sync` 会把 **qi 本体装成 editable**(`.venv/lib/python3.12/site-packages/_editable_impl_qi_agent.pth`)
 并装上 dev 依赖(`pytest` / `pytest-asyncio`)。
 
-**三个官方扩展要单独装**——它们各自是独立 pip 包,而仓库**没有配 uv workspace**(故意的:core 不该
+**三个扩展要单独装**——它们各自是独立 pip 包,而仓库**没有配 uv workspace**(故意的:core 不该
 默认拖上 MCP / FastAPI 那些依赖):
 
 ```bash
@@ -26,6 +26,11 @@ pip install -e extensions/qi-agents -e extensions/qi-mcp -e extensions/qi-web
 
 不装也能跑测试(见 §3);但要在开发机上**手工验证扩展行为**,这三个装上是必须的。
 
+> **还要声明它们才会加载** —— pip 通道的 entry point 只有在 `settings.packages` 里
+> 声明过才装载(对齐 pi)。editable 装完再把名字写进 `~/.qi/agent/settings.json`(或项目
+> `.qi/settings.json`)的 `packages`,例如 `"packages": ["qi-mcp", "qi-agents", "qi-web"]`;
+> `qi list` 会把没声明的列在「已装但未声明」。
+
 ## 2. 从源码跑
 
 ```bash
@@ -52,7 +57,7 @@ uv run pytest -q                      # 等价写法
 `tests/conftest.py` 里有一个 autouse 夹具,把 `qi.extensions` 这组 entry point **stub 成空**。
 理由写在那里的注释里,值得抄一遍:
 
-> 三个官方扩展一旦 `pip install -e` 装上(开发机上很常见),entry point 就会在每个测试的 runtime
+> 三个扩展一旦 `pip install -e` 装上(开发机上很常见),entry point 就会在每个测试的 runtime
 > 里被装载 —— 于是**测试结果取决于这台机器上装了什么**。那种漂移最难查:同一条测试在你这里是
 > 绿的、在 CI 上也是绿的,只是因为它们测的不是同一件事。
 
@@ -146,7 +151,7 @@ uv build --out-dir dist && uv build extensions/qi-mcp --out-dir dist \
 - **打 tag 发布**:`git tag v0.1.0 && git push origin v0.1.0` → 构建 + 发布到 **PyPI**;
 - **手动触发**:Actions → publish → Run workflow,两个输入:
   - `target`:`testpypi`(默认,试跑)/ `pypi`;
-  - `packages`:**`core`(默认,只发 `qi-coding-agent`)** / `all`(连三个官方扩展一起发)。
+  - `packages`:**`core`(默认,只发 `qi-coding-agent`)** / `all`(连三个扩展一起发)。
     选 `core` 时版本检查只核 core(四个锁步那条不适用);扩展还没发布时保持默认。
 - **action 全部按 commit SHA 固定**(发布 job 持有 PyPI 权限,不吃可变 tag),并关掉 uv 缓存
   (`cache-poisoning`)、`checkout` 不带 git 凭证(`persist-credentials: false`);

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/design/extensions-design.md

@@ -309,7 +309,7 @@ qi-agents(唯一知道角色目录的人)
 
 ### A1. 兼容与迁移(一刀切)
 
-已定:不保留"官方扩展自动装载"。`qi web`、`.qi/agents/`、`mcp.json` 都要求**显式装扩展**。
+已定:不保留"扩展自动装载"。`qi web`、`.qi/agents/`、`mcp.json` 都要求**显式装扩展**。
 
 #### A1.1 具体后果清单
 
@@ -357,7 +357,7 @@ qi-agents(唯一知道角色目录的人)
 | E22 | MCP 工具命名 | **`mcp__<server>__<tool>`**(Claude Code 约定),角色白名单支持 `mcp__<server>__*` 通配。理由:不撞名、可前缀过滤,且“角色只拿某 server 的工具”只能靠通配写 |
 | E23 | MCP 的接口归属 | qi-mcp 的接口(配置层级 / scope 交接 / 工具命名)**全属 qi 自己的决定**,不照搬任何现成形状 |
 | E24 | MCP 工具的暴露方式 | **代理兜底 + 白名单驱动直连**。主会话只给一个 `mcp` 代理工具(~200 token);角色的 `tools:` 里写了 `mcp__github__*` → 对**那个角色**直连匹配的工具、**且不给代理**;没写任何 mcp 条目 → 该角色**完全没有** MCP 访问。**否掉了“代理默认 + `directTools`”**:代理能调**任何** server 的工具,于是角色的 `tools:` 白名单限制不了 MCP —— 而“角色 = 精确的工具范围”是本仓的核心语义,白名单形同虚设是最忌的半对齐。**代价**:两种模式并存 **→ 已由 E25 取代** |
-| E25 | qi-mcp 的形状与依赖方向(取代 E20/E24) | **qi-agents 直接依赖 qi-mcp;agent 层的 MCP 发现归 qi-agents**。理由:① agent 目录是 qi-agents 的**自包含包**,包主人认识包成员不是泄漏;② E24 的白名单顾虑在新形状下**前提消失**(角色的 server 集合本就按需注册);③ 少一层自造协议。代价:`pip install qi-agents` 会拖上 MCP 栈;角色 `tools:` 对 MCP 的语义与内置工具不一致(要写进角色文档) |
+| E25 | qi-mcp 的形状与依赖方向(取代 E20/E24) | **qi-agents 直接依赖 qi-mcp;agent 层的 MCP 发现归 qi-agents**。理由:① agent 目录是 qi-agents 的**自包含包**,包主人认识包成员不是泄漏;② E24 的白名单顾虑在新形状下**前提消失**(角色的 server 集合本就按需注册);③ 少一层自造协议。代价:`qi install qi-agents` 会拖上 MCP 栈;角色 `tools:` 对 MCP 的语义与内置工具不一致(要写进角色文档) |
 | E26 | 扩展 API 的命名与参数形状 | **snake_case 是正式名,驼峰是别名**(两者绑定同一个函数对象,`api.registerTool is api.register_tool`);**参数形状两边都收**(options 对象与关键字写法)。事件名、`ctx` 成员名、`ctx.ui` 方法名同样双名。事件 payload 的**键名仍用 snake_case**、不发 `type` 判别字段(见 §12)。理由:两套写法都成立,外来扩展不必改写;代价只是多一层薄别名。**已知尾巴**:`deliver_as` 取值用 `follow_up`/`next_turn`,驼峰别名 `followUp`/`nextTurn` 也认 |
 | E27 | `executionMode` 的并发语义 | **逐工具声明,默认顺序(不声明 = 与以前逐字节一致)**;**相邻**的 `"parallel"` 工具并成一批并发跑,一个顺序工具把批次**打断**(顺序工具永不与并行工具重叠);**并发安全由声明方负责**(写 `"parallel"` 等于说“我的实现是并发安全的”,qi 不做文件变更队列);事件与上下文顺序**仍然确定**(先发完整批 `tool_execution_start`,再按声明序发 end / 结果 / 消息);**没有 session 级默认值**(不先提一个空旋钮)。配套:内部 `AgentEvent(kind="tool_start"/"tool_end")` 现在**必须带 `tool_call_id`** —— 并发时 TUI 工具卡片与 runtime 落盘靠它配对(以前都是单个槽位) |
 | E28 | 模型/思考级别切换的**可观测性与持久化** | **三条一起做,缺一条就是半对齐**:① 落盘 `model_change` / `thinking_level_change` 两个**设置类** entry(`SessionStore.set_context_setting`,同值不重写、只在新会话写起点);② bash/powershell 注入 `QI_SESSION_ID` / `QI_SESSION_FILE` / `QI_PROVIDER` / `QI_MODEL` / `QI_REASONING_LEVEL`(**先删后填**,子运行按自己的模型填);③ `Runtime.bind_session()` 按 entry 还原模型与级别。**为什么必须有**:换模型是**界面状态**、不作为消息进上下文,所以在此之前 agent 既感知不到切换、重启后又丢回去(第一轮对话里 agent 凭记忆答错模型,就是这个洞的表现)。**两处 qi 自己的取舍**:键名用 snake_case `model_id`(本仓约定);还原前多一道 `resolve_key(...).ok` 检查,没凭证就回落默认 + 记 note,而不是发一次注定 401 的请求。**新增的接线**:`bind_session()` —— 换模型/换级别发生在**回合外**,而 `_active_session` 只在一个回合内有效。契约见 [session-format.md §6.1](../docs/session-format.md);测试 `tests/test_session_model_entries.py` 20 项 + `tests/test_shell.py` 4 项 + `tests/test_tui_model_restore.py` 2 项(**TUI 启动路径**:footer 的模型/级别必须与 runtime 真正在用的那个一致 —— `_select_session()` 走的是**同步** bind,不能只靠 `session_start` 那个 async worker) |

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/design/overview.md

@@ -24,7 +24,7 @@
 │   ToolCatalog(内置 8 工具 + clarify)· Session(JSONL + 分支树)   │
 │   LLMClient(models.json)· 技能 / 提示词基座 / 主题资源           │
 ├──────────────────────────────────────────────────────────────┤
-│ 官方扩展(独立 pip 包,进程内)                                    │
+│ 扩展(独立 pip 包,进程内)                                      │
 │   qi-agents(角色 + subagent)· qi-mcp(MCP)· qi-web(HTTP + UI)     │
 └──────────────────────────────────────────────────────────────┘
 ```

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/design/pi-alignment.md

@@ -265,7 +265,7 @@ pi 的 `ToolDefinition.executionMode` 是 `"sequential" | "parallel"`(默认顺
 - 信任模型:pi 同样把信任决定存在用户 home 里(`trust.json`)、不在仓库里 —— qi「项目级 `defaultProjectTrust` 会被忽略」是同一个模型。
 - hook 粒度:**采用 pi 的粒度,不超出**(per-prompt `before_agent_start` + 通知型 `turn_start`)。
 - 依赖契约:公开 import 白名单是 pi 的 `## Available Imports` 的对应物;**禁止钉宿主版本**这条 —— pi 用 `peerDependencies` + `"*"`,Python 没有 peer,所以 qi 改成「明文规定 + 装载时报」。
-- `qi install` 对齐 pi 的 `pi install <source> [-l]`;`remove`/`uninstall` 只移除声明、不卸包,与 pi 同义。
+- `qi install` 对齐 pi 的 `pi install <source> [-l]`;`remove`/`uninstall` 也**真卸包**(先从指定作用域删声明,无别的作用域声明时才卸),与 pi 同义。
 
 ### 11.7 决策记录里被移出手册的上游对照(原 §10 各行)
 
@@ -353,6 +353,6 @@ pi 的 `~/.pi/agent/models-store.json` 不是用户配置,而是**远程模型
 | `compaction.md` | `reserveTokens` 16384「pi 默认值」;「split turn(pi 同款)」;「`_history()` 的装配规则(pi 语义)」 |
 | `skills.md` | 层序说明「为了跟 pi 的发现规则对齐,再叠上 qi 自己的私有层」;`/skill:` 段尾「pi 的同一句话是 "use prompting or `/skill:name` to force it"」 |
 | `quickstart.md` | `qi "分析这个仓库"` 注释「对齐 pi 的 `pi "问题"`」 |
-| `packages.md` | 「`qi install` 存在(对齐 pi)」;「`remove` 不卸包(与 pi 同义)」 |
+| `packages.md` | 「`qi install` 存在(对齐 pi)」;「`remove`/`uninstall` 真卸包(与 pi 同义)」 |
 | `usage.md` | `qi -r` 注释「对齐 pi」 |
 | `development.md` | 「qi 没有 `test.sh`(pi 有 `./test.sh`,照那个敲会失败)」 |

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/design/plugins.md

@@ -15,7 +15,7 @@
 
 | 通道 | 怎么装 | 装到哪 | 发现机制 | 场景 |
 | --- | --- | --- | --- | --- |
-| **pip 包** | `pip install qi-db-tools`(PyPI / git / 本地) | venv 的 site-packages(环境级) | **entry point 扫描**(`importlib.metadata`,启动时自动发现) | 分发、团队共享、锁依赖 |
+| **pip 包** | `qi install qi-db-tools`(PyPI / git / 本地) | venv 的 site-packages(环境级) | **entry point 扫描**(`importlib.metadata`,启动时自动发现) | 分发、团队共享、锁依赖 |
 | **本地目录** | 手动放置/复制源码目录 | `~/.qi/plugins/<name>/`(全局)或 `<项目>/.qi/plugins/<name>/`(项目,需信任) | **目录扫描** | 未发布/私有/本地开发,拷贝即用 |
 
 pip 包通过 **entry point** 声明(对齐 pytest/uvicorn 模式),无需维护安装清单:

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/cli.md

@@ -131,13 +131,22 @@ qi --tools read,grep,find,ls -p "审查这个项目"
 
 ```sh
 qi install <来源> [-l]      # 调 pip + 写进 settings.packages;本地目录只登记(不调 pip)
-qi remove <来源> [-l]       # 只从声明里移除(不卸包),并把 pip uninstall 命令打出来
-qi uninstall <来源> [-l]    # 同 remove
+qi remove <来源> [-l] [--force]   # 移除声明;没有别的作用域还声明它,就连包一起卸
+qi uninstall <来源> [-l] [--force] # 同 remove(别名)
+qi sync [--dry-run]         # 按 settings.packages 对账:补装「声明了但没装」的(只补不删)
 qi update [来源|self] [--self|--extensions|--all|--extension <来源>|--force]
 qi list                     # 列出已装扩展,并与声明双向比对
 qi doctor                   # 诊断(含「声明了没装」的可复制装法)
 ```
 
+`qi remove` / `qi uninstall` **真卸包**(对齐 pi):先从指定作用域删声明,若**没有别的作用域**
+还声明它,就用安装器把包装卸掉(pip / uv,与 `qi install` 同一套);还有别的作用域声明着就只
+删声明、留包(除非 `--force`)—— pip 只有一个环境,包是共享的。
+
+`qi sync` 是 qi 版的 `uv sync`:声明是唯一事实来源,环境按它重建 —— 把 `settings.packages` 里
+**声明了但没装**的扩展补回来(uv tool 环境里自动走 uv 的安装器),但**不卸载**多余的东西。
+它不是启动时自动补装,只在显式调用时动环境;`--dry-run` 只列要装什么。
+
 `qi update` 默认只更 qi 自己;`--models` 在 qi **无意义**(模型全在 `models.json` 里自己维护,它只说明这一点然后退出)。
 `qi install` 每次都先把要跑的 pip 命令打出来 —— 目标环境(自家 venv / `uv tool` / 只读解释器)的行为真的不同,
 声明与比对的意义见 [packages.md](packages.md)。

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/configuration.md

@@ -25,7 +25,7 @@ qi 的配置分**用户级**与**项目级**两层。
 | `<agent-dir>/extensions/` | 用户级[扩展](extensions.md),一目录一个扩展 |
 | `<agent-dir>/SYSTEM.md` | **整体替换**默认基座(见下) |
 | `<agent-dir>/AGENTS.md`(或 `AGENTS.override.md` / `CLAUDE.md`) | 跨工作目录的用户指令 |
-| `<agent-dir>/agents/`、`<agent-dir>/mcp.json` | **官方扩展自己的目录**:角色(qi-agents)与 MCP server(qi-mcp)—— 没装对应扩展就是普通目录 |
+| `<agent-dir>/agents/`、`<agent-dir>/mcp.json` | **扩展的约定目录**:角色与 MCP server —— **core 不读它们**,由扩展接手;没有任何扩展读时就是普通目录 |
 
 ## 项目 `.qi` 目录
 
@@ -36,7 +36,7 @@ qi 的配置分**用户级**与**项目级**两层。
 | `.qi/SYSTEM.md` | **整体替换**本项目里的基座 |
 | `.qi/extensions/` | 项目级扩展(**信任后才加载**) |
 | `.qi/skills/` | 项目级技能 |
-| `.qi/agents/`、`.qi/mcp.json` | 同上:官方扩展自己的目录与声明 |
+| `.qi/agents/`、`.qi/mcp.json` | 同上:扩展的约定目录与声明 |
 
 `SYSTEM.md` 有项目级就用项目级(同名文件**不合并**)。
 

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/extensions.md

@@ -16,7 +16,7 @@
 | 起一个受管的子运行 | `api.run_agent(spec, task)` | §5 |
 | 声明消费型配置(按作用域) | `provides_config` / `register_resolver` / `resolve_tools` | §9 |
 
-可跑的样例:[`examples/extensions/hello/`](../examples/extensions/hello/extension.py) —— 一份 `extension.py` 把主要的面各走一遍,复制它改名字就是你的扩展。`extensions/` 下的三个官方扩展是更完整的参考实现。
+可跑的样例:[`examples/extensions/hello/`](../examples/extensions/hello/extension.py) —— 一份 `extension.py` 把主要的面各走一遍,复制它改名字就是你的扩展。`extensions/` 下的三个自带扩展是更完整的参考实现。
 
 > 相关文档:[packages.md](packages.md)(安装与声明)、[how-qi-works.md](how-qi-works.md)(内置工具)、[settings.md](settings.md)(`extensions` / `packages` 字段)。
 
@@ -75,7 +75,7 @@ qi doctor               # 诊断:装载失败 / 依赖契约 / 声明不一致
 | 项目级 | `<项目>/.qi/extensions/<名>/extension.py`(未信任不加载,见下) |
 | 附加路径 | `settings.json` 的 `extensions[]`:每项可以是扩展目录的**父目录**,也可以直接指向**单个扩展目录**;支持 `-<路径>` 排除 |
 | 单次试用 | `qi -e <目录>` / `--extension`(只本进程,`scope=temporary`) |
-| pip 包 | entry point 组 `qi.extensions` |
+| pip 包 | entry point 组 `qi.extensions`,**且必须在 `settings.packages` 里声明**(没声明的装了也不加载 —— 对齐 pi) |
 
 装载顺序:**项目级 → 用户级 → `settings.extensions[]` → entry point**,各组内按名排序。顺序确定,但**不是稳定 API** —— 需要保证先后关系的扩展应当写成一个扩展。
 
@@ -341,7 +341,7 @@ api.register_tool(Tool(
 
 ## 10. 依赖契约
 
-**安装目标:统一装进 qi 自己的解释器环境。** 目标是 qi 所在的那个 venv,**不是**用户 cwd 的项目 venv(否则就是那个经典失败:"我在项目里 pip install 了,qi 就是 import 不到")。装法就是往 `sys.executable` 对应的环境里 pip —— **这个动作 qi 不替你做**(见下)。
+**安装目标:统一装进 qi 自己的解释器环境。** 目标是 qi 所在的那个 venv,**不是**用户 cwd 的项目 venv(否则就是那个经典失败:"我在项目里 pip install 了,qi 就是 import 不到")。装法就是 `qi install <来源>` —— 它固定往 `sys.executable` 对应的环境装(uv tool 环境里自动改用 uv 的安装器)。
 
 - **公开 import 白名单**:只能 import §3 列的那些名字。别的 `qi_agent.*` 模块算内部实现。
 - **扩展不得把 `qi-coding-agent` 写进 `dependencies`**(否则 pip 会在解析时把 qi 自己降级 —— 宿主被自己的扩展踢掉)。
@@ -349,9 +349,9 @@ api.register_tool(Tool(
   另一条会单独报出来:**旧名 `qi-agent`** —— 那个名字在 PyPI 上属于别的项目,写进依赖不是"多写一条",
   而是会真的装一个不相干的包(还可能与 qi 的 import 包在 `site-packages` 里撞车)。
 - **接受的代价**:所有扩展 + 宿主共用一棵解析树 → **版本冲突无处躲**。三层缓解:① 装载时比对已装版本,**不一致就报告**(不静默);② 冲突就拆成独立进程(自己的环境);③ 重依赖优先走外部进程/服务。
-- **uv tool / pipx 的坑**:uv 文档原话 —— tool 环境 "may be upgraded via `uv tool upgrade`, or **re-created entirely** via subsequent `uv tool install`",所以 pip 装进去的扩展**会被重建抹掉**。规矩:声明永远在 `settings.packages`,用 `qi doctor` / `qi list` 在每次重建后**发现**它丢了(并给出装法);或者这类用户直接用 `uv tool install qi-coding-agent --with <包>`(写进 uv 的托管依赖,升级不丢 —— 这条更省事,推荐)。
+- **uv tool / pipx 的坑**:uv 文档原话 —— tool 环境 "may be upgraded via `uv tool upgrade`, or **re-created entirely** via subsequent `uv tool install`",所以 pip 装进去的扩展**会被重建抹掉**。规矩:声明永远在 `settings.packages`,重建后用 **`qi sync`** 一条命令补回来(它按声明对账,自动走 uv 的安装器);也可以用 `qi doctor` / `qi list` **发现**它丢了(并给出装法)。或者这类用户直接用 `uv tool install qi-coding-agent --with <包>`(写进 uv 的托管依赖,升级不丢 —— 这条更省事,推荐)。
 - **宿主环境只读时**(系统 Python / Homebrew 管理的解释器):pip 会自己报错;出路是 `uv tool install qi-coding-agent --with <ext>`,或换一个可写的安装方式。qi 不检测这件事 —— 它不调 pip,所以也不该假装知道装不装得进。
-- **`qi install <来源> [-l]`** 帮你走一步:调 pip + 写进 `settings.packages`(带 `-l` 写项目)。它**不替代**“想清楚装到哪个环境”这件事,所以每次都先把要跑的命令打出来。`qi remove` / `uninstall` 只从声明里移除(**不卸包**)。详见 [packages.md](packages.md) 与 [cli.md](cli.md)。
+- **`qi install <来源> [-l]`** 帮你走一步:调安装器(uv tool 环境里**自动改用 uv 的安装器**,目标仍是 qi 自己的解释器)+ 写进 `settings.packages`(带 `-l` 写项目)。它每次都先把要跑的命令打出来。`qi remove` / `uninstall` 从指定作用域删声明,若没有别的作用域还声明它,就连包一起卸(对齐 pi)。详见 [packages.md](packages.md) 与 [cli.md](cli.md)。
 
 ## 11. 细节与已知限制
 

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/keybindings.md

@@ -19,6 +19,7 @@ TUI 里 `/hotkeys` 会列出当前生效的键位,并如实标出哪些还没做
 | `ctrl+x` | 复制最后一条回答 |
 | `ctrl+g` | 用 `$EDITOR` 编辑当前输入 |
 | `ctrl+l` | 模型选择器(与 `/model` 同一个) |
+| 模型选择器里 `enter` / `ctrl+s` | 换模型(**只本会话**,落 `model_change`)/ 换并**存为默认**(写 `settings.defaultProvider`/`defaultModel`) |
 | `ctrl+p` / `ctrl+shift+p` | 下一个 / 上一个模型(轮换清单由 `/scoped-models` 决定) |
 | `ctrl+z` | 挂起(回到 shell) |
 

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/models.md

@@ -30,6 +30,12 @@ qi 通过 litellm 调各家模型。provider 与模型定义都在 `models.json`
   真正提交消息才报错;无头路径(`-p` / `--mode json`)直接报错退出,并给出可照抄的迁移命令
   —— 与 pi 的 interactive / 非 interactive 同一取舍。
 - 查看:`qi --list-models [搜索词]`(缺密钥的也列,这是诊断面;解析不出凭证的 provider 不列)。
+- **TUI 里换模型**:`/model`(或 `ctrl+l`)选择器里 `enter` 只换**本会话**(落一条 `model_change`,
+  续接这条会话才还原);按 **`ctrl+s`** 则连**默认一起改** —— 写回 `settings.json` 的
+  `defaultProvider` / `defaultModel`,下次**新会话**就是它(对齐 pi 的 `app.models.save`)。
+- **登录时顺手定默认**:`/login <provider>` 时如果**还没有模型**,qi 会选中该 provider 的
+  第一个模型并**写成全局默认**(对齐 pi 的 `completeProviderAuthentication` 用 `persist: true`)
+  —— 所以第一次登录后重启也还是它。已经有模型时不洗掉当前选择(只提示“当前模型不变”)。
 
 ## 接本地模型
 
@@ -137,4 +143,5 @@ models.json:  $QI_AGENT_CONFIG(env 指定文件,最高)
 | 模型不在 `/model` 或 `ctrl+p` 清单里 | 清单只列**解析得出凭证**的 provider —— 跑 `qi --list-models` 看 `credential` 列 |
 | "我明明设了环境变量" | `qi doctor` 会给出凭证**来源**(`auth(...)` / `env:XXX` / `config:...`),区分"没读到"与"读到了但为空" |
 | provider 拒收 `reasoning_effort` | qi 会自动去掉参数重试并在 footer 提示一次;也可把该模型的 `reasoning` 改成 `false` |
+| 回合失败出现 `'ascii' codec can't encode` | **API key 里有非 ASCII 字符**(多半是把一段中文提示误粘进了密钥框)。现在 qi 在请求前就报“API key 含非 ASCII 字符(来源:…)”;修:`qi auth list` 看来源 → 重新 `qi auth login <provider>` / 改环境变量 / 改 `models.json` 的 `apiKey` |
 | 相容端点返回 4xx | 先确认 `api` 形态选对(`openai-completions` vs `openai-responses` vs `anthropic-messages`) |

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/packages.md

@@ -1,21 +1,24 @@
 # 扩展的安装与声明
 
-> 装扩展 = 调 pip(或放一个目录);qi **不做**这件事,只做「**声明层 + 比对**」。
+> 装扩展 = 装一个 pip 包,或放一个目录;`qi install` 帮你做这一步,`qi doctor` / `qi list` 负责「声明层 + 比对」。
 > 相关:[cli.md](cli.md)(命令速查)、[extensions.md](extensions.md)(扩展机制与 API)、[settings.md](settings.md)(`packages` / `extensions` 字段)。
 
 ## 1. 谁负责跱这一步
 
-`qi install` **存在**,但它只是**帮你跱一步**:调一次 pip,然后把声明写进
+`qi install` **存在**,但它只是**帮你跱一步**:调一次安装器,然后把声明写进
 `settings.packages`。**它不替代“想清楚装到哪个环境”这件事** —— 三种目标环境的行为真的不同:
 
 1. **目标环境有三种**:qi 自己的 venv、`uv tool` 托管的环境、只读的系统解释器(Homebrew / 系统 Python)。
-   qi 每次都把要跑的命令**先打出来**,所以你能看出装到了哪里;只读解释器下 pip 会自己报错,
-   qi 把输出原样给你并补上 `uv tool install qi-coding-agent --with <包>` 那条出路。
+   目标始终是 **qi 自己的解释器**(`sys.executable`),所以不会装到 cwd 的项目 venv。
+   `uv tool` 的环境里**没有 pip**(uv 自己解 wheel,不 seed pip),qi 会自动改用 uv 的安装器
+   (`uv pip install --python <sys.executable>`,目标不变)。qi 每次都把要跑的命令**先打出来**;
+   只读解释器下安装器会自己报错,qi 把输出原样给你并补上 `uv tool install qi-coding-agent --with <包>` 那条出路。
 2. **`uv tool` 会整个重建环境**。uv 文档的原话:tool 环境 "may be upgraded via `uv tool upgrade`,
    or **re-created entirely** via subsequent `uv tool install`"。所以 pip 装进去的扩展**会被抹掉**
    —— 声明还在,`qi doctor` 会把它报出来(这正是“声明层”存在的意义)。
-3. **`remove` 不卸包**:它只从声明里移除,并把 `pip uninstall` 命令给你。
-   装/卸包是 pip 的事,声明是你的事。
+3. **`remove` / `uninstall` 真卸包**(对齐 pi):先从指定作用域删声明,若没有别的作用域
+   还声明它,就用安装器把包装卸掉;还有别的作用域声明着就只删声明、留包(除非 `--force`)
+   —— pip 只有一个环境,包是共享的。
 4. **声明与实装始终是两件事**:声明说"这个环境该有什么",实装由 pip 决定。所以 `qi list` /
    `qi doctor` 永远做**两个方向**的比对 —— 即使你用的是 `qi install`。
 
@@ -34,6 +37,7 @@
 | `qi-mcp>=0.2` | pip | 名字 + 版本约束(整个 spec 会进装法) |
 | `Qi.MCP` | pip | **PEP 503 归一** → `qi-mcp`(与「已装」侧同一规则,否则一边算命中一边不算) |
 | `qi-mcp @ git+https://host/repo` | pip | **显式名字**(PEP 508 的 `名字 @ URL`) |
+| `qi_mcp-0.1.1.tar.gz` / `./x.whl` | pip | **本地归档**(wheel / sdist):从文件名取 `qi_mcp-0.1.1.tar.gz` → `qi-mcp` |
 | `local:./extensions/qi-mcp` | 目录 | 目录名 |
 | `/abs/path`、`./rel`、`~/x`、`file:…` | 目录 | `Path(...).name` |
 | `{"name": "pip:qi-mcp"}` | 按内容判 | 取 `name` / `spec` / `source` 里第一个非空的 |
@@ -50,71 +54,82 @@
 
 | 通道 | 位置 |
 | --- | --- |
-| pip | entry point 组 `qi.extensions`(`importlib.metadata`) |
+| pip | entry point 组 `qi.extensions`(`importlib.metadata`);**只有 `settings.packages` 声明过的才会装载** |
 | 目录 | `~/.qi/agent/extensions/<名>/extension.py`、项目 `.qi/extensions/<名>/extension.py` |
 | 附加 | `qi -e <dir>`、`settings.extensions[]` |
 
-> **未信任的项目目录不扫** —— 与装载路径同一条门控。否则未信任项目的 `.qi/extensions/`
-> 会让报告显得"已装",而实际一个都没加载。
+> **pip 通道的声明是装载门** —— 对齐 pi:`settings.packages` 是事实来源。`pip` 装了但没声明的
+> 扩展(`qi list` 会列在「已装但未声明」)**不会被加载**,写进声明才生效。
+>
+> **未信任的项目目录不扫**,项目级声明也不计入 —— 与装载路径同一条门控。否则未信任项目的
+> `.qi/extensions/` 会让报告显得"已装",而实际一个都没加载。
 
 同名去重:entry point 先到先得。
 
 ## 4. 两条装法,失效面不同
 
-`qi doctor` / `qi list` 会把两条都打出来,**不替你选**:
+`qi doctor` / `qi list` 会把两条都打出来,**不替你选**。嫌两条麻烦就直接 `qi sync` ——
+它按 `settings.packages` 把缺的装回来:
 
 ```bash
-# ① 直接装进 qi 所在的那个解释器(最直接)
-/path/to/venv/bin/python -m pip install "qi-mcp>=0.2"
+# ① 装进 qi 自己的解释器环境(uv tool 环境里自动改用 uv 的安装器)
+qi install "qi-mcp>=0.2"
 
 # ② 写进 uv tool 的托管依赖(uv tool 重建 / 升级后仍然在 —— 推荐)
 uv tool install qi-coding-agent --with "qi-mcp>=0.2"
 ```
 
-| | ① 直接 pip | ② uv 托管依赖 |
+| | ① `qi install` | ② uv 托管依赖 |
 | --- | --- | --- |
-| 装到哪 | `sys.executable` 对应的环境 | uv 的 tool 环境 |
+| 装到哪 | qi 自己的解释器环境(`sys.executable`;uv tool 环境里自动走 `uv pip --python <sys.executable>`) | uv 的 tool 环境 |
 | uv tool 重建后 | **丢**(声明还在,所以 `qi doctor` 会把它报出来) | 保留 |
-| 只读解释器 | 失败(pip 自己报错) | 可行 |
+| 只读解释器 | 失败(安装器自己报错) | 可行 |
 | 适合 | 自己管 venv 的人 | 用 `uv tool` 装 qi 的人 |
 
 ## 5. 怎么读输出
 
-装好了但没声明(这份环境里三个扩展都是 editable 装进来的):
+装好了但没声明(这份环境里三个扩展都是 pip 装进来的):
 
 ```text
 $ qi list
-                            扩展
-┏━━━━━━━━━━━┳━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┓
-┃ 扩展      ┃ 通道 ┃ 版本  ┃ 来源                   ┃ 声明 ┃
-┡━━━━━━━━━━━╇━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━┩
-│ qi-mcp    │ pip  │ 0.1.0 │ qi-mcp 0.1.0 · user    │ 否   │
-│ qi-agents │ pip  │ 0.1.0 │ qi-agents 0.1.0 · user │ 否   │
-│ qi-web    │ pip  │ 0.1.0 │ qi-web 0.1.0 · user    │ 否   │
-└───────────┴──────┴───────┴────────────────────────┴──────┘
-  已装但未声明(3): qi-mcp、qi-agents、qi-web —— 写进 settings.packages 才能在 uv
-tool 重建后补回
+                           扩展
+┏━━━━━━━━━━━┳━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┓
+┃ 扩展      ┃ 通道 ┃ 版本  ┃ 来源                  ┃ 声明 ┃
+┡━━━━━━━━━━━╇━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━┩
+│ qi-mcp    │ pip  │ 0.1.0 │ qi-mcp 0.1.0 · env    │ 否   │
+│ qi-agents │ pip  │ 0.1.0 │ qi-agents 0.1.0 · env │ 否   │
+│ qi-web    │ pip  │ 0.1.0 │ qi-web 0.1.0 · env    │ 否   │
+└───────────┴──────┴───────┴───────────────────────┴──────┘
+  已装但未声明(3): qi-mcp、qi-agents、qi-web —— pip 扩展只有声明了才会加载;
+写进 settings.packages 才生效(也是 uv tool 重建后能补回的依据)
 ```
 
-声明里有一条装不上、还有一条认不出时(`packages: ["pip:qi-todo", "qi-agents", "git+https://host/repo"]`):
+> **两个「作用域」别混**:`来源` 列的 `· env` 说的是**装在哪** —— pip 扩展都装进 qi 的
+> **同一个解释器环境**,所以固定是 `env`(没有“项目一份 / 全局一份”)。`声明` 列才是
+> **哪一级 `settings.packages` 写了它**:`user` = `~/.qi/agent/settings.json`,
+> `project` = `<git 根>/.qi/settings.json`(`qi install -l` 写的就是后者)。
+
+声明里有一条装不上、一条认不出,并且同一个包两级都声明时:
 
 ```text
                                扩展
-┏━━━━━━━━━━━┳━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
-┃ 扩展      ┃ 通道 ┃ 版本  ┃ 来源                        ┃ 声明   ┃
-┡━━━━━━━━━━━╇━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━┩
-│ qi-mcp    │ pip  │ 0.1.0 │ qi-mcp 0.1.0 · user         │ 否     │
-│ qi-agents │ pip  │ 0.1.0 │ qi-agents 0.1.0 · user      │ 是     │
-│ qi-web    │ pip  │ 0.1.0 │ qi-web 0.1.0 · user         │ 否     │
-│ qi-todo   │ pip  │ —     │ pip:qi-todo · settings:user │ 未安装 │
-└───────────┴──────┴───────┴─────────────────────────────┴────────┘
+┏━━━━━━━━━━━┳━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┓
+┃ 扩展      ┃ 通道 ┃ 版本  ┃ 来源                        ┃ 声明               ┃
+┡━━━━━━━━━━━╇━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━┩
+│ qi-mcp    │ pip  │ 0.1.0 │ qi-mcp 0.1.0 · env          │ 否                 │
+│ qi-agents │ pip  │ 0.1.0 │ qi-agents 0.1.0 · env       │ 是(user + project) │
+│ qi-web    │ pip  │ 0.1.0 │ qi-web 0.1.0 · env          │ 否                 │
+│ qi-todo   │ pip  │ —     │ pip:qi-todo · settings:user │ 未安装             │
+└───────────┴──────┴───────┴─────────────────────────────┴────────────────────┘
 包声明:
   ✗ 声明了但没装: pip:qi-todo (settings:user)
-      /…/bin/python3 -m pip install "qi-todo"
+      qi install "qi-todo"
       uv tool install qi-coding-agent --with "qi-todo"
   ⚠ 无法解析的声明: git+https://host/repo
       用 `名字 @ URL` 写法才认得出名(如 qi-mcp @ git+https://host/repo)
-  已装但未声明(2): qi-mcp、qi-web —— 写进 settings.packages 才能在 uv tool 重建后补回
+  已装但未声明(2): qi-mcp、qi-web —— pip 扩展只有声明了才会加载;
+写进 settings.packages 才生效(也是 uv tool 重建后能补回的依据)
+  qi-agents 被多级声明(user + project),以项目级为准
 ```
 
 四类信息各自的含义:
@@ -152,4 +167,4 @@ tool 重建后补回
 - **目录通道的 PEP 723 声明**:`# /// script` 里的 `dependencies` 目前只用于上面那条宿主依赖检查;
   `qi doctor` 还**不**据它去查"这些依赖装齐了没有"。
 - `settings.packages`(包声明)与 `settings.extensions`(资源路径)是**两件事**:
-  前者是"这个环境该装什么",后者是"到哪里去找扩展目录"。
+  前者既决定这个环境该装什么,**也是 pip 通道的装载门**(声明了才加载),后者是"到哪里去找扩展目录"。

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/sessions.md

@@ -100,6 +100,9 @@ TUI 里回放会话、以及网页端显示的用量,都来自 `session.py` 的
   在启动提示里说明 —— 不会拿着一个注定 401 的模型继续跑。
 - **CLI 显式给的赢**:`--model` / `--thinking`(含 `--model provider/id:级别`)是当次覆盖,
   不会被会话里的旧值顶掉。
+- **新会话走默认、不是“上次用过”**:裸 `qi` 起的是**新会话**,没有 `model_change` 可还原,
+  于是回 `settings.json` 的 `defaultProvider`/`defaultModel`。想让某个模型成为“以后都是它”,
+  在选择器里按 `ctrl+s` 存为默认(或直接编辑 `settings.json`)。
 - **换模型与换级别在界面上照旧是即时生效的**(下一回合用到请求里);落 entry 是为了"下次打开"
   与"回放里看得出切换点",不影响本回合行为。
 - **界面显示的与发出去的一致**:TUI 的 footer 缓存(`_model` / `_thinking_level`)在选会话后

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/docs/slash-commands.md

@@ -7,7 +7,7 @@ TUI 里输入 `/` 会补全全部命令(内置的、扩展注册的、技能命
 
 | 命令 | 说明 |
 | --- | --- |
-| `/model [p/m]` | 不给参数 = 开选择器(与 `ctrl+l` 同一个);给 `p/m` 或唯一模型名 = 直接切。**只列解析得出凭证的模型**。切换会落一条 `model_change`,下次打开这条会话仍用它 |
+| `/model [p/m]` | 不给参数 = 开选择器(与 `ctrl+l` 同一个);给 `p/m` 或唯一模型名 = 直接切。**只列解析得出凭证的模型**。切换会落一条 `model_change`,**续接这条会话**时仍用它;想让**下次新会话**也是它,在选择器里按 `ctrl+s`(存为全局默认,写 `settings.defaultProvider`/`defaultModel`) |
 | `/scoped-models` | 挑 `ctrl+p` 轮换哪些模型(空 = 全部,写回 `settings.enabledModels`);已不可用的条目画删除线 + `[unavailable]`,取消勾选才移出 |
 | `/thinking` | 不给参数 = 开选择器;切换落一条 `thinking_level_change` entry,下次打开按它还原 |
 | `/settings` | 偏好面板:主题 / 思考级别 / 交互开关(`enter` 换值、`ctrl+s` 保存到**用户级** settings) |

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/examples/extensions/README.md

@@ -12,7 +12,7 @@
 | 形态 | 入口 | 适合 |
 | --- | --- | --- |
 | **目录形态** | `<项目>/.qi/extensions/<名>/extension.py` 或 `~/.qi/agent/extensions/<名>/extension.py` | 自己用、快速试;**项目级要在信任的项目里才装载** |
-| **包形态** | `pyproject.toml` 里声明 `qi.extensions` entry point,`pip install` 之后自动发现 | 要发布/共享(三个官方扩展都是这种) |
+| **包形态** | `pyproject.toml` 里声明 `qi.extensions` entry point,装进 qi 后自动发现 | 要发布/共享(仓库里的三个扩展都是这种) |
 | **临时形态** | `settings.json` 的 `extensions: ["/路径"]` | 开发调试(不写进扩展目录) |
 
 ## 相关文档

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/examples/extensions/hello/README.md

@@ -34,7 +34,7 @@ hello/
 ```
 
 一个扩展就是一个目录 + 一个 `extension.py`(里面必须有 `register(api)`)。
-包形态(要发到 PyPI 那种)见 `extensions/` 下的三个官方扩展:它们用
+包形态(要发到 PyPI 那种)见 `extensions/` 下的三个扩展:它们用
 `pyproject.toml` 的 `qi.extensions` entry point 声明入口,目录里放一个真正的 Python 包。
 
 ## 想抄更完整的

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-agents/README.md

@@ -8,7 +8,7 @@ qi 的**角色系统**扩展:角色发现 + 角色选择 + `subagent` 委派。
 ## 装
 
 ```bash
-pip install qi-agents            # 或 -e ./extensions/qi-agents(开发)
+qi install qi-agents            # 或 -e ./extensions/qi-agents(开发)
 ```
 
 它会一并装上 **qi-mcp**(E25 定的硬依赖)—— 角色自带的 MCP server 由 qi-mcp 负责连与注册。

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-agents/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qi-agents"
-version = "0.1.1"
+version = "0.2.1"
 description = "qi 的角色系统扩展:角色发现 + 角色选择 + subagent 工具(进程内受管子运行)"
 readme = "README.md"
 requires-python = ">=3.12"

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-mcp/README.md

@@ -12,7 +12,7 @@ qi 的 MCP 支持。形状**照搬 [`pi-mcp-adapter`](https://pi.dev/packages/pi
 ## 装
 
 ```bash
-pip install qi-mcp        # 或 -e ./extensions/qi-mcp(开发)
+qi install qi-mcp        # 或 -e ./extensions/qi-mcp(开发)
 ```
 
 装完 `qi` 下次启动自动发现它(entry point `qi.extensions`)。

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-mcp/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qi-mcp"
-version = "0.1.1"
+version = "0.2.1"
 description = "qi 的 MCP 支持:两层 mcp.json 声明表 + 一个 mcp 代理工具 + lazy server"
 readme = "README.md"
 requires-python = ">=3.12"

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-web/README.md

@@ -9,7 +9,7 @@ core 不再拖 fastapi/uvicorn,`qi web` 这个入口也由本扩展自己提供(
 ## 装
 
 ```bash
-pip install qi-web        # 或 -e ./extensions/qi-web(开发)
+qi install qi-web        # 或 -e ./extensions/qi-web(开发)
 ```
 
 装完 `qi web` 才有这条子命令 —— 没装时它不是"报错",而是**不存在**(core 里已经没有它了)。

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-web/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qi-web"
-version = "0.1.1"
+version = "0.2.1"
 description = "qi 的 Web UI 扩展:HTTP 宿主(REST + SSE)+ AG-UI 桥 + 官方界面"
 readme = "README.md"
 requires-python = ">=3.12"

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/extensions/qi-web/qi_web/serve.py

@@ -146,7 +146,7 @@ def serve(argv: list[str]) -> int:
         from .app import create_app
     except ImportError as exc:               # fastapi/uvicorn 是**本扩展**的依赖
         err_console.print(f"[red]缺少 web 依赖:[/red] {escape(str(exc))}")
-        err_console.print("  安装: [bold]pip install qi-web[/bold]")
+        err_console.print("  安装: [bold]qi install qi-web[/bold]")
         return 2
 
     password = args.password or os.environ.get("QI_WEB_PASSWORD") or None

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qi-coding-agent"
-version = "0.1.1"
+version = "0.2.1"
 description = "编码 agent 框架:单 agent core + 扩展(MCP / 多 agent / web)"
 keywords = ["agent", "coding-agent", "cli", "tui", "llm", "mcp"]
 readme = "README.md"

{qi_coding_agent-0.1.1 → qi_coding_agent-0.2.1}/src/qi_agent/__init__.py

@@ -15,4 +15,4 @@ import os
 # 开关语义见 litellm/litellm_core_utils/get_model_cost_map.py。
 os.environ.setdefault("LITELLM_LOCAL_MODEL_COST_MAP", "True")
 
-__version__ = "0.1.1"
+__version__ = "0.2.1"