encore-ai 0.1.0__tar.gz

encore_ai-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: encore-ai
+Version: 0.1.0
+Summary: AI对话知识归档工具 — 让每一次AI对话都成为你的数字资产
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0

encore_ai-0.1.0/README.md

@@ -0,0 +1,71 @@
+# Encore — 让每一次 AI 对话，都成为你的数字资产
+
+## 痛点：被遗忘的"数字黄金"
+
+每天，我们都在与 ChatGPT、Claude、Cursor 进行着极具价值的对话。我们排查了深度的代码 Bug，探讨了绝妙的产品架构，学习了晦涩的技术概念。
+
+但是，当你关掉对话框的那一刻，这些知识就随之消散了。下一次遇到同样的报错，你依然需要重新提问；那些 AI 建议你"下一步该做的事"，转头就被遗忘。
+
+**对话是碎片的，但知识不应该是。**
+
+## 什么是 Encore？
+
+Encore 不是另一款笔记软件，而是一个**意图驱动的 AI 知识路由器**。
+
+它寄生在你已有的 AI 对话环境中（Claude Code、IDE、浏览器）。它能听懂你与 AI 的对话，自动剥离废话，提取核心价值，并将其转化为结构化的文档和待办事项，精准投递到你现有的工作流中。
+
+**你只管和 AI 解决问题，Encore 负责帮你记住一切。**
+
+## 核心特性
+
+### 零摩擦捕获
+
+"最好的工具，是让你感觉不到它的存在。"
+
+Encore 拒绝让你在多个软件间复制粘贴。通过内嵌于 Claude Code 的 Skill、IDE 插件和浏览器扩展，Encore 直接驻留在你的对话发生地。一个指令或一次点击，剩下的工作全部在后台静默完成。
+
+### 动态意图解析
+
+Encore 不做简单的"聊天记录导出"。它拥有自己的思考中枢，能精准识别你对话的真实意图，并动态应用不同的沉淀模板：
+
+| 模式 | 自动提取 |
+|------|---------|
+| 🐛 排错模式 | 核心报错 → 踩坑记录 → 正确解决流程 → 最终代码 |
+| 📚 学习模式 | 核心概念 → 费曼技巧总结 → 拓展阅读 |
+| 💡 灵感模式 | 核心 Idea → 优劣势分析 → 落地步骤 |
+
+### 智能资产分发
+
+Encore 遵循"让信息去该去的地方"原则，无缝对接你现有的生产力工具：
+
+- 复盘文档与知识点 → 自动写入 Notion / Obsidian
+- 高频工具函数 → 自动剥离并存入 GitHub Gist
+- 下一步行动指南 → 自动转化为待办任务，推送到 Todoist
+
+### 记忆回响
+
+"存下来的知识，能在需要时自动跳出来，才叫外脑。"
+
+当你再次遇到类似的报错时，Encore 会被唤醒并提醒你："上个月你遇到过类似问题，当时的复盘文档在这里，要不要先看看？"
+
+### AI 上下文接力
+
+"跨 AI 对话，不丢失上下文。"
+
+每个归档笔记都会自动生成一份 `context_digest`——2000 字以内的结构化摘要。下一个 AI 读完就能直接接手，无需重复解释背景。**50 轮对话的核心信息，压缩到一张卡片。**
+
+## 产品形态
+
+Encore 采用 **"前端寄生，后端独立"** 的架构：
+
+- **Encore for Claude Code** — 基于 Claude Code Skill 打造，终端环境下的一键知识归档
+- **Encore Browser Extension** — 嵌入 ChatGPT / Claude Web 端，一键沉淀网页对话
+- **Encore Workflow** — 基于 LangGraph 的异步处理引擎，负责意图识别与数据分发
+
+## 愿景
+
+Encore 的终极目标，是为你打造一个真正懂你的**认知外脑**。
+
+随着时间的推移，Encore 沉淀的不仅是文档，更是你个人的思考路径、踩坑经验和成长轨迹。让 AI 不仅是你解决当下问题的工具，更是你积累终身数字资产的合伙人。
+
+**Encore — 念念不忘，必有回响。**

