Skip to content

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.md
new file mode 100644
index 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.md
new file mode 100644
index 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.md
index 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.tsx
index 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 the
rail'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. */}
<button
type="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). */}
<button
diff --git a/packages/web/src/components/layout/project-dialogs.tsx b/packages/web/src/components/layout/project-dialogs.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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: "渠道",