Skip to content

PROJECT.md

Latest commit

 

History

History
78 lines (54 loc) · 2.59 KB

PROJECT.md

File metadata and controls

78 lines (54 loc) · 2.59 KB
Raw

PROJECT.md — Mini Notes with LLM Summary

项目概述

项目名称：Mini Notes with LLM Summary（Anna App 版本）

一句话描述：一个运行在 Anna App 平台上的迷你笔记应用，用户可以创建/查看/删除笔记，并通过本地 Executa Tool 调用 Host LLM 生成笔记总结。

项目类型：Anna App 本地开发能力验证项目（非普通 Web App）

创建日期：2026-07-03

项目目标

证明对以下 Anna App 平台概念的理解和工程实现能力：

  1. Anna Host API：通过 AnnaAppRuntime 与 Host 通信
  2. Anna Storage / APS KV：使用 anna.storage.get/set 持久化数据
  3. Executa Tool：实现 JSON-RPC 2.0 over stdio 的工具进程
  4. Sampling：通过反向 JSON-RPC sampling/createMessage 调用 Host LLM
  5. Binary Distribution：三平台二进制打包与 GitHub Actions 发布
  6. 工程化前端：源码目录 + 构建脚本，非单文件 HTML

核心用户

  • 审阅者：按照 README 步骤逐项验收
  • 开发者（你自己）：本地开发、调试、测试

核心场景

场景 描述
创建笔记 用户输入文字 → 点击保存 → 笔记通过 anna.storage.set 持久化
查看笔记列表 页面加载 → 通过 anna.storage.get 读取 → 展示列表
删除笔记 点击删除 → 通过 anna.storage.set 更新存储 → 列表刷新
LLM 总结 点击 Summarize → anna.tools.invoke → Executa Tool → sampling/createMessage → 结果展示

技术约束

  • ✅ 必须使用 Anna App 平台模型（Host API / Storage / Executa / Sampling）
  • ✅ 必须是工程化前端项目（源码 + 构建）
  • ✅ 必须支持 anna-app dev --no-llm 本地调试
  • ✅ 必须支持 anna-app executa dev --mock-sampling 测试
  • ✅ 必须支持三平台二进制打包
  • ❌ 不可绕过 Anna 平台直接使用 localStorage / HTTP API / llm.complete
  • ❌ 不可使用真实 Anna 账号 / LLM API key / 云端 APS

技术栈

层 选型
前端 React 18 + TypeScript + Vite
Executa Tool Node.js + TypeScript（binary 打包方案待验证）
包管理 pnpm (monorepo)
CI/CD GitHub Actions
Lint ESLint + Prettier

相关文档