echoctl 0.1.0 → 0.1.2

package/docs/.vitepress/theme/components/EchoGlobalControls.vue

@@ -0,0 +1,91 @@
+<template>
+  <div class="echo-global-controls">
+    <!-- [PROJECT_FILTER_DISABLED] 功能失灵，后期修复后取消注释
+    <select
+      class="echo-global-select"
+      :value="projectFilter.selectedProject.value"
+      @change="projectFilter.select(($event.target as HTMLSelectElement).value)"
+    >
+      <option value="__all__">全部项目</option>
+      <option v-for="p in projectFilter.allProjects.value" :key="p.id" :value="p.id">
+        {{ p.name }}
+      </option>
+    </select>
+    -->
+    <button
+      class="echo-global-btn"
+      :class="status?.captureEnabled ? 'echo-btn-on' : 'echo-btn-off'"
+      :disabled="state !== 'ready'"
+      :title="state === 'ready' ? '切换 Echo 收集状态' : 'Echo API 未运行'"
+      @click="toggleCapture"
+    >
+      收集 {{ status?.captureEnabled ? '开' : '关' }}
+    </button>
+    <button
+      class="echo-global-btn"
+      :disabled="state !== 'ready'"
+      title="复制 Echo MCP 配置"
+      @click="showMcp"
+    >
+      MCP
+    </button>
+  </div>
+
+  <Teleport to="body">
+    <div v-if="mcpVisible" class="echo-modal" @click.self="mcpVisible = false">
+      <div class="echo-modal-content">
+        <h3>MCP 配置</h3>
+        <p>这是 AI 访问 Echo 的桥。将此 JSON 添加到 Claude/Codex MCP 配置中：</p>
+        <pre>{{ mcpConfigText }}</pre>
+        <div class="echo-modal-btns">
+          <button class="echo-btn" @click="copyMcp">复制</button>
+          <button class="echo-btn" @click="mcpVisible = false">关闭</button>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { onMounted, ref } from 'vue'
+import { useEchoStatus } from '../lib/useEchoStatus'
+import { getMcpConfig, setCapture } from '../lib/echo-api'
+// [PROJECT_FILTER_DISABLED] 后期恢复时取消注释
+// import { useProjectFilter } from '../lib/useProjectFilter'
+
+const articleId = ref<string | undefined>(undefined)
+const { state, status } = useEchoStatus(articleId)
+// const projectFilter = useProjectFilter()
+
+onMounted(() => {
+  // projectFilter.load()
+  // projectFilter.restore()
+})
+
+const mcpVisible = ref(false)
+const mcpConfigText = ref('')
+
+async function toggleCapture() {
+  if (!status.value) return
+  try {
+    const r = await setCapture(!status.value.captureEnabled)
+    status.value = { ...status.value, captureEnabled: r.enabled }
+  } catch (_) {}
+}
+
+async function showMcp() {
+  try {
+    const cfg = await getMcpConfig()
+    mcpConfigText.value = JSON.stringify({
+      mcpServers: { echo: { command: cfg.canonical.command, args: cfg.canonical.args } }
+    }, null, 2)
+    mcpVisible.value = true
+  } catch (_) {}
+}
+
+async function copyMcp() {
+  try {
+    await navigator.clipboard.writeText(mcpConfigText.value)
+  } catch (_) {}
+}
+</script>

package/docs/.vitepress/theme/components/EchoLegacyRecovery.vue

