pisper 0.5.26 → 0.5.27-darwin-arm64.0

package/README.md

@@ -1,54 +1,61 @@
-# Pisper TUI 命令参考
+# Pisper TUI Command Reference
 
-[项目主页](https://ling-kong-ran.github.io/pisper/) · [GitHub 仓库](https://github.com/ling-kong-ran/pisper) · [English](./README.en.md)
+[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper) · [中文](./README.md)
 
-参数约定：`<参数>` 必填，`[参数]` 可选。
+Argument notation: `<argument>` is required; `[argument]` is optional.
 
-## CLI 命令
+## CLI Commands
 
-| 命令 | 解释 |
+| Command | Explanation |
 | :--- | :--- |
-| `pisper` | 在当前目录启动 TUI，并创建一个空会话；不会自动恢复历史会话。 |
-| `pisper --cwd <目录>` | 使用指定目录启动 TUI 并创建空会话。 |
-| `pisper resume` | 打开跨工作目录的历史会话选择器；没有历史会话时提示后退出。 |
-| `pisper resume --cwd <目录>` | 从指定启动目录进入历史会话选择器；恢复后仍使用会话自身保存的工作目录。 |
-| `pisper doctor` | 检查 Sidecar、Runtime 鉴权、能力目录与最近会话目录，并输出诊断信息。 |
-| `pisper doctor --cwd <目录>` | 以指定目录作为启动工作区执行诊断。 |
-| `pisper web` | 安装或使用 Web 前端，并在默认浏览器打开本机认证配置页；命令运行期间需保持进程存活。 |
-| `pisper web --cwd <目录>` | 以指定目录启动 Runtime 并打开 Web 配置页。 |
-| `pisper help [COMMAND]` | 显示全局帮助；`pisper help web` 显示 Web 子命令帮助。 |
-| `pisper -h` / `pisper --help` | 显示命令帮助，不启动 Runtime。 |
-| `pisper -V` / `pisper --version` | 显示已安装的 TUI 版本。 |
-| `pisper update --check` | 检查 npm 安装的 Pisper 是否有更新，不执行安装。 |
-| `pisper update` | 使用当前 npm registry 更新 npm 安装的 Pisper，并重新校验组件。 |
-
-## Slash Command
-
-| 命令 | 解释 |
+| `pisper` | Start the TUI in the current directory with a new empty conversation. History is not resumed automatically. |
+| `pisper --cwd <directory>` | Start the TUI with a new empty conversation in the specified directory. |
+| `pisper resume` | Open the conversation picker across all workspaces. If no history exists, report it and exit. |
+| `pisper resume --cwd <directory>` | Open the conversation picker from a specified launch directory. A resumed conversation keeps its own saved working directory. |
+| `pisper doctor` | Diagnose Sidecar startup, Runtime authentication, capability catalogs, and the latest conversation directory. |
+| `pisper doctor --cwd <directory>` | Run diagnostics with the specified launch workspace. |
+| `pisper web` | Install or use the Web frontend and open its authenticated local settings page in the default browser. Keep the process running while using the page. |
+| `pisper web --cwd <directory>` | Start the Runtime for a specified directory and open the Web settings page. |
+| `pisper help [COMMAND]` | Show global help. `pisper help web` shows help for the Web subcommand. |
+| `pisper -h` / `pisper --help` | Show command help without starting the Runtime. |
+| `pisper -V` / `pisper --version` | Print the installed TUI version. |
+| `pisper update --check` | Check an npm-installed Pisper for updates without installing them. |
+| `pisper update` | Update an npm-installed Pisper through the active npm registry and verify the components again. |
+
+## Environment Variables
+
+| Variable | Description |
 | :--- | :--- |
-| `/init` | 分析当前项目并创建或完善项目根目录的 `AGENTS.md`；保留已有有效说明，不修改其他项目文件。 |
-| `/new` | 在 TUI 启动目录创建空会话；Agent 运行期间不可执行。 |
-| `/sessions` | 打开跨所有目录的历史会话选择器；Agent 运行期间不可切换会话。 |
-| `/dir <目录>` | 修改当前会话的工作目录；相对路径以当前会话目录为基准，Agent 运行期间不可修改。 |
-| `/changes` | 打开 Git 或 SVN 改动视图。视图内 `R` 刷新、`C` 提交、`P` 推送 Git、连续两次 `V` 撤销；SVN 不提供 Push。 |
-| `/changes commit <message>` | 使用指定提交信息提交当前 Git 或 SVN 工作区改动。 |
-| `/chat` | 从其他视图返回 Chat 消息流。 |
-| `/model` | 打开模型选择器并切换当前会话模型；只列出已配置 Provider 的模型，Agent 运行期间不可切换。 |
-| `/thinking` | 刷新并选择当前模型支持的思考等级；Agent 运行期间不可切换。 |
-| `/provider [id]` | 编辑 Provider 协议、当前生效 Base URL 与掩码 API Key；传入 `id` 可直达指定 Provider。 |
-| `/apikey [id]` | `/provider` 的兼容别名。 |
-| `/web` | 使用已安装的 Web 前端，在默认浏览器打开本机认证配置页。 |
-| `/compact` | 立即摘要较早上下文；仅适用于有足够历史且当前空闲的会话。 |
-| `/attach` | 打开当前会话目录的附件选择器。 |
-| `/mode` | 显示当前执行模式及可用值；Agent 运行期间也可调整。 |
-| `/mode approval-required` | 写入、Shell 和高风险工具执行前请求授权。 |
-| `/mode workspace-write` | 自动批准工作区修改和常规命令。 |
-| `/mode full-access` | 允许以当前系统用户权限访问本机文件、网络与 Shell。 |
-| `/quit` | 退出 TUI。 |
-
-## Tool 与 Skill 命令
-
-| 形式 | 解释 |
+| `PISPER_TUI_MOUSE=1` | Enable mouse wheel scrolling in the transcript; note that mouse capture replaces the terminal's native text selection. |
+| `PISPER_TUI_REDUCED_MOTION=1` | Disable the typewriter reveal and status animations (streaming text appears immediately); useful on low-end terminals and SSH sessions. |
+
+## Slash Commands
+
+| Command | Explanation |
+| :--- | :--- |
+| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. Existing useful guidance is preserved, and no other project files are changed. |
+| `/new` | Create an empty conversation in the TUI launch directory. Unavailable during an Agent run. |
+| `/sessions` | Open the conversation picker across all directories. Switching is unavailable during an Agent run. |
+| `/dir <directory>` | Change the active conversation's working directory. Relative paths resolve from its current directory. Unavailable during an Agent run. |
+| `/changes` | Open Git or SVN changes. In that view, `R` refreshes, `C` commits, `P` pushes Git, and pressing `V` twice reverts. SVN has no Push operation. |
+| `/changes commit <message>` | Commit the current Git or SVN changes with an explicit message. |
+| `/chat` | Return to the Chat message stream from another view. |
+| `/model` | Open the model picker and switch the active conversation model. Only configured Provider models are listed. Unavailable during an Agent run. |
+| `/thinking` | Refresh and select thinking levels supported by the active model. Unavailable during an Agent run. |
+| `/provider [id]` | Edit a Provider's protocol, effective Base URL, and masked API key. Pass `id` to open a known Provider directly. |
+| `/apikey [id]` | Compatibility alias for `/provider`. |
+| `/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 conversations with enough history. |
+| `/attach` | Open the attachment picker rooted at the active conversation directory. |
+| `/mode` | Show the active execution mode and accepted values. The mode can also change during an Agent run. |
+| `/mode approval-required` | Ask before writes, Shell commands, and high-risk tools. |
+| `/mode workspace-write` | Auto-approve workspace edits and routine commands. |
+| `/mode full-access` | Allow local files, network access, and Shell commands as the current operating-system user. |
+| `/quit` | Exit the TUI. |
+
+## Tool and Skill Commands
+
+| Form | Explanation |
 | :--- | :--- |
-| `/<tool> [请求]` | 请求 Runtime Tool，例如 `/read README.md`、`/bash npm test` 或 `/web_search Pisper`。Agent 仍负责生成参数并调用 Tool，当前执行模式与 Tool 开关继续生效。 |
-| `/skill:<name> [请求]` | 请求已启用 Skill，例如 `/skill:docs-search 查找签名要求`。Runtime 按需加载 Skill 资源，其中触发的 Tool 继续经过同一权限链。 |
+| `/<tool> [request]` | Request a Runtime Tool, for example `/read README.md`, `/bash npm test`, or `/web_search Pisper`. The Agent still generates arguments and calls the Tool; the active execution mode and Tool settings remain enforced. |
+| `/skill:<name> [request]` | Request an enabled Skill, for example `/skill:docs-search find signing requirements`. Runtime resources load on demand, and Tools invoked by the Skill follow the same permission chain. |

package/components/runtime/Pisper_Runtime_Node_0.5.25_darwin_aarch64.tar.gz.sig

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOEdrUDR6WWM3VlRxNFlCZHhvTW92M01ZQmVjWSsvdUZJVW9YWEtUcUFLR0V0VGxkNDRFMlRocmN4WERXY283OEpGOFBXb29TYnBzeXBveHpma3NNY3c0PQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg4MDMzNDQ5CWZpbGU6UGlzcGVyX1J1bnRpbWVfTm9kZV8wLjUuMjVfZGFyd2luX2FhcmNoNjQudGFyLmd6CkI5c1RROWlYcWFDajlJbW0rYVo4YnRyWXhxdkIwcW1sbm5mU0tBRzhxUlQ1YnVKRGJSRHJoVHAxYzVGdWFtVVVxdm50L1dEUk5YdjVBSTBEVXAveURnPT0K

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

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IHNpZ25hdHVyZSBmcm9tIHRhdXJpIHNlY3JldCBrZXkKUlVTa3p5NWdvVExsOE5RZFRPaWdhb3d4aW5JNmZ2TTZHQlNNdE4xb2t2QWVWcG9aUWUwUUZRL25Qakh4QS8xQjY2ZTJRTzhINjVVMVRpbXBDcWJyT1V6WWhiSlVvL0xQSmdJPQp0cnVzdGVkIGNvbW1lbnQ6IHRpbWVzdGFtcDoxNzg4MDMzMDI0CWZpbGU6UGlzcGVyX1RVSV9Db21wb25lbnRfMC41LjE2X2Rhcndpbl9hYXJjaDY0LnRhci5negorR21pZkxiMVFWNWhNeFUrQVpzQjd0WUhLajVhTExIWEh1WXMyY3VRcllUeFROTGRvSHhNeWR4K1FabUo1dUFaQ3dFS3RVcXhMdTBaWHF5NWdySCtDUT09Cg==

package/package.json

@@ -1,57 +1,35 @@
 {
   "name": "pisper",
-  "version": "0.5.26",
-  "description": "Pisper CLI.",
+  "version": "0.5.27-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.15",
-    "runtimeVersion": "0.5.24"
-  },
-  "optionalDependencies": {
-    "pisper-binary-win32-x64": "npm:pisper@0.5.26-win32-x64.0",
-    "pisper-binary-darwin-x64": "npm:pisper@0.5.26-darwin-x64.0",
-    "pisper-binary-darwin-arm64": "npm:pisper@0.5.26-darwin-arm64.0",
-    "pisper-binary-linux-x64": "npm:pisper@0.5.26-linux-x64.0"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "pisperBundle": {
+    "target": "darwin_aarch64",
+    "tuiVersion": "0.5.16",
+    "runtimeVersion": "0.5.25"
   }
 }

package/README.en.md

@@ -1,54 +0,0 @@
-# Pisper TUI Command Reference
-
-[Project home](https://ling-kong-ran.github.io/pisper/) · [GitHub repository](https://github.com/ling-kong-ran/pisper) · [中文](./README.md)
-
-Argument notation: `<argument>` is required; `[argument]` is optional.
-
-## CLI Commands
-
-| Command | Explanation |
-| :--- | :--- |
-| `pisper` | Start the TUI in the current directory with a new empty conversation. History is not resumed automatically. |
-| `pisper --cwd <directory>` | Start the TUI with a new empty conversation in the specified directory. |
-| `pisper resume` | Open the conversation picker across all workspaces. If no history exists, report it and exit. |
-| `pisper resume --cwd <directory>` | Open the conversation picker from a specified launch directory. A resumed conversation keeps its own saved working directory. |
-| `pisper doctor` | Diagnose Sidecar startup, Runtime authentication, capability catalogs, and the latest conversation directory. |
-| `pisper doctor --cwd <directory>` | Run diagnostics with the specified launch workspace. |
-| `pisper web` | Install or use the Web frontend and open its authenticated local settings page in the default browser. Keep the process running while using the page. |
-| `pisper web --cwd <directory>` | Start the Runtime for a specified directory and open the Web settings page. |
-| `pisper help [COMMAND]` | Show global help. `pisper help web` shows help for the Web subcommand. |
-| `pisper -h` / `pisper --help` | Show command help without starting the Runtime. |
-| `pisper -V` / `pisper --version` | Print the installed TUI version. |
-| `pisper update --check` | Check an npm-installed Pisper for updates without installing them. |
-| `pisper update` | Update an npm-installed Pisper through the active npm registry and verify the components again. |
-
-## Slash Commands
-
-| Command | Explanation |
-| :--- | :--- |
-| `/init` | Analyze the current project and create or improve `AGENTS.md` at the project root. Existing useful guidance is preserved, and no other project files are changed. |
-| `/new` | Create an empty conversation in the TUI launch directory. Unavailable during an Agent run. |
-| `/sessions` | Open the conversation picker across all directories. Switching is unavailable during an Agent run. |
-| `/dir <directory>` | Change the active conversation's working directory. Relative paths resolve from its current directory. Unavailable during an Agent run. |
-| `/changes` | Open Git or SVN changes. In that view, `R` refreshes, `C` commits, `P` pushes Git, and pressing `V` twice reverts. SVN has no Push operation. |
-| `/changes commit <message>` | Commit the current Git or SVN changes with an explicit message. |
-| `/chat` | Return to the Chat message stream from another view. |
-| `/model` | Open the model picker and switch the active conversation model. Only configured Provider models are listed. Unavailable during an Agent run. |
-| `/thinking` | Refresh and select thinking levels supported by the active model. Unavailable during an Agent run. |
-| `/provider [id]` | Edit a Provider's protocol, effective Base URL, and masked API key. Pass `id` to open a known Provider directly. |
-| `/apikey [id]` | Compatibility alias for `/provider`. |
-| `/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 conversations with enough history. |
-| `/attach` | Open the attachment picker rooted at the active conversation directory. |
-| `/mode` | Show the active execution mode and accepted values. The mode can also change during an Agent run. |
-| `/mode approval-required` | Ask before writes, Shell commands, and high-risk tools. |
-| `/mode workspace-write` | Auto-approve workspace edits and routine commands. |
-| `/mode full-access` | Allow local files, network access, and Shell commands as the current operating-system user. |
-| `/quit` | Exit the TUI. |
-
-## Tool and Skill Commands
-
-| Form | Explanation |
-| :--- | :--- |
-| `/<tool> [request]` | Request a Runtime Tool, for example `/read README.md`, `/bash npm test`, or `/web_search Pisper`. The Agent still generates arguments and calls the Tool; the active execution mode and Tool settings remain enforced. |
-| `/skill:<name> [request]` | Request an enabled Skill, for example `/skill:docs-search find signing requirements`. Runtime resources load on demand, and Tools invoked by the Skill follow the same permission chain. |

package/bin/pisper.mjs

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-
-import { spawn } from 'node:child_process'
-import process from 'node:process'
-import { fileURLToPath } from 'node:url'
-import { ensurePisperInstallation } from '../lib/install.mjs'
-import { handleNpmHelp, handleNpmUpdate } from '../lib/npm-update.mjs'
-
-const frontendRoot = fileURLToPath(new URL('../web', import.meta.url))
-
-try {
-  const arguments_ = process.argv.slice(2)
-  if (!handleNpmHelp(arguments_) && !(await handleNpmUpdate(arguments_))) {
-    const installation = await ensurePisperInstallation()
-    const child = spawn(installation.executable, arguments_, {
-      env: {
-        ...process.env,
-        PISPER_APP_ROOT: installation.appRoot,
-        PISPER_DISTRIBUTION: 'npm',
-        PISPER_FRONTEND_ROOT: frontendRoot,
-        PISPER_RUNTIME_NODE: process.execPath,
-      },
-      stdio: 'inherit',
-      windowsHide: false,
-    })
-
-    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
-      process.on(signal, () => {
-        if (!child.killed) child.kill(signal)
-      })
-    }
-
-    child.once('error', (error) => {
-      console.error(`pisper: failed to start the terminal client: ${error.message}`)
-      process.exitCode = 1
-    })
-    child.once('exit', (code, signal) => {
-      if (signal) {
-        process.kill(process.pid, signal)
-        return
-      }
-      process.exitCode = code ?? 1
-    })
-  }
-} catch (error) {
-  console.error(`pisper: ${error instanceof Error ? error.message : String(error)}`)
-  process.exitCode = 1
-}