encore_ai-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "encore-ai"
+version = "0.1.0"
+description = "AI对话知识归档工具 — 让每一次AI对话都成为你的数字资产"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+encore = "encore.cli:main"
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+encore = ["encore_schema_v0.1.json"]

encore_ai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

encore_ai-0.1.0/src/encore/__init__.py

@@ -0,0 +1,3 @@
+"""Encore — AI 对话知识归档工具"""
+
+__version__ = "0.1.0"

encore_ai-0.1.0/src/encore/cli.py

@@ -0,0 +1,93 @@
+"""Encore CLI — AI 对话知识归档命令行工具"""
+
+import json
+import click
+from datetime import datetime, timezone
+
+from .storage import save, list_notes, search
+from .schema import validate
+
+
+@click.group()
+def main():
+    """Encore — AI 对话知识归档工具"""
+    pass
+
+
+@main.command()
+@click.argument("data", required=False)
+@click.option("--file", "-f", "json_file", type=click.Path(exists=True), help="从 JSON 文件读取")
+def save_cmd(data: str | None, json_file: str | None):
+    """保存一条结构化笔记。传入 JSON 字符串，或通过 --file 指定 JSON 文件。
+
+    \b
+    示例:
+      encore save '{"title":"测试","intent":"learning","context_digest":"...","payload":{...}}'
+      encore save --file note.json
+    """
+    if json_file:
+        with open(json_file, "r", encoding="utf-8") as f:
+            data = f.read()
+
+    if not data:
+        click.echo("错误: 请提供 JSON 数据或使用 --file 指定文件", err=True)
+        raise SystemExit(1)
+
+    try:
+        note = json.loads(data)
+    except json.JSONDecodeError as e:
+        click.echo(f"JSON 解析错误: {e}", err=True)
+        raise SystemExit(1)
+
+    # Fill defaults
+    if "created_at" not in note:
+        note["created_at"] = datetime.now(timezone.utc).isoformat()
+    if "status" not in note:
+        note["status"] = "resolved"
+    if "source_environment" not in note:
+        note["source_environment"] = "claude_code"
+
+    # Validate
+    errors = validate(note)
+    if errors:
+        for e in errors:
+            click.echo(f"校验错误: {e}", err=True)
+        raise SystemExit(1)
+
+    # Save
+    filepath = save(note)
+    click.echo(f"✅ 已归档: {filepath}")
+
+
+@main.command()
+@click.option("--intent", "-i", type=click.Choice(["bug_fix", "learning", "idea"]), help="按意图过滤")
+def list_cmd(intent: str | None):
+    """列出所有已归档笔记"""
+    notes = list_notes(intent)
+    if not notes:
+        click.echo("暂无归档笔记。")
+        return
+
+    click.echo(f"共 {len(notes)} 条笔记:\n")
+    for n in notes:
+        intent_icon = {"bug_fix": "🐛", "learning": "📚", "idea": "💡"}.get(n.get("intent", ""), "📝")
+        title = n.get("title", "未命名")
+        click.echo(f"  {intent_icon} {title}")
+        click.echo(f"    文件: {n['_file']}  |  {n.get('created_at', '')}")
+
+
+@main.command()
+@click.argument("keyword")
+def search_cmd(keyword: str):
+    """按关键词搜索笔记（匹配标题和标签）"""
+    results = search(keyword)
+    if not results:
+        click.echo(f"未找到与 '{keyword}' 相关的笔记。")
+        return
+
+    click.echo(f"找到 {len(results)} 条相关笔记:\n")
+    for n in results:
+        intent_icon = {"bug_fix": "🐛", "learning": "📚", "idea": "💡"}.get(n.get("intent", ""), "📝")
+        title = n.get("title", "未命名")
+        click.echo(f"  {intent_icon} {title}")
+        click.echo(f"    文件: {n['_file']}  |  标签: {', '.join(n.get('tags', []))}")

