u1s1-cli-cn 0.0.0-stage → 1.15.2

package/README.md

@@ -1,3 +1,72 @@
-# Temporary Holding Version
+# u1s1 — 有一说一,最省心的 AI 编程搭子
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在终端里用中文说需求,AI 帮你读文件、改代码、跑命令。不用买模型、不用配 API、不用懂那些名词,默认 DeepSeek Flash **每天免费 $2**(北京时间 0 点恢复),新用户另送一次性 $10 加量。
+
+## 三步开始
+
+### 🚀 一键安装(推荐)
+不需要提前装任何东西,复制下面一行到终端粘贴运行:
+
+**Linux / macOS**
+```bash
+curl -fsSL https://u1s1app.com/releases/install.sh | bash
+```
+
+**Windows**
+```powershell
+powershell -c "irm https://u1s1app.com/releases/install.ps1 | iex"
+```
+
+脚本会自动帮你安装 Node.js 和 u1s1,一行搞定。
+
+### 或者,手动安装(需要 Node.js 20+)
+```bash
+npm i -g u1s1-cli-cn
+```
+
+### 安装好后
+```bash
+# 第一次运行会引导你去 u1s1app.com 注册领 Key(30 秒,不用绑卡)
+u1s1
+
+# 进到你的项目文件夹,像发微信一样说需求
+cd 我的项目
+u1s1
+```
+
+## 常用命令
+
+| 命令 | 作用 |
+|---|---|
+| `u1s1` | 进入交互模式,直接开聊 |
+| `u1s1 -p "把 README 里的错别字修一下"` | 一句话模式,干完就退出 |
+| `u1s1 usage` | 看额度用了多少 |
+| `u1s1 model` | 看/切默认模型:`u1s1 model grok` 切 Grok 4.6,`u1s1 model deepseek` 切回(对话里 `/model` 同样会记住) |
+| `u1s1 update` | 升级 u1s1 到最新版 |
+| `u1s1 import` | 从 Claude Code / Codex 导入历史对话,之后 `/resume` 就能接着聊 |
+| `u1s1 login` / `u1s1 logout` | 登录 / 退出 |
+
+## 长会话自动压缩
+
+对话越长，每一轮上传的历史越多，回复会变慢、也更容易出错。u1s1 会在上下文接近 **200K token** 时自动压缩（把早期对话浓缩成摘要，最近 2 万 token 原文保留），压缩时界面有提示；`/context` 可以随时看当前占用、预算和触发点，`/compact` 可以手动压缩。
+
+这只改变压缩时机，不改变模型能力。想调整或关闭，编辑 `~/.u1s1/agent/settings.json`：
+
+```json
+{ "compaction": { "maxContextTokens": 200000 } }
+```
+
+`0` 表示不限（按模型自身窗口，如 DeepSeek Flash 的 1M）。改完重启 u1s1 生效。
+
+## 在终端粘贴图片
+
+默认模型 DeepSeek Flash 支持视觉输入，复制截图或图片后，在 u1s1 输入框按 `Ctrl+V` 即可附加图片。macOS 这里也使用 `Ctrl+V`；`Cmd+V` 由 Terminal/iTerm 接管，只适合粘贴文本，无法把剪贴板图片交给 CLI。
+
+## 有一说一
+
+- **背后模型**:默认 DeepSeek Flash(1M 上下文,每天免费 $2);难题可随时 `u1s1 model grok` 切 Grok 4.6。对话里 `/model` 也会记住,下次启动还是这个。
+- **怎么收费**:DeepSeek Flash 每天有 $2 免费用量,北京时间 0 点恢复且不累计。免费用完或切换其他模型后,按 API 实际成本从永久余额扣,不加价;新用户另送一次性 $10 加量。
+- **额度不够**:邀请朋友,你俩各得 $1 永久加量 → [u1s1app.com/dashboard](https://u1s1app.com/dashboard)
+- **内核**:基于开源的 [pi](https://pi.dev) coding agent,会话管理、斜杠命令、皮肤等能力全都有。
+
+官网:[u1s1app.com](https://u1s1app.com)

package/bench/suite.json

@@ -0,0 +1,193 @@
+[
+  {
+    "name": "quick",
+    "description": "快速烟雾测试 — 几秒钟测完,日常切模型后随手验证",
+    "questions": [
+      {
+        "id": "hello",
+        "category": "基础",
+        "prompt": "只说一句「你好,我是 u1s1」就行,不要多余的话。",
+        "maxScore": 5,
+        "checks": [
+          { "type": "contains", "value": "你好", "ignoreCase": false, "points": 2, "description": "包含「你好」" },
+          { "type": "contains", "value": "u1s1", "ignoreCase": true, "points": 2, "description": "包含「u1s1」" },
+          { "type": "max_length", "value": 50, "points": 1, "description": "不超过 50 字(啰嗦扣分)" }
+        ]
+      },
+      {
+        "id": "reverse",
+        "category": "编码",
+        "prompt": "写一个 TypeScript 函数,把字符串里的单词顺序反转(不是字符反转)。示例: 'hello world' → 'world hello'。只给代码,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains_code_block", "value": true, "points": 2, "description": "包含代码块" },
+          { "type": "contains", "value": "reverse", "ignoreCase": false, "points": 2, "description": "函数名包含 reverse" },
+          { "type": "contains", "value": "split", "ignoreCase": false, "points": 2, "description": "用了 split" },
+          { "type": "contains", "value": "reverse(", "ignoreCase": false, "points": 2, "description": "调用了数组 reverse" },
+          { "type": "contains", "value": "join", "ignoreCase": false, "points": 2, "description": "用了 join" }
+        ]
+      }
+    ]
+  },
+  {
+    "name": "full",
+    "description": "全面评测 — 覆盖编程、推理、中文理解、指令遵循",
+    "questions": [
+      {
+        "id": "fizzbuzz",
+        "category": "编码",
+        "prompt": "用 TypeScript 写 fizzbuzz,从 1 到 100,3 的倍数打印 fizz,5 的倍数打印 buzz,同时是 3 和 5 的倍数打印 fizzbuzz。只给代码,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains_code_block", "value": true, "points": 1, "description": "包含代码" },
+          { "type": "contains", "value": "% 3", "ignoreCase": false, "points": 2, "description": "判断 3 的倍数" },
+          { "type": "contains", "value": "% 5", "ignoreCase": false, "points": 2, "description": "判断 5 的倍数" },
+          { "type": "contains", "value": "fizzbuzz", "ignoreCase": false, "points": 2, "description": "输出了 fizzbuzz" },
+          { "type": "contains", "value": "100", "ignoreCase": false, "points": 1.5, "description": "循环到 100" },
+          { "type": "not_contains", "value": "解释", "ignoreCase": true, "points": 1.5, "description": "没有多余解释" }
+        ]
+      },
+      {
+        "id": "sort-algo",
+        "category": "编码",
+        "prompt": "用 TypeScript 实现一个快速排序(原地排序,不创建新数组)。只给代码,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains_code_block", "value": true, "points": 1, "description": "包含代码" },
+          { "type": "contains", "value": "partition", "ignoreCase": false, "points": 2, "description": "实现了 partition 函数" },
+          { "type": "contains", "value": "pivot", "ignoreCase": false, "points": 2, "description": "选定了 pivot" },
+          { "type": "contains", "value": "quickSort", "ignoreCase": false, "points": 2, "description": "递归调用 quickSort" },
+          { "type": "not_contains", "value": "concat", "ignoreCase": false, "points": 2, "description": "不是非原地排序(没用 concat)" },
+          { "type": "not_contains", "value": "解释", "ignoreCase": true, "points": 1, "description": "没有多余解释" }
+        ]
+      },
+      {
+        "id": "react-component",
+        "category": "编码",
+        "prompt": "写一个 React 计数器组件(TypeScript),包含:+ 按钮、- 按钮、重置按钮,显示当前数值。用 useState。只给代码,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains_code_block", "value": true, "points": 1, "description": "包含代码" },
+          { "type": "contains", "value": "useState", "ignoreCase": false, "points": 2, "description": "用了 useState" },
+          { "type": "contains", "value": "button", "ignoreCase": true, "points": 1.5, "description": "包含按钮元素" },
+          { "type": "contains", "value": "+", "ignoreCase": false, "points": 1, "description": "有加号按钮" },
+          { "type": "contains", "value": "-", "ignoreCase": false, "points": 1, "description": "有减号按钮" },
+          { "type": "contains", "value": "重置", "ignoreCase": false, "points": 1.5, "description": "有重置按钮" },
+          { "type": "contains", "value": "React", "ignoreCase": true, "points": 1, "description": "导入 React" },
+          { "type": "contains", "value": "FC", "ignoreCase": false, "points": 1, "description": "用了 React.FC 类型" }
+        ]
+      },
+      {
+        "id": "regex",
+        "category": "编码",
+        "prompt": "写一个 JavaScript 正则表达式,匹配中国大陆手机号(11 位,1 开头,第二位 3-9)。只给正则,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "valid_regex", "value": true, "points": 3, "description": "正则语法有效" },
+          { "type": "contains", "value": "1[3-9]", "ignoreCase": false, "points": 3, "description": "匹配 1 开头+第二位 3-9" },
+          { "type": "contains", "value": "\\d{9}", "ignoreCase": false, "points": 2, "description": "匹配后 9 位数字" },
+          { "type": "contains", "value": "^", "ignoreCase": false, "points": 1, "description": "有开头锚点" },
+          { "type": "contains", "value": "$", "ignoreCase": false, "points": 1, "description": "有结尾锚点" }
+        ]
+      },
+      {
+        "id": "reasoning-1",
+        "category": "推理",
+        "prompt": "有三个箱子:一个只装苹果,一个只装橘子,一个混装。所有标签都贴错了。你只能从一个箱子里拿一个水果看,就能推断出所有箱子的正确内容。请问该从哪个箱子拿?为什么?",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains", "value": "混装", "ignoreCase": false, "points": 3, "description": "回答从混装箱拿" },
+          { "type": "contains", "value": "标签", "ignoreCase": false, "points": 2, "description": "提到标签贴错" },
+          { "type": "contains", "value": "推理", "ignoreCase": true, "points": 2, "description": "有推理过程" },
+          { "type": "min_length", "value": 100, "points": 3, "description": "解释够详细(>=100 字)" }
+        ]
+      },
+      {
+        "id": "reasoning-2",
+        "category": "推理",
+        "prompt": "一个人花 8 元买了一只鸡,9 元卖出,10 元买回,11 元卖出。他赚了多少钱?一步步算。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains", "value": "2", "ignoreCase": false, "points": 4, "description": "答案正确(赚 2 元)" },
+          { "type": "contains", "value": "8", "ignoreCase": false, "points": 1.5, "description": "提到了 8 元买入" },
+          { "type": "contains", "value": "11", "ignoreCase": false, "points": 1.5, "description": "提到了 11 元卖出" },
+          { "type": "contains", "value": "利润", "ignoreCase": true, "points": 1.5, "description": "有利润计算过程" },
+          { "type": "min_length", "value": 80, "points": 1.5, "description": "有分步计算过程" }
+        ]
+      },
+      {
+        "id": "zh-explain",
+        "category": "中文",
+        "prompt": "用一句话给完全不懂编程的人解释什么是「递归」。说得通俗一点。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains", "value": "套娃", "ignoreCase": false, "points": 3, "description": "用了套娃类比(通俗)" },
+          { "type": "min_length", "value": 20, "points": 2, "description": "不是敷衍(>=20 字)" },
+          { "type": "max_length", "value": 200, "points": 2, "description": "真的是一句话(<=200 字)" },
+          { "type": "not_contains", "value": "函数调用", "ignoreCase": true, "points": 1.5, "description": "没用编程术语" },
+          { "type": "not_contains", "value": "递归调用", "ignoreCase": true, "points": 1.5, "description": "没递归解释递归(循环定义)" }
+        ]
+      },
+      {
+        "id": "zh-poem",
+        "category": "中文",
+        "prompt": "以「AI」为主题写一首五言绝句(每句五个字,共四句)。只给诗句,不要解释。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "has_chinese", "value": true, "points": 2, "description": "包含中文" },
+          { "type": "line_count_5chars", "value": 4, "points": 4, "description": "四句每句五字" },
+          { "type": "contains", "value": "AI", "ignoreCase": true, "points": 2, "description": "主题相关" },
+          { "type": "max_length", "value": 100, "points": 2, "description": "没有多余解释" }
+        ]
+      },
+      {
+        "id": "instruction-follow",
+        "category": "指令遵循",
+        "prompt": "你的回答里只能包含以下三个词(可以重复):好、的、行。其他任何词都不许出现。开始:今天天气怎么样?",
+        "maxScore": 10,
+        "checks": [
+          { "type": "allowed_words_only", "value": ["好", "的", "行"], "points": 8, "description": "只用了允许的词" },
+          { "type": "min_length", "value": 1, "points": 2, "description": "有实际回答(没沉默)" }
+        ]
+      },
+      {
+        "id": "format-json",
+        "category": "指令遵循",
+        "prompt": "输出一个 JSON 对象,包含 name(你的名字)、version(当前日期)、models(数组,随便列三个模型名)。只输出 JSON,不要 markdown 代码块标记。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "parse_json", "value": true, "points": 4, "description": "能解析为合法 JSON" },
+          { "type": "has_json_key", "value": "name", "points": 1.5, "description": "包含 name 字段" },
+          { "type": "has_json_key", "value": "version", "points": 1.5, "description": "包含 version 字段" },
+          { "type": "has_json_key", "value": "models", "points": 1.5, "description": "包含 models 字段" },
+          { "type": "not_contains", "value": "```", "ignoreCase": false, "points": 1.5, "description": "没包在 markdown 代码块里" }
+        ]
+      },
+      {
+        "id": "context-length",
+        "category": "长上下文",
+        "prompt": "请重复以下句子 50 遍:「u1s1 有一说一。」然后告诉我你一共输出了多少遍。",
+        "maxScore": 10,
+        "checks": [
+          { "type": "contains", "value": "50", "ignoreCase": false, "points": 4, "description": "输出了 50 遍(或声明了 50)" },
+          { "type": "contains", "value": "u1s1 有一说一", "ignoreCase": true, "points": 3, "description": "内容包含 u1s1 有一说一" },
+          { "type": "min_length", "value": 200, "points": 3, "description": "长度足够(>=200 字符)" }
+        ]
+      },
+      {
+        "id": "translation",
+        "category": "翻译",
+        "prompt": "把这句话翻译成地道的中文: 'One should always code as if the person who ends up maintaining your code is a violent psychopath who knows where you live.'",
+        "maxScore": 10,
+        "checks": [
+          { "type": "has_chinese", "value": true, "points": 2, "description": "输出是中文" },
+          { "type": "contains", "value": "暴力", "ignoreCase": false, "points": 2, "description": "翻出了 violent" },
+          { "type": "contains", "value": "代码", "ignoreCase": false, "points": 2, "description": "翻出了 code" },
+          { "type": "contains", "value": "维护", "ignoreCase": false, "points": 2, "description": "翻出了 maintaining" },
+          { "type": "contains", "value": "你", "ignoreCase": false, "points": 1, "description": "翻出了 you" },
+          { "type": "contains", "value": "住", "ignoreCase": false, "points": 1, "description": "翻出了 where you live" }
+        ]
+      }
+    ]
+  }
+]

