echoctl 0.1.0 → 0.1.2

package/docs/.vitepress/config.mts

@@ -0,0 +1,38 @@
+import { defineConfig } from 'vitepress'
+import { articleSidebar } from './echo-sidebar.mts'
+
+export default defineConfig({
+  title: 'Echo 知识库',
+  description: '本地优先的 AI 对话知识论坛',
+
+  themeConfig: {
+    nav: [
+      { text: '首页', link: '/' },
+      { text: '文章', link: '/articles/', activeMatch: '^/articles/' },
+      { text: '标签', link: '/tags/', activeMatch: '^/tags/' },
+    ],
+
+    sidebar: {
+      '/articles/': articleSidebar,
+      '/live/': articleSidebar,
+    },
+
+    socialLinks: [],
+
+    search: {
+      provider: 'local',
+    },
+
+    footer: {
+      message: '基于 Echo 管线生成',
+    },
+
+    lastUpdated: {
+      text: '最后更新',
+    },
+  },
+
+  markdown: {
+    // Preserve HTML comments (turn markers) in output for custom theme processing
+  },
+})

package/docs/.vitepress/echo-sidebar.mts

@@ -0,0 +1,52 @@
+export const articleSidebar = [
+  {
+    text: '文章列表',
+    items: [
+      { text: '全部文章', link: '/articles/' },
+      {
+        text: '最近文章',
+        collapsed: true,
+        items: [
+            { text: "/claude-mem:learn-codebase", link: '/articles/generated/session-2026-05-25' },
+            { text: "/gstack 做得不错，不过你都测试和review了吗？", link: '/articles/generated/session-2026-05-20' },
+            { text: "/office-hours 针对 @ECHO_STATUS.md 中的“产品表层设计讨论 (2026-05-24)...", link: '/articles/generated/session-2026-05-24' },
+            { text: "/superpowers:using-superpowers 我们继续 @ECHO_STATUS.md 中的“进行...", link: '/articles/generated/session-2026-05-21' },
+            { text: "/understand-anything:understand --language zh", link: '/articles/generated/session-2026-05-22' },
+            { text: "我在另一个会话中，让DeepSeek TUI带着DeepSeek，正在实现mcp server的事情。我们这个会话...", link: '/articles/generated/session-2026-05-23' },
+            { text: "我先说我的想法：1/当前我和ai的对话，有很多都是精妙绝伦的，但是我让ai处理之后他们总是会经过压缩，这样精妙的地...", link: '/articles/generated/session-d65985f1' },
+            { text: "把gstack叫出来，我们理解好当前项目之后。就继续干活吧。", link: '/articles/generated/session-e5239574' },
+            { text: "hello，早上好。我发现了一个小问题，你看 ~/.echo-buffer/session-2026-05-19....", link: '/articles/generated/session-66a8dd03' },
+            { text: "ok，而且我希望你能够加上 ~/.gstack/projects/echo-prototype/vincenthu...", link: '/articles/generated/session-b1c78bb2' }
+        ],
+      },
+      {
+        text: '项目',
+        collapsed: false,
+        items: [
+          {
+            text: "mynote (16)",
+            collapsed: false,
+            items: [
+                { text: "/claude-mem:learn-codebase", link: '/articles/generated/session-2026-05-25' },
+                { text: "/gstack 做得不错，不过你都测试和review了吗？", link: '/articles/generated/session-2026-05-20' },
+                { text: "/office-hours 针对 @ECHO_STATUS.md 中的“产品表层设计讨论 (2026-05-24)...", link: '/articles/generated/session-2026-05-24' },
+                { text: "/superpowers:using-superpowers 我们继续 @ECHO_STATUS.md 中的“进行...", link: '/articles/generated/session-2026-05-21' },
+                { text: "/understand-anything:understand --language zh", link: '/articles/generated/session-2026-05-22' },
+                { text: "我在另一个会话中，让DeepSeek TUI带着DeepSeek，正在实现mcp server的事情。我们这个会话...", link: '/articles/generated/session-2026-05-23' },
+                { text: "我先说我的想法：1/当前我和ai的对话，有很多都是精妙绝伦的，但是我让ai处理之后他们总是会经过压缩，这样精妙的地...", link: '/articles/generated/session-d65985f1' },
+                { text: "把gstack叫出来，我们理解好当前项目之后。就继续干活吧。", link: '/articles/generated/session-e5239574' },
+                { text: "hello，早上好。我发现了一个小问题，你看 ~/.echo-buffer/session-2026-05-19....", link: '/articles/generated/session-66a8dd03' },
+                { text: "ok，而且我希望你能够加上 ~/.gstack/projects/echo-prototype/vincenthu...", link: '/articles/generated/session-b1c78bb2' },
+                { text: "恢复上次的 office-hours 会话，我们在设计 Echo 知识论坛.", link: '/articles/generated/session-130a0fec' },
+                { text: "我们当前项目的任务是：1/完整记录每一个和ai对话的会话内容；2/方便人类有了新的想法之后，查找并且快速的评论，还...", link: '/articles/generated/session-3b0917ca' },
+                { text: "发一条测试消息，看看 hook 有没有触发", link: '/articles/generated/session-2026-05-19' },
+                { text: "从零设计 Echo 知识论坛——多 AI 协作实录", link: '/articles/generated/echo-design-session-v2' },
+                { text: "从零设计 Echo 知识论坛——一次真正的 AI 协作实录", link: '/articles/generated/echo-design-session' },
+                { text: "为什么你应该把 AI 对话存下来", link: '/articles/generated/article-ai-dialogue' }
+            ],
+          }
+        ],
+      },
+    ],
+  },
+]