encore_ai-0.1.0/src/encore/encore_schema_v0.1.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WWBQ/Encore/encore_note_v0.1.json",
+  "title": "Encore Memory Standard v0.1",
+  "description": "一条归档笔记的数据契约。同时服务于人类回顾和 AI 上下文传递。",
+  "type": "object",
+  "required": ["encore_version", "intent", "title", "context_digest", "created_at"],
+  "properties": {
+    "encore_version": {
+      "type": "string",
+      "const": "0.1",
+      "description": "协议版本号"
+    },
+    "intent": {
+      "type": "string",
+      "enum": ["bug_fix", "learning", "idea"],
+      "description": "对话意图分类。bug_fix=排错 | learning=学习 | idea=灵感"
+    },
+    "title": {
+      "type": "string",
+      "maxLength": 120,
+      "description": "一句话标题，人类可读"
+    },
+    "source_environment": {
+      "type": "string",
+      "enum": ["claude_code", "chatgpt_web", "cursor", "windsurf", "other"],
+      "default": "claude_code"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["resolved", "in_progress", "open"],
+      "default": "resolved",
+      "description": "问题是否已解决"
+    },
+    "context_digest": {
+      "type": "string",
+      "maxLength": 2000,
+      "description": "给下一个 AI 看的压缩摘要。包含：做了什么、为什么这样做、关键决策、遗留问题。等价于 50 轮原始对话的核心信息量。"
+    },
+    "key_decision": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "本次对话中做出的核心决策"
+    },
+    "open_questions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "未解决的遗留问题"
+    },
+    "payload": {
+      "type": "object",
+      "description": "按意图类型填充的结构化详情",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/bug_fix_payload"
+        },
+        {
+          "$ref": "#/$defs/learning_payload"
+        },
+        {
+          "$ref": "#/$defs/idea_payload"
+        }
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "分类标签，用于检索"
+    }
+  },
+
+  "$defs": {
+    "bug_fix_payload": {
+      "type": "object",
+      "required": ["symptom", "root_cause", "solution"],
+      "properties": {
+        "symptom": { "type": "string", "description": "报错现象/症状描述" },
+        "root_cause": { "type": "string", "description": "根因分析" },
+        "failed_attempts": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "试过但失败的方法"
+        },
+        "solution_code": { "type": "string", "description": "最终可运行的代码" },
+        "solution_summary": { "type": "string", "description": "解决方案的文字总结" },
+        "action_items": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "后续待办事项"
+        }
+      }
+    },
+    "learning_payload": {
+      "type": "object",
+      "required": ["core_concept", "feynman_summary"],
+      "properties": {
+        "core_concept": { "type": "string", "description": "核心概念名称" },
+        "feynman_summary": { "type": "string", "description": "用费曼技巧一句话解释" },
+        "detailed_explanation": { "type": "string", "description": "详细解释" },
+        "related_concepts": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "关联概念"
+        },
+        "references": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "拓展阅读链接"
+        }
+      }
+    },
+    "idea_payload": {
+      "type": "object",
+      "required": ["core_idea", "pros_cons"],
+      "properties": {
+        "core_idea": { "type": "string", "description": "核心创意" },
+        "pros_cons": {
+          "type": "object",
+          "properties": {
+            "pros": { "type": "array", "items": { "type": "string" } },
+            "cons": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "action_steps": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "落地步骤拆解"
+        }
+      }
+    }
+  }
+}

encore_ai-0.1.0/src/encore/schema.py

