@nanmicoder/dsh-agent-teams 0.1.10 → 0.1.12

package/lib/members.js

@@ -318,44 +318,22 @@ export function interruptMember(ctx, captain, childId) {
         ctx.logger.warn(`agent-teams: interrupt of member ${childId} failed: ${String(error)}`);
     }
 }
-/** Resolve one live parent's workspace-scoped retirement index. */
-async function retiredForParent(ctx, parentId, stateDir) {
-    const parent = ctx.agents.get(parentId);
-    return parent === undefined
-        ? new Set()
-        : readRetiredMemberIds(join(parent.session.header.cwd ?? process.cwd(), stateDir));
-}
 /**
  * Install the missing per-child retirement boundary above Harness rc.6.
  *
  * Upstream `interrupt()` deliberately preserves continuable sessions and the
  * upstream seam exposes no targeted forget/retire method. The durable
- * AgentTeams index therefore guards all three public continuation boundaries:
- * retired rows disappear from `list_agents` (children and descendants), and a
- * direct `followup()` is rejected before it can cold-resume the member. Exact
- * ids keep unrelated subagents untouched; transcripts remain in persistence
- * for archived-team review.
+ * AgentTeams index therefore rejects `followup()` before it can cold-resume a
+ * retired member. Catalog rows deliberately remain discoverable: Harness rc.8
+ * uses the direct-child catalog to authorize historical transcript reads and
+ * `openSubagent()`, so filtering those rows would make an archived member's
+ * persisted conversation inaccessible. Exact ids keep unrelated subagents
+ * untouched while the followup boundary still prevents further model turns.
  */
 export function installRetiredMemberGuard(ctx, stateDir) {
     const runtime = ctx.subagents;
     ctx.effect(() => {
-        const listChildren = runtime.listChildren;
-        const listDescendants = runtime.listDescendants;
         const followup = runtime.followup;
-        const guardedChildren = async (parentId, signal) => {
-            const [entries, retired] = await Promise.all([
-                listChildren.call(runtime, parentId, signal),
-                retiredForParent(ctx, parentId, stateDir),
-            ]);
-            return entries.filter(entry => !retired.has(entry.id));
-        };
-        const guardedDescendants = async (rootId, signal) => {
-            const [entries, retired] = await Promise.all([
-                listDescendants.call(runtime, rootId, signal),
-                retiredForParent(ctx, rootId, stateDir),
-            ]);
-            return entries.filter(entry => !retired.has(entry.id));
-        };
         const guardedFollowup = async (parent, childId, content, options) => {
             const retired = await readRetiredMemberIds(join(parent.session.header.cwd ?? process.cwd(), stateDir));
             if (retired.has(childId)) {
@@ -363,36 +341,32 @@ export function installRetiredMemberGuard(ctx, stateDir) {
             }
             return followup.call(runtime, parent, childId, content, options);
         };
-        runtime.listChildren = guardedChildren;
-        runtime.listDescendants = guardedDescendants;
         runtime.followup = guardedFollowup;
         return () => {
-            if (runtime.listChildren === guardedChildren)
-                runtime.listChildren = listChildren;
-            if (runtime.listDescendants === guardedDescendants)
-                runtime.listDescendants = listDescendants;
             if (runtime.followup === guardedFollowup)
                 runtime.followup = followup;
         };
     }, 'agent-teams: retired member guard');
 }
 /**
- * Snapshot each direct continuable child's real driver activity under the
- * captain's session. `listChildren().activity` is only session residency, so
- * live children are refined through the Agent registry exactly like Harness's
- * shipped `list_agents` tool.
- * @param ctx - the plugin context (injects `subagents`).
- * @param captainSessionId - the captain's session id.
- * @returns child id → activity, missing entries are unknown children.
+ * Snapshot the real driver activity for durable member ids.
+ *
+ * The team record is the membership authority, so this path intentionally no
+ * longer depends on `listChildren()`'s versioned projection shape. Harness
+ * rc.8 changed those rows to branded `SessionId` values plus residency-only
+ * `activity`; neither is needed to answer whether the live Agent driver is
+ * running, idle, or absent/ready.
+ * @param ctx - the plugin context (injects `agents`).
+ * @param memberIds - child ids restored from the durable team record.
+ * @returns child id → live activity.
  */
-export async function memberActivity(ctx, captainSessionId) {
-    const entries = await ctx.subagents.listChildren(brandedSessionId(captainSessionId));
+export function memberActivity(ctx, memberIds) {
     const activity = new Map();
-    for (const entry of entries) {
-        if (entry.kind !== 'child')
+    for (const id of memberIds) {
+        if (id === '')
             continue;
-        const live = ctx.agents.get(entry.id);
-        activity.set(entry.id, live === undefined ? 'ready' : live.status);
+        const live = ctx.agents.get(brandedSessionId(id));
+        activity.set(id, live === undefined ? 'ready' : live.status);
     }
     return activity;
 }

package/lib/snapshot.js

@@ -9,6 +9,7 @@
  */
 import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
+import { memberActivity } from "./members.js";
 import { CAPTAIN_KEY, listArchivedTeamIds, readArchivedTeam, readUnreadMailbox, readTeam, taskDepthsById, taskVisualState, } from "./state.js";
 /** The current task of a member: its first unfinished owned task. */
 function currentTaskOf(memberName, tasks) {
@@ -32,21 +33,9 @@ export async function assembleTeamSnapshot(ctx, stateRoot, workspace, state, opt
     const roster = options.includeRemoved === true
         ? state.members
         : state.members.filter((member) => member.status !== 'removed');
-    const activity = new Map();
-    if (options.historic !== true) {
-        try {
-            const children = await ctx.subagents.listChildren(state.captainSessionId);
-            for (const entry of children) {
-                if (entry.kind === 'child') {
-                    const live = ctx.agents.get(entry.id);
-                    activity.set(entry.id, live === undefined ? 'ready' : live.status);
-                }
-            }
-        }
-        catch (error) {
-            ctx.logger.warn(`agent-teams: activity listing failed for ${state.name}: ${String(error)}`);
-        }
-    }
+    const activity = options.historic === true
+        ? new Map()
+        : memberActivity(ctx, roster.map((member) => member.id));
     const unreadByMember = new Map();
     for (const member of roster) {
         try {

package/lib/tools.js

@@ -871,7 +871,7 @@ export function registerAgentTeamsTools(ctx, config) {
                 await scheduler.kickTeam(workspace, located.id, caller);
             }
             const { team, identity } = await withTeamLock(teamLockKey(stateRoot, located.id), () => requireFreshParticipant(stateRoot, located.id, caller.id));
-            const activity = await memberActivity(ctx, team.captainSessionId);
+            const activity = memberActivity(ctx, team.members.map((member) => member.id));
             const members = team.members
                 .filter((member) => member.status !== 'removed')
                 .map((member) => ({

package/lib/types/client/ActivityPanel.d.ts

@@ -16,12 +16,14 @@
  * always-available monitor.
  * @module dsh-agent-teams/client/activity
  */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
 /** The top-right activity floater. Teams follow the current session: live
  * snapshots and historic card summaries are only shown while their captain
  * session is the one currently open. */
-export declare function ActivityPanel({ sessionsList, openSession }: {
+export type ActivityPanelProps = {
     readonly sessionsList: ObservableSnapshot<SessionListState>;
-    readonly openSession: (id: SessionId) => void;
-}): import("react").JSX.Element | null;
+    readonly openMember: (parentId: SessionId, childId: SessionId) => void;
+} & PropsLocale<'agentTeams'>;
+export declare function ActivityPanel({ sessionsList, openMember, t }: ActivityPanelProps): import("react").JSX.Element | null;

package/lib/types/client/AgentTeamsCard.d.ts

@@ -15,9 +15,9 @@ import type { SessionId } from '@deepseek-ai/dsh-session/types';
 export declare const OPEN_PANEL_EVENT = "agent-teams:open-panel";
 /** Navigation action injected from the plugin's own SessionsService access. */
 export interface AgentTeamsCardInjected {
-    readonly openSession: (id: SessionId) => void;
+    readonly openMember: (parentId: SessionId, childId: SessionId) => void;
 }
 /** Complete keyed Chat renderer props. */
 export type AgentTeamsCardProps = PropsRuntime<'conversation.chat.node', 'agent-teams'> & PropsLocale<'agentTeams'> & AgentTeamsCardInjected;
 /** Render one durable team as a compact conversation card. */
-export declare function AgentTeamsCard({ node, openSession, sessionId }: AgentTeamsCardProps): import("react").JSX.Element;
+export declare function AgentTeamsCard({ node, openMember, sessionId, t }: AgentTeamsCardProps): import("react").JSX.Element;

package/lib/types/client/activity-monitor.d.ts

@@ -79,6 +79,12 @@ interface ActivityFetchResponse {
 }
 /** Injectable browser primitives used by the poll controller and its tests. */
 export interface ActivityPollingRuntime {
+    /**
+     * Current captain session to discover after a cold client/host restart.
+     * This one-time scope restores teams whose older conversation log has no
+     * AgentTeams card capable of registering an explicit monitor target.
+     */
+    readonly discoverySessionId?: string;
     readonly fetchState?: (url: string, init: {
         readonly cache: 'no-store';
         readonly signal: AbortSignal;
@@ -98,9 +104,13 @@ export interface ActivityPollingController {
 /**
  * Start the single polling loop for the current session's requested targets.
  *
- * With no targets this is deliberately inert: installing the plugin must not
- * touch the state route. Live state is polled at the normal cadence; archive
- * state is fetched only as a one-time fallback for targets no longer live.
+ * With neither targets nor a discovery session this is deliberately inert.
+ * A discovery session performs one live+archive pass after selection/restart;
+ * it keeps polling only while that captain still owns a live team. This
+ * restores legacy/cardless history without turning every ordinary session
+ * into a permanent one-second filesystem scan. Explicit card targets retain
+ * the normal cadence, and archive state is refreshed when a target or a
+ * previously discovered live team disappears.
  */
 export declare function startActivityPolling(monitorTargets: readonly ActivityMonitorTarget[], runtime?: ActivityPollingRuntime): ActivityPollingController;
 export {};

package/lib/types/client/index.d.ts

@@ -1,6 +1,13 @@
 /** Browser plugin for the AgentTeams activity floater and conversation card. */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-/** Required services: conversation nodes, slots, and sessions navigation. */
+import { type AgentTeamsLocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** AgentTeams conversation card and activity monitor copy. */
+        agentTeams: AgentTeamsLocaleKey;
+    }
+}
+/** Required services: conversation nodes, slots, sessions navigation, and locale. */
 export declare const inject: string[];
 /**
  * Register the activity monitor in the shell's additive overlay and the

package/lib/types/client/locales.d.ts

@@ -0,0 +1,169 @@
+/** `agentTeams` namespace dictionaries for every plugin-owned Web surface. */
+/** Dictionary namespace owned by the AgentTeams client plugin. */
+export declare const AGENT_TEAMS_LOCALE_NAMESPACE = "agentTeams";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'card.memberCount': string;
+    'action.openActivityPanel': string;
+    'activity.panelButton': string;
+    'activity.badgeAria': string;
+    'activity.panelAria': string;
+    'activity.title': string;
+    'activity.float': string;
+    'activity.dockRight': string;
+    'activity.collapse': string;
+    'activity.empty': string;
+    'format.listSeparator': string;
+    'task.status.pending': string;
+    'task.status.claimed': string;
+    'task.status.inProgress': string;
+    'task.status.completed': string;
+    'task.status.failed': string;
+    'task.status.cancelled': string;
+    'member.state.working': string;
+    'member.state.failed': string;
+    'member.state.waiting': string;
+    'member.state.delivered': string;
+    'member.state.left': string;
+    'member.state.removed': string;
+    'member.state.pending': string;
+    'member.state.unassigned': string;
+    'member.status.executing': string;
+    'member.status.working': string;
+    'member.status.waitingOn': string;
+    'member.status.waitingPrerequisite': string;
+    'member.status.waitingAssignment': string;
+    'member.status.delivered': string;
+    'member.status.idle': string;
+    'member.status.unknown': string;
+    'task.assignee.unclaimed': string;
+    'task.summary.waitingBreakdown': string;
+    'task.summary.allDelivered': string;
+    'task.summary.blockedAndRunning': string;
+    'task.summary.more': string;
+    'task.summary.running': string;
+    'task.summary.ready': string;
+    'task.summary.blocked': string;
+    'task.summary.waitingSchedule': string;
+    'progress.aria': string;
+    'progress.title': string;
+    'progress.running': string;
+    'progress.blocked': string;
+    'progress.delivered': string;
+    'dependency.aria': string;
+    'dependency.parallel': string;
+    'dependency.title': string;
+    'dependency.hint.parallel': string;
+    'dependency.hint.chain': string;
+    'dependency.hint.pinned': string;
+    'task.runningAria': string;
+    'task.detail.completed': string;
+    'task.detail.noPrerequisite': string;
+    'task.detail.ready': string;
+    'task.detail.waitingOn': string;
+    'task.detail.noDownstream': string;
+    'task.detail.unlocks': string;
+    'team.ended': string;
+    'team.stats.members': string;
+    'team.stats.completed': string;
+    'team.stats.messages': string;
+    'delegation.aria': string;
+    'captain.name': string;
+    'captain.role': string;
+    'captain.summary': string;
+    'captain.state.working': string;
+    'captain.state.collected': string;
+    'captain.state.waiting': string;
+    'members.toggle': string;
+    'members.collapse': string;
+    'members.expand': string;
+    'members.empty': string;
+    'assignment.label': string;
+    'assignment.empty': string;
+    'archive.label': string;
+};
+/** AgentTeams namespace key union. */
+export type AgentTeamsLocaleKey = keyof typeof zh;
+/** English dictionary, checked complete against the Chinese source key set. */
+export declare const en: {
+    'card.memberCount': string;
+    'action.openActivityPanel': string;
+    'activity.panelButton': string;
+    'activity.badgeAria': string;
+    'activity.panelAria': string;
+    'activity.title': string;
+    'activity.float': string;
+    'activity.dockRight': string;
+    'activity.collapse': string;
+    'activity.empty': string;
+    'format.listSeparator': string;
+    'task.status.pending': string;
+    'task.status.claimed': string;
+    'task.status.inProgress': string;
+    'task.status.completed': string;
+    'task.status.failed': string;
+    'task.status.cancelled': string;
+    'member.state.working': string;
+    'member.state.failed': string;
+    'member.state.waiting': string;
+    'member.state.delivered': string;
+    'member.state.left': string;
+    'member.state.removed': string;
+    'member.state.pending': string;
+    'member.state.unassigned': string;
+    'member.status.executing': string;
+    'member.status.working': string;
+    'member.status.waitingOn': string;
+    'member.status.waitingPrerequisite': string;
+    'member.status.waitingAssignment': string;
+    'member.status.delivered': string;
+    'member.status.idle': string;
+    'member.status.unknown': string;
+    'task.assignee.unclaimed': string;
+    'task.summary.waitingBreakdown': string;
+    'task.summary.allDelivered': string;
+    'task.summary.blockedAndRunning': string;
+    'task.summary.more': string;
+    'task.summary.running': string;
+    'task.summary.ready': string;
+    'task.summary.blocked': string;
+    'task.summary.waitingSchedule': string;
+    'progress.aria': string;
+    'progress.title': string;
+    'progress.running': string;
+    'progress.blocked': string;
+    'progress.delivered': string;
+    'dependency.aria': string;
+    'dependency.parallel': string;
+    'dependency.title': string;
+    'dependency.hint.parallel': string;
+    'dependency.hint.chain': string;
+    'dependency.hint.pinned': string;
+    'task.runningAria': string;
+    'task.detail.completed': string;
+    'task.detail.noPrerequisite': string;
+    'task.detail.ready': string;
+    'task.detail.waitingOn': string;
+    'task.detail.noDownstream': string;
+    'task.detail.unlocks': string;
+    'team.ended': string;
+    'team.stats.members': string;
+    'team.stats.completed': string;
+    'team.stats.messages': string;
+    'delegation.aria': string;
+    'captain.name': string;
+    'captain.role': string;
+    'captain.summary': string;
+    'captain.state.working': string;
+    'captain.state.collected': string;
+    'captain.state.waiting': string;
+    'members.toggle': string;
+    'members.collapse': string;
+    'members.expand': string;
+    'members.empty': string;
+    'assignment.label': string;
+    'assignment.empty': string;
+    'archive.label': string;
+};
+/** Translation function consumed by pure view helpers. */
+export type AgentTeamsTranslate = (key: AgentTeamsLocaleKey, params?: Record<string, unknown>) => string;

package/lib/types/client/session-navigation.d.ts

@@ -0,0 +1,22 @@
+/** Version-tolerant navigation into durable AgentTeams member transcripts. */
+import type { SessionId, SubagentAddress } from '@deepseek-ai/dsh-client-runtime/client';
+/** Narrow sessions-service face used by the activity panel and team card. */
+export interface AgentTeamsSessionNavigator {
+    /** Legacy/ordinary session navigation. */
+    open(id: SessionId): void;
+    /** rc.8 addressed subagent navigation. */
+    openSubagent?(address: SubagentAddress): void;
+    /** Refresh the exact parent's durable direct-child catalog. */
+    refreshSubagents?(parentSessionId: SessionId): Promise<void>;
+    /** Reuse an address already retained by the client runtime when available. */
+    subagentAddress?(id: SessionId): SubagentAddress | undefined;
+}
+/**
+ * Open one member's persisted transcript.
+ *
+ * Harness rc.8 intentionally removed cold subagents from the ordinary session
+ * list. They must first be rediscovered in their parent's catalog, then opened
+ * with the exact parent/child/mode address. Older runtimes have only `open()`;
+ * the fallback preserves the plugin's rc.6 peer range.
+ */
+export declare function openAgentTeamMember(sessions: AgentTeamsSessionNavigator, parentSessionId: SessionId, childSessionId: SessionId): Promise<'subagent' | 'session'>;

package/lib/types/members.d.ts

@@ -123,20 +123,24 @@ export declare function interruptMember(ctx: Context, captain: Agent, childId: s
  *
  * Upstream `interrupt()` deliberately preserves continuable sessions and the
  * upstream seam exposes no targeted forget/retire method. The durable
- * AgentTeams index therefore guards all three public continuation boundaries:
- * retired rows disappear from `list_agents` (children and descendants), and a
- * direct `followup()` is rejected before it can cold-resume the member. Exact
- * ids keep unrelated subagents untouched; transcripts remain in persistence
- * for archived-team review.
+ * AgentTeams index therefore rejects `followup()` before it can cold-resume a
+ * retired member. Catalog rows deliberately remain discoverable: Harness rc.8
+ * uses the direct-child catalog to authorize historical transcript reads and
+ * `openSubagent()`, so filtering those rows would make an archived member's
+ * persisted conversation inaccessible. Exact ids keep unrelated subagents
+ * untouched while the followup boundary still prevents further model turns.
  */
 export declare function installRetiredMemberGuard(ctx: Context, stateDir: string): void;
 /**
- * Snapshot each direct continuable child's real driver activity under the
- * captain's session. `listChildren().activity` is only session residency, so
- * live children are refined through the Agent registry exactly like Harness's
- * shipped `list_agents` tool.
- * @param ctx - the plugin context (injects `subagents`).
- * @param captainSessionId - the captain's session id.
- * @returns child id → activity, missing entries are unknown children.
+ * Snapshot the real driver activity for durable member ids.
+ *
+ * The team record is the membership authority, so this path intentionally no
+ * longer depends on `listChildren()`'s versioned projection shape. Harness
+ * rc.8 changed those rows to branded `SessionId` values plus residency-only
+ * `activity`; neither is needed to answer whether the live Agent driver is
+ * running, idle, or absent/ready.
+ * @param ctx - the plugin context (injects `agents`).
+ * @param memberIds - child ids restored from the durable team record.
+ * @returns child id → live activity.
  */
-export declare function memberActivity(ctx: Context, captainSessionId: string): Promise<Map<string, 'running' | 'idle' | 'ready'>>;
+export declare function memberActivity(ctx: Context, memberIds: readonly string[]): Map<string, 'running' | 'idle' | 'ready'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "AgentTeams for DeepSeek Harness: multi-agent team collaboration (captain, members, tasks with dependencies, messaging) driven by natural language, with a tree monitor in the web GUI",
   "type": "module",
   "main": "lib/index.js",

package/release-notes/v0.1.11.md

@@ -0,0 +1,52 @@
+# AgentTeams v0.1.11
+
+This release restores AgentTeams activity and member history after a DeepSeek Harness client or host restart. It fixes the rc.8 compatibility regressions reported in [#60](https://github.com/NanmiCoder/dsh-agent-teams/issues/60) and [#61](https://github.com/NanmiCoder/dsh-agent-teams/issues/61).
+
+## Fixes
+
+- **Cold-start activity recovery**: selecting a captain session now performs a lightweight live and archived team discovery pass, so older sessions without an AgentTeams conversation card restore their activity panel after restart.
+- **Reliable member activity**: live `running / idle / ready` state is resolved from the durable team roster and Agent registry instead of depending on the versioned `listChildren()` projection shape.
+- **Persistent member history**: retired AgentTeams members remain discoverable in the Harness subagent catalog for transcript review while direct follow-up remains blocked.
+- **rc.8 transcript navigation**: activity-panel and conversation-card member links refresh the parent catalog and use addressed `openSubagent()` navigation, with a fallback for older Harness runtimes.
+
+## Verification
+
+- Reproduced the full captain/member/task/archive lifecycle in a real `/tmp` workspace on the Harness web client.
+- Verified cold restart recovery without opening the built-in subagent catalog first.
+- Verified archived member navigation and complete persisted task history.
+- Passed type checking, production build, offline verification, lifecycle verification, and the eight-member complex stress suite.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.11
+
+本次更新修复 DeepSeek Harness 客户端或 host 重启后 AgentTeams 活动面板与成员历史消失的问题，对应 [#60](https://github.com/NanmiCoder/dsh-agent-teams/issues/60) 和 [#61](https://github.com/NanmiCoder/dsh-agent-teams/issues/61) 中报告的 rc.8 兼容性回归。
+
+## 修复
+
+- **冷启动活动恢复**：选择队长会话时会执行一次轻量的活动团队与历史归档发现；即使旧会话没有 AgentTeams 对话卡片，重启后也能恢复活动面板。
+- **可靠的成员活动状态**：从持久化团队成员表和 Agent registry 解析真实的 `running / idle / ready`，不再依赖容易变化的 `listChildren()` 投影结构。
+- **成员历史持续可见**：已退休的 AgentTeams 成员继续保留在 Harness 子代理目录中供历史记录查看，但直接 follow-up 仍会被拒绝。
+- **rc.8 历史会话导航**：活动面板和对话卡片会先刷新父级目录，再通过带父子地址的 `openSubagent()` 打开成员记录；旧版 Harness 继续使用兼容回退。
+
+## 验证
+
+- 在 Harness Web 客户端的真实 `/tmp` workspace 中完成队长、成员、任务和归档全流程复现。
+- 验证未预先打开内置子代理目录时的冷重启恢复。
+- 验证归档成员导航及完整持久化任务历史。
+- 通过类型检查、生产构建、离线验证、生命周期验证及八成员复杂压力测试。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>

package/release-notes/v0.1.12.md

@@ -0,0 +1,54 @@
+# AgentTeams v0.1.12
+
+This release adds host-native English and Simplified Chinese localization to the AgentTeams Web UI.
+
+## New & Improved
+
+- **Official Harness locale integration**: the plugin registers its own `agentTeams` namespace with the Harness locale service instead of inspecting or rewriting host DOM.
+- **Complete localized Web surfaces**: the conversation card and activity panel now translate task and member states, dynamic summaries, progress labels, dependency guidance, archive markers, controls, and accessibility text.
+- **Live language switching**: changing the Harness language updates the active AgentTeams card and panel immediately without a page reload or a separate plugin setting.
+- **Consistent fallback behavior**: English remains the fallback for missing locale entries, and dictionary keys and placeholders are verified as a release contract.
+
+The `/agent-teams` slash-command description and input hint remain stable English metadata because the current Harness command protocol does not expose a locale namespace.
+
+## Verification
+
+- Ran a real DeepSeek API workflow in an isolated `/tmp` Git project with one captain, two members, two dependent tasks, durable messaging, generated artifacts, and a successful project verification command.
+- Verified English → Chinese → English live switching in the real Harness Web UI, including panel folding, dock/floating mode, task dependencies, and member transcript navigation.
+- Passed type checking, production build, offline verification, lifecycle verification, the eight-member complex stress suite, and the Skill mirror check.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.12
+
+本次更新为 AgentTeams Web UI 增加基于宿主官方能力的简体中文与英文多语言支持。
+
+## 新增与改进
+
+- **接入 Harness 官方多语言服务**：插件注册独立的 `agentTeams` 命名空间，不读取或改写宿主 DOM。
+- **完整覆盖 Web 界面**：对话卡片与活动面板中的任务/成员状态、动态摘要、进度、依赖提示、归档标识、操作按钮及无障碍文案均已适配。
+- **语言实时切换**：修改 Harness 语言后，当前 AgentTeams 卡片和面板无需刷新即可同步更新，也不需要插件自己的语言设置。
+- **稳定回退与发布校验**：缺失文案按官方机制回退到英文，发布验证会检查中英文字典的键和模板参数保持一致。
+
+由于当前 Harness 命令协议尚未提供 locale namespace，`/agent-teams` 在 slash 菜单中的描述和输入提示暂时保留稳定的英文元数据。
+
+## 验证
+
+- 在隔离的 `/tmp` Git 项目中使用真实 DeepSeek API 完成队长、两名成员、两个依赖任务、持久消息、真实产物及项目校验的完整链路。
+- 在真实 Harness Web UI 中验证英文 → 中文 → 英文实时切换，以及面板收起、停靠/浮动、任务依赖和成员记录跳转。
+- 通过类型检查、生产构建、离线验证、生命周期验证、八成员复杂压力测试及 Skill 镜像检查。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>