@@ -0,0 +1,178 @@
+<template>
+  <div v-if="visible" class="echo-legacy-overlay" @click.self="dismiss">
+    <div class="echo-legacy-dialog">
+      <h2>Echo 发现遗留会话 / Echo found legacy sessions</h2>
+      <p class="echo-legacy-desc">
+        Echo 发现有一些会话记录之前进入了 legacy 区。它们看起来属于当前项目。<br/>
+        Echo found chat records in the legacy area. They appear to belong to the current project.
+      </p>
+      <p class="echo-legacy-question">
+        是否迁移到当前项目？迁移后，它们会出现在当前项目的实时会话或文章列表中。<br/>
+        Move them into this project? After migration, they will appear in this project's live sessions or articles.
+      </p>
+
+      <div v-if="mode === 'list' && candidates.length > 0" class="echo-legacy-list">
+        <div v-for="c in candidates" :key="c.sessionId" class="echo-legacy-item">
+          <span class="echo-legacy-session">{{ c.fileName }}</span>
+          <span class="echo-legacy-meta">{{ c.turnCount }} turns, {{ c.confidence }} confidence</span>
+        </div>
+      </div>
+
+      <div v-if="error" class="echo-legacy-error">{{ error }}</div>
+      <div v-if="success" class="echo-legacy-success">{{ success }}</div>
+
+      <div class="echo-legacy-buttons">
+        <button class="echo-legacy-btn later" @click="dismiss" :disabled="migrating">
+          稍后处理 / Later
+        </button>
+        <button v-if="mode === 'prompt'" class="echo-legacy-btn review" @click="mode = 'list'">
+          查看候选 / Review
+        </button>
+        <button class="echo-legacy-btn migrate" @click="migrate" :disabled="migrating">
+          {{ migrating ? '迁移中... / Migrating...' : '迁移到当前项目 / Move to this project' }}
+        </button>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, onMounted } from 'vue'
+import { useData } from 'vitepress'
+import { getLegacyCandidates, migrateLegacyCandidates, getStatus } from '../lib/echo-api'
+
+const props = defineProps<{ projectId?: string }>()
+
+const { frontmatter } = useData()
+const pageProjectId = computed(() => (frontmatter.value as any)?.echo?.projectId as string | null | undefined)
+
+const visible = ref(false)
+const mode = ref<'prompt' | 'list'>('prompt')
+const candidates = ref<any[]>([])
+const migrating = ref(false)
+const error = ref('')
+const success = ref('')
+const resolvedProjectId = ref<string | null>(null)
+
+onMounted(async () => {
+  let pid = pageProjectId.value || props.projectId || null
+  if (!pid) {
+    try { const s = await getStatus(); pid = s.projectId } catch (_) {}
+  }
+  if (!pid) return
+  resolvedProjectId.value = pid
+  try {
+    const result = await getLegacyCandidates(pid)
+    if (result.candidates.length > 0) {
+      candidates.value = result.candidates
+      visible.value = true
+    }
+  } catch (_) {}
+})
+
+function dismiss() {
+  visible.value = false
+}
+
+async function migrate() {
+  migrating.value = true
+  error.value = ''
+  try {
+    const ids = candidates.value.map((c) => c.sessionId)
+    const result = await migrateLegacyCandidates(resolvedProjectId.value!, ids)
+    if (result.ok) {
+      success.value = `已迁移 ${result.migrated} 个会话。页面即将刷新... / Migrated ${result.migrated} sessions. Refreshing...`
+      setTimeout(() => location.reload(), 1500)
+    }
+  } catch (err: any) {
+    error.value = err.message || '迁移失败 / Migration failed'
+  } finally {
+    migrating.value = false
+  }
+}
+</script>
+
+<style scoped>
+.echo-legacy-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+}
+.echo-legacy-dialog {
+  background: var(--vp-c-bg);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 12px;
+  padding: 24px;
+  max-width: 520px;
+  width: 90%;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.2);
+}
+.echo-legacy-dialog h2 {
+  margin: 0 0 12px;
+  font-size: 18px;
+}
+.echo-legacy-desc, .echo-legacy-question {
+  margin: 0 0 12px;
+  color: var(--vp-c-text-2);
+  font-size: 14px;
+  line-height: 1.6;
+}
+.echo-legacy-list {
+  max-height: 200px;
+  overflow-y: auto;
+  margin-bottom: 12px;
+}
+.echo-legacy-item {
+  display: flex;
+  justify-content: space-between;
+  padding: 6px 0;
+  border-bottom: 1px solid var(--vp-c-divider);
+  font-size: 13px;
+}
+.echo-legacy-session {
+  font-weight: 600;
+}
+.echo-legacy-meta {
+  color: var(--vp-c-text-3);
+}
+.echo-legacy-error {
+  color: var(--vp-c-danger);
+  margin-bottom: 12px;
+  font-size: 14px;
+}
+.echo-legacy-success {
+  color: var(--vp-c-brand);
+  margin-bottom: 12px;
+  font-size: 14px;
+}
+.echo-legacy-buttons {
+  display: flex;
+  gap: 8px;
+  justify-content: flex-end;
+}
+.echo-legacy-btn {
+  padding: 8px 16px;
+  border-radius: 6px;
+  border: 1px solid var(--vp-c-divider);
+  background: var(--vp-c-bg);
+  color: var(--vp-c-text-1);
+  cursor: pointer;
+  font-size: 14px;
+}
+.echo-legacy-btn.migrate {
+  background: var(--vp-c-brand);
+  color: #fff;
+  border-color: var(--vp-c-brand);
+}
+.echo-legacy-btn.migrate:hover {
+  background: var(--vp-c-brand-dark);
+}
+.echo-legacy-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+</style>