@@ -0,0 +1,39 @@
+"""Schema 加载与基础校验"""
+
+import json
+from pathlib import Path
+
+SCHEMA_PATH = Path(__file__).parent / "encore_schema_v0.1.json"
+
+
+def load_schema() -> dict:
+    """加载数据 Schema 定义"""
+    with open(SCHEMA_PATH, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def validate(note: dict) -> list[str]:
+    """校验必填字段和枚举值，返回错误列表"""
+    errors = []
+    schema = load_schema()
+
+    # Required fields
+    for field in schema.get("required", []):
+        if field not in note or note[field] is None:
+            errors.append(f"缺少必填字段: {field}")
+
+    # Intent enum
+    intent = note.get("intent", "")
+    intent_schema = schema["properties"]["intent"]
+    valid_intents = intent_schema.get("enum", [])
+    if intent not in valid_intents:
+        errors.append(f"无效意图 '{intent}'，允许值: {valid_intents}")
+
+    # Status enum
+    status = note.get("status", "resolved")
+    status_schema = schema["properties"]["status"]
+    valid_statuses = status_schema.get("enum", [])
+    if status not in valid_statuses:
+        errors.append(f"无效状态 '{status}'，允许值: {valid_statuses}")
+
+    return errors

encore_ai-0.1.0/src/encore/storage.py

@@ -0,0 +1,173 @@
+"""笔记存储：本地 Markdown + YAML frontmatter"""
+
+import os
+import re
+import json
+import yaml
+from datetime import datetime
+from pathlib import Path
+
+NOTES_DIR = Path.home() / ".encore" / "notes"
+
+
+def _ensure_dir() -> Path:
+    NOTES_DIR.mkdir(parents=True, exist_ok=True)
+    return NOTES_DIR
+
+
+def _slugify(title: str) -> str:
+    """中英文标题转为文件名 safe slug"""
+    slug = re.sub(r"[^\w一-鿿-]", "-", title.strip())
+    slug = re.sub(r"-{2,}", "-", slug)
+    return slug.strip("-")[:80] or "untitled"
+
+
+def save(note: dict) -> Path:
+    """保存一条笔记，返回文件路径"""
+    _ensure_dir()
+
+    title = note.get("title", "未命名")
+    ts = note.get("created_at", datetime.now().astimezone().isoformat())
+    try:
+        dt = datetime.fromisoformat(ts)
+    except ValueError:
+        dt = datetime.now()
+    timestamp = dt.strftime("%Y-%m-%d-%H%M%S")
+    filename = f"{timestamp}--{_slugify(title)}.md"
+    filepath = NOTES_DIR / filename
+
+    # Build YAML frontmatter
+    frontmatter = {
+        "title": note.get("title", ""),
+        "intent": note.get("intent", ""),
+        "status": note.get("status", "resolved"),
+        "tags": note.get("tags", []),
+        "created_at": note.get("created_at", dt.isoformat()),
+        "source": note.get("source_environment", "claude_code"),
+    }
+    if note.get("key_decision"):
+        frontmatter["key_decision"] = note["key_decision"]
+    if note.get("open_questions"):
+        frontmatter["open_questions"] = note["open_questions"]
+
+    # Build Markdown body
+    body = _build_body(note)
+
+    # Write file
+    with open(filepath, "w", encoding="utf-8") as f:
+        f.write("---\n")
+        yaml.dump(frontmatter, f, allow_unicode=True, default_flow_style=False, sort_keys=False)
+        f.write("---\n\n")
+        f.write(body)
+
+    return filepath
+
+
+def _build_body(note: dict) -> str:
+    """按意图类型生成人类可读正文"""
+    intent = note.get("intent", "")
+    payload = note.get("payload", {})
+
+    blocks = []
+
+    if intent == "bug_fix":
+        if payload.get("symptom"):
+            blocks.append(f"## 症状\n\n{payload['symptom']}\n")
+        if payload.get("root_cause"):
+            blocks.append(f"## 根因\n\n{payload['root_cause']}\n")
+        failed = payload.get("failed_attempts", [])
+        if failed:
+            lines = "\n".join(f"- {a}" for a in failed)
+            blocks.append(f"## 失败尝试\n\n{lines}\n")
+        if payload.get("solution_summary"):
+            blocks.append(f"## 解决方案\n\n{payload['solution_summary']}\n")
+        if payload.get("solution_code"):
+            blocks.append(f"## 最终代码\n\n```\n{payload['solution_code']}\n```\n")
+        actions = payload.get("action_items", [])
+        if actions:
+            lines = "\n".join(f"- [ ] {a}" for a in actions)
+            blocks.append(f"## 后续行动\n\n{lines}\n")
+
+    elif intent == "learning":
+        if payload.get("core_concept"):
+            blocks.append(f"## 核心概念\n\n{payload['core_concept']}\n")
+        if payload.get("feynman_summary"):
+            blocks.append(f"## 一句话理解\n\n{payload['feynman_summary']}\n")
+        if payload.get("detailed_explanation"):
+            blocks.append(f"## 详细解释\n\n{payload['detailed_explanation']}\n")
+        related = payload.get("related_concepts", [])
+        if related:
+            lines = "\n".join(f"- {c}" for c in related)
+            blocks.append(f"## 关联概念\n\n{lines}\n")
+        refs = payload.get("references", [])
+        if refs:
+            lines = "\n".join(f"- {r}" for r in refs)
+            blocks.append(f"## 拓展阅读\n\n{lines}\n")
+
+    elif intent == "idea":
+        if payload.get("core_idea"):
+            blocks.append(f"## 核心创意\n\n{payload['core_idea']}\n")
+        pc = payload.get("pros_cons", {})
+        if pc:
+            if pc.get("pros"):
+                lines = "\n".join(f"- {p}" for p in pc["pros"])
+                blocks.append(f"## 优势\n\n{lines}\n")
+            if pc.get("cons"):
+                lines = "\n".join(f"- {c}" for c in pc["cons"])
+                blocks.append(f"## 劣势\n\n{lines}\n")
+        steps = payload.get("action_steps", [])
+        if steps:
+            lines = "\n".join(f"- [ ] {s}" for s in steps)
+            blocks.append(f"## 落地步骤\n\n{lines}\n")
+
+    # Append context_digest
+    if note.get("context_digest"):
+        blocks.append("---\n")
+        blocks.append("## AI 上下文摘要 (context_digest)\n\n")
+        blocks.append(f"{note['context_digest']}\n")
+
+    return "\n".join(blocks)
+
+
+def list_notes(intent_filter: str = None) -> list[dict]:
+    """列出所有笔记摘要"""
+    _ensure_dir()
+    notes = []
+    for fp in sorted(NOTES_DIR.glob("*.md"), reverse=True):
+        meta = _read_frontmatter(fp)
+        if meta:
+            if intent_filter and meta.get("intent") != intent_filter:
+                continue
+            meta["_file"] = fp.name
+            notes.append(meta)
+    return notes
+
+
+def search(keyword: str) -> list[dict]:
+    """基于标题和标签的简单搜索"""
+    _ensure_dir()
+    results = []
+    kw = keyword.lower()
+    for fp in sorted(NOTES_DIR.glob("*.md"), reverse=True):
+        meta = _read_frontmatter(fp)
+        if not meta:
+            continue
+        title = meta.get("title", "").lower()
+        tags = " ".join(meta.get("tags", [])).lower()
+        if kw in title or kw in tags:
+            meta["_file"] = fp.name
+            results.append(meta)
+    return results
+
+
+def _read_frontmatter(filepath: Path) -> dict | None:
+    """读取笔记的 YAML frontmatter"""
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            content = f.read()
+        if not content.startswith("---"):
+            return None
+        _, fm, _ = content.split("---", 2)
+        return yaml.safe_load(fm)
+    except Exception:
+        return None

encore_ai-0.1.0/src/encore_ai.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: encore-ai
+Version: 0.1.0
+Summary: AI对话知识归档工具 — 让每一次AI对话都成为你的数字资产
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0

encore_ai-0.1.0/src/encore_ai.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/encore/__init__.py
+src/encore/cli.py
+src/encore/encore_schema_v0.1.json
+src/encore/schema.py
+src/encore/storage.py
+src/encore_ai.egg-info/PKG-INFO
+src/encore_ai.egg-info/SOURCES.txt
+src/encore_ai.egg-info/dependency_links.txt
+src/encore_ai.egg-info/entry_points.txt
+src/encore_ai.egg-info/requires.txt
+src/encore_ai.egg-info/top_level.txt

encore_ai-0.1.0/src/encore_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

encore_ai-0.1.0/src/encore_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+encore = encore.cli:main

encore_ai-0.1.0/src/encore_ai.egg-info/requires.txt

@@ -0,0 +1,2 @@
+click>=8.0
+pyyaml>=6.0

encore_ai-0.1.0/src/encore_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+encore