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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qi-coding-agent
-Version: 0.2.0
+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
@@ -70,6 +70,7 @@ qi                      # 裸 qi 就是界面(装完直接敲)
 ```text
 /login                  # 选 provider(预置都在列表里)→ 遮罩输入 API key → 写 ~/.qi/agent/auth.json
 /model                  # 选模型(只列解析得出凭证的;刚才没有模型时 /login 会顺带选中第一个)
+                        #   选择器里按 ctrl+s = **存为默认**;不按就只对本次会话生效
 ```
 
 然后直接说你要做什么。三种跑法:

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

@@ -40,6 +40,7 @@ qi                      # 裸 qi 就是界面(装完直接敲)
 ```text
 /login                  # 选 provider(预置都在列表里)→ 遮罩输入 API key → 写 ~/.qi/agent/auth.json
 /model                  # 选模型(只列解析得出凭证的;刚才没有模型时 /login 会顺带选中第一个)
+                        #   选择器里按 ctrl+s = **存为默认**;不按就只对本次会话生效
 ```
 
 然后直接说你要做什么。三种跑法:

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

@@ -143,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.2.0 → qi_coding_agent-0.2.1}/docs/packages.md

@@ -88,41 +88,48 @@ uv tool install qi-coding-agent --with "qi-mcp>=0.2"
 
 ## 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)
       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),以项目级为准
 ```
 
 四类信息各自的含义:

{qi_coding_agent-0.2.0 → 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.2.0"
+version = "0.2.1"
 description = "qi 的角色系统扩展:角色发现 + 角色选择 + subagent 工具(进程内受管子运行)"
 readme = "README.md"
 requires-python = ">=3.12"

{qi_coding_agent-0.2.0 → 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.2.0"
+version = "0.2.1"
 description = "qi 的 MCP 支持:两层 mcp.json 声明表 + 一个 mcp 代理工具 + lazy server"
 readme = "README.md"
 requires-python = ">=3.12"

{qi_coding_agent-0.2.0 → 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.2.0"
+version = "0.2.1"
 description = "qi 的 Web UI 扩展:HTTP 宿主(REST + SSE)+ AG-UI 桥 + 官方界面"
 readme = "README.md"
 requires-python = ">=3.12"

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "qi-coding-agent"
-version = "0.2.0"
+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.2.0 → 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.2.0"
+__version__ = "0.2.1"

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/auth.py

@@ -118,15 +118,37 @@ class ResolvedKey:
     key: str | None        # None = 未找到
     source: str
     ok: bool
+    #: 密钥**明显不像密钥**的原因(`key_problem()` 给的),否则 None。
+    #: 保留 `ok=True`(密钥来源存在、provider 仍可被选中),但请求前会据此报清楚。
+    problem: str | None = None
 
     def describe(self) -> str:
         if self.source == "none":
             return "无需密钥(本地 provider)"
+        if self.problem:
+            return f"无效:{self.problem}({self.source})"
         if self.ok:
             return f"{self.source}({self.key[:6]}…)" if self.key else self.source
         return f"缺失({self.source})"
 
 
+def key_problem(key: str) -> str | None:
+    """显然不能当 API key 的值 → 一句人话(否则 None)。
+
+    HTTP 头只能装 ASCII,所以含非 ASCII 的密钥一定会在请求时炸成
+    `'ascii' codec can't encode …: InternalServerError` —— 而那时离“输入”已经很远了。
+    空白/换行同理(真密钥里不会有空格)。最常见的来源是**误粘贴**:把一段提示/日志
+    粘进了密钥输入框。所以宁在入口就拦下。
+    """
+    if not key or not key.strip():
+        return "是空的"
+    if any(ord(ch) > 127 for ch in key):
+        return "含非 ASCII 字符(多半是把别的内容粘贴进来了)"
+    if any(ch.isspace() for ch in key):
+        return "含空白字符"
+    return None
+
+
 class AuthStore:
     """`~/.qi/agent/auth.json`:按 provider 存 {type:api_key, key:…},权限 0600。"""
 
@@ -155,6 +177,14 @@ class AuthStore:
             os.chmod(self.path, 0o600)
 
     def set_key(self, provider: str, key: str) -> None:
+        """存一个 API key。**显然不是密钥的值直接拒绝**(`ValueError`)。
+
+        在入口拦(而不是等到请求时):非 ASCII / 带空格的密钥不可能是真的,而它一旦落盘,
+        失败会拖到某个回合才以 `InternalServerError: 'ascii' codec …` 的形式暴露。
+        """
+        problem = key_problem(key)
+        if problem:
+            raise ValueError(f"{provider} 的 API key {problem}")
         data = self.load()
         data[provider] = {"type": "api_key", "key": key}
         self.save(data)
@@ -196,18 +226,24 @@ def resolve_key(provider: str, api_key_ref: str | None = None,
     1. auth store → 2. 约定环境变量 → 3. provider apiKey 引用。
     """
     store = store or AuthStore()