package/docs/.vitepress/theme/components/EchoLiveSession.vue

@@ -0,0 +1,82 @@
+<template>
+  <div class="echo-live-actions" v-if="!isPublished">
+    <button class="echo-publish-btn" @click="publish" :disabled="publishing">
+      {{ publishing ? '发布中...' : '发布为正式文章' }}
+    </button>
+    <span v-if="error" class="echo-publish-error">{{ error }}</span>
+    <span v-if="ok" class="echo-publish-ok">{{ ok }}</span>
+  </div>
+  <div class="echo-live-actions" v-else>
+    <a :href="`/articles/generated/${publishedSlug}`" class="echo-published-link">查看已发布文章</a>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, onBeforeUnmount, onMounted } from 'vue'
+import { postPublish, getLiveSessionState, EchoApiError } from '../lib/echo-api'
+import { subscribeEchoHeartbeat } from '../lib/echo-heartbeat'
+
+const props = defineProps<{
+  projectId: string
+  sessionId: string
+  published: string
+  publishedSlug: string
+}>()
+
+const publishing = ref(false)
+const error = ref("")
+const ok = ref("")
+const isPublished = computed(() => props.published === "true")
+let unsubscribeHeartbeat: (() => void) | null = null
+let lastHash: string | null = null
+let checking = false
+
+onMounted(() => {
+  const livePath = window.location.pathname
+  const checkForChanges = async () => {
+    if (checking) return
+    if (document.visibilityState === "hidden") return
+    checking = true
+    try {
+      const state = await getLiveSessionState(props.projectId || null, props.sessionId)
+      if (!state.exists || !state.hash) return
+      if (lastHash && lastHash !== state.hash && window.location.pathname === livePath) {
+        window.location.reload()
+        return
+      }
+      lastHash = state.hash
+    } catch (_) {
+      // Live pages must remain readable when the local API is stopped.
+    } finally {
+      checking = false
+    }
+  }
+
+  void checkForChanges()
+  unsubscribeHeartbeat = subscribeEchoHeartbeat(checkForChanges)
+})
+
+onBeforeUnmount(() => {
+  if (unsubscribeHeartbeat) unsubscribeHeartbeat()
+})
+
+async function publish() {
+  publishing.value = true
+  error.value = ""
+  ok.value = ""
+  try {
+    const data = await postPublish({
+      projectId: props.projectId || null,
+      sessionId: props.sessionId,
+    })
+    ok.value = '发布成功！页面即将跳转...'
+    setTimeout(() => { window.location.href = `/articles/generated/${data.slug}` }, 1500)
+  } catch (e: any) {
+    error.value = e instanceof EchoApiError && e.status === 409
+      ? '已经是最新快照'
+      : e.message || '网络错误'
+  } finally {
+    publishing.value = false
+  }
+}
+</script>