package/docs/.vitepress/theme/Layout.vue

@@ -0,0 +1,28 @@
+<script setup lang="ts">
+import DefaultTheme from 'vitepress/theme'
+import { useData } from 'vitepress'
+import { computed } from 'vue'
+
+const { frontmatter } = useData()
+const echoInteractive = computed(() => !!(frontmatter.value as any)?.echo?.interactive)
+</script>
+
+<template>
+  <EchoSearchLanding />
+  <EchoChatBubbles />
+  <EchoLegacyRecovery />
+  <DefaultTheme.Layout>
+    <template #nav-bar-content-after>
+      <EchoGlobalControls />
+    </template>
+    <template #doc-bottom>
+      <div v-if="echoInteractive" class="echo-doc-bottom">
+        <div class="echo-doc-bottom-inner">
+          <EchoArticleActions />
+          <EchoCommentChain />
+        </div>
+      </div>
+      <EchoSelectionComment v-if="echoInteractive" />
+    </template>
+  </DefaultTheme.Layout>
+</template>

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

@@ -0,0 +1,235 @@
+<template>
+  <div v-if="state === 'unavailable'" class="echo-serve-notice">
+    Echo API 未运行 — 运行 <code>echoctl serve</code> 以启用评论和标记
+  </div>
+
+  <div class="echo-tag-strip">
+    <span class="echo-tag-strip-label">标记</span>
+    <div class="echo-existing-tags" v-if="existingTags.length">
+      <span v-for="tag in existingTags" :key="tag" class="echo-tag-chip">
+        {{ tag }}
+        <button
+          class="echo-tag-remove"
+          :disabled="state !== 'ready' || removingTags.has(tag)"
+          title="删除标记"
+          @click="removeTag(tag)"
+        >×</button>
+      </span>
+    </div>
+    <div class="echo-tag-form">
+      <input
+        v-model="tagText"
+        placeholder="添加文章标记"
+        :disabled="state !== 'ready'"
+        @keydown.enter.prevent="submitTag"
+      />
+      <button
+        class="echo-btn"
+        :disabled="state !== 'ready' || !tagText.trim() || tagging"
+        @click="submitTag"
+      >
+        {{ tagging ? '添加中...' : '添加' }}
+      </button>
+    </div>
+    <span v-if="tagError" class="echo-inline-error">{{ tagError }}</span>
+  </div>
+
+  <div class="echo-summary-strip">
+    <span class="echo-summary-strip-label">摘要</span>
+    <textarea
+      v-model="summaryText"
+      placeholder="文章摘要..."
+      rows="2"
+      :disabled="state !== 'ready' || savingSummary"
+    ></textarea>
+    <div class="echo-summary-actions">
+      <button
+        class="echo-btn"
+        :disabled="state !== 'ready' || savingSummary || summaryText === originalSummary"
+        @click="saveSummary"
+      >
+        {{ savingSummary ? '保存中...' : '保存摘要' }}
+      </button>
+      <span v-if="summaryError" class="echo-inline-error">{{ summaryError }}</span>
+      <span v-if="summarySaved" class="echo-inline-ok">{{ summarySaved }}</span>
+    </div>
+  </div>
+
+  <div v-if="canPublish" class="echo-publish-strip">
+    <button
+      class="echo-btn"
+      :disabled="state !== 'ready' || publishing"
+      @click="publishLatest"
+    >
+      {{ publishing ? '发布中...' : '发布最新快照' }}
+    </button>
+    <span v-if="publishMessage" class="echo-inline-ok">{{ publishMessage }}</span>
+    <span v-if="publishError" class="echo-inline-error">{{ publishError }}</span>
+  </div>
+
+  <div class="echo-comment-box">
+    <h3>发表评论</h3>
+    <textarea
+      v-model="commentText"
+      placeholder="对整篇文章的评论..."
+      rows="3"
+      :disabled="state !== 'ready'"
+    ></textarea>
+    <button
+      class="echo-btn"
+      :disabled="state !== 'ready' || !commentText.trim() || submitting"
+      @click="submitComment"
+    >
+      {{ submitting ? '提交中...' : '提交评论' }}
+    </button>
+    <span v-if="submitError" style="color:var(--vp-c-danger-1);font-size:13px;">{{ submitError }}</span>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, watch } from 'vue'
+import { useData } from 'vitepress'
+import { useEchoStatus } from '../lib/useEchoStatus'
+import { EchoApiError, postComment, postPublish, postTag, removeTags, updateSummary } from '../lib/echo-api'
+
+const { frontmatter } = useData()
+const articleId = computed(() => (frontmatter.value as any)?.echo?.articleId as string | undefined)
+const projectId = computed(() => (frontmatter.value as any)?.echo?.projectId as string | null | undefined)
+
+const { state, status } = useEchoStatus(articleId)
+
+const commentText = ref('')
+const submitting = ref(false)
+const submitError = ref('')
+const existingTags = computed(() => {
+  const tags = (frontmatter.value as any)?.tags
+  return Array.isArray(tags) ? tags : []
+})
+const removingTags = ref<Set<string>>(new Set())
+const tagText = ref('')
+const tagging = ref(false)
+const tagError = ref('')
+const summaryText = ref('')
+const originalSummary = ref('')
+const savingSummary = ref(false)
+const summaryError = ref('')
+const summarySaved = ref('')
+const publishing = ref(false)
+const publishMessage = ref('')
+const publishError = ref('')
+const canPublish = computed(() => !!articleId.value?.startsWith('session-'))
+
+watch(articleId, () => {
+  tagError.value = ''
+  submitError.value = ''
+  publishMessage.value = ''
+  publishError.value = ''
+  tagText.value = ''
+  commentText.value = ''
+  summaryError.value = ''
+  summarySaved.value = ''
+  const s = (frontmatter.value as any)?.summary || ''
+  summaryText.value = s
+  originalSummary.value = s
+})
+
+async function submitComment() {
+  if (!articleId.value || !commentText.value.trim()) return
+  submitting.value = true
+  submitError.value = ''
+  try {
+    await postComment({
+      articleId: articleId.value,
+      comment: commentText.value.trim(),
+      scope: 'article',
+      author: status.value?.author,
+      projectId: projectId.value ?? null,
+    })
+    commentText.value = ''
+    submitError.value = '评论已提交，即将刷新...'
+    setTimeout(() => location.reload(), 1200)
+  } catch (err: any) {
+    submitError.value = err.message || '提交失败'
+  } finally {
+    submitting.value = false
+  }
+}
+
+async function submitTag() {
+  if (!articleId.value || !tagText.value.trim()) return
+  tagging.value = true
+  tagError.value = ''
+  try {
+    await postTag({
+      articleId: articleId.value,
+      tag: tagText.value.trim(),
+      projectId: projectId.value ?? null,
+    })
+    tagText.value = ''
+    location.reload()
+  } catch (err: any) {
+    tagError.value = err.message || '创建失败'
+  } finally {
+    tagging.value = false
+  }
+}
+
+async function removeTag(tag: string) {
+  if (!articleId.value) return
+  removingTags.value = new Set([...removingTags.value, tag])
+  tagError.value = ''
+  try {
+    await removeTags({
+      articleId: articleId.value,
+      tags: [tag],
+      projectId: projectId.value ?? null,
+    })
+    location.reload()
+  } catch (err: any) {
+    tagError.value = err.message || '删除失败'
+    removingTags.value = new Set([...removingTags.value].filter(t => t !== tag))
+  }
+}
+
+async function saveSummary() {
+  if (!articleId.value) return
+  savingSummary.value = true
+  summaryError.value = ''
+  summarySaved.value = ''
+  try {
+    await updateSummary({
+      articleId: articleId.value,
+      summary: summaryText.value.trim(),
+      projectId: projectId.value ?? null,
+    })
+    originalSummary.value = summaryText.value.trim()
+    summarySaved.value = '摘要已保存'
+    setTimeout(() => { summarySaved.value = '' }, 3000)
+  } catch (err: any) {
+    summaryError.value = err.message || '保存失败'
+  } finally {
+    savingSummary.value = false
+  }
+}
+
+async function publishLatest() {
+  if (!articleId.value) return
+  publishing.value = true
+  publishMessage.value = ''
+  publishError.value = ''
+  try {
+    const result = await postPublish({
+      sessionId: articleId.value,
+      projectId: projectId.value ?? null,
+    })
+    publishMessage.value = '发布成功，即将跳转...'
+    setTimeout(() => { window.location.href = `/articles/generated/${result.slug}` }, 1000)
+  } catch (err: any) {
+    publishError.value = err instanceof EchoApiError && err.status === 409
+      ? '已经是最新快照'
+      : err.message || '发布失败'
+  } finally {
+    publishing.value = false
+  }
+}
+</script>

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

