dsh-packycode-api 1.2.7 → 1.2.8

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.2.8
+
+- **Diagnostics for request problems.** Settings → PackyCode gains a **Diagnostics** card (诊断信息). A user who hits "已达到输出 token 上限" or repeated failures picks the session (the 20 most recent top-level sessions, newest first, labelled by local start time, the workspace folder's base name and whether it is open), clicks **Generate diagnostics** and then **Copy**, and sends the text to the plugin author. Without a clipboard API the text is selected for a manual copy. The host builds the text from DSH's session history over two new RPC endpoints, `diagnostics/sessions` and `diagnostics/session`, in format `packycode-diagnostics/1`. It holds the plugin version; the session id, start time and live state; each stored key by position with its groups and reachable models; the logged request settings (provider, model, reasoning effort, `maxTokens`, and whether DSH's adapter supplied that ceiling); the steps that ended at the output limit; the latest steps' token usage and finish reasons; turn endings; retries and failed attempts with their codes; and the compaction count. Error messages are redacted and cut to 160 characters. Conversation text, reasoning, titles, tool arguments and results, paths, key labels and keys never enter it. An invalid session id or a runtime without session history is refused with its own message.
+- **Claude session titles come back as plain text in the user's language.** A Claude session's title runs on `claude-haiku-5-5` inside the Claude Code CLI, where DSH's title rules are only an appendix to the CLI's own system prompt and the user's text arrives as English framing around a JSON array. For a short message such as 在吗, the title came back as English or as raw JSON (`{"title": "Casual greeting check-in"}`). The CLI title prompt now ends by restating the rules: the bare title, not JSON or quoted, in the messages' language, named outright when the text is Chinese, Japanese or Korean. Only the CLI's last text block is read as the reply, so narration before a tool call is never taken for the title. The reply is then unwrapped from a code fence, a JSON object's `title` or a JSON string, a "Title:"/"标题：" label, or wrapping quotes before DSH reads it. A reply that holds no usable title yields no text, so DSH keeps its first-message fallback: several lines (live, Haiku once wrote its thinking on one line and the title on another), a placeholder such as 对话标题 / "Session title", or an empty wrapper. HTTP models' titles and delegated turns are unchanged.
+- README: an FAQ entry on reporting truncated replies and failing requests with the Diagnostics card, and a note on how Claude-session titles are restated and unwrapped.
+- Validation, 2026-10-15: 437 offline tests (10 new for diagnostics, 5 for titles), both rebuilt bundles and the versioned tarball. A browser replay of the built settings page showed the session picker, the generated text and, where the clipboard refused the write, the select-all fallback. Titles were replayed live through the built CLI adapter with DSH 0.2.0-rc.2's exact title request (system prompt, JSON framing, 64-token cap) and a `cc` key. Before the fix, 在吗 came back as `Greeting Check-In` and as `{"title": "Session greeting check"}`. After it, ten titles for 在吗, 你好, 你饿吗, hi and a Chinese repository question all came back as plain text, Chinese for Chinese messages, for about $0.08. No DSH restart.
+
 ## 1.2.7
 
 - **Image keys can be renamed.** Settings → PackyCode → Image generation and editing gains the same **Rename** action as conversation keys, through a new `images/keys/rename` endpoint on the image key ring (`packycode-api/image-keys`). Both cards share one rename form: the name becomes a text field, Enter or **Save** stores it, Escape or **Cancel** keeps the old one, and only the key id and the new label reach the host.

package/README.en.md

@@ -48,10 +48,10 @@ You need **DeepSeek Harness** and a **PackyCode (PackyAPI) API key**. For DSH se
 Open the desktop application's **Plugins** page, click **Add plugin**, and enter the package name **with a version** as the **package name or address**:
 
 ```text
-dsh-packycode-api@1.2.7
+dsh-packycode-api@1.2.8
 ```
 
-Choose the **official** install source, then click **Install**. `1.2.7` was the latest release when this was written; the [npm page](https://www.npmjs.com/package/dsh-packycode-api) shows the current one.
+Choose the **official** install source, then click **Install**. `1.2.8` was the latest release when this was written; the [npm page](https://www.npmjs.com/package/dsh-packycode-api) shows the current one.
 
 > **Always include the version.** With a bare `dsh-packycode-api`, the install prompt shows the newest version on npm, but DSH's bundled pnpm by default installs only versions published at least 24 hours ago, so you can end up several releases behind with no sign of it in the prompt. With an exact version, pnpm installs that version and adds it to the profile's `minimumReleaseAgeExclude` itself. Afterwards, check **Current version** under **Settings → PackyCode → Plugin version**.
 
@@ -72,7 +72,7 @@ Choose a model from the `PackyCode` group. `deepseek-flash`, `gpt-6.1-sol`, `gpt
 
 The **Plugins** page shows the installed state and version, and is also where you enable, disable, or uninstall.
 
-**For non-desktop profiles only:** `dsh plugin --profile <name> add dsh-packycode-api@1.2.7`. Do not use it for `desktop` — the CLI refuses it (`profile "desktop" is managed exclusively by the Electron application`).
+**For non-desktop profiles only:** `dsh plugin --profile <name> add dsh-packycode-api@1.2.8`. Do not use it for `desktop` — the CLI refuses it (`profile "desktop" is managed exclusively by the Electron application`).
 
 For a local checkout, keep the `link:` prefix: `dsh plugin --profile <name> add link:/path/to/dsh-packycode-api`. **Do not pass a bare path or `file:`** — that install copies the whole checkout, `node_modules` included, into the profile, where it then shadows the packages the DSH installation itself provides and the plugin looks uninstalled; see the FAQ. If you already installed that way, uninstall first and reinstall as above.
 
@@ -204,7 +204,7 @@ Only GPT Responses requests keep `prompt_cache_key`; other Responses models omit
 - The reasoning block opens with `▸ 启动 Claude Code CLI…` and then shows the CLI's version and model once it is up. When the gateway throttles or is busy (429, 503 `账号并发排队已满` / per-account wait queue full, and similar), the CLI retries up to 10 times on its own; each retry now shows as `↻ 网关返回 HTTP 503，CLI 自动重试 n/10` instead of looking hung. When the retries run out, the turn says PackyCode's Claude upstream is busy, not that the key is bad. A CLI that prints nothing for 2 minutes after starting is stopped and reported.
 - The conversation and its images reach the CLI over stdin (`--input-format stream-json`), not argv: a Windows command line is length-limited and cannot carry an image. Images in the conversation are sent to Claude as images, at the HTTP route's request size (at most 2048×2048, about 1 MiB each; at most 20 images and 20 MiB per turn, dropping the oldest first). An image left out is named with its read-only local copy, which the CLI can open with Read.
 - Every run carries `--append-system-prompt` (the delegation note). In `-p` mode the official CLI introduces itself as "You are Claude Code, Anthropic's official CLI for Claude …" when it has appended instructions and as "You are a Claude agent, built on Anthropic's Claude Agent SDK." when it has none; the latter was refused upstream as not coming from the official CLI (403 `only accepts requests from the official Claude Code CLI`). That is the official CLI's own behavior; the plugin does not rewrite its system prompt.
-- While the session model is a Claude model, titles are generated with `claude-haiku-5-5`, read-only, in a temporary directory, instead of a full Opus turn.
+- While the session model is a Claude model, titles are generated with `claude-haiku-5-5`, read-only, in a temporary directory, instead of a full Opus turn. Inside the CLI, DSH's title rules are only an appendix to the CLI's own system prompt, and a very short message such as 在吗 used to come back as English JSON (`{"title": "Casual greeting check-in"}`). The prompt therefore ends by restating them: the bare title as plain text, in the language of the messages (Chinese, Japanese and Korean are named by their script). A reply that still arrives in JSON, a code fence, quotes or after a "Title:" label is unwrapped before DSH reads it. A reply of several lines (the model wrote out its thinking or an explanation, so the title line cannot be told) or a bare placeholder such as "Session title" yields no title, and DSH keeps its default title from the first message.
 - While the session model is `gpt-6-astra`, titles are generated with `gpt-6.1-sol` (same Codex group); the turns themselves stay on Astra. Other models title their own sessions.
 - The `claude_code` tool can delegate one task to the local CLI while the session model is `gpt-6.1-sol`, `gpt-6-astra`, or `deepseek-flash`. The requested `mode` cannot exceed what the session preset allows. While the session is in plan mode the delegation plans too, and returns the plan text to the parent model.
 - An effort level the model does not support is rejected before the request is sent. Do not edit a model's effort map casually.
@@ -213,7 +213,7 @@ Only GPT Responses requests keep `prompt_cache_key`; other Responses models omit
 
 ## Update and uninstall
 
-**Update:** open **Settings → PackyCode** and, when a newer version is listed, click **Update plugin**. It installs that exact version into the owning profile with DSH's bundled pnpm and reads `package.json` back before reporting success. A local `link:` checkout does not get the button. Then quit and reopen the desktop application. A page refresh does not reload the Host. Reinstalling from the **Plugins** page works too, again with the version in the package name (for example `dsh-packycode-api@1.2.7`); without it you may get a version that is merely the newest one published at least 24 hours ago.
+**Update:** open **Settings → PackyCode** and, when a newer version is listed, click **Update plugin**. It installs that exact version into the owning profile with DSH's bundled pnpm and reads `package.json` back before reporting success. A local `link:` checkout does not get the button. Then quit and reopen the desktop application. A page refresh does not reload the Host. Reinstalling from the **Plugins** page works too, again with the version in the package name (for example `dsh-packycode-api@1.2.8`); without it you may get a version that is merely the newest one published at least 24 hours ago.
 
 **Coming back from a local-path install, uninstall first.** An update is a `pnpm add`: it rewrites the files inside the package directory and leaves a `node_modules` that an earlier local-path install left there. That older tree keeps shadowing the packages the DSH installation provides, so the plugin row fails to load with no visible reason. **Uninstall** runs `pnpm remove`, which deletes the package directory outright — only a reinstall after that is clean. `node scripts/install-check.mjs` reports whether a profile is in that state.
 
@@ -229,7 +229,7 @@ ls ~/.dsh/profiles/desktop/node_modules/dsh-packycode-api/node_modules
 
 Output means a leftover tree: a registry install ships no `node_modules`, so this one usually comes from an earlier local-path install (`file:`, or a bare path instead of `link:`). It sits inside the profile directory, and DSH resolves a plugin's imports from inside the profile first, so the plugin gets those old copies — for example `@deepseek-ai/schemastery` 3.18.2, which has no `Schema.volatile()`, so the module throws while it is imported. When an import fails the Loader creates no fiber for that row and no client bundle is composed either, so the model route, the RPC channel, and the settings panel all stay absent.
 
-Recovery: **uninstall** the plugin on the **Plugins** page, **install** it again with the version in the package name (for example `dsh-packycode-api@1.2.7`), then quit and reopen the desktop application. Uninstall runs `pnpm remove` and deletes the whole package directory; reinstalling or clicking **Update** only rewrites files and keeps the leftover tree. Deleting that `node_modules` by hand and restarting works too.
+Recovery: **uninstall** the plugin on the **Plugins** page, **install** it again with the version in the package name (for example `dsh-packycode-api@1.2.8`), then quit and reopen the desktop application. Uninstall runs `pnpm remove` and deletes the whole package directory; reinstalling or clicking **Update** only rewrites files and keeps the leftover tree. Deleting that `node_modules` by hand and restarting works too.
 
 **Right after a first install, every card in Settings shows `transport failure for /packycode-api/…: HTTP 405`?** The installed version is 1.1.6 or earlier, usually because only the bare package name was entered: the install prompt shows the newest version, but pnpm installs the newest one published at least 24 hours ago (see **Install the plugin**). Those older versions can register their settings channel only after DSH restarts and rebuilds its `connection` service. So right after a first install `/packycode-api` does not exist yet, requests fall through to the static page, and it answers 405; the model route and the settings panel itself load normally. From 1.1.7 on, a first install needs no restart. Check which version was installed:
 
@@ -257,13 +257,15 @@ Recovery: quit and reopen the desktop application, and the old version works. Th
 
 **The CLI is installed, but Claude still fails?** A host launched from Finder or the Start menu usually has a shorter `PATH` than a terminal. The plugin also checks the official install location, common package-manager directories, and `npm prefix -g`. If it still cannot find the binary, set `claudeCliPath` or click **Check again**. After a Host change or a reinstall, quit and reopen the desktop application.
 
+**Replies stop at the output token limit (已达到输出 token 上限), or requests keep failing — how do I report it?** Open **Settings → PackyCode → Diagnostics**, pick the session (the 20 most recent, newest first, labelled with their folder name), click **Generate diagnostics** and then **Copy**, and paste the text into an [Issue](https://github.com/BaronCyrus/dsh-packycode-api/issues) or send it to the plugin author. It holds settings and numbers only: the plugin version, the session id and start time, each key's position and groups (no labels, no keys), each request's model, reasoning effort and output limit, the latest steps' token usage and finish reasons, and retry and failure codes (messages redacted and shortened). It contains no conversation text, file paths or keys. Where copying is unavailable, the text is selected instead; press ⌘C or Ctrl+C.
+
 ## Security and scope
 
 This is a community plugin, not affiliated with or endorsed by DeepSeek or PackyCode. Model requests go to the PackyCode host you configured. Keeping credentials out of browser responses does not mean inference is local. Claude models also start the official CLI on this device.
 
 Keys stay in the local DSH credential file (`~/.dsh/.credentials.yaml`, owner-only as enforced by DSH). They are not written into settings, logs, or the transcript. Balance requests run only on the host, with a timeout and redirects refused.
 
-Use [Issues](https://github.com/BaronCyrus/dsh-packycode-api/issues) for ordinary bugs. Never include a key, token, or credential-file contents. See [SECURITY.md](SECURITY.md).
+Use [Issues](https://github.com/BaronCyrus/dsh-packycode-api/issues) for ordinary bugs; for a failing request, attach the text from the **Diagnostics** card. Never include a key, token, or credential-file contents. See [SECURITY.md](SECURITY.md).
 
 ## Local development
 

package/README.md

@@ -48,10 +48,10 @@
 打开桌面应用的**插件**页，点击**添加插件**，在**包名或地址**中填入**带版本号**的包名：
 
 ```text
-dsh-packycode-api@1.2.7
+dsh-packycode-api@1.2.8
 ```
 
-在**安装源**中选择**官方源**，然后点击**安装**。`1.2.7` 是写这份说明时的最新版，当前最新版本号以 [npm 页面](https://www.npmjs.com/package/dsh-packycode-api) 为准。
+在**安装源**中选择**官方源**，然后点击**安装**。`1.2.8` 是写这份说明时的最新版，当前最新版本号以 [npm 页面](https://www.npmjs.com/package/dsh-packycode-api) 为准。
 
 > **一定要带版本号。** 只填 `dsh-packycode-api` 时，安装前的提示显示的是 npm 上的最新版，但 DSH 自带的 pnpm 默认只安装发布满 24 小时的版本，实际装上的可能是好几个版本之前的旧版，而安装提示里看不出这一点。填写精确版本时，pnpm 会直接安装这个版本，并自动把它加入 profile 的 `minimumReleaseAgeExclude`。装好后可以在 **设置 → PackyCode → 插件版本** 核对「当前版本」。
 
@@ -72,7 +72,7 @@ dsh-packycode-api@1.2.7
 
 桌面应用的**插件**页可以看到已安装状态与版本，也可以在那里启用、停用或卸载。
 
-**仅用于非 desktop profile：** `dsh plugin --profile <name> add dsh-packycode-api@1.2.7`。不要对 `desktop` 使用它 —— CLI 会直接拒绝（`profile "desktop" is managed exclusively by the Electron application`）。
+**仅用于非 desktop profile：** `dsh plugin --profile <name> add dsh-packycode-api@1.2.8`。不要对 `desktop` 使用它 —— CLI 会直接拒绝（`profile "desktop" is managed exclusively by the Electron application`）。
 
 本地开发要加 `link:` 前缀：`dsh plugin --profile <name> add link:/path/to/dsh-packycode-api`。**不要直接写路径（或 `file:`）** —— 那样的安装会把整个仓库目录（连同 `node_modules`）复制进 profile，之后它会在 profile 内部挡住 DSH 自带的包，插件看起来像没装，见「常见问题」。已经那样装过的话，先卸载再按上面的方式重装。
 
@@ -204,7 +204,7 @@ Responses 请求只有 GPT 模型保留 `prompt_cache_key`，其他 Responses
 - 思考区第一行是「▸ 启动 Claude Code CLI…」，CLI 起来后显示版本和模型。网关限流或繁忙（429、503 `账号并发排队已满` 等）时，CLI 会自己重试最多 10 次，每次重试都会显示成 `↻ 网关返回 HTTP 503，CLI 自动重试 n/10`，不再像卡住。重试用完仍失败时，会说明是 PackyCode 的 Claude 上游繁忙，不是 Key 的问题。CLI 启动后 2 分钟内没有任何输出会被停止并报告原因。
 - 对话记录和图片通过 stdin 交给 CLI（`--input-format stream-json`），不走命令行参数：Windows 命令行长度有上限，而且命令行带不了图片。对话里的图片会以图片形式发给 Claude（与 HTTP 路由相同的压缩规格：每张不超过 2048×2048、约 1 MiB；一回合最多 20 张、合计 20 MiB，超出时先舍弃最早的）。没随消息发出的图片会写明本机只读副本的路径，CLI 需要时可以用 Read 读取。
 - 每次运行都带 `--append-system-prompt`（委派说明）。在 `-p` 模式下，官方 CLI 有追加说明时会以 "You are Claude Code, Anthropic's official CLI for Claude …" 自我介绍，没有时是 "You are a Claude agent, built on Anthropic's Claude Agent SDK."；后者曾被上游当成非官方 CLI 拒绝（403 `only accepts requests from the official Claude Code CLI`）。这是官方 CLI 自己的行为，插件没有改写它的系统提示词。
-- 会话跑在 Claude 模型上时，生成标题改用 `claude-haiku-5-5`，只读、临时目录，避免为起标题跑一整轮 Opus。
+- 会话跑在 Claude 模型上时，生成标题改用 `claude-haiku-5-5`，只读、临时目录，避免为起标题跑一整轮 Opus。DSH 的标题要求在 CLI 里只是追加在它自己系统提示词后面的一段，「在吗」这类很短的消息曾被起成 `{"title": "Casual greeting check-in"}` 这样的英文 JSON。所以插件会在提示词末尾再强调一次：只回标题纯文本，用消息原文的语言（中文、日文、韩文按文字直接点名）。回复里仍带 JSON、代码块、引号或「Title:」前缀时，插件会先剥掉再交给 DSH。如果回复有好几行（模型把思考或解释也写了出来，分不清哪行是标题），或者只是「对话标题」这类占位词，就不给标题，DSH 会保留按首条消息生成的默认标题。
 - 会话跑在 `gpt-6-astra` 上时，标题改由 `gpt-6.1-sol` 生成（同一个 Codex 分组）；对话本身仍然用 Astra。其它模型的标题由会话模型自己生成。
 - 另有 `claude_code` 工具：当前模型是 `gpt-6.1-sol`、`gpt-6-astra` 或 `deepseek-flash` 时，可以把一个任务委派给本机 Claude Code。请求的 `mode` 不会超过会话权限允许的上限；会话处于计划模式时，这个委派也只规划，并把计划正文交回父模型。
 - 声明了模型不支持的推理档位会被 harness 在发请求前拒绝，不要随手改档位映射。
@@ -213,7 +213,7 @@ Responses 请求只有 GPT 模型保留 `prompt_cache_key`，其他 Responses
 
 ## 更新与卸载
 
-**更新：** 打开 **设置 → PackyCode**，有新版本时点「更新插件」。它会在当前 profile 目录里用 DSH 自带的 pnpm 安装精确版本，并读回 `package.json` 确认版本落地。本地 `link:` 开发安装不会出现这个按钮。完成后完全退出并重新打开桌面应用。只刷新页面不会重载 Host。也可以在**插件**页重新安装，同样要填写带版本号的包名（例如 `dsh-packycode-api@1.2.7`），否则装上的可能是发布满 24 小时的旧版。
+**更新：** 打开 **设置 → PackyCode**，有新版本时点「更新插件」。它会在当前 profile 目录里用 DSH 自带的 pnpm 安装精确版本，并读回 `package.json` 确认版本落地。本地 `link:` 开发安装不会出现这个按钮。完成后完全退出并重新打开桌面应用。只刷新页面不会重载 Host。也可以在**插件**页重新安装，同样要填写带版本号的包名（例如 `dsh-packycode-api@1.2.8`），否则装上的可能是发布满 24 小时的旧版。
 
 **从本地路径安装切回官方源时，必须先卸载。** 「更新」是 `pnpm add`，它只重写包目录里的文件，不会删除更早一次本地路径安装留在包目录内的 `node_modules`；那份旧依赖会继续挡住 DSH 自带的包，插件行加载失败且看不出原因。「卸载」执行的是 `pnpm remove`，会删掉整个包目录，重装才是干净的。用 `node scripts/install-check.mjs` 可以确认当前 profile 是否处于这个状态。
 
@@ -229,7 +229,7 @@ ls ~/.dsh/profiles/desktop/node_modules/dsh-packycode-api/node_modules
 
 有输出就是残留：从 npm 安装的包不会自带 `node_modules`，这一份通常来自更早一次「本地路径」安装（`file:` 或直接写路径，而不是 `link:`）。它位于 profile 目录内部，而 DSH 解析插件导入时优先使用 profile 内的副本，所以插件拿到的仍是那份旧依赖 —— 例如 `@deepseek-ai/schemastery` 3.18.2 没有 `Schema.volatile()`，模块在导入阶段就抛错。导入失败时 Loader 不会为这一行创建 fiber，客户端 bundle 也不会被组合，于是模型路由、RPC 通道和设置页全都不会出现。
 
-修复：到**插件**页**卸载**本插件，再用带版本号的包名重新**安装**（例如 `dsh-packycode-api@1.2.7`），然后完全退出并重新打开桌面应用。卸载执行的是 `pnpm remove`，会删掉整个包目录；直接重装或点「更新」只重写文件，不会清掉这份残留。也可以手动删掉上面那个 `node_modules` 再重启。
+修复：到**插件**页**卸载**本插件，再用带版本号的包名重新**安装**（例如 `dsh-packycode-api@1.2.8`），然后完全退出并重新打开桌面应用。卸载执行的是 `pnpm remove`，会删掉整个包目录；直接重装或点「更新」只重写文件，不会清掉这份残留。也可以手动删掉上面那个 `node_modules` 再重启。
 
 **首次安装后，设置页每张卡片都显示 `transport failure for /packycode-api/…: HTTP 405`？** 实际装上的是 1.1.6 或更早的版本，通常是因为安装时只填了包名：安装提示显示的是最新版，pnpm 实际装的却是发布满 24 小时的旧版（见「安装插件」）。这些旧版要等 DSH 重启、重建它的 `connection` 服务之后，才能注册设置通道。所以首次安装后 `/packycode-api` 通道还不存在，请求落到静态页面，返回 405；模型路由和设置页本身照常加载。1.1.7 起首次安装不需要重启。先确认装上的版本：
 
@@ -257,13 +257,15 @@ grep '"version"' ~/.dsh/profiles/desktop/node_modules/dsh-packycode-api/package.
 
 **装了 CLI 还是不能用 Claude？** 从 Finder 或开始菜单启动时，`PATH` 往往比终端短。插件会再查官方安装位置、常见包管理器目录和 `npm prefix -g`。仍找不到就在设置里填 `claudeCliPath`，或点「重新检测」。改的是 Host 或重新安装了插件时，要完全退出并重启桌面应用。
 
+**回答被截断（「已达到输出 token 上限」）、请求反复失败，怎么反馈？** 打开 **设置 → PackyCode → 诊断信息**，选出问题的会话（最近 20 个，按时间倒序，标着所在文件夹名），点「生成诊断信息」再点「复制」，把内容贴到 [Issue](https://github.com/BaronCyrus/dsh-packycode-api/issues) 或发给插件作者。内容只有设置和数字：插件版本、会话 id 与创建时间、每个 Key 的序号与分组（不含备注名和 Key 本身）、每次请求用的模型、推理档位和输出上限、最近若干步的 token 用量与结束原因，以及重试和失败的错误码（错误信息已脱敏并截短）。不含对话内容、文件路径和 Key。复制不可用时，文本会被全选，按 ⌘C 或 Ctrl+C 即可。
+
 ## 安全边界
 
 本项目是社区插件，与 DeepSeek、PackyCode 无隶属或背书关系。模型请求会发到你配置的 PackyCode 接口；凭据不返回浏览器，不代表推理在本地完成。Claude 模型还会在本机启动官方 CLI。
 
 Key 存在本机 DSH 凭据文件（`~/.dsh/.credentials.yaml`，权限由 DSH 设为仅所有者可读），不进设置文档、日志或对话记录。余额请求只在宿主侧发出，带超时并禁止重定向。
 
-普通问题请提交 [Issue](https://github.com/BaronCyrus/dsh-packycode-api/issues)。不要附带 Key、令牌或凭据文件内容。更多说明见 [SECURITY.md](SECURITY.md)。
+普通问题请提交 [Issue](https://github.com/BaronCyrus/dsh-packycode-api/issues)，请求出错时可附上「诊断信息」卡片生成的内容。不要附带 Key、令牌或凭据文件内容。更多说明见 [SECURITY.md](SECURITY.md)。
 
 ## 本地开发
 

package/lib/client.js

@@ -185,6 +185,20 @@ window.__ModuleLoader__.load({
 			versionRestartHint: "插件无法安全地重启桌面应用。请完全退出 DSH，再重新打开。",
 			versionRefresh: "刷新界面",
 			versionLater: "稍后",
+			diagTitle: "诊断信息",
+			diagIntro: "遇到回答被截断（已达到输出 token 上限）、请求反复失败等问题时，选择出问题的会话，生成诊断信息并复制给插件作者。",
+			diagSession: "会话",
+			diagGenerate: "生成诊断信息",
+			diagGenerating: "正在生成…",
+			diagReport: "诊断信息内容",
+			diagCopy: "复制",
+			diagCopied: "已复制",
+			diagSelected: "已选中全部内容，请按 ⌘C 或 Ctrl+C 复制。",
+			diagPrivacy: "只包含模型、推理档位、输出上限、每一步的 token 用量和错误码，不含对话内容、文件路径和 Key。",
+			diagNoSessions: "还没有会话。",
+			diagLive: "进行中",
+			diagNoFolder: "无目录",
+			diagError: "生成诊断信息失败",
 			searchTitle: "网页搜索",
 			searchScope: "DSH 全局设置",
 			searchIntro: "DSH 的 web_search 和 Claude CLI 的 MCP 搜索可使用这里选择的 DeepSeek/GPT 后端。每次搜索是独立的模型调用，用插件保存的 Key 计费。",
@@ -362,6 +376,20 @@ window.__ModuleLoader__.load({
 			versionRestartHint: "The plugin cannot safely restart the desktop application. Quit DSH completely, then open it again.",
 			versionRefresh: "Refresh page",
 			versionLater: "Later",
+			diagTitle: "Diagnostics",
+			diagIntro: "If replies are cut off (\"output token limit reached\") or requests keep failing, pick the affected session, generate its diagnostics and send them to the plugin author.",
+			diagSession: "Session",
+			diagGenerate: "Generate diagnostics",
+			diagGenerating: "Generating…",
+			diagReport: "Diagnostics text",
+			diagCopy: "Copy",
+			diagCopied: "Copied",
+			diagSelected: "All text is selected; press ⌘C or Ctrl+C to copy.",
+			diagPrivacy: "Contains only models, reasoning effort, output limits, per-step token usage and error codes — no conversation text, file paths or keys.",
+			diagNoSessions: "No sessions yet.",
+			diagLive: "open",
+			diagNoFolder: "no folder",
+			diagError: "Could not generate diagnostics",
 			searchTitle: "Web search",
 			searchScope: "DSH-wide setting",
 			searchIntro: "DSH’s web_search and Claude CLI’s MCP search can use the DeepSeek/GPT backend selected here. Each search is a separate model call billed to the plugin-stored keys.",
@@ -429,6 +457,8 @@ window.__ModuleLoader__.load({
 .pkc-input:focus{border-color:var(--dsw-alias-state-business-primary)}
 .pkc-input::placeholder{color:var(--dsw-alias-label-caption)}
 .pkc-input:disabled{opacity:.5}
+.pkc-diag-session{flex:1 1 260px;max-width:480px;cursor:pointer}
+.pkc-diag-text{width:100%;height:auto;min-height:220px;padding:8px 10px;line-height:18px;resize:vertical;white-space:pre;overflow:auto}
 .pkc-image-choice{flex:none;width:100%;max-width:300px;cursor:pointer}
 .pkc-image-shortcut{display:inline-flex;align-items:center;gap:8px}
 .pkc-quota{position:relative;display:inline-flex;align-items:center}
@@ -1721,6 +1751,173 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client-diagnostics.jsx
+		/**
+		* The settings card that turns one session into a numbers-only diagnosis a
+		* user can copy into a bug report. The host builds the text; this card only
+		* picks the session, shows the result and copies it.
+		*
+		* @module dsh-packycode-api/client-diagnostics
+		*/
+		const pad = (value) => String(value).padStart(2, "0");
+		/** The picker's local date and time; the report itself keeps UTC ISO times. */
+		function localTime(iso) {
+			const date = new Date(iso);
+			if (Number.isNaN(date.getTime())) return "—";
+			return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+		}
+		const messageOf = (failure) => failure instanceof Error ? failure.message : String(failure);
+		function DiagnosticsCard({ call, t }) {
+			const [sessions, setSessions] = react.useState();
+			const [selected, setSelected] = react.useState("");
+			const [report, setReport] = react.useState();
+			const [busy, setBusy] = react.useState(false);
+			const [error, setError] = react.useState();
+			const [copied, setCopied] = react.useState();
+			const area = react.useRef(null);
+			const mounted = react.useRef(true);
+			react.useEffect(() => () => {
+				mounted.current = false;
+			}, []);
+			const loadSessions = react.useCallback(() => {
+				setError(void 0);
+				return call("diagnostics/sessions").then((value) => {
+					if (!mounted.current) return;
+					const list = Array.isArray(value?.sessions) ? value.sessions : [];
+					setSessions(list);
+					setSelected((current) => list.some((item) => item.id === current) ? current : list[0]?.id ?? "");
+				}).catch((failure) => {
+					if (mounted.current) setError(messageOf(failure));
+				});
+			}, [call]);
+			react.useEffect(() => {
+				loadSessions();
+			}, [loadSessions]);
+			const generate = () => {
+				if (selected === "") return;
+				setBusy(true);
+				setError(void 0);
+				setCopied(void 0);
+				call("diagnostics/session", { sessionId: selected }).then((value) => {
+					if (mounted.current) setReport(JSON.stringify(value, null, 2));
+				}).catch((failure) => {
+					if (mounted.current) setError(messageOf(failure));
+				}).finally(() => {
+					if (mounted.current) setBusy(false);
+				});
+			};
+			/** Copy through the clipboard API, or select everything for a manual copy. */
+			const copy = () => {
+				if (report === void 0) return;
+				const selectAll = () => {
+					area.current?.focus?.();
+					area.current?.select?.();
+					if (mounted.current) setCopied("selected");
+				};
+				const clipboard = globalThis.navigator?.clipboard;
+				if (typeof clipboard?.writeText !== "function") {
+					selectAll();
+					return;
+				}
+				clipboard.writeText(report).then(() => {
+					if (mounted.current) setCopied("copied");
+				}, selectAll);
+			};
+			const label = (item) => [
+				localTime(item.createdAt),
+				item.folder ?? t("diagNoFolder"),
+				item.live ? t("diagLive") : void 0
+			].filter(Boolean).join(" · ");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: "pkc-card",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+						className: "pkc-head",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							className: "pkc-title",
+							children: t("diagTitle")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: "pkc-actions",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								className: "pkc-btn",
+								type: "button",
+								disabled: busy,
+								onClick: () => {
+									loadSessions();
+								},
+								children: t("refresh")
+							})
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "pkc-note",
+						children: t("diagIntro")
+					}),
+					sessions !== void 0 && sessions.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "pkc-note",
+						children: t("diagNoSessions")
+					}),
+					sessions !== void 0 && sessions.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "pkc-form",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+							className: "pkc-input pkc-diag-session",
+							"aria-label": t("diagSession"),
+							value: selected,
+							disabled: busy,
+							onChange: (event) => {
+								setSelected(event.target.value);
+								setReport(void 0);
+								setCopied(void 0);
+							},
+							children: sessions.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: item.id,
+								children: label(item)
+							}, item.id))
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							className: "pkc-btn",
+							"data-variant": "primary",
+							"data-size": "md",
+							type: "button",
+							disabled: busy || selected === "",
+							onClick: generate,
+							children: busy ? t("diagGenerating") : t("diagGenerate")
+						})]
+					}),
+					report !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+							ref: area,
+							className: "pkc-input pkc-mono pkc-diag-text",
+							readOnly: true,
+							rows: 14,
+							value: report,
+							"aria-label": t("diagReport")
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "pkc-form",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								className: "pkc-btn",
+								type: "button",
+								onClick: copy,
+								children: copied === "copied" ? t("diagCopied") : t("diagCopy")
+							}), copied === "selected" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "pkc-note",
+								children: t("diagSelected")
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "pkc-note",
+							children: t("diagPrivacy")
+						})
+					] }),
+					error !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "pkc-error",
+						role: "alert",
+						children: `${t("diagError")}: ${error}`
+					})
+				]
+			});
+		}
+		//#endregion
 		//#region src/client.jsx
 		/**
 		* Browser half: the PackyCode settings page and the composer balance chip.
@@ -2736,6 +2933,10 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionCard, {
 						call,
 						t
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(DiagnosticsCard, {
+						call,
+						t
 					})
 				]
 			});

package/lib/index.js

@@ -8,8 +8,8 @@ import { closeSync, constants, existsSync, fstatSync, lstatSync, mkdtempSync, op
 import { lstat, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm, writeFile } from "node:fs/promises";
 import { createServer } from "node:http";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { credentialKey } from "@deepseek-ai/dsh-credentials";
 import { fileURLToPath } from "node:url";
+import { credentialKey } from "@deepseek-ai/dsh-credentials";
 import { PiAiAdapter } from "@deepseek-ai/dsh-llm-pi-ai";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { lazyStream } from "@earendil-works/pi-ai/api/lazy";
@@ -1334,7 +1334,9 @@ function pickKeyForModel(modelId, active, usable, covers) {
 *
 * A session-title request is not a delegation: it runs on the small model,
 * read-only and outside the workspace, with the title instructions appended,
-* so naming a session does not cost an Opus agent turn.
+* so naming a session does not cost an Opus agent turn. Under the CLI's own
+* system prompt those instructions are easily outweighed, so the prompt ends
+* by restating them and the answer is unwrapped before DSH reads it.
 *
 * @module dsh-packycode-api/claude-adapter
 */
@@ -1796,6 +1798,87 @@ function renderAuxiliaryPrompt(options) {
 	return (Array.isArray(options?.messages) ? options.messages : []).filter((message) => message !== null && typeof message === "object" && message.role !== "system").flatMap((message) => Array.isArray(message.content) ? message.content : []).filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n\n").trim();
 }
 /**
+* Languages named by their script. The caller frames a title request in
+* English, so text in one of these scripts is the user's own.
+*/
+const TITLE_SCRIPTS = Object.freeze([
+	["Korean", /\p{Script=Hangul}/u],
+	["Japanese", /[\p{Script=Hiragana}\p{Script=Katakana}]/u],
+	["Chinese", /\p{Script=Han}/u]
+]);
+/**
+* The prompt of a CLI title request: the caller's framed input, verbatim,
+* then the two rules the small model breaks under the CLI's own system
+* prompt. There the caller's title instructions are only an appendix and its
+* input is English framing around a JSON array, so a short message came back
+* as JSON or in English (`{"title": "Session greeting check"}` for 在吗).
+* @param options - the assembled title request.
+* @returns the prompt text.
+*/
+function renderTitlePrompt(options) {
+	const framed = renderAuxiliaryPrompt(options);
+	const language = TITLE_SCRIPTS.find(([, script]) => script.test(framed))?.[0];
+	return [
+		framed,
+		"",
+		"Reply with the title alone, as plain text on one line: not JSON, not quoted, with no label such as \"Title:\".",
+		language === void 0 ? "Write it in the language of the messages' text, not in the language of these instructions." : `Write it in ${language}, the language of the messages' text, not in the language of these instructions.`
+	].join("\n");
+}
+/** Pairs a reply wraps a whole title in. Book-title marks belong to a title. */
+const TITLE_WRAPPERS = Object.freeze([
+	["\"", "\""],
+	["'", "'"],
+	["“", "”"],
+	["‘", "’"],
+	["「", "」"],
+	["『", "』"],
+	["```", "```"],
+	["`", "`"],
+	["**", "**"],
+	["«", "»"]
+]);
+const TITLE_LABEL = /^[*"'`]*(?:(?:session\s+)?title|(?:会话)?标题)[*"'`]*\s*[:：]\**\s*/iu;
+/** A reply that names the field instead of filling it. */
+const TITLE_PLACEHOLDER = /^(?:(?:(?:session|conversation|chat)\s+)?title|(?:会话|对话|聊天)?标题)$/iu;
+/** The title inside a JSON reply: a string, or an object's `title` string. */
+function jsonTitle(text) {
+	if (!/^[{"]/u.test(text)) return void 0;
+	let value;
+	try {
+		value = JSON.parse(text);
+	} catch {
+		return;
+	}
+	if (typeof value === "string") return value.trim();
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const field = Object.keys(value).find((key) => key.toLowerCase() === "title");
+	return field !== void 0 && typeof value[field] === "string" ? value[field].trim() : void 0;
+}
+/**
+* Recover the bare title from a reply that wrapped it: in a code fence, as a
+* JSON object's `title` or a JSON string, after a "Title:" label, or in
+* quotes. Anything else comes back trimmed.
+*
+* Some replies hold no usable title: several lines (the model wrote out its
+* thinking or an explanation, and which line is the title cannot be told), a
+* placeholder such as "Session title", or an empty wrapper. Those yield no
+* text, so DSH keeps its own fallback title, the first message's words.
+* @param text - a title request's whole text answer.
+* @returns the title text, or '' when the reply holds none.
+*/
+function unwrapTitle(text) {
+	const raw = typeof text === "string" ? text.trim() : "";
+	const body = /^```[^\n]*\n([\s\S]*?)\n?```$/u.exec(raw)?.[1].trim() ?? raw;
+	const lines = body.split("\n").map((line) => line.trim()).filter((line) => line !== "");
+	const json = jsonTitle(body) ?? jsonTitle(lines[0] ?? "");
+	if (json === void 0 && lines.length > 1) return "";
+	let title = (json ?? lines[0] ?? "").replace(TITLE_LABEL, "");
+	const wrapper = TITLE_WRAPPERS.find(([open, close]) => title.length > open.length + close.length && title.startsWith(open) && title.endsWith(close));
+	if (wrapper !== void 0) title = title.slice(wrapper[0].length, title.length - wrapper[1].length).trim();
+	return TITLE_PLACEHOLDER.test(title) ? "" : title;
+}
+/**
 * Emit text and reasoning as well-formed harness blocks.
 *
 * The harness's stream grammar requires every delta to address an open block
@@ -1948,14 +2031,15 @@ function retryNote(event) {
 }
 /**
 * How one request runs on the CLI: a title request on the small model with
-* the caller's instructions appended, anything else as a delegated turn.
+* the caller's instructions appended and restated, anything else as a
+* delegated turn.
 *
 * The CLI's own system prompt and tool set stay in place even for a title:
 * they are part of what the gateway sees from the official client.
 */
 async function cliCall(options, { titleModel, cwdOf, modeOf, attachmentsOf, imageLimits }) {
 	if (options?.purpose === "session-title") return {
-		prompt: renderAuxiliaryPrompt(options),
+		prompt: renderTitlePrompt(options),
 		model: titleModel,
 		mode: "read-only",
 		enableSearch: false,
@@ -2040,6 +2124,7 @@ function createClaudeCliAdapter({ inner, runner, modelIds = CLI_BACKED_MODEL_IDS
 	}
 	async function* cliStream(options) {
 		const quiet = options?.purpose === "session-title";
+		let titleText = "";
 		const blocks = createBlockWriter();
 		if (!quiet) yield* blocks.note("▸ 启动 Claude Code CLI…\n");
 		let call;
@@ -2112,10 +2197,12 @@ function createClaudeCliAdapter({ inner, runner, modelIds = CLI_BACKED_MODEL_IDS
 					if (!quiet) yield* blocks.note(`  ↻ ${retryNote(event)}\n`);
 					break;
 				case "block":
+					if (quiet && event.kind === "text") titleText = "";
 					blocks.boundary(event.kind);
 					break;
 				case "text":
-					yield* blocks.write("text", event.text);
+					if (quiet) titleText += event.text;
+					else yield* blocks.write("text", event.text);
 					break;
 				case "reasoning":
 					yield* blocks.write("reasoning", event.text);
@@ -2150,6 +2237,7 @@ function createClaudeCliAdapter({ inner, runner, modelIds = CLI_BACKED_MODEL_IDS
 				};
 				return;
 			}
+			if (quiet) yield* blocks.write("text", unwrapTitle(titleText));
 			yield* blocks.close();
 			yield {
 				type: "usage",
@@ -5439,6 +5527,221 @@ function createClaudeCodeTool({ runner, modeCeiling, planActive }) {
 	});
 }
 //#endregion
+//#region src/diagnostics.js
+/**
+* A support summary of one DSH session, for reports such as "已达到输出 token
+* 上限" or failing requests: which route, reasoning effort and output ceiling
+* each request used, how every model step ended and what it consumed, and
+* which retries and failures happened.
+*
+* The summary carries numbers and identifiers only. Message text, reasoning,
+* tool arguments and results, titles, paths and key material never enter it;
+* error messages are redacted and shortened. A user can paste it into a bug
+* report as it is.
+*
+* @module dsh-packycode-api/diagnostics
+*/
+const DIAGNOSTICS_FORMAT = "packycode-diagnostics/1";
+const SESSION_LIST_LIMIT = 20;
+const SESSION_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u;
+const MESSAGE_CHARS = 160;
+/** How many of each record the summary keeps, newest last. */
+const DIAGNOSTICS_LIMITS = Object.freeze({
+	requests: 8,
+	truncated: 12,
+	steps: 20,
+	turns: 10,
+	retries: 10,
+	attempts: 10
+});
+const finite = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
+/** Identifier-like strings only (routes, models, efforts, reason kinds, codes). */
+const word = (value) => typeof value === "string" && /^[\w.:/@[\]-]{1,80}$/u.test(value) ? value : void 0;
+const iso = (value) => finite(value) === void 0 ? void 0 : new Date(value).toISOString();
+const last = (list, count) => list.slice(Math.max(0, list.length - count));
+const compact = (object) => Object.fromEntries(Object.entries(object).filter(([, value]) => value !== void 0));
+const chunksOf = (stream) => Array.isArray(stream) ? stream.map((item) => item?.chunk).filter((chunk) => chunk !== null && typeof chunk === "object") : [];
+/** A provider or harness error message, redacted and shortened. */
+function safeMessage$1(text, secrets) {
+	if (typeof text !== "string" || text === "") return void 0;
+	const safe = redactSecrets(text, secrets).replace(/sk-[A-Za-z0-9_-]{8,}/gu, "sk-[redacted]").replace(/Bearer\s+[A-Za-z0-9._~+/=-]{8,}/giu, "Bearer [redacted]").replace(/\s+/gu, " ").trim();
+	return safe.length > MESSAGE_CHARS ? `${safe.slice(0, MESSAGE_CHARS)}…` : safe;
+}
+function failureOf(reason, secrets) {
+	const failure = reason?.failure ?? reason?.error;
+	return failure === void 0 ? {} : {
+		code: word(failure.code),
+		message: safeMessage$1(failure.message, secrets)
+	};
+}
+/**
+* Summarize one session's events.
+* @param events - the session's events in log order.
+* @param options - values to redact from error messages.
+* @returns the numbers-only summary body.
+*/
+function summarizeSessionEvents(events, { secrets = [] } = {}) {
+	const requests = [];
+	const steps = [];
+	const turnEnds = [];
+	const retries = [];
+	const attempts = [];
+	let turns = 0;
+	let compactions = 0;
+	for (const event of events ?? []) {
+		const type = event?.type;
+		const data = event?.data ?? {};
+		if (typeof type !== "string") continue;
+		if (/compact/u.test(type)) compactions += 1;
+		if (type === "turn/start") turns += 1;
+		else if (type === "request/header") {
+			const config = data.header?.config ?? {};
+			requests.push(compact({
+				time: iso(event.time),
+				reason: word(data.reason),
+				provider: word(config.provider),
+				model: word(config.model),
+				reasoningEffort: word(config.reasoningEffort),
+				maxTokens: finite(config.maxTokens),
+				maxTokensFromAdapter: data.header?.adapterDefaults?.maxTokens === true ? true : void 0
+			}));
+		} else if (type === "assistant/message") {
+			const chunks = chunksOf(data.stream);
+			const usage = data.usage ?? chunks.find((chunk) => chunk.type === "usage")?.usage ?? {};
+			const input = finite(usage.inputTokens);
+			const cacheRead = finite(usage.cacheReadTokens);
+			steps.push(compact({
+				turn: finite(data.turn),
+				step: finite(data.step),
+				time: iso(event.time),
+				finish: word(chunks.find((chunk) => chunk.type === "finish")?.reason?.kind) ?? "none",
+				input,
+				cacheRead,
+				cacheWrite: finite(usage.cacheWriteTokens),
+				output: finite(usage.outputTokens),
+				context: input === void 0 && cacheRead === void 0 ? void 0 : (input ?? 0) + (cacheRead ?? 0)
+			}));
+		} else if (type === "assistant/attempt") {
+			const reason = chunksOf(data.stream).find((chunk) => chunk.type === "finish")?.reason;
+			attempts.push(compact({
+				turn: finite(data.turn),
+				step: finite(data.step),
+				time: iso(event.time),
+				finish: word(reason?.kind),
+				...failureOf(reason, secrets)
+			}));
+		} else if (type === "llm/retry") retries.push(compact({
+			turn: finite(data.turn),
+			step: finite(data.step),
+			time: iso(event.time),
+			provider: word(data.provider),
+			retry: finite(data.retry),
+			maxRetries: finite(data.maxRetries),
+			...failureOf({ failure: data.failure }, secrets)
+		}));
+		else if (type === "turn/end") turnEnds.push(compact({
+			turn: finite(data.turn),
+			time: iso(event.time),
+			kind: word(data.reason?.kind),
+			...failureOf(data.reason, secrets)
+		}));
+	}
+	const truncated = steps.filter((step) => step.finish === "max-tokens");
+	return {
+		totals: {
+			turns,
+			steps: steps.length,
+			maxTokenSteps: truncated.length,
+			retries: retries.length,
+			failedAttempts: attempts.length,
+			compactionEvents: compactions
+		},
+		requestSettings: last(requests, DIAGNOSTICS_LIMITS.requests),
+		maxTokenSteps: last(truncated, DIAGNOSTICS_LIMITS.truncated),
+		recentSteps: last(steps, DIAGNOSTICS_LIMITS.steps),
+		turnEnds: last(turnEnds, DIAGNOSTICS_LIMITS.turns),
+		retries: last(retries, DIAGNOSTICS_LIMITS.retries),
+		failedAttempts: last(attempts, DIAGNOSTICS_LIMITS.attempts)
+	};
+}
+/**
+* The diagnostics service behind the settings card.
+* @param options - DSH's session query service (read lazily), the session
+*   event reader the image originals already use, the key ring and group
+*   reader, the stored secrets to redact, and this package's manifest URL.
+*/
+function createDiagnostics({ sessionQuery, readEvents, ring, groups, secrets = async () => [], ownPackageJsonUrl }) {
+	const query = () => {
+		const service = sessionQuery?.();
+		if (typeof service?.listSessions !== "function") throw new Error("PackyCode diagnostics need DSH session history, which this runtime does not provide");
+		return service;
+	};
+	const version = async () => {
+		try {
+			return word(JSON.parse(await readFile(fileURLToPath(ownPackageJsonUrl), "utf8")).version);
+		} catch {
+			return;
+		}
+	};
+	/** Stored conversation keys by position: state and groups, never labels or keys. */
+	const keys = async () => {
+		const listed = (await ring.list()).keys ?? [];
+		let reading;
+		try {
+			reading = await groups?.read({ force: false });
+		} catch {
+			reading = void 0;
+		}
+		return listed.map((entry, index) => {
+			const group = reading?.keys?.find((item) => item.id === entry.id);
+			return compact({
+				key: index + 1,
+				active: entry.active === true,
+				disabled: entry.disabled === true ? true : void 0,
+				groups: Array.isArray(group?.groups) ? group.groups.map(word).filter(Boolean) : void 0,
+				reaches: group?.coverage === void 0 ? void 0 : Object.keys(group.coverage).filter((model) => group.coverage[model] === true)
+			});
+		});
+	};
+	return Object.freeze({
+		/** Recent top-level sessions, newest first, for the picker. */
+		async list(signal) {
+			return { sessions: (await query().listSessions(signal)).filter((record) => typeof record?.header?.id === "string" && !(record.header.delegationDepth > 0)).slice(0, SESSION_LIST_LIMIT).map((record) => compact({
+				id: record.header.id,
+				createdAt: iso(record.header.createdAt),
+				live: record.live === true,
+				folder: typeof record.header.cwd === "string" && record.header.cwd !== "" ? basename(record.header.cwd) : void 0
+			})) };
+		},
+		/** The numbers-only summary of one session. */
+		async read(payload, signal) {
+			const sessionId = payload?.sessionId;
+			if (typeof sessionId !== "string" || !SESSION_ID.test(sessionId)) throw new Error("PackyCode diagnostics need a session to read");
+			query();
+			let events;
+			try {
+				events = await readEvents(sessionId, signal);
+			} catch {
+				throw new Error("PackyCode could not read that session");
+			}
+			const record = (await query().listSessions(signal)).find((item) => item?.header?.id === sessionId);
+			return {
+				format: DIAGNOSTICS_FORMAT,
+				generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				plugin: compact({ version: await version() }),
+				session: compact({
+					id: sessionId,
+					createdAt: iso(record?.header?.createdAt),
+					live: record === void 0 ? void 0 : record.live === true,
+					delegationDepth: finite(record?.header?.delegationDepth)
+				}),
+				keys: await keys(),
+				...summarizeSessionEvents(events, { secrets: await secrets() })
+			};
+		}
+	});
+}
+//#endregion
 //#region src/preferences.js
 /**
 * Where the plugin's preferences are read from and written to, on both
@@ -6962,8 +7265,9 @@ function createRouteAdapter({ ring, keys, fallbackSessionId, resolveAttachments,
 * Every reply carries only what this plugin owns: key labels and state, the
 * balance and group projections the host built, host overrides, whether this
 * device has the Claude Code CLI, the plugin version, and the web search
-* preference and model visibility, or bounded session-authorized original PNG
-* chunks. Key material never crosses this boundary.
+* preference and model visibility, bounded session-authorized original PNG
+* chunks, or a numbers-only session diagnosis. Key material never crosses this
+* boundary.
 *
 * @module dsh-packycode-api/rpc
 */
@@ -6989,7 +7293,7 @@ const keyId = (payload) => String(payload?.id ?? "");
 *   web search controller (without one, its endpoints refuse).
 * @returns a handler for `connection.rpc.handle(CHANNEL, handler)`.
 */
-function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claudeCli, pluginManager, search, modelSelection, images, imageOriginals }) {
+function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claudeCli, pluginManager, search, modelSelection, images, imageOriginals, diagnostics }) {
 	const need = (service, message) => {
 		if (service === void 0) throw new Error(message);
 		return service;
@@ -7001,6 +7305,7 @@ function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claudeCl
 	const models = () => need(modelSelection, "PackyCode model selection is unavailable in this runtime");
 	const imageSupport = () => need(images, "PackyCode images are unavailable in this runtime");
 	const originals = () => need(imageOriginals, "PackyCode original images are unavailable in this runtime");
+	const diagnosis = () => need(diagnostics, "PackyCode diagnostics are unavailable in this runtime");
 	const status = async () => ({
 		...await ring.list(),
 		hosts: hosts(),
@@ -7087,7 +7392,9 @@ function createPackyCodeRpc({ ring, balance, groups, hosts, preference, claudeCl
 		}),
 		"images/keys/remove": (payload) => imageSupport().mutate("remove", { id: payload?.id }),
 		"images/keys/select": (payload) => imageSupport().mutate("select", { id: payload?.id }),
-		"images/keys/enable": (payload) => imageSupport().mutate("enable", { id: payload?.id })
+		"images/keys/enable": (payload) => imageSupport().mutate("enable", { id: payload?.id }),
+		"diagnostics/sessions": (_payload, signal) => diagnosis().list(signal),
+		"diagnostics/session": (payload, signal) => diagnosis().read(payload, signal)
 	};
 	return async (endpoint, payload, signal) => {
 		try {
@@ -8283,6 +8590,23 @@ function apply(ctx, config) {
 		search.register(webCtx.web, (callback, label) => scope.effect(callback, label));
 	});
 	keys.remember().catch(() => void 0);
+	/** One session's events from DSH's session query service, without projections. */
+	const readSessionEvents = async (sessionId, signal) => {
+		const query = ctx.get?.("sessionQuery");
+		if (typeof query?.observeSession === "function") {
+			const observation = await query.observeSession(sessionId, {
+				signal,
+				projectionMode: "none"
+			});
+			try {
+				return [...observation.events];
+			} finally {
+				observation[Symbol.dispose]();
+			}
+		}
+		if (typeof query?.readSession === "function") return (await query.readSession(sessionId)).events;
+		return [];
+	};
 	const handler = createPackyCodeRpc({
 		ring,
 		balance,
@@ -8296,22 +8620,15 @@ function apply(ctx, config) {
 		images,
 		imageOriginals: createImageOriginalReader({
 			imageDirectory: join(dshHome, "packycode-api", "images"),
-			getSessionEvents: async (sessionId, signal) => {
-				const query = ctx.get?.("sessionQuery");
-				if (typeof query?.observeSession === "function") {
-					const observation = await query.observeSession(sessionId, {
-						signal,
-						projectionMode: "none"
-					});
-					try {
-						return [...observation.events];
-					} finally {
-						observation[Symbol.dispose]();
-					}
-				}
-				if (typeof query?.readSession === "function") return (await query.readSession(sessionId)).events;
-				return [];
-			}
+			getSessionEvents: readSessionEvents
+		}),
+		diagnostics: createDiagnostics({
+			sessionQuery: () => ctx.get?.("sessionQuery"),
+			readEvents: readSessionEvents,
+			ring,
+			groups,
+			secrets: async () => (await Promise.all([ring.secrets(), imageRing.secrets()])).flat().map((entry) => entry.key),
+			ownPackageJsonUrl: new URL("../package.json", import.meta.url)
 		})
 	});
 	/**
@@ -8347,4 +8664,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { AUTO_CLAUDE_MODE, CHANNEL, CLAUDE_CLI_MODES, CLAUDE_INSTALL_COMMAND, CLAUDE_MISSING_MESSAGE, CLAUDE_NPM_PACKAGE, CLAUDE_TOOL_INSTRUCTIONS, CLI_BACKED_MODEL_IDS, CLI_IMAGE_LIMITS, Config, DEFAULT_API_HOST, DEFAULT_APPEND_SYSTEM_PROMPT, DEFAULT_IMAGE_MODEL, DEFAULT_SEARCH_BACKEND, DEFAULT_STATUS_HOST, DISPLAY_NAME, IMAGE_MODELS, IMAGE_MODEL_IDS, IMAGE_QUALITIES, IMAGE_TIMEOUT_MS, IMAGE_TOOL_NAME, LEGACY_STATUS_HOSTS, MAX_CLI_IMAGE_CALLS, MAX_IMAGE_BYTES, MCP_IMAGE_SCHEMA, PACKYCODE_AUTO_SEARCH_PROVIDER_ID, PACKYCODE_MODELS, PACKYCODE_MODEL_IDS, PACKYCODE_SEARCH_PROVIDER_ID, PLUGIN_ID, PROVIDER, PackyCodeKeyRing, SEARCH_BACKENDS, SEARCH_BACKEND_MODELS, SEARCH_MODES, SETTINGS_NAMESPACE, TITLE_MODEL_ID, TITLE_MODEL_ROUTES, accountHostOrder, apply, assertApiKey, buildClaudeArgs, buildClaudeEnvironment, buildClaudeInput, buildDelegatedContent, buildSearchRequest, capClaudeMode, catalogCoverage, classifyClientPolicy, classifyGatewayFailure, claudeBinaryCandidates, claudeModeFor, claudeModeForSession, cliSearchInstructions, createBalanceReader, createClaudeCliAdapter, createClaudeCliManager, createClaudeCodeTool, createClaudeImageService, createClaudeRunner, createClaudeSearchBridge, createGroupReader, createImageController, createKeyChooser, createModelSelectionController, createPackyCodeAutoSearchProvider, createPackyCodeImageClient, createPackyCodeImageTool, createPackyCodeProfile, createPackyCodeProvider, createPackyCodeRpc, createPackyCodeSearchProvider, createProfileSearchComposition, createRouteAdapter, createSearchComposition, createSearchController, decodeImagePng, delegationInstructions, describeRunKey, explainCliClientPolicyFailure, explainCliGroupFailure, explainClientPolicyFailure, explainNpmFailure, findClaudeBinary, guardKeyRotation, inject, keyNote, locateClaudeBinary, locateNpm, name, normalizeFailureMessage, normalizeHost, npmCandidates, parseBillingSubscription, parseBillingUsage, parseClaudeResult, parseClaudeVersion, parseMessagesSearchResponse, parsePricing, parseResponsesSearchResponse, parseSelectedGroups, parseTokenUsage, pickKeyForModel, planModeForSession, planModeForToolExecution, pngDimensions, readClaudeStreamEvents, readHiddenModels, readImagePreference, readSearchChoice, renderAuxiliaryPrompt, renderDelegatedPrompt, resolveSpawnCommand, statusHostOrder, summarizeToolUse, validateImageOptions };
+export { AUTO_CLAUDE_MODE, CHANNEL, CLAUDE_CLI_MODES, CLAUDE_INSTALL_COMMAND, CLAUDE_MISSING_MESSAGE, CLAUDE_NPM_PACKAGE, CLAUDE_TOOL_INSTRUCTIONS, CLI_BACKED_MODEL_IDS, CLI_IMAGE_LIMITS, Config, DEFAULT_API_HOST, DEFAULT_APPEND_SYSTEM_PROMPT, DEFAULT_IMAGE_MODEL, DEFAULT_SEARCH_BACKEND, DEFAULT_STATUS_HOST, DIAGNOSTICS_FORMAT, DIAGNOSTICS_LIMITS, DISPLAY_NAME, IMAGE_MODELS, IMAGE_MODEL_IDS, IMAGE_QUALITIES, IMAGE_TIMEOUT_MS, IMAGE_TOOL_NAME, LEGACY_STATUS_HOSTS, MAX_CLI_IMAGE_CALLS, MAX_IMAGE_BYTES, MCP_IMAGE_SCHEMA, PACKYCODE_AUTO_SEARCH_PROVIDER_ID, PACKYCODE_MODELS, PACKYCODE_MODEL_IDS, PACKYCODE_SEARCH_PROVIDER_ID, PLUGIN_ID, PROVIDER, PackyCodeKeyRing, SEARCH_BACKENDS, SEARCH_BACKEND_MODELS, SEARCH_MODES, SETTINGS_NAMESPACE, TITLE_MODEL_ID, TITLE_MODEL_ROUTES, accountHostOrder, apply, assertApiKey, buildClaudeArgs, buildClaudeEnvironment, buildClaudeInput, buildDelegatedContent, buildSearchRequest, capClaudeMode, catalogCoverage, classifyClientPolicy, classifyGatewayFailure, claudeBinaryCandidates, claudeModeFor, claudeModeForSession, cliSearchInstructions, createBalanceReader, createClaudeCliAdapter, createClaudeCliManager, createClaudeCodeTool, createClaudeImageService, createClaudeRunner, createClaudeSearchBridge, createDiagnostics, createGroupReader, createImageController, createKeyChooser, createModelSelectionController, createPackyCodeAutoSearchProvider, createPackyCodeImageClient, createPackyCodeImageTool, createPackyCodeProfile, createPackyCodeProvider, createPackyCodeRpc, createPackyCodeSearchProvider, createProfileSearchComposition, createRouteAdapter, createSearchComposition, createSearchController, decodeImagePng, delegationInstructions, describeRunKey, explainCliClientPolicyFailure, explainCliGroupFailure, explainClientPolicyFailure, explainNpmFailure, findClaudeBinary, guardKeyRotation, inject, keyNote, locateClaudeBinary, locateNpm, name, normalizeFailureMessage, normalizeHost, npmCandidates, parseBillingSubscription, parseBillingUsage, parseClaudeResult, parseClaudeVersion, parseMessagesSearchResponse, parsePricing, parseResponsesSearchResponse, parseSelectedGroups, parseTokenUsage, pickKeyForModel, planModeForSession, planModeForToolExecution, pngDimensions, readClaudeStreamEvents, readHiddenModels, readImagePreference, readSearchChoice, renderAuxiliaryPrompt, renderDelegatedPrompt, renderTitlePrompt, resolveSpawnCommand, statusHostOrder, summarizeSessionEvents, summarizeToolUse, unwrapTitle, validateImageOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-packycode-api",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Use PackyCode API keys in DeepSeek Harness with multi-protocol models, image generation and editing, separate key rings, and balance display",
   "type": "module",
   "main": "./lib/index.js",