@songtonyli/dsh-cli 0.1.84 → 0.1.86
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.
- package/README.md +1 -1
- package/bin/dsh.mjs +1 -1
- package/node_modules/@deepseek-ai/dsh-client-modules/lib/index.js +1 -1
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar/lib/client.js +1 -1
- package/node_modules/@deepseek-ai/dsh-experimental-tool-agent-team/README.i18n.yaml +14 -14
- package/node_modules/@deepseek-ai/dsh-experimental-tool-agent-team/README.md +7 -7
- package/node_modules/@deepseek-ai/dsh-experimental-tool-agent-team/README.zh.md +7 -7
- package/node_modules/@deepseek-ai/dsh-experimental-tool-agent-team/lib/index.js +28 -4
- package/node_modules/@deepseek-ai/dsh-llm-pi-ai/lib/index.js +39 -52
- package/node_modules/@deepseek-ai/dsh-subagent/README.i18n.yaml +4 -4
- package/node_modules/@deepseek-ai/dsh-subagent/README.md +3 -3
- package/node_modules/@deepseek-ai/dsh-subagent/README.zh.md +3 -3
- package/node_modules/@deepseek-ai/dsh-subagent/lib/index.js +8 -5
- package/node_modules/@deepseek-ai/dsh-subagent/lib/types/child-agent.js +9 -4
- package/node_modules/@deepseek-ai/dsh-tui-app/README.i18n.yaml +10 -10
- package/node_modules/@deepseek-ai/dsh-tui-app/README.md +16 -11
- package/node_modules/@deepseek-ai/dsh-tui-app/README.zh.md +16 -11
- package/node_modules/@deepseek-ai/dsh-tui-app/lib/index.js +1938 -1409
- package/node_modules/execa/package.json +1 -1
- package/node_modules/unist-util-visit/lib/index.js +173 -161
- package/node_modules/unist-util-visit/license +1 -1
- package/node_modules/unist-util-visit/package.json +46 -56
- package/node_modules/unist-util-visit/readme.md +87 -27
- package/node_modules/unist-util-visit-parents/lib/color.js +4 -0
- package/node_modules/unist-util-visit-parents/lib/color.node.js +4 -0
- package/node_modules/unist-util-visit-parents/lib/index.js +235 -52
- package/node_modules/unist-util-visit-parents/license +1 -1
- package/node_modules/unist-util-visit-parents/package.json +44 -54
- package/node_modules/unist-util-visit-parents/readme.md +185 -74
- package/package.json +4 -4
|
@@ -42,7 +42,7 @@ Once a quit has saved the session, the app prints `dsh: session <id> saved; resu
|
|
|
42
42
|
|
|
43
43
|
Every frame is drawn one column in from each edge of the terminal, so no line of the conversation or of the docked chrome touches either side. The header names the session by its title once one is generated or set, with the id beside it. The transcript grows in the terminal's own scrollback: your prompts start with `❯` on a tinted full-width band while colour is on (attachments listed under them), and a prompt steered or injected into a turn that already had a model step draws dim on a darker band so it recedes behind the turn it joined, assistant reasoning is dim italic under a `✻ Thinking` header above the Markdown reply, a bloom spinning beside `Thinking` while it streams, and each tool call is a card with a status glyph — a yellow spinner of that tool family's flowers, blooms, and stars while it runs, a green `◆` once done, a red `◆` on failure — the tool name in bold cyan, the presenter headline in teal — without the tool name a presenter repeated, so `Read src/app.ts` draws as `read src/app.ts`, and for a shell card the call's own summary, never the command, which the card draws once as its `$` row — a loading row while it runs, and a body folded to `toolPreviewLines` rows. A top-level workflow call also draws its own run beside that card: the name, member count, status, and a ten-cell member progress bar with the settled count, then each phase and the members that started. While a live run runs, its `◇` pulses through a diamond animation and each running member's `○` spins in the subagent family's flowers, one phase ahead of the member before it; a run drawn from a replayed log spins only while its background job is still live, and reduced motion draws the static glyphs. Running groups and groups with a failed, cancelled, or interrupted member open; a clean completion stays closed. Space or Enter on a run or phase folds that level, and Enter on a running member opens its child only while that child is a live direct child of this session. The card appears when the model starts the call and flows out row after row, each row left to right, at one pace whatever the card holds: a full-width row takes `toolRevealFrames` frames, a shorter row proportionally less, and the columns just drawn brighten from the terminal background to their own colors. The result rows flow out the same way when the tool answers, behind whatever the card is still drawing; neither the call nor the result waits for the animation. An `edit` or `write` diff card fills each added row edge to edge with a green background and each removed row with a red one, the removed rows above the added ones, and paints the `+` and `-` in their own lighter colour so each sign reads against the fill rather than in it; a wrapped row carries the fill on without a second sign; once the tool applied the change, the applied hunks replace the diff the call carried and lead every row with its file line number, the new file's for added and unchanged rows and the old file's for removed rows. A `subagent` or `subagent_*` card draws folded as one row behind the same status glyph, spinning while it runs and a dim `◆` for a child handed to the background: while it runs, the tool name, the task description, and the requested model and `background` when the call names them; once settled, the description dimmed with `[done]`, `[started]` for a child handed to the background, or `[failed]` at the right edge. `Space` on the marked row, or `Ctrl+O`, unfolds the full card. A nonempty system prompt and each injected context — instructions, catalogs, snapshots, notices, relays, and recalls — draw as a dim `⬡` title over the first `contextPreviewLines` rows of their model-facing text, with each snapshot contribution named above its own rows; an empty system prompt is omitted. A compaction, from `/compact` or automatic, draws as one context block whose accent `⬡` title names its origin and the estimated tokens it replaced and its summary costs, as in `context compacted by /compact · ~6.4k → ~0.9k tokens` or `context compacted automatically in turn 12 · …`; under the title, `compressed` names the item count and turns the summary replaced, each prompt among them (five at most, one row each), and a count of the replies, tool results by tool, context blocks, and earlier summaries, and `preserved` names the system prompt and what each later turn still holds verbatim; both stay drawn while the summary under them folds to `contextPreviewLines` rows like any context block. The checkpoint message itself is not drawn again. A `/compact` attempt the log closes with an error prints `/compact failed · <error>` when the session is redrawn, since the live command reports its own failure; a failed automatic attempt changes nothing and draws nothing, as in the browser. A tool card and a context block that carry more rows than they draw end on one marker: `… <n> more rows · Space expands` while the conversation's focus holds that block, and `… <n> more rows · Ctrl+O expands` otherwise. Fenced code in a reply, the file rows of a `read` card, the changed rows of an `edit` or `write` diff card — with `+` additions marked green, `-` removals red, and source text behind those signs drawn in the language the file's extension names — and the shell command of a `!` / `!!` draft, a `$ command` user-shell row (its `$` in the accent colour), and a terminal tool card, use syntax colours from a theme the terminal's own background picks, light or dark; the grammar of a language loads on the first block that asks for it, so that block draws plain and is repainted in colour a moment later, and a language with no grammar here, a terminal that reports neither 24-bit nor 256 colours, and `codeHighlight: false` each draw every block plain. Headings and list markers use orange, links and inline code use magenta, and quotes stay dim. Every hue is a Tokyo Night (Night) color, drawn exactly when `COLORTERM` declares `truecolor` or `24bit` and as the nearest of the 256 indexed colors otherwise; the background bands keep their 256-color greys and diff tints. Streamed reasoning, reply text, and tool arguments are queued as they arrive and drawn a share per frame, about 60 frames per second by default, so a network burst spreads over `streamPaceFrames` frames instead of landing at once, and the queue never holds the model call back. Streamed reply text fades in and every word keeps its own clock: a word enters near the terminal's background color and brightens to the color it settles in over `streamFadeSteps` ticks of `streamFadeStepMs` each, so a fast stream leaves a longer trail of brightening words rather than a darker one. Streamed reasoning floats out over the same duration: it appears at a lifted color and recedes to the dim italic it settles in. Each column of a tool card brightens over it from the terminal background to the palette color it settles in; a card redrawn from persisted history carries no flow or fade, and text that has settled is never dimmed again.
|
|
44
44
|
|
|
45
|
-
Below the transcript sit a spinner while the agent works — `thinking`, `writing`, `calling <tool>`, a retry, or `compacting`, each beside its own braille animation: circling dots, filling lines, an orbiting dot, a sliding bar, or a settling cell — with a bright highlight sweeping across the word, plus live `↑` send and `↓` receive tokens for the current model call, as compact `k` / `M` / `B` counts, growing as the stream arrives and settling on the provider usage chunk — any open prompt, a boxed follow-ups list while messages wait, an activity board of the open turn's todos and
|
|
45
|
+
Below the transcript sit a spinner while the agent works — `thinking`, `writing`, `calling <tool>`, a retry, or `compacting`, each beside its own braille animation: circling dots, filling lines, an orbiting dot, a sliding bar, or a settling cell — with a bright highlight sweeping across the word, plus live `↑` send and `↓` receive tokens for the current model call, as compact `k` / `M` / `B` counts, growing as the stream arrives and settling on the provider usage chunk — any open prompt, a boxed follow-ups list while messages wait, an activity board of the open turn's todos and one row per subagent while either has a row — completed todo content scratched out and status glyphs colored green, yellow, or blue, the in-progress one a spinner, at most four todo rows then `+<n> more`, each subagent row its spinner or `✓` / `✗`, its task label — `<name> · <role>` for an Agent Teams teammate — and the last sentence of what it said it was doing, cut to one terminal line, running subagents first and at most three then `+<n> more subagents`, not a focus region, gone on `turn/end` and bind — the editor, the subagent panel, and the footer: a status bar that, unfocused, is one line built from both ends inward. The editor's caret is the terminal's own blinking bar: the app asks for that shape at start, gives your default back on quit, and draws no caret at all while the status bar or the panel holds the keyboard. The model is purple and the entry keys magenta; live turn, context, and todo facts use yellow, magenta, and green. The model is anchored at the left edge and is never dropped — past 20 columns it falls back to the bare model name, and only a label still too wide for that is ellipsized — and the two keys that leave the input are anchored at the right edge as `Shift+↑ read · Shift+↓ status`, or `Shift+↑ select · Shift+↓ status` while follow-ups wait, narrowing to `Shift+↑↓ nav` and dropped below 40 columns. The key facts fill whatever middle is left, in bar order: effort (`effort default` when the selection leaves reasoning to the model), the running turn's elapsed time, the context window percentage, the todo counts, and the workspace path (shortened with `~` and `…/` when long). Every segment that middle cannot hold folds into a trailing `+N`, together with the segments the unfocused line never draws — the permission preset, token usage (session totals plus the in-flight call), the goal and plan-mode markers from the projection seam, and the count of pending attachments. Model-request retries appear as notices, the same facts the browser's markers carry.
|
|
46
46
|
|
|
47
47
|
While the keyboard walks the conversation a framed inspector is docked directly above the editor, and the frame is the mode: it is drawn exactly while the conversation holds the keyboard. Its top rule carries an inverse ` ● READ ` chip and the focused section's heading — the section's position among the navigable blocks, the turn it belongs to, and what the section is — as in `╭ ● READ ─ 3/12 · turn 2 · bash git status · result ─╮`. Under it the block's parts draw as a numbered wrapping strip like `← 1 call · [2 result] →` when the block has more than one, the held label bracketed as well as accented so the selection is legible with no color at all; then the section's own source rows, each closed by a `│ ` border on both sides and wrapped four columns narrower, folded at `focusPreviewLines` for every section kind — a system prompt and an injected context included — with `… <n> more rows · Ctrl+G reads it` under them. The bottom rule carries the keys the conversation answers, `↑↓ sections · ←→ parts · Space folds · Ctrl+G reader · Esc input`, narrowed to `↑↓ ←→ · Space folds · Esc input` and then to `Esc input` as the terminal loses columns.
|
|
48
48
|
|
|
@@ -52,11 +52,11 @@ The focused block is also marked where it stands, with a two-column gutter that
|
|
|
52
52
|
|
|
53
53
|
Transient key feedback floats as a dim framed line in the top-right corner of the viewport: `press Esc again to stop turn <n>`, `press Ctrl+C again to quit` — `press Ctrl+C again to quit · stops 1 command, 2 background jobs` while commands, background jobs, or subagents run — and `nothing in the transcript to read yet`. It holds at full strength for `toastMs`, fades out, costs the conversation no row of its own, and takes no keyboard; where the renderer can no longer repaint the top of the viewport it is printed into the conversation instead, which keeps it. Facts worth keeping are notices in the conversation: `stopping the turn…`, `wait for the session switch to finish`, `above the repaint window · opened in the reader`, and every command result.
|
|
54
54
|
|
|
55
|
-
Motion reaches past streamed text: every lift and float rides the same fade tick, and every working animation one spinner tick. The keyboard landing on the conversation, the subagent panel, or the status bar lifts that surface's frame, its chip, and the mark it holds for twelve ticks of `streamFadeStepMs`; a step of the conversation walk lifts the newly focused gutter for six; and a step along the bar lifts the selected label for eight. A new or status-changed activity-board todo row, and a
|
|
55
|
+
Motion reaches past streamed text: every lift and float rides the same fade tick, and every working animation one spinner tick. The keyboard landing on the conversation, the subagent panel, or the status bar lifts that surface's frame, its chip, and the mark it holds for twelve ticks of `streamFadeStepMs`; a step of the conversation walk lifts the newly focused gutter for six; and a step along the bar lifts the selected label for eight. A new or status-changed activity-board todo row, and a changed subagent row, float out on the fade tick; replay and `reducedMotion` draw the settled board. Every working animation has eight frames, takes the one it draws from the clock, and steps on the spinner tick of `spinnerMs`, 100 ms by default, so everything that spins advances at the same instant and speed, a label change keeps the beat, and the tick is armed only while one of them is drawn. The working spinner alone draws braille, its animation following its status, so it never repeats a card's glyph. A running tool card and a folded subagent row draw the animation of that tool's family, and an in-progress todo row and a running subagent row on the activity board draw the planning family's. Each of those animations mixes flowers, blooms, and stars, no two families share a glyph, and every frame of one family is different, so two indicators of one family at different phases never draw the same glyph. An indicator that starts while others of its family spin takes a phase at which it never draws their glyph at the same instant, for up to eight of that family spinning together; beyond eight, it takes the phase the fewest indicators of that family hold. A card whose header has scrolled above the part of the screen the renderer can repaint draws the static `◆` from then on, and `reducedMotion` draws every one of them still — the card's `◆`, the todo's `▸`, and the working spinner's label without a glyph — with no spinner tick. The reader arrives complete on the screen it owns, and what it newly shows floats out on the fade tick: opening it and showing another turn float out the whole turn, and stepping the list to another section of the same turn floats out that section, over `streamFadeSteps` ticks; scrolling, live growth, and a rewrap float nothing out. No lift changes how many lines anything draws, and `reducedMotion` — like `NO_COLOR`, a disabled palette, and `TERM=dumb` — turns every lift and float off and arms no repaint for them.
|
|
56
56
|
|
|
57
|
-
The subagent panel is drawn while a local subagent session under the bound one is resident, or the listing carries a candidate it could not read; an external task has no local session and stays out of the panel. Unfocused it is one summary line with the listed count and the first child's key label; focused, its heading counts what it lists and ends on the keys it answers, `↑↓ children · Enter opens · Tab regions · Esc input`, narrowed to `↑↓ children · Esc input` and then to `Esc input` on a terminal that cannot hold them, and each row gives the child's depth indent, its label or id, its mode (`one-shot` or `continuable`), `resident`, whether its agent is `running`, `completed` after its latest settled turn, or `idle`, its elapsed time — the open turn's, else the total its settled turns took — and its token usage, as far as this process's own view of that child and the composed projections carry them. Six rows are drawn at most, with `+<n> more · /subagents lists them all` under them; `/subagents` shows an external task as `external task · no local session` and shows its no-local-session detail instead of opening a Session, a candidate the listing could not interpret draws as `unreadable: <reason>` and shows its reason instead of opening a Session, and a failed listing keeps the rows the last good one produced with `listing failed: <reason>` beneath. The panel disappears with its last row. `Enter` or `Right` on a readable row, like `Enter` on a readable `/subagents` row, opens that child as a subagent view: the terminal draws the child session in place of the bound one — its transcript, live stream, conversation walk, inspector, reader, and its own subagent panel — while the session it was entered from stays open. A resident child is read live, and any other is resumed. The entry's detail rows print as notices under `subagent <label> · Ctrl+P or /parent returns to session <id>`, the header ends on `◆ subagent view ›` with one `›` per level entered and `· Ctrl+P returns`, a shaded line directly above the input reads `◆ subagent view · main › <label> · Ctrl+P back to <parent>` for as long as the view is open, whatever the transcript has scrolled to, and `Ctrl+P` or `/parent` goes back one level, redrawing the parent from its log as it stands then. A one-shot child opens read-only: its banner opens with `◆ subagent view · one-shot, read-only`, a prompt or `!` line typed there is refused with a notice and stays in the editor, `Esc` does not stop its turn, and commands such as `/parent` still run, while a continuable child takes prompts and a stop as any session does. `/new`, `/clear`, `/resume`, `/sessions`, and `/fork` refuse while any session in that chain runs a turn or a background job, since releasing a session ends its jobs, and otherwise release every view with the session they leave; quitting releases every view and saves the root session.
|
|
57
|
+
The subagent panel is drawn while a local subagent session under the bound one is resident, or the listing carries a candidate it could not read; an external task has no local session and stays out of the panel, and so does a member of the bound session's Agent Teams roster, which the team line and the activity board show instead. Unfocused it is one summary line with the listed count and the first child's key label; focused, its heading counts what it lists and ends on the keys it answers, `↑↓ children · Enter opens · Tab regions · Esc input`, narrowed to `↑↓ children · Esc input` and then to `Esc input` on a terminal that cannot hold them, and each row gives the child's depth indent, its label or id, its mode (`one-shot` or `continuable`), `resident`, whether its agent is `running`, `completed` after its latest settled turn, or `idle`, its elapsed time — the open turn's, else the total its settled turns took — and its token usage, as far as this process's own view of that child and the composed projections carry them. Six rows are drawn at most, with `+<n> more · /subagents lists them all` under them; `/subagents` shows an external task as `external task · no local session` and shows its no-local-session detail instead of opening a Session, a candidate the listing could not interpret draws as `unreadable: <reason>` and shows its reason instead of opening a Session, and a failed listing keeps the rows the last good one produced with `listing failed: <reason>` beneath. The panel disappears with its last row. `Enter` or `Right` on a readable row, like `Enter` on a readable `/subagents` row, opens that child as a subagent view: the terminal draws the child session in place of the bound one — its transcript, live stream, conversation walk, inspector, reader, and its own subagent panel — while the session it was entered from stays open. A resident child is read live, and any other is resumed. The entry's detail rows print as notices under `subagent <label> · Ctrl+P or /parent returns to session <id>`, the header ends on `◆ subagent view ›` with one `›` per level entered and `· Ctrl+P returns`, a shaded line directly above the input reads `◆ subagent view · main › <label> · Ctrl+P back to <parent>` for as long as the view is open, whatever the transcript has scrolled to, and `Ctrl+P` or `/parent` goes back one level, redrawing the parent from its log as it stands then. A one-shot child opens read-only: its banner opens with `◆ subagent view · one-shot, read-only`, a prompt or `!` line typed there is refused with a notice and stays in the editor, `Esc` does not stop its turn, and commands such as `/parent` still run, while a continuable child takes prompts and a stop as any session does. `/new`, `/clear`, `/resume`, `/sessions`, and `/fork` refuse while any session in that chain runs a turn or a background job, since releasing a session ends its jobs, and otherwise release every view with the session they leave; quitting releases every view and saves the root session.
|
|
58
58
|
|
|
59
|
-
The team panel is one dim summary line, `team · <n>
|
|
59
|
+
The team panel is one dim summary line, `team · <n> teammates · working: <name>, <name> · tasks <completed>/<total> done · /team-play`, while the bound session has a teammate or a shared task that is not deleted, and it does not take the keyboard; a lead with neither leaves it unmounted. The count leaves out the lead, `working:` names the running teammates and is omitted while none runs, and the task counts leave out deleted tasks. A line wider than the terminal folds trailing names into `+<n>`, then reads `<n> working`, then ends in `…`. It is the only summary of the team: roster members are not rows or counts in the subagent panel, and a teammate's activity-board row reads `<name> · <role>`, where the lead's role is `orchestrator` and a teammate's is the description the lead gave it. A teammate's session view titles its header and the line above the input `teammate <name> · <role>`, the role cut to 28 columns, instead of `subagent view`. `/team-panel off` hides the line, `/team-panel on` forces it on, which draws `team · no teammates or shared tasks yet` when the roster has no teammate and no shared task, and `/team-panel` alone toggles that choice. `/team` lists every member and every shared task; `Enter` opens a running or inactive teammate as a continuable session view, and a lead, a provisioning member, a failed member, or a task opens a detail page. `/team-tools` prints the tools the Agent Teams plugin currently scopes onto this agent, each with the description the plugin supplies, and omits tools that are already visible without that plugin. A tool the plugin adds or removes shows up on the next `/team-tools` without a terminal change. `/team` detail pages also print string, number, and boolean fields the plugin adds to a member or a task. `/team-play` lists the exchanges those scoped tool calls, received team messages, and `team/` events record. Without the service each command notices `Agent Teams are not enabled in this composition` and the panel stays unmounted; a session that is not on a team notices `this session is not on a team`.
|
|
60
60
|
|
|
61
61
|
`/btw` opens a temporary side agent as a view over the session on screen, so the user can ask questions while that session's agent keeps working. The side agent is a new Agent seeded with every event the session has logged so far, an unfinished turn included: a tool call still waiting for its result gets the fork's error result, and reply text that is still streaming is not included. Input still queued for the session, prompts and next-step context alike, stays with that session's agent and is not carried into the side agent. It runs on the session's last logged model, else its current selection, and it can only read: its session runs in the `read-only` sandbox mode with the `never` approval policy, so a write fails and cannot be approved, and it sees only the tools named in `btwTools`, plus the command tools in `btwSandboxedTools` when the command executor confines commands. Every other tool is hidden from it and refused if called. It runs its own turns: the question after `/btw` is its first prompt, and every line typed while it is on screen goes to it, `/btw <question>` included. The view is drawn like a subagent view: the header ends on `◆ btw side agent · Ctrl+P ends it and returns`, the shaded line above the input reads `◆ btw side agent · main › btw · Ctrl+P back to main`, and the transcript starts empty instead of repeating the inherited conversation. `Ctrl+P` or `/parent` ends the side agent, cancelling a turn it is running, and redraws the session it was opened from under `btw ended · back in session <id>`. The working session is only read: nothing is appended to its log, its inbox is untouched, and neither its subagent panel, `/subagents`, nor its model-facing subagent listing shows the side agent, which also cannot message it. An approval or question that a session held behind any view raises is shown on screen after `session <id>, behind this view, asks:` instead of being refused.
|
|
62
62
|
|
|
@@ -198,7 +198,7 @@ Typing `/` at the start of the editor completes the terminal's own commands and
|
|
|
198
198
|
| `/deliverables` | The files the agent presented, grouped by turn |
|
|
199
199
|
| `/changes [turn]` | Browse the files the latest turn changed, or turn `turn`, with their line counts; `Enter` opens one file's turn-start to turn-end comparison |
|
|
200
200
|
| `/subagents` | Browse local subagent sessions and external task records under this session; `Enter` opens a readable session as a subagent view and shows details for an external or unreadable row |
|
|
201
|
-
| `/team-play` |
|
|
201
|
+
| `/team-play` | Open the team room on its own screen: each member with its role and what it is doing now, the shared tasks with owner and blockers, and the messages between members. `↑` `↓` select a member, `Enter` opens that teammate's session as `/team` does, `f` narrows the messages to the selected member, `PgUp` `PgDn` scroll them, and `Esc` or `q` closes the room. The subagent view stays `/subagents` |
|
|
202
202
|
| `/team` | Browse the team roster and shared tasks; `Enter` opens a running or inactive teammate session, and a lead, a provisioning or failed member, or a task opens its details |
|
|
203
203
|
| `/team-tools` | List the tools the Agent Teams plugin currently gives this agent, with each tool's description |
|
|
204
204
|
| `/team-panel` | Show or hide the team summary (`/team-panel`, `/team-panel on`, `/team-panel off`) |
|
|
@@ -212,7 +212,9 @@ Typing `/` at the start of the editor completes the terminal's own commands and
|
|
|
212
212
|
| `/btw <question>` | Open a temporary side agent with this session's context and ask it the question; it can use read-only tools, the session keeps working and never sees it, and `Ctrl+P` ends it. Inside the side agent, `/btw <question>` asks it another question |
|
|
213
213
|
| `/quit`, `/exit` | Save the session and exit |
|
|
214
214
|
|
|
215
|
-
An empty session whose profile mounts Agent Teams draws a start card. It reads `Agent Teams is on
|
|
215
|
+
An empty session whose profile mounts Agent Teams draws a static start card. It reads `Agent Teams is on`, says that the lead plans the work and delegates independent subtasks to teammates that each have one role, lists `/team-play` and `/team` with what each shows, and names `/plugins disable @deepseek-ai/dsh-experimental-agent-team-profile`. The card never animates. The header reads `Agent Teams on`.
|
|
216
|
+
|
|
217
|
+
`/team-play` opens the team room on the alternate screen. The first line is `team play · <n> teammates · <n> working · tasks <done>/<total> done`, and the second is the key legend, or the reason `Enter` opened nothing. The Members section lists the lead first and then each teammate with a status glyph, its name, its role, and what it is doing now. A running member spins on the spinner tick unless reduced motion is on, and an inactive, provisioning, or failed member draws `○`, `◌`, or `✗`. The role is `orchestrator` for the lead and otherwise the description the lead gave the teammate, or `teammate` when it has none. The current work is the subject of the in-progress task the member owns, else the last sentence it narrated, else its status. The Tasks section lists each task that is not deleted as `#<id> <glyph> <subject>`, its owner or `unowned`, and `blocked by #<id>` while blockers remain. The Messages section lists the exchanges the bound session logged as `<from> → <to> <kind>: <text>`, oldest first and the newest at the bottom: each spawn once with its assignment, each task status or owner change, each message the session sent or received, and every message of an older team log that recorded team mail, with sender and target resolved through the roster. Members and tasks fold past eight rows into `+<n> more`, the member list keeps the selected member in view, and the messages take the remaining rows. A team without teammates shows the lead and `No teammates yet — ask for work that splits into independent parts and the lead will delegate it.` The room repaints when a `team/` event, a child event, or a narration arrives, and steps the spinner only while a member runs. `/subagents` still opens one transcript.
|
|
216
218
|
|
|
217
219
|
Every other `/name` line goes to the shared command registry, so `/compact`, `/goal`, and plugin commands work as they do in the browser. `/compact` runs between turns: with a turn running it prints `/compact runs between turns: let this turn finish, or stop it (Esc twice)`. While it runs, the working spinner reads `compacting context · Esc cancels`, `Esc` cancels it with the notice `/compact cancelled`, a prompt submitted meanwhile waits in the follow-ups list under `queued: the prompt starts once compaction finishes`, and a session switch waits for it; the compaction block it lands is its result, so its own success text is not printed. An automatic compaction inside a running turn labels that turn's spinner `compacting` until the next model call starts.
|
|
218
220
|
|
|
@@ -291,7 +293,7 @@ The runner awaits the complete application (`ctx.get('loader')?.await()`) and bu
|
|
|
291
293
|
|
|
292
294
|
### Rendering model
|
|
293
295
|
|
|
294
|
-
Durable facts come from the session log: `system/message` (a nonempty prompt draws in full; an empty rendering is omitted), `user/message` (own submissions are drawn once and their echo skipped by message id; injected context — instructions, catalogs, snapshots, notices, relays, recalls, and undeclared forms — draws in full as a dim `⬡` row, a snapshot as one named contribution per part; compaction checkpoints and tool or model sources are omitted), `compaction/start`, `compaction/summary`, the checkpoint replacement, and `compaction/end` (a mirror of the surface kept from each event's `surfaceOp` names the replaced and remaining nodes, and the closing marker draws the compaction block or a failed `/compact` notice; a turn-owned `compaction/start` relabels the running spinner), `assistant/message` (which replaces the streamed block with the committed text and folds usage into the footer), `tool/call` and `tool/result` (drawn through the tool's `presentCall` and `presentResult` views when it declares them, with a raw-argument and raw-result fallback), `turn/end` notices, `workspace/changes` (one notice with the turn's file and line counts while the Host still holds the summary), `session/title` (header), `permission/preset` (footer), and `todo/write` under the enclosing `turn/start` (the turns one todo item's page reports; the list carries no per-item identity, so a reworded item counts as a new one; the same write refreshes the activity board from the `todos` projection). A descendant `
|
|
296
|
+
Durable facts come from the session log: `system/message` (a nonempty prompt draws in full; an empty rendering is omitted), `user/message` (own submissions are drawn once and their echo skipped by message id; injected context — instructions, catalogs, snapshots, notices, relays, recalls, and undeclared forms — draws in full as a dim `⬡` row, a snapshot as one named contribution per part; compaction checkpoints and tool or model sources are omitted), `compaction/start`, `compaction/summary`, the checkpoint replacement, and `compaction/end` (a mirror of the surface kept from each event's `surfaceOp` names the replaced and remaining nodes, and the closing marker draws the compaction block or a failed `/compact` notice; a turn-owned `compaction/start` relabels the running spinner), `assistant/message` (which replaces the streamed block with the committed text and folds usage into the footer), `tool/call` and `tool/result` (drawn through the tool's `presentCall` and `presentResult` views when it declares them, with a raw-argument and raw-result fallback), `turn/end` notices, `workspace/changes` (one notice with the turn's file and line counts while the Host still holds the summary), `session/title` (header), `permission/preset` (footer), and `todo/write` under the enclosing `turn/start` (the turns one todo item's page reports; the list carries no per-item identity, so a reworded item counts as a new one; the same write refreshes the activity board from the `todos` projection). A descendant `turn/start`, `assistant/message`, or `turn/end`, and a `subagent/start` or `subagent/end` for the bound parent, update that child's own board row — the last sentence of the message's text blocks, never reasoning, tool calls, or tool results, and the stop word once the turn settles; a child that has not spoken draws its label alone; `turn/end` on the bound session and bind clear the board. Live incrementality comes from `agent/assistant-stream` text, reasoning, tool-call, and usage deltas: a card is mounted when the model names the tool, and the working spinner follows that stream plus durable `tool/call` / `tool/result` so it says `thinking`, `writing`, or `calling <tool>` with live `↑` send and `↓` receive for that call. Session facts outside the log come from the same services the browser reads: `sessionTitle`, `permissionPresets`, `sessionQuery` for the picker identities, the live or cached `title` projection for picker titles, `/deliverables`, and subagent details, `sessionProjections` for the footer, `/status`, `/context`, `/todos`, and `/outline`, `tokenMeter` for `/context`, `fileReferences` and `sessionReferenceResolver` for `@` completion, `attachments`, `skills`, `authorization`, `settings`, `subagents`, and the Loader's entries for `/plugins`. Modal prompts are process-local presentation and are never logged.
|
|
295
297
|
|
|
296
298
|
### Patch surface over base
|
|
297
299
|
|
|
@@ -343,12 +345,12 @@ The patch rides over `dsh-base`: it sets the coding persona prefix and cwd suffi
|
|
|
343
345
|
| [`src/status.ts`](src/status.ts) | Projection-seam facts and the sections the `/status` report and the segment details share; the retry notice |
|
|
344
346
|
| [`src/footer.ts`](src/footer.ts) | The status bar: the ordered segments, each segment's detail rows, the unfocused line built from both ends, and the focused sliding window |
|
|
345
347
|
| [`src/subagent-panel.ts`](src/subagent-panel.ts) | The live subagent panel: one descendant listing plus sampled live facts become its rows, the unfocused summary line, and the focused listing |
|
|
346
|
-
| [`src/team-panel.ts`](src/team-panel.ts) | The team summary: one line of
|
|
348
|
+
| [`src/team-panel.ts`](src/team-panel.ts) | The team summary: one line of teammate, working, and task counts fitted to the terminal width, drawn while a teammate or a shared task exists |
|
|
347
349
|
| [`src/team.ts`](src/team.ts) | `/team`, `/team-tools`, and `/team-panel`: roster rows, the nine tool lines, and the read of the optional service |
|
|
348
350
|
| [`src/queue-panel.ts`](src/queue-panel.ts) | The follow-ups list: pending-row glyphs, hanging wrap, and the enter-steer legend |
|
|
349
351
|
| [`src/background.ts`](src/background.ts) | `Ctrl+B`: the `tools/execute` wrapper that tracks root calls, moves them to `tool` jobs, recognizes a shell call's own process job, and holds the jobs of a stopped turn |
|
|
350
352
|
| [`src/jobs-panel.ts`](src/jobs-panel.ts) | The background-jobs line above the editor, the `/jobs` rows and detail page, and the settlement line |
|
|
351
|
-
| [`src/activity-board.ts`](src/activity-board.ts) | The activity board: todo glyphs, the completed scratch-out, the row
|
|
353
|
+
| [`src/activity-board.ts`](src/activity-board.ts) | The activity board: todo glyphs, the completed scratch-out, the row caps, the narration a subagent row shows, and the one-row-per-subagent draw |
|
|
352
354
|
| [`src/catalog.ts`](src/catalog.ts) | Rows for `/settings`, `/plugins`, `/subagents`, `/deliverables`, `/changes`, and `/outline`, and the `/plugins` management verbs |
|
|
353
355
|
| [`src/view-banner.ts`](src/view-banner.ts) | The line above the input that names an open subagent view or `/btw` side agent and the key back |
|
|
354
356
|
| [`src/todos.ts`](src/todos.ts) | The todo list: the status glyphs, the picker rows with completed content scratched out, and one item's detail rows |
|
|
@@ -358,7 +360,7 @@ The patch rides over `dsh-base`: it sets the coding persona prefix and cwd suffi
|
|
|
358
360
|
| [`tests/background.spec.ts`](tests/background.spec.ts) | `Ctrl+B` over the real tool runtime, job registry, and job tools: the spinner hint, the moved result and card, the jobs line, `/jobs` output and `Ctrl+K`, completion notices, refusal, failure, and the turn stop |
|
|
359
361
|
| [`tests/background-tracking.spec.ts`](tests/background-tracking.spec.ts) | Which calls the wrapper tracks, which jobs count as a call's own, and the moved-result text |
|
|
360
362
|
| [`tests/jobs-panel.spec.ts`](tests/jobs-panel.spec.ts) | The jobs line, `/jobs` rows, detail page, and settlement line as text |
|
|
361
|
-
| [`tests/activity-board.spec.ts`](tests/activity-board.spec.ts) | Activity-board glyphs, the completed scratch-out, the row
|
|
363
|
+
| [`tests/activity-board.spec.ts`](tests/activity-board.spec.ts) | Activity-board glyphs, the completed scratch-out, the row caps, narration trimming, and the subagent rows |
|
|
362
364
|
| [`tests/keys.spec.ts`](tests/keys.spec.ts) | What each region claims for a key, the legend steps, and the text one press types |
|
|
363
365
|
| [`tests/editor.spec.ts`](tests/editor.spec.ts) | The terminal caret, `Shift+Left` / `Shift+Right` word navigation, and `!` / `!!` draft colour against pi-tui's editor behavior |
|
|
364
366
|
| [`tests/frame.spec.ts`](tests/frame.spec.ts) | The rules, the chip, the body rows, and the legend a width holds |
|
|
@@ -392,9 +394,10 @@ The patch rides over `dsh-base`: it sets the coding persona prefix and cwd suffi
|
|
|
392
394
|
| [`tests/startup.spec.ts`](tests/startup.spec.ts) | Command-line parsing over a real Loader tree |
|
|
393
395
|
| [`tests/shortcuts.spec.ts`](tests/shortcuts.spec.ts) | `?` on an empty input and inside a draft, `Ctrl+T` from any region, `Ctrl+P` at the root session, and the `Ctrl+L` redraw |
|
|
394
396
|
| [`tests/subagents.spec.ts`](tests/subagents.spec.ts) | The live subagent panel's rows, walk, and listing refresh, and the subagent view it and `/subagents` open, left through `/parent` and `Ctrl+P` and released on a session switch and on quit |
|
|
395
|
-
| [`tests/team-panel.spec.ts`](tests/team-panel.spec.ts) | The team summary's counts,
|
|
397
|
+
| [`tests/team-panel.spec.ts`](tests/team-panel.spec.ts) | The team summary's counts, working names, width fitting, hiding, and deleted tasks |
|
|
396
398
|
| [`tests/team.spec.ts`](tests/team.spec.ts) | Tool visibility lines, roster picker rows, and the optional service read |
|
|
397
399
|
| [`tests/team-app.spec.ts`](tests/team-app.spec.ts) | `/team`, `/team-tools`, and `/team-panel` in the terminal: notices, the summary, and opening a teammate session |
|
|
400
|
+
| [`tests/team-main-page.spec.ts`](tests/team-main-page.spec.ts) | One home per teammate: roster members left out of the subagent panel, `<name> · <role>` board rows, the working list on the team line, and the teammate view title |
|
|
398
401
|
| [`../../../apps/cli/tests/profiles/tui/tests/keyless-smoke.e2e.ts`](../../../apps/cli/tests/profiles/tui/tests/keyless-smoke.e2e.ts) | The shipped profile through the real launcher with a keyless mock model |
|
|
399
402
|
| [`../../../apps/cli/tests/profiles/tui/tests/quit-while-busy.e2e.ts`](../../../apps/cli/tests/profiles/tui/tests/quit-while-busy.e2e.ts) | The shipped profile quitting while a command, a background job, a subagent, or a process that ignores `SIGTERM` is running, and on `SIGHUP` and `SIGINT`: the stderr lines and their order, the exit codes, and that no process survives |
|
|
400
403
|
|
|
@@ -488,6 +491,7 @@ The side agent uses the working session's last logged provider and model, but it
|
|
|
488
491
|
These limits describe the terminal surface as shipped; they are not a general CLI comparison or a task backlog.
|
|
489
492
|
|
|
490
493
|
- **One session at a time** — `/resume`, `/sessions`, `/new`, `/clear`, and `/fork` move the terminal between sessions, but only the bound Agent streams, and a subagent view draws one child in place of the session it was entered from; the browser shows several sessions side by side.
|
|
494
|
+
- **The team room shows the bound session's own messages** — a message between two teammates is logged only in their sessions, so the lead's `/team-play` lists lead↔teammate messages and not teammate↔teammate ones; opening a teammate from the room shows its side.
|
|
491
495
|
- **Approvals are one-shot** — the prompt offers allow once or reject, matching the approval seam's vocabulary; there is no remembered grant.
|
|
492
496
|
- **Browser-only pages stay in the browser** — workspace and directory pickers, open-in-app links, the trajectory ledger, and per-message like/dislike have no terminal counterpart; `/settings`, `/plugins`, `/subagents`, `/outline`, and the shared `/feedback` cover their facts as text, and a subagent transcript is read in a subagent view.
|
|
493
497
|
- **Deliverables are named, not opened** — `/deliverables` lists the presented paths and `/changes` shows line comparisons; the browser previews the files.
|
|
@@ -497,6 +501,7 @@ These limits describe the terminal surface as shipped; they are not a general CL
|
|
|
497
501
|
- **The conversation is not drawn while the reader is up** — its screen is held off the terminal, so a turn that runs, a tool result that lands, and a notice that is printed are all drawn in one frame when the reader closes. The reader itself shows them as they arrive, because it re-reads the conversation on every drawing.
|
|
498
502
|
- **The reader shows source text** — an assistant reply reads as the Markdown the model wrote, not the rendering the transcript draws, so tables and headings read as their source; only a list item's leading `-`, `*`, or `+` is drawn as `•`.
|
|
499
503
|
- **A cold large turn needs a measurement pass** — before it can draw that turn's viewport, the reader counts every section to find the full scroll range; later paints reuse cached row counts and draw only visible sections, while changed content or a width it has not measured requires fresh measurements.
|
|
504
|
+
- **A silent subagent draws its label alone** — a board row shows what the child last said in an assistant message, so a child that calls tools without saying anything shows its label and spinner only, and the model's reasoning is never shown in its place. Each child's delegation context asks for one sentence before every tool call, which a model can still skip.
|
|
500
505
|
- **The panel lists local residency, not the tree** — a child joins it while its session record is resident in this process, so an external task with no local session never appears; `/subagents` lists that durable task record as non-openable, alongside every local descendant.
|
|
501
506
|
- **A continuable child view prompts its Agent directly** — a prompt typed in a continuable subagent view goes to that child's Agent as in any session, and a child that is not resident is resumed by the view; the Web client sends the prompt through the subagent runtime's prompt route instead.
|
|
502
507
|
- **Residency is not work** — the listing's `activity: 'running'` says the child's record is resident, which is what the row's `resident` reports; whether the child is working is the separate `running` / `idle` word beside it, read from that child's Agent in this process.
|
|
@@ -42,7 +42,7 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
42
42
|
|
|
43
43
|
每一帧都从终端左右两边各内缩一列绘制,因此对话记录与停靠的界面组件都不会有任何一行贴到两侧边缘。页眉在标题生成或设置后以标题命名会话,并在旁边显示 id。对话记录在终端自身的回滚区中增长:你的提示以 `❯` 开头,启用颜色时铺在一条通栏的着色背景带上(附件列在其下),而在已有模型步骤的轮次中被引导或注入的提示以暗色文字铺在更深的背景带上,退到它所加入的轮次之后,assistant 的推理以暗色斜体显示在 `✻ Thinking` 标题之下、Markdown 回复上方,流式期间标题旁的绽放符号随之旋转,每次工具调用是一张卡片,含状态符号(运行中为按工具族混合花朵、绽放与星形的黄色旋转指示、完成为绿色 `◆`、失败为红色 `◆`)、粗体青色工具名、以蓝绿色显示的呈现器标题(去掉呈现器重复写出的工具名,因此 `Read src/app.ts` 画成 `read src/app.ts`;shell 卡片取该次调用自身的摘要,绝不取命令,命令只由卡片的 `$` 行绘制一次)、运行中的一行加载标记,以及折叠到 `toolPreviewLines` 行的正文。顶层 workflow 调用还会在该卡片旁另绘一次运行:运行名、成员数、状态,以及一条十格的成员进度条与已结束数,然后是每个阶段和已启动的成员。实时运行进行中时,其 `◇` 以菱形动画脉动,每个运行中成员的 `○` 以子 agent 族的花朵旋转,相位比前一个成员领先一格;从重放日志绘制的运行只在其后台作业仍存活时旋转,减少动效时绘制静态符号。运行中的层级,以及含失败、取消或中断成员的层级会展开;干净完成的层级保持折叠。在运行或阶段上按 Space 或 Enter 折叠该层,在仍在运行的成员上按 Enter 只会在该子会话是本会话的直接子会话且仍在本进程运行时打开它。卡片在模型开始调用时出现,并逐行向外流出,每行从左到右,无论卡片装着什么,速度都一致:一整行宽的内容需 `toolRevealFrames` 帧,较短的行按比例更短,刚画出的列会从终端背景色亮起到各自的颜色。工具回答后,结果行也以同样方式流出,排在卡片尚未画完的内容之后;调用与结果都不会等待动画。`edit` 或 `write` diff 卡片把每一新增行整行铺满绿色背景、每一删除行整行铺满红色背景,删除的旧行在上、新增的新行在下,并把 `+` 与 `-` 画成各自更亮的颜色,使符号从填充色中读得出来;折行续行只延续填充色,不再画第二个符号;工具应用变更后,已应用的 hunk 取代调用时携带的 diff,并在每行前标出文件行号,新增行与未变行用新文件的行号,删除行用旧文件的行号。`subagent` 与 `subagent_*` 卡片折叠时只画一行,行首是同样的状态符号,运行中旋转,交给后台的子 agent 则为暗色 `◆`:运行中显示工具名、任务描述,以及调用指定的模型与 `background`;结束后描述变暗,右端标出 `[done]`,交给后台的子 agent 标 `[started]`,失败标 `[failed]`。在被标记的行上按 `Space`,或按 `Ctrl+O`,即可展开完整卡片。非空的系统提示词与每一条注入的上下文——instructions、catalogs、snapshots、notices、relays 与 recalls——绘制为暗色 `⬡` 标题,其下是面向模型文本的前 `contextPreviewLines` 行,快照的每一份贡献具名写在其自身各行上方;空的系统提示词则省略。一次压缩(compaction)——无论来自 `/compact` 还是自动触发——绘制为一个上下文块,其强调色 `⬡` 标题写明来源,以及被替换内容与摘要各自的估算 token 数,如 `context compacted by /compact · ~6.4k → ~0.9k tokens` 或 `context compacted automatically in turn 12 · …`;标题之下,`compressed` 写明摘要替换的条目数与轮次、其中的每条提示(最多五条,每条一行),以及回复、按工具分列的工具结果、上下文块与更早摘要的计数,`preserved` 写明系统提示词以及之后每一轮仍逐字保留的内容;这两部分始终绘出,其下的摘要则像其他上下文块一样折叠到 `contextPreviewLines` 行。检查点消息本身不再重复绘制。日志以错误结束的 `/compact` 尝试会在会话重绘时打印 `/compact failed · <error>`,因为实时运行的命令会自己报告失败;失败的自动尝试不改变任何内容,也不绘制任何内容,与浏览器一致。承载的行数多于其绘制行数的工具卡片与上下文块,结尾都是同一条标记:该块被对话记录的焦点持有时为 `… <n> more rows · Space expands`,否则为 `… <n> more rows · Ctrl+O expands`。回复中的围栏代码、`read` 卡片的文件行、`edit` 或 `write` diff 卡片的变更行——其中 `+` 新增项标为绿色、`-` 删除项标为红色,符号后的源文本按文件扩展名对应的语言绘制——以及 `!` / `!!` 草稿、用户 shell 的 `$ command` 行(其 `$` 用强调色)与终端工具卡片中的 shell 命令,都使用语法高亮,配色主题由终端自身的背景在明暗之间选定;某种语言的语法会在第一个用到它的代码块出现时才加载,因此该块先以纯文本绘制、随后被重绘为彩色;这里没有对应语法的语言、既不支持 24 位也不支持 256 色的终端,以及 `codeHighlight: false`,都会把每个代码块画成纯文本。标题与列表标记使用橙色,链接与行内代码使用品红色,引用保持暗色。每种色相都是 Tokyo Night(Night)配色,当 `COLORTERM` 声明 `truecolor` 或 `24bit` 时按原色精确绘制,否则取 256 色索引中最接近的一色;背景带保留其 256 色灰阶与 diff 底色。流式推理、回复文字与工具参数到达时先入队,再按帧(默认约每秒 60 帧)分批绘制,因此一次网络突发会分摊到 `streamPaceFrames` 帧里,而不是一次落下,队列也从不拖慢模型调用。流式回复文字会淡入,而且每个词各走各的时钟:一个词以接近终端背景色的亮度出现,并经 `streamFadeSteps` 次、每次 `streamFadeStepMs` 提亮到它最终稳定的颜色,因此流得更快只会留下更长的一串正在提亮的词,而不会更暗。流式推理在同一时长内浮出:以抬高的颜色出现,再退回到稳定时的暗色斜体。工具卡片的每一列则在这段时长内从终端背景色亮起到它稳定时的调色板颜色;从持久化历史重绘的卡片不带流出或淡入,已经稳定下来的文字也不会再被调暗。
|
|
44
44
|
|
|
45
|
-
对话记录下方依次是 agent 工作时的旋转指示——`thinking`、`writing`、`calling <tool>`、重试或 `compacting`,各自旁边是它自己的盲文动画:环绕的点、逐行填满的线、绕行的单点、滑动的横条,或沉降又回满的方格——标签单词上带着一道扫过的高亮,并带着当前这次模型调用的实时 `↑` 发送与 `↓` 接收 token,以紧凑的 `k` / `M` / `B` 计数,随数据流入增长,并在提供方的 usage 块到达后落定——任何打开的提示、有消息等待时的带框 follow-ups 列表、本轮 todo
|
|
45
|
+
对话记录下方依次是 agent 工作时的旋转指示——`thinking`、`writing`、`calling <tool>`、重试或 `compacting`,各自旁边是它自己的盲文动画:环绕的点、逐行填满的线、绕行的单点、滑动的横条,或沉降又回满的方格——标签单词上带着一道扫过的高亮,并带着当前这次模型调用的实时 `↑` 发送与 `↓` 接收 token,以紧凑的 `k` / `M` / `B` 计数,随数据流入增长,并在提供方的 usage 块到达后落定——任何打开的提示、有消息等待时的带框 follow-ups 列表、本轮 todo 与每个子 agent 一行的 activity board(有行时才绘制;已完成内容划掉,状态符号以绿色、黄色或蓝色显示,进行中的那一项为旋转指示,todo 最多四行其后 `+<n> more`,每个子 agent 行是其旋转指示或 `✓` / `✗`、任务标签(Agent Teams 的 teammate 为 `<name> · <role>`),以及它自述正在做什么的最后一句话,截成终端的一行,运行中的子 agent 在前,最多三行其后 `+<n> more subagents`,不是焦点区域,在 `turn/end` 与 bind 时消失)、编辑器、子 agent 面板,以及页脚:未聚焦时是一行由两端向内构建的状态栏。编辑器的光标是终端自身的闪烁竖条:应用在启动时请求这一形状,退出时把你的默认形状还回去,而状态栏或面板持有键盘期间完全不绘制光标。模型为紫色,入口按键为品红色;进行中的轮次、上下文与 todo 信息分别使用黄色、品红色与绿色。模型锚定在左端且永不丢弃——超过 20 列时退回到裸模型名,只有仍然过宽的标签才会被省略号截断——离开编辑器的那两个按键则锚定在右端,写作 `Shift+↑ read · Shift+↓ status`,有 follow-ups 等待时则写作 `Shift+↑ select · Shift+↓ status`,窄到一定程度收缩为 `Shift+↑↓ nav`,不足 40 列时整体丢弃。关键事实填满剩下的中间部分,按状态栏顺序排列:推理强度(选择把推理交给模型时标为 `effort default`)、进行中轮次的已用时间、上下文窗口百分比、todo 计数,以及 workspace 路径(过长时以 `~` 与 `…/` 缩短)。中间部分容纳不下的每个分段都折进末尾的 `+N`,未聚焦行从不绘制的那些分段也一并折入——权限预设、token 用量(会话合计加上进行中的这次调用)、来自投影接缝的目标与计划模式标记,以及待发送附件的数量。模型请求重试以通知形式出现,与浏览器标记承载的事实相同。
|
|
46
46
|
|
|
47
47
|
键盘在对话记录中移动时,编辑器正上方停靠着一个带边框的检视面板,边框即模式:它恰好在对话记录持有键盘时绘制。其顶边线带有一个反白的 ` ● READ ` 徽标与当前聚焦小节的标题——该小节在可导航块中的位置、所属轮次,以及这是哪一种小节——例如 `╭ ● READ ─ 3/12 · turn 2 · bash git status · result ─╮`。其下在块含多个部分时,把这些部分绘制成形如 `← 1 call · [2 result] →` 的带编号、会折行的选择行,被持有的标签除强调色外还加上方括号,因此完全无颜色时选择仍然可读;再往下是该小节自身的源文本行,每行左右两侧都由 `│ ` 边框闭合并按窄四列换行,对每一种小节——含系统提示词与注入的上下文——都折叠到 `focusPreviewLines` 行,其下写出 `… <n> more rows · Ctrl+G reads it`。底边线列出对话记录所应答的按键 `↑↓ sections · ←→ parts · Space folds · Ctrl+G reader · Esc input`,随着终端列数减少收缩为 `↑↓ ←→ · Space folds · Esc input`,再收缩为 `Esc input`。
|
|
48
48
|
|
|
@@ -52,11 +52,11 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
52
52
|
|
|
53
53
|
临时按键反馈以一行暗色带框文字浮在视口右上角:`press Esc again to stop turn <n>`、`press Ctrl+C again to quit`——有命令、后台作业或子 agent 在运行时为 `press Ctrl+C again to quit · stops 1 command, 2 background jobs`——与 `nothing in the transcript to read yet`。它以全亮度保持 `toastMs`、随后淡出,不占用对话记录自身的任何一行,也不接管键盘;渲染器已无法重绘视口顶部时,它改为打印进对话记录,从而被保留下来。值得留存的事实则是对话记录中的通知:`stopping the turn…`、`wait for the session switch to finish`、`above the repaint window · opened in the reader` 以及每一条命令结果。
|
|
54
54
|
|
|
55
|
-
动效不止于流式文本:每种抬亮与浮出都乘着同一个淡入时钟,每种工作动画则乘着同一个旋转时钟。键盘落到对话记录、子 agent 面板或状态栏上时,会把该表层的边框、其徽标与它持有的标记抬亮十二拍(每拍一个 `streamFadeStepMs`);对话记录走查中的一步把新聚焦的标记条抬亮六拍;状态栏上的一步把所选标签抬亮八拍。活动板上新出现或状态已变的 todo
|
|
55
|
+
动效不止于流式文本:每种抬亮与浮出都乘着同一个淡入时钟,每种工作动画则乘着同一个旋转时钟。键盘落到对话记录、子 agent 面板或状态栏上时,会把该表层的边框、其徽标与它持有的标记抬亮十二拍(每拍一个 `streamFadeStepMs`);对话记录走查中的一步把新聚焦的标记条抬亮六拍;状态栏上的一步把所选标签抬亮八拍。活动板上新出现或状态已变的 todo 行,以及变化了的子 agent 行,也在淡入时钟上浮出;重放与 `reducedMotion` 则画出已稳定的活动板。每种工作动画都有八帧,由时钟决定当前画哪一帧,并在周期为 `spinnerMs`(默认 100 ms)的旋转时钟上步进,因此一切旋转中的指示都在同一时刻、以同一速度前进,标签变化也不打乱节拍,而该时钟只在其中之一被绘制时才启动。只有工作时的旋转指示画盲文,其动画随状态而变,因此它从不与卡片的符号重复。运行中的工具卡片与折叠的子 agent 行画该工具族的动画,进行中的 todo 行画规划族的动画。这些动画都把花朵、绽放与星形混在同一组帧里,族与族之间不共用符号,同一族的每一帧也各不相同,因此同一族里相位不同的两个指示在任何时刻都不会画出相同的符号。某个指示开始旋转时若同族已有其他指示在转,它会取一个相位,使它在任何时刻都不与它们画出相同的符号,同族同时旋转的不超过八个时都能做到;超过八个后,它取同族中被持有指示最少的那个相位。标题行已滚动到渲染器可重绘区域之上的卡片自此画出静态的 `◆`,而 `reducedMotion` 把它们全部画成静止的——卡片的 `◆`、todo 的 `▸`,以及不带符号、只剩标签的工作旋转指示——且不启动旋转时钟。阅读器在自己占据的屏幕上一次性完整出现,而它新显示的内容会在淡入时钟上浮出:打开它与显示另一个轮次时浮出整个轮次,在列表中步进到同一轮次的另一个小节时浮出该小节,历时 `streamFadeSteps` 拍;滚动、实时增长与重新换行都不浮出任何内容。任何抬亮都不改变任何东西绘制的行数,而 `reducedMotion`——与 `NO_COLOR`、被禁用的调色板和 `TERM=dumb` 一样——会关闭每一种抬亮与浮出,并且不为它们安排任何重绘。
|
|
56
56
|
|
|
57
|
-
子 agent 面板在绑定会话之下有常驻的本地子 agent
|
|
57
|
+
子 agent 面板在绑定会话之下有常驻的本地子 agent 会话、或列表中带有无法读取的候选者时绘制;外部任务没有本地会话,因此不在面板中出现;绑定会话的 Agent Teams 名册成员也不在面板中出现,改由团队行和 activity board 显示。未聚焦时它是一行摘要,含列出的数量与第一个子会话的关键标签;聚焦时其标题统计所列出的条目,并以它所应答的按键 `↑↓ children · Enter opens · Tab regions · Esc input` 结尾,在容纳不下时收缩为 `↑↓ children · Esc input`,再收缩为 `Esc input`;每一行给出该子会话的层级缩进、其标签或 id、其模式(`one-shot` 或 `continuable`)、`resident`、其 agent 处于 `running`、最新已结束轮次后为 `completed`,还是 `idle`、其已用时间——进行中轮次的用时,否则是已结束轮次的合计——以及其 token 用量,以本进程对该子会话的可见程度与已组合的投影所能提供的为限。最多绘制六行,其下是 `+<n> more · /subagents lists them all`;`/subagents` 把外部任务显示为 `external task · no local session`,并显示其没有本地会话的详情而不打开会话,列表无法解读的候选者绘制为 `unreadable: <reason>`,并显示其原因而不打开会话,读取失败的列表则保留上一次成功读取产生的各行,并在其下写出 `listing failed: <reason>`。面板随其最后一行一同消失。在可读的行上按 `Enter` 或 `Right`,与在可读的 `/subagents` 行上按 `Enter` 一样,会把该子会话作为子 agent 视图打开:终端在已绑定会话的位置绘制子会话——其对话记录、实时流、对话记录走查、检查器、阅读器以及它自己的子 agent 面板——而进入它之前的会话保持打开。常驻的子会话被实时读取,其他子会话则被恢复。条目的详情行作为通知打印在 `subagent <label> · Ctrl+P or /parent returns to session <id>` 之下,页眉以 `◆ subagent view ›`(每进入一层一个 `›`)与 `· Ctrl+P returns` 结尾,只要视图打开,输入框正上方就有一条着色行写着 `◆ subagent view · main › <label> · Ctrl+P back to <parent>`,无论对话记录滚动到哪里,`Ctrl+P` 或 `/parent` 返回上一层,并按父会话此刻的日志重绘它。`one-shot` 子会话以只读方式打开:其横幅以 `◆ subagent view · one-shot, read-only` 开头,在其中输入的提示词或 `!` 行会被通知拒绝并留在编辑器中,`Esc` 不会停止它的轮次,而 `/parent` 等命令仍可运行;`continuable` 子会话则像任何会话一样接受提示词与停止。只要这条链中任一会话正在运行轮次或后台任务,`/new`、`/clear`、`/resume`、`/sessions` 与 `/fork` 都会拒绝(释放会话会结束它的后台任务),否则它们会随所离开的会话释放每一个视图;退出会释放每一个视图并保存根会话。
|
|
58
58
|
|
|
59
|
-
团队面板在绑定会话有 teammate,或有一条状态不是 `deleted` 的共享任务时,是一行不占键盘的暗色摘要 `team · <n>
|
|
59
|
+
团队面板在绑定会话有 teammate,或有一条状态不是 `deleted` 的共享任务时,是一行不占键盘的暗色摘要 `team · <n> teammates · working: <name>, <name> · tasks <completed>/<total> done · /team-play`;只有 lead、且没有这类任务时,面板不挂载。计数不含 lead,`working:` 列出正在运行的 teammate 名字,没有 teammate 运行时省略,任务计数不含已删除任务。该行宽于终端时,先把末尾的名字折成 `+<n>`,再改为 `<n> working`,最后以 `…` 截断。它是团队唯一的摘要:名册成员不作为子 agent 面板的行,也不计入其计数;teammate 在 activity board 上的行显示为 `<name> · <role>`,其中 lead 的角色是 `orchestrator`,teammate 的角色是 lead 给它的描述。teammate 的会话视图在页头和输入框上方那一行以 `teammate <name> · <role>` 为标题(角色截为 28 列),而不是 `subagent view`。`/team-panel off` 隐藏该行,`/team-panel on` 强制显示,名册里既没有 teammate 也没有共享任务时绘制 `team · no teammates or shared tasks yet`,单独的 `/team-panel` 在这两种选择之间切换。`/team` 列出每一名成员和每一条未删除的共享任务;在 `running` 或 `inactive` 的 teammate 上按 `Enter` 会把该会话作为可继续的会话视图打开,lead、`provisioning` 或 `failed` 的成员以及任务则打开详情页。`/team-tools` 打印 Agent Teams 插件当前限定在本 agent 上的工具,每条带上插件给出的描述,并略去没有该插件时就已经可见的工具。插件新增或移除的工具,下一次 `/team-tools` 就会反映出来,终端本身不必改动。`/team` 的详情页也会打印插件加在成员或任务上的字符串、数字和布尔字段。`/team-play` 列出这些限定工具的调用、收到的团队消息,以及 `team/` 事件所记录的往来。没有该服务时,每条命令提示 `Agent Teams are not enabled in this composition`,面板保持不挂载;会话不在团队中时提示 `this session is not on a team`。
|
|
60
60
|
|
|
61
61
|
`/btw` 在屏幕上的会话之上打开一个临时的旁路 agent 视图,让用户在该会话的 agent 继续工作时提问。旁路 agent 是一个新的 Agent,以该会话迄今记录的全部事件为种子,包括尚未结束的轮次:仍在等待结果的工具调用会得到分叉产生的错误结果,仍在流式输出的回复文本不包含在内。该会话仍在排队的输入,无论是提示还是下一步上下文,都留给该会话的 agent,不会带进旁路 agent。它使用该会话最后记录的模型(否则使用其当前选择),并且只能读取:它的会话运行在 `read-only` 沙箱模式与 `never` 审批策略下,因此写入会失败且无法获批;它只看得到 `btwTools` 中列出的工具,以及在命令执行器会约束命令时 `btwSandboxedTools` 中的命令工具。其他工具对它隐藏,被调用时也会被拒绝。它运行自己的轮次:`/btw` 之后的问题是它的第一条提示,它在屏幕上时输入的每一行都交给它,`/btw <question>` 也一样。该视图的绘制方式与子 agent 视图相同:页眉以 `◆ btw side agent · Ctrl+P ends it and returns` 结尾,输入框上方的着色行写着 `◆ btw side agent · main › btw · Ctrl+P back to main`,对话记录从空开始,而不是重复继承来的对话。`Ctrl+P` 或 `/parent` 结束旁路 agent(取消它正在运行的轮次),并在 `btw ended · back in session <id>` 之下重绘打开它之前的会话。工作中的会话只被读取:不向其日志追加任何内容,不触碰其收件箱,其子 agent 面板、`/subagents` 与面向模型的子 agent 列表都不显示旁路 agent,旁路 agent 也不能给它发消息。被任一视图挡在后面的会话发起的审批或提问,会在 `session <id>, behind this view, asks:` 之后显示在屏幕上,而不是被拒绝。
|
|
62
62
|
|
|
@@ -198,7 +198,7 @@ follow-ups 面板持有键盘时:
|
|
|
198
198
|
| `/deliverables` | agent 交付的文件,按轮次分组 |
|
|
199
199
|
| `/changes [turn]` | 浏览最近一轮(或第 `turn` 轮)改动的文件及其行数;`Enter` 打开某个文件从轮次开始到结束的对比 |
|
|
200
200
|
| `/subagents` | 浏览本会话之下的本地子 agent 会话和外部任务记录;`Enter` 把可读的会话作为子 agent 视图打开,对外部或无法读取的行则显示详情 |
|
|
201
|
-
| `/team-play` |
|
|
201
|
+
| `/team-play` | 在独立画面打开团队室:每名成员及其角色和此刻在做的事、带负责人与阻塞项的共享任务,以及成员之间的消息。`↑` `↓` 选择成员,`Enter` 像 `/team` 一样打开该 teammate 的会话,`f` 把消息收窄到所选成员,`PgUp` `PgDn` 滚动消息,`Esc` 或 `q` 关闭团队室。子 agent 视图仍是 `/subagents` |
|
|
202
202
|
| `/team` | 浏览团队名册与共享任务;`Enter` 打开 running 或 inactive 的 teammate 会话,lead、provisioning 或 failed 的成员以及任务则打开详情 |
|
|
203
203
|
| `/team-tools` | 列出 Agent Teams 插件当前提供给本 agent 的工具,并带上每个工具的描述 |
|
|
204
204
|
| `/team-panel` | 显示或隐藏团队摘要(`/team-panel`、`/team-panel on`、`/team-panel off`) |
|
|
@@ -212,7 +212,9 @@ follow-ups 面板持有键盘时:
|
|
|
212
212
|
| `/btw <question>` | 打开一个带有本会话上下文的临时旁路 agent 并向它提问;它可以使用只读工具,本会话继续工作且看不到它,`Ctrl+P` 结束它。在旁路 agent 中,`/btw <question>` 向它再提一个问题 |
|
|
213
213
|
| `/quit`、`/exit` | 保存会话并退出 |
|
|
214
214
|
|
|
215
|
-
挂载了 Agent Teams 的 profile
|
|
215
|
+
挂载了 Agent Teams 的 profile 在空会话里画出一张静态起始卡片。卡片写着 `Agent Teams is on`,说明 lead 规划工作并把相互独立的子任务委派给 teammate,每名 teammate 承担一个角色,列出 `/team-play` 与 `/team` 各自显示的内容,并给出 `/plugins disable @deepseek-ai/dsh-experimental-agent-team-profile`。卡片从不动画。标题行写着 `Agent Teams on`。
|
|
216
|
+
|
|
217
|
+
`/team-play` 在备用屏幕上打开团队室。第一行是 `team play · <n> teammates · <n> working · tasks <done>/<total> done`,第二行是按键图例,或 `Enter` 没有打开任何会话的原因。Members 区先列 lead,再列每名 teammate,每行有状态字形、名称、角色和此刻在做的事。running 的成员除非开启减弱动效,否则随旋转指示 tick 转动,inactive、provisioning 或 failed 的成员分别画 `○`、`◌` 或 `✗`。角色对 lead 是 `orchestrator`,对 teammate 是 lead 给它的描述,没有描述则为 `teammate`。当前工作是该成员负责的进行中任务的主题,否则是它最近叙述的最后一句,再否则是它的状态。Tasks 区把每条未删除的任务列为 `#<id> <glyph> <subject>`、负责人或 `unowned`,仍有阻塞项时再加 `blocked by #<id>`。Messages 区把绑定会话记录的往来列为 `<from> → <to> <kind>: <text>`,旧的在前,最新的在底部:每次创建只列一次并附带其分派内容,每次任务状态或负责人变化,本会话发出或收到的每条消息,以及记录过团队邮件的旧团队日志中的每条消息,发送方和接收方都通过名册解析。成员与任务超过八行时折叠为 `+<n> more`,成员列表让所选成员保持在视野内,消息占用剩余的行。没有 teammate 的团队显示 lead 和 `No teammates yet — ask for work that splits into independent parts and the lead will delegate it.`。`team/` 事件、子 agent 事件或叙述到来时团队室重绘,只有成员在运行时才推进旋转指示。`/subagents` 仍然打开一份对话记录。
|
|
216
218
|
|
|
217
219
|
其他每条 `/name` 行都交给共享命令注册表,因此 `/compact`、`/goal` 与插件命令的行为和浏览器中一致。`/compact` 在轮次之间运行:有轮次正在进行时,它打印 `/compact runs between turns: let this turn finish, or stop it (Esc twice)`。运行期间,工作旋转指示显示 `compacting context · Esc cancels`,`Esc` 会取消它并给出通知 `/compact cancelled`,其间提交的提示在 follow-ups 列表中等待并提示 `queued: the prompt starts once compaction finishes`,切换会话也会等它结束;它落地的压缩块就是其结果,因此不再打印它自己的成功文本。运行中的轮次里发生的自动压缩,会把该轮次的旋转指示标为 `compacting`,直到下一次模型调用开始。
|
|
218
220
|
|
|
@@ -291,7 +293,7 @@ runner 等待完整应用就绪(`ctx.get('loader')?.await()`),并在核心
|
|
|
291
293
|
|
|
292
294
|
### 渲染模型
|
|
293
295
|
|
|
294
|
-
持久事实来自会话日志:`system/message`(非空提示词完整画出;空的绘制则省略)、`user/message`(自己提交的消息只绘制一次,其回显按消息 id 跳过;注入的上下文——instructions、catalogs、snapshots、notices、relays、recalls 以及未声明的形式——以暗色 `⬡` 行完整画出,快照按具名贡献各成一部分;压缩检查点以及工具或模型来源则省略)、`compaction/start`、`compaction/summary`、检查点替换与 `compaction/end`(依据每个事件的 `surfaceOp` 维护的 surface 镜像写明被替换与仍保留的节点,结束标记绘出压缩块或失败的 `/compact` 通知;归属于轮次的 `compaction/start` 会改写运行中的旋转指示标签)、`assistant/message`(用已提交文本替换流式块,并把用量折入页脚)、`tool/call` 与 `tool/result`(工具声明 `presentCall` 与 `presentResult` 视图时据此绘制,否则回退到原始参数与原始结果)、`turn/end` 通知、`workspace/changes`(在 Host 仍保存摘要时,以一行通知给出该轮的文件数与行数)、`session/title`(页眉)、`permission/preset`(页脚),以及所属 `turn/start` 之下的 `todo/write`(某条 todo 的详情页所报告的轮次;该列表不带逐条标识,因此改写措辞的条目算作新条目;同一次写入还从 `todos` 投影刷新 activity board)。后代会话的 `
|
|
296
|
+
持久事实来自会话日志:`system/message`(非空提示词完整画出;空的绘制则省略)、`user/message`(自己提交的消息只绘制一次,其回显按消息 id 跳过;注入的上下文——instructions、catalogs、snapshots、notices、relays、recalls 以及未声明的形式——以暗色 `⬡` 行完整画出,快照按具名贡献各成一部分;压缩检查点以及工具或模型来源则省略)、`compaction/start`、`compaction/summary`、检查点替换与 `compaction/end`(依据每个事件的 `surfaceOp` 维护的 surface 镜像写明被替换与仍保留的节点,结束标记绘出压缩块或失败的 `/compact` 通知;归属于轮次的 `compaction/start` 会改写运行中的旋转指示标签)、`assistant/message`(用已提交文本替换流式块,并把用量折入页脚)、`tool/call` 与 `tool/result`(工具声明 `presentCall` 与 `presentResult` 视图时据此绘制,否则回退到原始参数与原始结果)、`turn/end` 通知、`workspace/changes`(在 Host 仍保存摘要时,以一行通知给出该轮的文件数与行数)、`session/title`(页眉)、`permission/preset`(页脚),以及所属 `turn/start` 之下的 `todo/write`(某条 todo 的详情页所报告的轮次;该列表不带逐条标识,因此改写措辞的条目算作新条目;同一次写入还从 `todos` 投影刷新 activity board)。后代会话的 `turn/start`、`assistant/message` 或 `turn/end`,以及绑定父会话的 `subagent/start` / `subagent/end`,会更新该子会话在板上自己的那一行——消息文本块的最后一句话,从不使用推理、工具调用或工具结果,轮次结束后则是停止用语;尚未说过话的子会话只画出标签;绑定会话的 `turn/end` 与 bind 会清空该板。实时增量来自 `agent/assistant-stream` 的文本、推理、工具调用与用量增量:模型一报出工具名就挂上卡片,工作时的旋转指示跟随该流以及持久的 `tool/call` / `tool/result`,从而标出 `thinking`、`writing` 或 `calling <tool>`,并带着该次调用的实时 `↑` 发送与 `↓` 接收。日志之外的会话事实来自浏览器读取的同一批服务:`sessionTitle`、`permissionPresets`、供选择器身份、`/deliverables` 与子 agent 详情使用的 `sessionQuery`、供选择器标题使用的实时或缓存 `title` 投影、供页脚、`/status`、`/context`、`/todos` 与 `/outline` 使用的 `sessionProjections`、供 `/context` 使用的 `tokenMeter`、供 `@` 补全使用的 `fileReferences` 与 `sessionReferenceResolver`、`attachments`、`skills`、`authorization`、`settings`、`subagents`,以及供 `/plugins` 使用的 Loader 条目。模态提示是进程本地的呈现,从不写入日志。
|
|
295
297
|
|
|
296
298
|
### 基于 base 的 patch 面
|
|
297
299
|
|
|
@@ -343,12 +345,12 @@ runner 等待完整应用就绪(`ctx.get('loader')?.await()`),并在核心
|
|
|
343
345
|
| [`src/status.ts`](src/status.ts) | 投影接缝的事实,以及 `/status` 报告与分段详情共享的小节;重试通知 |
|
|
344
346
|
| [`src/footer.ts`](src/footer.ts) | 状态栏:有序的各分段、每个分段的详情行、未聚焦时由两端向内构建的一行,以及聚焦时的滑动窗口 |
|
|
345
347
|
| [`src/subagent-panel.ts`](src/subagent-panel.ts) | 实时子 agent 面板:一次后代列表加上采样到的实时事实构成其各行、未聚焦时的摘要行,以及聚焦时的列表 |
|
|
346
|
-
| [`src/team-panel.ts`](src/team-panel.ts) |
|
|
348
|
+
| [`src/team-panel.ts`](src/team-panel.ts) | 团队摘要:一行按终端宽度适配的 teammate、运行中与任务计数,在有 teammate 或共享任务时绘制 |
|
|
347
349
|
| [`src/team.ts`](src/team.ts) | `/team`、`/team-tools` 与 `/team-panel`:名册行、九个工具的可见性,以及对可选服务的读取 |
|
|
348
350
|
| [`src/queue-panel.ts`](src/queue-panel.ts) | follow-ups 列表:待处理行符号、悬挂换行与 enter-steer 图例 |
|
|
349
351
|
| [`src/background.ts`](src/background.ts) | `Ctrl+B`:跟踪根调用的 `tools/execute` 包装器,把调用移为 `tool` 作业、识别 shell 调用自己的进程作业,并保持被停止轮次的作业 |
|
|
350
352
|
| [`src/jobs-panel.ts`](src/jobs-panel.ts) | 编辑器上方的后台作业行、`/jobs` 的行与详情页,以及作业结束提示行 |
|
|
351
|
-
| [`src/activity-board.ts`](src/activity-board.ts) | activity board:todo
|
|
353
|
+
| [`src/activity-board.ts`](src/activity-board.ts) | activity board:todo 状态符号、已完成内容划掉、行数上限、子 agent 行所示的自述,以及每个子 agent 一行的绘制 |
|
|
352
354
|
| [`src/catalog.ts`](src/catalog.ts) | `/settings`、`/plugins`、`/subagents`、`/deliverables`、`/changes` 与 `/outline` 的行,以及 `/plugins` 的管理动作 |
|
|
353
355
|
| [`src/view-banner.ts`](src/view-banner.ts) | 输入框上方标明已打开的子 agent 视图或 `/btw` 旁路 agent 及返回按键的一行 |
|
|
354
356
|
| [`src/todos.ts`](src/todos.ts) | todo 列表:状态符号、已完成内容划掉的选择器行与单个条目的详情行 |
|
|
@@ -358,7 +360,7 @@ runner 等待完整应用就绪(`ctx.get('loader')?.await()`),并在核心
|
|
|
358
360
|
| [`tests/background.spec.ts`](tests/background.spec.ts) | 基于真实工具运行时、作业注册表与作业工具的 `Ctrl+B`:旋转指示提示、被移走的结果与卡片、作业行、`/jobs` 输出与 `Ctrl+K`、完成通知、拒绝、失败与轮次停止 |
|
|
359
361
|
| [`tests/background-tracking.spec.ts`](tests/background-tracking.spec.ts) | 包装器跟踪哪些调用、哪些作业算作调用自己的作业,以及被移走结果的文本 |
|
|
360
362
|
| [`tests/jobs-panel.spec.ts`](tests/jobs-panel.spec.ts) | 作业行、`/jobs` 的行、详情页与作业结束提示行的文本 |
|
|
361
|
-
| [`tests/activity-board.spec.ts`](tests/activity-board.spec.ts) | activity board
|
|
363
|
+
| [`tests/activity-board.spec.ts`](tests/activity-board.spec.ts) | activity board 的状态符号、已完成划掉、行数上限、自述的裁剪与子 agent 行 |
|
|
362
364
|
| [`tests/keys.spec.ts`](tests/keys.spec.ts) | 每个区域为一个按键认领什么、按键提示的各级,以及一次按键输入的文字 |
|
|
363
365
|
| [`tests/editor.spec.ts`](tests/editor.spec.ts) | 对照 pi-tui 编辑器行为验证终端光标、`Shift+Left` / `Shift+Right` 词导航,以及 `!` / `!!` 草稿着色 |
|
|
364
366
|
| [`tests/frame.spec.ts`](tests/frame.spec.ts) | 边框线、徽标、正文行,以及某个宽度容纳得下的按键提示 |
|
|
@@ -392,9 +394,10 @@ runner 等待完整应用就绪(`ctx.get('loader')?.await()`),并在核心
|
|
|
392
394
|
| [`tests/startup.spec.ts`](tests/startup.spec.ts) | 基于真实 Loader 配置树的命令行解析 |
|
|
393
395
|
| [`tests/shortcuts.spec.ts`](tests/shortcuts.spec.ts) | 空输入与草稿中的 `?`、任一区域的 `Ctrl+T`、根会话上的 `Ctrl+P`,以及 `Ctrl+L` 重绘 |
|
|
394
396
|
| [`tests/subagents.spec.ts`](tests/subagents.spec.ts) | 实时子 agent 面板的各行、走查与列表刷新,以及它与 `/subagents` 打开的子 agent 视图:经 `/parent` 与 `Ctrl+P` 离开,并在会话切换与退出时释放 |
|
|
395
|
-
| [`tests/team-panel.spec.ts`](tests/team-panel.spec.ts) |
|
|
397
|
+
| [`tests/team-panel.spec.ts`](tests/team-panel.spec.ts) | 团队摘要的计数、运行中的名字、宽度适配、隐藏与已删除任务 |
|
|
396
398
|
| [`tests/team.spec.ts`](tests/team.spec.ts) | 工具可见性行、名册选择行,以及对可选服务的读取 |
|
|
397
399
|
| [`tests/team-app.spec.ts`](tests/team-app.spec.ts) | 终端中的 `/team`、`/team-tools` 与 `/team-panel`:提示、摘要,以及打开 teammate 会话 |
|
|
400
|
+
| [`tests/team-main-page.spec.ts`](tests/team-main-page.spec.ts) | 每个 teammate 只出现在一处:名册成员不进子 agent 面板、`<name> · <role>` 的 board 行、团队行上的运行中名单,以及 teammate 视图标题 |
|
|
398
401
|
| [`../../../apps/cli/tests/profiles/tui/tests/keyless-smoke.e2e.ts`](../../../apps/cli/tests/profiles/tui/tests/keyless-smoke.e2e.ts) | 通过真实启动器与免密钥模拟模型运行随附 profile |
|
|
399
402
|
| [`../../../apps/cli/tests/profiles/tui/tests/quit-while-busy.e2e.ts`](../../../apps/cli/tests/profiles/tui/tests/quit-while-busy.e2e.ts) | 已发布的配置文件在命令、后台作业、子代理或忽略 `SIGTERM` 的进程仍在运行时退出,以及收到 `SIGHUP` 与 `SIGINT` 时的表现:stderr 输出行及其顺序、退出码,以及没有进程残留 |
|
|
400
403
|
|
|
@@ -488,6 +491,7 @@ The user moved this call to the background. It keeps running as job <id>. You ar
|
|
|
488
491
|
这些限制描述随发行版交付的终端表层;它们不是一般的 CLI 比较,也不是任务积压。
|
|
489
492
|
|
|
490
493
|
- **同一时间一个会话**——`/resume`、`/sessions`、`/new`、`/clear` 与 `/fork` 在会话间移动终端,但只有绑定的 Agent 流式显示,子 agent 视图也是用一个子会话替换它所来自的会话来绘制;浏览器可并排展示多个会话。
|
|
494
|
+
- **团队室只显示绑定会话自己的消息**——两个 teammate 之间的消息只记录在它们自己的会话中,所以 lead 的 `/team-play` 列出 lead↔teammate 的消息,不列 teammate↔teammate 的消息;从团队室打开某个 teammate 可以看到它那一方。
|
|
491
495
|
- **审批为一次性**——提示只提供允许一次或拒绝,与审批接缝的词汇一致;没有记忆的授权。
|
|
492
496
|
- **仅浏览器的页面留在浏览器**——workspace 与目录选择器、在应用中打开的链接、轨迹账本与逐条消息的点赞/点踩没有终端对应物;`/settings`、`/plugins`、`/subagents`、`/outline` 与共享的 `/feedback` 以文本覆盖其事实,子 agent 的对话记录在子 agent 视图中阅读。
|
|
493
497
|
- **交付物只列名、不打开**——`/deliverables` 列出交付路径,`/changes` 显示逐行对比;浏览器会预览这些文件。
|
|
@@ -497,6 +501,7 @@ The user moved this call to the background. It keeps running as job <id>. You ar
|
|
|
497
501
|
- **阅读器开着时不绘制对话记录**——对话记录的屏幕被挡在终端之外,因此期间跑完的轮次、落地的工具结果与打印的通知,都在阅读器关闭时的同一帧里绘出。阅读器自身仍会随它们到达而显示,因为它在每一次绘制时都重新读取对话记录。
|
|
498
502
|
- **阅读器显示的是源文本**——assistant 回复读到的是模型写下的 Markdown,而不是对话记录绘制出的渲染结果,因此表格与标题以源码形式呈现;只有列表项开头的 `-`、`*` 或 `+` 画成 `•`。
|
|
499
503
|
- **首次读取大型轮次仍需测量**——在绘制该轮次视口前,阅读器会统计每个小节以得出完整滚动范围;后续绘制会复用缓存的行数并只绘制可见小节,但内容变化或尚未测量过的宽度仍需重新测量。
|
|
504
|
+
- **沉默的子 agent 只画出标签**——板上的一行显示子会话在 assistant 消息里最后说的话,因此只调用工具而不说话的子会话只显示标签与旋转指示,也绝不会拿模型的推理来顶替。每个子会话的委派上下文要求它在每次工具调用前说一句话,但模型仍可能跳过。
|
|
500
505
|
- **面板列出的是本地常驻,而不是整棵树**——子会话在其会话记录常驻于本进程期间加入面板,因此没有本地会话的外部任务永远不会出现;`/subagents` 将该持久任务记录列为不可打开,并与每一个本地后代一同列出。
|
|
501
506
|
- **`continuable` 子会话视图直接向其 Agent 提示**——在 `continuable` 子 agent 视图中输入的提示词会像在任何会话中一样送给该子会话的 Agent,未常驻的子会话由该视图恢复;Web 客户端则经由 subagent 运行时的提示路由发送提示词。
|
|
502
507
|
- **常驻不等于正在工作**——列表的 `activity: 'running'` 表示该子会话的记录常驻,这正是行内 `resident` 所报告的内容;子会话是否在工作则是它旁边单独的 `running` / `idle`,读自本进程中该子会话的 Agent。
|