package/docs/.vitepress/theme/components/EchoProjectTabs.vue

@@ -0,0 +1,132 @@
+<template>
+  <div class="echo-project-tabs" aria-label="项目筛选">
+    <a
+      v-for="tab in tabs"
+      :key="tab.key"
+      :href="`#${encodeURIComponent(tab.anchor)}`"
+      class="echo-project-tab"
+      :class="{ 'echo-project-tab-active': tab.key === selectedKey }"
+      @click.prevent="select(tab.key)"
+    >
+      {{ tab.label }}<span>{{ tab.articles.length }}</span>
+    </a>
+  </div>
+
+  <div class="echo-article-grid">
+    <a
+      v-for="article in selectedArticles"
+      :key="article.href"
+      class="echo-article-card"
+      :href="article.href"
+    >
+      <strong>{{ article.title }}</strong>
+      <small>{{ article.updated || '-' }}</small>
+      <p>{{ article.summary || '无摘要' }}</p>
+      <div v-if="article.tags.length" class="echo-tags">
+        <span v-for="tag in article.tags" :key="tag">{{ tag }}</span>
+      </div>
+    </a>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, onMounted, onUnmounted, ref, watch } from 'vue'
+import { useProjectFilter } from '../lib/useProjectFilter'
+
+type ProjectArticle = {
+  href: string
+  summary?: string
+  tags: string[]
+  title: string
+  updated?: string
+}
+
+type ProjectGroup = {
+  anchor: string
+  articles: ProjectArticle[]
+  key: string
+  label: string
+}
+
+const props = defineProps<{ payload: string }>()
+
+const projectFilter = useProjectFilter()
+
+const projectGroups = computed<ProjectGroup[]>(() => {
+  try {
+    return JSON.parse(decodeURIComponent(props.payload)) as ProjectGroup[]
+  } catch {
+    return []
+  }
+})
+
+const allTab = computed<ProjectGroup>(() => ({
+  anchor: 'project-all',
+  articles: projectGroups.value.flatMap((group) => group.articles),
+  key: '__all__',
+  label: '全部',
+}))
+
+const emptyProjectTabs = computed<ProjectGroup[]>(() => {
+  const withArticles = new Set(projectGroups.value.map((group) => group.key))
+  return projectFilter.allProjects.value
+    .filter((project) => !withArticles.has(project.id))
+    .map((project) => ({
+      anchor: `project-${project.id}`,
+      articles: [],
+      key: project.id,
+      label: project.name,
+    }))
+})
+
+const tabs = computed(() => [allTab.value, ...projectGroups.value, ...emptyProjectTabs.value])
+const selectedKey = ref('__all__')
+
+const selectedArticles = computed(() => {
+  return tabs.value.find((tab) => tab.key === selectedKey.value)?.articles || []
+})
+
+function resolveTabKey(projectId: string): string {
+  if (projectId === '__all__') return '__all__'
+  const tab = tabs.value.find((t) => t.key === projectId)
+  return tab ? tab.key : '__all__'
+}
+
+function syncFromHash() {
+  const hash = decodeURIComponent(window.location.hash.slice(1) || '')
+  const tab = tabs.value.find((item) => item.anchor === hash)
+  selectedKey.value = tab?.key || '__all__'
+}
+
+function select(key: string) {
+  selectedKey.value = key
+  // Also update the global filter so nav dropdown syncs
+  projectFilter.select(key === '__all__' ? '__all__' : key)
+}
+
+function syncFromProjectFilter(projectId: string) {
+  selectedKey.value = resolveTabKey(projectId)
+}
+
+// Sync with global project filter (nav dropdown), including async project loads.
+watch(
+  () => [projectFilter.selectedProject.value, tabs.value.map((tab) => tab.key).join('|')],
+  ([projectId]) => syncFromProjectFilter(projectId),
+)
+
+onMounted(() => {
+  projectFilter.load()
+  projectFilter.restore()
+  // If global filter is set, use it; otherwise fall back to hash
+  if (projectFilter.selectedProject.value !== '__all__') {
+    syncFromProjectFilter(projectFilter.selectedProject.value)
+  } else {
+    syncFromHash()
+  }
+  window.addEventListener('hashchange', syncFromHash)
+})
+
+onUnmounted(() => {
+  window.removeEventListener('hashchange', syncFromHash)
+})
+</script>