+
+    def _found(key: str, source: str) -> ResolvedKey:
+        # 来源存在 → `ok=True`(provider 仍可被选中);但“不像密钥”要在 `problem` 里留下,
+        # 让请求前能报“你的 key 有问题”,而不是拖到 HTTP 头编码失败。
+        return ResolvedKey(key=key, source=source, ok=True, problem=key_problem(key))
+
     stored = store.get(provider)
     if stored:
-        return ResolvedKey(key=stored, source="auth", ok=True)
+        return _found(stored, "auth")
     default_env = DEFAULT_API_KEY_ENV.get(provider)
     if default_env:
         value = os.environ.get(default_env)
         if value:
-            return ResolvedKey(key=value, source=f"env:{default_env}", ok=True)
+            return _found(value, f"env:{default_env}")
     if api_key_ref:
         value = resolve_value(api_key_ref)
         if value:
-            return ResolvedKey(key=value, source=f"config:{api_key_ref}", ok=True)
+            return _found(value, f"config:{api_key_ref}")
         return ResolvedKey(key=None, source=f"config:{api_key_ref}(未解析)", ok=False)
     if default_env:
         return ResolvedKey(key=None, source=f"env:{default_env}(未设置)", ok=False)

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/cli.py

@@ -842,14 +842,19 @@ def list_extensions() -> None:
         console.print("[dim]没有已装扩展,settings.packages 里也没有声明。[/dim]")
         console.print(f"[dim]装法:uv tool install {HOST_DISTRIBUTION} --with qi-mcp[/dim]")
         return
-    declared_names = {item.name for item in report.declared}
+    declared_by = {item.name: item for item in report.declared}
     table = Table(title="扩展")
     table.add_column("扩展"); table.add_column("通道"); table.add_column("版本")
     table.add_column("来源"); table.add_column("声明")
     for item in report.installed:
+        decl = declared_by.get(item.name)
+        if decl is None:
+            mark = "否"
+        else:
+            # 声明**写在哪一级**(user = `~/.qi/agent/settings.json`;project = `<git根>/.qi/settings.json`)
+            mark = f"是({' + '.join(decl.scopes)})" if decl.scopes else "是"
         table.add_row(item.name, item.channel, item.version or "—",
-                      f"{item.origin} · {item.scope}",
-                      "是" if item.name in declared_names else "否")
+                      f"{item.origin} · {item.scope}", mark)
     for decl in report.missing:            # 声明了却加载不到 —— 单独一行,不混进已装列表
         table.add_row(decl.name, decl.channel, "—", f"{decl.spec} · {decl.source}", "未安装")
     console.print(table)
@@ -1388,7 +1393,11 @@ def auth_login(provider: str = typer.Argument(...)) -> None:
     provider = provider.strip().lower()
     key = prompt.text(f"{provider} API key", required=True)
     store = AuthStore()
-    store.set_key(provider, key)
+    try:
+        store.set_key(provider, key)
+    except ValueError as exc:              # 显然不是密钥(误粘贴)→ 入口就拦
+        err_console.print(f"[red]{escape(str(exc))}[/red]")
+        raise typer.Exit(code=2) from exc
     console.print(f"[green]已保存 {provider} 到 {store.path}(0600): [/green]{escape(_mask(key))}")
 
 
@@ -1657,8 +1666,13 @@ def _configure_provider(provider: str, entry: dict) -> None:
     key = prompt.text(f"{provider} API key", suffix=suffix,
                       required=not current_key and not env_name)
     if key:
-        store.set_key(provider, key)
-        current_key = key
+        try:
+            store.set_key(provider, key)
+        except ValueError as exc:              # 显然不是密钥(误粘贴)
+            console.print(f"[red]{escape(str(exc))}[/red]")
+            key = ""
+        else:
+            current_key = key
     shown = _mask(current_key) if current_key else (
         f"${env_name}(环境变量)" if env_name else "(未设置)")
     summary = f"[green]✓[/green] {provider} — API Key: {escape(shown)}"
