@u689579307919059
2026/10/14
StoryCode 介绍
StoryCode 是一个本地优先(Local-first)的桌面端 AI 智能体平台。它以 Rust 代理内核 + Tauri 桌面应用为主体,集编码助手、办公自动化、多媒体处理、知识库、IM 机器人于一体,构成一个可扩展的 Agent 系统。
所有数据默认留在本地,模型可选云端或本地,既能获得大模型能力,又保持对代码、文件、隐私的完全掌控。
核心能力
1. 智能体运行时(Agent Runtime)
- 完整的代理编排层:tool loop、上下文管理、会话生命周期。
- 子代理(Subagents):任务可分解到独立子代理执行,主会话保持精简。
- 技能系统(Skills):可动态加载的能力包,快速扩展 Agent 本领。
- 工作流引擎:YAML/JSON 定义可复用流程,支持参数化、嵌套子工作流、模型覆盖,配合
{{parameter}}模板语法。 - 定时调度器:Cron 表达式调度工作流,支持暂停 / 恢复 / 执行历史。
2. 模型接入:云端 + 本地全覆盖
- 模型供应商:OpenAI、Anthropic、DeepSeek、xAI(Grok)、Mistral、Groq、智谱 AI(GLM)、阿里云百炼(Qwen)、Kimi、MiniMax、火山引擎方舟、小米 MiMo(MiMo-V2.6 全模态系列)、美团 LongCat。
- 订阅套餐端点:阿里云百炼 Token Plan、小米 MiMo Token Plan、智谱 Coding Plan、Kimi Code Plan——使用套餐专属 Base URL 与 API Key,按额度(Credits)计费,面向 AI 编程与智能体工具。
- 云平台 / 聚合网关:Azure、Google Gemini、LiteLLM、OpenRouter、AWS Bedrock、GCP Vertex AI、SageMaker TGI。
- Agent / CLI 与 Copilot:Codex、Claude Code、Cursor Agent、Gemini CLI、GitHub Copilot。
- 数据 / 行业平台:Databricks、Snowflake。
- 其他平台:Venice、Tetrate、Inception。
- 本地推理:内置 llama.cpp 本地推理引擎(llama-server)。
- 自定义 Provider:可自建 OpenAI / Anthropic / Ollama 兼容的私有模型接入。
3. MCP 扩展生态
基于 Model Context Protocol 的可插拔工具系统,内置扩展包括:
- Developer:文件系统、Shell、文本编辑、tree-sitter 代码结构分析。
- Computer Use:UI 自动化、网页抓取、PDF/DOCX/XLSX 文档处理。
- Web Search:联网搜索,支持多 Provider 自动降级(Bocha / Brave / Tavily / 智谱 Z.ai / 阿里云百炼 / Kimi 开放平台 / MiniMax / 火山方舟 / DuckDuckGo),返回带引用来源的结果。配置过对应模型 Provider(
ZAI_API_KEY/DASHSCOPE_API_KEY/MOONSHOT_API_KEY/MINIMAX_CN_API_KEY/VOLCENGINE_ARK_API_KEY)的用户自动复用同一把 Key,零额外配置即可搜索;智谱走 GLM Coding Plan 专属搜索 MCP(积分抵扣)、阿里走百炼 EnhancedSearch MCP(Token Plan 附赠每月免费额度)、MiniMax 走官方本地 MCP(需 uv,未安装自动跳过);显式指定某个 provider 时默认独占、不产生计划外费用(可通过WEB_SEARCH_FAILOVER开启降级);DuckDuckGo 网络失败后熔断 5 分钟,避免国内网络下反复超时。 - Memory:跨会话持久化记忆(分类 + 标签)。
- Knowledge:RAG 知识库(内置 embedding 模型随包分发)。
- Visualizer:Mermaid、Sankey、雷达图、地图等交互式可视化。
- Tutorial:引导式教程。
- DevTools:数据库(SQLite / PostgreSQL / MySQL)、SSH(详见第 6 节)。
- 多媒体:音频 / 视频 / 截图 / AI 生成(详见第 7 节)。
4. Story:项目故事与决策记忆
Story 是 StoryCode 中承载“可长期沉淀的项目记忆”的载体。Agent 不再每次从零开始,而是能读取项目历史、理解“为什么这样写”。
- 三种内容类型:
- 笔记(Note):自由 Markdown 记录、灵感、需求分析。
- 检查点(Checkpoint):自动记录代码变更背后的故事(Commit SHA、变更文件数、增删行数、状态)。
- 会话摘要(Session Summary):把一次高质量会话归档成可复用的知识片段。
- 三种来源:手动创建、Agent 自动沉淀、会话归档。
- 版本历史:每次保存自动生成新版本,随时回溯与恢复。
- 全文检索(FTS5):按标题、正文、关键词、标签快速定位 Story。
- 双向关联:关联会话 / 轮次 / 文件 / Git Commit;Story 之间也可以互相链接,实现需求 ↔ 代码 ↔ 决策的可追溯。
- 星标收藏:重要 Story 一键置顶。
- 自动召回(Auto Recall):新建会话时自动加载相关 Story 作为上下文,减少重复解释。
核心理念:不要让用户刻意记录,而是让 Agent 工作过程中的关键决策自然沉淀为可追溯的项目故事。
5. 知识库(Knowledge):本地 RAG 知识底座
知识库是 StoryCode 的“可增长的知识层”。它不仅被动索引,更能在 Agent 工作过程中主动更新。
- 多知识库管理:可创建多个知识库,索引本地文档目录;托管知识库(Managed KB)可直接由 Agent 写入。
- 混合检索:全文检索 + 向量语义检索(RAG),内置 embedding 模型随安装包分发,开箱即用、无需联网下载。
- 内置 OCR:图片、PDF 扫描件文字识别入库,内置 OCR 模型随包分发。
- 多格式摄取:支持 Markdown、PDF、DOCX、XLSX、PPTX、ODT/ODP、图片、HTML 页面及常见代码文件等文本提取与增量索引。
- Agent 深度集成:
- 搜索 / 读取知识库工具。
- 回答后可一键归档为 Story 或写入知识库。
- 支持手动触发摘要、建关联、更新 wiki,所有写入均受控、可审阅、可回滚。
闭环流程:导入资料 → 生成摘要/笔记 → 回答后归档 → 重新索引 → 下次复用。
6. DevTools 套件
- 数据库工具:SQLite / PostgreSQL / MySQL 查询、行编辑、CSV 导出(含公式注入防护)。
- Git / SSH / 终端:远程主机管理、SFTP 文件传输、内置终端。
- Vault:凭据安全保管。
7. 多媒体能力
- AI 生成:文生图、图生图、图生视频(本地推理或阿里云百炼)。
- 录制:屏幕录制、窗口 / 全屏截图、麦克风与系统音频采集(Windows 采用进程内 WASAPI loopback)。
- 本地语音:
- ASR:Whisper / Qwen3 语音转文字(含说话人分离 sherpa-onnx)。
- TTS:Kokoro / Qwen3 / MOSS 语音合成。
8. IM 通道:把 Agent 变成聊天机器人
StoryCode 通过统一的 channel-common 基础设施,把桌面 Agent 延伸为可在 IM 中使用的聊天机器人。
- 已支持:QQ、微信、企业微信、钉钉、飞书、Telegram、Discord、WhatsApp、Linq。
- 群聊 / 私聊中直接调用 Agent 的全部工具能力。
- 消息收发、会话映射、权限控制统一封装,接入新通道成本低。
作者声明:原创
1
评论 00
评论加载中…