pisper 0.5.6 → 0.5.7-darwin-arm64.0

package/README.md

@@ -1,42 +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)
 
-[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+ 时，可以直接通过 npm 安装 Pisper CLI。npm 会从当前配置的 registry 获取轻量启动器、包内 Web 前端以及当前平台的签名 TUI 与 Runtime 包，不再从 GitHub Releases 下载；安装过程会在本地完成验签和解压，命令返回后即可运行，不包含桌面壳：
+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
 ```
 
-npm 发行版使用 `pisper --help` 可直接查看首次使用、会话恢复、诊断、整体 npm 更新和 Web 配置入口，不需要另行查阅 README。
+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.
 
-安装 Pisper 桌面版后，也可以打开 **设置 → 应用更新**，安装、修复或卸载 `pisper` 命令。Pisper 将可执行文件安装到当前用户目录并管理对应的 `PATH` 项，不需要管理员权限。
+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.
 
-通过桌面版安装或卸载后需要完全重启终端宿主：Windows Terminal 需退出全部窗口后重开，IDE 内置终端需重启 IDE。
-
-也可以从源码构建完整发行目录：
+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>/
@@ -45,176 +43,180 @@ release/tui/pisper-<version>-<platform>-<arch>/
 └── sidecar-runtime/
 ```
 
-## 发行版更新
+## Distribution Updates
 
-npm 发行版提供一个整体更新入口，不提供 TUI、Runtime 或 Web 组件选择：
+Check or update an npm installation of Pisper:
 
 ```bash
 pisper update --check
 pisper update
 ```
 
-该命令使用当前配置的 npm registry 更新 launcher、包内 Web、签名 TUI 与 Runtime 平台包。npm 安装过程会完成本地验签和解压，返回后即可直接运行。独立 TUI 不提供组件更新命令或后台更新检查；桌面发行版统一由 **设置 → 应用更新** 管理。无内置 sidecar 的独立轻量 TUI 在缺少 Runtime 时仍会安装所需的签名 Runtime，保证首次启动可用。
+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
 ```
 
-npm 发行版会直接使用包内 Web 前端；独立 TUI 在本地没有 Web 时才安装签名 Web 组件。该命令启动只监听 `127.0.0.1` 的 Runtime，并通过一次性认证入口在默认浏览器打开 Provider 设置。终端中的 Pisper 进程需要在浏览器使用期间保持运行。Web 配置页的 **保存 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` 会打开跨所有 workspace 的交互式会话列表；使用方向键选择，按 `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 workspace; 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 workspace:
 
 ```bash
 pisper --cwd /path/to/project
 ```
 
-诊断 sidecar、鉴权和能力目录：
+Inspect sidecar, authentication, and capability status:
 
 ```bash
 pisper doctor
 ```
 
-诊断输出会列出 sidecar 连接来源、TUI 启动目录、sidecar runtime fallback 目录，以及该 workspace 的最近会话目录，便于定位目录继承问题。
+The diagnostic output reports the sidecar connection source, TUI launch workspace, sidecar runtime fallback workspace, and the latest matching session workspace so directory inheritance failures are visible.
+
+## Composer and Message Stream
 
-## Composer 与消息流
+- `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.
 
-- `Enter`：提交消息；Agent 运行期间提交的无附件文本会立即追加到当前 run，与桌面端使用相同的 Runtime `steer` 队列。带附件的消息会保留到当前 run 结束后发送，避免丢失附件。
-- `/`：打开由 runtime Tools、已启用 Skills 和内置命令合并而成的 Slash 列表。
-- `Up` / `Down`：移动 Slash、会话、模型、思考等级或文件选择器中的选中项。
-- `Tab`：仅在 Slash 列表打开时补全当前候选。
-- `Esc`：关闭当前选择器、清空 Slash 草稿，或从 Changes 返回 Chat。
-- `↑` / `↓`：逐行翻阅消息；`PageUp` / `PageDown`：每次翻阅 8 行。TUI 仅保留最新 100 条消息，避免长会话持续占用内存。
-- `Home` / `End`、`Left` / `Right`、`Backspace` / `Delete`：编辑 composer 草稿。
-- `Ctrl+C`：Agent 运行或等待审批时中止当前 run（若 Agent 卡住未在超时窗口内响应，Runtime 会强制结束该次运行）；运行中再次 `Ctrl+C` 强制退出 TUI；空闲时退出 TUI。
+The bottom status bar is left-aligned. While a session is running, a single breathing light (a glyph that cycles from dim to bright and back, e.g. `○ ◔ ◑ ◕ ●`) appears at the far left 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.
 
-最底部状态栏以 `token: 88M cache 79%` 的紧凑格式显示当前会话 Provider 返回的 Token 总量和真实缓存命中率，数据按会话隔离。
+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` | 分析当前项目并创建或完善 workspace 根目录的 `AGENTS.md`。 |
-| `/new` | 在 TUI 启动时的 workspace 新建空会话；运行期间不可执行。 |
-| `/sessions` | 打开跨所有 workspace 的历史会话选择器；按 `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` | 打开 workspace 文件选择器。 |
-| `/mode` | 显示当前执行模式和可用参数；运行期间也可随时调整。 |
-| `/mode read-only` | 只开放低风险分析工具，不允许修改项目。 |
-| `/mode full-access` | 允许本机文件、网络和 Shell 完整访问。 |
-| `/quit` | 退出 TUI。 |
+| `/init` | Analyze the current project and create or improve `AGENTS.md` at the workspace root. |
+| `/new` | Create an empty conversation in the TUI launch workspace; unavailable during a run. |
+| `/sessions` | Open the history picker across every workspace; 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 workspace 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 workspace 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 workspace file picker. |
+| `/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`：返回上级目录，但不会越过当前 workspace。
-- `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 workspace.
+- `Delete`: remove the selected attachment.
+- `Esc`: close the picker while preserving the composer draft.
 
-安全限制与桌面端一致：最多 8 个文件，单文件不超过 10 MiB，总计不超过 20 MiB；只允许 workspace 内的图片、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 workspace-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 开关或当前执行模式；附件仍限制在当前 workspace 内。
+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 workspace.
 
-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` does not expose write or Shell capabilities. `full-access` means the user explicitly allows unrestricted access as the current operating-system user.
 
-`read-only` 模式不会开放写入或 Shell 能力；`full-access` 代表用户明确允许以当前系统用户权限完整访问。
+## 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 workspace:
 
 ```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.7_darwin_aarch64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOE5aQjhQQmZhdEV2OTl2VlhhSEc3M1B4L1FtTFV5SGpjcVE4S0ZZTjd6VWVZWDBwQXUwMUhhY3I5dHJ5aTJjUWJBRDBUOXlyYWpkdGFPTGxteHg5SWdFPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MDc2NzY0CWZpbGU6UGlzcGVyX1J1bnRpbWVfTm9kZV8wLjUuN19kYXJ3aW5fYWFyY2g2NC50YXIuZ3oKN1VOK0h0MWJYbEJsU2JVQzh2bjBJeXd0Sk1ZOC9HZlJBUTc1SUZrbzJQbk4wQXZ3Q1NwUExoWmkreEhlWGVlMmloZmUrYnpTUzUvbnFTWXNITlRFQnc9PQo=

package/components/tui/Pisper_TUI_Component_0.5.5_darwin_aarch64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOEdCcEJvVlRUdGNrRFl5MDNxVUZ4WnplY2h6V1I0bWk5S3J5Y0pVMk9VcXdKQXhPVHgxSUZQVHdvZ2s2dXMrRlYwNGd5cHZONWk4Nzh1dnc5WnhFV0FNPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg3MDc2MzcwCWZpbGU6UGlzcGVyX1RVSV9Db21wb25lbnRfMC41LjVfZGFyd2luX2FhcmNoNjQudGFyLmd6ClhOVENieFl6RXdyaDV0aml3QUZrUGdobll0aTBEQjhNUGJ4WU82QXNaWXNiTk43UkZkMWdOMnN6U2ZwRzlVOUtTM2ZKeFYyR24vWWNFMTVwK0I0aEFRPT0K

package/package.json

@@ -1,57 +1,35 @@
 {
   "name": "pisper",
-  "version": "0.5.6",
-  "description": "Pisper CLI.",
+  "version": "0.5.7-darwin-arm64.0",
+  "description": "Pisper signed TUI and Node Runtime bundle for darwin-arm64.",
   "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": [
+    "arm64"
+  ],
   "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.4",
-    "runtimeVersion": "0.5.6"
-  },
-  "optionalDependencies": {
-    "pisper-binary-win32-x64": "npm:pisper@0.5.6-win32-x64.0",
-    "pisper-binary-darwin-x64": "npm:pisper@0.5.6-darwin-x64.0",
-    "pisper-binary-darwin-arm64": "npm:pisper@0.5.6-darwin-arm64.0",
-    "pisper-binary-linux-x64": "npm:pisper@0.5.6-linux-x64.0"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "pisperBundle": {
+    "target": "darwin_aarch64",
+    "tuiVersion": "0.5.5",
+    "runtimeVersion": "0.5.7"
   }
 }

package/README.en.md

@@ -1,224 +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)
-
-[GitHub project home](https://github.com/ling-kong-ran/pisper)
-
-[中文指南](https://github.com/ling-kong-ran/pisper/blob/release/src-tui/README.md)
-
-## Install the Terminal Command
-
-With Node.js 20+, install the Pisper CLI through npm. npm obtains the lightweight launcher, bundled Web frontend, and signed TUI and Runtime packages for the current platform from the configured registry, without downloading from GitHub Releases. Installation completes local signature verification and extraction so Pisper is ready when the command returns; it does not include the desktop shell:
-
-```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
-```
-
-Run `pisper --help` in the npm distribution for complete first-run, resume, diagnostics, complete npm updates, and Web configuration guidance without consulting a separate README.
-
-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
-
-The npm distribution provides one complete update entry point without TUI, Runtime, or Web component selection:
-
-```bash
-pisper update --check
-pisper update
-```
-
-This command uses the configured npm registry to update the launcher, bundled Web frontend, and signed TUI and Runtime platform packages. npm installation completes local signature verification and extraction so Pisper is ready when the command returns. The standalone TUI exposes no component-update command or background update check; the desktop distribution is managed through **Settings → App updates**. A standalone thin TUI without a bundled sidecar can still install its required signed Runtime so its first startup succeeds.
-
-## 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
-```
-
-The npm distribution uses its bundled Web frontend directly; a standalone TUI installs the signed Web component only when no local Web frontend exists. This command starts a Runtime bound only to `127.0.0.1` and opens Provider settings through a one-time authenticated entry point in your default browser. Keep the Pisper terminal process running while using the browser. **Save Provider settings** saves only the current connection; only **Set as default Provider** changes the default model for later sessions. Saving configuration or switching the default does not interrupt an actively running session.
-
-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 workspace; 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 workspace:
-
-```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 workspace, sidecar runtime fallback workspace, and the latest matching session workspace 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. The TUI retains only the latest 100 messages so long sessions stay memory-bounded.
-- `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 shows the active session's provider-reported token total and cache hit rate in the compact form `token: 88M cache 79%`. The values remain isolated per conversation.
-
-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 workspace root. |
-| `/new` | Create an empty conversation in the TUI launch workspace; unavailable during a run. |
-| `/sessions` | Open the history picker across every workspace; 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 workspace 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 workspace 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 workspace file picker. |
-| `/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 fold completed items and retain `Plan · completed/total` in the footer.
-
-## 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 workspace.
-- `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 workspace-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 workspace.
-
-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
-
-Run from source in the current directory:
-
-```bash
-npm run tui:dev
-```
-
-Choose another workspace:
-
-```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
-```