Docs · Getting Started

快速开始

CetaMesh 是一个本地优先的 AI 节点与协作运行时，目标是把对话、记忆、任务、能力、设备和外部模型服务连接到同一套可控的协作体系中。

最后更新：2026-10-15

先了解当前阶段

CetaMesh 当前仍属于 pre-stable / 预稳定开发阶段。已经有可运行的移动端基础能力、自动化检查与部分原生实现，但接口、协议、交互和兼容性仍可能在稳定版本前调整。

这意味着官网文档会优先描述“当前已经实现的行为”，而不是把路线图当成现成功能。涉及真机、iOS、跨设备、第三方模型或远程服务的能力，也会明确区分代码实现、自动化验证与实际环境验证。

开发阶段说明

当前版本适合体验、测试、贡献和验证架构，不应被理解为已经完成独立安全审计、长期兼容性承诺或所有设备场景验证的成熟生产平台。

CetaMesh 是什么

CetaMesh 不只是一个聊天客户端。它把 Chat、Memory、Tasks、Device Mesh、Capability Runtime 和 Extensions 组织成一套可组合的本地优先运行时。

当前公开仓库首先提供 CetaMesh Mobile 源码基线。Mobile 本身就是一个独立节点，本地聊天、记忆与任务不要求依赖 Desktop、QQ、DSH 或中心服务器才能启动。

  • Chat：连接用户选择的模型 Provider，保留本地会话与消息状态。
  • Memory：本地创建、搜索、编辑、置顶和确认写入长期记忆。
  • Tasks：任务身份与模型会话分离，保存事件、注意事项、审批和执行引用。
  • Device Mesh：为设备身份、配对、信任、同步和远程能力建立边界。
  • Capability Runtime：敏感设备能力通过统一权限策略进入原生 Provider。
  • Plugins / Extensions：当前采用声明式或远程契约，不提供下载后任意执行代码的隐藏路径。

第一次使用建议

  1. 先确认你使用的是当前官方构建或自行从官方源码构建的版本。
  2. 配置一个你自己选择的模型 Provider；CetaMesh 不内置公共 API Key。
  3. 在 Chat 中建立会话并验证基本流式回复、停止和重试。
  4. 需要长期保存的信息，通过 Memory 明确确认后再写入。
  5. 需要跨多次执行持续跟踪的工作，使用 Tasks，而不是把 Provider Session 当成任务本身。
  6. 涉及相机、麦克风、文件、通知或远程设备能力时，检查本机权限与 CetaMesh 的能力授权提示。

从源码开始

如果你是开发者，可以直接从公开仓库开始。当前仓库要求 Node.js 22.11+；Android 构建需要 Android Studio / Android SDK；iOS 原生构建需要 macOS、Xcode 与 CocoaPods。

npm ci
npm run check
验证原则

npm run check 用于 TypeScript、ESLint、架构边界与 Jest 检查。它不能替代真实设备、系统权限、硬件能力、第三方 Provider 或跨设备互操作验证。

实现依据

本页根据 CetaMesh 当前公开仓库中的实现与工程文档整理，不把路线图中的未来能力当成现成功能。