@linxin666/dsh-client-ui-task-board 0.1.20 → 0.2.0

package/src/client/board/TaskDetail.tsx

@@ -12,7 +12,7 @@ import { t, type TaskBoardKey } from '../locales.ts'
 import { SCHEDULE_PRESETS } from '../schedule-presets.ts'
 import css from '../board.module.css'
 import { ConfirmDialog } from './ConfirmDialog.tsx'
-import { formatTime } from './TaskCard.tsx'
+import { formatHostTimestamp, formatTime } from './TaskCard.tsx'
 import { STATUS_KEY } from './status-key.ts'
 
 /** Execution outcome → locale key. */
@@ -23,7 +23,7 @@ const RESULT_KEY: Record<NonNullable<ExecutionRecord['result']>, TaskBoardKey> =
 }
 
 /** One execution-history row. */
-function ExecutionRow({ execution, onOpen }: { execution: ExecutionRecord; onOpen: (sessionId: string) => void }) {
+function ExecutionRow({ execution, timeZone, onOpen }: { execution: ExecutionRecord; timeZone?: string; onOpen: (sessionId: string) => void }) {
   const result = execution.result
   return (
     <li className={css.executionRow} data-result={result}>
@@ -31,8 +31,8 @@ function ExecutionRow({ execution, onOpen }: { execution: ExecutionRecord; onOpe
         {result === undefined ? t('detail.result.running') : t(RESULT_KEY[result])}
       </span>
       <span className={css.executionTimes}>
-        {t('detail.executionStarted')} {formatTime(execution.startedAt)}
-        {execution.endedAt !== undefined && ` · ${t('detail.executionEnded')} ${formatTime(execution.endedAt)}`}
+        {t('detail.executionStarted')} {formatTime(execution.startedAt, timeZone)}
+        {execution.endedAt !== undefined && ` · ${t('detail.executionEnded')} ${formatTime(execution.endedAt, timeZone)}`}
       </span>
       {execution.sessionId !== undefined && (
         <button
@@ -52,7 +52,7 @@ function ExecutionRow({ execution, onOpen }: { execution: ExecutionRecord; onOpe
 }
 
 /** The execution-target editor: workspace / mode / permission pickers. */
-function ExecutionSettingsSection({ controller, task }: { controller: BoardController; task: TaskRecord }) {
+function ExecutionSettingsSection({ controller, task, pending }: { controller: BoardController; task: TaskRecord; pending: boolean }) {
   const [options, setOptions] = useState(controller.getSnapshot().executionOptions)
   useEffect(
     () => controller.subscribe(() => setOptions(controller.getSnapshot().executionOptions)),
@@ -75,6 +75,7 @@ function ExecutionSettingsSection({ controller, task }: { controller: BoardContr
         <select
           className={css.select}
           value={workspaceId}
+          disabled={pending}
           onChange={event => { controller.updateTask(task.id, { workspaceId: event.target.value }) }}
         >
           <option value="">{t('exec.workspace.recent')}</option>
@@ -89,6 +90,7 @@ function ExecutionSettingsSection({ controller, task }: { controller: BoardContr
         <select
           className={css.select}
           value={mode}
+          disabled={pending}
           onChange={event => { controller.updateTask(task.id, { mode: event.target.value }) }}
         >
           <option value="">{t('exec.mode.default')}</option>
@@ -107,6 +109,7 @@ function ExecutionSettingsSection({ controller, task }: { controller: BoardContr
         <select
           className={css.select}
           value={permission}
+          disabled={pending}
           onChange={event => { controller.updateTask(task.id, { permission: event.target.value === '' ? undefined : event.target.value as TaskPermission }) }}
         >
           <option value="">{t('exec.permission.default')}</option>
@@ -120,13 +123,14 @@ function ExecutionSettingsSection({ controller, task }: { controller: BoardContr
 }
 
 /** The scheduled-runs editor: enable toggle, cron input + presets, next-run info. */
-function ScheduleSection({ controller, task }: { controller: BoardController; task: TaskRecord }) {
+function ScheduleSection({ controller, task, pending }: { controller: BoardController; task: TaskRecord; pending: boolean }) {
   const schedule = task.schedule
   const [cron, setCron] = useState(schedule?.cron ?? '0 9 * * *')
   const [enabled, setEnabled] = useState(schedule?.enabled ?? false)
   const [nextRunAt, setNextRunAt] = useState<number | undefined>(schedule?.nextRunAt)
   const [lastTriggeredAt, setLastTriggeredAt] = useState<number | undefined>(schedule?.lastTriggeredAt)
   const [error, setError] = useState<string | undefined>(undefined)
+  const timeZone = controller.getSnapshot().host?.scheduler.timeZone
 
   // Keep the editor in sync when the task record changes underneath (the
   // schedule rolls forward as runs trigger).
@@ -158,8 +162,11 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
       return
     }
     setError(undefined)
-    if (next && trimmed !== schedule?.cron) controller.setSchedule(task.id, { cron: trimmed })
-    if (controller.setSchedule(task.id, { enabled: next })) setEnabled(next)
+    const submitted = controller.setSchedule(task.id, {
+      enabled: next,
+      ...(next && trimmed !== schedule?.cron ? { cron: trimmed } : {}),
+    })
+    if (submitted && !controller.isHostBacked()) setEnabled(next)
   }
 
   const applyPreset = (preset: string): void => {
@@ -173,8 +180,8 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
     ? t('detail.schedule.notScheduled')
     : nextRunAt <= Date.now()
       ? t('detail.schedule.dueSoon')
-      : new Date(nextRunAt).toLocaleString()
-  const lastLabel = lastTriggeredAt === undefined ? '—' : new Date(lastTriggeredAt).toLocaleString()
+      : formatHostTimestamp(nextRunAt, timeZone)
+  const lastLabel = lastTriggeredAt === undefined ? '—' : formatHostTimestamp(lastTriggeredAt, timeZone)
 
   return (
     <section className={css.detailSection}>
@@ -183,6 +190,7 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
         <input
           type="checkbox"
           checked={enabled}
+          disabled={pending}
           onChange={event => { toggleEnabled(event.target.checked) }}
         />
         <span>{t('detail.schedule.enable')}</span>
@@ -191,6 +199,7 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
         <input
           className={`${css.input} ${css.scheduleInput}${error !== undefined ? ` ${css.scheduleInputInvalid}` : ''}`}
           value={cron}
+          disabled={pending}
           placeholder="0 9 * * *"
           spellCheck={false}
           aria-label={t('detail.schedule.cron')}
@@ -201,6 +210,7 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
         <select
           className={css.schedulePreset}
           value=""
+          disabled={pending}
           aria-label={t('detail.schedule.presets')}
           onChange={event => { applyPreset(event.target.value) }}
         >
@@ -222,19 +232,26 @@ function ScheduleSection({ controller, task }: { controller: BoardController; ta
 /** Task detail overlay. */
 export function TaskDetail({ controller, task }: { controller: BoardController; task: TaskRecord }) {
   const [confirmDelete, setConfirmDelete] = useState(false)
-  const running = task.status === 'running'
 
   // Keep the overlay in sync if the task record changes underneath.
   const [latest, setLatest] = useState(task)
   useEffect(() => { setLatest(task) }, [task])
   const current = latest
+  const snapshot = controller.getSnapshot()
+  const running = current.status === 'running'
+  const archived = current.archivedAt !== undefined
+  const pending = snapshot.pendingTaskIds.includes(current.id)
+  const transportError = snapshot.transportError
+  const timeZone = snapshot.host?.scheduler.timeZone
 
   return (
     <div className={css.modalBackdrop} onMouseDown={event => { if (event.target === event.currentTarget) controller.closeTask() }}>
       <div className={css.detail} role="dialog" aria-label={t('detail.title')}>
         <header className={css.detailHeader}>
           <h2 className={css.detailTitle}>{current.title}</h2>
-          <span className={css.statusBadge} data-status={current.status}>{t(STATUS_KEY[current.status])}</span>
+          <span className={css.statusBadge} data-status={archived ? 'archived' : current.status}>
+            {archived ? t('board.archive') : t(STATUS_KEY[current.status])}
+          </span>
           <button
             type="button"
             className={css.iconButton}
@@ -246,6 +263,14 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
         </header>
 
         <div className={css.detailBody}>
+          {transportError !== undefined && (
+            <div className={css.formError}>
+              {t('board.hostError', { error: transportError })}{' '}
+              <button type="button" className={css.linkButton} onClick={() => { void controller.retryHostSync() }}>
+                {t('board.retryHost')}
+              </button>
+            </div>
+          )}
           <section className={css.detailSection}>
             <h4>{t('detail.description')}</h4>
             <p className={css.detailText}>{current.description !== '' ? current.description : '—'}</p>
@@ -256,9 +281,12 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
             <pre className={css.promptBlock}>{current.prompt !== '' ? current.prompt : current.title}</pre>
           </section>
 
-          <ExecutionSettingsSection controller={controller} task={current} />
-
-          <ScheduleSection controller={controller} task={current} />
+          {!archived && (
+            <>
+              <ExecutionSettingsSection controller={controller} task={current} pending={pending} />
+              <ScheduleSection controller={controller} task={current} pending={pending} />
+            </>
+          )}
 
           <section className={css.detailSection}>
             <h4>{t('detail.execution')}</h4>
@@ -270,6 +298,7 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
                   <ExecutionRow
                     key={execution.id}
                     execution={execution}
+                    timeZone={timeZone}
                     onOpen={sessionId => { controller.openSession(sessionId) }}
                   />
                 ))}
@@ -277,45 +306,49 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
             )}
           </section>
 
-          <section className={css.detailSection}>
-            <h4>{t('board.status')}</h4>
-            <div className={css.moveRow}>
-              {MANUAL_STATUSES.map(status => (
-                <button
-                  key={status}
-                  type="button"
-                  className={css.ghostButton}
-                  disabled={current.status === status || running}
-                  onClick={() => { controller.moveTask(current.id, status) }}
-                >
-                  {t(`status.move.${status}` as TaskBoardKey)}
-                </button>
-              ))}
-            </div>
-          </section>
+          {!archived && (
+            <section className={css.detailSection}>
+              <h4>{t('board.status')}</h4>
+              <div className={css.moveRow}>
+                {MANUAL_STATUSES.map(status => (
+                  <button
+                    key={status}
+                    type="button"
+                    className={css.ghostButton}
+                    disabled={current.status === status || running || pending}
+                    onClick={() => { controller.moveTask(current.id, status) }}
+                  >
+                    {t(`status.move.${status}` as TaskBoardKey)}
+                  </button>
+                ))}
+              </div>
+            </section>
+          )}
         </div>
 
         <footer className={css.detailFooter}>
-          <button
-            type="button"
-            className={css.primaryButton}
-            disabled={running}
-            onClick={() => {
-              // Running kicks off a real agent session; close the detail so
-              // the whole board stays visible while the task executes.
-              controller.closeTask()
-              void controller.rerunTask(current.id)
-            }}
-          >
-            {current.executions.length === 0 ? t('detail.run') : t('detail.rerun')}
-          </button>
-          {current.archivedAt !== undefined ? (
+          {!archived && pending && <span className={css.detailMeta}>{t('board.pending')}…</span>}
+          {!archived && (
+            <button
+              type="button"
+              className={css.primaryButton}
+              disabled={running || pending}
+              onClick={() => {
+                void controller.rerunTask(current.id).then(() => {
+                  if (controller.getSnapshot().transportError === undefined) controller.closeTask()
+                })
+              }}
+            >
+              {current.executions.length === 0 ? t('detail.run') : t('detail.rerun')}
+            </button>
+          )}
+          {archived ? (
             <button
               type="button"
               className={css.primaryButton}
+              disabled={pending}
               onClick={() => {
                 controller.restoreTask(current.id)
-                controller.closeTask()
               }}
             >
               {t('detail.restore')}
@@ -325,9 +358,9 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
               <button
                 type="button"
                 className={css.ghostButton}
+                disabled={pending}
                 onClick={() => {
                   controller.archiveTask(current.id)
-                  controller.closeTask()
                 }}
               >
                 {t('detail.archive')}
@@ -337,13 +370,14 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
           <button
             type="button"
             className={css.dangerButton}
+            disabled={pending}
             onClick={() => { setConfirmDelete(true) }}
           >
             {t('detail.delete')}
           </button>
           <span className={css.detailMeta}>
-            {t('board.created')} {formatTime(current.createdAt)}
-            {current.archivedAt !== undefined && ` · ${t('detail.archivedAt', { time: formatTime(current.archivedAt) })}`}
+            {t('board.created')} {formatTime(current.createdAt, timeZone)}
+            {archived && ` · ${t('detail.archivedAt', { time: formatTime(current.archivedAt!, timeZone) })}`}
           </span>
         </footer>
       </div>
@@ -358,7 +392,6 @@ export function TaskDetail({ controller, task }: { controller: BoardController;
           onConfirm={() => {
             setConfirmDelete(false)
             controller.deleteTask(current.id)
-            controller.closeTask()
           }}
         />
       )}

package/src/client/host-api.ts

@@ -0,0 +1,95 @@
+import type { TaskRecord } from '../core/tasks.ts'
+import {
+  TASK_BOARD_API_PREFIX,
+  type TaskBoardAction,
+  type TaskBoardActionEnvelope,
+  type TaskBoardSnapshot,
+} from '../protocol.ts'
+
+const IMPORT_MARKER = 'dsh.taskBoard.v2.hostImported'
+const SOURCE_KEY = 'dsh.taskBoard.v2.sourceId'
+const IMPORT_REQUEST_KEY = 'dsh.taskBoard.v2.importRequestId'
+const REQUEST_TIMEOUT_MS = 15_000
+
+function uuid(): string {
+  return globalThis.crypto?.randomUUID?.() ?? `browser-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`
+}
+
+async function readJson<T>(response: Response): Promise<T> {
+  const body = await response.json() as T & { error?: string }
+  if (!response.ok) throw new Error(body.error ?? `task-board request failed: ${response.status}`)
+  return body
+}
+
+export interface TaskBoardHostTransport {
+  bootstrap(legacy: readonly TaskRecord[]): Promise<TaskBoardSnapshot>
+  state(): Promise<TaskBoardSnapshot>
+  action(action: TaskBoardAction): Promise<TaskBoardSnapshot>
+  subscribe(listener: () => void): () => void
+}
+
+export class HttpTaskBoardHostTransport implements TaskBoardHostTransport {
+  constructor(private readonly storage: Pick<Storage, 'getItem' | 'setItem'> | undefined = globalThis.localStorage) {}
+
+  async bootstrap(legacy: readonly TaskRecord[]): Promise<TaskBoardSnapshot> {
+    const initial = await this.state()
+    const ledgerId = initial.scheduler.ledgerId
+    if (legacy.length > 0 && ledgerId !== undefined && this.storage?.getItem(IMPORT_MARKER) !== ledgerId) {
+      let sourceId = this.storage?.getItem(SOURCE_KEY)
+      if (sourceId === null || sourceId === undefined || sourceId === '') {
+        sourceId = uuid()
+        this.storage?.setItem(SOURCE_KEY, sourceId)
+      }
+      let requestId = this.storage?.getItem(IMPORT_REQUEST_KEY)
+      if (requestId === null || requestId === undefined || requestId === '') {
+        requestId = uuid()
+        this.storage?.setItem(IMPORT_REQUEST_KEY, requestId)
+      }
+      const snapshot = await this.post(requestId, { kind: 'import', sourceId, tasks: [...legacy] })
+      this.storage?.setItem(IMPORT_MARKER, snapshot.scheduler.ledgerId ?? ledgerId)
+      return snapshot
+    }
+    return initial
+  }
+
+  async state(): Promise<TaskBoardSnapshot> {
+    return await this.request(`${TASK_BOARD_API_PREFIX}/state`, { cache: 'no-store' })
+  }
+
+  async action(action: TaskBoardAction): Promise<TaskBoardSnapshot> {
+    return await this.post(uuid(), action)
+  }
+
+  private async post(requestId: string, action: TaskBoardAction): Promise<TaskBoardSnapshot> {
+    const envelope: TaskBoardActionEnvelope = { requestId, action }
+    return await this.request(`${TASK_BOARD_API_PREFIX}/action`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(envelope),
+    })
+  }
+
+  private async request(url: string, init: RequestInit): Promise<TaskBoardSnapshot> {
+    const controller = new AbortController()
+    const timeout = globalThis.setTimeout(() => { controller.abort() }, REQUEST_TIMEOUT_MS)
+    try {
+      return await readJson<TaskBoardSnapshot>(await fetch(url, { ...init, signal: controller.signal }))
+    } catch (error) {
+      if (controller.signal.aborted) throw new Error(`task-board Host request timed out after ${REQUEST_TIMEOUT_MS / 1_000}s`)
+      throw error
+    } finally {
+      globalThis.clearTimeout(timeout)
+    }
+  }
+
+  subscribe(listener: () => void): () => void {
+    const events = new EventSource(`${TASK_BOARD_API_PREFIX}/events`)
+    events.onmessage = () => { listener() }
+    const onVisible = (): void => { if (document.visibilityState === 'visible') listener() }
+    document.addEventListener('visibilitychange', onVisible)
+    return () => {
+      document.removeEventListener('visibilitychange', onVisible)
+      events.close()
+    }
+  }
+}

package/src/client/index.ts

@@ -8,8 +8,8 @@
  * shell fails the whole boot when a plugin apply throws, and an external
  * plugin must not take the GUI down.
  */
-import type { ClientContext, SessionId, SettingsScope, SettingsScopeSpec, WorkspaceId } from '@deepseek-ai/dsh-client-runtime/client'
-import type { ConnectionHandle, PromptContentPart } from '@deepseek-ai/dsh-client-connection/client'
+import type { ClientContext, ISessions, IWorkspaces, SessionId, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client'
 import type {} from '@deepseek-ai/dsh-client-ui-slots'
 // Type-only: pulls the locale plugin's Context merge (ctx.locale) and its
 // LocaleNamespaceMap merge table.
@@ -17,14 +17,13 @@ import type {} from '@deepseek-ai/dsh-client-locale/client'
 // Type-only: pulls the settings-surface Context merge (ctx.settingsScope).
 import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import { BoardController } from '../core/controller.ts'
-import { ExecutionService } from '../core/execution.ts'
-import { SchedulerService } from '../core/scheduler.ts'
 import { LocalStorageTaskStore } from '../core/store.ts'
 import { claimTaskboardApply, releaseTaskboardApply } from './apply-guard.ts'
 import { mountBoard } from './board-mount.tsx'
 import { mountSidebarEntry } from './sidebar-entry.ts'
 import { TaskBoardSettingsCard, TaskBoardSettingsCardController, type TaskBoardSettings } from './TaskBoardSettingsCard.tsx'
 import { en, zh, type TaskBoardKey } from './locales.ts'
+import { HttpTaskBoardHostTransport } from './host-api.ts'
 
 /** Locale namespace this plugin owns. */
 const NS = 'task-board'
@@ -113,64 +112,18 @@ export function apply(ctx: ClientContext): void {
   let uiDisposer: (() => void) | undefined
   const mountUi = (): void => {
     if (uiDisposer !== undefined) return
-    const sessions = ctx.sessions
-    const workspaces = ctx.workspaces
+    // Host and browser SDK declarations share the Cordis Context name. Read
+    // the browser faces explicitly so Host-side declaration merging cannot
+    // narrow these two client services during a combined package build.
+    const sessions = ctx.get('sessions') as unknown as ISessions
+    const workspaces = ctx.get('workspaces') as unknown as IWorkspaces
     const connection = ctx.get('connection') as ConnectionHandle
 
     // Core wiring: real runtime faces into the framework-free services.
     const store = new LocalStorageTaskStore()
-    const exec = new ExecutionService({
-      sessions: {
-        list: sessions.list,
-        binding: id => {
-          const binding = sessions.binding(id as SessionId)
-          if (binding === undefined) return undefined
-          const { session } = binding
-          return {
-            session: {
-              rename: title => session.rename(title),
-              prompt: (content, mode) =>
-                session.prompt(content as PromptContentPart[], mode).then(result =>
-                  result.ok ? { ok: true as const } : { ok: false as const, error: result.error }),
-              command: line =>
-                session.command(line).then(result =>
-                  result.ok ? { ok: true as const, matched: result.value.matched } : { ok: false as const, error: result.error }),
-              getSnapshot: () => session.getSnapshot(),
-              subscribe: fn => session.subscribe(fn),
-            },
-          }
-        },
-        noteAgentPreset: (sessionId, agentPreset) => sessions.noteAgentPreset(sessionId as SessionId, agentPreset),
-      },
-      workspaces: {
-        list: workspaces.list,
-        connectWorkspace: id => workspaces.connectWorkspace(id as WorkspaceId),
-      },
-      presets: {
-        select: async (sessionId, agentPreset) => {
-          try {
-            const response = await connection.api.agentPresets.select({ sessionId: sessionId as SessionId, agentPreset })
-            return response.result.ok ? { ok: true as const } : { ok: false as const, error: response.result.error }
-          } catch (error) {
-            return { ok: false as const, error }
-          }
-        },
-      },
-      history: {
-        loadTail: async sessionId => {
-          const response = await connection.api.sessions.history({
-            sessionId: sessionId as SessionId,
-            maxMessages: 20,
-          })
-          return response.result.ok
-            ? { events: response.result.value.events.map(entry => entry.event) }
-            : undefined
-        },
-      },
-    })
     const controller = new BoardController({
       store,
-      exec,
+      transport: new HttpTaskBoardHostTransport(),
       sessions: {
         list: sessions.list,
         open: id => sessions.open(id as SessionId),
@@ -178,27 +131,6 @@ export function apply(ctx: ClientContext): void {
     })
     controller.start()
 
-    // Scheduled runs: a browser-side heartbeat that triggers due tasks through
-    // the same run path as the manual Run button. The first tick is gated on
-    // the session list baseline so a page-load catch-up never fires into a
-    // not-yet-ready runtime; tab visibility recovery ticks immediately.
-    const scheduler = new SchedulerService({
-      tasks: () => controller.getSnapshot().tasks,
-      // Re-read the persisted ledger before every fire decision: a task
-      // deleted in another tab must never fire from a stale in-memory copy.
-      refresh: () => controller.reloadFromStore(),
-      now: () => Date.now(),
-      runTask: id => controller.runTask(id),
-      applySchedule: (id, nextRunAt, lastTriggeredAt) =>
-        controller.applyScheduleNextRun(id, nextRunAt, lastTriggeredAt),
-      ready: () => sessions.list.getSnapshot().phase === 'ready',
-      environment: {
-        addEventListener: (type, listener) => document.addEventListener(type, listener),
-        removeEventListener: (type, listener) => document.removeEventListener(type, listener),
-      },
-    })
-    scheduler.start()
-
     const disposers: Array<() => void> = []
 
     // Execution-target option feeds: the workspace list drives the workspace
@@ -248,7 +180,6 @@ export function apply(ctx: ClientContext): void {
 
     uiDisposer = () => {
       for (const dispose of disposers.splice(0)) dispose()
-      scheduler.dispose()
       controller.dispose()
       uiDisposer = undefined
     }

package/src/client/locales.ts

@@ -24,9 +24,13 @@ export const zh = {
   'board.status.running': '进行中',
   'board.status.done': '已完成',
   'board.status.failed': '已失败',
-  'board.runs': '次执行',
+    'board.runs': '次执行',
+    'board.pending': '正在提交',
   'board.updated': '更新于',
   'board.created': '创建于',
+  'board.hostError': 'Host 操作失败：{error}',
+  'board.retryHost': '重试连接 Host',
+  'board.hostMeta': 'Host 时区 {timeZone} · revision {revision}',
   'new.title': '标题',
   'new.titlePlaceholder': '一句话描述要做什么',
   'new.description': '描述',
@@ -96,11 +100,17 @@ export const zh = {
   'exec.hint': '执行时生效：工作区决定执行会话落在哪个工作区；模式决定会话的 agent 预设；权限经 /permission 命令应用到会话。留空则使用运行时默认。',
   // 插件设置卡片（settings.plugin.item 席位）。
   'settings.title': '任务看板',
-  'settings.description': '控制看板在 agent 系统提示中的播报行为。',
+  'settings.description': '控制 Host 任务看板、agent 播报与运行期间的系统空闲睡眠保护。',
   'settings.enabled': '启用任务看板',
   'settings.enabledHint': '关闭后隐藏侧边栏入口与看板视图。',
   'settings.announceToAgent': '向 agent 播报任务看板',
   'settings.announceToAgentHint': '开启：每条 agent 系统提示都会包含本看板的说明；关闭：不播报，agent 仅在用户主动提及时了解看板。',
+  'settings.preventIdleSleep': '阻止系统空闲睡眠',
+  'settings.preventIdleSleepHint': '默认关闭。开启后，只要存在运行中的 DSH 会话、已启用的定时任务或会话状态尚未确认，Host 就阻止整机因空闲睡眠；屏幕仍可自动关闭。',
+  'settings.powerStatus': '平台：{platform}；保护状态：{phase}；运行会话：{running}；已启用计划：{schedules}',
+  'settings.powerBoundary': '这可能增加电池消耗。合盖、手动睡眠、休眠、关机、低电量或企业策略不在保证范围内，也不会唤醒已经睡眠的机器。',
+  'settings.powerUnknown': '未知',
+  'settings.powerError': '最近一次电源保护错误：{error}',
   'settings.inherit': '继承',
   'settings.on': '开',
   'settings.off': '关',
@@ -137,9 +147,13 @@ export const en: Record<keyof typeof zh, string> = {
   'board.status.running': 'In Progress',
   'board.status.done': 'Done',
   'board.status.failed': 'Failed',
-  'board.runs': 'runs',
+    'board.runs': 'runs',
+    'board.pending': 'Submitting',
   'board.updated': 'Updated',
   'board.created': 'Created',
+  'board.hostError': 'Host action failed: {error}',
+  'board.retryHost': 'Retry Host connection',
+  'board.hostMeta': 'Host time zone {timeZone} · revision {revision}',
   'new.title': 'Title',
   'new.titlePlaceholder': 'What should be done, in one line',
   'new.description': 'Description',
@@ -209,11 +223,17 @@ export const en: Record<keyof typeof zh, string> = {
   'exec.hint': 'Applied when the task runs: the workspace decides where the execution session lands; the mode composes the session\'s agent preset; the permission is applied through the /permission command. Blank = runtime default.',
   // Plugin settings card (the `settings.plugin.item` seat).
   'settings.title': 'Task Board',
-  'settings.description': 'How the board announces itself in each agent system prompt.',
+  'settings.description': 'Configure the Host task board, agent announcement, and idle-system-sleep protection while work is pending.',
   'settings.enabled': 'Enable the task board',
   'settings.enabledHint': 'When off, the sidebar entry and board view are hidden.',
   'settings.announceToAgent': 'Announce the task board to agents',
   'settings.announceToAgentHint': 'On: every agent system prompt includes a note about this board. Off: no announcement; agents learn about the board only when you mention it.',
+  'settings.preventIdleSleep': 'Prevent idle system sleep',
+  'settings.preventIdleSleepHint': 'Off by default. When enabled, the Host prevents idle system sleep while any DSH session runs, any schedule is enabled, or session state is not yet known. The display may still turn off.',
+  'settings.powerStatus': 'Platform: {platform}; protection: {phase}; running sessions: {running}; enabled schedules: {schedules}',
+  'settings.powerBoundary': 'This may use more battery. Lid close, manual sleep, hibernation, shutdown, low-battery actions, and enterprise policy are outside the guarantee; an already sleeping computer is not woken.',
+  'settings.powerUnknown': 'unknown',
+  'settings.powerError': 'Latest power-protection error: {error}',
   'settings.inherit': 'Inherit',
   'settings.on': 'On',
   'settings.off': 'Off',