A local-first multi-agent app development platform, built on PenguinHarness
fix(web): the sidebar's marks say what they stand for (#538)
Yaowei Zhenga8e2d16cee16
diff --git a/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.md b/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.mdnew file mode 100644index 00000000..c1787572--- /dev/null+++ b/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.md@@ -0,0 +1,34 @@+# The sidebar's marks say what they stand for++- **Date:** 2026-08-28+- **Type:** fix+- **Scope:** `web`+- **PR:** [#538](https://github.com/Prism-Shadow/penguin-harness/pull/538)++[中文版](2026-08-28-sidebar-glyphs-and-copy.zh.md)++Six small corrections in the sidebar, each one a mark or a label that named something other+than what it does.++## Details++- **Last conversation** (collapsed rail): a history mark — a clock read backwards — in place+ of the chat-lines-with-resume-arrow glyph. Deliberately not the bare clock the session+ list's "most recent" sort option wears: that one means "ordered by time", this one means+ "the conversation you were last in", and the returning arrow is what says so.+- **Agents** (nav row, and the "group by agent" option that shares the glyph): a robot head+ with ears, eyes and a smile, in place of the featureless dome. An Agent is the thing in+ this product a person talks to.+- **Model library** (nav row): a brain in place of the CPU chip. The page lists language+ models, not the hardware they run on.+- The new-chat page's **"Build and tune agents"** example folder wears that same Agent glyph+ by importing it, where it had been hand-copied as a literal — the copy was already out of+ step with the comment claiming the two were the same mark, and it is what a redrawn glyph+ silently leaves behind. (The import cycle the copy was justified by does not exist: the+ glyph lives in `components/ui/group-list.tsx`, which pulls in nothing from `features/`.)+- **Project settings → Members**: two people, in place of the Agent glyph the tab had+ borrowed. Members are humans.+- zh: the grouping option reads 「按智能体分组」, naming the surface it groups into exactly as+ the nav entry does, instead of 「按 Agent 分组」.+- The session row's **Remote control** action drops its trailing ellipsis, in both languages —+ the other actions in that menu carry none.diff --git a/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.zh.md b/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.zh.mdnew file mode 100644index 00000000..170cf02f--- /dev/null+++ b/changelog/unreleased/2026-08-28-sidebar-glyphs-and-copy.zh.md@@ -0,0 +1,26 @@+# 侧栏的图标各自说清自己代表什么++- **Date:** 2026-08-28+- **Type:** fix+- **Scope:** `web`+- **PR:** [#538](https://github.com/Prism-Shadow/penguin-harness/pull/538)++[English](2026-08-28-sidebar-glyphs-and-copy.md)++侧栏里六处小修正,每一处都是图标或文案指错了对象。++## 细节++- **最近一次对话**(收起态侧栏):改为历史图标——一个带回溯箭头的钟面——取代原先的「对话行 ++ 续接箭头」。刻意不用会话列表「最近」排序选项的那个纯钟面:后者表示「按时间排序」,前者表示+ 「你上次待着的那个对话」,回溯箭头正是说明这一点的部分。+- **智能体**(导航行,以及与之共用图标的「按智能体分组」):改为带耳朵、眼睛和笑脸的机器人头+ 像,取代原先没有五官的圆顶。智能体是这个产品里被人对话的那个对象。+- **模型库**(导航行):改为大脑,取代原先的芯片。这一页列的是语言模型,不是跑模型的硬件。+- 新对话页「**搭建和优化智能体**」示例文件夹改为直接引用同一枚智能体字形,此前是手抄的一份字面+ 量——注释声称两处是同一个标记,实际已经对不上,图标一改就会悄悄留下旧的那份。(当初为抄写找的+ 「import cycle」理由并不成立:该字形在 `components/ui/group-list.tsx`,它不引用 `features/`+ 下的任何东西。)+- **Project 设置 → 成员**:改为两个人形,取代原先借用的智能体图标。成员是人。+- 中文分组选项改为「按智能体分组」,与导航入口对同一处界面的叫法一致,不再写「按 Agent 分组」。+- 会话行的**远程控制**动作去掉末尾省略号(中英文均改)——同一个菜单里其他动作都没有。diff --git a/packages/docs/content/web-app.zh.md b/packages/docs/content/web-app.zh.mdindex efad73e3..d58457df 100644--- a/packages/docs/content/web-app.zh.md+++ b/packages/docs/content/web-app.zh.md@@ -41,7 +41,7 @@ penguin web### 会话列表-侧边栏的会话列表按 Workspace 或 Agent 分组,分组方式与排序方式在标题栏的**列表选项**菜单(滑块图标)里切换,每个选项前带一枚对应图标:文件夹表示按 Workspace 分组、机器人表示按 Agent 分组、时钟表示按最近更新排序、上下箭头表示手动拖拽排序。+侧边栏的会话列表按 Workspace 或 Agent 分组,分组方式与排序方式在标题栏的**列表选项**菜单(滑块图标)里切换,每个选项前带一枚对应图标:文件夹表示按 Workspace 分组、机器人表示按智能体分组、时钟表示按最近更新排序、上下箭头表示手动拖拽排序。会话行的操作分两层:diff --git a/packages/web/src/components/layout/app-layout.tsx b/packages/web/src/components/layout/app-layout.tsxindex dd8f4be4..7376ee04 100644--- a/packages/web/src/components/layout/app-layout.tsx+++ b/packages/web/src/components/layout/app-layout.tsx@@ -27,8 +27,13 @@ import { TerminalDockRuntime } from "../../features/terminal/terminal-view-pool"import { setDockScope } from "../../features/dock/dock-state";import { toneStrip } from "../../lib/tone";-/** "Last conversation" glyph (chat lines + resume arrow), used only by the rail. */-const LAST_CHAT_ICON = "M8 10h8M8 14h5M21 12a9 9 0 1 1-4.2-7.6L21 4v5h-5";+/**+ * "Last conversation" glyph, used only by the rail: lucide's history mark — a clock read+ * backwards. Deliberately not the bare clock the session list's "most recent" sort option+ * wears (group-list.tsx): that one means "ordered by time", this one means "the conversation+ * you were last in", and the returning arrow is what says so.+ */+const HISTORY_ICON = "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8M3 3v5h5M12 7v5l4 2";/** Shared look of rail entries (icon buttons and NavLinks alike): solid gray fill when active, gray hover otherwise. `relative` so an entry can anchor an update badge on its corner (no z-index, so it still creates no stacking context). */const railItemClass = (active: boolean) =>@@ -106,9 +111,11 @@ function CollapsedRail({ onExpand }: { onExpand: () => void }) {growing the document. Scrollbar hidden — at 48px wide it would cost a third of therail's width. */}<nav className="no-scrollbar mt-1 flex min-h-0 flex-1 flex-col items-center gap-1 overflow-y-auto">- {/* 1. Last conversation: lit on any non-draft conversation. Dimmed/disabled (tooltip kept) only- once the list has settled with no non-archived Session — while it is still loading the- entry keeps its normal look (no flash) and a click is a graceful no-op. */}+ {/* 1. Last conversation: a history mark (a clock read backwards) — the entry goes BACK to+ where the user was, which the returning arrow says and a bare clock face does not.+ Lit on any non-draft conversation. Dimmed/disabled (tooltip kept) only once the list+ has settled with no non-archived Session — while it is still loading the entry keeps+ its normal look (no flash) and a click is a graceful no-op. */}<buttontype="button"title={S.nav.lastConversation}@@ -121,7 +128,7 @@ function CollapsedRail({ onExpand }: { onExpand: () => void }) {: "flex h-8 w-8 cursor-not-allowed items-center justify-center rounded-md text-gray-300 dark:text-gray-700"}>- <GlyphIcon d={LAST_CHAT_ICON} size={18} />+ <GlyphIcon d={HISTORY_ICON} size={18} /></button>{/* 2. New chat: shows the same gray active fill while on the draft page (pinned-sidebar convention). */}<buttondiff --git a/packages/web/src/components/layout/project-dialogs.tsx b/packages/web/src/components/layout/project-dialogs.tsxindex 1916c2d3..b3971215 100644--- a/packages/web/src/components/layout/project-dialogs.tsx+++ b/packages/web/src/components/layout/project-dialogs.tsx@@ -37,7 +37,6 @@ import { Input } from "../ui/input";import { Select } from "../ui/select";import { Switch } from "../ui/switch";import { GEAR_ICON } from "../ui/icons";-import { AGENT_GROUP_ICON } from "../ui/group-list";import { FieldError, FieldHint, FieldLabel } from "../ui/field";import { toastError, toastSuccess } from "../ui/toast";import { Modal } from "../ui/modal";@@ -178,7 +177,9 @@ export function CreateProjectDialog({/** Path data for the settings tabs' small icons (24px viewBox, stroked like NAV_ICONS). */const TAB_ICON_PATHS = {general: GEAR_ICON,- members: AGENT_GROUP_ICON,+ /** Two people (lucide users). Project members are humans — the Agent glyph used to stand in here. */+ members:+ "M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2M13 7a4 4 0 1 1-8 0 4 4 0 0 1 8 0M22 21v-2a4 4 0 0 0-3-3.87M16 3.13a4 4 0 0 1 0 7.75",/** Sliders (lucide sliders-vertical). */defaults: "M4 21v-7m0-4V3m8 18v-9m0-4V3m8 18v-5m0-4V3M1 14h6m2-6h6m2 8h6",/** Shield (lucide shield). */diff --git a/packages/web/src/components/ui/group-list.tsx b/packages/web/src/components/ui/group-list.tsxindex c1b78f91..67f63506 100644--- a/packages/web/src/components/ui/group-list.tsx+++ b/packages/web/src/components/ui/group-list.tsx@@ -26,9 +26,14 @@ export const FOLDER_ICON =export const FOLDER_OPEN_ICON ="m6 14 1.45-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.55 6a2 2 0 0 1-1.94 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2";-/** Agent glyph (the grouping toggle's "by Agent" option; also NAV_ICONS.agents in the sidebar nav). */+/**+ * Agent glyph (the grouping toggle's "by Agent" option; also NAV_ICONS.agents in the sidebar+ * nav): a robot head with an antenna, two ears, two eyes and a smile — lucide's `bot` with the+ * mouth added. The face is the point: an Agent is the thing in this product a person talks to,+ * and the friendliest mark on the rail should be the one that stands for it.+ */export const AGENT_GROUP_ICON =- "M12 3v3m-6 4a6 6 0 0 1 12 0v5a3 3 0 0 1-3 3H9a3 3 0 0 1-3-3v-5zm3 3h.01M15 13h.01";+ "M12 8V4H8M6 8h12a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2zM2 14h2M20 14h2M9 13h.01M15 13h.01M10 16.5s.8 1 2 1 2-1 2-1";/** Clock (lucide clock, drawn as one path), the "most recent" sort option. */export const CLOCK_ICON = "M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0M12 6v6l4 2";diff --git a/packages/web/src/components/ui/icons.tsx b/packages/web/src/components/ui/icons.tsxindex 3bfcc80c..eb53bcb7 100644--- a/packages/web/src/components/ui/icons.tsx+++ b/packages/web/src/components/ui/icons.tsx@@ -189,7 +189,13 @@ export const NAV_ICONS = {agents: AGENT_GROUP_ICON,/** Skill library (an open book: two pages + spine). */skills: "M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2zM22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z",- models: "M7 7h10v10H7zM4 10h3m10 0h3M4 14h3m10 0h3M10 4v3m4-3v3m-4 10v3m4-3v3",+ /**+ * Model library (a brain: two lobes drawn as one path, closed across the midline). The chip+ * this replaces named the hardware a model runs on; what the page actually lists is language+ * models, and a brain is the mark that says so at a glance.+ */+ models:+ "M12 5a3 3 0 1 0-5.997.125 4 4 0 0 0-2.526 5.77 4 4 0 0 0 .556 6.588A4 4 0 1 0 12 18ZM12 5a3 3 0 1 1 5.997.125 4 4 0 0 1 2.526 5.77 4 4 0 0 1-.556 6.588A4 4 0 1 1 12 18Z",/** Machines (two stacked server units, each with its own status lamp). */machines: "M4 4h16v6H4zM4 14h16v6H4zM7 7h.01M7 17h.01",usage: "M4 20V10m6 10V4m6 16v-7m4 7H2",diff --git a/packages/web/src/features/chat/draft-view.tsx b/packages/web/src/features/chat/draft-view.tsxindex c71d0b5d..408c5ce8 100644--- a/packages/web/src/features/chat/draft-view.tsx+++ b/packages/web/src/features/chat/draft-view.tsx@@ -57,6 +57,7 @@ import { agentDisplayName, useProject } from "../../state/project";import { useSessions } from "../../state/sessions";import { AgentAvatar } from "../../components/ui/agent-avatar";import { Chevron } from "../../components/ui/chevron";+import { AGENT_GROUP_ICON } from "../../components/ui/group-list";import { Dropdown } from "../../components/ui/dropdown";import { PenguinLogo } from "../../components/ui/penguin-logo";import { toastError } from "../../components/ui/toast";@@ -124,18 +125,18 @@ function saveAppliedRouteKey(field: RouteStateField, key: string): void {* competing with the titles, while the folder row is exactly where a glyph earns its place —* it is what you scan to pick a category.*- * webapps: a browser window (chrome bar + two dots). agents: the SAME robot head the sidebar's- * Agents entry uses (NAV_ICONS.agents) — deliberately not a generic refresh loop, because the- * app already has one glyph that means "agent" and a folder of agent examples should wear it.- * Duplicated as a literal rather than imported: sidebar.tsx imports from chat-page.tsx, which- * renders this file, so importing it back would close an import cycle. schedules: a clock face- * with hands — the plainest mark for "fires on a timer", and distinct from the hourglass that- * already means a Session is waiting.+ * webapps: a browser window (chrome bar + two dots). agents: AGENT_GROUP_ICON itself — the one+ * glyph in the app that means "agent", worn by the sidebar's Agents entry and its grouping+ * option — imported rather than copied, because a hand-copied duplicate is what silently drifts+ * the day that glyph is redrawn. (`components/ui/group-list.tsx` pulls in nothing from+ * `features/`, so there is no cycle to avoid here.) schedules: a clock face with hands — the+ * plainest mark for "fires on a timer", and distinct from the hourglass that already means a+ * Session is waiting.*/const FOLDER_GLYPHS: Record<ExampleFolderId, string> = {webapps:"M3 6a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V6zM3 9h18M6 6.5h.01M9 6.5h.01",- agents: "M12 3v3m-6 4a6 6 0 0 1 12 0v5a3 3 0 0 1-3 3H9a3 3 0 0 1-3-3v-5zm3 3h.01M15 13h.01",+ agents: AGENT_GROUP_ICON,schedules: "M12 2a10 10 0 1 0 0 20 10 10 0 1 0 0-20M12 6.5V12l3.5 2",};diff --git a/packages/web/src/lib/strings-en.ts b/packages/web/src/lib/strings-en.tsindex f612c85d..a88dbeab 100644--- a/packages/web/src/lib/strings-en.ts+++ b/packages/web/src/lib/strings-en.ts@@ -2070,8 +2070,8 @@ Scenarios:*/messaging: {panelTitle: "Remote control",- /** Session-row context-menu action (the trailing ellipsis marks that a dialog follows). */- bindAction: "Remote control…",+ /** Session-row context-menu action. */+ bindAction: "Remote control",dialogTitle: "Remote control",/** The channel selector (always live: each channel's config is saved independently). */channelLabel: "Channel",diff --git a/packages/web/src/lib/strings.ts b/packages/web/src/lib/strings.tsindex f33cd5a5..e2596abf 100644--- a/packages/web/src/lib/strings.ts+++ b/packages/web/src/lib/strings.ts@@ -7,7 +7,9 @@* language (module-level constants do not update on switch — keep reads inside components).* Keep domain terms capitalized in English — Workspace, Token, Task, Session, Project, Trace.* "agent" is a common noun: lowercase mid-sentence, capitalized only at the start of a- * label/sentence or in a proper name (Agent State, AgentHub). zh keeps "Agent" as-is.+ * label/sentence or in a proper name (Agent State, AgentHub). zh names the SURFACE+ * 「智能体」 — the nav entry, the grouping option, the panel — and keeps "Agent" as-is+ * inside running prose, where it is the term of art rather than the thing being pointed at.*/export const zh = {appName: "PenguinHarness",@@ -1254,7 +1256,7 @@ export const zh = {workspaceDirInvalid: "目录不存在或无法访问,已回退",/** Grouping toggle of the sidebar conversation list (workspace grouping is the default) and the workspace groups. */groupByWorkspace: "按工作区分组",- groupByAgent: "按 Agent 分组",+ groupByAgent: "按智能体分组",groupByTime: "按时间分组",/** Time-mode bucket names (last day / last month / older), by last activity. */timeGroups: {@@ -2019,8 +2021,8 @@ Benchmark:*/messaging: {panelTitle: "远程控制",- /** Session-row context-menu action (the trailing ellipsis marks that a dialog follows). */- bindAction: "远程控制…",+ /** Session-row context-menu action. */+ bindAction: "远程控制",dialogTitle: "远程控制",/** The channel selector (always live: each channel's config is saved independently). */channelLabel: "渠道",