pisper 0.5.8 → 0.5.9-darwin-x64.0

package/README.md

@@ -1,40 +1,40 @@
 # Pisper TUI
 
-![Pisper TUI 启动画面](https://ling-kong-ran.github.io/pisper/shots/cli.png)
+![Pisper TUI welcome screen](https://ling-kong-ran.github.io/pisper/shots/cli.png)
 
-![Pisper TUI Chat 与实时活动](https://ling-kong-ran.github.io/pisper/shots/cli-chat.png)
+![Pisper TUI chat and live activity](https://ling-kong-ran.github.io/pisper/shots/cli-chat.png)
 
-[项目主页](https://ling-kong-ran.github.io/pisper/) · [GitHub 仓库](https://github.com/ling-kong-ran/pisper)
+[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper)
 
-[English guide](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.en.md)
+[中文指南](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.md)
 
-## 安装终端命令
+## Install the Terminal Command
 
-需要 Node.js 20+。安装后直接运行 `pisper`：
+Requires Node.js 20+. Install Pisper, then run `pisper`:
 
 ```bash
 npm install -g pisper --progress=true --foreground-scripts
 pisper
 ```
 
-使用 npm 镜像时，平台包会走同一个 registry。`--progress=true` 显示 npm 下载进度，`--foreground-scripts` 显示本地验签和解压阶段；需要查看请求和缓存明细时再增加 `--loglevel=info`：
+Platform packages use the same registry when an npm mirror is configured. `--progress=true` shows npm download progress, while `--foreground-scripts` shows local signature verification and extraction; add `--loglevel=info` only when request and cache details are needed:
 
 ```bash
 npm install -g pisper --registry=https://registry.npmmirror.com --progress=true --foreground-scripts
 ```
 
-安装 Pisper 桌面版后，也可以打开 **设置 → 应用更新**，安装、修复或卸载 `pisper` 命令。Pisper 将可执行文件安装到当前用户目录并管理对应的 `PATH` 项，不需要管理员权限。
+After installing the Pisper desktop app, you can alternatively open **Settings → App updates** to install, repair, or uninstall the `pisper` command. Pisper installs it in a current-user directory and manages the matching `PATH` entry without administrator access.
 
-通过桌面版安装或卸载后需要完全重启终端宿主：Windows Terminal 需退出全部窗口后重开，IDE 内置终端需重启 IDE。
+After installing or uninstalling through the desktop app, restart the terminal host. Fully quit and reopen Windows Terminal, or restart the IDE that owns an integrated terminal.
 
-也可以从源码构建完整发行目录：
+To build the complete distribution from source:
 
 ```bash
 npm run sidecar:sea
 npm run tui:package
 ```
 
-产物位于：
+The output is written to:
 
 ```text
 release/tui/pisper-<version>-<platform>-<arch>/
@@ -43,180 +43,180 @@ release/tui/pisper-<version>-<platform>-<arch>/
 └── sidecar-runtime/
 ```
 
-## 发行版更新
+## Distribution Updates
 
-检查或更新 npm 安装的 Pisper：
+Check or update an npm installation of Pisper:
 
 ```bash
 pisper update --check
 pisper update
 ```
 
-命令使用当前配置的 npm registry。桌面版更新在 **设置 → 应用更新** 中管理。
+The command uses the configured npm registry. Manage desktop updates under **Settings → App updates**.
 
-## Provider 与可选 Web 配置
+## Provider and Optional Web Configuration
 
-首次进入 TUI 后输入 `/provider` 并选择 Provider，即可编辑协议类型、Base URL 和 API Key。Base URL 会预填 Runtime 当前生效地址：未自定义时显示官方默认地址，已自定义时显示自定义地址；API Key 留空会保留已保存的密钥。使用 `Up`/`Down` 或 `Tab` 切换字段，使用 `Left`/`Right` 选择协议，`Enter` 保存，`Esc` 返回 Provider 列表或取消。API Key 使用独立掩码输入，粘贴时会移除空白字符，且密钥不会进入 composer、Slash 历史或 Runtime 的普通配置响应。已知 Provider 可直接输入 `/provider <id>` 跳过选择，例如 `/provider deepseek`；`/apikey` 保留为兼容别名，功能相同。
+After entering the TUI for the first time, run `/provider` and choose a Provider to edit its protocol, Base URL, and API key. The Base URL is prefilled with the Runtime's effective address: the official default when there is no override, or the custom address when one is configured. Leaving API Key blank preserves the saved secret. Use `Up`/`Down` or `Tab` to move between fields, `Left`/`Right` to choose a protocol, `Enter` to save, and `Esc` to return to the Provider list or cancel. The API key uses a separate masked input, whitespace is removed when pasting, and the secret never enters the composer, Slash history, or ordinary Runtime configuration responses. For a known Provider you can skip the picker with `/provider <id>`, e.g. `/provider deepseek`; `/apikey` remains a compatible alias.
 
-需要完整可视化配置时运行：
+For complete visual configuration, run:
 
 ```bash
 pisper web
 ```
 
-该命令在默认浏览器打开本机 Provider 设置；浏览器使用期间需保持终端中的 Pisper 进程运行。**保存 Provider 配置**只保存当前连接，**设为默认 Provider**才会修改后续会话的默认模型。
+This opens local Provider settings in your default browser. Keep the Pisper terminal process running while using the browser. **Save Provider settings** saves the current connection; **Set as default Provider** changes the default model for later sessions.
 
-Web 前端已安装时，可在 TUI 中输入 `/web` 再次打开配置页；尚未安装时先退出并运行 `pisper web`。
+After Web is installed, run `/web` in the TUI to reopen the settings page. If it is not installed yet, exit and run `pisper web` first.
 
-## 启动与会话
+## Startup and Sessions
 
-在项目目录运行：
+Run Pisper from a project directory:
 
 ```bash
 pisper
 ```
 
-普通 `pisper` 始终创建空会话，不会自动打开历史记录。显式使用 `resume` 会打开跨所有目录的交互式会话列表；使用方向键选择，按 `Enter` 恢复，按 `Esc` 退出：
+Plain `pisper` always creates an empty conversation. It never restores history automatically. Use `resume` explicitly to open an interactive list containing conversations from every directory; use the arrow keys to select one, press `Enter` to resume, or press `Esc` to exit:
 
 ```bash
 pisper resume
 ```
 
-没有历史会话时，`pisper resume` 会提示后退出，不会创建新会话。恢复只使用会话已保存的工作目录，不会将其改写为 TUI 启动目录。进入会话后可通过 `/dir <目录>` 显式修改该会话的工作目录；相对路径以当前会话目录为基准。
+When no history exists, `pisper resume` reports that condition and exits without creating a conversation. Resuming uses the conversation's saved working directory without rewriting it to the TUI launch directory. After entering a conversation, `/dir <directory>` explicitly changes its working directory; relative paths resolve from the current conversation directory.
 
-指定其他工作目录创建新会话：
+Create a new conversation for another directory:
 
 ```bash
 pisper --cwd /path/to/project
 ```
 
-诊断 sidecar、鉴权和能力目录：
+Inspect sidecar, authentication, and capability status:
 
 ```bash
 pisper doctor
 ```
 
-诊断输出会列出 sidecar 连接来源、TUI 启动目录、sidecar runtime fallback 目录，以及该目录下最近的会话，便于定位目录继承问题。
+The diagnostic output reports the sidecar connection source, TUI launch directory, sidecar runtime fallback directory, and the latest matching session directory so directory inheritance failures are visible.
 
-## Composer 与消息流
+## Composer and Message Stream
 
-- `Enter`：提交消息；Agent 运行期间提交的无附件文本会立即追加到当前 run，与桌面端使用相同的 Runtime `steer` 队列。带附件的消息会保留到当前 run 结束后发送，避免丢失附件。
-- `/`：打开由 runtime Tools、已启用 Skills 和内置命令合并而成的 Slash 列表。
-- `Up` / `Down`：移动 Slash、会话、模型、思考等级或文件选择器中的选中项。
-- `Tab`：仅在 Slash 列表打开时补全当前候选。
-- `Esc`：关闭当前选择器、清空 Slash 草稿，或从 Changes 返回 Chat。
-- `↑` / `↓`：逐行翻阅消息；`PageUp` / `PageDown`：每次翻阅 8 行。历史消息按需分页加载，内存中最多保留 160 条，空闲后回收到最近 80 条，避免长会话持续占用内存。
-- `Home` / `End`、`Left` / `Right`、`Backspace` / `Delete`：编辑 composer 草稿。
-- `Ctrl+C`：Agent 运行或等待审批时中止当前 run（若 Agent 卡住未在超时窗口内响应，Runtime 会强制结束该次运行）；运行中再次 `Ctrl+C` 强制退出 TUI；空闲时退出 TUI。
+- `Enter`: submit a message. Plain text submitted during an active run is appended immediately through the same Runtime `steer` queue as the desktop app. Messages with attachments wait until the active run finishes so their attachments are preserved.
+- `/`: open the combined list of runtime Tools, enabled Skills, and built-in commands.
+- `Up` / `Down`: move through Slash, session, model, thinking-level, or file choices.
+- `Tab`: complete the highlighted candidate only while the Slash list is open.
+- `Esc`: close a picker, clear a Slash draft, or return from Changes to Chat.
+- `↑` / `↓`: scroll the conversation one row at a time; `PageUp` / `PageDown`: move eight rows. History loads on demand; the TUI keeps at most 160 messages in memory and evicts back to the latest 80 after an idle period.
+- `Home` / `End`, `Left` / `Right`, `Backspace` / `Delete`: edit the composer draft.
+- `Ctrl+C`: abort the active or approval-blocked run (if the Agent hangs without responding, the Runtime force-settles the run after a timeout); a second `Ctrl+C` while still running force-quits the TUI; exits only while idle.
 
-最底部状态栏整体左对齐。会话运行期间，最左侧显示一段彩色能量波，波峰沿固定宽度的柱段来回移动，例如 `▁▂▄▆█▆▄`，不再显示 `Thinking`、`Responding` 等阶段文字；之后依次显示执行模式、模型、思考等级和指标，例如 `▁▂▄▆█▆▄  [full-access]  gpt-5.6-sol  high  ·  88M  ·  cache 79%`。队列和审批位置追加在指标之后，数据按会话隔离。
+The bottom status bar is left-aligned. While a session is running, a colorful energy wave appears at the far left, with its peak traveling back and forth across a fixed-width set of bars, for example `▁▂▄▆█▆▄`, instead of phase labels such as `Thinking` or `Responding`. Execution mode, model, thinking level, and metrics follow, for example `▁▂▄▆█▆▄  [full-access]  gpt-5.6-sol  high  ·  88M  ·  cache 79%`. Queue and approval positions follow the metrics. The values remain isolated per conversation.
 
-TUI 默认使用终端真彩色，并在 `TERM` 表明仅支持 256 色时自动降级。可用 `PISPER_TUI_THEME=ansi256` 强制 256 色，或用 `PISPER_TUI_THEME=monochrome` / `NO_COLOR=1` 使用单色模式。设置 `PISPER_TUI_REDUCED_MOTION=1` 会关闭装饰动画并立即显示完整流式文本；翻阅历史消息时也会暂停逐字揭示。
+The TUI uses terminal truecolor by default and automatically falls back when `TERM` advertises only 256 colors. Set `PISPER_TUI_THEME=ansi256` to force the 256-color palette, or use `PISPER_TUI_THEME=monochrome` / `NO_COLOR=1` for monochrome output. `PISPER_TUI_REDUCED_MOTION=1` disables decorative animation and reveals streamed text immediately; scrolling through history also pauses incremental reveal.
 
-长文本或多行 bracketed paste 会在 composer 中折叠为 `[Pasted text · …]`，但提交给 Agent 的仍是包含原始换行的完整文本。摘要可作为整体移动和删除。
+Long or multiline bracketed pastes render as a compact `[Pasted text · …]` token. The complete original text, including line breaks, is still submitted to the Agent. The token can be moved across or deleted as one unit.
 
-## 内置命令
+## Built-in Commands
 
-| 命令 | 作用 |
+| Command | Action |
 | :--- | :--- |
-| `/init` | 分析当前项目并创建或完善项目根目录的 `AGENTS.md`。 |
-| `/new` | 在 TUI 启动目录新建空会话；运行期间不可执行。 |
-| `/sessions` | 打开跨所有目录的历史会话选择器；按 `Enter` 恢复，运行期间不可切换。 |
-| `/dir <目录>` | 显式修改当前会话的工作目录；相对路径以当前会话目录为基准，运行期间不可修改。 |
-| `/changes` | 查看 Git 或 SVN 工作区改动；改动页中 `R` 刷新、`C` 提交、`P` 推送 Git、连续按两次 `V` 撤销；SVN 没有 Push。 |
-| `/changes commit <message>` | 使用指定 message 提交当前 Git/SVN 工作区改动。 |
-| `/chat` | 返回 Chat 消息流。 |
-| `/model` | 打开模型选择器并切换当前会话模型；只显示已配置 Provider 的模型，运行期间不可切换。 |
-| `/thinking` | 刷新并打开当前模型支持的思考等级；不支持或加载失败时显示原因并可重试，运行期间不可切换。 |
-| `/provider` | 编辑 Provider 的协议类型、当前生效 Base URL 和掩码 API Key；`/provider <id>` 可直达指定 Provider，`/apikey` 为兼容别名。 |
-| `/web` | 使用已安装的 Web 前端，在默认浏览器打开本机认证配置页。 |
-| `/compact` | 立即摘要较早上下文；仅用于已有可压缩历史的空闲会话。 |
-| `/attach` | 打开当前目录的文件选择器。 |
-| `/mode` | 显示当前执行模式和可用参数；运行期间也可随时调整。 |
-| `/mode read-only` | 只开放低风险分析工具，不允许修改项目。 |
-| `/mode full-access` | 允许本机文件、网络和 Shell 完整访问。 |
-| `/quit` | 退出 TUI。 |
+| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. |
+| `/new` | Create an empty conversation in the TUI launch directory; unavailable during a run. |
+| `/sessions` | Open the history picker across every directory; press `Enter` to resume. Unavailable during a run. |
+| `/dir <directory>` | Explicitly change the active conversation directory. Relative paths resolve from its current directory; unavailable during a run. |
+| `/changes` | Inspect Git or SVN changes. In the changes view, `R` refreshes, `C` commits, `P` pushes Git, and `V` twice reverts; SVN has no push operation. |
+| `/changes commit <message>` | Commit current Git/SVN changes with an explicit message. |
+| `/chat` | Return to the Chat message stream. |
+| `/model` | Open the model picker and switch the active session model; only models from configured Providers are listed, and switching is unavailable during a run. |
+| `/thinking` | Refresh and open thinking levels supported by the active model; unsupported/error states explain why and can be retried. Unavailable during a run. |
+| `/provider` | Edit a Provider's protocol, effective Base URL, and masked API key; `/provider <id>` targets a Provider directly and `/apikey` remains a compatible alias. |
+| `/web` | Open the authenticated local settings page in the default browser using the installed Web frontend. |
+| `/compact` | Summarize older context immediately; available only for idle sessions with enough history. |
+| `/attach` | Open the file picker for the current directory. |
+| `/mode` | Show the active execution mode and accepted values; it can be changed during a run. |
+| `/mode read-only` | Expose low-risk analysis tools only. |
+| `/mode full-access` | Allow unrestricted local files, network, and Shell access. |
+| `/quit` | Exit the TUI. |
 
-命令候选会根据前缀匹配和本机使用频率排序。`Tab` 只补全，不会执行 Tool；选择内置命令后按 `Enter` 才执行。
+Candidates are sorted by prefix match and local usage frequency. `Tab` completes a command without executing a Tool; press `Enter` to select a built-in command.
 
-`/init` 会让 Agent 先检查项目结构、命令和约定，再生成项目专属的 `AGENTS.md`，而不是写入固定模板。已有文件会在保留有效说明的基础上谨慎更新，且该任务不会修改其他项目文件。`read-only` 模式下不能运行；`full-access` 模式下以当前系统用户权限执行。命令完成后使用 `/new`，可让新会话从启动时加载生成的项目说明。
+`/init` asks the Agent to inspect the project structure, commands, and conventions before writing repository-specific guidance instead of a fixed template. It carefully preserves useful content in an existing `AGENTS.md` and does not modify other project files. The command is unavailable in `read-only` mode and runs with current-user permissions in `full-access` mode. After it completes, use `/new` to start a session that loads the generated project guidance at startup.
 
-Agent 创建结构化 Plan 后，TUI 会在消息流和 Composer 之间原位显示步骤、负责人、依赖和状态；窄终端只保留当前项，顶部细分隔显示 `Plan 完成数/总数`。
+When the Agent creates a structured Plan, the TUI updates its items, owners, dependencies, and statuses in place between the transcript and Composer. Narrow terminals keep only the current item, with `Plan completed/total` in the thin top divider.
 
-## 附件
+## Attachments
 
-使用以下任一入口打开附件选择器：
+Open the attachment picker with any of these controls:
 
-- composer 为空时输入 `+`
-- `Ctrl+O`
-- `/attach`
+- type `+` while the composer is empty
+- press `Ctrl+O`
+- run `/attach`
 
-文件选择器操作：
+File picker controls:
 
-- `Up` / `Down`：选择文件或目录。
-- `Enter` / `Right`：进入目录或添加文件。
-- `Left`：返回上级目录，但不会越过当前目录。
-- `Delete`：移除当前已选附件。
-- `Esc`：关闭选择器并保留 composer 草稿。
+- `Up` / `Down`: select a file or directory.
+- `Enter` / `Right`: enter a directory or add a file.
+- `Left`: move to the parent without leaving the active directory.
+- `Delete`: remove the selected attachment.
+- `Esc`: close the picker while preserving the composer draft.
 
-安全限制与桌面端一致：最多 8 个文件，单文件不超过 10 MiB，总计不超过 20 MiB；只允许当前目录内的图片、UTF-8 文本/代码和支持的文档。仅当当前模型明确支持图片输入时，图片才会作为视觉输入发送。
+The desktop attachment boundary is shared by the TUI: up to 8 files, 10 MiB per file, and 20 MiB total. Files must be directory-local images, UTF-8 text/code, or supported documents. Images become visual input only when the active model explicitly supports images.
 
-## Tool 与 Skill
+## Tools and Skills
 
-输入 `/` 后，前缀 `T` 表示 runtime Tool，前缀 `S` 表示已启用且允许模型调用的 Skill。
+After typing `/`, `T` marks runtime Tools and `S` marks enabled, model-invocable Skills.
 
-Tool 示例：
+Tool examples:
 
 ```text
 /read README.md
 /bash npm test
 /web_search Pisper latest release
-/mcp_pencil_get_editor_state_f9837b9b 读取当前 Pencil 画布状态
+/mcp_pencil_get_editor_state_f9837b9b inspect the current Pencil canvas
 ```
 
-TUI 只把首个 Slash token 作为结构化 `requestedToolNames` 请求发送给 runtime。Agent 仍负责生成参数和调用 Tool，Slash 选择不会绕过 Tool 开关或当前执行模式；附件仍限制在当前目录内。
+The TUI sends the first Slash token through the structured `requestedToolNames` field. The Agent still generates arguments and performs the call. Slash selection never bypasses Tool settings or the active execution mode; attachments remain limited to the current directory.
 
-Skill 示例：
+Skill example:
 
 ```text
-/skill:docs-search 查找 Tauri updater 的签名要求
+/skill:docs-search find the Tauri updater signing requirements
 ```
 
-Skill 名称以当前 Slash 列表为准。runtime 会按需加载对应的 `SKILL.md`、脚本和参考资料，Skill 内触发的 Tool 仍走相同权限链。
+The active Slash list is authoritative for Skill names. The runtime loads the matching `SKILL.md`, scripts, and references on demand. Tools invoked by a Skill follow the same permission chain.
 
-`read-only` 模式不会开放写入或 Shell 能力；`full-access` 代表用户明确允许以当前系统用户权限完整访问。
+`read-only` does not expose write or Shell capabilities. `full-access` means the user explicitly allows unrestricted access as the current operating-system user.
 
-## 本地开发
+## Local Development
 
-从源码构建 TUI 需要 Rust 1.88 或更高版本。
+Building the TUI from source requires Rust 1.88 or newer.
 
-从源码启动当前目录：
+Run from source in the current directory:
 
 ```bash
 npm run tui:dev
 ```
 
-指定工作目录：
+Choose another directory:
 
 ```bash
 npm run tui:dev -- --cwd /path/to/project
 ```
 
-开发版默认运行仓库中的 `runtime/sidecar.mjs`。也可以连接已经运行的隔离 sidecar：
+Development runs `runtime/sidecar.mjs` by default. To connect an isolated running sidecar:
 
 ```text
 PISPER_TUI_URL=http://127.0.0.1:<port>
 PISPER_TUI_TOKEN=<desktop token>
 ```
 
-或指定 sidecar 可执行文件和 runtime：
+Or specify a sidecar executable and runtime:
 
 ```text
 PISPER_SIDECAR_PATH=/path/to/pisper-sidecar
 PISPER_APP_ROOT=/path/to/sidecar-runtime
 ```
 
-## 验证
+## Verification
 
 ```bash
 npm run tui:test

package/components/runtime/Pisper_Runtime_Node_0.5.8_darwin_x86_64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOEhiWEtDTFlEQm5zeFZUdHhrTndIV0xiOFhPdW12TXFxVVdZNC90VzFsZm1ia3RyKzU0YzYwU1NLTkFmODdITDZEU0V2ZllWQU8vQ3NVZWlXc2NyUUE4PQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MTY2NzUwCWZpbGU6UGlzcGVyX1J1bnRpbWVfTm9kZV8wLjUuOF9kYXJ3aW5feDg2XzY0LnRhci5negpwYThSNWdjdkxKWWp4L2NKSTJ4UnVrckZsTml2TjRYdzk3VnNpNkhUWFNNNENqWE9vMmNOSGR0cVhHRTA2NG5qTXFIUXJoMjBtVnNGNDdUeTdvQVJEdz09Cg==

package/components/tui/Pisper_TUI_Component_0.5.7_darwin_x86_64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOEFNbnlGSmhoMUN1aVV2eG9oVXY5dExJQjdPVld1Q2ZMUC9VQ2h1QVlvNTJkRlZ1VCswM0ZZWHNCY1FoTVR6ZHp2dzVLcm5SS05OdUdHa05iTTlxMVFFPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MjA1MDAyCWZpbGU6UGlzcGVyX1RVSV9Db21wb25lbnRfMC41LjdfZGFyd2luX3g4Nl82NC50YXIuZ3oKZkhzY2dpMnBQbUd4eks0WGI2d0tWR2Q0dWlkR1AreDc5UU1ab24wcWNZQXIvRWdaU0REbjc1YnhUVXBZbE9idldReXRnSzNyWHFZTXBBTnZMeGNkQWc9PQo=

package/package.json

@@ -1,57 +1,35 @@
 {
   "name": "pisper",
-  "version": "0.5.8",
-  "description": "Pisper CLI.",
+  "version": "0.5.9-darwin-x64.0",
+  "description": "Pisper signed TUI and Node Runtime bundle for darwin-x64.",
   "license": "MIT",
   "author": {
     "name": "ling-kong-ran",
     "email": "65328093+ling-kong-ran@users.noreply.github.com",
     "url": "https://github.com/ling-kong-ran"
   },
-  "type": "module",
-  "homepage": "https://github.com/ling-kong-ran/pisper#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ling-kong-ran/pisper.git"
   },
-  "bugs": {
-    "url": "https://github.com/ling-kong-ran/pisper/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "bin": {
-    "pisper": "bin/pisper.mjs"
-  },
-  "scripts": {
-    "postinstall": "node lib/postinstall.mjs"
-  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
   "files": [
-    "bin/",
-    "lib/",
-    "web/",
-    "updater.pubkey",
+    "components/",
     "README.md",
-    "README.en.md",
     "LICENSE"
   ],
-  "dependencies": {
-    "@threema/wasm-minisign-verify": "0.1.3",
-    "tar": "7.5.22"
-  },
-  "pisper": {
-    "repository": "ling-kong-ran/pisper",
-    "tuiVersion": "0.5.6",
-    "runtimeVersion": "0.5.8"
-  },
-  "optionalDependencies": {
-    "pisper-binary-win32-x64": "npm:pisper@0.5.8-win32-x64.0",
-    "pisper-binary-darwin-x64": "npm:pisper@0.5.8-darwin-x64.0",
-    "pisper-binary-darwin-arm64": "npm:pisper@0.5.8-darwin-arm64.0",
-    "pisper-binary-linux-x64": "npm:pisper@0.5.8-linux-x64.0"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "pisperBundle": {
+    "target": "darwin_x86_64",
+    "tuiVersion": "0.5.7",
+    "runtimeVersion": "0.5.8"
   }
 }

package/README.en.md

@@ -1,226 +0,0 @@
-# Pisper TUI
-
-![Pisper TUI welcome screen](https://ling-kong-ran.github.io/pisper/shots/cli.png)
-
-![Pisper TUI chat and live activity](https://ling-kong-ran.github.io/pisper/shots/cli-chat.png)
-
-[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper)
-
-[中文指南](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.md)
-
-## Install the Terminal Command
-
-Requires Node.js 20+. Install Pisper, then run `pisper`:
-
-```bash
-npm install -g pisper --progress=true --foreground-scripts
-pisper
-```
-
-Platform packages use the same registry when an npm mirror is configured. `--progress=true` shows npm download progress, while `--foreground-scripts` shows local signature verification and extraction; add `--loglevel=info` only when request and cache details are needed:
-
-```bash
-npm install -g pisper --registry=https://registry.npmmirror.com --progress=true --foreground-scripts
-```
-
-After installing the Pisper desktop app, you can alternatively open **Settings → App updates** to install, repair, or uninstall the `pisper` command. Pisper installs it in a current-user directory and manages the matching `PATH` entry without administrator access.
-
-After installing or uninstalling through the desktop app, restart the terminal host. Fully quit and reopen Windows Terminal, or restart the IDE that owns an integrated terminal.
-
-To build the complete distribution from source:
-
-```bash
-npm run sidecar:sea
-npm run tui:package
-```
-
-The output is written to:
-
-```text
-release/tui/pisper-<version>-<platform>-<arch>/
-├── pisper[.exe]
-├── pisper-sidecar[.exe]
-└── sidecar-runtime/
-```
-
-## Distribution Updates
-
-Check or update an npm installation of Pisper:
-
-```bash
-pisper update --check
-pisper update
-```
-
-The command uses the configured npm registry. Manage desktop updates under **Settings → App updates**.
-
-## Provider and Optional Web Configuration
-
-After entering the TUI for the first time, run `/provider` and choose a Provider to edit its protocol, Base URL, and API key. The Base URL is prefilled with the Runtime's effective address: the official default when there is no override, or the custom address when one is configured. Leaving API Key blank preserves the saved secret. Use `Up`/`Down` or `Tab` to move between fields, `Left`/`Right` to choose a protocol, `Enter` to save, and `Esc` to return to the Provider list or cancel. The API key uses a separate masked input, whitespace is removed when pasting, and the secret never enters the composer, Slash history, or ordinary Runtime configuration responses. For a known Provider you can skip the picker with `/provider <id>`, e.g. `/provider deepseek`; `/apikey` remains a compatible alias.
-
-For complete visual configuration, run:
-
-```bash
-pisper web
-```
-
-This opens local Provider settings in your default browser. Keep the Pisper terminal process running while using the browser. **Save Provider settings** saves the current connection; **Set as default Provider** changes the default model for later sessions.
-
-After Web is installed, run `/web` in the TUI to reopen the settings page. If it is not installed yet, exit and run `pisper web` first.
-
-## Startup and Sessions
-
-Run Pisper from a project directory:
-
-```bash
-pisper
-```
-
-Plain `pisper` always creates an empty conversation. It never restores history automatically. Use `resume` explicitly to open an interactive list containing conversations from every directory; use the arrow keys to select one, press `Enter` to resume, or press `Esc` to exit:
-
-```bash
-pisper resume
-```
-
-When no history exists, `pisper resume` reports that condition and exits without creating a conversation. Resuming uses the conversation's saved working directory without rewriting it to the TUI launch directory. After entering a conversation, `/dir <directory>` explicitly changes its working directory; relative paths resolve from the current conversation directory.
-
-Create a new conversation for another directory:
-
-```bash
-pisper --cwd /path/to/project
-```
-
-Inspect sidecar, authentication, and capability status:
-
-```bash
-pisper doctor
-```
-
-The diagnostic output reports the sidecar connection source, TUI launch directory, sidecar runtime fallback directory, and the latest matching session directory so directory inheritance failures are visible.
-
-## Composer and Message Stream
-
-- `Enter`: submit a message. Plain text submitted during an active run is appended immediately through the same Runtime `steer` queue as the desktop app. Messages with attachments wait until the active run finishes so their attachments are preserved.
-- `/`: open the combined list of runtime Tools, enabled Skills, and built-in commands.
-- `Up` / `Down`: move through Slash, session, model, thinking-level, or file choices.
-- `Tab`: complete the highlighted candidate only while the Slash list is open.
-- `Esc`: close a picker, clear a Slash draft, or return from Changes to Chat.
-- `↑` / `↓`: scroll the conversation one row at a time; `PageUp` / `PageDown`: move eight rows. History loads on demand; the TUI keeps at most 160 messages in memory and evicts back to the latest 80 after an idle period.
-- `Home` / `End`, `Left` / `Right`, `Backspace` / `Delete`: edit the composer draft.
-- `Ctrl+C`: abort the active or approval-blocked run (if the Agent hangs without responding, the Runtime force-settles the run after a timeout); a second `Ctrl+C` while still running force-quits the TUI; exits only while idle.
-
-The bottom status bar is left-aligned. While a session is running, a colorful energy wave appears at the far left, with its peak traveling back and forth across a fixed-width set of bars, for example `▁▂▄▆█▆▄`, instead of phase labels such as `Thinking` or `Responding`. Execution mode, model, thinking level, and metrics follow, for example `▁▂▄▆█▆▄  [full-access]  gpt-5.6-sol  high  ·  88M  ·  cache 79%`. Queue and approval positions follow the metrics. The values remain isolated per conversation.
-
-The TUI uses terminal truecolor by default and automatically falls back when `TERM` advertises only 256 colors. Set `PISPER_TUI_THEME=ansi256` to force the 256-color palette, or use `PISPER_TUI_THEME=monochrome` / `NO_COLOR=1` for monochrome output. `PISPER_TUI_REDUCED_MOTION=1` disables decorative animation and reveals streamed text immediately; scrolling through history also pauses incremental reveal.
-
-Long or multiline bracketed pastes render as a compact `[Pasted text · …]` token. The complete original text, including line breaks, is still submitted to the Agent. The token can be moved across or deleted as one unit.
-
-## Built-in Commands
-
-| Command | Action |
-| :--- | :--- |
-| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. |
-| `/new` | Create an empty conversation in the TUI launch directory; unavailable during a run. |
-| `/sessions` | Open the history picker across every directory; press `Enter` to resume. Unavailable during a run. |
-| `/dir <directory>` | Explicitly change the active conversation directory. Relative paths resolve from its current directory; unavailable during a run. |
-| `/changes` | Inspect Git or SVN changes. In the changes view, `R` refreshes, `C` commits, `P` pushes Git, and `V` twice reverts; SVN has no push operation. |
-| `/changes commit <message>` | Commit current Git/SVN changes with an explicit message. |
-| `/chat` | Return to the Chat message stream. |
-| `/model` | Open the model picker and switch the active session model; only models from configured Providers are listed, and switching is unavailable during a run. |
-| `/thinking` | Refresh and open thinking levels supported by the active model; unsupported/error states explain why and can be retried. Unavailable during a run. |
-| `/provider` | Edit a Provider's protocol, effective Base URL, and masked API key; `/provider <id>` targets a Provider directly and `/apikey` remains a compatible alias. |
-| `/web` | Open the authenticated local settings page in the default browser using the installed Web frontend. |
-| `/compact` | Summarize older context immediately; available only for idle sessions with enough history. |
-| `/attach` | Open the file picker for the current directory. |
-| `/mode` | Show the active execution mode and accepted values; it can be changed during a run. |
-| `/mode read-only` | Expose low-risk analysis tools only. |
-| `/mode full-access` | Allow unrestricted local files, network, and Shell access. |
-| `/quit` | Exit the TUI. |
-
-Candidates are sorted by prefix match and local usage frequency. `Tab` completes a command without executing a Tool; press `Enter` to select a built-in command.
-
-`/init` asks the Agent to inspect the project structure, commands, and conventions before writing repository-specific guidance instead of a fixed template. It carefully preserves useful content in an existing `AGENTS.md` and does not modify other project files. The command is unavailable in `read-only` mode and runs with current-user permissions in `full-access` mode. After it completes, use `/new` to start a session that loads the generated project guidance at startup.
-
-When the Agent creates a structured Plan, the TUI updates its items, owners, dependencies, and statuses in place between the transcript and Composer. Narrow terminals keep only the current item, with `Plan completed/total` in the thin top divider.
-
-## Attachments
-
-Open the attachment picker with any of these controls:
-
-- type `+` while the composer is empty
-- press `Ctrl+O`
-- run `/attach`
-
-File picker controls:
-
-- `Up` / `Down`: select a file or directory.
-- `Enter` / `Right`: enter a directory or add a file.
-- `Left`: move to the parent without leaving the active directory.
-- `Delete`: remove the selected attachment.
-- `Esc`: close the picker while preserving the composer draft.
-
-The desktop attachment boundary is shared by the TUI: up to 8 files, 10 MiB per file, and 20 MiB total. Files must be directory-local images, UTF-8 text/code, or supported documents. Images become visual input only when the active model explicitly supports images.
-
-## Tools and Skills
-
-After typing `/`, `T` marks runtime Tools and `S` marks enabled, model-invocable Skills.
-
-Tool examples:
-
-```text
-/read README.md
-/bash npm test
-/web_search Pisper latest release
-/mcp_pencil_get_editor_state_f9837b9b inspect the current Pencil canvas
-```
-
-The TUI sends the first Slash token through the structured `requestedToolNames` field. The Agent still generates arguments and performs the call. Slash selection never bypasses Tool settings or the active execution mode; attachments remain limited to the current directory.
-
-Skill example:
-
-```text
-/skill:docs-search find the Tauri updater signing requirements
-```
-
-The active Slash list is authoritative for Skill names. The runtime loads the matching `SKILL.md`, scripts, and references on demand. Tools invoked by a Skill follow the same permission chain.
-
-`read-only` does not expose write or Shell capabilities. `full-access` means the user explicitly allows unrestricted access as the current operating-system user.
-
-## Local Development
-
-Building the TUI from source requires Rust 1.88 or newer.
-
-Run from source in the current directory:
-
-```bash
-npm run tui:dev
-```
-
-Choose another directory:
-
-```bash
-npm run tui:dev -- --cwd /path/to/project
-```
-
-Development runs `runtime/sidecar.mjs` by default. To connect an isolated running sidecar:
-
-```text
-PISPER_TUI_URL=http://127.0.0.1:<port>
-PISPER_TUI_TOKEN=<desktop token>
-```
-
-Or specify a sidecar executable and runtime:
-
-```text
-PISPER_SIDECAR_PATH=/path/to/pisper-sidecar
-PISPER_APP_ROOT=/path/to/sidecar-runtime
-```
-
-## Verification
-
-```bash
-npm run tui:test
-npm run tui:check
-cargo clippy --manifest-path src-tui/Cargo.toml --all-targets -- -D warnings
-cargo build --manifest-path src-tui/Cargo.toml --release
-```