From 412fdceb3cb8147f4076e6ab0c18b9bc72b63e07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=9B=B7=E7=94=B5=E8=8A=BD=E8=A1=A3?=
 <zhangyanghaha0407@outlook.com>
Date: Fri, 9 Oct 2026 11:32:43 -0400
Subject: [PATCH] Q206: Work and Library say which object drives work: only a
 task runs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/renderer/src/i18n/zh.ts            | 2 ++
 src/renderer/src/pages/LibraryPage.tsx | 1 +
 src/renderer/src/pages/WorkPage.tsx    | 1 +
 tests/e2e/library.spec.ts              | 7 +++++++
 4 files changed, 11 insertions(+)

diff --git a/src/renderer/src/i18n/zh.ts b/src/renderer/src/i18n/zh.ts
index 9d6d48e1..74dcb85a 100644
--- a/src/renderer/src/i18n/zh.ts
+++ b/src/renderer/src/i18n/zh.ts
@@ -699,6 +699,8 @@ export const zh: Record<string, string> = {
   "Waiting for the {name} sign-in in your browser (check {check} of {checks}).": "正在等待你在浏览器中完成 {name} 登录（第 {check}/{checks} 次检查）。",
   "Stop waiting": "停止等待",
   "People to mention": "可提及的人",
+  "Only a task runs: an agent picks it up and does the work. Goals and projects group tasks; documents and knowledge are what agents read and write along the way.": "只有任务会被执行：智能体接手任务并完成工作。目标和项目用来归组任务；文档和知识是智能体在工作中读写的内容。",
+  "Agents read and write these while working on tasks. Nothing here starts work; a task does.": "智能体在执行任务时读写这些内容。这里的内容不会自行启动工作，只有任务会。",
   "{title}: use the arrow keys to read each value": "{title}：用方向键逐项读取数值",
   "{rate}% of judged work accepted": "已评判的工作中 {rate}% 被接受",
   "No work judged yet": "还没有评判过的工作",
diff --git a/src/renderer/src/pages/LibraryPage.tsx b/src/renderer/src/pages/LibraryPage.tsx
index de89d572..089c3c8a 100644
--- a/src/renderer/src/pages/LibraryPage.tsx
+++ b/src/renderer/src/pages/LibraryPage.tsx
@@ -49,6 +49,7 @@ export function LibraryPage({ snapshot, actions, focus }: PageProps) {
         <div className="content">
           <div className="page">
             <h1 className="page-h1">{tab === "documents" ? t("Documents") : t("Knowledge")}</h1>
+            <p className="page-sub">{t("Agents read and write these while working on tasks. Nothing here starts work; a task does.")}</p>
             {tab === "documents"
               ? <DocumentsPanel focusId={focus?.kind === "document" ? focus.id : null} orgId={orgId} employeeId={employee.id} documents={documents} tasks={tasks} actions={actions} />
               : <KnowledgePanel focusId={focus?.kind === "knowledge" ? focus.id : null} orgId={orgId} employeeId={employee.id} entries={entries} scopes={scopes} actions={actions} />}
diff --git a/src/renderer/src/pages/WorkPage.tsx b/src/renderer/src/pages/WorkPage.tsx
index a6671f40..5e743616 100644
--- a/src/renderer/src/pages/WorkPage.tsx
+++ b/src/renderer/src/pages/WorkPage.tsx
@@ -113,6 +113,7 @@ export function WorkPage({ snapshot, actions, navigate, focus }: PageProps) {
         <Button tone="primary" onClick={() => setNewTaskOpen(true)}><Icon name="plus" size={16} /> {t("New task")}</Button>
       </TopbarActions>
       <h1 className="page-h1">{t("Work")}</h1>
+      <p className="page-sub">{t("Only a task runs: an agent picks it up and does the work. Goals and projects group tasks; documents and knowledge are what agents read and write along the way.")}</p>
       {scope && (
         <div className="row" style={{ gap: 8, marginBottom: 8 }}>
           <Pill>
diff --git a/tests/e2e/library.spec.ts b/tests/e2e/library.spec.ts
index 87aa2972..78cabfbc 100644
--- a/tests/e2e/library.spec.ts
+++ b/tests/e2e/library.spec.ts
@@ -48,6 +48,8 @@ test("the library manages documents with versions and knowledge with history", a
     expect(orgId).toBeTruthy();
 
     await page.getByRole("button", { name: "Library", exact: true }).click();
+    // Each page says which object drives work: only a task runs.
+    await expect(page.getByText("Nothing here starts work; a task does.", { exact: false })).toBeVisible();
     await page.getByRole("listitem").filter({ hasText: "Pricing memo" }).click();
     await page.getByRole("button", { name: "Edit", exact: true }).click();
     await page.getByLabel("Content").fill("Price is 12.");
@@ -57,6 +59,11 @@ test("the library manages documents with versions and knowledge with history", a
     await page.getByLabel("Version").selectOption("1");
     await expect(page.getByText("Price is 10.")).toBeVisible();
 
+    await page.getByRole("button", { name: "Knowledge", exact: true }).click();
+    await expect(page.getByText("Nothing here starts work; a task does.", { exact: false })).toBeVisible();
+    await page.getByRole("button", { name: "Work", exact: true }).click();
+    await expect(page.getByText("Only a task runs: an agent picks it up and does the work.", { exact: false })).toBeVisible();
+    await page.getByRole("button", { name: "Library", exact: true }).click();
     await page.getByRole("button", { name: "Knowledge", exact: true }).click();
     await page.getByRole("button", { name: "New", exact: true }).click();
     await page.getByLabel("Topic").fill("Refund window");