@@ -1860,7 +1874,11 @@ def _init_noninteractive(*, provider: str | None, model: str | None, base_url: s
 
     store = AuthStore()
     if api_key:
-        store.set_key(provider, api_key)
+        try:
+            store.set_key(provider, api_key)
+        except ValueError as exc:              # 显然不是密钥(误粘贴)
+            err_console.print(f"[red]{escape(str(exc))}[/red]")
+            raise typer.Exit(code=2) from exc
     elif api_key_env:
         entry["apiKey"] = f"${api_key_env}"
     elif not entry.get("apiKey") and not store.get(provider):

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/llm.py

@@ -315,6 +315,30 @@ def _as_int(value: Any, default: int = 0) -> int:
         return default
 
 
+class ProviderAuthError(RuntimeError):
+    """凭证侧可解释的失败(密钥不像密钥 / 请求头装不下)。
+
+    存在的理由:底层 litellm 把这种错误包成
+    `InternalServerError: … 'ascii' codec can't encode …`,**看不出是 API key 的问题**。
+    在请求前/请求时把它翻成一句直接指向凭证的话。
+    """
+
+
+def friendly_provider_error(exc: Exception) -> Exception:
+    """把 provider 侧那句只有工程师看得懂的底层错误,翻成带下一步动作的。
+
+    命中 `'ascii'/'latin-1' codec can't encode`:HTTP 头/URL 装不下这个值 —— 最常见的就是
+    API key 里混入了非 ASCII 字符(把一段中文提示误粘贴进了密钥框)。
+    """
+    text = str(exc)
+    if "'ascii' codec can't encode" in text or "'latin-1' codec can't encode" in text:
+        return ProviderAuthError(
+            "请求头里有非 ASCII 字符(HTTP 头只能是 ASCII)—— 最常见的是 **API key 里混入了"
+            "中文/全角字符**(比如误把一段提示粘进了密钥框)。检查 `qi auth list`、对应的"
+            "环境变量(如 `DEEPSEEK_API_KEY`)、以及 `models.json` 里的 `apiKey` 来源。")
+    return exc
+
+
 class LiteLLMClient:
     """基于 litellm 的实现。spec 来自 resolve_model()(经 resolve_key 取 key)。"""
 
@@ -389,6 +413,13 @@ class LiteLLMClient:
     def _base_kwargs(self, messages: list[ChatMessage], tools: list[dict] | None,
                      temperature: float | None) -> dict:
         """chat 与 astream 共用的请求参数(避免两处漂移)。"""
+        if self._resolved.problem:
+            # 在发请求**之前**就报 —— 否则要拖到 litellm 拼 `Authorization: Bearer …`
+            # 时以 `'ascii' codec can't encode` 暴露,看不出是 key 的问题。
+            raise ProviderAuthError(
+                f"{self.spec.provider} 的 API key {self._resolved.problem}"
+                f"(来源:{self._resolved.source})。HTTP 头只能是 ASCII,这个值发不出去 —— "
+                f"重新登录(如 `qi auth login {self.spec.provider}`)或修正该来源。")
         kwargs: dict = {
             "model": self.model_name,
             "messages": [m.to_dict() for m in messages],
@@ -467,7 +498,7 @@ class LiteLLMClient:
             resp = await litellm.acompletion(**kwargs)
         except Exception as exc:
             if not self._consider_reasoning_rejection(exc):
-                raise
+                raise friendly_provider_error(exc) from exc
             # 去掉 reasoning_effort 重试一次(用户只想调级别,不该因此整轮失败)
             kwargs = await self._prepare_headers(
                 await self._prepare_request(self._base_kwargs(messages, tools, temperature)))
@@ -522,6 +553,9 @@ class LiteLLMClient:
             try:
                 return await self._open_stream(messages, tools, temperature, with_usage)
             except Exception as exc:  # noqa: BLE001 打开流失败:逐项降级
+                friendly = friendly_provider_error(exc)
+                if isinstance(friendly, ProviderAuthError):
+                    raise friendly from exc      # 凭证问题不该被当成“参数不被接受”吞掉
                 if self._consider_reasoning_rejection(exc):
                     continue
                 if with_usage:
@@ -582,10 +616,10 @@ class LiteLLMClient:
                     yield LLMDelta(text=text)
                 for tc in getattr(delta_obj, "tool_calls", None) or []:
                     merge_tool_call_delta(merged, tc)
-        except Exception:
+        except Exception as exc:
             # 首片就失败 → 可安全降级;已吐过字/思考 → 不能重试(会重复输出)
             if content_seen:
-                raise
+                raise friendly_provider_error(exc) from exc
             self._stream_broken = True
             async for delta in chat_as_stream(self, messages, tools, temperature):
                 yield delta

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/runtime.py

@@ -60,7 +60,7 @@ from .session import (MODEL_CHANGE, THINKING_LEVEL_CHANGE, Session, SessionStore
 from .titling import suggest_title
 from .settings import (default_tools, extension_dirs, load_settings, load_settings_by_scope,
                        branch_summary_skip_prompt, model_thinking_level,
-                       resolve_project_trust, session_dir)
+                       project_declared_default_trust, resolve_project_trust, session_dir)
 from .tools import ToolContext, register_builtin_tools
 from .tools.shell import session_env
 
@@ -282,8 +282,7 @@ class QiRuntime:
         #: 与 `_level_pins` 分开:那是会话级的,这个是**整场运行**的。
         #: 命令行给的值是当次显式覆盖,不该被会话里记的旧值顶掉(与 `_model_pinned` 对称)。
         self._level_pinned_cli = False
-        declared_by_repo = (getattr(scopes.get("project"), "defaultProjectTrust", None)
-                            or "").strip()
+        declared_by_repo = project_declared_default_trust(self.cwd) or ""
         if declared_by_repo:
             # 不静默:一个仓库自称可信是值得报警的事
             self.notes.append(

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/settings.py

@@ -410,6 +410,22 @@ def project_trust_default(settings: QiSettings) -> str:
     return value if value in ("ask", "always", "never") else "ask"
 
 
+def project_declared_default_trust(cwd: Path | None = None) -> str | None:
+    """项目级 `settings.json` **原始文件**里显式写的 `defaultProjectTrust`(没写 → None)。
+
+    为什么不能直接读解析后的 `QiSettings`:那个字段默认值就是 `"ask"`,`getattr` 分不出
+    “没写”与“写了 ask” —— 会把**任何**有 `.qi/settings.json` 的仓库都误报成“仓库自称可信”。
+    """
+    for path, scope in settings_file_candidates(cwd):
+        if scope != "project":
+            continue
+        if not path.is_file():
+            return None
+        value = read_json(path).get("defaultProjectTrust")
+        return str(value).strip() if value is not None else None
+    return None
+
+
 def resolve_project_trust(settings: QiSettings | None, *,
                           approve: bool | None = None,
                           has_ui: bool = False,

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/src/qi_agent/tui.py

@@ -3298,7 +3298,10 @@ class QiTui(App):
         return self._editor_component_factory
 
     def _append(self, widget) -> None:
-        log = self.query_one("#log", VerticalScroll)
+        try:
+            log = self.query_one("#log", VerticalScroll)
+        except (NoMatches, ScreenStackError):
+            return                  # 卸载竞态:worker 在 teardown 之后才报错,没地方可写
         if len(log.children):
             log.mount(Blank())
         log.mount(widget)
@@ -4726,6 +4729,9 @@ class QiTui(App):
         except OSError as exc:                 # 读/写盘失败(权限、只读 home…)
             self._note(f"写凭证失败: {exc}", "error")
             return
+        except ValueError as exc:              # 显然不是密钥(误粘贴)→ 入口就拦
+            self._note(f"没保存:{exc}。重新 `/login` 粘贴正确的 API key。", "error")
+            return
         self._note(f"已保存 {provider} 的 API key → {store.path}(0600)", "info")
         if provider in self._preset_providers():
             self._note(f"{provider} 来自**预置**(models.json 里没写,qi 的内置表兜底);"

qi_coding_agent-0.2.1/tests/test_auth_key.py

@@ -0,0 +1,96 @@
+"""API key 入口校验:显然不是密钥的值在**写入时**就拒绝。
+
+真实事故:把一段中文提示误粘贴进了 `/login` 的密钥框、落进 `auth.json`;之后某个回合
+才以 `InternalServerError: 'ascii' codec can't encode characters in position 7-13`
+暴露 —— 离“输入”已经很远(litellm 拼出 `Authorization: Bearer 检测到角色目录…`)。
+所以校验放在 `AuthStore.set_key`,而不是等请求时。
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+
+import pytest  # noqa: E402
+
+from qi_agent.auth import AuthStore, key_problem  # noqa: E402
+
+
+def test_key_problem_accepts_real_looking_keys():
+    assert key_problem("sk-abc123-XYZ_09.+/=") is None
+    assert key_problem("ghp_" + "a" * 40) is None
+
+
+@pytest.mark.parametrize("bad", [
+    "", "   ",
+    "sk-a b",                                   # 空格
+    "sk-a\nb",                                  # 换行
+    "检测到角色目录(/x)但没有任何扩展读取它",     # 误粘贴的中文提示
+    "sk-键",                                    # 单个非 ASCII 字符
+])
+def test_key_problem_rejects_obvious_non_keys(bad):
+    assert key_problem(bad)
+
+
+def test_set_key_refuses_a_pasted_warning(tmp_path):
+    store = AuthStore(tmp_path / "auth.json")
+    with pytest.raises(ValueError):
+        store.set_key("deepseek", "检测到角色目录(/x)但没有任何扩展读取它")
+    assert not (tmp_path / "auth.json").exists(), "被拒的值不该落盘"
+
+
+def test_set_key_still_stores_a_real_looking_key(tmp_path):
+    store = AuthStore(tmp_path / "auth.json")
+    store.set_key("deepseek", "sk-real-key")
+    assert store.get("deepseek") == "sk-real-key"
+
+
+def test_resolve_key_flags_an_already_stored_bad_key(tmp_path):
+    """旧版本/手工编辑落下的坏值:解析时不隐藏 provider,但把问题标出来。"""
+    from qi_agent.auth import resolve_key
+
+    store = AuthStore(tmp_path / "auth.json")
+    store.save({"deepseek": {"type": "api_key", "key": "sk-中文"}})
+    rk = resolve_key("deepseek", store=store)
+    assert rk.ok and rk.key == "sk-中文"          # 来源还在 → 仍可被选中/诊断
+    assert rk.problem and "非 ASCII" in rk.problem
+    assert "无效" in rk.describe()
+
+
+@pytest.mark.asyncio
+async def test_client_refuses_a_bad_key_before_the_request(tmp_path):
+    """请求**之前**就报“你的 key 有问题”,而不是等 provider 侧的 ascii 错误。"""
+    from qi_agent.config import ResolvedModel
+    from qi_agent.llm import ChatMessage, LiteLLMClient, ProviderAuthError
+
+    store = AuthStore(tmp_path / "auth.json")
+    store.save({"deepseek": {"type": "api_key", "key": "检测到角色目录(误粘贴)"}})
+    spec = ResolvedModel(provider="deepseek", model="deepseek-chat", api="openai-completions",
+                         base_url=None, api_key_ref=None, reasoning=False,
+                         context_window=8192, max_tokens=1024)
+    client = LiteLLMClient(spec, store)
+    with pytest.raises(ProviderAuthError) as excinfo:
+        await client.chat([ChatMessage(role="user", content="hi")])
+    msg = str(excinfo.value)
+    assert "API key" in msg and "deepseek" in msg and "auth" in msg
+
+
+def test_friendly_provider_error_translates_the_ascii_codec_failure():
+    """底层那句 `'ascii' codec …` 要翻成直接指向凭证的话。"""
+    from qi_agent.llm import ProviderAuthError, friendly_provider_error
+
+    raw = RuntimeError(
+        "litellm.InternalServerError: InternalServerError: OpenAIException - "
+        "'ascii' codec can't encode characters in position 7-13: ordinal not in range(128)")
+    friendly = friendly_provider_error(raw)
+    assert isinstance(friendly, ProviderAuthError)
+    assert "API key" in str(friendly)
+
+
+def test_friendly_provider_error_leaves_other_errors_alone():
+    from qi_agent.llm import friendly_provider_error
+
+    raw = RuntimeError("connection reset")
+    assert friendly_provider_error(raw) is raw

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/tests/test_cli_install.py

@@ -444,3 +444,36 @@ def test_installer_cmd_strips_yes_for_uv_uninstall(tmp_path, monkeypatch):
     cmd = cli_mod._installer_cmd(["uninstall", "-y", "qi-mcp"])
     assert cmd == ["/usr/bin/uv", "pip", "uninstall", "--python",
                    str(root / "bin" / "python"), "qi-mcp"]
+
+
+# ── qi list:声明写在哪一级 ────────────────────────────────────────────
+
+
+def test_list_shows_the_declaring_scope(tmp_path, monkeypatch):
+    """`声明` 列要能看出用户级还是项目级 —— 否则和「来源·env」混在一起看不出写在哪。"""
+    from qi_agent.packages import DeclaredPackage, InstalledExtension, PackageReport
+
+    report = PackageReport(
+        installed=[InstalledExtension("qi-mcp", "pip", "qi-mcp 0.1.1", "env")],
+        declared=[DeclaredPackage("qi_mcp-0.1.1.tar.gz", "qi-mcp", "pip",
+                                  "settings:project", requirement="qi_mcp-0.1.1.tar.gz",
+                                  scopes=("project",))],
+    )
+    monkeypatch.setattr(cli_mod, "package_report", lambda cwd=None: report)
+    res = runner.invoke(app, ["list"])
+    assert res.exit_code == 0, res.output
+    assert "是(project)" in res.output
+
+
+def test_list_shows_both_scopes_when_declared_twice(tmp_path, monkeypatch):
+    from qi_agent.packages import DeclaredPackage, InstalledExtension, PackageReport
+
+    report = PackageReport(
+        installed=[InstalledExtension("qi-mcp", "pip", "qi-mcp 0.1.1", "env")],
+        declared=[DeclaredPackage("qi-mcp", "qi-mcp", "pip", "settings:project",
+                                  scopes=("user", "project"))],
+    )
+    monkeypatch.setattr(cli_mod, "package_report", lambda cwd=None: report)
+    res = runner.invoke(app, ["list"])
+    assert res.exit_code == 0, res.output
+    assert "是(user + project)" in res.output

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/tests/test_trust_scope.py

@@ -70,6 +70,17 @@ def test_repo_cannot_declare_itself_trusted(tmp_path, monkeypatch):
     assert any("defaultProjectTrust" in n and "已忽略" in n for n in rt.notes), rt.notes
 
 
+def test_project_settings_without_the_key_does_not_warn(tmp_path, monkeypatch):
+    """回归:`QiSettings.defaultProjectTrust` 的默认值就是 `"ask"`,不能用 getattr 判“写没写”。
+
+    否则**任何**有 `.qi/settings.json` 的仓库(哪怕只是写了 `packages`)都会被误报成
+    “项目 settings 里写了 defaultProjectTrust=ask”。
+    """
+    project = _env(tmp_path, monkeypatch, user={}, project={"packages": ["qi-mcp"]})
+    rt = _runtime(project)
+    assert not any("已忽略" in n for n in rt.notes), rt.notes
+
+
 def test_user_level_always_still_trusts(tmp_path, monkeypatch):
     """正当路径不能被误伤:用户在**自己家里**表态就生效。"""
     project = _env(tmp_path, monkeypatch, user={"defaultProjectTrust": "always"})

{qi_coding_agent-0.2.0 → qi_coding_agent-0.2.1}/tests/test_tui_no_model.py

@@ -160,3 +160,28 @@ def test_headless_runtime_still_requires_a_default_model(tmp_path, monkeypatch):
     project = _env(tmp_path, monkeypatch)
     with pytest.raises(ConfigError):
         QiRuntime(cwd=project)                         # has_ui 默认 False
+
+
+@pytest.mark.asyncio
+async def test_login_refuses_a_pasted_warning_instead_of_a_key(tmp_path, monkeypatch):
+    """误把一段中文提示粘进密钥框:入口就拒绝,不落盘、不选中模型。
+
+    落盘的后果是**很晚**才以 `InternalServerError: 'ascii' codec …` 暴露。
+    """
+    _env(tmp_path, monkeypatch)
+
+    app = tui_mod.QiTui(palette=PALETTE, approve_project=True)
+
+    async def fake_screen(screen):
+        return "检测到角色目录(/x)但没有任何扩展读取它 —— 这些角色不会被使用"
+
+    async with app.run_test(size=(100, 30)) as pilot:
+        await pilot.pause(0.3)
+        app.await_screen = fake_screen                 # type: ignore[method-assign]
+        app._command("/login deepseek")
+        await app.workers.wait_for_complete()
+        await pilot.pause(0.2)
+
+        assert app._model is None, "拒绝之后不该选中任何模型"
+        assert "没保存" in _log_text(app)
+        assert not (tmp_path / "home" / "auth.json").exists(), "被拒的值不该落盘"