package/docs/.vitepress/theme/components/EchoSearchLanding.vue

@@ -0,0 +1,215 @@
+<template></template>
+
+<script setup lang="ts">
+import { nextTick, onMounted, onUnmounted, watch } from 'vue'
+import { useRoute } from 'vitepress'
+
+const route = useRoute()
+const STORAGE_KEY = 'echo:lastSearchQuery'
+const APPLIED_KEY = 'echo:lastSearchApplied'
+const MAX_AGE_MS = 2 * 60 * 1000
+let memorySearch: StoredSearch | null = null
+let memoryApplied = ''
+
+type StoredSearch = {
+  query: string
+  ts: number
+}
+
+function readStoredSearch(): StoredSearch | null {
+  if (memorySearch && Date.now() - memorySearch.ts <= MAX_AGE_MS) return memorySearch
+  try {
+    const raw = window.sessionStorage?.getItem(STORAGE_KEY)
+    if (!raw) return null
+    const parsed = JSON.parse(raw) as StoredSearch
+    if (!parsed.query || Date.now() - parsed.ts > MAX_AGE_MS) return null
+    return parsed
+  } catch {
+    return null
+  }
+}
+
+function writeSearchQuery(query: string) {
+  const value = query.trim()
+  if (!value) return
+  memorySearch = { query: value, ts: Date.now() }
+  try {
+    window.sessionStorage?.setItem(STORAGE_KEY, JSON.stringify(memorySearch))
+  } catch {}
+}
+
+function isSearchInput(input: HTMLInputElement): boolean {
+  const text = [
+    input.type,
+    input.placeholder,
+    input.ariaLabel,
+    input.className,
+    input.id,
+    input.closest('[class*="Search"], [class*="search"], [id*="Search"], [id*="search"]')?.className || '',
+  ].join(' ')
+  return /search|docsearch|搜索/i.test(text)
+}
+
+function currentSearchQuery(): string {
+  const active = document.activeElement
+  if (active instanceof HTMLInputElement && isSearchInput(active)) return active.value.trim()
+
+  const inputs = Array.from(document.querySelectorAll<HTMLInputElement>('input'))
+  const found = inputs.find((input) => isSearchInput(input) && input.value.trim())
+  return found?.value.trim() || ''
+}
+
+function rememberSearchQuery() {
+  const query = currentSearchQuery()
+  if (query) writeSearchQuery(query)
+}
+
+function handleInput(event: Event) {
+  const target = event.target
+  if (target instanceof HTMLInputElement && isSearchInput(target)) {
+    writeSearchQuery(target.value)
+  }
+}
+
+function handlePointerDown(event: Event) {
+  const target = event.target as HTMLElement | null
+  if (!target) return
+  if (target.closest('a, button, [role="option"], [role="link"], [role="button"]')) {
+    rememberSearchQuery()
+    scheduleSearchLanding()
+  }
+}
+
+function handleKeyDown(event: KeyboardEvent) {
+  if (event.key === 'Enter') {
+    rememberSearchQuery()
+    scheduleSearchLanding()
+  }
+}
+
+function unwrapPreviousHighlights(root: Element) {
+  const marks = Array.from(root.querySelectorAll('mark.echo-search-hit'))
+  for (const mark of marks) {
+    mark.replaceWith(document.createTextNode(mark.textContent || ''))
+  }
+  root.normalize()
+}
+
+function shouldSkipNode(node: Node): boolean {
+  const parent = node.parentElement
+  if (!parent) return true
+  return !!parent.closest('script, style, pre, code, textarea, input, select, button, nav, .echo-toolbar, .echo-modal, .echo-sel-popup, .echo-comment-box')
+}
+
+function highlightTextNode(node: Text, query: string): HTMLElement[] {
+  const text = node.nodeValue || ''
+  const lowerText = text.toLowerCase()
+  const lowerQuery = query.toLowerCase()
+  const hits: HTMLElement[] = []
+  let index = lowerText.indexOf(lowerQuery)
+  if (index === -1) return hits
+
+  const fragment = document.createDocumentFragment()
+  let cursor = 0
+  while (index !== -1) {
+    if (index > cursor) {
+      fragment.appendChild(document.createTextNode(text.slice(cursor, index)))
+    }
+    const mark = document.createElement('mark')
+    mark.className = 'echo-search-hit'
+    mark.textContent = text.slice(index, index + query.length)
+    fragment.appendChild(mark)
+    hits.push(mark)
+    cursor = index + query.length
+    index = lowerText.indexOf(lowerQuery, cursor)
+  }
+  if (cursor < text.length) {
+    fragment.appendChild(document.createTextNode(text.slice(cursor)))
+  }
+
+  node.replaceWith(fragment)
+  return hits
+}
+
+function highlightQuery(root: Element, query: string): HTMLElement[] {
+  const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+    acceptNode(node) {
+      if (shouldSkipNode(node)) return NodeFilter.FILTER_REJECT
+      return (node.nodeValue || '').toLowerCase().includes(query.toLowerCase())
+        ? NodeFilter.FILTER_ACCEPT
+        : NodeFilter.FILTER_REJECT
+    },
+  })
+
+  const nodes: Text[] = []
+  while (walker.nextNode()) nodes.push(walker.currentNode as Text)
+  return nodes.flatMap((node) => highlightTextNode(node, query))
+}
+
+function bestHit(hits: HTMLElement[]): HTMLElement | null {
+  if (hits.length === 0) return null
+
+  const hash = decodeURIComponent(location.hash.slice(1))
+  const hashTarget = hash ? document.getElementById(hash) : null
+  const anchorTop = hashTarget
+    ? hashTarget.getBoundingClientRect().top + window.scrollY
+    : window.scrollY + 120
+
+  return hits
+    .map((hit) => {
+      const rect = hit.getBoundingClientRect()
+      const top = rect.top + window.scrollY
+      return { hit, distance: Math.abs(top - anchorTop) }
+    })
+    .sort((a, b) => a.distance - b.distance)[0].hit
+}
+
+function applySearchLanding() {
+  const stored = readStoredSearch()
+  const root = document.querySelector('.vp-doc')
+  if (!stored || !root) return
+
+  const applyKey = `${location.pathname}${location.hash}:${stored.query}:${stored.ts}`
+  let applied = memoryApplied
+  try {
+    applied = window.sessionStorage?.getItem(APPLIED_KEY) || memoryApplied
+  } catch {}
+  if (applied === applyKey) return
+
+  unwrapPreviousHighlights(root)
+  const hits = highlightQuery(root, stored.query)
+  const target = bestHit(hits)
+  if (!target) return
+
+  memoryApplied = applyKey
+  try {
+    window.sessionStorage?.setItem(APPLIED_KEY, applyKey)
+  } catch {}
+  target.classList.add('echo-search-hit-active')
+  target.scrollIntoView({ behavior: 'smooth', block: 'center' })
+}
+
+function scheduleSearchLanding() {
+  window.setTimeout(() => {
+    nextTick(() => applySearchLanding())
+  }, 120)
+}
+
+onMounted(() => {
+  document.addEventListener('input', handleInput, true)
+  document.addEventListener('pointerdown', handlePointerDown, true)
+  document.addEventListener('keydown', handleKeyDown, true)
+  scheduleSearchLanding()
+})
+
+onUnmounted(() => {
+  document.removeEventListener('input', handleInput, true)
+  document.removeEventListener('pointerdown', handlePointerDown, true)
+  document.removeEventListener('keydown', handleKeyDown, true)
+})
+
+watch(
+  () => route.path,
+  () => scheduleSearchLanding(),
+)
+</script>