From a8be150f02e10dae28b8ea66eaada97f7ce72de3 Mon Sep 17 00:00:00 2001 From: Xinyuan Weng Date: Sat, 14 Nov 2026 03:44:25 -0500 Subject: [PATCH 1/2] docs(pine): add an advanced configuration guide Cover every optional feature and setting in Pine 0.20.0: the settings sections, approvals and automatic review, session features, the workbench and preview comments, automations, Skills and MCP, remote control, WeChat remote and keyboard shortcuts, in Chinese and English. Co-Authored-By: Claude Opus 5.5 --- pine/en/configuration/approvals.md | 58 +++++++++++++++ pine/en/configuration/automations.md | 40 ++++++++++ pine/en/configuration/index.md | 39 ++++++++++ pine/en/configuration/remote.md | 63 ++++++++++++++++ pine/en/configuration/sessions.md | 77 ++++++++++++++++++++ pine/en/configuration/settings.md | 90 +++++++++++++++++++++++ pine/en/configuration/shortcuts.md | 80 ++++++++++++++++++++ pine/en/configuration/wechat.md | 97 +++++++++++++++++++++++++ pine/en/configuration/workbench.md | 69 ++++++++++++++++++ pine/en/using-pine.md | 2 +- pine/zh-CN/configuration/approvals.md | 58 +++++++++++++++ pine/zh-CN/configuration/automations.md | 40 ++++++++++ pine/zh-CN/configuration/index.md | 39 ++++++++++ pine/zh-CN/configuration/remote.md | 63 ++++++++++++++++ pine/zh-CN/configuration/sessions.md | 77 ++++++++++++++++++++ pine/zh-CN/configuration/settings.md | 90 +++++++++++++++++++++++ pine/zh-CN/configuration/shortcuts.md | 80 ++++++++++++++++++++ pine/zh-CN/configuration/wechat.md | 97 +++++++++++++++++++++++++ pine/zh-CN/configuration/workbench.md | 69 ++++++++++++++++++ pine/zh-CN/using-pine.md | 2 +- 20 files changed, 1228 insertions(+), 2 deletions(-) create mode 100644 pine/en/configuration/approvals.md create mode 100644 pine/en/configuration/automations.md create mode 100644 pine/en/configuration/index.md create mode 100644 pine/en/configuration/remote.md create mode 100644 pine/en/configuration/sessions.md create mode 100644 pine/en/configuration/settings.md create mode 100644 pine/en/configuration/shortcuts.md create mode 100644 pine/en/configuration/wechat.md create mode 100644 pine/en/configuration/workbench.md create mode 100644 pine/zh-CN/configuration/approvals.md create mode 100644 pine/zh-CN/configuration/automations.md create mode 100644 pine/zh-CN/configuration/index.md create mode 100644 pine/zh-CN/configuration/remote.md create mode 100644 pine/zh-CN/configuration/sessions.md create mode 100644 pine/zh-CN/configuration/settings.md create mode 100644 pine/zh-CN/configuration/shortcuts.md create mode 100644 pine/zh-CN/configuration/wechat.md create mode 100644 pine/zh-CN/configuration/workbench.md diff --git a/pine/en/configuration/approvals.md b/pine/en/configuration/approvals.md new file mode 100644 index 0000000..d166837 --- /dev/null +++ b/pine/en/configuration/approvals.md @@ -0,0 +1,58 @@ +--- +title: "Approvals and automatic review" +description: "The four approval modes, the automatic approval path, what an approval card shows, and which actions always ask you." +order: 2 +--- + +# Approvals and automatic review + +## Approval modes + +Each session has an approval mode at the bottom of the composer that decides whether the agent asks you before risky actions. The mode is saved with the conversation and shared between the desktop app and remote devices. + +| Mode | Who decides | +| --- | --- | +| **Let Me Review** | Every risky action shows an approval card for you to decide | +| **Auto Approve** | The approval model reviews first; you get a card only when it is unsure or thinks you should confirm | +| **Autonomous Work** | The approval model reviews and tries not to stop for you, except for the actions listed below | +| **YOLO** | No permission constraints; asks you to confirm before enabling | + +A session or sub-session the agent starts runs in the same approval mode as the session that started it, or a stricter one, never a looser one. + +## Automatic approval path + +In **Auto Approve** and **Autonomous Work**, choose who reviews in **Pine Settings › Agent › Automatic approval path**: + +- **Model review**: every review goes to the approval model set in **Models**. +- **Decision model** (Beta): the **Decisions screening model** screens first. Calls it allows proceed directly, and calls that need you open a card; denied calls, or calls the screening could not handle, go to the approval model for the final decision and rationale. Needs OpenRouter; model review is used until it is configured. + +Every automatic review is recorded. Open a tool call in the conversation, and **Review history** lists each screening or model review with the model actually used, its outcome and its reason. Outcomes are shown in bold with their own icon and color: green "Allowed", amber "Denied", blue "User confirmation required", grey "Sent for model review" and red "Review failed". The records remain when you reopen the conversation. + +## Approval cards + +When you need to decide, an **Approval required** card takes the composer's place: + +- **Approve**, **Reject**, or **Reject with guidance**: type what you want instead; Enter sends, `Shift + Enter` adds a line, and `Esc` returns to the buttons. +- When automatic review hands a call to you, the card starts with one sentence on what the operation does and a short **Risks** list, worded for your **User profile › Technical background**. The **Explained by the approval model** label reminds you that what actually runs is the original parameters. +- **Technical details** (collapsed) holds why Pine asked, the agent's description, the original parameters and the reviewer's notes. +- On the Decision model path, Pine waits up to about 10 seconds for the plain-language account before showing the card; if it is not ready in time, the card appears with Technical details open and the account fills in when it arrives. +- When enabling a new tool would make the provider reprocess a very long context at full price, the card offers **Activate now**, compressing first and then continuing, or stopping the run. + +With **Notify for approvals and questions** on, approvals raise a system notification while Pine is in the background, and you can approve or deny right from it. + +## Actions that always ask you + +These actions show a card in every approval mode, YOLO included: + +- **Adding or changing an MCP server**: adding, changing, renaming or turning on an MCP server. The card names the server, the command it runs on this computer with your permissions outside Pine's sandbox (or the address it connects to), where it applies (**All projects** or this project only), and the names of the credentials it receives (values hidden). +- **Deleting a session**: a session open in a tab stops and its tab closes. Deleting a session also deletes its sub-sessions, and the confirmation says how many. +- **Changing a project**: creating, renaming, adding or removing folders, changing the working folder, setting the icon and accent color, or deleting it. The card's details list what will change. + +In **Let Me Review**, organizing session folders, starting new sessions, and reading unrelated sessions also ask first. + +## Computer Use + +The first time the agent controls a desktop app or browser tab, it asks for control **for the current task**: one card in Let Me Review, and an automatic review in Auto Approve and Autonomous Work. Once granted, ordinary clicks, typing, scrolling, app switching and navigation continue without per-action reviews. The grant ends when the run finishes, you click **Stop response**, or the approval mode changes, and it is not restored when you reopen the session. OS permission requests and browser extension installation are approved separately. + +> [!WARNING] +> While the grant is active, consequential actions such as payments, sending, publishing, irreversible deletion, security changes or sharing sensitive information with a new recipient rely on the agent choosing to ask you first, not on a separate check of each click. For that kind of work, stay in **Let Me Review**. diff --git a/pine/en/configuration/automations.md b/pine/en/configuration/automations.md new file mode 100644 index 0000000..c373c00 --- /dev/null +++ b/pine/en/configuration/automations.md @@ -0,0 +1,40 @@ +--- +title: "Automations, Skills and MCP" +description: "Unattended automations, reusable Skills, and MCP servers that connect outside tools." +order: 5 +--- + +# Automations, Skills and MCP + +All three managers are in the **More** menu at the top of the left sidebar, and each has a shortcut. Each one offers **Manage with Pine**: it starts a new session with the matching authoring tools already on, so you describe what you want and Pine writes it. + +## Automations + +**Automations** (`Mod + U`) are work Pine does on its own when a time, a file change or a website update calls for it. The easiest way to create one is to tell Pine in a conversation what you want done automatically; it shows an automation approval card listing the triggers, what it will read, write and reach, and any warnings, for you to approve. + +Triggers: **Schedule**, **Folder change**, **System event**, **Website or feed check** and **Manual**, or several at once. + +The manager has three tabs: + +- **Activity**: each run with its status, such as **Running**, **Found something**, **Nothing new** or **Failed**. **Mark all as read**, or turn on **Show runs with nothing new**. Opening a run opens its session. +- **Automations**: each automation's triggers and permissions, with its state **On**, **Off** or **Paused**; **Run now**, **Edit definition** as JSON and **Check** it, or delete it. +- **Secrets**: values automations can use, such as API tokens. They are encrypted on this computer, given only to the automations that reference them, and hidden from what the agent reads; they can be changed only in the Pine desktop app on this computer. + +Each run is a session in the project, marked with a workflow icon. + +> [!NOTE] +> Automations run only while Pine is running. To keep them going after you close the window, turn on **Keep running in the background** in **General**. + +## Skills + +**Skills** (`Mod + S`) are reusable ways of working: instructions that tell the agent how to do a kind of task and which tools it may use. + +- **Global** Skills are available to every project but are switched on per project; **Project** Skills belong to the current project only. +- Create, edit, enable per project, or delete them. + +## MCP servers + +**MCP servers** (`Mod + /`) connect outside tools to the agent through MCP. Each server is available to **All projects** or to the current **Project** only; add, edit, enable, remove and refresh their status. + +> [!WARNING] +> A local MCP server runs with your user permissions, outside Pine's sandbox. That is why adding, changing, renaming or turning on an MCP server asks you in every approval mode, with a card that shows the command it runs or the address it connects to. Add only servers you trust. diff --git a/pine/en/configuration/index.md b/pine/en/configuration/index.md new file mode 100644 index 0000000..2c2f7a3 --- /dev/null +++ b/pine/en/configuration/index.md @@ -0,0 +1,39 @@ +--- +title: "Advanced configuration" +description: "Every optional feature and setting in Pine: what each one does, its default, and where to find it." +order: 35 +--- + +# Advanced configuration + +[Using Pine](../using-pine.md) covers the basics of projects, sessions and approvals. These pages go through Pine's optional features and settings one by one: what each does, what it defaults to, and where to turn it on. None of them are required; look up a topic when you need it. + +> [!NOTE] +> `Mod` means `Cmd` on macOS and `Ctrl` on Windows. Interface text follows Pine's English interface. + +## Find by topic + +- [Settings reference](settings.md): every option in the General, Appearance, Models, Agent, User profile and Projects sections of **Pine Settings** +- [Approvals and automatic review](approvals.md): the four approval modes, the automatic approval path, what an approval card shows, and which actions always ask you +- [Working with sessions](sessions.md): steering, quotes and follow-ups, attachments, interim answers, interactive answers, context and cost, sub-sessions, and letting the agent organize sessions and projects +- [Workbench and file previews](workbench.md): the workbench panels, file details, preview comments, the audio and video player, and enlarging images +- [Automations, Skills and MCP](automations.md): unattended automations, reusable Skills, and MCP servers that connect outside tools +- [Remote control](remote.md): Browser access, pairing a phone or other device through Aldine, keeping the computer awake, running in the background and the tray menu +- [WeChat remote](wechat.md): sending Pine tasks from your own WeChat, and every command available there +- [Keyboard shortcuts](shortcuts.md): every keyboard shortcut + +## Where the settings are + +Click the gear in the title bar to open **Pine Settings**. The sections are listed on the left (on a phone, the list comes first): + +| Section | Main contents | See | +| --- | --- | --- | +| **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) | +| **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) | +| **Remote control** | Keeping awake, pairing devices through Aldine, Browser access, WeChat | [Remote control](remote.md), [WeChat remote](wechat.md) | + +Automations, Skills and MCP servers are not in the settings dialog but in the **More** menu at the top of the left sidebar; see [Automations, Skills and MCP](automations.md). diff --git a/pine/en/configuration/remote.md b/pine/en/configuration/remote.md new file mode 100644 index 0000000..43fd9e7 --- /dev/null +++ b/pine/en/configuration/remote.md @@ -0,0 +1,63 @@ +--- +title: "Remote control" +description: "Browser access, pairing a phone or other device through Aldine, keeping the computer awake, running in the background and the tray menu." +order: 6 +--- + +# Remote control + +**Pine Settings › Remote control** (desktop app only) lets you use the Pine on this computer from other devices. Every remote option works only while Pine is running and the computer is awake. To send tasks from WeChat, see [WeChat remote](wechat.md). + +## Browser access + +**Browser access** serves Pine's full interface to a browser, and is required for remote control through Aldine. Before turning it on, set an **Access password** (at least 8 characters) that browsers sign in with. + +| Option | What it does | +| --- | --- | +| **Require password** | On by default. Turn it off only when something in front of Pine, such as Cloudflare Access, already signs people in; once off, anyone who reaches the address controls Pine and can run commands on this computer without signing in | +| **Stay signed in** | How long a browser stays signed in after entering the password: **Until the browser closes**, 1 day, 7 days or 30 days | +| **Allow LAN access** | Other devices on your network can open Pine. Traffic is unencrypted HTTP, so only use networks you trust | +| **Public address** | When a reverse proxy or a tunnel such as Cloudflare Tunnel serves Pine, its address, such as `https://pine.example.com` | +| **Port** | The port Pine listens on; open the access link again after changing it | +| **Access link** | Opens Pine at `127.0.0.1` on this computer; copy it or open it in a browser | +| **Signed-in browsers** | **Sign out all** makes every browser enter the password again. Changing the password also signs them out | + +> [!CAUTION] +> Anyone who can sign in through Browser access can read your projects, run agents and run commands on this computer. Don't reuse the access password anywhere else. + +## Remote control via Aldine + +**Remote control via Aldine** pairs any device by QR code or link, with no port forwarding and end-to-end encryption. + +1. Turn on **Browser access** first. +2. Click **Pair a device**, then scan the QR code with the other device's system camera, or open the pairing link in its browser. The dialog shows how long the code and link stay valid; after that, click **New code**. +3. Confirm the pairing on this computer. The dialog shows this computer's fingerprint so you can check it. + +> [!TIP] +> Use the system camera and the native browser, not the scanners built into chat or payment apps. + +**Paired devices** lists each device with when it was paired and last connected; **Rename** or **Remove** it. A removed device disconnects at once and must pair again. + +On a phone: + +- After adding the Pine Remote web page to your Home Screen, add computers inside that app with **Scan pairing code** or **Paste pairing link**, so they are saved there. Extra text around a pasted link is ignored. +- With several computers paired, **Switch computer** returns to the list of computers, where you can also add another. +- On a phone, Pine uses a layout for small screens: dialogs fill the screen, and lists and details are shown one at a time. + +## Keeping the computer awake + +**Keep the computer awake while remote control is on**, at the top of the section, is off by default. When on, the computer does not go to sleep while Browser access is on or WeChat is receiving tasks; the display can still turn off, and closing the lid still sleeps. When no remote control is on, the computer sleeps as usual. + +## Running in the background and the tray menu + +With **Keep running in the background** on in **General**, closing the last window keeps Pine in the menu bar (macOS) or notification area (Windows). The tray menu has: + +- **Open Pine** and **Quick composer** +- Switches for **Browser access**, **Remote Control via Aldine** and **WeChat remote** +- **Keep computer awake for remote control** +- **Manage more settings…**, which opens the Remote control settings +- The number of running sessions, and **Quit Pine** + +To stop automations and every kind of remote control, quit Pine from the tray menu. Pine asks before quitting while sessions are running, remote control is on, or WeChat remote is listening. + +To keep remote access available on an always-on machine, see [Run on a server](../advanced/server.md). diff --git a/pine/en/configuration/sessions.md b/pine/en/configuration/sessions.md new file mode 100644 index 0000000..f996df4 --- /dev/null +++ b/pine/en/configuration/sessions.md @@ -0,0 +1,77 @@ +--- +title: "Working with sessions" +description: "Steering, quotes and follow-ups, attachments, interim answers, interactive answers, context and cost, sub-sessions, and letting the agent organize sessions and projects." +order: 3 +--- + +# Working with sessions + +## Working alongside a running agent + +- **Steer response**: while the agent works, type a new message and choose Steer response; the agent reads it at its next step without stopping the task. Staged messages sit above the composer, each with **Withdraw** and **Send now** below it. +- **Stop response**: stops the turn at any time. +- **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. + +## Quotes, follow-ups and side chats + +Selecting text in the conversation shows two buttons: + +- **Quote**: attaches the passage to your next message. +- **Follow up**: opens a side chat about that passage in the workbench. Follow-ups are saved with the session, the passage is highlighted, and clicking the highlight reopens it. + +A **Side chat** is a read-only conversation about the current session: it can read files and search the web but cannot change anything, so you can ask questions without disturbing the main task. A side chat about the whole conversation, opened from the workbench's panel switcher or **Add card**, is marked **Not saved** and is discarded when closed. + +In long sessions, the **Conversation outline** jumps to an earlier turn. + +## Attachments + +**Add attachment** in the composer adds a **File**, **Folder** or **Conversation**; you can also drop files and paste images and long text. + +- **Attaching a conversation**: drag a session from the left sidebar into the composer, or choose Conversation in the attachment menu. The agent reads that conversation without asking for approval. Once sent, clicking the chip opens it. +- **Sending from a file preview**: **Send to tab…** and **Send selection to tab…** in a file preview attach the whole file or the selection to a session; preview comments can also go to a session in one step. See [Workbench and file previews](workbench.md). +- In a new session with no project, typing `@` chooses the project. + +## What answers can contain + +- **Interactive answers**: replies can include checklists, tables, charts, calculators and inputs. Turn this off in **Pine Settings › Agent**. +- **Interim answers**: the agent can post a preliminary answer before slow work such as a web search, or answer each part of a multi-part request as soon as it is solved, and keep working. They can be selected, quoted, searched and exported like any reply. Turn them off in the same place. +- **Question cards**: when the agent needs more from you, a questionnaire card takes the composer's place; move between questions with **Previous** and **Next**, or write a free-text answer and **Submit**. + +## Context and cost + +Click **Context usage** at the bottom of the composer: + +- The top part shows tokens used, the context window, utilization and cache hit rate; **Compact context now** compacts by hand. The automatic compaction strategy is set in the [Settings reference](settings.md). +- The bottom part shows this conversation's cost (in the currency set in **General**) and a **Session cost limit** switch and amount. Reaching the limit stops the run and blocks new messages until you raise or clear it. You can set it before a session starts. + +The composer's footer also switches this session's **Model** and **Reasoning effort**. + +## Sub-sessions and sessions the agent starts + +You can ask the agent to start new sessions for independent work: + +- **Sub-session**: the usual choice. It belongs to the current session and sits indented under its parent in the left sidebar, joined by a tree line; the chevron at the end of the parent's row expands or collapses it (so does clicking the row of the parent you already have open). A sub-session's tab shows two speech bubbles. Sub-sessions go only one level deep; a sub-session can start only siblings. +- **Sibling session**: an independent session in this or another project that works in the background. It appears in the left sidebar without opening a tab or switching away from your current session. + +When a sub-session finishes a turn, fails or waits for an approval, the parent shows a marker (for example "Sub-session {name} finished") that opens it; the parent's agent reads the sub-session's reply and continues, even when the parent has no tab open. A sub-session's approvals are answered in its own tab. A message one session sends another shows in the receiving session under "Started by {name}" or "From {name}", which opens the sender. + +The agent can also search your sessions in every project. Reading a session unrelated to the current work is reviewed first: a card in Let Me Review, the approval model in Auto Approve and Autonomous Work, and no review in YOLO. It cannot send messages to those sessions. + +## Letting the agent organize sessions and projects + +When you ask, the agent can: + +- **Organize sessions**: create, rename and delete session folders, move sessions into or out of folders, and rename sessions. Deleting a session always asks you. +- **Manage projects**: create a project from folders, rename it, add or remove folders, change the working folder, set its icon and accent color, or delete it. Every change asks you, in every mode. Deleting a project deletes its sessions but keeps its folders on disk; the agent cannot delete the project it runs in, **No Project**, or a project with a session still working. + +**Session titles**: Pine names a session after its first exchange; when a later message starts a different task, the agent may update the title to the work it is now doing. A title you set with Rename stays until you rename it again. + +## Managing sessions + +- **Search sessions**: `Mod + K` searches titles and content across every project. +- **Session folders**: create a folder from the button on a project's group header; right-click a folder to **Rename folder** or **Delete folder** (its conversations move back to the project). +- **Right-click a session**: **Rename conversation**, **Export conversation** (Markdown), **Move to folder**, **Delete conversation** (permanent). +- In the left sidebar, a running session's title shimmers; a session stopped on an approval shows a shield icon at the end of its row ("Waiting for your approval"); automation runs show a workflow icon; sessions started or used from WeChat show a chat-bubble icon. diff --git a/pine/en/configuration/settings.md b/pine/en/configuration/settings.md new file mode 100644 index 0000000..f41f6a0 --- /dev/null +++ b/pine/en/configuration/settings.md @@ -0,0 +1,90 @@ +--- +title: "Settings reference" +description: "Every option in the General, Appearance, Models, Agent, User profile and Projects sections of Pine Settings." +order: 1 +--- + +# Settings reference + +Click the gear in the title bar to open **Pine Settings**. The sections are covered one by one below. **Remote control** has more to it and has pages of its own: [Remote control](remote.md) and [WeChat remote](wechat.md). + +## General + +### Interface + +- **Language**: the interface language. Simplified Chinese, Traditional Chinese, English, Japanese, Korean, Spanish, French, German and Russian are available. +- **Currency**: the currency for conversation cost and cost limits. Defaults to **Follow system**; converted at the European Central Bank's daily rate, and shown in US dollars when rates are unavailable. +- **Monet**: gives Pine a distinctive voice and uses a serif reading font for replies, session titles, headings, input placeholders and the model picker; your own messages, buttons, menus and the sidebar keep the interface font. While it is on, **Communication style** in **User profile** is unavailable, because Monet replaces it. + +### Notifications + +- **Signal when work is done**: tells you when the agent finishes a turn: **Off**, **Notification**, or **Notification and sound**. +- **Notify for approvals and questions**: while Pine is in the background, shows a system notification when a tool call needs approval or Pine asks you a question; approval notifications have Approve and Deny buttons. + +### System + +- **Quick composer**: a global shortcut that opens a floating composer from any app to start a new conversation. With the screen recording and accessibility permissions, it can also take the frontmost app's window and selected text as context; files, pasted images and long text can be added before the main window opens. +- **Keep running in the background** (macOS and Windows desktop app): closing the last window keeps Pine in the menu bar (macOS) or notification area (Windows), so automations, remote control and the quick composer stay available. To quit completely, choose **Quit Pine** from the tray icon. The tray menu is described in [Remote control](remote.md). +- **Diagnostic logging**: records errors and sleep recovery events on this computer to help troubleshoot. Keeps the two most recent logs, about 2 MB in total; conversation text is excluded and logs are never uploaded automatically. Turning it off stops recording and keeps existing logs. + +## Appearance + +- **Color mode**: **System**, **Light** or **Dark**. +- **Pine default color theme**: the app's default theme color: Neutral, Olive, Red, Rose, Orange, Green, Blue, Yellow or Violet (Neutral by default). A project's own accent color takes precedence. +- **Working glow**: while the agent works, a thin light runs clockwise along the composer's border in the project's accent color. On by default and applies to every open window. With the system's reduced motion on, the light stays still at the bottom-right corner. +- **Native sidebar material** (macOS): draws the sidebar with the native translucent macOS material. +- **Invert documents in dark mode**: in dark mode, PDFs, presentations and other documents open with inverted pages for easier reading at night. + +## Models + +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. +- **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). +- **Decisions screening model**: the model that screens calls when the automatic approval path is **Decision model**. + +## Agent + +### How Pine answers + +- **Interactive answers**: lets Pine include interactive checklists, calculators, tables and charts in replies. **Enabled** by default. +- **Interim answers**: lets Pine share a preliminary answer from what it already knows, or each part of a multi-part request as soon as it is solved, before it finishes searching or working. **Enabled** by default; applies from the next message. Sub-sessions and automation runs do not post interim answers. + +### Permissions + +- **Automatic approval path**: who decides during automatic approval: **Model review** or **Decision model** (Beta). See [Approvals and automatic review](approvals.md) for the difference. + +### Context + +When a conversation grows close to the model's context limit, Pine compacts the earlier part and keeps the essentials so work can continue. + +- **Context compaction strategy**: **Use recommended settings** compacts at 80% context usage, capped at 400K tokens; **Passive compaction** keeps the default behavior and compacts only near the context limit. +- **Context compaction method**: **Model** asks the current model to write the summary; **Semantic algorithm** (Beta) makes no model call, extracting goals, file changes, commits and a brief transcript from the conversation, so it is faster and uses no tokens. + +To compact by hand, see the cost, or set a cost limit, see [Working with sessions](sessions.md). + +### Tools & privacy + +- **TinyFish web tools**: with a TinyFish API key, the agent can search the web and fetch pages. See [Web search](../connect-models/web-search.md). +- **Share approximate location with AI**: Pine gets this computer's public IP address from Cloudflare and estimates your city on this device with its built-in GeoIP database; only the city, region and country reach the AI. A VPN or proxy can make the location inaccurate. + +## User profile + +These details help Pine understand you. Changes save automatically and apply from the next message in every conversation. + +- **Nickname**: what Pine calls you when appropriate. +- **Pronouns**: used when Pine refers to you in the third person, for example in documents or messages it writes for you. **Not specified** (the default), **he/him**, **she/her**, **they/them** or **Custom**. +- **Communication style**: **Calm & professional**, **Neutral** or **Warm & friendly**. Unavailable while Monet mode is on. +- **Technical background**: **General user** avoids jargon and explains in goal-oriented language; **Professional user** gets technical details directly. The plain-language explanations on approval cards follow it too. +- **Other personal details**: your work, interests, preferences or current goals. +- **Custom instructions**: additional ways you want Pine to work. Safety and approval rules still apply. + +## Projects + +Lists every project with the data Pine keeps for it (sessions, attachments, temporary files, search cache). Project folders themselves are never changed. + +- **New Project** and **Edit**: name, icon, accent color (**Pine Default** follows the Appearance setting, or pick a color of its own), default folder, and the access of additional context folders (**Read only** or **Read and write**). +- **Clear temporary files**: deletes the project's temporary files. +- **Clear attachments…**: deletes pasted images and long text. Earlier messages that reference them can no longer preview them; Pine asks before clearing. diff --git a/pine/en/configuration/shortcuts.md b/pine/en/configuration/shortcuts.md new file mode 100644 index 0000000..23eec83 --- /dev/null +++ b/pine/en/configuration/shortcuts.md @@ -0,0 +1,80 @@ +--- +title: "Keyboard shortcuts" +description: "Every keyboard shortcut in Pine: tabs, windows, managers, enlarged images, preview comments and audio and video playback." +order: 8 +--- + +# Keyboard shortcuts + +`Mod` means `Cmd` on macOS and `Ctrl` on Windows. + +## Windows and tabs + +| Shortcut | What it does | +| --- | --- | +| `Mod + N` / `Mod + T` | New session tab | +| `Mod + W` | Close tab (middle-clicking a tab also closes it) | +| `Mod + Shift + T` | Reopen the last closed tab | +| `Mod + Shift + N` | New window | +| `Mod + Shift + R` | Reload the window (plain `Mod + R` does nothing, so a stray press does not reload Pine) | +| `Mod + 1` … `Mod + 8` | Jump to that tab | +| `Mod + 9` | Jump to the last tab | +| `Mod + Alt + ←` / `→` | Previous / next tab | +| `Mod + B` | Show / hide the left sidebar | +| `Mod + Alt + B` | Show / hide the workbench | +| `Mod + L` | Focus the composer | + +## Managers and search + +| Shortcut | What it does | +| --- | --- | +| `Mod + K` | Search all sessions | +| `Mod + P` | Open **Pine Settings › Projects** | +| `Mod + S` | Skills manager | +| `Mod + U` | Automations manager | +| `Mod + /` | MCP servers manager | + +The quick composer's global shortcut is set in **General**. + +## Composer and approvals + +| Shortcut | What it does | +| --- | --- | +| Enter | Send the message | +| `Shift + Enter` | New line | +| `Esc` | Return to the buttons from Reject with guidance | + +With a session row focused in the left sidebar, `→` / `←` expand or collapse its sub-sessions. + +## Enlarged images + +After enlarging an image in a Markdown file's Rendered view: + +| Shortcut | What it does | +| --- | --- | +| `←` / `→` | Previous / next image | +| `Mod + =` / `Mod + −` | Zoom in / out | +| `Mod + 0` | Fit to window | +| `Esc` | Close | + +## Preview comments + +| Shortcut | What it does | +| --- | --- | +| `Mod + Alt + M` | Comment on the selected text or cells | +| Enter / `Shift + Enter` | Save / new line in the comment box | +| `Esc` | Cancel the comment, or the area being drawn | + +## Audio and video + +While the preview is the active tab and focus is not in a text field: + +| Shortcut | What it does | +| --- | --- | +| Space / `K` | Play / pause | +| `←` / `→` | Back / forward 5 seconds | +| `J` / `L` | Back / forward 10 seconds | +| `M` | Mute | +| `F` | Full screen (video) | +| `I` / `O` | Mark the start / end of a span to comment on | +| `Esc` | Clear the marks | diff --git a/pine/en/configuration/wechat.md b/pine/en/configuration/wechat.md new file mode 100644 index 0000000..f532e1e --- /dev/null +++ b/pine/en/configuration/wechat.md @@ -0,0 +1,97 @@ +--- +title: "WeChat remote" +description: "Send Pine tasks from your own WeChat through Tencent's ClawBot: connecting, permission settings and every command." +order: 7 +--- + +# WeChat remote + +**WeChat remote** (experimental) lets you use your own WeChat, through Tencent's ClawBot, to send tasks to the Pine on this computer, follow their progress, handle approvals and get files back. Its settings are in **Pine Settings › Remote control › WeChat**. + +> [!WARNING] +> With WeChat remote on, anyone who gets into your WeChat account can direct Pine on this computer. Messages pass through Tencent's servers, and the connected account can read session titles, search results and replies of every project. Set the limits below with that in mind. + +## Connecting WeChat + +1. Click **Connect WeChat**, scan the QR code in the dialog with WeChat on your phone, and confirm on the phone. If WeChat asks, enter the verification code it shows on your phone. +2. In WeChat, send any message (a single dot is enough) to the bot. It replies with a 6-digit pairing code. +3. Enter the code in the six boxes (pasting fills them all); it is sent as soon as the sixth digit is entered. If the code expires, click **Try again**. + +Once connected, the settings show **WeChat account XXXX-XXXX** with a status: **Online**, **Connecting**, **Retrying**, **Scan again needed** or **Paused**. When a new scan is needed, click **Scan again**. + +One WeChat account connects to one computer. A proxy or an overseas network exit may be blocked. + +## Permission settings + +| Option | What it does | +| --- | --- | +| **Receive tasks from WeChat** | While off, Pine ignores messages from WeChat. Only this computer can turn it back on | +| **Default project** | Where a new session from WeChat starts, or **No Project** | +| **Highest approval mode** | Sessions driven from WeChat never run with less supervision than this. Choosing **YOLO** asks for confirmation first | +| **Default approval mode** | The mode of sessions started from WeChat, within the highest mode | +| **Allow approving high-risk actions from WeChat** | Native execution outside the sandbox and destructive commands. Off by default; while off, they can be approved only on this computer | +| **Allow sending files to WeChat** | Only the session's artifacts (files the agent submitted), up to 100 MB each. Off by default. When on, up to three files a task submitted or opened are sent right after its result, and the rest are listed with `.o` | + +**Disconnect** asks first: sessions that only WeChat holds stop, and the WeChat permission settings return to their defaults. + +Other sessions that WeChat-driven work starts or contacts are held to the same limits. Automation approvals, wherever they were requested, are answered only on this computer. + +## Using it in WeChat + +- **Plain text** goes to the current session. To add to the request while the agent runs, put the text in the steering queue with `.queue`; the agent reads it at its next step. +- **Commands** start with a dot (`.` or the Chinese full stop `。`). Send `.help` (or `.?`) for the common commands and `.h 2` for the rest. +- Replies are formatted as Markdown, with lists and command help as narrow tables; a long reply is cut, with a note on how to see all of it. +- Approval and question cards are numbered; send `.number` to see a card in full. An interactive answer's buttons are numbered too: reply with the number. +- Tasks that reach Pine more than 10 minutes after you sent them wait until you confirm them in WeChat. + +### Commands + +| Command | Short form | What it does | +| --- | --- | --- | +| `.help [command \| 2]` | `.h` | Common commands; `.h 2` for the rest | +| `.status` | `.s`, or a lone `.` | Current session and open asks | +| `.info` | `.cfg` | This computer and the WeChat remote settings | +| `.lang zh \| en \| auto` | | Reply language | +| `.pause [all]` | | Pause WeChat remote; `all` also stops running sessions. Resume on the computer | +| `.more` | `.0` | Next page | +| `.new [@project] [text]` | `.n` | Start a session; without text, the next message starts one | +| `.sessions [@project]` | `.l` | Recent sessions | +| `.search words` | `.f` | Search all sessions | +| `.use [ref]` | `.u` | Switch the current session (`.u 9` is the latest push) | +| `.last` | `.r` | Final reply of the last turn | +| `.history [n]` | `.hi` | Last turns (default 3, at most 10) | +| `.stop [all]` | `.x` | Stop the current run; `all` stops every run | +| `.queue [text]` | `.q` | Add to the steering queue; without text, list the queue | +| `.unqueue [N]` | `.qx` | Withdraw a queued message (default: the newest) | +| `.rename title` | `.rn` | Rename the current session | +| `.delete ref` | `.del` | Delete a session started from WeChat (confirmed) | +| `.model [ref]` | `.m` | List models, or switch the current session's model | +| `.effort [level]` | `.e` | Reasoning effort | +| `.mode [mode]` | `.mo` | Approval mode (up to the limit set on the computer) | +| `.usage` | `.i` | Context and cost | +| `.compact` | `.c` | Compact the context | +| `.todo` | `.t` | The agent's todo list | +| `.pending` | `.w` | Every approval and question waiting for you | +| `.show ref` | `.number` | Show a card in full | +| `.approve [ref]` | `.y` | Approve or confirm | +| `.reject [ref] [guidance]` | `.d` | Reject or cancel, optionally with guidance | +| `.guide [ref] text` | `.g` | Reject and tell the agent what to do instead | +| `.answer [ref] answers` | `.a` | Answer a question card; separate questions with `;` | +| `.files [N]` | `.o` | Files the agent submitted as artifacts | +| `.file N` | `.send` | Send one file to WeChat | +| `.tasks` | `.b` | Background processes | +| `.task N` | | Output of one background process | +| `.kill N` | `.k` | Stop one background process | +| `.projects [ref]` | `.p` | List projects, or pick the project for new sessions | +| `.autos [@project]` | `.au` | Automations | +| `.auto N [on \| off \| run]` | | One automation: details, on, off or run now | +| `.runs [N]` | `.ar` | Automation runs | +| `.skills` | `.sk` | Skills of the current project | +| `.mcp` | | MCP servers | +| `.drop` | | Discard attachments not sent yet | + +## Notifications and the tray + +Even with notifications turned off, these always raise a system notification: a session started from WeChat, an existing session first used from WeChat, a high-risk action approved from WeChat, a file sent to WeChat, a session deleted from WeChat, an automation run from WeChat, a session switched to YOLO from WeChat, WeChat needing a new scan, WeChat remote being paused, or its settings being reset. Clicking one brings Pine's window forward. + +The **WeChat remote** switch in the tray menu pauses or resumes receiving at any time, the same as **Receive tasks from WeChat** in Settings. Pine asks before quitting while WeChat remote is listening, because tasks sent from WeChat will not arrive after you quit. To keep it online all the time, [run Pine on a server](../advanced/server.md). diff --git a/pine/en/configuration/workbench.md b/pine/en/configuration/workbench.md new file mode 100644 index 0000000..8183ca6 --- /dev/null +++ b/pine/en/configuration/workbench.md @@ -0,0 +1,69 @@ +--- +title: "Workbench and file previews" +description: "The workbench panels, file details, preview comments, the audio and video player, and enlarging images." +order: 4 +--- + +# Workbench and file previews + +## Workbench + +The workbench is the panel on the right of the window (`Mod + Alt + B` shows or hides it), kept per session. It holds up to two cards stacked top and bottom, with a handle between them; drag its leading edge to change its width. Each card header has a panel switcher, **Open in tab**, **Add card** and a close button. + +| Panel | Contents | +| --- | --- | +| **Artifacts** | The session's deliverables: the result files the agent submitted, newest first, with a title and a one-line description. Files the agent only showed to report progress or compare are not listed | +| **Background processes** | Processes the agent started, with their output | +| **Preview** | The file the agent last presented, or one picked from Artifacts | +| **Files** | The project's file tree, with each folder's access | +| **Side chat** | A read-only conversation about the current session; see [Working with sessions](sessions.md) | + +When the agent opens a card or presents a file in Preview, that card pulses in yellow until you hover it. A file the agent presents fullscreen opens as a pulsing tab behind the current one, never taking focus. + +## File previews + +Clicking a file in the file tree, the conversation or Artifacts opens a preview tab. Depending on the format, it offers **Rendered** / **Text** views, page navigation, search, zoom, rotate, invert, sheet and layer pickers, and **Open with default application**. + +### Details and Comments cards + +While a file tab is in front, the right sidebar shows two cards for that file instead of the session's cards: **Details** on top and **Comments** below (for project files that can take comments). It is closed by default; open it with the **Comments** button in the preview's footer (**Details** for files that cannot take comments), the workbench button in the title bar, or `Mod + Alt + B`. + +**Details** lists the type, size, modified and created dates, and location, then what the preview measured (encoding, lines, dimensions, duration, pages, rows and columns) and what the format records, such as a document's title, author, application and word count, a photo's camera, date taken and color mode, a recording's codec and tags, an email's sender and recipients, or an archive's entries. + +### Enlarging Markdown images + +In the Rendered view of a Markdown file, click an image (or focus it and press Enter): the window blurs and the image moves to the middle. The toolbar at the bottom has previous and next, **Fit to window**, zoom out and zoom in; `Mod + scroll` also zooms, and a zoomed image can be dragged around. Click outside the image, the close button or press `Esc` to return. + +### Audio and video player + +Audio and video play in Pine's own player: a timeline (click or drag to seek), Play/Pause, the current time and length, **Comment on this moment**, **Loop**, **Playback speed**, mute and volume, and for video **Picture in picture** and full screen. See [Keyboard shortcuts](shortcuts.md) for its keys. + +## Preview comments + +In a preview of a project file, you can write change requests on parts of the file and send them to a session together. + +### What you can comment on + +| How | Formats | +| --- | --- | +| Selected text | Text, code, Markdown (Text or Rendered view), HTML, Word and other documents (DOCX, DOC, ODT, RTF, Pages), PDF, slides (PPTX, PPT, Keynote), EPUB e-books, email (EML, MSG) | +| Selected cells | Spreadsheets (XLSX, Numbers), CSV / TSV and other data tables, SQLite tables | +| A boxed area | Images, PDF pages, slides, PSD, OFD, Typst, PostScript, draw.io, Mermaid and other diagrams, mind maps | +| A time span | Audio and video | + +### How to comment + +- **Text and cells**: select, then choose **Comment** in the floating menu or press `Mod + Alt + M`, and type. Enter saves, `Shift + Enter` adds a line, `Esc` cancels. +- **Areas**: click **Comment on area** in the preview's footer and drag a box on an image, page or slide; `Esc` cancels. +- **Time spans**: **Comment on this moment** in the player comments on the current time; to comment on a span, Shift-drag along the timeline, or press `I` at its start and `O` at its end. + +Commented text is highlighted in amber, and commented cells and areas are boxed in amber; clicking one shows its comment in the right sidebar. + +### Managing and sending + +- The **Comments** card lists every comment in document order with its location (such as "Line 12", "Page 3", "B2:D5" or "0:12–0:30"), the quoted text and the comment, with Edit and Delete. A comment whose passage is no longer in the file after it changed is marked **Original text changed**. +- **Send N comments** at the bottom lists the project's session tabs and a new session. Choose one, and the comments go into that session's composer as comment chips (file, location and comment) and are cleared from the preview. +- **Clear all** asks before removing them. + +> [!NOTE] +> A file holds up to 50 comments. Comments are kept in memory until they are sent or cleared; they are not kept when Pine quits. diff --git a/pine/en/using-pine.md b/pine/en/using-pine.md index 1cc0b9c..d5d7e59 100644 --- a/pine/en/using-pine.md +++ b/pine/en/using-pine.md @@ -64,7 +64,7 @@ Also: ## Optional settings -None of these are required; come back to them when you need them. +None of these are required; come back to them when you need them. For a full explanation of each one, see [Advanced configuration](configuration/index.md). | What you want to do | Where | | --- | --- | diff --git a/pine/zh-CN/configuration/approvals.md b/pine/zh-CN/configuration/approvals.md new file mode 100644 index 0000000..05ce2ae --- /dev/null +++ b/pine/zh-CN/configuration/approvals.md @@ -0,0 +1,58 @@ +--- +title: "审批与自动审核" +description: "四种审批模式、自动审批路径、审批卡片上的信息,以及哪些操作永远需要你确认。" +order: 2 +--- + +# 审批与自动审核 + +## 审批模式 + +每个会话在输入框底部有一个审批模式,决定智能体做有风险的操作前要不要问你。模式随会话保存,桌面端和远程设备共用同一个设置。 + +| 模式 | 谁来决定 | +| --- | --- | +| **让我过目(Let Me Review)** | 有风险的操作都弹出审批卡片,由你决定 | +| **自动审批(Auto Approve)** | 审批模型先审核;它拿不准或认为需要你确认时,才把卡片交给你 | +| **自主工作(Autonomous Work)** | 审批模型审核,尽量不停下来等你;下面列出的几类操作除外 | +| **干就完了(YOLO)** | 不做权限限制,开启前会再次确认 | + +智能体开出的新会话或子会话,审批模式与发起它的会话相同或更严格,不会更宽松。 + +## 自动审批路径 + +**自动审批(Auto Approve)** 和 **自主工作(Autonomous Work)** 下,由谁审核在 **Pine 设置(Pine Settings)→ 智能体(Agent)→ 自动审批路径(Automatic approval path)** 中选择: + +- **大模型审批(Model review)**:每次审核都交给 **模型(Models)** 分区里设置的审批模型。 +- **基于决策模型(Decision model)**(Beta):先由 **Decisions 初筛模型** 快速判断。判断为允许的直接执行,判断为需要用户确认的弹出卡片;被拒绝或初筛不可用时,再交给审批模型做最终决定并给出理由。需要配置 OpenRouter,未配置时自动改用大模型审批。 + +每次自动审核都会留下记录。点开会话里的工具调用,**审核历史(Review history)** 列出每一次初筛或模型审核实际使用的模型、结果和理由,结果用粗体、图标和颜色区分:绿色“允许”、琥珀色“拒绝”、蓝色“需要用户确认”、灰色“已送交模型审核”、红色“审核失败”。重新打开会话后这些记录依然可见。 + +## 审批卡片 + +需要你决定时,输入框的位置会出现 **需要确认(Approval required)** 卡片: + +- **批准(Approve)**、**拒绝(Reject)**,或 **拒绝并说明要求(Reject with guidance)**:输入你希望它怎么改,回车发送,`Shift + 回车` 换行,`Esc` 返回按钮。 +- 自动审核把调用交给你时,卡片先用一句话说明这个操作做什么,并列出 **风险(Risks)**。措辞随 **自定义(User profile)→ 技术背景(Technical background)** 调整。旁边的 **由审批模型解读(Explained by the approval model)** 标签提醒你:实际执行的是原始参数。 +- **技术细节(Technical details)**(默认收起)里有 Pine 发起审批的原因、智能体的说明、原始参数和审核备注。 +- 使用基于决策模型的路径时,Pine 最多等约 10 秒拿到白话解读再显示卡片;来不及时先展开技术细节显示卡片,解读到了再补上。 +- 启用某个新工具会让服务商以全价重新处理很长的上下文时,卡片会给出 **直接激活(Activate now)**、先压缩再继续,或停止本轮运行三个选择。 + +开启 **批准和提问时发送通知(Notify for approvals and questions)** 后,Pine 在后台时审批会以系统通知提醒你,通知上可以直接批准或拒绝。 + +## 始终需要你确认的操作 + +下面这些操作无论处于哪种审批模式(包括干就完了)都会弹出卡片: + +- **新增或修改 MCP 服务器**:添加、修改、重命名或启用 MCP 服务器。卡片写明服务器名称、它在本机以你的权限、在 Pine 沙箱之外运行的命令(或连接的地址)、适用范围(**所有项目(All projects)** 或仅当前项目),以及它拿到的凭据名称(不显示值)。 +- **删除会话**:会话若正在标签页中打开,删除后会停止并关闭标签。删除会话会一并删除它的子会话,确认框会写明数量。 +- **改动项目**:新建、重命名、增删文件夹、更换工作文件夹、设置图标和强调色、删除项目。卡片的详情列出将要改变的内容。 + +在 **让我过目(Let Me Review)** 模式下,智能体整理会话文件夹、开启新会话、读取不相关的其他会话等操作也会先问你。 + +## Computer Use + +智能体第一次操作桌面应用或浏览器标签页时,会为**本次任务**申请控制权限:让我过目模式下弹出一张卡片,自动审批和自主工作模式下由审核自动处理。批准后,普通的点击、输入、滚动、切换应用和导航不再逐步审批;本轮结束、你点 **停止回答(Stop response)** 或切换审批模式后,授权即失效,重新打开会话也不会恢复。系统权限请求和浏览器扩展安装仍然单独审批。 + +> [!WARNING] +> 授权期间,付款、发送、发布、不可恢复的删除、安全设置更改或向新对象分享敏感信息等后果较重的操作,依靠智能体自觉先问你,而不是对每次点击单独检查。涉及这类事务时,请保持在 **让我过目(Let Me Review)**。 diff --git a/pine/zh-CN/configuration/automations.md b/pine/zh-CN/configuration/automations.md new file mode 100644 index 0000000..4323e21 --- /dev/null +++ b/pine/zh-CN/configuration/automations.md @@ -0,0 +1,40 @@ +--- +title: "自动化、Skills 与 MCP" +description: "无人值守的自动化任务、可复用的 Skills,以及接入外部工具的 MCP 服务器。" +order: 5 +--- + +# 自动化、Skills 与 MCP + +这三个管理器都在左侧栏顶部的 **更多功能(More)** 菜单里,也可以用快捷键打开。每个管理器都有 **和 Pine 协作管理(Manage with Pine)**:它会开一个新会话,输入框里已经启用了相应的创作工具,你用对话描述需求,Pine 帮你写好。 + +## 自动化 + +**自动化(Automations)**(`Mod + U`)是 Pine 在到点、文件变化或网站更新时自己去做的工作。最简单的创建方式是在对话里告诉 Pine 你想自动完成什么,它会弹出自动化审批卡片,列出触发条件、它会读写和访问的内容以及警告,由你批准。 + +触发方式:**定时(Schedule)**、**文件夹变化(Folder change)**、**系统事件(System event)**、**网站或订阅检查(Website or feed check)**、**手动(Manual)**,也可以组合多个触发。 + +管理器分三个标签页: + +- **动态(Activity)**:每次运行的记录和状态,例如 **运行中(Running)**、**有发现(Found something)**、**没有新内容(Nothing new)**、**失败(Failed)**。可以 **全部标为已读(Mark all as read)**,或勾选 **显示没有新内容的运行(Show runs with nothing new)**。打开一次运行即打开它的会话。 +- **自动化(Automations)**:每个自动化的触发条件和权限,状态为 **开启(On)**、**关闭(Off)** 或 **已暂停(Paused)**;可以 **立即运行(Run now)**、以 JSON **编辑定义(Edit definition)** 并 **检查(Check)**,或删除。 +- **密钥(Secrets)**:自动化可以使用的值,例如 API 令牌。它们在这台电脑上加密保存,只交给引用它们的自动化,并在智能体读到的内容中隐去;只能在这台电脑的 Pine 桌面端修改。 + +每次运行都是项目里的一个会话,带工作流图标。 + +> [!NOTE] +> 自动化只在 Pine 运行时工作。希望关闭窗口后继续运行,请在 **通用(General)** 中开启 **在后台继续运行(Keep running in the background)**。 + +## Skills + +**Skills**(`Mod + S`)是可复用的工作方法:一份说明,告诉智能体某类工作该怎么做,以及可以用哪些工具。 + +- **全局(Global)** Skill 对所有项目可用,但需要在每个项目里单独打开开关;**项目(Project)** Skill 只属于当前项目。 +- 可以新建、编辑、按项目启用或删除。 + +## MCP 服务器 + +**MCP 服务器(MCP servers)**(`Mod + /`)通过 MCP 协议把外部工具接入智能体。每个服务器可以设为 **所有项目(All projects)** 可用或只在 **当前项目(Project)** 可用;可以添加、编辑、启用、移除和刷新状态。 + +> [!WARNING] +> 本地 MCP 服务器以你的用户权限在 Pine 沙箱之外运行。所以智能体新增、修改、重命名或启用 MCP 服务器时,无论处于哪种审批模式都会先问你,卡片会写明它运行的命令或连接的地址。只添加你信任的服务器。 diff --git a/pine/zh-CN/configuration/index.md b/pine/zh-CN/configuration/index.md new file mode 100644 index 0000000..90f82ab --- /dev/null +++ b/pine/zh-CN/configuration/index.md @@ -0,0 +1,39 @@ +--- +title: "进阶配置" +description: "Pine 的全部可选功能和设置项:每一项做什么、默认值是什么、在哪里打开。" +order: 35 +--- + +# 进阶配置 + +[使用 Pine](../using-pine.md) 讲了最基本的项目、会话和审批。这一组页面把 Pine 的可选功能和设置项逐一讲清楚:每一项做什么、默认是什么、在哪里打开。它们都不是必须的,需要时按主题查阅即可。 + +> [!NOTE] +> 文中 `Mod` 在 macOS 上是 `Cmd`,在 Windows 上是 `Ctrl`。界面文案写成「中文(English)」,与 Pine 的中文和英文界面对应。 + +## 按主题查找 + +- [设置详解](settings.md):**Pine 设置(Pine Settings)** 里通用、外观、模型、智能体、自定义、项目管理各分区的每一个选项 +- [审批与自动审核](approvals.md):四种审批模式、自动审批路径、审批卡片上的信息,以及哪些操作永远需要你确认 +- [会话进阶](sessions.md):追加要求、引用与追问、附件、中途回答、交互式回答、上下文与费用、子会话,以及让智能体整理会话和项目 +- [工作台与文件预览](workbench.md):右侧工作台的各个面板、文件详情、预览批注、音视频播放器和图片查看 +- [自动化、Skills 与 MCP](automations.md):无人值守的自动化任务、可复用的 Skills,以及接入外部工具的 MCP 服务器 +- [远程控制](remote.md):浏览器访问、经 Aldine 配对手机或其他设备、保持电脑唤醒、后台运行与托盘菜单 +- [微信远程](wechat.md):用自己的微信给 Pine 派任务,以及微信里可用的全部命令 +- [快捷键](shortcuts.md):所有键盘快捷键 + +## 设置在哪里 + +点标题栏的齿轮图标打开 **Pine 设置(Pine Settings)**。左侧是分区列表(手机上先显示分区列表): + +| 分区 | 主要内容 | 详见 | +| --- | --- | --- | +| **通用(General)** | 语言、货币、Monet 模式、完成提示、通知、快速提问、后台运行、诊断日志 | [设置详解](settings.md) | +| **外观(Appearance)** | 配色模式、默认颜色主题、工作光效、侧栏材质、文档反色 | [设置详解](settings.md) | +| **模型(Models)** | 模型目录刷新、标题生成、审批、图像与视频生成、Decisions 初筛模型 | [设置详解](settings.md) | +| **智能体(Agent)** | 交互式回答、中途回答、自动审批路径、上下文压缩、网络工具、大致位置 | [设置详解](settings.md) | +| **自定义(User profile)** | 昵称、人称代词、语言风格、技术背景、个人细节、自定义指令 | [设置详解](settings.md) | +| **项目管理(Projects)** | 所有项目及其数据占用,清理临时文件和附件 | [设置详解](settings.md) | +| **远程控制(Remote control)** | 保持唤醒、经 Aldine 配对设备、浏览器访问、微信 | [远程控制](remote.md)、[微信远程](wechat.md) | + +自动化、Skills 和 MCP 服务器不在设置对话框里,而是在左侧栏顶部的 **更多功能(More)** 菜单中,见[自动化、Skills 与 MCP](automations.md)。 diff --git a/pine/zh-CN/configuration/remote.md b/pine/zh-CN/configuration/remote.md new file mode 100644 index 0000000..0881bf6 --- /dev/null +++ b/pine/zh-CN/configuration/remote.md @@ -0,0 +1,63 @@ +--- +title: "远程控制" +description: "浏览器访问、经 Aldine 配对手机或其他设备、保持电脑唤醒、后台运行与托盘菜单。" +order: 6 +--- + +# 远程控制 + +**Pine 设置(Pine Settings)→ 远程控制(Remote control)**(仅桌面端)让你在别的设备上使用这台电脑上的 Pine。所有远程方式都只在 Pine 运行、电脑未睡眠时可用。用微信派任务见[微信远程](wechat.md)。 + +## 浏览器访问 + +**浏览器访问(Browser access)** 让 Pine 在浏览器里提供完整界面,是经 Aldine 远程控制的前提。开启前需要先设置 **访问密码(Access password)**(至少 8 个字符),浏览器用它登录。 + +| 选项 | 说明 | +| --- | --- | +| **要求密码(Require password)** | 默认开启。只有在 Pine 前面已有其他登录手段(例如 Cloudflare Access)时才关闭;关闭后,任何能访问该地址的人无需登录即可控制 Pine,并能在这台电脑上运行命令 | +| **保持登录(Stay signed in)** | 浏览器输入密码后保持登录多久:**直到关闭浏览器**、1 天、7 天或 30 天 | +| **允许局域网访问(Allow LAN access)** | 同一网络中的其他设备可以打开 Pine。流量是未加密的 HTTP,只在可信网络中使用 | +| **公开地址(Public address)** | 通过反向代理或 Cloudflare Tunnel 等隧道提供 Pine 时,填写对外地址,例如 `https://pine.example.com` | +| **端口(Port)** | Pine 监听的端口;修改后需要重新打开访问链接 | +| **访问链接(Access link)** | 在本机用 `127.0.0.1` 打开 Pine,可以复制或直接在浏览器中打开 | +| **已登录的浏览器(Signed-in browsers)** | **全部退出登录(Sign out all)** 让所有浏览器重新输入密码。修改密码也会让它们退出 | + +> [!CAUTION] +> 能登录浏览器访问的人可以读取你的项目、运行智能体,并在这台电脑上执行命令。访问密码请勿与其他地方共用。 + +## 经 Aldine 远程控制 + +**经 Aldine 远程控制(Remote control via Aldine)** 用二维码或链接配对任意设备,无需端口转发,内容端到端加密。 + +1. 先开启 **浏览器访问(Browser access)**。 +2. 点 **配对新设备(Pair a device)**,用另一台设备的系统相机扫描二维码,或在它的浏览器里打开配对链接。对话框会显示二维码和链接的剩余有效时间,过期后可以 **重新生成(New code)**。 +3. 在这台电脑上确认配对。对话框会显示这台电脑的指纹,便于核对。 + +> [!TIP] +> 请用系统自带的相机和浏览器扫码打开,不要用微信、支付宝、QQ 里的扫一扫。 + +**已配对的设备(Paired devices)** 列出每台设备的配对和上次连接时间,可以 **重命名(Rename)** 或 **移除(Remove)**;移除后该设备立即断开,需要重新配对。 + +在手机上: + +- 把 Pine 远程控制网页添加到主屏幕后,可以在应用里用 **扫描配对二维码(Scan pairing code)** 或 **粘贴配对链接(Paste pairing link)** 添加电脑,电脑会保存在这个应用里。粘贴时链接前后多余的文字会被忽略。 +- 配对了多台电脑时,用 **切换电脑(Switch computer)** 回到电脑列表,也可以从那里再添加一台。 +- 在手机上,Pine 使用适合小屏幕的布局:对话框全屏显示,列表和详情分步呈现。 + +## 保持电脑唤醒 + +分区顶部的 **远程控制开启时保持电脑唤醒(Keep the computer awake while remote control is on)** 默认关闭。开启后,只要浏览器访问开着或微信正在接收任务,电脑就不会自动睡眠;显示器仍可以关闭,合上笔记本盖子仍会睡眠。没有任何远程控制开启时,电脑照常睡眠。 + +## 后台运行与托盘菜单 + +在 **通用(General)** 中开启 **在后台继续运行(Keep running in the background)** 后,关闭最后一个窗口,Pine 会留在菜单栏(macOS)或通知区域(Windows)。托盘菜单包括: + +- **打开 Pine(Open Pine)**、**快速输入(Quick composer)** +- **浏览器访问(Browser access)**、**经 Aldine 远程控制(Remote Control via Aldine)**、**微信远程(WeChat remote)** 开关 +- **远程控制时保持电脑唤醒(Keep computer awake for remote control)** +- **管理更多设置…(Manage more settings…)**:打开远程控制设置 +- 正在运行的会话数,以及 **退出 Pine(Quit Pine)** + +要停止自动化和所有远程控制,需要从托盘菜单退出 Pine。有会话仍在运行、远程控制开启或微信远程正在接收时,退出前会再次确认。 + +想让 Pine 在一台常开的机器上长期提供远程访问,见[在服务器上运行](../advanced/server.md)。 diff --git a/pine/zh-CN/configuration/sessions.md b/pine/zh-CN/configuration/sessions.md new file mode 100644 index 0000000..40bba4b --- /dev/null +++ b/pine/zh-CN/configuration/sessions.md @@ -0,0 +1,77 @@ +--- +title: "会话进阶" +description: "追加要求、引用与追问、附件、中途回答、交互式回答、上下文与费用、子会话,以及让智能体整理会话和项目。" +order: 3 +--- + +# 会话进阶 + +## 与运行中的智能体协作 + +- **追加要求(Steer response)**:智能体工作时,在输入框输入新消息并选择追加要求,它会在下一步读到,不必中断任务。暂存的消息显示在输入框上方,每条下面有 **撤回(Withdraw)** 和 **立即发送(Send now)**。 +- **停止回答(Stop response)**:随时中止本轮。 +- **编辑消息(Edit message)**:编辑自己发过的消息会从那里重新发送。 +- **任务清单(Todos)**:智能体列出任务清单时,输入框上方显示进度卡片,点开是 **全部任务(All todos)**,带依赖关系图。全部完成后,卡片在本轮结束时消失。 +- **后台进程(Background processes)**:智能体启动的长时间进程显示在卡片和工作台里,可查看命令、输出,或在运行中停止。 +- **等待提示**:消息发出约 3 秒后仍没有任何回复、思考或工具调用时,回复位置会提示 Pine 仍在等待模型服务商响应;持续几十秒请检查网络和服务商是否可用。 + +## 引用、追问与侧边对话 + +在对话中选中一段文字,会出现两个按钮: + +- **引用(Quote)**:把这段文字作为引用附到下一条消息。 +- **追问(Follow up)**:在工作台打开一个针对这段文字的侧边对话。追问随会话保存,原文会被高亮,点击高亮可以重新打开。 + +**侧边对话(Side chat)** 是关于当前会话的只读对话:它能读文件、搜索网页,但不能改动任何东西,适合在不打扰主线任务的情况下问问题。从工作台的面板切换器或 **添加卡片(Add card)** 打开的整段侧边对话标着 **不保存(Not saved)**,关闭后即丢弃。 + +长会话可以用 **对话大纲(Conversation outline)** 快速跳到之前的某一轮。 + +## 附件 + +点输入框的 **添加附件(Add attachment)** 可以添加 **文件(File)**、**文件夹(Folder)** 或 **会话(Conversation)**;也可以直接拖入文件、粘贴图片和长文本。 + +- **附加会话**:从左侧栏把一个会话拖进输入框,或在附件菜单中选择会话。智能体会读取那段对话,不需要审批。发出后点击会话附件可以打开它。 +- **从文件预览发送**:文件预览里的 **发送到选项卡…(Send to tab…)** 和 **发送选中范围到选项卡…(Send selection to tab…)** 把整个文件或选中内容附到某个会话;预览批注也能一次发到会话,见[工作台与文件预览](workbench.md)。 +- 在没有项目的新会话中输入 `@` 可以选择项目。 + +## 回答的形式 + +- **交互式回答(Interactive answers)**:回复里可以出现可勾选的清单、表格、图表、计算器和输入框。可在 **Pine 设置(Pine Settings)→ 智能体(Agent)** 中关闭。 +- **中途回答(Interim answers)**:智能体可以在耗时操作(例如网页搜索)前先给出初步答复,或在多部分问题中解决一部分就回复一部分,然后继续工作。它和普通回复一样可以选中、引用、搜索和导出。可在同一位置关闭。 +- **提问卡片**:智能体需要你补充信息时,输入框位置会出现问题卡片,可以用 **上一题(Previous)** / **下一题(Next)** 切换,也可以填写自由文本后 **提交(Submit)**。 + +## 上下文与费用 + +点输入框底部的 **上下文占用(Context usage)**: + +- 上半部分显示已用 token、上下文窗口、占用比例和缓存命中率,**立即压缩上下文(Compact context now)** 手动压缩。自动压缩的策略在[设置详解](settings.md)中配置。 +- 下半部分显示本会话的费用(货币在 **通用(General)** 中设置),以及 **会话成本上限(Session cost limit)** 开关和金额。达到上限会停止运行,并阻止发送新消息,直到你提高或取消上限。可以在会话开始前就设好。 + +输入框底部还可以切换本会话的 **模型(Model)** 和 **推理强度(Reasoning effort)**。 + +## 子会话与智能体开启的会话 + +你可以让智能体开启新的会话去处理相互独立的工作: + +- **子会话**:通常的选择。它属于当前会话,在左侧栏缩进显示在父会话下方,用连线相连;父会话行尾的箭头可以展开或收起(也可以再次点击已打开的父会话那一行)。子会话的标签页图标是两个对话气泡。子会话只有一层,它自己只能开同级会话。 +- **同级会话**:在当前项目或其他项目里开启的独立会话,在后台工作,出现在左侧栏,不会打开标签页或切走你当前的会话。 + +子会话完成一轮、失败或等待审批时,父会话里会出现一条标记(例如“子会话 {名称} 已完成”),点击即可打开;父会话的智能体会读取子会话的回复并继续工作,即使父会话没有打开标签页。子会话的审批要在它自己的标签页里处理。一个会话发给另一个会话的消息,会在接收方显示“由 {名称} 创建”或“来自 {名称}”,点击可以打开发送方。 + +智能体还可以搜索你所有项目里的会话。读取与当前工作无关的会话前需要经过审核:让我过目模式下弹出卡片,自动审批和自主工作模式下由审批模型审核,干就完了模式下不审核。它不能给这些会话发消息。 + +## 让智能体整理会话和项目 + +只要你开口,智能体可以: + +- **整理会话**:新建、重命名、删除会话文件夹,把会话移入或移出文件夹,重命名会话。删除会话始终需要你确认。 +- **管理项目**:用文件夹新建项目,重命名项目,增删文件夹,更换工作文件夹,设置图标和强调色,或删除项目。每一项改动在任何模式下都需要你确认。删除项目会删除它的会话,但保留磁盘上的文件夹;智能体不能删除自己所在的项目、**无项目(No Project)**,或仍有会话在运行的项目。 + +**会话标题**:Pine 在第一轮对话后为会话起标题;之后的消息开始了另一项任务时,智能体可能把标题更新为当前在做的事。你用重命名改过的标题会一直保留,直到你再次修改。 + +## 管理会话 + +- **搜索会话**:`Mod + K` 搜索所有项目的会话标题和内容。 +- **会话文件夹**:在项目分组标题的按钮上新建文件夹;右键文件夹可以 **重命名文件夹(Rename folder)** 或 **删除文件夹(Delete folder)**(其中的会话会回到项目下)。 +- **右键会话**:**重命名(Rename conversation)**、**导出(Export conversation)**(Markdown)、**移动到文件夹(Move to folder)**、**删除(Delete conversation)**(永久删除)。 +- 左侧栏里,运行中的会话标题会闪烁;停在审批上的会话行尾有盾牌图标(“等待你批准”);自动化运行带工作流图标;从微信发起或使用过的会话带对话气泡图标。 diff --git a/pine/zh-CN/configuration/settings.md b/pine/zh-CN/configuration/settings.md new file mode 100644 index 0000000..6f96c66 --- /dev/null +++ b/pine/zh-CN/configuration/settings.md @@ -0,0 +1,90 @@ +--- +title: "设置详解" +description: "Pine 设置中通用、外观、模型、智能体、自定义和项目管理各分区的每一个选项。" +order: 1 +--- + +# 设置详解 + +点标题栏的齿轮图标打开 **Pine 设置(Pine Settings)**。下面按分区逐项说明。**远程控制(Remote control)** 分区内容较多,单独写在[远程控制](remote.md)和[微信远程](wechat.md)。 + +## 通用(General) + +### 界面(Interface) + +- **语言(Language)**:界面语言。支持简体中文、繁体中文、英语、日语、韩语、西班牙语、法语、德语和俄语。 +- **货币(Currency)**:显示会话费用和费用上限时使用的货币。默认 **跟随系统(Follow system)**;按欧洲央行每日汇率换算,拿不到汇率时显示美元。 +- **Monet**:开启后,Pine 换用一种独特的回答语气,并为回复、会话标题、标题、输入框提示和模型选择器使用衬线阅读字体;你自己的消息、按钮、菜单和侧栏仍用界面字体。开启期间,**自定义(User profile)** 里的 **语言风格(Communication style)** 不可用,由 Monet 取代。 + +### 通知(Notifications) + +- **完成工作后发出信号(Signal when work is done)**:智能体完成一轮工作后提醒你,可选 **关闭(Off)**、**通知(Notification)** 或 **通知和声音(Notification and sound)**。 +- **批准和提问时发送通知(Notify for approvals and questions)**:Pine 在后台时,工具调用需要审批或 Pine 向你提问会弹出系统通知;审批通知上直接有批准和拒绝按钮。 + +### 系统(System) + +- **快速提问(Quick composer)**:设置一个全局快捷键,在任何应用里按下即可弹出一个浮动输入框开始新对话。授予屏幕录制和辅助功能权限后,它还能把最前面应用的窗口截图和选中的文字作为上下文;也可以在打开主窗口前添加文件、粘贴图片和长文本。 +- **在后台继续运行(Keep running in the background)**(macOS 和 Windows 桌面端):关闭最后一个窗口后,Pine 留在菜单栏(macOS)或通知区域(Windows),自动化、远程控制和快速提问继续可用。要彻底退出,从托盘图标选 **退出 Pine(Quit Pine)**。托盘菜单见[远程控制](remote.md)。 +- **诊断日志(Diagnostic logging)**:在本机记录错误和睡眠恢复事件,便于排查问题。只保留最近两份日志,合计约 2 MB;不记录对话内容,也不会自动上传。关闭后停止记录,已有日志保留。 + +## 外观(Appearance) + +- **配色模式(Color mode)**:**跟随系统(System)**、**浅色(Light)** 或 **深色(Dark)**。 +- **Pine 默认颜色主题(Pine default color theme)**:整个应用的默认主题色,可选 Neutral、Olive、Red、Rose、Orange、Green、Blue、Yellow、Violet,默认 Neutral。项目自己设置的强调色优先于它。 +- **工作光效(Working glow)**:智能体工作时,一道细光沿输入框边框顺时针流动,颜色取项目的强调色。默认开启,对所有已打开的窗口生效。系统开启“减少动态效果”时,光停在右下角不动。 +- **侧栏原生材质(Native sidebar material)**(macOS):用 macOS 原生的半透明材质绘制侧栏。 +- **深色模式下反色文档(Invert documents in dark mode)**:深色模式下,PDF、演示文稿等文档以反色页面打开,夜间阅读不刺眼。 + +## 模型(Models) + +模型的连接方法见[连接模型](../connect-models/index.md)。这里的选项决定各种辅助工作由哪个模型完成: + +- **模型目录(Model catalogs)**:点 **立即刷新(Refresh now)** 拉取已配置提供商的最新模型列表。 +- **标题生成模型(Title generation model)**:为新会话起标题。 +- **审批模型(Approval model)**:在 **自动审批(Auto Approve)** 和 **自主工作(Autonomous Work)** 模式下审核工具调用,并在把调用交给你时用白话解读操作。详见[审批与自动审核](approvals.md)。 +- **图像生成模型(Image generation model)**、**视频生成模型(Video generation model)**:智能体生成图片或视频时使用,需要先配置 OpenRouter,见[媒体生成](../connect-models/media-generation.md)。 +- **Decisions 初筛模型(Decisions screening model)**:自动审批路径选择 **基于决策模型(Decision model)** 时用来初筛的模型。 + +## 智能体(Agent) + +### 回答方式 + +- **交互式回答(Interactive answers)**:允许 Pine 在回复中放入可交互的清单、计算器、表格和图表。默认 **启用(Enabled)**。 +- **中途回答(Interim answers)**:允许 Pine 在搜索或处理完成前,先根据已知信息给出初步答复,或在多部分问题中解决一部分就先回复一部分,然后继续工作。默认 **启用(Enabled)**,从下一条消息开始生效。子会话和自动化运行不会发中途回答。 + +### 权限(Permissions) + +- **自动审批路径(Automatic approval path)**:自动审批时由谁做判断,可选 **大模型审批(Model review)** 或 **基于决策模型(Decision model)**(Beta)。两者的区别见[审批与自动审核](approvals.md)。 + +### 上下文(Context) + +对话太长、接近模型的上下文上限时,Pine 会压缩较早的内容,保留要点继续工作。 + +- **上下文压缩策略(Context compaction strategy)**:**使用推荐设置(Use recommended settings)** 在上下文占用达到 80% 时压缩,上限 40 万 token;**消极压缩(Passive compaction)** 沿用默认行为,接近上下文上限时才压缩。 +- **上下文压缩途径(Context compaction method)**:**大模型(Model)** 让当前模型写摘要;**语义化算法(Semantic algorithm)**(Beta)不调用模型,直接从对话中提取目标、文件改动、提交记录和简短记录,更快且不消耗 token。 + +随时手动压缩、查看费用和设置费用上限,见[会话进阶](sessions.md)。 + +### 工具与隐私(Tools & privacy) + +- **TinyFish 网络工具(TinyFish web tools)**:添加 TinyFish API 密钥后,智能体可以搜索网页和抓取页面。配置方法见[网页搜索](../connect-models/web-search.md)。 +- **向 AI 提供大致位置(Share approximate location with AI)**:Pine 从 Cloudflare 获取本机公网 IP,并用内置的 GeoIP 数据库在本机估算城市;只有城市、地区和国家会发给 AI。使用 VPN 或代理时位置可能不准。 + +## 自定义(User profile) + +这些信息帮助 Pine 更懂你。改动自动保存,从下一条消息起在所有对话中生效。 + +- **昵称(Nickname)**:Pine 在合适的时候这样称呼你。 +- **人称代词(Pronouns)**:Pine 以第三人称提到你时使用,例如替你写文档或消息时。可选 **不指定(Not specified)**(默认)、**他(he/him)**、**她(she/her)**、**TA(they/them)** 或 **自定义(Custom)**。 +- **语言风格(Communication style)**:**冷静专业(Calm & professional)**、**中性(Neutral)** 或 **热情亲和(Warm & friendly)**。Monet 模式开启时不可用。 +- **技术背景(Technical background)**:**一般用户(General user)** 少用术语、用目标导向的语言解释;**专业用户(Professional user)** 直接讲技术细节。审批卡片上的白话解读也会随它调整措辞。 +- **其他个人细节(Other personal details)**:你的工作、兴趣、偏好或当前目标。 +- **自定义指令(Custom instructions)**:希望 Pine 遵循的额外工作方式。安全和审批规则不受它影响。 + +## 项目管理(Projects) + +列出所有项目及 Pine 为它们保存的数据占用(会话、附件、临时文件、搜索缓存)。项目文件夹本身不会被改动。 + +- **新建项目(New Project)**、**编辑(Edit)**:设置名称、图标、强调色(**Pine 默认(Pine Default)** 跟随外观设置,或选一个自己的颜色)、默认文件夹,以及附加上下文文件夹的访问权限(**只读(Read only)** 或 **读写(Read and write)**)。 +- **清理临时文件(Clear temporary files)**:删除项目的临时文件。 +- **清理附件…(Clear attachments…)**:删除粘贴的图片和长文本。之前引用它们的消息将无法再预览这些附件,操作前会再次确认。 diff --git a/pine/zh-CN/configuration/shortcuts.md b/pine/zh-CN/configuration/shortcuts.md new file mode 100644 index 0000000..59e077b --- /dev/null +++ b/pine/zh-CN/configuration/shortcuts.md @@ -0,0 +1,80 @@ +--- +title: "快捷键" +description: "Pine 的全部键盘快捷键:标签页、窗口、管理器、图片查看、预览批注和音视频播放。" +order: 8 +--- + +# 快捷键 + +`Mod` 在 macOS 上是 `Cmd`,在 Windows 上是 `Ctrl`。 + +## 窗口与标签页 + +| 快捷键 | 作用 | +| --- | --- | +| `Mod + N` / `Mod + T` | 新建会话标签 | +| `Mod + W` | 关闭标签(中键点击标签也可以关闭) | +| `Mod + Shift + T` | 重新打开刚关闭的标签 | +| `Mod + Shift + N` | 新建窗口 | +| `Mod + Shift + R` | 重新加载窗口(单按 `Mod + R` 不会重新加载,以免误触) | +| `Mod + 1` … `Mod + 8` | 跳到对应位置的标签 | +| `Mod + 9` | 跳到最后一个标签 | +| `Mod + Alt + ←` / `→` | 上一个 / 下一个标签 | +| `Mod + B` | 显示 / 隐藏左侧栏 | +| `Mod + Alt + B` | 显示 / 隐藏右侧工作台 | +| `Mod + L` | 聚焦输入框 | + +## 管理器与搜索 + +| 快捷键 | 作用 | +| --- | --- | +| `Mod + K` | 搜索所有会话 | +| `Mod + P` | 打开 **Pine 设置 → 项目管理(Projects)** | +| `Mod + S` | Skills 管理器 | +| `Mod + U` | 自动化管理器 | +| `Mod + /` | MCP 服务器管理器 | + +快速提问(Quick composer)的全局快捷键在 **通用(General)** 中自行设置。 + +## 输入框与审批 + +| 快捷键 | 作用 | +| --- | --- | +| 回车 | 发送消息 | +| `Shift + 回车` | 换行 | +| `Esc` | 在“拒绝并说明要求”中返回按钮 | + +左侧栏中某个会话行获得焦点时,`→` / `←` 展开或收起它的子会话。 + +## 图片查看 + +在 Markdown 渲染视图中放大图片后: + +| 快捷键 | 作用 | +| --- | --- | +| `←` / `→` | 上一张 / 下一张 | +| `Mod + =` / `Mod + −` | 放大 / 缩小 | +| `Mod + 0` | 适合窗口 | +| `Esc` | 关闭 | + +## 预览批注 + +| 快捷键 | 作用 | +| --- | --- | +| `Mod + Alt + M` | 批注选中的文字或单元格 | +| 回车 / `Shift + 回车` | 批注框中保存 / 换行 | +| `Esc` | 取消批注,或取消正在框选的区域 | + +## 音视频播放 + +预览是当前标签、且焦点不在文本框中时可用: + +| 快捷键 | 作用 | +| --- | --- | +| 空格 / `K` | 播放 / 暂停 | +| `←` / `→` | 后退 / 前进 5 秒 | +| `J` / `L` | 后退 / 前进 10 秒 | +| `M` | 静音 | +| `F` | 全屏(视频) | +| `I` / `O` | 标记要批注的时间段起点 / 终点 | +| `Esc` | 清除标记 | diff --git a/pine/zh-CN/configuration/wechat.md b/pine/zh-CN/configuration/wechat.md new file mode 100644 index 0000000..eef8460 --- /dev/null +++ b/pine/zh-CN/configuration/wechat.md @@ -0,0 +1,97 @@ +--- +title: "微信远程" +description: "用自己的微信通过腾讯 ClawBot 给 Pine 派任务:连接、权限设置和全部命令。" +order: 7 +--- + +# 微信远程 + +**微信远程**(实验性)让你用自己的微信,通过腾讯 ClawBot 给这台电脑上的 Pine 发任务、看进度、处理审批和取回文件。设置在 **Pine 设置(Pine Settings)→ 远程控制(Remote control)→ 微信(WeChat)**。 + +> [!WARNING] +> 微信远程开启后,能进入你微信账号的人就能指挥这台电脑上的 Pine。消息会经过腾讯的服务器;已连接的账号可以读取所有项目的会话标题、搜索结果和回复。请按下面的说明设好权限边界。 + +## 连接微信 + +1. 点 **连接微信(Connect WeChat)**,用手机微信扫描对话框里的二维码,并在手机上确认。如果微信要求,再输入手机上显示的验证码。 +2. 在微信里给机器人发任意一条消息(一个句点就行),它会回复一个 6 位配对码。 +3. 把配对码填进对话框的六个格子(可以直接粘贴),填满即自动提交。配对码过期后点 **重试(Try again)**。 + +连接后,设置里显示 **微信账号 XXXX-XXXX** 和状态:**在线(Online)**、**正在连接(Connecting)**、**正在重试(Retrying)**、**需要重新扫码(Scan again needed)** 或 **已暂停(Paused)**。需要重新扫码时点 **重新扫码(Scan again)**。 + +一个微信账号只能连接一台电脑。使用代理或境外网络出口时,连接可能被拦截。 + +## 权限设置 + +| 选项 | 说明 | +| --- | --- | +| **接收来自微信的任务(Receive tasks from WeChat)** | 关闭后 Pine 忽略微信消息。只能在这台电脑上重新打开 | +| **默认项目(Default project)** | 从微信新建的会话放在哪个项目,或 **无项目(No Project)** | +| **最高审批模式(Highest approval mode)** | 微信驱动的会话不会以比它更宽松的模式运行。选择 **干就完了(YOLO)** 前会再次确认 | +| **默认审批模式(Default approval mode)** | 从微信新建会话时使用的模式,只能在最高审批模式以内 | +| **允许在微信中批准高风险操作(Allow approving high-risk actions from WeChat)** | 沙箱之外的原生执行和破坏性命令。默认关闭,此时这类操作只能在电脑上批准 | +| **允许向微信发送文件(Allow sending files to WeChat)** | 只发送会话的产出文件(智能体提交的结果),每个最多 100 MB。默认关闭。开启后,一次任务提交或打开的文件最多前三个会紧跟结果发出,其余用 `.o` 查看 | + +**断开(Disconnect)** 会先确认:只由微信持有的会话会停止,微信相关的权限设置恢复默认。 + +微信驱动的会话所开启或联系的其他会话,也受同样的上限约束。自动化的审批无论从哪里发起,都只能在电脑上处理。 + +## 在微信里使用 + +- **普通文字**发给当前会话。想在智能体运行时补充要求,用 `.queue` 把文字排进插话队列,它会在下一步读到。 +- **命令**以句点开头(`.` 或中文句号 `。` 都可以),发送 `.help`(或 `.?`)查看常用命令,`.h 2` 查看其余命令。 +- 回复以 Markdown 排版,列表和命令帮助以窄表格显示;回复过长时会截断,并提示如何查看全文。 +- 审批卡片和问题卡片带编号,发送 `.编号` 查看完整卡片;交互式回答的按钮也有编号,直接回复数字作答。 +- 发出超过 10 分钟才到达 Pine 的任务,会等你在微信里确认后才执行。 + +### 命令一览 + +| 命令 | 简写 | 作用 | +| --- | --- | --- | +| `.help [命令 \| 2]` | `.h` | 常用命令;`.h 2` 看其余命令 | +| `.status` | `.s`、单独一个 `.` | 当前会话和待处理事项 | +| `.info` | `.cfg` | 这台电脑和微信远程的设置 | +| `.lang zh \| en \| auto` | | 回复语言 | +| `.pause [all]` | | 暂停微信远程;`all` 同时停止运行中的会话。只能在电脑上恢复 | +| `.more` | `.0` | 下一页 | +| `.new [@项目] [文字]` | `.n` | 新建会话;不带文字则下一条消息开新会话 | +| `.sessions [@项目]` | `.l` | 最近的会话 | +| `.search 关键词` | `.f` | 搜索所有会话 | +| `.use [编号]` | `.u` | 切换当前会话(`.u 9` 是最新推送的会话) | +| `.last` | `.r` | 最后一轮的回复 | +| `.history [n]` | `.hi` | 最近几轮对话(默认 3,最多 10) | +| `.stop [all]` | `.x` | 停止当前运行;`all` 停止所有 | +| `.queue [文字]` | `.q` | 加入插话队列;不带文字则列出队列 | +| `.unqueue [N]` | `.qx` | 撤回排队的消息(默认最新一条) | +| `.rename 标题` | `.rn` | 重命名当前会话 | +| `.delete 编号` | `.del` | 删除从微信新建的会话(需确认) | +| `.model [编号]` | `.m` | 列出模型,或切换当前会话的模型 | +| `.effort [级别]` | `.e` | 推理强度 | +| `.mode [模式]` | `.mo` | 审批模式(不超过电脑上设的上限) | +| `.usage` | `.i` | 上下文和费用 | +| `.compact` | `.c` | 压缩上下文 | +| `.todo` | `.t` | 智能体的待办列表 | +| `.pending` | `.w` | 所有等你处理的审批和问题 | +| `.show 编号` | `.编号` | 完整显示一张卡片 | +| `.approve [编号]` | `.y` | 批准或确认 | +| `.reject [编号] [指导]` | `.d` | 拒绝或取消,可附上指导 | +| `.guide [编号] 文字` | `.g` | 拒绝并告诉智能体怎么做 | +| `.answer [编号] 答案` | `.a` | 回答问题卡片,多个问题用 `;` 分隔 | +| `.files [N]` | `.o` | 智能体提交的产出文件 | +| `.file N` | `.send` | 把一个文件发到微信 | +| `.tasks` | `.b` | 后台进程 | +| `.task N` | | 一个后台进程的输出 | +| `.kill N` | `.k` | 结束一个后台进程 | +| `.projects [编号]` | `.p` | 列出项目,或选择新会话用的项目 | +| `.autos [@项目]` | `.au` | 自动化列表 | +| `.auto N [on \| off \| run]` | | 一个自动化的详情、开关或立即运行 | +| `.runs [N]` | `.ar` | 自动化的运行记录 | +| `.skills` | `.sk` | 当前项目的 Skills | +| `.mcp` | | MCP 服务器 | +| `.drop` | | 丢弃还没发出的附件 | + +## 通知与托盘 + +即使关闭了通知,下列事件也一定会弹出系统通知:从微信新建会话、首次从微信使用已有会话、从微信批准高风险操作、向微信发送文件、从微信删除会话、从微信运行自动化、从微信把会话切到干就完了模式、需要重新扫码、微信远程被暂停或设置被重置。点击通知会把 Pine 窗口带到前台。 + +托盘菜单的 **微信远程(WeChat remote)** 开关可以随时暂停或恢复接收,作用与设置里的 **接收来自微信的任务** 相同。微信远程正在接收时退出 Pine 会再次确认,退出后将收不到从微信发来的任务。想让它长期在线,可以[在服务器上运行](../advanced/server.md) Pine。 diff --git a/pine/zh-CN/configuration/workbench.md b/pine/zh-CN/configuration/workbench.md new file mode 100644 index 0000000..c804edc --- /dev/null +++ b/pine/zh-CN/configuration/workbench.md @@ -0,0 +1,69 @@ +--- +title: "工作台与文件预览" +description: "右侧工作台的各个面板、文件详情、预览批注、音视频播放器和图片查看。" +order: 4 +--- + +# 工作台与文件预览 + +## 工作台 + +工作台是窗口右侧的面板(`Mod + Alt + B` 显示或隐藏),每个会话各有一份。它最多上下放两张卡片,中间的把手可以调整高低,左边缘可以拖动调整宽度。每张卡片标题栏有面板切换器、**在标签页中打开(Open in tab)**、**添加卡片(Add card)** 和关闭按钮。 + +| 面板 | 内容 | +| --- | --- | +| **产出文件(Artifacts)** | 本会话的交付成果:智能体明确提交的结果文件,最新的在前,带标题和一句话说明。只用来展示进度或对比的文件不在这里 | +| **后台进程(Background processes)** | 智能体启动的进程及其输出 | +| **预览(Preview)** | 智能体最近展示的文件,或从产出文件里选中的文件 | +| **文件(Files)** | 项目的文件树,显示各文件夹的访问权限 | +| **侧边对话(Side chat)** | 关于当前会话的只读对话,见[会话进阶](sessions.md) | + +智能体打开某张卡片或在预览中展示文件时,那张卡片会以黄色闪烁,直到你把鼠标移上去。智能体全屏展示的文件会在当前标签后面打开一个闪烁的标签页,不会抢走焦点。 + +## 文件预览 + +在文件树、会话或产出文件中点击文件,会以标签页打开预览。根据格式不同,预览提供 **渲染(Rendered)** / **文本(Text)** 视图、翻页、搜索、缩放、旋转、反色、工作表和图层切换,以及 **用默认应用打开(Open with default application)**。 + +### 详细信息与批注卡片 + +文件标签页在前台时,右侧栏不显示会话的卡片,而是显示这个文件的两张卡片:上方 **详细信息(Details)**,下方 **批注(Comments)**(仅限可以批注的项目文件)。右侧栏默认关闭,用预览底部的 **批注** 按钮(不能批注的文件显示为 **详细信息**)、标题栏的工作台按钮或 `Mod + Alt + B` 打开。 + +**详细信息** 列出类型、大小、修改和创建时间、位置,以及预览测得的编码、行数、尺寸、时长、页数、行列数,还有格式本身记录的信息,例如文档的标题、作者、应用和字数,照片的相机、拍摄时间和色彩模式,音视频的编码和标签,邮件的发件人和收件人,压缩包的条目。 + +### Markdown 图片查看 + +在 Markdown 文件的渲染视图中点击图片(或聚焦后按回车),窗口变模糊,图片放大到窗口中央。底部工具栏可以切换上一张 / 下一张、**适合窗口(Fit to window)**、缩小和放大;`Mod + 滚轮` 也能缩放,放大后可以拖动查看。点图片外面、关闭按钮或按 `Esc` 返回。 + +### 音视频播放器 + +音频和视频用 Pine 自己的播放器播放:进度条(点击或拖动跳转)、播放 / 暂停、当前时间和总长、**评论此刻(Comment on this moment)**、**循环播放(Loop)**、**播放速度(Playback speed)**、静音和音量,视频还有 **画中画(Picture in picture)** 和全屏。快捷键见[快捷键](shortcuts.md)。 + +## 预览批注 + +在项目文件的预览里,可以对文件的某些部分写下修改意见,攒够了再一次发给会话。 + +### 能批注什么 + +| 方式 | 适用格式 | +| --- | --- | +| 选中文字 | 文本、代码、Markdown(文本或渲染视图)、HTML、Word 等文档(DOCX、DOC、ODT、RTF、Pages)、PDF、幻灯片(PPTX、PPT、Keynote)、EPUB 电子书、邮件(EML、MSG) | +| 选中单元格 | 电子表格(XLSX、Numbers)、CSV / TSV 等数据表、SQLite 表 | +| 框选区域 | 图片、PDF 页面、幻灯片、PSD、OFD、Typst、PostScript、draw.io、Mermaid 等图表、思维导图 | +| 时间段 | 音频和视频 | + +### 怎么批注 + +- **文字和单元格**:选中后在浮动菜单中点 **批注(Comment)**,或按 `Mod + Alt + M`,输入意见。回车保存,`Shift + 回车` 换行,`Esc` 取消。 +- **区域**:点预览底部的 **框选批注(Comment on area)**,在图片、页面或幻灯片上拖出一个框,`Esc` 取消。 +- **时间段**:播放器里点 **评论此刻** 批注当前时间点;按住 `Shift` 在进度条上拖动,或在起点按 `I`、终点按 `O`,标出一段时间再批注。 + +批注过的文字以琥珀色高亮,单元格和区域以琥珀色框出,点击即可在右侧栏定位到那条批注。 + +### 管理和发送 + +- **批注** 卡片按文档顺序列出所有批注,每条显示位置(如“第 12 行”、“第 3 页”、“B2:D5”、“0:12–0:30”)、引用的原文和意见,可以编辑或删除。原文在文件改动后不复存在时,会标记为“原文已变化(Original text changed)”。 +- 卡片底部的 **发送 N 条批注(Send N comments)** 列出项目里的会话标签页和新会话。选一个,批注就以批注附件的形式(文件、位置和意见)放进那个会话的输入框,并从预览中清除。 +- **全部清除(Clear all)** 会先确认再删除。 + +> [!NOTE] +> 每个文件最多 50 条批注。批注只保存在内存中,发送或清除前一直有效,退出 Pine 后不会保留。 diff --git a/pine/zh-CN/using-pine.md b/pine/zh-CN/using-pine.md index bfa4cc3..072eb9a 100644 --- a/pine/zh-CN/using-pine.md +++ b/pine/zh-CN/using-pine.md @@ -64,7 +64,7 @@ order: 30 ## 可选配置 -这些都不是必须的,需要时再回来设置。 +这些都不是必须的,需要时再回来设置。每一项的完整说明见[进阶配置](configuration/index.md)。 | 想做的事 | 在哪里 | | --- | --- | From fc2bb8289b24007878cbf5be8cd2eb919efcee06 Mon Sep 17 00:00:00 2001 From: Xinyuan Weng Date: Sat, 14 Nov 2026 03:44:26 -0500 Subject: [PATCH 2/2] docs(pine): describe WeChat remote on a server Co-Authored-By: Claude Opus 5.5 --- pine/en/advanced/server.md | 33 +++++++++++++++++++++++++++++++++ pine/zh-CN/advanced/server.md | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+) diff --git a/pine/en/advanced/server.md b/pine/en/advanced/server.md index 4facdde..570f688 100644 --- a/pine/en/advanced/server.md +++ b/pine/en/advanced/server.md @@ -98,6 +98,39 @@ PINE_PASSWORD=... node apps/desktop/.vite/server/server.mjs --pair A removed device can never connect again. `--data-dir` / `PINE_DATA_DIR` must match what the server runs with. - A device can't pair other devices: pairing can only be started from the terminal. +## WeChat remote + +A server can also take [WeChat remote](../configuration/wechat.md), so an always-on machine receives tasks from WeChat at any time. Connecting needs an interactive terminal, because it shows a QR code and asks for the code WeChat sends: + +```sh +PINE_PASSWORD=... node apps/desktop/.vite/server/server.mjs --wechat-bind +``` + +The terminal shows a QR code; scan it with WeChat on your phone and confirm, then send any message to the bot in WeChat and type the 6-digit pairing code it replies with into the terminal. When Pine runs as a service, stop the service and run it once in the foreground to connect (with Docker, use `docker run -it`); after that, start it as usual. The connection is kept in the data directory. + +Check the status, disconnect and change settings with the `wechat` subcommand; `--data-dir` / `PINE_DATA_DIR` must match what the server runs with: + +```sh +node apps/desktop/.vite/server/server.mjs wechat status +node apps/desktop/.vite/server/server.mjs wechat unbind +node apps/desktop/.vite/server/server.mjs wechat config --ceiling auto-approve --default-project none +``` + +| `wechat config` option | What it does | +| --- | --- | +| `--ceiling ` | Highest approval mode: `let-me-review`, `auto-approve`, `autonomous` or `yolo` | +| `--default-mode ` | Approval mode of sessions started from WeChat, never above the ceiling | +| `--default-project ` | Project `.new` starts sessions in; `none` is the temporary workspace | +| `--allow-high-risk ` | Whether high-risk actions can be approved from WeChat | +| `--allow-files ` | Whether files can be sent to WeChat | +| `--language ` | Language of the replies in WeChat | +| `--pause` / `--resume` | Stop / resume acting on WeChat messages | + +A running server applies a change when it receives `SIGHUP` (`kill -HUP `) or restarts. When the login expires and WeChat needs a new scan, the log says so; run `--wechat-bind` in a terminal again as above. + +> [!WARNING] +> Setting the ceiling or default mode to `yolo` prints a warning: anyone who gets into that WeChat account controls this server. + ## Differences from the desktop app - The data directory is separate from the desktop app's, and projects and sessions aren't shared by default. You can point `--data-dir` at any directory, but don't let the desktop app and the server use the same one at the same time. diff --git a/pine/zh-CN/advanced/server.md b/pine/zh-CN/advanced/server.md index 85b6ffb..abe2c48 100644 --- a/pine/zh-CN/advanced/server.md +++ b/pine/zh-CN/advanced/server.md @@ -98,6 +98,39 @@ PINE_PASSWORD=... node apps/desktop/.vite/server/server.mjs --pair 移除后设备再也无法连接。`--data-dir` / `PINE_DATA_DIR` 与运行时一致。 - 设备不能再配对其他设备:配对只能由终端发起。 +## 微信远程 + +服务端也可以接入[微信远程](../configuration/wechat.md),让一台常开的机器随时接收微信里的任务。连接需要交互式终端,因为要显示二维码并输入微信发来的配对码: + +```sh +PINE_PASSWORD=... node apps/desktop/.vite/server/server.mjs --wechat-bind +``` + +终端会显示二维码;用手机微信扫码并确认,再在微信里给机器人发任意一条消息,把它回复的 6 位配对码输入终端。以服务方式运行时,先停止服务,在前台运行一次完成连接(Docker 用 `docker run -it`);之后正常启动即可,连接保存在数据目录里。 + +查看状态、断开和修改设置用 `wechat` 子命令,`--data-dir` / `PINE_DATA_DIR` 与运行时一致: + +```sh +node apps/desktop/.vite/server/server.mjs wechat status +node apps/desktop/.vite/server/server.mjs wechat unbind +node apps/desktop/.vite/server/server.mjs wechat config --ceiling auto-approve --default-project none +``` + +| `wechat config` 选项 | 作用 | +| --- | --- | +| `--ceiling <模式>` | 最高审批模式:`let-me-review`、`auto-approve`、`autonomous` 或 `yolo` | +| `--default-mode <模式>` | 从微信新建会话时的审批模式,不能高于最高审批模式 | +| `--default-project ` | `.new` 新建会话所在的项目;`none` 为临时工作区 | +| `--allow-high-risk ` | 是否允许从微信批准高风险操作 | +| `--allow-files ` | 是否允许向微信发送文件 | +| `--language ` | 微信里回复的语言 | +| `--pause` / `--resume` | 暂停 / 恢复处理微信消息 | + +运行中的服务端在收到 `SIGHUP`(`kill -HUP `)或重启时应用修改。登录失效需要重新扫码时,日志会提示,按上面的方式在终端里再运行一次 `--wechat-bind`。 + +> [!WARNING] +> 最高或默认审批模式设为 `yolo` 时,命令会打印警告:任何进入该微信账号的人都能控制这台服务器。 + ## 与桌面端的差异 - 数据目录与桌面端分开,默认不共享项目和会话;可以用 `--data-dir` 指向任意目录,但不要让桌面端和服务端同时使用同一个目录。