npm - @aiwayds/dsh-tui-pi - Versions diffs - 1.2.1 → 1.2.3 - Mend

@aiwayds/dsh-tui-pi 1.2.1 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md CHANGED Viewed

@@ -12,142 +12,47 @@ https://github.com/user-attachments/assets/6a7e00bb-1fd0-4bc5-9070-457f1e9fa54d
 ## ✨ Features
-> Each item links to its section below — one line for what it gives you.
-- [**Footer — live session overview**](#footer) — provider/model, context pressure and the session cache-hit rate at a glance, always in view.
-- [**Think & tool panels**](#think-and-tool-panels) — reasoning and tool activity stay out of the transcript, so the conversation reads clean.
-- [**Subagents**](#subagents) — every running subagent gets a status line; watch and steer it live.
-- [**Ask User Question**](#ask-user-question) — the model can pause and ask you structured questions, answered without leaving the TUI.
-- [**Feishu integration demo**](#feishu-integration-demo) — dsh-tui-pi on the desktop and Feishu/Lark on the phone driving (and answering for) the same dsh session.
-- [**Dynamic context pruning (DCP)**](#dynamic-context-pruning-dcp) — context stays within limits automatically, with zero LLM calls.
-- [**Persistent context**](#persistent-context) — your ground rules ride along on every request, hot-applied with no restart.
-- [**Model profiles & favorites**](#model-profiles-and-favorites) — switch a whole model setup per project and keep the picker small.
-- [**Sessions & resume**](#sessions-and-resume) — sessions stay tidy automatically and resume in a few keystrokes.
-- [**Themes**](#themes) — GitHub light/dark palettes, hot-switchable; `auto` follows your terminal.
-- [**Search, selection & images**](#search-selection-and-images) — `Ctrl+Shift+F` over the whole transcript, drag-select copies to the OS clipboard, attachments from web/Feishu render inline, LaTeX replies draw as Unicode math.
+> Each item links to its own doc under [`docs/features/`](docs/features/) — one line here, the details (and demo videos) there.
----
-## Footer
-Every number that matters for a session — provider/model route, thinking level, context use, message and tool counts, plus a live clock — sits in one powerline bar pinned at the bottom, with the editor's top border showing your cwd and git branch. You see cost pressure (context %, cache-hit %) and activity without ever leaving the terminal.
-```
-dsh ▸ volc-ark-plan ▸ deepseek-v4-flash ▸ high ▸ 48.7k/1.0M(4.6%) ▸ ⚡ CH85.4% ▸ 15 msgs ▸ 11 tools     00:02:13
-```
-**Cache-hit (`CHxx%`)** is the session's cache-hit rate — the share of the session's total billed input traffic that was served from the prompt cache. It is cumulative over the whole session (a provider/model switch does not reset it) and appears only once the session has actually billed any cached tokens. (Layout: [ARCHITECTURE.md](ARCHITECTURE.md).)
----
-## Think and tool panels
-Live reasoning and tool calls render as fixed panels pinned **above the chat input** instead of scrolling into the transcript, so the conversation thread stays readable. Panels appear only while something is active, and their height is configurable (`dsh-tui.panelHeight`: `1` line, `5`/`7`/`10` boxed rows, or `all`).
----
-## Subagents
-Running subagents show as compact one-line status rows below the editor — name, context use, rounds, elapsed — so delegation is visible without opening anything. `Ctrl+G` (or `/subagents`) opens a live transcript viewer; press `Enter` inside it to steer a child with a message. The `● Todos` panel keeps your task tree pinned above the input. Caps (`maxAgents`, `maxRounds`, configured via `/agents` → `l`) keep runaway delegation in check.
----
-## Ask User Question
-While mid-turn, the model can pause and ask you structured questions via the `ask_user_question` tool; the answering side is a docked panel above the input — no window juggling. One question at a time with tabs for the rest, `Ctrl+T` folds the panel away, double-`Esc` declines. Free text, multi-select, a multi-question review page, bracketed-paste and right-click / `Ctrl+Shift+C` system-clipboard paste are all supported.
-See the ask-question flow in action:
-https://github.com/user-attachments/assets/aa36be36-a508-4f53-ba85-efe0394dab11
+- [**Footer — live session overview**](docs/features/footer.md) — provider/model, context pressure and the session cache-hit rate at a glance, always in view.
+- [**Think & tool panels**](docs/features/think-tool-panels.md) — reasoning and tool activity stay out of the transcript, so the conversation reads clean.
+- [**Subagents**](docs/features/subagents.md) — every running subagent gets a status line; watch and steer it live.
+- [**Ask User Question**](docs/features/ask-user-question.md) — the model can pause and ask you structured questions, answered without leaving the TUI.
+- [**Feishu integration**](docs/features/feishu-demo.md) — dsh-tui-pi on the desktop and Feishu/Lark on the phone driving (and answering for) the same dsh session.
+- [**Dynamic context pruning (DCP)**](docs/features/dcp.md) — context stays within limits automatically, with zero LLM calls.
+- [**Persistent context**](docs/features/persistent-context.md) — your ground rules ride along on every request, hot-applied with no restart.
+- [**Model profiles & favorites**](docs/features/model-profiles.md) — switch a whole model setup per project and keep the picker small.
+- [**Sessions & resume**](docs/features/sessions-resume.md) — sessions stay tidy automatically and resume in a few keystrokes; a cross-process writer guard keeps the log single-writer.
+- [**Themes**](docs/features/themes.md) — GitHub light/dark palettes, hot-switchable; `auto` follows your terminal.
+- [**Search, selection & images**](docs/features/search-selection-images.md) — `Ctrl+Shift+F` over the whole transcript, drag-select copies to the OS clipboard, attachments from web/Feishu render inline, LaTeX replies draw as Unicode math.
+- [**Slash commands**](docs/features/slash-commands.md) — `/model`, `/resume`, `/btw`, `/profile-switch`, … plus everything dsh-native.
+- [**Startup plugin tree**](docs/features/startup-tree.md) — every profile plugin with its installed npm version, printed at launch.
 ---
-## Feishu integration demo
-dsh-tui-pi on the desktop and Feishu/Lark on the phone driving (and answering for) the same dsh session:
-https://github.com/user-attachments/assets/177e8839-523b-487e-b3d1-6d725cd8aba5
-https://github.com/user-attachments/assets/c0d7092f-deda-4443-b75a-2bc93bd30d86
-Demos courtesy of the [dsh-feishu Demos issue](https://github.com/fan56/dsh-feishu/issues/1).
----
-## Dynamic context pruning (DCP)
-Context stays within the model window automatically: [dsh-dcp](https://github.com/fan56/dsh-dcp) compacts the session **without calling an LLM to summarize**. Mount it once and it runs transparently — the footer's context segment follows the shrink, and inside a subagent each committed compaction shows as a `🧹` notice in the viewer.
+## Install and launch
 ```sh
-dsh plugin --profile tui add @aiwayds/dsh-dcp
+dsh plugin --profile tui add @aiwayds/dsh-tui-pi
+dsh plugin --profile tui add @aiwayds/dsh-subagent-registry   # optional
+dsh plugin --profile tui add @aiwayds/dsh-dcp                 # optional
+dsh --profile tui          # launch (or: dsh-tui-pi)
 ```
----
-## Persistent context
-`$DSH_HOME/APPEND_SYSTEM.md` (default `~/.dsh/APPEND_SYSTEM.md`, pi convention) is appended to the **main agent's** system prompt and hot-applied — edit the file and the next request sees it, no restart. The TUI seeds it from a template on first run, keeps its marked todo-lifecycle section idempotent, and never overwrites your content. Subagents are deliberately left untouched.
----
-## Model profiles and favorites
-`/profile-switch` swaps a whole setup — default model, thinking level and every subagent's model — in one pick; `p` pins a profile to the current directory so every new session in that tree loads it. `/model` favorites and hidden lists keep the picker small. Manage profiles with `/profile-cfg` (roster, edit, save-current, rename, delete).
----
-## Sessions and resume
-`/resume` restores any recent session in a few keystrokes (ordered by last update), `/new` starts fresh, `/export` writes the session log as JSONL (`~/Downloads/dsh-session-<id>.jsonl`). A startup janitor (`dsh-tui.retention.*`) prunes old session logs so the store never grows without bound; the resume picker shows only the working set (`dsh-tui.resume.*`). Both are configurable in `~/.dsh/settings.yaml` with env overrides.
----
-## Themes
-GitHub light/dark palettes, hot-switched with `/theme`; `auto` detects your terminal and follows live light/dark switches. `DSH_TUI_THEME=light|dark` pins a scheme, `DSH_TUI_TRANSPARENT=1` makes the canvas see-through, `DSH_TUI_MOUSE=buttons|all|off` tunes mouse tracking.
----
-## Search, selection and images
+Everything that used to need manual patching — the canvas background, the `@deepseek-ai` module closure, the compaction backend — now happens automatically. Upgrade an existing profile after a release:
-- **Transcript search** — `Ctrl+Shift+F` opens an input overlay over the transcript; `Enter`/`Ctrl+G` and `Shift+Enter`/`Ctrl+Shift+G` walk the matches, `Esc` closes. While it is open the search owns the keys, so your Esc/Ctrl+C gestures stay untouched.
-- **Selection copy** — drag to select anywhere in the transcript; releasing copies through the OS clipboard (`pbcopy` / `wl-copy` / `xclip` / `xsel` / `clip`, with OSC 52 riding along for terminals that honor it). `DSH_TUI_COPY_ON_SELECT=0` keeps selection visual-only. Mouse tracking is still tuned by `DSH_TUI_MOUSE` (default `buttons`: clicks, wheel, drag-selection and scrollbar dragging, no idle-motion noise).
-- **Images from other surfaces** — messages sent with attachments from the web UI or Feishu render inline in the transcript: a real bitmap on Kitty / Ghostty / WezTerm (kitty graphics) and iTerm2, a clickable filename fallback elsewhere, and a muted "unavailable" note if the stored attachment fails verification. Session resume re-renders past images too.
-- **LaTeX in replies** — `$e^{i\pi}+1=0$` and `$$\int_0^1 x\,dx$$` render as terminal-friendly Unicode math (`e^(iπ)+1 = 0`, `∫₀¹ x dx`). Quirk inherited from upstream: a literal `$$` pair in prose is treated as display math.
+```sh
+node scripts/dev-upgrade.mjs                  # latest
+node scripts/dev-upgrade.mjs 1.0.5 --dry-run  # preview the plan first
+```
 ---
-## Slash commands
+## Companion plugins
-| Command | What it does |
-|---|---|
-| `/model` | Two-stage provider/model picker + thinking level; `f` favorite, `h` hide, `/` filter (persisted). |
-| `/think` | Reasoning-effort picker (`Off`/`High`/`Max`). |
-| `/session` | Read-only info: id, cwd, model, token usage, event count. |
-| `/resume` | Pick a persisted session (newest first), validate its log, restore it. |
-| `/new` | Detach the current session; the next prompt opens a fresh one. |
-| `/btw` | By-the-way side question while the main task runs — one tool-less model call over a recent-conversation snapshot, streamed into a temporary overlay. Never kept in the session; idle main line refuses it; `--model provider/model` overrides the route; bare `/btw` reopens the last answer (`DSH_TUI_BTW_CONTEXT_MESSAGES` sizes the snapshot). |
-| `/settings` | Text-based settings browser (namespaces, schema walk, secrets masked). |
-| `/export` | Write the current session log as JSONL. |
-| `/permission` | Permission-preset picker (read-only / workspace-write / danger-full-access). |
-| `/theme` | Color-scheme picker (`auto`/`light`/`dark`), applies immediately. |
-| `/preset` | Agent-preset picker; `<name>` switches directly, `next` cycles (same as `Tab`). |
-| `/profile-switch` | Apply a model profile to the live selection, the persisted default and the agent files; `p` pins the cwd. |
-| `/profile-cfg` | Manage profiles: edit default model / think / per-agent models, `s` save current, `n` new, `r` rename, `d` delete. |
-| `/agents` | Manage agent markdown files + subagent limits (`maxAgents`, `maxRounds`). |
-| `/subagents` | Pick a running/recent subagent and watch its live transcript; `Enter` steers it. |
-| `/skills` | Manage user skills (installed and available). |
-| `/reload` | Hot-reload the plugin from source after `pnpm build`. |
-| `/login` | Log in to a provider (or `/login openai`); **Custom provider…** adds any OpenAI/Anthropic-compatible gateway. |
-| `/logout` | Remove a provider's stored key and profile. |
-| `/hotkeys` | Keybinding browser and live editor. |
-Model-list auto-sync for hand-declared (baseURL) providers is no longer a
-built-in command: the separate `@aiwayds/dsh-model-sync` plugin (a default
-dependency of this package) keeps those routes' model lists up to date on its
-own schedule.
-Anything else falls through to the model as an ordinary prompt; dsh-native commands (`plan`, `compact`, `feedback`, `goal`, …) work unchanged.
+- [@aiwayds/dsh-ask-router](https://www.npmjs.com/package/@aiwayds/dsh-ask-router) — ships as a default dependency; fans every `ask_user_question` out to all answering surfaces (TUI panel, Feishu card) and the first answer wins. List it in the profile's `bundles` before the UI bundles to activate.
+- [@aiwayds/dsh-feishu](https://github.com/fan56/dsh-feishu) — optional; drives the same dsh session from Feishu/Lark on your phone ([demo](docs/features/feishu-demo.md)).
+- [@aiwayds/dsh-mcp-adapter](https://github.com/fan56/dsh-mcp-adapter) — optional; folds MCP tool schemas out of every prompt and adds the `/mcp` command ([demo](docs/features/mcp-adapter.md)).
 ---
@@ -189,31 +94,6 @@ Other knobs: `dsh-tui.panelHeight` (think/tool panel height), `dsh-tui.iconSet`
 ---
-## Install and launch
-```sh
-dsh plugin --profile tui add @aiwayds/dsh-tui-pi
-dsh plugin --profile tui add @aiwayds/dsh-subagent-registry   # optional
-dsh plugin --profile tui add @aiwayds/dsh-dcp                 # optional
-dsh --profile tui          # launch (or: dsh-tui-pi)
-```
-Everything that used to need manual patching — the canvas background, the `@deepseek-ai` module closure, the compaction backend — now happens automatically. Upgrade an existing profile after a release:
-```sh
-node scripts/dev-upgrade.mjs                  # latest
-node scripts/dev-upgrade.mjs 1.0.5 --dry-run  # preview the plan first
-```
----
-## Companion plugins
-- [@aiwayds/dsh-ask-router](https://www.npmjs.com/package/@aiwayds/dsh-ask-router) — ships as a default dependency; fans every `ask_user_question` out to all answering surfaces (TUI panel, Feishu card) and the first answer wins. List it in the profile's `bundles` before the UI bundles to activate.
-- [@aiwayds/dsh-feishu](https://github.com/fan56/dsh-feishu) — optional; drives the same dsh session from Feishu/Lark on your phone, including an ask-user card surface. Install into the same profile for phone-side participation.
----
 ## Development
 ```sh
@@ -228,6 +108,7 @@ pnpm test     # unit tests, node --test against lib/ (pretest builds; 1020 tests
 ## Documentation
+- [docs/features/](docs/features/) — one doc per feature, with demo videos.
 - [ARCHITECTURE.md](ARCHITECTURE.md) — full design: process model, layers, data flow.
 - [HANDOFF.md](HANDOFF.md) — session history and current state (Chinese).
 - [CHANGELOG.md](CHANGELOG.md) — release history.
@@ -238,4 +119,4 @@ pnpm test     # unit tests, node --test against lib/ (pretest builds; 1020 tests
 ## Credits
-The [Ask User Question](#ask-user-question) interaction is inspired by [juicesharp/rpiv-ask-user-question](https://github.com/juicesharp/rpiv-ask-user-question) (adapted to this TUI's docked-panel and dsh `userQuestions` provider architecture; all code here is original).
+The [Ask User Question](docs/features/ask-user-question.md) interaction is inspired by [juicesharp/rpiv-ask-user-question](https://github.com/juicesharp/rpiv-ask-user-question) (adapted to this TUI's docked-panel and dsh `userQuestions` provider architecture; all code here is original).

package/README.zh-CN.md CHANGED Viewed

@@ -12,131 +12,47 @@ https://github.com/user-attachments/assets/6a7e00bb-1fd0-4bc5-9070-457f1e9fa54d
 ## ✨ 功能亮点
-> 每一项都链接到下文对应小节——一句话讲清楚它能给你什么。
-- [**Footer——会话实时总览**](#footer-状态栏) — provider/model、上下文压力与会话缓存命中率一眼看清，始终在视线内。
-- [**Think 与 Tool 面板**](#think-与-tool-面板) — 推理和工具活动不进对话记录，对话读起来干净清爽。
-- [**Subagents 子代理**](#subagents-子代理) — 每个运行中的 subagent 都有一行状态；实时观看并操控它。
-- [**Ask User Question**](#ask-user-question-向用户提问) — 模型可以暂停下来向你提结构化问题，无需离开 TUI 即可作答。
-- [**飞书集成演示**](#飞书集成演示) — 桌面上的 dsh-tui-pi 与手机上的飞书/Lark 驱动（并代答）同一个 dsh session。
-- [**Dynamic context pruning (DCP)**](#dynamic-context-pruning-dcp) — 上下文自动保持在限制内，零 LLM 调用。
-- [**Persistent context 持久上下文**](#persistent-context-持久上下文) — 你的基本规则随每次请求生效，热应用无需重启。
-- [**模型 profile 与收藏**](#模型-profile-与收藏) — 按项目整体切换一套模型配置，并让选择器保持精简。
-- [**Sessions 会话与恢复**](#sessions-会话与恢复) — 会话自动保持整洁，几次按键即可恢复。
-- [**Themes 主题**](#themes-主题) — GitHub 明/暗配色，热切换；`auto` 跟随你的终端。
+> 每一项对应 [`docs/features/`](docs/features/) 下的一篇独立文档（英文），内附演示视频。
----
-## Footer 状态栏
-一个 session 所有关键数字——provider/model 路由、推理等级、上下文占用、消息与工具计数，外加实时时钟——都收在钉于屏幕底部的同一条 powerline 状态栏里，编辑器顶部边框则显示你的工作目录和 git 分支。不用离开终端，就能看到成本压力（context %、cache-hit %）和实时活动。
-```
-dsh ▸ volc-ark-plan ▸ deepseek-v4-flash ▸ high ▸ 48.7k/1.0M(4.6%) ▸ ⚡ CH85.4% ▸ 15 msgs ▸ 11 tools     00:02:13
-```
-**Cache-hit（`CHxx%`）** 是会话的缓存命中率——会话全部计费输入流量中由 prompt 缓存供给的占比。它按整个 session 累计（切换 provider/model 不会重置），并且只有会话实际计费过缓存 token 后才会显示。（布局见 [ARCHITECTURE.md](ARCHITECTURE.md)。）
----
-## Think 与 Tool 面板
-实时推理和工具调用渲染为**钉在聊天输入框上方**的固定面板，而不是滚进对话记录，因此对话线程始终可读。面板只在有活动时才出现，高度可配置（`dsh-tui.panelHeight`：`1` 行，`5`/`7`/`10` 行带边框，或 `all`）。
----
-## Subagents 子代理
-运行中的 subagent 以紧凑的单行状态显示在编辑器下方——名称、上下文占用、rounds、已耗时——不用打开任何东西就能看到委派情况。`Ctrl+G`（或 `/subagents`）打开实时 transcript 查看器；在查看器内按 `Enter` 即可给子代理发消息 steer。`● Todos` 面板把你的任务树钉在输入框上方。上限（`maxAgents`、`maxRounds`，经 `/agents` → `l` 配置）防止委派失控。
+- [**Footer 状态栏**](docs/features/footer.md) —— provider/model、上下文压力、会话缓存命中率，始终在视野里。
+- [**Think 与 Tool 面板**](docs/features/think-tool-panels.md) —— 推理与工具活动不进 transcript，对话保持干净。
+- [**Subagents 子代理**](docs/features/subagents.md) —— 每个运行中的子代理一行状态；实时观看并 steer。
+- [**Ask User Question 向用户提问**](docs/features/ask-user-question.md) —— 模型可暂停并提问结构化问题，不用离开 TUI。
+- [**飞书集成**](docs/features/feishu-demo.md) —— 桌面端 dsh-tui-pi + 手机端飞书/Lark 驱动同一个 dsh session。
+- [**动态上下文修剪（DCP）**](docs/features/dcp.md) —— 上下文自动保持在窗口内，零 LLM 调用。
+- [**持久上下文**](docs/features/persistent-context.md) —— 你的基本规则随每个请求生效，热应用无需重启。
+- [**模型 profile 与收藏**](docs/features/model-profiles.md) —— 按项目切换整套模型配置，选择器保持精简。
+- [**Sessions 会话与恢复**](docs/features/sessions-resume.md) —— 会话自动保持整洁、几次按键恢复；跨进程写者守卫保证日志单写者。
+- [**Themes 主题**](docs/features/themes.md) —— GitHub 明/暗配色热切换；`auto` 跟随终端。
+- [**搜索、选择与图片**](docs/features/search-selection-images.md) —— `Ctrl+Shift+F` 全文搜索、划选复制到系统剪贴板、web/飞书附件内联渲染、LaTeX 转 Unicode 数学。
+- [**斜杠命令**](docs/features/slash-commands.md) —— `/model`、`/resume`、`/btw`、`/profile-switch`……外加全部 dsh 原生命令。
+- [**启动插件树**](docs/features/startup-tree.md) —— 启动即打印每个 profile 插件及其安装的 npm 版本。
 ---
-## Ask User Question 向用户提问
-模型在一轮回答进行到一半时可以暂停，通过 `ask_user_question` 工具向你提结构化问题；应答侧是停靠在输入框上方的面板——不用来回切换窗口。一次一个问题，其余收进标签页；`Ctrl+T` 把面板折叠起来，双击 `Esc` 拒绝作答。自由文本、多选、多问题确认页、bracket-paste，以及右键 / `Ctrl+Shift+C` 从系统剪贴板粘贴，全都支持。
-看看 ask-question 流程的实际效果：
-https://github.com/user-attachments/assets/aa36be36-a508-4f53-ba85-efe0394dab11
----
-## 飞书集成演示
-桌面上的 dsh-tui-pi 与手机上的飞书/Lark 驱动（并代答）同一个 dsh session：
-https://github.com/user-attachments/assets/177e8839-523b-487e-b3d1-6d725cd8aba5
-https://github.com/user-attachments/assets/c0d7092f-deda-4443-b75a-2bc93bd30d86
-演示来自 [dsh-feishu Demos issue](https://github.com/fan56/dsh-feishu/issues/1)。
----
-## Dynamic context pruning (DCP)
-上下文自动保持在模型窗口内：[dsh-dcp](https://github.com/fan56/dsh-dcp) 压缩 session **无需调用 LLM 做摘要**。挂载一次即透明运行——footer 的 context 段随压缩回落；在 subagent 内部，每次提交的压缩都会在查看器中以 `🧹` 提示显示。
+## 安装与启用
 ```sh
-dsh plugin --profile tui add @aiwayds/dsh-dcp
+dsh plugin --profile tui add @aiwayds/dsh-tui-pi
+dsh plugin --profile tui add @aiwayds/dsh-subagent-registry   # optional
+dsh plugin --profile tui add @aiwayds/dsh-dcp                 # optional
+dsh --profile tui          # 启动（或：dsh-tui-pi）
 ```
----
-## Persistent context 持久上下文
-`$DSH_HOME/APPEND_SYSTEM.md`（默认 `~/.dsh/APPEND_SYSTEM.md`，pi 约定）会追加到**主 agent** 的 system prompt 末尾并热应用——编辑文件后下一条请求就能看到，无需重启。TUI 首次运行时从模板播种该文件，幂等维护其带标记的 todo-lifecycle 段，并且绝不覆盖你的内容。子代理被刻意排除在外。
----
-## 模型 profile 与收藏
-`/profile-switch` 一次选择切换整套配置——默认模型、推理等级、以及每个 subagent 的模型；`p` 把某个 profile 钉到当前目录，该目录树下的每个新 session 都会加载它。`/model` 的收藏与隐藏列表让选择器保持精简。用 `/profile-cfg` 管理 profile（名录、编辑、保存当前、重命名、删除）。
----
-## Sessions 会话与恢复
-`/resume` 用几次按键恢复任意最近的 session（按最后更新排序），`/new` 开启新会话，`/export` 把会话日志写成 JSONL（`~/Downloads/dsh-session-<id>.jsonl`）。启动清理器（`dsh-tui.retention.*`）修剪旧的会话日志，存储不会无界增长；resume 选择器只显示工作集（`dsh-tui.resume.*`）。两者都可在 `~/.dsh/settings.yaml` 配置，并带环境变量覆盖。
----
-## Themes 主题
+过去需要手工 patch 的一切——画布背景、`@deepseek-ai` 模块闭包、compaction 后端——现在都自动完成。发版后升级现有 profile：
-GitHub 明/暗配色，`/theme` 热切换；`auto` 检测你的终端并跟随实时的明/暗切换。`DSH_TUI_THEME=light|dark` 钉选一套配色，`DSH_TUI_TRANSPARENT=1` 让画布透出终端背景，`DSH_TUI_MOUSE=buttons|all|off` 调节鼠标追踪。
+```sh
+node scripts/dev-upgrade.mjs                  # 最新版
+node scripts/dev-upgrade.mjs 1.0.5 --dry-run  # 先预览执行计划
+```
 ---
-## 斜杠命令
+## Companion plugins 伴生插件
-| 命令 | 功能 |
-|---|---|
-| `/model` | 两阶段 provider/model 选择器 + 推理等级；`f` 收藏、`h` 隐藏、`/` 过滤（持久化）。 |
-| `/think` | 推理强度选择器（`Off`/`High`/`Max`）。 |
-| `/session` | 只读信息：id、cwd、model、token 用量、事件数。 |
-| `/resume` | 选择持久化的 session（新的在前），校验日志后恢复。 |
-| `/new` | 分离当前 session；下一条 prompt 开启新会话。 |
-| `/btw` | 主线任务运行中的「顺带一问」——一次无工具的单次模型调用（带最近对话快照），答案流式呈现在临时浮层里。不进会话记录；主线空闲时拒绝使用；`--model provider/model` 临时换路由；空参 `/btw` 回看上一条问答（`DSH_TUI_BTW_CONTEXT_MESSAGES` 控制快照条数）。 |
-| `/settings` | 文本式设置浏览器（命名空间、schema 遍历、密钥脱敏）。 |
-| `/export` | 把当前会话日志写成 JSONL。 |
-| `/permission` | 权限预设选择器（read-only / workspace-write / danger-full-access）。 |
-| `/theme` | 配色选择器（`auto`/`light`/`dark`），立即生效。 |
-| `/preset` | agent preset 选择器；`<name>` 直接切换，`next` 循环（同 `Tab`）。 |
-| `/profile-switch` | 把模型 profile 应用到当前选择、持久化默认值和 agent 文件；`p` 钉住当前目录。 |
-| `/profile-cfg` | 管理 profile：编辑默认模型 / think / 各 agent 模型，`s` 保存当前，`n` 新建，`r` 重命名，`d` 删除。 |
-| `/agents` | 管理 agent markdown 文件 + subagent 上限（`maxAgents`、`maxRounds`）。 |
-| `/subagents` | 选择运行中/最近的 subagent 并观看其实时 transcript；`Enter` steer。 |
-| `/skills` | 管理用户 skills（已安装与可用）。 |
-| `/reload` | `pnpm build` 后从源码热重载插件。 |
-| `/login` | 登录 provider（或 `/login openai`）；**Custom provider…** 添加任意 OpenAI/Anthropic 兼容网关。 |
-| `/logout` | 删除 provider 的已存 key 与 profile。 |
-| `/hotkeys` | 快捷键浏览器与实时编辑器。 |
-手工声明（baseURL）provider 的模型列表自动同步不再是内置命令：由独立的
-`@aiwayds/dsh-model-sync` 插件（本包的默认依赖）按自己的节奏保持这些路由的
-模型列表最新。
-其余内容作为普通 prompt 落给模型；dsh 原生命令（`plan`、`compact`、`feedback`、`goal`……）原样可用。
+- [@aiwayds/dsh-ask-router](https://www.npmjs.com/package/@aiwayds/dsh-ask-router) —— 作为默认依赖附带；把每个 `ask_user_question` 扇出到所有应答面（TUI 面板、飞书卡片），第一个答案获胜。把它加进 profile 的 `bundles`，放在任何 UI bundle 之前即可激活。
+- [@aiwayds/dsh-feishu](https://github.com/fan56/dsh-feishu) —— 可选；用手机上的飞书/Lark 驱动同一个 dsh session（[演示](docs/features/feishu-demo.md)）。
+- [@aiwayds/dsh-mcp-adapter](https://github.com/fan56/dsh-mcp-adapter) —— 可选；把 MCP 工具 schema 折出每个请求，并提供 `/mcp` 命令（[演示](docs/features/mcp-adapter.md)）。
 ---
@@ -151,6 +67,7 @@ GitHub 明/暗配色，`/theme` 热切换；`auto` 检测你的终端并跟随
 | `Ctrl+L` | 打开 model/think 选择器 |
 | `Ctrl+G` | 打开 subagent 选择器（查看器内 `Enter` 打开 steer） |
 | `Ctrl+O` | 待发消息队列（`s` 立即 steer · `d` 移除） |
+| `Ctrl+Shift+F` | 全文搜索（`Enter`/`Ctrl+G` 下一个 · `Shift+Enter`/`Ctrl+Shift+G` 上一个 · `Esc` 关闭） |
 | `Tab` | 循环切换 agent preset |
 | `↑` / `↓` | 浏览已提交消息历史 |
@@ -177,31 +94,6 @@ dsh-tui:
 ---
-## 安装与启用
-```sh
-dsh plugin --profile tui add @aiwayds/dsh-tui-pi
-dsh plugin --profile tui add @aiwayds/dsh-subagent-registry   # optional
-dsh plugin --profile tui add @aiwayds/dsh-dcp                 # optional
-dsh --profile tui          # 启动（或：dsh-tui-pi）
-```
-过去需要手工 patch 的一切——画布背景、`@deepseek-ai` 模块闭包、compaction 后端——现在都自动完成。发版后升级现有 profile：
-```sh
-node scripts/dev-upgrade.mjs                  # 最新版
-node scripts/dev-upgrade.mjs 1.0.4 --dry-run  # 先预览执行计划
-```
----
-## Companion plugins 伴生插件
-- [@aiwayds/dsh-ask-router](https://www.npmjs.com/package/@aiwayds/dsh-ask-router) —— 作为默认依赖附带；把每个 `ask_user_question` 扇出到所有应答面（TUI 面板、飞书卡片），第一个答案获胜。把它加进 profile 的 `bundles`，放在任何 UI bundle 之前即可激活。
-- [@aiwayds/dsh-feishu](https://github.com/fan56/dsh-feishu) —— 可选；用手机上的飞书/Lark 驱动同一个 dsh session，包括 ask-user 卡片面。想手机侧参与就装进同一个 profile。
----
 ## 开发
 ```sh
@@ -216,6 +108,7 @@ pnpm test     # 单元测试，node --test 对 lib/ 执行（pretest 构建；55
 ## 文档索引
+- [docs/features/](docs/features/) —— 每个功能一篇独立文档，附演示视频（英文）。
 - [ARCHITECTURE.md](ARCHITECTURE.md) —— 完整设计：进程模型、分层、数据流。
 - [HANDOFF.md](HANDOFF.md) —— 会话历史与当前状态（中文）。
 - [CHANGELOG.md](CHANGELOG.md) —— 发布历史。
@@ -226,4 +119,4 @@ pnpm test     # 单元测试，node --test 对 lib/ 执行（pretest 构建；55
 ## 致谢
-[Ask User Question](#ask-user-question-向用户提问) 交互的灵感来自 [juicesharp/rpiv-ask-user-question](https://github.com/juicesharp/rpiv-ask-user-question)（改编自本 TUI 的停靠面板与 dsh `userQuestions` provider 架构；这里的全部代码均为原创）。
+[Ask User Question](docs/features/ask-user-question.md) 交互的灵感来自 [juicesharp/rpiv-ask-user-question](https://github.com/juicesharp/rpiv-ask-user-question)（改编自本 TUI 的停靠面板与 dsh `userQuestions` provider 架构；这里的全部代码均为原创）。

package/assets/demos/mcp.mp4 ADDED Viewed

Binary file

package/cordis.patch.yml CHANGED Viewed

@@ -14,20 +14,9 @@
 # the bundle to be wired into the model-facing tool catalog. Without this
 # insert, the `ask_user_question` tool never registers with the model and
 # the user-questions seam has no visible surface in this profile.
-#
-# dsh-model-sync is mounted here: it is a default dependency of this package
-# and handles the automatic sync of the built-in routes' model lists — no TUI
-# command involved. It ships its own bundle patch
-# (@aiwayds/dsh-model-sync/cordis.patch.yml); the dependency only puts its
-# package in the profile's node_modules so the patch has something to mount.
-# Do NOT also list @aiwayds/dsh-model-sync in a profile's bundles: mounting
-# it here too would duplicate the entry id and crash the loader — remove it
-# from the profile's bundles instead.
 - insert:
     - id: tui-pi
       name: '@aiwayds/dsh-tui-pi'
     - id: tool-ask-user
       name: '@deepseek-ai/dsh-tool-ask-user'
-    - id: dsh-model-sync
-      name: '@aiwayds/dsh-model-sync'

package/lib/index.js CHANGED Viewed

@@ -953,17 +953,17 @@ export function apply(ctx) {
         }), 'dsh-tui-pi: /preset');
         // /profile-switch + /profile-cfg: user model profiles — named snapshots
         // of the whole model configuration (default model + think level, every
-        // subagent's model/thinking) that switch in one step between contexts
-        // like work and personal. `/profile-switch` applies one;
-        // `/profile-cfg` configures them (edit fields, save current, rename,
-        // review). Storage lives at $DSH_HOME/model-profiles.json, agent
-        // overrides in ~/.dsh/agents/*.md.
+        // subagent's model/thinking). Switching is WORKSPACE-SCOPED: Enter
+        // applies the profile to the live session + agent markdown and binds the
+        // current directory tree (.dsh-profile) so NEW sessions here start on
+        // it — other trees keep their own binding, or the global default.
+        // Storage lives at $DSH_HOME/model-profiles.json.
         const profileDeps = {
             getSelection: () => bridge.getSelection(),
             setSelection: selection => bridge.setSelection(selection),
         };
         const profileHandler = async () => {
-            const summary = await openProfileSwitcher(ctx, ui.tui, ui.theme, profileDeps, refocusEditor);
+            const summary = await openProfileSwitcher(ui.tui, ui.theme, profileDeps, refocusEditor);
             ui.requestRender();
             return summary === undefined
                 ? { kind: 'success', text: 'Profile unchanged.' }
@@ -972,7 +972,7 @@ export function apply(ctx) {
         commands.registerLocal('profile-switch', profileHandler);
         ctx.effect(() => ctx.commands.register({
             name: 'profile-switch',
-            description: 'Switch the model profile (default model, subagent models, think levels)',
+            description: 'Switch the model profile for this workspace (default model, subagent models, think levels)',
             handler: invocation => profileHandler(invocation.rawInput, invocation.signal),
         }), 'dsh-tui-pi: /profile-switch');
         const profilesHandler = async (rawInput) => {