@@ -0,0 +1,153 @@
+<template></template>
+
+<script setup lang="ts">
+import { onMounted, onUnmounted, watch } from 'vue'
+import { useRoute } from 'vitepress'
+
+const route = useRoute()
+
+function isUserSpeaker(speaker: string): boolean {
+  const s = speaker.toLowerCase()
+  return s === 'vincent' || s === 'user' || s === '我' || s === 'human'
+}
+
+function isAssistantSpeaker(speaker: string): boolean {
+  const s = speaker.toLowerCase()
+  return s === 'ai' || s === 'claude' || s === 'assistant' || s === 'codex'
+}
+
+function shouldStopAt(el: Element): boolean {
+  const tag = el.tagName
+  if (tag === 'H2' || tag === 'H1') {
+    const id = el.id || ''
+    return /评论|comment|标注|annotation/i.test(id)
+  }
+  const cls = el.className || ''
+  if (typeof cls === 'string') {
+    return /echo-comment-list|echo-comment-box|echo-toolbar|echo-tag-box|echo-serve-notice/i.test(cls)
+  }
+  return false
+}
+
+function markerBoundary(marker: Element): Element {
+  const parent = marker.parentElement
+  if (
+    parent?.tagName === 'P' &&
+    parent.children.length === 1 &&
+    parent.textContent?.trim() === ''
+  ) {
+    return parent
+  }
+  return marker
+}
+
+function chatify() {
+  const doc = document.querySelector('.vp-doc')
+  if (!doc) return
+
+  if (doc.hasAttribute('data-echo-chatified')) return
+
+  const markers = Array.from(doc.querySelectorAll('.echo-turn-marker'))
+  if (markers.length === 0) return
+  const boundaries = markers.map(markerBoundary)
+
+  for (let i = 0; i < markers.length; i++) {
+    const marker = markers[i]
+    const speaker = marker.getAttribute('data-speaker') || 'unknown'
+    const boundary = boundaries[i]
+    const nextBoundary = boundaries[i + 1] || null
+
+    boundary.classList.add('echo-turn-boundary')
+
+    const nodes: Node[] = []
+    let cursor: Node | null = boundary.nextSibling
+
+    while (cursor) {
+      if (nextBoundary && cursor === nextBoundary) break
+      if (cursor instanceof Element && shouldStopAt(cursor)) break
+      if (cursor instanceof Element && cursor.classList.contains('echo-turn-marker')) break
+      if (cursor instanceof Element && cursor.classList.contains('echo-turn-boundary')) break
+
+      const next: Node | null = cursor.nextSibling
+      nodes.push(cursor)
+      cursor = next
+    }
+
+    if (nodes.length === 0) continue
+
+    let bubbleClass = 'echo-chat-assistant'
+    if (isUserSpeaker(speaker)) {
+      bubbleClass = 'echo-chat-user'
+    } else if (!isAssistantSpeaker(speaker)) {
+      bubbleClass = 'echo-chat-unknown'
+    }
+
+    const wrapper = document.createElement('div')
+    wrapper.className = `echo-chat-turn ${bubbleClass}`
+
+    boundary.after(wrapper)
+    for (const node of nodes) {
+      wrapper.appendChild(node)
+    }
+  }
+
+  doc.setAttribute('data-echo-chatified', '')
+}
+
+function dechatify() {
+  const doc = document.querySelector('.vp-doc')
+  if (!doc) return
+  doc.removeAttribute('data-echo-chatified')
+
+  const turns = Array.from(doc.querySelectorAll('.echo-chat-turn'))
+  for (const turn of turns) {
+    const parent = turn.parentNode
+    if (!parent) continue
+    while (turn.firstChild) {
+      parent.insertBefore(turn.firstChild, turn)
+    }
+    parent.removeChild(turn)
+  }
+
+  for (const boundary of Array.from(doc.querySelectorAll('.echo-turn-boundary'))) {
+    boundary.classList.remove('echo-turn-boundary')
+  }
+}
+
+let observer: MutationObserver | null = null
+
+function setup() {
+  dechatify()
+  if (observer) observer.disconnect()
+
+  const doc = document.querySelector('.vp-doc')
+  if (doc && !doc.hasAttribute('data-echo-chatified')) {
+    chatify()
+  }
+
+  observer = new MutationObserver(() => {
+    const d = document.querySelector('.vp-doc')
+    if (d && !d.hasAttribute('data-echo-chatified') && d.querySelector('.echo-turn-marker')) {
+      chatify()
+    }
+  })
+
+  const content = document.querySelector('.VPContent')
+  if (content) {
+    observer.observe(content, { childList: true, subtree: true })
+  }
+}
+
+onMounted(() => {
+  setup()
+})
+
+watch(() => route.path, () => {
+  setTimeout(setup, 100)
+})
+
+onUnmounted(() => {
+  if (observer) observer.disconnect()
+  dechatify()
+})
+</script>