@qnote/q-ai-note 1.0.12 → 1.0.14

package/dist/web/app.js

@@ -1,6 +1,7 @@
 import { API_BASE, apiRequest, escapeHtml, safeText, appendLoadingMessage, setButtonState } from './shared.js';
 import { renderChatEntry } from './chatView.js';
 import { mountSandboxGrid, mountHtmlList, mountDiaryTimeline, mountWorkTree } from './vueRenderers.js';
+import { createAserRuntimeView } from './aserRuntimeView.js';
 
 const state = {
   sandboxes: [],
@@ -36,8 +37,12 @@ const state = {
   workTreeViewMode: 'full',
   workItemElementPreviewMode: 'none',
   workItemShowAssignee: false,
+  sandboxSortMode: 'created_asc',
   workItemSearch: '',
   workItemStatusFilter: 'all',
+  taskBoardPeriod: 'week',
+  taskBoardOwnerName: '',
+  taskBoardData: null,
   diarySearch: '',
   diarySandboxFilter: '',
   diaryProcessedFilter: 'all',
@@ -46,6 +51,16 @@ const state = {
   changesTypeFilter: 'all',
   changesQuickFilter: 'all',
   workTreeExpandInitialized: false,
+  agentClub: [],
+  teams: [],
+  aserProjectTeamAssignments: {},
+  opencodeRunnerProjects: [],
+  opencodeRunnerSelectedProjectId: '',
+  opencodeRunnerSelectedTeamId: '',
+  opencodeRunnerTasks: [],
+  opencodeRunnerTimeline: [],
+  opencodeRunnerRunning: false,
+  opencodeRunnerPlanned: false,
 };
 
 const expandedNodes = new Set();
@@ -53,8 +68,14 @@ let quickChatPopover = null;
 let sandboxActionHandler = null;
 let sandboxEscLocked = false;
 let resizeRenderTimer = null;
+let aserRuntimeView = null;
 const WORK_ITEM_SHOW_ASSIGNEE_STORAGE_KEY = 'q-ai-note.work-item.show-assignee';
 const WORK_TREE_VIEW_MODE_STORAGE_KEY = 'q-ai-note.work-tree.view-mode';
+const SANDBOX_SORT_MODE_STORAGE_KEY = 'q-ai-note.sandbox.sort-mode';
+const TASK_BOARD_OWNER_STORAGE_KEY = 'q-ai-note.task-board.owner-name';
+const AGENT_CLUB_STORAGE_KEY = 'q-ai-note.ai-engineering.agent-club';
+const TEAMS_STORAGE_KEY = 'q-ai-note.ai-engineering.teams';
+const ASER_PROJECT_TEAM_ASSIGNMENTS_STORAGE_KEY = 'q-ai-note.ai-engineering.aser-project-team-assignments';
 
 function loadWorkItemAssigneePreference() {
   try {
@@ -96,6 +117,558 @@ function persistWorkTreeViewModePreference() {
   }
 }
 
+function loadSandboxSortModePreference() {
+  try {
+    const raw = String(window.localStorage.getItem(SANDBOX_SORT_MODE_STORAGE_KEY) || '').trim();
+    if (!raw) return;
+    if (raw === 'created_asc' || raw === 'created_desc' || raw === 'updated_desc' || raw === 'name_asc') {
+      state.sandboxSortMode = raw;
+    }
+  } catch {
+    // Ignore storage failures in restricted environments.
+  }
+}
+
+function persistSandboxSortModePreference() {
+  try {
+    window.localStorage.setItem(SANDBOX_SORT_MODE_STORAGE_KEY, state.sandboxSortMode || 'created_asc');
+  } catch {
+    // Ignore storage failures in restricted environments.
+  }
+}
+
+function loadTaskBoardOwnerNamePreference() {
+  try {
+    state.taskBoardOwnerName = String(window.localStorage.getItem(TASK_BOARD_OWNER_STORAGE_KEY) || '').trim();
+  } catch {
+    state.taskBoardOwnerName = '';
+  }
+}
+
+function persistTaskBoardOwnerNamePreference() {
+  try {
+    window.localStorage.setItem(TASK_BOARD_OWNER_STORAGE_KEY, state.taskBoardOwnerName || '');
+  } catch {
+    // Ignore storage failures in restricted environments.
+  }
+}
+
+function safeParseJson(rawValue, fallback) {
+  if (!rawValue) return fallback;
+  try {
+    return JSON.parse(rawValue);
+  } catch {
+    return fallback;
+  }
+}
+
+function parseLineList(rawValue) {
+  return String(rawValue || '')
+    .split('\n')
+    .map((value) => value.trim())
+    .filter(Boolean);
+}
+
+function parseSkillRows(rawValue) {
+  return parseLineList(rawValue).map((row) => {
+    const [skillPart, levelPart = ''] = row.split(':');
+    const skill = String(skillPart || '').trim();
+    const level = String(levelPart || '').trim();
+    return {
+      skill,
+      level: level || 'intermediate',
+    };
+  }).filter((row) => Boolean(row.skill));
+}
+
+function normalizeAgentRecord(rawAgent = {}) {
+  const id = String(rawAgent.id || '').trim() || `agent-${Date.now()}-${Math.floor(Math.random() * 1000)}`;
+  const roleType = String(rawAgent.role_type || rawAgent.role || '').trim() || 'generalist';
+  const legacySkill = String(rawAgent.skill || '').trim();
+  const rawSkills = Array.isArray(rawAgent.skills) ? rawAgent.skills : [];
+  const parsedSkills = rawSkills
+    .map((row) => {
+      if (!row || typeof row !== 'object') return null;
+      const skill = String(row.skill || '').trim();
+      const level = String(row.level || '').trim() || 'intermediate';
+      if (!skill) return null;
+      return { skill, level };
+    })
+    .filter(Boolean);
+  return {
+    id,
+    name: String(rawAgent.name || '').trim() || id,
+    role: roleType,
+    role_type: roleType,
+    knowledge_background: Array.isArray(rawAgent.knowledge_background)
+      ? rawAgent.knowledge_background.map((row) => String(row || '').trim()).filter(Boolean)
+      : [],
+    skills: parsedSkills.length ? parsedSkills : (legacySkill ? [{ skill: legacySkill, level: 'intermediate' }] : []),
+    task_types: Array.isArray(rawAgent.task_types)
+      ? rawAgent.task_types.map((row) => String(row || '').trim()).filter(Boolean)
+      : [],
+    deliverables: Array.isArray(rawAgent.deliverables)
+      ? rawAgent.deliverables.map((row) => String(row || '').trim()).filter(Boolean)
+      : [],
+    raci_default: String(rawAgent.raci_default || '').trim(),
+    quality_criteria: Array.isArray(rawAgent.quality_criteria)
+      ? rawAgent.quality_criteria.map((row) => String(row || '').trim()).filter(Boolean)
+      : [],
+    risk_limits: Array.isArray(rawAgent.risk_limits)
+      ? rawAgent.risk_limits.map((row) => String(row || '').trim()).filter(Boolean)
+      : [],
+    created_at: String(rawAgent.created_at || new Date().toISOString()),
+  };
+}
+
+function normalizeTeamRecord(rawTeam = {}) {
+  const id = String(rawTeam.id || '').trim() || `team-${Date.now()}-${Math.floor(Math.random() * 1000)}`;
+  const agentIds = Array.isArray(rawTeam.agent_ids) ? rawTeam.agent_ids.map((idValue) => String(idValue || '').trim()).filter(Boolean) : [];
+  return {
+    id,
+    name: String(rawTeam.name || '').trim() || id,
+    agent_ids: Array.from(new Set(agentIds)),
+    created_at: String(rawTeam.created_at || new Date().toISOString()),
+  };
+}
+
+function loadAiEngineeringState() {
+  try {
+    const rawAgentClub = window.localStorage.getItem(AGENT_CLUB_STORAGE_KEY);
+    const rawTeams = window.localStorage.getItem(TEAMS_STORAGE_KEY);
+    const rawAssignments = window.localStorage.getItem(ASER_PROJECT_TEAM_ASSIGNMENTS_STORAGE_KEY);
+    const parsedAgentClub = safeParseJson(rawAgentClub, []);
+    const parsedTeams = safeParseJson(rawTeams, []);
+    const parsedAssignments = safeParseJson(rawAssignments, {});
+    state.agentClub = Array.isArray(parsedAgentClub) ? parsedAgentClub.map((row) => normalizeAgentRecord(row)) : [];
+    state.teams = Array.isArray(parsedTeams) ? parsedTeams.map((row) => normalizeTeamRecord(row)) : [];
+    state.aserProjectTeamAssignments = parsedAssignments && typeof parsedAssignments === 'object' ? parsedAssignments : {};
+  } catch {
+    state.agentClub = [];
+    state.teams = [];
+    state.aserProjectTeamAssignments = {};
+  }
+}
+
+function persistAiEngineeringState() {
+  try {
+    window.localStorage.setItem(AGENT_CLUB_STORAGE_KEY, JSON.stringify(state.agentClub));
+    window.localStorage.setItem(TEAMS_STORAGE_KEY, JSON.stringify(state.teams));
+    window.localStorage.setItem(
+      ASER_PROJECT_TEAM_ASSIGNMENTS_STORAGE_KEY,
+      JSON.stringify(state.aserProjectTeamAssignments || {}),
+    );
+  } catch {
+    // Ignore storage failures in restricted environments.
+  }
+}
+
+function getAgentNameById(agentId) {
+  const id = String(agentId || '').trim();
+  const row = state.agentClub.find((agent) => String(agent.id) === id);
+  if (!row) return id || '-';
+  return `${row.name} (${row.role})`;
+}
+
+function renderAgentClub() {
+  const list = document.getElementById('agent-club-list');
+  if (!(list instanceof HTMLElement)) return;
+  if (!state.agentClub.length) {
+    list.innerHTML = '<div class="aser-empty">暂无 Agent，可先创建。</div>';
+    return;
+  }
+  list.innerHTML = state.agentClub
+    .map((agent) => {
+      const knowledgeText = Array.isArray(agent.knowledge_background) && agent.knowledge_background.length
+        ? agent.knowledge_background.join('；')
+        : '-';
+      const skillsText = Array.isArray(agent.skills) && agent.skills.length
+        ? agent.skills.map((row) => `${row.skill}(${row.level})`).join('；')
+        : '-';
+      const taskTypesText = Array.isArray(agent.task_types) && agent.task_types.length ? agent.task_types.join('；') : '-';
+      const deliverablesText = Array.isArray(agent.deliverables) && agent.deliverables.length ? agent.deliverables.join('；') : '-';
+      const qualityText = Array.isArray(agent.quality_criteria) && agent.quality_criteria.length ? agent.quality_criteria.join('；') : '-';
+      const riskText = Array.isArray(agent.risk_limits) && agent.risk_limits.length ? agent.risk_limits.join('；') : '-';
+      return `
+        <article class="aser-project-item">
+          <div>
+            <strong>${escapeHtml(agent.name)}</strong>
+            <div class="aser-project-id">${escapeHtml(agent.id)}</div>
+            <div class="aser-meta-item">角色：${escapeHtml(agent.role_type || agent.role || 'generalist')}</div>
+            <div class="aser-meta-item">知识背景：${escapeHtml(knowledgeText)}</div>
+            <div class="aser-meta-item">技能：${escapeHtml(skillsText)}</div>
+            <div class="aser-meta-item">任务类型：${escapeHtml(taskTypesText)}</div>
+            <div class="aser-meta-item">产物类型：${escapeHtml(deliverablesText)}</div>
+            <div class="aser-meta-item">RACI：${escapeHtml(agent.raci_default || '-')}</div>
+            <div class="aser-meta-item">质量标准：${escapeHtml(qualityText)}</div>
+            <div class="aser-meta-item">风险边界：${escapeHtml(riskText)}</div>
+          </div>
+          <button class="btn btn-secondary btn-sm" type="button" data-agent-delete-id="${escapeHtml(agent.id)}">删除</button>
+        </article>
+      `;
+    })
+    .join('');
+}
+
+function renderTeams() {
+  renderTeamAgentSelector();
+  const list = document.getElementById('teams-list');
+  if (!(list instanceof HTMLElement)) return;
+  if (!state.teams.length) {
+    list.innerHTML = '<div class="aser-empty">暂无 Team，可先创建。</div>';
+    return;
+  }
+  list.innerHTML = state.teams
+    .map((team) => {
+      const memberText = team.agent_ids.length ? team.agent_ids.map((id) => escapeHtml(getAgentNameById(id))).join('，') : '无成员';
+      return `
+        <article class="aser-project-item">
+          <div>
+            <strong>${escapeHtml(team.name)}</strong>
+            <div class="aser-project-id">${escapeHtml(team.id)}</div>
+            <div class="aser-meta-item">成员：${memberText}</div>
+          </div>
+          <button class="btn btn-secondary btn-sm" type="button" data-team-delete-id="${escapeHtml(team.id)}">删除</button>
+        </article>
+      `;
+    })
+    .join('');
+}
+
+function renderTeamAgentSelector() {
+  const select = document.getElementById('teams-agent-select');
+  if (!(select instanceof HTMLSelectElement)) return;
+  if (!state.agentClub.length) {
+    select.innerHTML = '<option value="" disabled>暂无 Agent，请先到 Agent Club 创建</option>';
+    return;
+  }
+  select.innerHTML = state.agentClub
+    .map((agent) => `<option value="${escapeHtml(agent.id)}">${escapeHtml(agent.name)} (${escapeHtml(agent.role)})</option>`)
+    .join('');
+}
+
+function assignAserProjectTeam(projectId, teamId) {
+  const pid = String(projectId || '').trim();
+  if (!pid) return;
+  const normalizedTeamId = String(teamId || '').trim();
+  if (normalizedTeamId) {
+    state.aserProjectTeamAssignments[pid] = normalizedTeamId;
+  } else {
+    delete state.aserProjectTeamAssignments[pid];
+  }
+  persistAiEngineeringState();
+  renderOpenCodeRunner();
+}
+
+function formatLocalTime(value) {
+  if (!value) return '-';
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return String(value);
+  return date.toLocaleString();
+}
+
+function getTeamById(teamId) {
+  const id = String(teamId || '').trim();
+  if (!id) return null;
+  return state.teams.find((team) => String(team.id) === id) || null;
+}
+
+function getAssignedTeamIdForProject(projectId) {
+  const pid = String(projectId || '').trim();
+  if (!pid) return '';
+  return String(state.aserProjectTeamAssignments?.[pid] || '').trim();
+}
+
+function appendRunnerTimeline(row = {}) {
+  state.opencodeRunnerTimeline.unshift({
+    id: `runner-log-${Date.now()}-${Math.floor(Math.random() * 1000)}`,
+    time: new Date().toISOString(),
+    ...row,
+  });
+}
+
+function inferTaskTaxonomy(task, intents) {
+  const intentId = String(task?.intent_id || '').trim();
+  const intent = (Array.isArray(intents) ? intents : []).find((row) => String(row.id) === intentId);
+  return String(intent?.taxonomy || '').trim();
+}
+
+function inferCommunicationDemand(taxonomy) {
+  const value = String(taxonomy || '').trim();
+  if (value === 'clarify_design') return 'clarification';
+  if (value === 'escalate_issue' || value === 'report_issue') return 'escalation';
+  return '';
+}
+
+function getRoleArtifactTemplates(role) {
+  const value = String(role || '').trim();
+  if (value === 'product_manager') return [{ type: 'requirement_doc', summary: '需求分解与验收标准已提交' }];
+  if (value === 'architect') return [{ type: 'design_doc', summary: '系统设计方案与约束说明已提交' }];
+  if (value === 'reviewer') return [{ type: 'review_record', summary: '质量评审记录已提交' }];
+  return [
+    { type: 'pr', summary: '实现代码与变更说明已提交' },
+    { type: 'test_report', summary: '测试报告与通过结论已提交' },
+  ];
+}
+
+function pickAgentForTask(team, task) {
+  const members = Array.isArray(team?.agent_ids) ? team.agent_ids : [];
+  const ownerRole = String(task?.owner_role || '').trim();
+  const exact = members
+    .map((id) => state.agentClub.find((agent) => String(agent.id) === String(id)))
+    .find((agent) => String(agent?.role_type || agent?.role || '').trim() === ownerRole);
+  if (exact) return exact;
+  return members
+    .map((id) => state.agentClub.find((agent) => String(agent.id) === String(id)))
+    .find(Boolean) || null;
+}
+
+async function loadOpenCodeRunnerProjects() {
+  if (!state.pageAccess.sandboxes && !state.fullAccess) return;
+  const projects = await apiRequest(`${API_BASE}/aser-runtime/projects`);
+  state.opencodeRunnerProjects = Array.isArray(projects) ? projects : [];
+  if (!state.opencodeRunnerSelectedProjectId && state.opencodeRunnerProjects.length) {
+    state.opencodeRunnerSelectedProjectId = String(state.opencodeRunnerProjects[0].id || '');
+  }
+  if (state.opencodeRunnerSelectedProjectId
+    && !state.opencodeRunnerProjects.some((project) => String(project.id) === String(state.opencodeRunnerSelectedProjectId))) {
+    state.opencodeRunnerSelectedProjectId = state.opencodeRunnerProjects[0]
+      ? String(state.opencodeRunnerProjects[0].id || '')
+      : '';
+  }
+  const assignedTeamId = getAssignedTeamIdForProject(state.opencodeRunnerSelectedProjectId);
+  state.opencodeRunnerSelectedTeamId = assignedTeamId || state.opencodeRunnerSelectedTeamId || String(state.teams[0]?.id || '');
+}
+
+function renderOpenCodeRunner() {
+  const projectSelect = document.getElementById('opencode-runner-project-select');
+  const teamSelect = document.getElementById('opencode-runner-team-select');
+  const taskList = document.getElementById('opencode-runner-task-list');
+  const timeline = document.getElementById('opencode-runner-timeline');
+  const summary = document.getElementById('opencode-runner-summary');
+  const loadBtn = document.getElementById('opencode-runner-load-btn');
+  const planBtn = document.getElementById('opencode-runner-plan-btn');
+  const startBtn = document.getElementById('opencode-runner-start-btn');
+  if (!(projectSelect instanceof HTMLSelectElement)
+    || !(teamSelect instanceof HTMLSelectElement)
+    || !(taskList instanceof HTMLElement)
+    || !(timeline instanceof HTMLElement)
+    || !(summary instanceof HTMLElement)) {
+    return;
+  }
+
+  if (!state.opencodeRunnerProjects.length) {
+    projectSelect.innerHTML = '<option value="">暂无 ASER Project</option>';
+  } else {
+    projectSelect.innerHTML = state.opencodeRunnerProjects
+      .map((project) => `<option value="${escapeHtml(project.id)}">${escapeHtml(project.name || project.id)}</option>`)
+      .join('');
+    projectSelect.value = String(state.opencodeRunnerSelectedProjectId || state.opencodeRunnerProjects[0].id || '');
+  }
+
+  if (!state.teams.length) {
+    teamSelect.innerHTML = '<option value="">暂无 Team（先在 Teams 页面创建）</option>';
+  } else {
+    teamSelect.innerHTML = state.teams
+      .map((team) => `<option value="${escapeHtml(team.id)}">${escapeHtml(team.name || team.id)}</option>`)
+      .join('');
+    if (!state.opencodeRunnerSelectedTeamId || !state.teams.some((team) => String(team.id) === String(state.opencodeRunnerSelectedTeamId))) {
+      state.opencodeRunnerSelectedTeamId = String(state.teams[0].id || '');
+    }
+    teamSelect.value = state.opencodeRunnerSelectedTeamId;
+  }
+
+  const selectedTeam = getTeamById(state.opencodeRunnerSelectedTeamId);
+  const totalTasks = state.opencodeRunnerTasks.length;
+  const doneTasks = state.opencodeRunnerTasks.filter((row) => ['accepted', 'completed'].includes(String(row.status || ''))).length;
+  const commTasks = state.opencodeRunnerTasks.filter((row) => String(row.communication_demand || '')).length;
+  summary.textContent = `项目 ${state.opencodeRunnerSelectedProjectId || '-'} | Team ${selectedTeam?.name || '-'} | 任务 ${doneTasks}/${totalTasks} 已完成 | 沟通诉求 ${commTasks}`;
+
+  if (!state.opencodeRunnerTasks.length) {
+    taskList.innerHTML = '<div class="aser-empty">点击“获取任务”加载当前 Project 的任务池。</div>';
+  } else {
+    taskList.innerHTML = state.opencodeRunnerTasks
+      .map((task) => `
+        <article class="aser-project-item">
+          <div>
+            <strong>${escapeHtml(task.title || task.id)}</strong>
+            <div class="aser-project-id">${escapeHtml(task.id)}</div>
+            <div class="aser-meta-item">责任角色：${escapeHtml(task.owner_role || '-')} | Agent：${escapeHtml(task.assigned_agent_name || '-')}</div>
+            <div class="aser-meta-item">状态：${escapeHtml(task.status || '-')} | 意图：${escapeHtml(task.taxonomy || '-')}</div>
+            <div class="aser-meta-item">诉求：${escapeHtml(task.communication_demand || '-')}</div>
+          </div>
+        </article>
+      `)
+      .join('');
+  }
+
+  if (!state.opencodeRunnerTimeline.length) {
+    timeline.innerHTML = '<div class="aser-empty">暂无过程日志。</div>';
+  } else {
+    timeline.innerHTML = state.opencodeRunnerTimeline
+      .map((row) => `
+        <article class="aser-chat-task-interaction">
+          <strong>${escapeHtml(row.phase || 'event')}</strong> · ${escapeHtml(formatLocalTime(row.time))}
+          <div>${escapeHtml(row.message || '-')}</div>
+        </article>
+      `)
+      .join('');
+  }
+
+  const writeDisabled = state.readonly || !state.fullAccess;
+  if (loadBtn instanceof HTMLButtonElement) loadBtn.disabled = state.opencodeRunnerRunning;
+  if (planBtn instanceof HTMLButtonElement) planBtn.disabled = state.opencodeRunnerRunning || !state.opencodeRunnerTasks.length;
+  if (startBtn instanceof HTMLButtonElement) {
+    startBtn.disabled = writeDisabled
+      || state.opencodeRunnerRunning
+      || !state.opencodeRunnerTasks.length
+      || !state.opencodeRunnerSelectedTeamId;
+  }
+}
+
+async function loadOpenCodeRunnerTasks() {
+  const projectId = String(state.opencodeRunnerSelectedProjectId || '').trim();
+  if (!projectId) return;
+  const detail = await apiRequest(`${API_BASE}/aser-runtime/projects/${projectId}`);
+  const intents = Array.isArray(detail?.intents) ? detail.intents : [];
+  const selectedTeam = getTeamById(state.opencodeRunnerSelectedTeamId);
+  const tasks = Array.isArray(detail?.tasks) ? detail.tasks : [];
+  state.opencodeRunnerTasks = tasks.map((task) => {
+    const taxonomy = inferTaskTaxonomy(task, intents);
+    const communicationDemand = inferCommunicationDemand(taxonomy);
+    const assigned = pickAgentForTask(selectedTeam, task);
+    return {
+      id: String(task.id || ''),
+      title: String(task.title || ''),
+      owner_role: String(task.owner_role || ''),
+      status: String(task.status || ''),
+      taxonomy,
+      communication_demand: communicationDemand,
+      assigned_agent_id: String(assigned?.id || ''),
+      assigned_agent_name: String(assigned?.name || ''),
+    };
+  });
+  state.opencodeRunnerPlanned = false;
+  appendRunnerTimeline({
+    phase: 'tasks_fetched',
+    message: `已获取任务 ${state.opencodeRunnerTasks.length} 条，准备进入编排。`,
+  });
+  renderOpenCodeRunner();
+}
+
+function planOpenCodeRunnerTasks() {
+  if (!state.opencodeRunnerTasks.length) return;
+  state.opencodeRunnerTasks.forEach((task) => {
+    appendRunnerTimeline({
+      phase: 'dispatch',
+      message: `任务 ${task.title || task.id} -> ${task.owner_role || '-'} / ${task.assigned_agent_name || '-'}`,
+    });
+  });
+  state.opencodeRunnerPlanned = true;
+  renderOpenCodeRunner();
+}
+
+async function startOpenCodeRunner() {
+  const projectId = String(state.opencodeRunnerSelectedProjectId || '').trim();
+  const teamId = String(state.opencodeRunnerSelectedTeamId || '').trim();
+  if (!projectId || !teamId || state.opencodeRunnerRunning) return;
+  const team = getTeamById(teamId);
+  if (!team) return;
+
+  state.opencodeRunnerRunning = true;
+  renderOpenCodeRunner();
+  appendRunnerTimeline({ phase: 'run_start', message: `启动 OpenCode Team Runner，Team=${team.name}` });
+
+  try {
+    for (const task of state.opencodeRunnerTasks) {
+      const status = String(task.status || '');
+      if (status === 'accepted' || status === 'completed') {
+        appendRunnerTimeline({ phase: 'skip', message: `跳过已完成任务：${task.title || task.id}` });
+        continue;
+      }
+      const role = String(task.owner_role || 'developer') || 'developer';
+      appendRunnerTimeline({ phase: 'agent_start', message: `启动 Agent：${task.assigned_agent_name || role}，处理任务 ${task.title || task.id}` });
+
+      const pulled = await apiRequest(`${API_BASE}/aser-runtime/projects/${projectId}/pull-task?role=${encodeURIComponent(role)}`);
+      const pulledTaskId = String(pulled?.task?.id || '');
+      if (!pulledTaskId) {
+        appendRunnerTimeline({ phase: 'blocked', message: `角色 ${role} 当前无可拉取任务，等待调度。` });
+        continue;
+      }
+
+      const artifacts = getRoleArtifactTemplates(role).map((row, index) => ({
+        type: row.type,
+        uri: `opencode://runner/${projectId}/${pulledTaskId}/${index + 1}`,
+        summary: row.summary,
+      }));
+      await apiRequest(`${API_BASE}/aser-runtime/projects/${projectId}/tasks/${pulledTaskId}/submit-result`, {
+        method: 'POST',
+        body: JSON.stringify({
+          role,
+          summary: `OpenCode Runner completed by ${task.assigned_agent_name || role}`,
+          artifacts,
+        }),
+      });
+
+      const decision = await apiRequest(`${API_BASE}/aser-runtime/projects/${projectId}/tasks/${pulledTaskId}/evaluations`, {
+        method: 'POST',
+        body: JSON.stringify({
+          evaluator: task.assigned_agent_name || `Runner-${role}`,
+          decision: 'accept',
+          score: 90,
+          comments: 'OpenCode Team Runner: auto-accepted by orchestration policy',
+        }),
+      });
+      appendRunnerTimeline({
+        phase: 'agent_done',
+        message: `任务 ${task.title || pulledTaskId} 完成，评价=${String(decision?.decision || 'accept')}`,
+      });
+      if (task.communication_demand === 'clarification') {
+        appendRunnerTimeline({ phase: 'communication', message: `澄清诉求：${task.title || pulledTaskId} 需要进一步业务澄清。` });
+      }
+      if (task.communication_demand === 'escalation') {
+        appendRunnerTimeline({ phase: 'communication', message: `上升诉求：${task.title || pulledTaskId} 存在风险需上升管理。` });
+      }
+    }
+    appendRunnerTimeline({ phase: 'run_done', message: 'OpenCode Team Runner 执行结束。' });
+    await loadOpenCodeRunnerTasks();
+  } catch (error) {
+    appendRunnerTimeline({ phase: 'run_error', message: `执行失败：${error?.message || error}` });
+  } finally {
+    state.opencodeRunnerRunning = false;
+    renderOpenCodeRunner();
+  }
+}
+
+function compareSandboxesBySortMode(a, b) {
+  const mode = String(state.sandboxSortMode || 'created_asc');
+  const createdA = String(a?.created_at || '');
+  const createdB = String(b?.created_at || '');
+  const updatedA = String(a?.updated_at || '');
+  const updatedB = String(b?.updated_at || '');
+  const nameA = String(a?.name || '');
+  const nameB = String(b?.name || '');
+  if (mode === 'created_desc') {
+    if (createdA !== createdB) return createdB.localeCompare(createdA);
+  } else if (mode === 'updated_desc') {
+    if (updatedA !== updatedB) return updatedB.localeCompare(updatedA);
+  } else if (mode === 'name_asc') {
+    if (nameA !== nameB) return nameA.localeCompare(nameB, 'zh-Hans-CN');
+  } else {
+    if (createdA !== createdB) return createdA.localeCompare(createdB);
+  }
+  return String(a?.id || '').localeCompare(String(b?.id || ''));
+}
+
+function applySandboxSortControl() {
+  const select = document.getElementById('sandbox-sort-mode');
+  if (!(select instanceof HTMLSelectElement)) return;
+  const mode = String(state.sandboxSortMode || 'created_asc');
+  if (select.value !== mode) {
+    select.value = mode;
+  }
+}
+
 function applySandboxChatVisibility() {
   const layout = document.getElementById('sandbox-layout');
   const toggleBtn = document.getElementById('toggle-sandbox-chat-btn');
@@ -171,10 +744,34 @@ function applyReadonlyMode() {
   if (diariesNav instanceof HTMLElement) {
     diariesNav.classList.toggle('hidden', !state.pageAccess.diaries && !state.fullAccess);
   }
+  const tasksNav = document.querySelector('[data-nav="tasks"]');
+  if (tasksNav instanceof HTMLElement) {
+    tasksNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
   const changesNav = document.querySelector('[data-nav="changes"]');
   if (changesNav instanceof HTMLElement) {
     changesNav.classList.toggle('hidden', !state.pageAccess.changes && !state.fullAccess);
   }
+  const aserRuntimeNav = document.querySelector('[data-nav="aser-runtime"]');
+  if (aserRuntimeNav instanceof HTMLElement) {
+    aserRuntimeNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
+  const aiEngineeringNav = document.querySelector('[data-nav="ai-engineering"]');
+  if (aiEngineeringNav instanceof HTMLElement) {
+    aiEngineeringNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
+  const agentClubNav = document.querySelector('[data-nav="agent-club"]');
+  if (agentClubNav instanceof HTMLElement) {
+    agentClubNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
+  const teamsNav = document.querySelector('[data-nav="teams"]');
+  if (teamsNav instanceof HTMLElement) {
+    teamsNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
+  const opencodeRunnerNav = document.querySelector('[data-nav="opencode-team-runner"]');
+  if (opencodeRunnerNav instanceof HTMLElement) {
+    opencodeRunnerNav.classList.toggle('hidden', !state.pageAccess.sandboxes && !state.fullAccess);
+  }
   const projectSettingsNav = document.querySelector('[data-nav="settings"]');
   if (projectSettingsNav instanceof HTMLElement) {
     projectSettingsNav.classList.toggle('hidden', !state.pageAccess.settings);
@@ -184,6 +781,7 @@ function applyReadonlyMode() {
     systemSettingsNav.classList.toggle('hidden', !state.canAccessSystemSettings);
   }
   setHiddenById('add-sandbox-btn', state.readonly || !state.fullAccess);
+  setHiddenById('import-sandbox-btn', state.readonly || !state.fullAccess);
   setHiddenById('add-item-btn', state.readonly || !state.currentSandboxWritable);
   setHiddenById('toggle-node-entity-form-btn', state.readonly || !state.currentSandboxWritable);
   setHiddenById('drawer-diary-save-btn', state.readonly || !state.currentSandboxWritable);
@@ -201,6 +799,12 @@ function applyReadonlyMode() {
     closeQuickChatPopover();
   }
   applySandboxChatVisibility();
+  if (aserRuntimeView) {
+    aserRuntimeView.setAccessContext({
+      readonly: state.readonly,
+      hasAccess: state.fullAccess || state.pageAccess.sandboxes,
+    });
+  }
 }
 
 function getSandboxLayoutElement() {
@@ -776,6 +1380,25 @@ function populateParentSelect(items, preferredParentId = null) {
   select.value = hasExpectedValue ? expectedValue : '';
 }
 
+function getTodoMetaFromItem(item) {
+  const extraData = item?.extra_data || {};
+  const todo = extraData?.todo && typeof extraData.todo === 'object' ? extraData.todo : {};
+  const plannedStartDate = String(todo.planned_start_date || '').trim();
+  const dueDate = String(todo.due_date || '').trim();
+  return { plannedStartDate, dueDate };
+}
+
+function isTodoItem(item) {
+  return Boolean(item?.extra_data?.todo?.is_todo);
+}
+
+function getNodeTodoItems(nodeId) {
+  const items = state.currentSandbox?.items || [];
+  return items
+    .filter((item) => String(item.parent_id || '') === String(nodeId || '') && isTodoItem(item))
+    .sort((a, b) => String(a.created_at || '').localeCompare(String(b.created_at || '')));
+}
+
 function normalizeAssistantResponseText(raw) {
   let text = String(raw || '').trim();
   if (!text) return '';
@@ -1150,12 +1773,14 @@ function renderNodeEntitySummary(nodeId) {
   const issues = rows.filter((row) => row.entity_type === 'issue');
   const knowledges = rows.filter((row) => row.entity_type === 'knowledge');
   const capabilities = rows.filter((row) => row.entity_type === 'capability');
+  const todos = getNodeTodoItems(nodeId);
   const openIssues = issues.filter((row) => row.status === 'open' || row.status === 'in_progress' || row.status === 'blocked').length;
   container.innerHTML = `
     <div class="summary-card"><div class="label">Issue</div><div class="value">${issues.length}</div></div>
     <div class="summary-card"><div class="label">Open Issue</div><div class="value">${openIssues}</div></div>
     <div class="summary-card"><div class="label">Knowledge</div><div class="value">${knowledges.length}</div></div>
     <div class="summary-card"><div class="label">Capability</div><div class="value">${capabilities.length}</div></div>
+    <div class="summary-card"><div class="label">Todo</div><div class="value">${todos.length}</div></div>
     <div class="summary-card"><div class="label">Diary</div><div class="value">${diaries.length}</div></div>
   `;
 }
@@ -1180,8 +1805,10 @@ function renderNodeEntityList(nodeId) {
   if (!container) return;
   const allEntityRows = getNodeEntitiesByNodeId(nodeId);
   const allDiaryRows = getNodeDiariesByNodeId(nodeId);
+  const allTodoRows = getNodeTodoItems(nodeId);
   const timelineRows = [
     ...allEntityRows.map((row) => ({ ...row, timeline_type: row.entity_type || 'issue' })),
+    ...allTodoRows.map((row) => ({ ...row, timeline_type: 'todo' })),
     ...allDiaryRows.map((row) => ({ ...row, timeline_type: 'diary' })),
   ].sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
   const rows = state.nodeEntityFilter === 'all'
@@ -1218,6 +1845,32 @@ function renderNodeEntityList(nodeId) {
         </div>
       `;
     }
+    if (row.timeline_type === 'todo') {
+      const todoMeta = getTodoMetaFromItem(row);
+      return `
+        <div class="entity-card">
+          <div class="entity-card-header">
+            <div>
+              <span class="entity-type-pill">todo</span>
+              <strong>${safeText(row.name || '-')}</strong>
+            </div>
+            ${state.readonly ? '' : `
+              <div class="entity-card-actions">
+                <button class="btn btn-secondary btn-sm" data-todo-edit-id="${safeText(row.id)}">编辑</button>
+                <button class="btn btn-secondary btn-sm" data-todo-delete-id="${safeText(row.id)}">删除</button>
+              </div>
+            `}
+          </div>
+          <div class="entity-meta">
+            ${safeText(new Date(row.created_at).toLocaleString())}
+            ${row.status ? ` · <span class="entity-status-pill ${safeText(row.status)}">${safeText(row.status)}</span>` : ''}
+            ${row.assignee ? ` · @${safeText(row.assignee)}` : ''}
+            ${todoMeta.plannedStartDate ? ` · 启动 ${safeText(todoMeta.plannedStartDate)}` : ''}
+            ${todoMeta.dueDate ? ` · 截止 ${safeText(todoMeta.dueDate)}` : ''}
+          </div>
+        </div>
+      `;
+    }
     return `
       <div class="entity-card">
         <div class="entity-card-header">
@@ -1237,6 +1890,7 @@ function renderNodeEntityList(nodeId) {
           ${row.status ? ` · <span class="entity-status-pill ${safeText(row.status)}">${safeText(row.status)}</span>` : ''}
           ${row.priority ? ` · ${safeText(row.priority)}` : ''}
           ${row.assignee ? ` · @${safeText(row.assignee)}` : ''}
+          ${row.due_date ? ` · 截止 ${safeText(row.due_date)}` : ''}
         </div>
         <div class="entity-content">${renderMarkdownSnippet(row.content_md || '')}</div>
       </div>
@@ -1264,6 +1918,41 @@ function renderNodeEntityList(nodeId) {
     });
   });
 
+  container.querySelectorAll('[data-todo-edit-id]').forEach((el) => {
+    el.addEventListener('click', (e) => {
+      e.preventDefault();
+      const id = el.getAttribute('data-todo-edit-id');
+      if (!id) return;
+      const row = allTodoRows.find((item) => item.id === id);
+      if (!row) return;
+      startEditNodeEntity({
+        id: row.id,
+        entity_type: 'todo',
+        title: row.name,
+        content_md: row.description || '',
+        assignee: row.assignee || '',
+        status: row.status || 'pending',
+        priority: row.priority || 'medium',
+        capability_type: '',
+        due_date: '',
+        todo_planned_start_date: getTodoMetaFromItem(row).plannedStartDate,
+        todo_due_date: getTodoMetaFromItem(row).dueDate,
+      });
+    });
+  });
+  container.querySelectorAll('[data-todo-delete-id]').forEach((el) => {
+    el.addEventListener('click', async (e) => {
+      e.preventDefault();
+      if (!state.currentSandbox) return;
+      const id = String(el.getAttribute('data-todo-delete-id') || '');
+      if (!id) return;
+      if (!confirm('确定删除该待办？')) return;
+      await apiRequest(`${API_BASE}/items/${id}`, { method: 'DELETE' });
+      await loadSandbox(state.currentSandbox.id);
+      if (state.selectedNodeId) showNodeEntityDrawer(state.selectedNodeId, state.nodeEntityFilter);
+    });
+  });
+
   container.querySelectorAll('[data-diary-edit-id]').forEach((el) => {
     el.addEventListener('click', (e) => {
       e.preventDefault();
@@ -1300,6 +1989,7 @@ function resetNodeEntityForm() {
   const titleInput = document.getElementById('entity-title-input');
   const contentInput = document.getElementById('entity-content-input');
   const assigneeInput = document.getElementById('entity-assignee-input');
+  const dueDateInput = document.getElementById('entity-due-date-input');
   const statusInput = document.getElementById('entity-status-select');
   const priorityInput = document.getElementById('entity-priority-select');
   const capabilityTypeInput = document.getElementById('entity-capability-type-input');
@@ -1307,6 +1997,11 @@ function resetNodeEntityForm() {
   if (titleInput) titleInput.value = '';
   if (contentInput) contentInput.value = '';
   if (assigneeInput) assigneeInput.value = '';
+  if (dueDateInput) dueDateInput.value = '';
+  const todoPlannedStartInput = document.getElementById('entity-todo-planned-start-input');
+  const todoDueDateInput = document.getElementById('entity-todo-due-date-input');
+  if (todoPlannedStartInput) todoPlannedStartInput.value = '';
+  if (todoDueDateInput) todoDueDateInput.value = '';
   if (statusInput) statusInput.value = '';
   if (priorityInput) priorityInput.value = '';
   if (capabilityTypeInput) capabilityTypeInput.value = '';
@@ -1333,20 +2028,27 @@ function ensureCapabilityTypeOption(value) {
 }
 
 function startEditNodeEntity(row) {
-  state.editingNodeEntityId = row.id;
+  const rowType = String(row.entity_type || 'issue');
+  state.editingNodeEntityId = rowType === 'todo' ? `todo:${row.id}` : row.id;
   setNodeEntityFormExpanded(true);
   const typeInput = document.getElementById('entity-type-select');
   const titleInput = document.getElementById('entity-title-input');
   const contentInput = document.getElementById('entity-content-input');
   const assigneeInput = document.getElementById('entity-assignee-input');
+  const dueDateInput = document.getElementById('entity-due-date-input');
   const statusInput = document.getElementById('entity-status-select');
   const priorityInput = document.getElementById('entity-priority-select');
   const capabilityTypeInput = document.getElementById('entity-capability-type-input');
-  if (typeInput) typeInput.value = row.entity_type || 'issue';
+  if (typeInput) typeInput.value = rowType || 'todo';
   applyEntityFormMode();
-  if (titleInput) titleInput.value = row.title || '';
+  if (titleInput) titleInput.value = rowType === 'todo' ? (row.title || row.name || '') : (row.title || '');
   if (contentInput) contentInput.value = row.content_md || '';
   if (assigneeInput) assigneeInput.value = row.assignee || '';
+  if (dueDateInput) dueDateInput.value = row.due_date || '';
+  const todoPlannedStartInput = document.getElementById('entity-todo-planned-start-input');
+  const todoDueDateInput = document.getElementById('entity-todo-due-date-input');
+  if (todoPlannedStartInput) todoPlannedStartInput.value = row.todo_planned_start_date || '';
+  if (todoDueDateInput) todoDueDateInput.value = row.todo_due_date || '';
   if (statusInput) statusInput.value = row.status || '';
   if (priorityInput) priorityInput.value = row.priority || '';
   ensureCapabilityTypeOption(row.capability_type || '');
@@ -1365,7 +2067,7 @@ function showNodeEntityDrawer(nodeId, preferredFilter = 'all') {
   const node = getNodeById(nodeId);
   if (!drawer || !title || !node) return;
   state.selectedNodeId = nodeId;
-  const filter = ['all', 'issue', 'knowledge', 'capability', 'diary'].includes(preferredFilter) ? preferredFilter : 'all';
+  const filter = ['all', 'todo', 'issue', 'knowledge', 'capability', 'diary'].includes(preferredFilter) ? preferredFilter : 'all';
   state.nodeEntityFilter = filter;
   title.textContent = node.name || nodeId;
   renderNodeEntitySummary(nodeId);
@@ -1388,6 +2090,14 @@ function renderNodeEntityFilterTabs() {
 }
 
 function getStatusOptionsByEntityType(entityType) {
+  if (entityType === 'todo') {
+    return [
+      { value: 'pending', label: 'pending' },
+      { value: 'in_progress', label: 'in_progress' },
+      { value: 'done', label: 'done' },
+      { value: 'archived', label: 'archived' },
+    ];
+  }
   if (entityType === 'issue') {
     return [
       { value: '', label: '状态（Issue，默认 open）' },
@@ -1411,11 +2121,14 @@ function getStatusOptionsByEntityType(entityType) {
 function applyEntityFormMode() {
   const type = document.getElementById('entity-type-select')?.value || 'issue';
   const assigneeGroup = document.getElementById('entity-assignee-group');
+  const dueDateGroup = document.getElementById('entity-due-date-group');
+  const todoDateGroup = document.getElementById('entity-todo-date-group');
   const statusGroup = document.getElementById('entity-status-group');
   const priorityGroup = document.getElementById('entity-priority-group');
   const capabilityTypeGroup = document.getElementById('entity-capability-type-group');
   const hint = document.getElementById('entity-form-hint');
   const statusSelect = document.getElementById('entity-status-select');
+  const contentInput = document.getElementById('entity-content-input');
 
   if (statusSelect) {
     statusSelect.innerHTML = getStatusOptionsByEntityType(type)
@@ -1423,17 +2136,22 @@ function applyEntityFormMode() {
       .join('');
   }
 
-  assigneeGroup?.classList.toggle('hidden', type !== 'issue');
-  priorityGroup?.classList.toggle('hidden', type !== 'issue');
+  assigneeGroup?.classList.toggle('hidden', !(type === 'issue' || type === 'todo'));
+  dueDateGroup?.classList.toggle('hidden', type !== 'issue');
+  todoDateGroup?.classList.toggle('hidden', type !== 'todo');
+  priorityGroup?.classList.toggle('hidden', !(type === 'issue' || type === 'todo'));
   capabilityTypeGroup?.classList.toggle('hidden', type !== 'capability');
   statusGroup?.classList.toggle('hidden', false);
+  contentInput?.classList.toggle('hidden', type === 'todo');
 
   if (hint) {
-    hint.textContent = type === 'issue'
-      ? 'Issue 推荐填写状态/优先级/负责人。'
-      : type === 'knowledge'
-        ? 'Knowledge 可仅保存链接或少量 Markdown。'
-        : 'Capability 建议填写能力类型与简述。';
+    hint.textContent = type === 'todo'
+      ? 'Todo 将作为当前节点子任务创建。'
+      : type === 'issue'
+        ? 'Issue 推荐填写状态/优先级/负责人。'
+        : type === 'knowledge'
+          ? 'Knowledge 可仅保存链接或少量 Markdown。'
+          : 'Capability 建议填写能力类型与简述。';
   }
 }
 
@@ -1672,23 +2390,128 @@ function renderSandboxesSummary() {
 function renderSandboxes() {
   const grid = document.getElementById('sandbox-grid');
   if (!grid) return;
-  
+  const sortedSandboxes = [...state.sandboxes].sort(compareSandboxesBySortMode);
+  applySandboxSortControl();
   mountSandboxGrid('sandbox-grid', {
-    sandboxes: state.sandboxes,
+    sandboxes: sortedSandboxes,
     emptyText: '暂无沙盘',
     onOpen: (id) => {
       window.location.hash = `/sandbox/${id}`;
     },
+    onEdit: (state.readonly || !state.fullAccess) ? undefined : (id) => {
+      const current = state.sandboxes.find((sandbox) => sandbox.id === id);
+      if (!current) return;
+      const dialog = document.getElementById('sandbox-dialog');
+      const title = document.getElementById('sandbox-dialog-title');
+      const confirmBtn = document.getElementById('confirm-sandbox-btn');
+      if (!dialog || !title || !confirmBtn) return;
+      title.textContent = '编辑沙盘';
+      confirmBtn.textContent = '保存';
+      dialog.dataset.editId = String(id);
+      document.getElementById('new-sandbox-name').value = String(current.name || '');
+      document.getElementById('new-sandbox-desc').value = String(current.description || '');
+      dialog.showModal();
+    },
+    onCopyLink: (state.readonly || !state.fullAccess) ? undefined : async (id) => {
+      try {
+        const data = await apiRequest(`${API_BASE}/sandboxes/${id}/copy-link`, { method: 'POST' });
+        const copyLink = String(data?.copy_link || '');
+        if (!copyLink) throw new Error('复制链接为空');
+        await navigator.clipboard.writeText(copyLink);
+        alert('复制链接已复制到剪贴板');
+      } catch (error) {
+        alert(`复制链接失败: ${error.message}`);
+      }
+    },
     onDelete: (state.readonly || !state.fullAccess) ? undefined : async (id) => {
-      if (confirm('确定删除此沙盘？')) {
-        await apiRequest(`${API_BASE}/sandboxes/${id}`, { method: 'DELETE' });
-        await loadSandboxes();
+      const current = state.sandboxes.find((sandbox) => String(sandbox.id || '') === String(id || ''));
+      if (!current) return;
+      const expectedName = String(current.name || '').trim();
+      const typedName = String(window.prompt(`为避免误删，请输入沙盘名称确认删除：${expectedName}`) || '').trim();
+      if (!typedName) return;
+      if (typedName !== expectedName) {
+        alert('输入名称不匹配，已取消删除。');
+        return;
       }
+      await apiRequest(`${API_BASE}/sandboxes/${id}`, { method: 'DELETE' });
+      await loadSandboxes();
     },
     readonly: state.readonly || !state.fullAccess,
   });
 }
 
+function renderTaskBoardList(containerId, rows = []) {
+  const container = document.getElementById(containerId);
+  if (!(container instanceof HTMLElement)) return;
+  if (!rows.length) {
+    container.innerHTML = '<div class="empty-state"><p>暂无任务</p></div>';
+    return;
+  }
+  container.innerHTML = rows.map((row) => `
+    <article class="task-board-item">
+      <div><strong>${safeText(row.name || '-')}</strong> <span class="entity-type-pill">${safeText(row.record_type || 'todo')}</span></div>
+      <div class="task-board-item-meta">沙盘：${safeText(row.sandbox_name || row.sandbox_id || '-')}</div>
+      <div class="task-board-item-meta">负责人：${safeText(row.assignee || '我（未指派）')} · 状态：${safeText(row.status || '-')}</div>
+      <div class="task-board-item-meta">计划启动：${safeText(row.planned_start_date || '-')} · 截止：${safeText(row.due_date || '-')}</div>
+    </article>
+  `).join('');
+}
+
+function normalizeTaskBoardPeriod(value) {
+  const normalized = String(value || '').trim();
+  if (['week', 'month', 'quarter', 'all'].includes(normalized)) {
+    return normalized;
+  }
+  return 'week';
+}
+
+function getTaskBoardRangeLabel(taskBoardData) {
+  const period = normalizeTaskBoardPeriod(taskBoardData?.period || state.taskBoardPeriod);
+  if (period === 'all') return '全部';
+  return `${safeText(taskBoardData?.start_date || '-')} ~ ${safeText(taskBoardData?.end_date || '-')}`;
+}
+
+function renderTaskBoard() {
+  const summary = document.getElementById('task-board-summary');
+  const periodSelect = document.getElementById('task-board-period');
+  const ownerInput = document.getElementById('task-board-owner-input');
+  if (periodSelect instanceof HTMLSelectElement) {
+    periodSelect.value = normalizeTaskBoardPeriod(state.taskBoardPeriod);
+  }
+  if (ownerInput instanceof HTMLInputElement) {
+    ownerInput.value = state.taskBoardOwnerName || '';
+  }
+  if (!state.taskBoardData) {
+    renderTaskBoardList('task-board-mine-list', []);
+    renderTaskBoardList('task-board-others-list', []);
+    if (summary instanceof HTMLElement) {
+      summary.innerHTML = '';
+    }
+    return;
+  }
+  renderTaskBoardList('task-board-mine-list', state.taskBoardData.mine || []);
+  renderTaskBoardList('task-board-others-list', state.taskBoardData.others || []);
+  if (summary instanceof HTMLElement) {
+    const counts = state.taskBoardData.counts || { mine: 0, others: 0, total: 0 };
+    summary.innerHTML = `
+      <div class="summary-card"><div class="label">统计区间</div><div class="value" style="font-size:13px;font-weight:500">${getTaskBoardRangeLabel(state.taskBoardData)}</div></div>
+      <div class="summary-card"><div class="label">我的任务</div><div class="value">${Number(counts.mine || 0)}</div></div>
+      <div class="summary-card"><div class="label">他人任务</div><div class="value">${Number(counts.others || 0)}</div></div>
+      <div class="summary-card"><div class="label">总数</div><div class="value">${Number(counts.total || 0)}</div></div>
+    `;
+  }
+}
+
+async function loadTaskBoard() {
+  const params = new URLSearchParams();
+  params.set('period', normalizeTaskBoardPeriod(state.taskBoardPeriod));
+  if (state.taskBoardOwnerName) {
+    params.set('owner', state.taskBoardOwnerName);
+  }
+  state.taskBoardData = await apiRequest(`${API_BASE}/items/agenda?${params.toString()}`);
+  renderTaskBoard();
+}
+
 async function loadSandbox(id) {
   closeQuickChatPopover();
   state.currentSandboxWritable = canWriteSandboxById(id);
@@ -2521,6 +3344,20 @@ function showPage(pageId) {
   const navPageId = pageId === 'sandbox-detail' ? 'sandboxes' : pageId;
   const nav = document.querySelector(`[data-nav="${navPageId}"]`);
   if (nav) nav.classList.add('active');
+  if (['ai-engineering', 'aser-runtime', 'agent-club', 'teams', 'opencode-team-runner'].includes(navPageId)) {
+    setAiEngineeringNavCollapsed(false);
+  }
+}
+
+function setAiEngineeringNavCollapsed(collapsed) {
+  const navGroup = document.getElementById('ai-engineering-nav-group');
+  const toggleBtn = document.getElementById('toggle-ai-engineering-nav');
+  if (!(navGroup instanceof HTMLElement)) return;
+  navGroup.classList.toggle('nav-group-collapsed', Boolean(collapsed));
+  if (toggleBtn instanceof HTMLButtonElement) {
+    toggleBtn.setAttribute('aria-expanded', collapsed ? 'false' : 'true');
+    toggleBtn.textContent = collapsed ? '▸' : '▾';
+  }
 }
 
 function editWorkItem(id) {
@@ -2543,8 +3380,19 @@ async function initApp() {
   await loadRuntimeMode();
   loadWorkItemAssigneePreference();
   loadWorkTreeViewModePreference();
+  loadSandboxSortModePreference();
+  loadTaskBoardOwnerNamePreference();
+  loadAiEngineeringState();
   renderQuickDiaryTargetLabel();
   applyReadonlyMode();
+  aserRuntimeView = createAserRuntimeView({
+    readonly: state.readonly,
+    hasAccess: state.fullAccess || state.pageAccess.sandboxes,
+    getTeams: () => state.teams.map((team) => ({ ...team })),
+    getProjectTeamAssignments: () => ({ ...(state.aserProjectTeamAssignments || {}) }),
+    assignProjectTeam: (projectId, teamId) => assignAserProjectTeam(projectId, teamId),
+  });
+  aserRuntimeView.mount();
   
   document.querySelectorAll('.nav-list a').forEach(link => {
     link.addEventListener('click', (e) => {
@@ -2552,14 +3400,172 @@ async function initApp() {
       window.location.hash = link.getAttribute('href').replace('#', '') || '/';
     });
   });
+
+  document.getElementById('agent-club-create-btn')?.addEventListener('click', () => {
+    const nameInput = document.getElementById('agent-club-name');
+    const roleInput = document.getElementById('agent-club-role');
+    const knowledgeInput = document.getElementById('agent-club-knowledge');
+    const skillsInput = document.getElementById('agent-club-skills');
+    const taskTypesInput = document.getElementById('agent-club-task-types');
+    const deliverablesInput = document.getElementById('agent-club-deliverables');
+    const raciInput = document.getElementById('agent-club-raci-default');
+    const qualityInput = document.getElementById('agent-club-quality-criteria');
+    const riskInput = document.getElementById('agent-club-risk-limits');
+    const name = String(nameInput?.value || '').trim();
+    const role = String(roleInput?.value || '').trim();
+    const knowledgeBackground = parseLineList(knowledgeInput?.value);
+    const skills = parseSkillRows(skillsInput?.value);
+    const taskTypes = parseLineList(taskTypesInput?.value);
+    const deliverables = parseLineList(deliverablesInput?.value);
+    const raciDefault = String(raciInput?.value || '').trim();
+    const qualityCriteria = parseLineList(qualityInput?.value);
+    const riskLimits = parseLineList(riskInput?.value);
+    if (!name) {
+      alert('请填写 Agent 名称');
+      return;
+    }
+    const id = `agent-${Date.now()}`;
+    state.agentClub.unshift(normalizeAgentRecord({
+      id,
+      name,
+      role_type: role || 'generalist',
+      knowledge_background: knowledgeBackground,
+      skills,
+      task_types: taskTypes,
+      deliverables,
+      raci_default: raciDefault,
+      quality_criteria: qualityCriteria,
+      risk_limits: riskLimits,
+    }));
+    persistAiEngineeringState();
+    renderAgentClub();
+    renderTeams();
+    renderOpenCodeRunner();
+    if (nameInput) nameInput.value = '';
+    if (roleInput) roleInput.value = '';
+    if (knowledgeInput) knowledgeInput.value = '';
+    if (skillsInput) skillsInput.value = '';
+    if (taskTypesInput) taskTypesInput.value = '';
+    if (deliverablesInput) deliverablesInput.value = '';
+    if (raciInput) raciInput.value = '';
+    if (qualityInput) qualityInput.value = '';
+    if (riskInput) riskInput.value = '';
+    if (aserRuntimeView) aserRuntimeView.refreshTeamContext();
+  });
+
+  document.getElementById('agent-club-list')?.addEventListener('click', (event) => {
+    const target = event.target;
+    if (!(target instanceof HTMLElement)) return;
+    const deleteId = String(target.getAttribute('data-agent-delete-id') || '').trim();
+    if (!deleteId) return;
+    state.agentClub = state.agentClub.filter((agent) => String(agent.id) !== deleteId);
+    state.teams = state.teams.map((team) => ({
+      ...team,
+      agent_ids: team.agent_ids.filter((agentId) => String(agentId) !== deleteId),
+    }));
+    persistAiEngineeringState();
+    renderAgentClub();
+    renderTeams();
+    renderOpenCodeRunner();
+    if (aserRuntimeView) aserRuntimeView.refreshTeamContext();
+  });
+
+  document.getElementById('teams-create-btn')?.addEventListener('click', () => {
+    const nameInput = document.getElementById('teams-name');
+    const agentSelect = document.getElementById('teams-agent-select');
+    const name = String(nameInput?.value || '').trim();
+    if (!name) {
+      alert('请填写 Team 名称');
+      return;
+    }
+    const agentIds = agentSelect instanceof HTMLSelectElement
+      ? Array.from(agentSelect.selectedOptions)
+        .map((option) => String(option.value || '').trim())
+        .filter(Boolean)
+        .filter((agentId) => state.agentClub.some((agent) => String(agent.id) === agentId))
+      : [];
+    const id = `team-${Date.now()}`;
+    state.teams.unshift(normalizeTeamRecord({ id, name, agent_ids: agentIds }));
+    persistAiEngineeringState();
+    renderTeams();
+    renderOpenCodeRunner();
+    if (nameInput) nameInput.value = '';
+    if (agentSelect instanceof HTMLSelectElement) {
+      Array.from(agentSelect.options).forEach((option) => {
+        option.selected = false;
+      });
+    }
+    if (aserRuntimeView) aserRuntimeView.refreshTeamContext();
+  });
+
+  document.getElementById('teams-list')?.addEventListener('click', (event) => {
+    const target = event.target;
+    if (!(target instanceof HTMLElement)) return;
+    const deleteId = String(target.getAttribute('data-team-delete-id') || '').trim();
+    if (!deleteId) return;
+    state.teams = state.teams.filter((team) => String(team.id) !== deleteId);
+    Object.keys(state.aserProjectTeamAssignments || {}).forEach((projectId) => {
+      if (String(state.aserProjectTeamAssignments[projectId]) === deleteId) {
+        delete state.aserProjectTeamAssignments[projectId];
+      }
+    });
+    persistAiEngineeringState();
+    renderTeams();
+    renderOpenCodeRunner();
+    if (aserRuntimeView) aserRuntimeView.refreshTeamContext();
+  });
+
+  document.getElementById('opencode-runner-project-select')?.addEventListener('change', (event) => {
+    const target = event.target;
+    if (!(target instanceof HTMLSelectElement)) return;
+    state.opencodeRunnerSelectedProjectId = String(target.value || '').trim();
+    const assigned = getAssignedTeamIdForProject(state.opencodeRunnerSelectedProjectId);
+    if (assigned) state.opencodeRunnerSelectedTeamId = assigned;
+    renderOpenCodeRunner();
+  });
+
+  document.getElementById('opencode-runner-team-select')?.addEventListener('change', (event) => {
+    const target = event.target;
+    if (!(target instanceof HTMLSelectElement)) return;
+    state.opencodeRunnerSelectedTeamId = String(target.value || '').trim();
+    renderOpenCodeRunner();
+  });
+
+  document.getElementById('opencode-runner-load-btn')?.addEventListener('click', () => {
+    loadOpenCodeRunnerTasks().catch((error) => {
+      alert(`获取任务失败: ${error?.message || error}`);
+    });
+  });
+
+  document.getElementById('opencode-runner-plan-btn')?.addEventListener('click', () => {
+    planOpenCodeRunnerTasks();
+  });
+
+  document.getElementById('opencode-runner-start-btn')?.addEventListener('click', () => {
+    startOpenCodeRunner().catch((error) => {
+      alert(`启动 Runner 失败: ${error?.message || error}`);
+    });
+  });
   
   document.getElementById('add-sandbox-btn')?.addEventListener('click', () => {
     if (state.readonly) return;
-    document.getElementById('sandbox-dialog').showModal();
+    const dialog = document.getElementById('sandbox-dialog');
+    if (!dialog) return;
+    dialog.dataset.editId = '';
+    const title = document.getElementById('sandbox-dialog-title');
+    const confirmBtn = document.getElementById('confirm-sandbox-btn');
+    if (title) title.textContent = '新建沙盘';
+    if (confirmBtn) confirmBtn.textContent = '创建';
+    document.getElementById('new-sandbox-name').value = '';
+    document.getElementById('new-sandbox-desc').value = '';
+    dialog.showModal();
   });
   
   document.getElementById('cancel-sandbox-btn')?.addEventListener('click', () => {
-    document.getElementById('sandbox-dialog').close();
+    const dialog = document.getElementById('sandbox-dialog');
+    if (!dialog) return;
+    dialog.dataset.editId = '';
+    dialog.close();
   });
   
   const createSandbox = async (e) => {
@@ -2568,23 +3574,78 @@ async function initApp() {
     const name = document.getElementById('new-sandbox-name').value;
     const description = document.getElementById('new-sandbox-desc').value;
     const dialog = document.getElementById('sandbox-dialog');
+    const editId = String(dialog?.dataset?.editId || '').trim();
     
     try {
-      await apiRequest(`${API_BASE}/sandboxes`, {
-        method: 'POST',
-        body: JSON.stringify({ name, description }),
-      });
+      if (editId) {
+        await apiRequest(`${API_BASE}/sandboxes/${editId}`, {
+          method: 'PUT',
+          body: JSON.stringify({ name, description }),
+        });
+      } else {
+        await apiRequest(`${API_BASE}/sandboxes`, {
+          method: 'POST',
+          body: JSON.stringify({ name, description }),
+        });
+      }
+      dialog.dataset.editId = '';
       dialog.close();
       document.getElementById('new-sandbox-name').value = '';
       document.getElementById('new-sandbox-desc').value = '';
       await loadSandboxes();
     } catch (error) {
-      alert('创建失败: ' + error.message);
+      alert(`${editId ? '保存' : '创建'}失败: ${error.message}`);
     }
   };
 
   document.getElementById('sandbox-dialog')?.addEventListener('submit', createSandbox);
   document.getElementById('confirm-sandbox-btn')?.addEventListener('click', createSandbox);
+  document.getElementById('sandbox-sort-mode')?.addEventListener('change', (event) => {
+    const mode = String(event?.target?.value || '').trim();
+    if (mode === 'created_asc' || mode === 'created_desc' || mode === 'updated_desc' || mode === 'name_asc') {
+      state.sandboxSortMode = mode;
+      persistSandboxSortModePreference();
+      renderSandboxes();
+    }
+  });
+
+  document.getElementById('import-sandbox-btn')?.addEventListener('click', () => {
+    if (state.readonly) return;
+    const dialog = document.getElementById('import-sandbox-dialog');
+    if (!dialog) return;
+    document.getElementById('import-sandbox-link').value = '';
+    document.getElementById('import-sandbox-name').value = '';
+    dialog.showModal();
+  });
+  document.getElementById('cancel-import-sandbox-btn')?.addEventListener('click', () => {
+    document.getElementById('import-sandbox-dialog')?.close();
+  });
+  const importSandboxByLink = async (e) => {
+    if (state.readonly) return;
+    e?.preventDefault?.();
+    const dialog = document.getElementById('import-sandbox-dialog');
+    const copyLink = String(document.getElementById('import-sandbox-link').value || '').trim();
+    const name = String(document.getElementById('import-sandbox-name').value || '').trim();
+    if (!copyLink) {
+      alert('请先输入复制链接');
+      return;
+    }
+    try {
+      const created = await apiRequest(`${API_BASE}/sandboxes/import-from-link`, {
+        method: 'POST',
+        body: JSON.stringify({ copy_link: copyLink, name }),
+      });
+      dialog?.close();
+      await loadSandboxes();
+      if (created?.id) {
+        window.location.hash = `/sandbox/${created.id}`;
+      }
+    } catch (error) {
+      alert(`复制失败: ${error.message}`);
+    }
+  };
+  document.getElementById('import-sandbox-dialog')?.addEventListener('submit', importSandboxByLink);
+  document.getElementById('confirm-import-sandbox-btn')?.addEventListener('click', importSandboxByLink);
   
   document.getElementById('add-item-btn')?.addEventListener('click', () => {
     if (state.readonly) return;
@@ -2619,13 +3680,49 @@ async function initApp() {
     document.getElementById('item-dialog').close();
   });
 
+  document.getElementById('toggle-ai-engineering-nav')?.addEventListener('click', () => {
+    const navGroup = document.getElementById('ai-engineering-nav-group');
+    if (!(navGroup instanceof HTMLElement)) return;
+    const collapsed = navGroup.classList.contains('nav-group-collapsed');
+    setAiEngineeringNavCollapsed(!collapsed);
+  });
+
+  document.getElementById('task-board-period')?.addEventListener('change', async (event) => {
+    const value = String(event?.target?.value || 'week');
+    state.taskBoardPeriod = normalizeTaskBoardPeriod(value);
+    await loadTaskBoard();
+  });
+
+  document.getElementById('task-board-owner-input')?.addEventListener('change', async (event) => {
+    state.taskBoardOwnerName = String(event?.target?.value || '').trim();
+    persistTaskBoardOwnerNamePreference();
+    await loadTaskBoard();
+  });
+
+  document.getElementById('task-board-refresh-btn')?.addEventListener('click', async () => {
+    await loadTaskBoard();
+  });
+
   document.getElementById('close-node-drawer-btn')?.addEventListener('click', () => {
     closeNodeEntityDrawer();
   });
 
   document.getElementById('toggle-node-entity-form-btn')?.addEventListener('click', () => {
     if (state.readonly) return;
-    setNodeEntityFormExpanded(!state.nodeEntityFormExpanded);
+    const nextExpanded = !state.nodeEntityFormExpanded;
+    if (nextExpanded) {
+      const preferredType = ['todo', 'issue', 'knowledge', 'capability'].includes(state.nodeEntityFilter)
+        ? state.nodeEntityFilter
+        : 'issue';
+      if (!state.editingNodeEntityId) {
+        const typeSelect = document.getElementById('entity-type-select');
+        if (typeSelect instanceof HTMLSelectElement) {
+          typeSelect.value = preferredType;
+          applyEntityFormMode();
+        }
+      }
+    }
+    setNodeEntityFormExpanded(nextExpanded);
     if (state.nodeEntityFormExpanded) {
       document.getElementById('entity-title-input')?.focus();
     }
@@ -2660,31 +3757,77 @@ async function initApp() {
     const entity_type = document.getElementById('entity-type-select').value;
     if (!title) return;
     const rawStatus = document.getElementById('entity-status-select').value || '';
-    const status = rawStatus || (entity_type === 'issue' ? 'open' : entity_type === 'capability' ? 'building' : '');
-    const payload = {
-      work_item_id: state.selectedNodeId,
-      entity_type,
-      title,
-      content_md: document.getElementById('entity-content-input').value || '',
-      assignee: document.getElementById('entity-assignee-input').value || '',
-      status,
-      priority: document.getElementById('entity-priority-select').value || '',
-      capability_type: document.getElementById('entity-capability-type-input').value || '',
-    };
-
+    const status = rawStatus || (entity_type === 'todo'
+      ? 'pending'
+      : entity_type === 'issue'
+        ? 'open'
+        : entity_type === 'capability'
+          ? 'building'
+          : '');
     const isEditing = Boolean(state.editingNodeEntityId);
+    const editingTodoId = isEditing && String(state.editingNodeEntityId).startsWith('todo:')
+      ? String(state.editingNodeEntityId).slice(5)
+      : '';
+    const editingEntityId = isEditing && !editingTodoId ? String(state.editingNodeEntityId) : '';
+
     setButtonState(btn, { disabled: true, text: isEditing ? '保存中...' : '添加中...' });
     try {
-      if (isEditing) {
-        await apiRequest(`${API_BASE}/sandboxes/${state.currentSandbox.id}/entities/${state.editingNodeEntityId}`, {
-          method: 'PUT',
-          body: JSON.stringify(payload),
-        });
+      if (entity_type === 'todo') {
+        const todoPayload = {
+          name: title,
+          parent_id: state.selectedNodeId,
+          description: '',
+          assignee: document.getElementById('entity-assignee-input').value || '',
+          status,
+          priority: document.getElementById('entity-priority-select').value || 'medium',
+          extra_data: {
+            todo: {
+              is_todo: true,
+              planned_start_date: document.getElementById('entity-todo-planned-start-input').value || '',
+              due_date: document.getElementById('entity-todo-due-date-input').value || '',
+            },
+          },
+        };
+        const plannedStart = String(todoPayload.extra_data.todo.planned_start_date || '').trim();
+        const dueDate = String(todoPayload.extra_data.todo.due_date || '').trim();
+        if (plannedStart && dueDate && plannedStart > dueDate) {
+          alert('计划启动日期不能晚于截止日期。');
+          return;
+        }
+        if (editingTodoId) {
+          await apiRequest(`${API_BASE}/items/${editingTodoId}`, {
+            method: 'PUT',
+            body: JSON.stringify(todoPayload),
+          });
+        } else {
+          await apiRequest(`${API_BASE}/sandboxes/${state.currentSandbox.id}/items`, {
+            method: 'POST',
+            body: JSON.stringify(todoPayload),
+          });
+        }
       } else {
-        await apiRequest(`${API_BASE}/sandboxes/${state.currentSandbox.id}/entities`, {
-          method: 'POST',
-          body: JSON.stringify(payload),
-        });
+        const payload = {
+          work_item_id: state.selectedNodeId,
+          entity_type,
+          title,
+          content_md: document.getElementById('entity-content-input').value || '',
+          assignee: document.getElementById('entity-assignee-input').value || '',
+          due_date: document.getElementById('entity-due-date-input').value || '',
+          status,
+          priority: document.getElementById('entity-priority-select').value || '',
+          capability_type: document.getElementById('entity-capability-type-input').value || '',
+        };
+        if (editingEntityId) {
+          await apiRequest(`${API_BASE}/sandboxes/${state.currentSandbox.id}/entities/${editingEntityId}`, {
+            method: 'PUT',
+            body: JSON.stringify(payload),
+          });
+        } else {
+          await apiRequest(`${API_BASE}/sandboxes/${state.currentSandbox.id}/entities`, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+          });
+        }
       }
       await loadSandbox(state.currentSandbox.id);
       showNodeEntityDrawer(state.selectedNodeId);
@@ -2755,7 +3898,9 @@ async function initApp() {
     if (state.readonly) return;
     const dialog = document.getElementById('item-dialog');
     const editId = dialog.dataset.editId || null;
-    const isNewItem = !editId;
+    const editingItem = editId
+      ? state.currentSandbox?.items?.find((item) => String(item.id) === String(editId))
+      : null;
     
     const data = {
       name: document.getElementById('new-item-name').value,
@@ -2765,6 +3910,10 @@ async function initApp() {
       priority: document.getElementById('new-item-priority').value,
       parent_id: document.getElementById('new-item-parent').value || null,
     };
+    const mergedExtraData = {
+      ...(editingItem?.extra_data || {}),
+    };
+    data.extra_data = mergedExtraData;
     
     if (!data.name) {
       return;
@@ -3421,6 +4570,12 @@ async function initApp() {
       } else if (state.canAccessSystemSettings) {
         window.location.hash = '/system-settings';
       }
+    } else if (pathHash === '/ai-engineering') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('ai-engineering');
     } else if (pathHash === '/sandboxes') {
       if (!state.pageAccess.sandboxes && !state.fullAccess) {
         window.location.hash = '/';
@@ -3450,6 +4605,44 @@ async function initApp() {
       showPage('diaries');
       await loadDiaries();
       await loadSandboxes();
+    } else if (pathHash === '/tasks') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('tasks');
+      await loadTaskBoard();
+    } else if (pathHash === '/aser-runtime') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('aser-runtime');
+      if (aserRuntimeView) {
+        await aserRuntimeView.loadProjects();
+      }
+    } else if (pathHash === '/agent-club') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('agent-club');
+      renderAgentClub();
+    } else if (pathHash === '/teams') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('teams');
+      renderTeams();
+    } else if (pathHash === '/opencode-team-runner') {
+      if (!state.pageAccess.sandboxes && !state.fullAccess) {
+        window.location.hash = '/';
+        return;
+      }
+      showPage('opencode-team-runner');
+      await loadOpenCodeRunnerProjects();
+      renderOpenCodeRunner();
     } else if (pathHash === '/changes') {
       if (!state.pageAccess.changes && !state.fullAccess) {
         window.location.hash = '/';