From 5f8f7836d3f88bfec1478e5b4cebf69d5eb6b6ca Mon Sep 17 00:00:00 2001 From: Xinyuan Weng Date: Sat, 14 Nov 2026 11:34:50 -0500 Subject: [PATCH] docs(pine): cover Pi providers and the 0.20.1 changes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Describe Settings › Models › Pi providers (CC Switch), the update dialog's notes for skipped versions, and the five-second provider-wait note. Co-Authored-By: Claude Opus 5.5 --- pine/en/configuration/index.md | 2 +- pine/en/configuration/sessions.md | 2 +- pine/en/configuration/settings.md | 3 +++ pine/en/maintenance.md | 2 +- pine/zh-CN/configuration/index.md | 2 +- pine/zh-CN/configuration/sessions.md | 2 +- pine/zh-CN/configuration/settings.md | 3 +++ pine/zh-CN/maintenance.md | 2 +- 8 files changed, 12 insertions(+), 6 deletions(-) diff --git a/pine/en/configuration/index.md b/pine/en/configuration/index.md index 2c2f7a3..804f39f 100644 --- a/pine/en/configuration/index.md +++ b/pine/en/configuration/index.md @@ -30,7 +30,7 @@ Click the gear in the title bar to open **Pine Settings**. The sections are list | --- | --- | --- | | **General** | Language, currency, Monet mode, completion signal, notifications, quick composer, running in the background, diagnostic logging | [Settings reference](settings.md) | | **Appearance** | Color mode, default color theme, Working glow, sidebar material, inverted documents | [Settings reference](settings.md) | -| **Models** | Model catalog refresh, title generation, approval, image and video generation, Decisions screening model | [Settings reference](settings.md) | +| **Models** | Model catalog refresh, Pi providers, title generation, approval, image and video generation, Decisions screening model | [Settings reference](settings.md) | | **Agent** | Interactive answers, Interim answers, automatic approval path, context compaction, web tools, approximate location | [Settings reference](settings.md) | | **User profile** | Nickname, pronouns, communication style, technical background, personal details, custom instructions | [Settings reference](settings.md) | | **Projects** | Every project and its data usage; clearing temporary files and attachments | [Settings reference](settings.md) | diff --git a/pine/en/configuration/sessions.md b/pine/en/configuration/sessions.md index f996df4..34e873c 100644 --- a/pine/en/configuration/sessions.md +++ b/pine/en/configuration/sessions.md @@ -13,7 +13,7 @@ order: 3 - **Edit message**: editing one of your messages resends it from that point. - **Todos**: when the agent keeps a task list, a progress card sits above the composer and opens **All todos** with a dependency graph. Once every task is completed, the card disappears when the turn ends. - **Background processes**: long-running processes the agent starts appear in a card and in the workbench, with their command and output, and can be stopped while running. -- **Waiting note**: when about 3 seconds pass after sending without any reply, reasoning or tool call, a note says Pine is still waiting for the model provider; if it stays for tens of seconds, check your network and the provider's status. +- **Waiting note**: when about 5 seconds pass after sending without any reply, reasoning or tool call, a note says Pine is still waiting for the model provider; if it stays for tens of seconds, check your network and the provider's status. ## Quotes, follow-ups and side chats diff --git a/pine/en/configuration/settings.md b/pine/en/configuration/settings.md index f41f6a0..d33ba25 100644 --- a/pine/en/configuration/settings.md +++ b/pine/en/configuration/settings.md @@ -40,6 +40,9 @@ Click the gear in the title bar to open **Pine Settings**. The sections are cove To connect models, see [Connect models](../connect-models/index.md). These options choose which model does Pine's supporting work: - **Model catalogs**: **Refresh now** fetches the latest model lists from configured providers. +- **Pi providers (CC Switch)** (desktop app only): with **Use providers from Pi** on (off by default), Pine adds the providers in Pi's `models.json` (as set up in Pi or CC Switch) and follows changes to the file within a moment. By default it reads the file under `PI_CODING_AGENT_DIR` or `~/.pi/agent`; **Show in folder** reveals it, **Choose folder…** picks another location, and **Use default folder** switches back. The section shows how many providers were added, and which were skipped and why. + - Pine only reads this file: these providers cannot be edited, signed in to or removed in Pine; change them in Pi or CC Switch. They carry a "Pi" badge in the model picker, and their IDs start with `pi-`. + - A provider whose key or header is written as a `!command` is skipped; Pine never runs it. - **Title generation model**: names new sessions. - **Approval model**: reviews tool calls in **Auto Approve** and **Autonomous Work**, and explains operations plainly when it hands a call to you. See [Approvals and automatic review](approvals.md). - **Image generation model** and **Video generation model**: used when the agent generates images or video; they need OpenRouter. See [Media generation](../connect-models/media-generation.md). diff --git a/pine/en/maintenance.md b/pine/en/maintenance.md index d57d26e..bd4ea01 100644 --- a/pine/en/maintenance.md +++ b/pine/en/maintenance.md @@ -10,7 +10,7 @@ order: 40 ### Updates -When a new version is available, Pine shows an **update dialog** with what's new and lets you install it. You can also go back to the download page at any time, download the latest installer, and install over the old version; your data isn't lost. +When a new version is available, Pine shows an **update dialog** with what's new and lets you install it. When an update spans several versions, the dialog lists the notes of each one, newest first. You can also go back to the download page at any time, download the latest installer, and install over the old version; your data isn't lost. ### Data location diff --git a/pine/zh-CN/configuration/index.md b/pine/zh-CN/configuration/index.md index 90f82ab..da21268 100644 --- a/pine/zh-CN/configuration/index.md +++ b/pine/zh-CN/configuration/index.md @@ -30,7 +30,7 @@ order: 35 | --- | --- | --- | | **通用(General)** | 语言、货币、Monet 模式、完成提示、通知、快速提问、后台运行、诊断日志 | [设置详解](settings.md) | | **外观(Appearance)** | 配色模式、默认颜色主题、工作光效、侧栏材质、文档反色 | [设置详解](settings.md) | -| **模型(Models)** | 模型目录刷新、标题生成、审批、图像与视频生成、Decisions 初筛模型 | [设置详解](settings.md) | +| **模型(Models)** | 模型目录刷新、Pi 供应商、标题生成、审批、图像与视频生成、Decisions 初筛模型 | [设置详解](settings.md) | | **智能体(Agent)** | 交互式回答、中途回答、自动审批路径、上下文压缩、网络工具、大致位置 | [设置详解](settings.md) | | **自定义(User profile)** | 昵称、人称代词、语言风格、技术背景、个人细节、自定义指令 | [设置详解](settings.md) | | **项目管理(Projects)** | 所有项目及其数据占用,清理临时文件和附件 | [设置详解](settings.md) | diff --git a/pine/zh-CN/configuration/sessions.md b/pine/zh-CN/configuration/sessions.md index 40bba4b..c2b80e4 100644 --- a/pine/zh-CN/configuration/sessions.md +++ b/pine/zh-CN/configuration/sessions.md @@ -13,7 +13,7 @@ order: 3 - **编辑消息(Edit message)**:编辑自己发过的消息会从那里重新发送。 - **任务清单(Todos)**:智能体列出任务清单时,输入框上方显示进度卡片,点开是 **全部任务(All todos)**,带依赖关系图。全部完成后,卡片在本轮结束时消失。 - **后台进程(Background processes)**:智能体启动的长时间进程显示在卡片和工作台里,可查看命令、输出,或在运行中停止。 -- **等待提示**:消息发出约 3 秒后仍没有任何回复、思考或工具调用时,回复位置会提示 Pine 仍在等待模型服务商响应;持续几十秒请检查网络和服务商是否可用。 +- **等待提示**:消息发出约 5 秒后仍没有任何回复、思考或工具调用时,回复位置会提示 Pine 仍在等待模型服务商响应;持续几十秒请检查网络和服务商是否可用。 ## 引用、追问与侧边对话 diff --git a/pine/zh-CN/configuration/settings.md b/pine/zh-CN/configuration/settings.md index 6f96c66..0c56ed6 100644 --- a/pine/zh-CN/configuration/settings.md +++ b/pine/zh-CN/configuration/settings.md @@ -40,6 +40,9 @@ order: 1 模型的连接方法见[连接模型](../connect-models/index.md)。这里的选项决定各种辅助工作由哪个模型完成: - **模型目录(Model catalogs)**:点 **立即刷新(Refresh now)** 拉取已配置提供商的最新模型列表。 +- **Pi 供应商(CC Switch)(Pi providers (CC Switch))**(仅桌面端):开启 **使用 Pi 的供应商(Use providers from Pi)**(默认关闭)后,Pine 会添加 Pi 的 `models.json` 中配置的供应商(在 Pi 或 CC Switch 中设置),文件改动后片刻内自动跟随。默认读取 `PI_CODING_AGENT_DIR` 或 `~/.pi/agent` 下的文件;可以 **在文件夹中显示(Show in folder)**,用 **选择文件夹…(Choose folder…)** 换一个位置,再用 **使用默认文件夹(Use default folder)** 改回。这里会显示已添加的供应商数量,以及被跳过的供应商和原因。 + - Pine 只读取这个文件:这些供应商不能在 Pine 中修改、登录或移除,请在 Pi 或 CC Switch 中修改。它们在模型选择器中带有“Pi”标记,ID 以 `pi-` 开头。 + - 密钥或请求头写成 `!命令` 形式的供应商会被跳过,Pine 不会执行其中的命令。 - **标题生成模型(Title generation model)**:为新会话起标题。 - **审批模型(Approval model)**:在 **自动审批(Auto Approve)** 和 **自主工作(Autonomous Work)** 模式下审核工具调用,并在把调用交给你时用白话解读操作。详见[审批与自动审核](approvals.md)。 - **图像生成模型(Image generation model)**、**视频生成模型(Video generation model)**:智能体生成图片或视频时使用,需要先配置 OpenRouter,见[媒体生成](../connect-models/media-generation.md)。 diff --git a/pine/zh-CN/maintenance.md b/pine/zh-CN/maintenance.md index 28a3219..7459060 100644 --- a/pine/zh-CN/maintenance.md +++ b/pine/zh-CN/maintenance.md @@ -10,7 +10,7 @@ order: 40 ### 更新 -有新版本时,Pine 会弹出**更新对话框**,显示更新内容并让你安装。也可以随时回到发布页下载最新安装包,直接覆盖安装,数据不会丢失。 +有新版本时,Pine 会弹出**更新对话框**,显示更新内容并让你安装。一次跨越多个版本时,对话框会从新到旧列出每个版本的更新内容。也可以随时回到发布页下载最新安装包,直接覆盖安装,数据不会丢失。 ### 数据位置