package/dist/agent-setup.d.ts

@@ -0,0 +1,169 @@
+import { type CliConfig, type CustomEndpoint, type ModelDef, type ThinkingLevel } from "./config.js";
+import type { ShellDoctorResult } from "./shell-doctor.js";
+import type { Site } from "./site.js";
+/**
+ * 系统提示里的品牌人设。中国站面向编程新手、兜底语言中文(保持原文一字不差);
+ * 国际站面向开发者、兜底语言英文。按站点而不是界面语言判定,用时求值(配置可能晚于 import 才读)。
+ */
+export declare function brandAppend(site?: Site): string;
+/** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
+export declare function ensureBrandPrompt(shell: ShellDoctorResult): void;
+/**
+ * Seed per-model defaults without overwriting a user's Ctrl+S choice. The
+ * marker records values managed by u1s1, so a later Gateway default can update
+ * them while a diverged user value becomes user-owned.
+ */
+export declare function applyModelThinkingDefaults(settings: Record<string, unknown>, models: ModelDef[]): boolean;
+/** pi 1.0 的 DEFAULT_TOOL_NAMES(未导出,测试里对过 pi 源码)。 */
+export declare const PI_DEFAULT_TOOL_NAMES: string[];
+/**
+ * pi 内置 codemode 默认不开,u1s1 给每个用户开一次。标记写下后不再碰:用户删掉
+ * codemode 都算用户的选择。写成完整工具名列表而不是 `+codemode`,原因见
+ * normalizeDefaultTools。
+ */
+export declare function applyCodemodeDefault(settings: Record<string, unknown>): boolean;
+/**
+ * 每次启动把 defaultTools 里的 `+name` / `-name` 按 pi 1.0 的规则展开成完整工具名列表。
+ * Desktop App ≤0.1.23 内置的 pi 0.87.1 和 CLI 共用这份 settings.json,它不认增减写法,
+ * 会把 `["+codemode"]` 当成「只开一个叫 +codemode 的工具」,结果旧对话一个工具都没有。
+ * 展开后 pi 1.0 解析结果不变(项目级的 +/- 照样叠在上面),旧版也能读懂;
+ * 1.13.0 写下的 `["+codemode"]` 由此修复。
+ */
+export declare function normalizeDefaultTools(settings: Record<string, unknown>): boolean;
+/**
+ * pi 1.0 内置 llama.cpp 扩展(本地模型 provider + /llama),u1s1 走网关用不上,默认关一次。
+ * 用户在 extensions 里自己写过 builtin:llama.cpp 的任何开关就不动;标记写下后同样不再碰。
+ */
+export declare function applyLlamaDisabledDefault(settings: Record<string, unknown>): boolean;
+/**
+ * 恢复 Pi 默认界面:早先版本替用户写下 hideThinkingBlock=true(隐藏思考块)和
+ * clearOnShrink=true(精简 UI 配套),并用扩展把内置工具行渲染成 0 行。现在不再覆盖,
+ * 老用户 settings.json 里残留的这两个值要清一次,否则升级后仍看不到思考块。
+ * 无法区分「u1s1 写的」和「用户后来自己选的」,所以全员只重置这一次;标记写下后
+ * 用户再在 /settings 里选的值就不会被动了。
+ */
+export declare function applyNativeUiRestore(settings: Record<string, unknown>): boolean;
+/** Defaults that don't overwrite values the user already set. */
+export declare function ensureDefaultSettings(models?: ModelDef[]): void;
+/** ≤0.4.0 wrote u1s1-dark/u1s1-light into the pi themes dir; remove them. */
+export declare function cleanupBrandThemes(): void;
+/**
+ * u1s1 provider for SDK-based frontends (Desktop App): pi composes
+ * <agentDir>/models.json above registered providers, so this exposes the same
+ * models as the TUI's in-process extension without patching the frontend.
+ * apiKey stays an env reference — the launcher sets U1S1_API_KEY, the file
+ * itself holds no secret. Rewritten on every launch so baseUrl/model changes
+ * propagate; other providers a user may have added are preserved.
+ */
+/**
+ * 联网工具经 <agentDir>/extensions 投影:pi 的资源加载器对 TUI 和 Desktop App
+ * 都会扫描这个目录,两个前端从此共用同一份工具注册,不用各接一遍。
+ * 文件每次启动重写(baseUrl/服务端开关变化随之生效);apiKey 走 U1S1_API_KEY
+ * 环境变量,文件里不落密钥。U1S1_TOOLS_VIA_EXTENSION 守卫:旧版 CLI 仍在
+ * 进程内注册工具且不设该变量,残留的本文件在旧版下自动空转,避免双重注册。
+ */
+export declare function writeWebToolsExtension(cfg: CliConfig, features: {
+    webSearch: boolean;
+    webFetchRender: boolean;
+    imageGen: boolean;
+}): void;
+/**
+ * 生成「错误信息人话化」扩展到 <agentDir>/extensions/u1s1-error-humanize.js:
+ * 把「429: {json}」形态的模型调用错误翻成中文正文 + 状态码尾巴,TUI 和
+ * Desktop App 共用(同 compact-ui 的投影机制)。实现见 error-humanize.ts,
+ * 分类兼容性(重试/配额/上下文超长)的约束也写在那里。
+ * import 失败时静默跳过——Desktop 独立运行时若指向的 CLI dist 已不存在,
+ * 宁可回到原始错误文本,也不能让扩展报错刷英文堆栈。
+ */
+export declare function writeErrorHumanizeExtension(): void;
+/**
+ * 生成「会话内公告触达」扩展到 <agentDir>/extensions/u1s1-announcements.js:
+ * 启动横幅只渲染一次公告,维护窗口里挂着会话的用户只会撞裸错误(审计 F14)。
+ * 轮询逻辑在 announcements-poll.ts(5 分钟一次、首拉只建基线不打扰);
+ * 公告变化时 appendEntry 进会话 + 尽力弹 notify。TUI 和 Desktop App 共用。
+ * print/json 一次性模式不起轮询;import 失败静默跳过(同 error-humanize)。
+ */
+export declare function writeAnnouncementsExtension(): void;
+/**
+ * 生成「自定义 MCP 服务」扩展到 <agentDir>/extensions/u1s1-mcp.js,只给没有内置 MCP 的
+ * 旧引擎用(Desktop App 的 pi-web-ui 还是 0.83):读 agent/mcp.json,把工具注册成
+ * mcp_<服务>_<工具>,逻辑在 mcp/extension.ts。pi ≥0.99 有 pi.registerMcpServer,说明内置
+ * MCP 会读同一份配置,扩展直接让位。投影前先把 ≤1.12 的 ~/.u1s1/mcp.json 迁过去。
+ * 子会话(spawn_subagent)里不挂 MCP 工具:避免每个子进程都拉起一份服务。
+ */
+export declare function writeMcpExtension(): void;
+/**
+ * 生成「OpenRouter 应用归因」扩展到 <agentDir>/extensions/u1s1-attribution.js。
+ * 用户自己配 OPENROUTER_API_KEY 直连时，pi 内置的归因头归到 pi.dev 名下（且受遥测
+ * 开关控制）；这里用 before_provider_headers 钩子覆盖为 u1s1，让这部分流量也计入
+ * u1s1 的 OpenRouter 公开排行与数据分析（openrouter.ai/docs/app-attribution）。
+ * 只在请求目标确认为 OpenRouter 时才改头，其它供应商不加多余头。
+ */
+export declare function writeAttributionExtension(site?: Site): void;
+/**
+ * 「精简 UI」扩展(u1s1-compact-ui.js)已下线:界面回到 Pi 默认——内置工具调用、思考块都按原样显示。
+ * 旧版本每次启动都把它写进 <agentDir>/extensions,Pi 会照单加载并继续隐藏工具行,
+ * 所以启动时要把残留文件删掉(Desktop App 共用同一个 agentDir,同样受益)。
+ */
+export declare function removeLegacyCompactUiExtension(outputDir?: string): void;
+/**
+ * 「界面文案」(斜杠命令补全描述、思考中提示)上一版投影成 <agentDir>/extensions/u1s1-ui-text.js,
+ * 用户带 --no-extensions 或在设置里禁用它时就失效;现在改由 pi.ts 的进程内扩展调用
+ * pi-ui-text.ts 的 registerUiText。启动时删掉残留文件,免得和进程内扩展各包一层
+ * (两层同时生效结果也正确,只是多余);Desktop App 共用 agentDir,它那里本来就是空转。
+ */
+export declare function removeLegacyUiTextExtension(outputDir?: string): void;
+/**
+ * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
+ * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。
+ * 这里补一条 u1s1 的 api_key 记录 —— key 用 $U1S1_API_KEY 环境变量引用,
+ * pi 的 resolveConfigValue 读取时才解析,文件本身不落密钥,和 models.json 同款。
+ * 其他 provider 的凭据原样保留;文件损坏时不动它,交给 SDK 自己报错。
+ */
+export declare function ensureAuthCredential(): void;
+/**
+ * pi provider 条目里的模型形状(models.json 与 registerProvider 共用)。
+ * contextWindow 不是模型真实窗口而是自动压缩预算(见 effectiveContextWindow):
+ * options.maxContextTokens 显式传 undefined 表示「用户没设」(测试用),不传则读 settings.json。
+ */
+export declare function toProviderModels(models: ModelDef[], options?: {
+    maxContextTokens?: number;
+}): {
+    id: string;
+    name: string;
+    reasoning: boolean;
+    thinkingLevelMap?: Partial<Record<ThinkingLevel, string | null>>;
+    input: ("text" | "image")[];
+    cost: NonNullable<ModelDef["cost"]>;
+    contextWindow: number;
+    maxTokens: number;
+    compat?: {
+        supportsStore?: boolean;
+        supportsDeveloperRole?: boolean;
+        supportsReasoningEffort: boolean;
+        maxTokensField?: "max_tokens";
+        requiresReasoningContentOnAssistantMessages?: boolean;
+        thinkingFormat: "openai" | "deepseek" | "qwen";
+    };
+}[];
+/**
+ * 自定义端点 → pi provider 条目。密钥走环境变量引用(启动器已 set,见
+ * endpointKeyEnv),文件里不落明文;没配密钥的端点(本机 Ollama 等)写
+ * 字面量 "local" —— pi 没有凭据会直接拒启("No API key found"),
+ * 这是 pi 自带 llama provider 的同款兜底,本地服务会忽略 Authorization 头。
+ */
+export declare function endpointProviderEntry(ep: CustomEndpoint, options?: {
+    literalKey?: boolean;
+}): Record<string, unknown>;
+/** run_workflow 已下线:清掉旧版本每次启动写入的 /workflow 提示词模板,免得它引导模型调用不存在的工具。 */
+export declare function removeLegacyWorkflowPromptTemplate(): void;
+export declare function scrubForeignProviderEnv(): void;
+/** 把各端点密钥放进环境(TUI 直接 process.env;web 传给子进程)。 */
+export declare function endpointKeyEnv(): Record<string, string>;
+export interface ProviderModelsFileOptions {
+    /** Destination for the composed provider config. Defaults to the shared agent models file. */
+    outputPath?: string;
+    /** Existing config to preserve. Defaults to outputPath. */
+    sourcePath?: string;
+}
+export declare function ensureProviderModels(cfg: CliConfig, options?: ProviderModelsFileOptions): void;