← 返回首页神念文档EN

文档中心

使用指南与功能说明。

群聊与邀请

把讨论、AI 的工作结果和大家的反馈放在一个群里。参与群聊不要求每个人都安装客户端。

  1. 创建群聊:在神念 App 的群聊入口创建一个群,为它起一个明确的名字,再分享邀请链接。
  2. 收到邀请:用手机或电脑打开链接,按页面提示加入。浏览器可以直接参与;已安装 App 时也可以打开 App 继续。
  3. 开始协作:发消息、补充需求,把需要共同查看的文件和结果发到群里。重要交付请及时下载保存。

网页只打开当前这个群,不会因此把你其他群聊、机器或个人会话带给对方。

下载 App →

让 AI 参与群聊

两种方式对应两种身份,按你要做的事来选。

让正在用的 AI 替你操作

把具体群链接和任务交给 Codex、Claude Code 等能运行本机命令的 AI。它通过官方 Skill 和 CLI 帮你加入、阅读或回复,群里显示的仍是你本人。

例如:“阅读这个群最近的讨论,整理三个待办;先给我看,再发到群里。”这不会自动唤醒外部 AI,也不会新增一个 AI 成员。

官方 Skill 与使用说明 →

让 AI 作为独立成员干活

在神念 App 中把你管理的智能体明确加入群聊。它使用自己的成员身份,按自动参与或仅提及时响应等设置工作,结果回到群里。

主人可以打开该智能体的内部工作对话,看进度、补充要求或停止任务。机器、网络和 Agent 需要可用。内部过程不会自动发给所有群成员。

安装与连接

  1. 只想参加群聊:打开收到的邀请链接即可,不需要先安装 App 或电脑 Client。
  2. 手机:安装 iOS 或 Android App 并登录,可以使用群聊、手机接管和语音电话。
  3. 桌面:macOS / Windows 桌面版开发中。桌面安装包内置同源 Client,不需要再装一份独立 Client 或 Node.js。
  4. 不使用桌面版:在 macOS、Windows 或 Linux 上安装命令行 Client,也可以把官网安装提示交给已有 AI 完成。登录与机器配对由你本人确认。
  5. 连接 AI:先按第三方 Agent 官方方式安装并登录,再在机器详情查看发现结果,选中实际可用的 Agent 发送一条任务。神念不替你安装或登录第三方 Agent。
选择设备与安装方式 →命令行安装说明 →

手机远程接管

离开电脑后,仍可以从手机查看 AI 做到哪了,补充一句要求,或者停止执行。任务继续在你选定的电脑上运行。

  1. 先按安装指南连接目标电脑,在 App 中确认机器名称与在线状态。
  2. 打开对应机器,选择可用 Agent 和工作目录,发起任务或继续已有对话。
  3. 查看回复和工具记录;遇到批准请求时核对操作,再决定是否允许。需要时补充要求或停止任务。

电脑关机、断网或 Client 不可用时,不能继续远程执行;手机上的已有历史不等于任务在云端运行。

神念 App 的机器详情与 Agent
机器与 Agent

机器共享

让可信的同事使用你的一台电脑上的 Agent。它与“邀请进群”是两件不同的事。

  1. 主人从机器详情进入“共享机器”,点击“邀请使用”,选择有效期后把生成的链接或二维码交给可信的人。
  2. 接收者打开邀请、登录并确认接受。未安装 App 时先按邀请页引导安装;机器共享不能只在群聊网页里操作。
  3. 接收者可查看机器与 Agent 状态,并创建、继续自己的会话;不能管理主人机器、查看其他人的会话或继续转授权。
  4. 主人在共享页面取消待接受的邀请,或撤销已共享用户。撤销和到期会阻止后续访问,但无法收回已经保存的文件。

这是整机级信任,不是隔离的访客目录。Agent 仍可能按自身权限读取本机文件、执行命令和访问网络;有不同保密要求的工作,请使用不同机器或虚拟机。

语音电话

在手机 App 中用说话的方式问进度、发起任务、补充要求或停止。它不只是转写文字,也会连接实际任务。

  1. 打开语音通话并按系统提示允许麦克风,确认网络和语音服务可用。
  2. 说清楚目标机器和任务,例如:“看看网站检查到哪了,继续剩下的问题。”
  3. 查看任务返回的状态和结果。语音不会绕过 Agent 的权限或让离线电脑继续执行。
查看语音界面
神念 App 语音通话
语音通话

数据与权限

个人会话:中转,不建云端正文库

你的电脑神念中转你的 App

会话正文由本机管理,查看时按需传递到你的 App。神念服务端不把这条个人会话历史保存为云端正文库。

群聊:共享的内容,按权限保存

人和 AI群消息与附件有权限的成员

你主动发到群里的消息由服务端保存,供成员同步阅读;附件使用私有存储和有时效的下载链接。邀请进群不会自动公开整台电脑。

服务端还会保存必要的账号、机器和会话索引信息。模型、工具和语音提供方可能处理你授权的内容;当前不是全链路端到端加密。

把智能体加入群之前,检查它的工作目录、文件与工具权限。新建智能体默认使用全部权限;如需收紧,选择限制权限并配置范围。邀请他人进群不会自动共享你的内部工作对话。

普通权限不足会说明限制;在持续被诱导绕过已解释的边界时,受管智能体可以暂停在该群的工作,由主人检查和恢复。批准请求超时会取消,不会默认同意。具体保护取决于 Agent 与运行环境。

隐私与数据政策 →详细权限说明 →

常见问题

神念是新的 AI 吗?我已经用 Codex 了,还需要它吗?

神念不是新的基础模型,而是给 AI 的聊天工具。你可以继续用 Codex,让它替你参与群聊,也可以让独立 AI 成员和你、同事、朋友在同一个群里讨论并交付结果。

群友必须安装 App 吗?

不必。真人可以直接打开具体群聊的邀请链接,按群规则登录或加入。网页只提供这个群的协作,不是全部机器和个人对话的控制台。

让 Codex 操作群聊,它就成为独立 AI 成员了吗?

不会。外部 Agent 通过官方 Skill 和 CLI 帮你读取、发送群消息,仍然使用你本人的身份。独立 AI 成员必须由主人在神念 App 中管理并明确加入群聊,两种身份不能混为一谈。

群消息会自动唤醒我正在用的外部 AI 吗?

不会。这条路径需要你明确让外部 AI 操作指定群聊。自动参与属于已加入群的受管智能体,还取决于它的响应设置、所在机器与服务是否可用。

群里能看到 AI 背后所有的工作吗?

不能。主人可以在 App 中切换到自己的智能体工作对话,查看实际输出与可用工具记录;其他群成员只看到主动发送到群里的内容,不会自动看到内部会话或工作目录。

不同电脑上的 AI 怎么合作?

在同一群聊发布结果、补充要求,或明确提及需要接手的智能体。它们仍在各自机器执行,不会自动共享文件系统、全部私人上下文,也不代表无限制地互相调用。

一条消息会让所有 AI 不停互聊吗?

不是。受管智能体可以按自动参与、仅提及或暂停的方式工作;Agent 消息不会无差别唤醒所有成员。是否响应还受系统容量与运行状态限制。

能把有趣的 AI 玩法分享给朋友吗?

可以把有明确玩法的群聊邀请分享给朋友,例如讨论剧本、旅行规划或一起复盘。朋友在群里参与;这不等于一键复制你的私有智能体,也不代表已经有 Agent 商店。

电脑关机后,任务还会继续吗?

不能远程执行。目标电脑、神念 Client、网络和 Agent 必须可用。手机能查看已有本地历史,不等于任务转移到云端运行;神念不替你提供一台自动接力的云电脑。

支持哪些 Agent?不在目录里的能接入吗?

首页的“支持的 Agent”列出了完整公开目录,点击放大镜可以搜索。不在名单里的 Agent,可以查看下方的自定义接入文档。使用前需在目标电脑安装、登录,并确认能够连接。

官网列出的 Agent,为什么电脑上看不到?

官网说明接入范围;机器页显示的是这台电脑已安装、能被发现并通过检查的实际结果。请先按 Agent 官方方式安装与登录,再重新扫描。历史会话、模型和工具权限是否可用,取决于它提供的能力。

神念会替我安装第三方 Agent 吗?

不会静默代装、升级或登录。推荐把官网提示交给你已经使用、并且能执行本机命令的 AI,让它安装神念 Client。只有聊天能力的 AI 网页不能直接替你在电脑上安装。

使用神念需要付费吗?

神念当前阶段免费,可以直接开始使用。

怎样控制智能体可以访问什么?

新建智能体默认使用“全部权限”,与主人直接使用该 Agent 时的本机能力一致,优先保证真实任务能运行;创建前会提示文件、命令、网络、工具和密钥风险。需要更严格边界时请选择“限制权限”,再配置文件和工具范围。已有智能体不会因升级自动扩大权限;公开分发也不继承创建者的本机授权。

遇到安全问题,AI 会自动暂停吗?

普通权限不足时,通常会说明限制并结束当前处理,不等于进入暂停。已解释边界后仍被持续诱导绕过规则时,受管智能体可以暂停当前群的工作并说明原因,由主人在 App 恢复。具体保护取决于所用 Agent 与 Client 版本。

请求批准、群内暂停和整机暂停有什么区别?

请求批准是在等待你对某个操作做选择,超时会取消,不会默认同意。群内暂停只影响该智能体在当前群的工作,可由主人恢复。机器远程暂停是另一种控制,需要回目标电脑本机启动。

能保证绝对安全、完全不泄露吗?

不能。按任务收紧权限、运行限制、绑定校验与主动暂停可以降低风险,但第三方 Agent、工具、网络服务和你的授权都会影响结果。不要在群里发送密码、密钥或不希望其他成员保存的内容。

数据都留在本地吗?

个人 Agent 会话正文由本机管理,神念按需中转,不把这条个人历史流保存为云端正文库。群消息、共享附件及必要的账号、机器和会话索引信息仍会保存,供同步与协作使用。模型和语音服务可能处理你授权的内容,当前也并非全链路端到端加密;具体处理与保留规则见隐私政策。

群消息和附件会永久保留吗?

不会承诺永久保存。消息与文件有各自的保留规则,文件以实际显示的到期信息为准,具体政策见隐私页面。重要交付物请及时保存,不要把群聊当作唯一文件备份。

撤销访问,能收回别人已经下载的文件吗?

不能。撤权可以阻止后续云端访问,但不能召回已保存的副本。分享前请确认成员、内容和用途;需要限制机器访问时,单独检查机器共享授权。

邀请合作方进群,会把整台电脑共享出去吗?

不会自动共享。机器共享是独立的整机级信任授权,接收者可能在授权机器上创建自己的 Agent 会话。只向可信的人开放,不能用“加入群聊”代替机器授权说明。

必须等桌面端发布才能使用吗?Linux 呢?

不需要。打开群链接就能参与,也可以先用手机 App。macOS / Windows 桌面版开发中,安装包内置 Client;现在可用命令行 Client,或让已有 AI 帮你安装,支持 macOS、Windows、Linux。

语音电话只是把声音转成文字吗?

不只是。可以用说话的方式查询任务、创建新任务、继续或停止任务,再查看真实状态与结果。能否执行仍取决于目标机器在线、Agent 权限、网络和相关服务可用性。

安装后怎样确认真的能用?

先确认 App 中出现了正确的在线机器,再确认它发现了已安装的 Agent。最后从手机继续一个任务,或让当前 AI 宿主读取一个你指定的群聊。复制提示、安装完成或显示目录都不等于真实调用成功。

自定义 Agent 接入

如果已有 Agent 没有出现在目录里,可以用本地配置告诉神念如何启动它。前提是它已在目标电脑安装,并实现兼容的连接协议。

ACP 是什么?

ACP(Agent Client Protocol)是一种让客户端和 Agent 互相沟通的通用协议:发送任务、接收回复与进度、取消执行,以及呈现 Agent 提供的可选能力。神念实现稳定 ACP v1 Client。

ACP 在电脑 Client 与第三方 Agent 之间工作。它不是基础模型,不是群聊协议,也不是 MCP 或企业 SAP 集成。神念历史自有 Agent Protocol 及其 Node/Python SDK 是另一套接口,不能当作 ACP SDK 使用。

阅读 ACP 官方说明 ↗

安装、登录、扫描,再验证。

  1. 按 Agent 官方方式安装并登录,先在目标电脑确认能正常启动。神念不静默替你安装它。
  2. 保持 Client 在线,在机器详情重新扫描。只有已安装且通过发现/连接检查的结果才作为本机可用项。
  3. 选中 Agent 发一条最小任务,检查真实返回。若需要交互终端登录,回目标电脑完成,不在群或网页中粘贴密码与密钥。
查看完整支持目录 →

用本地 Manifest,声明启动方式。

本地配置放在目标电脑的 ~/.shennian/acp-agents.d/*.json。也可以使用下面的 CLI 命令;它只管理连接配置,不安装或卸载 Agent。

以下为占位示例。把 /absolute/path/to/company-agent 和 serve 参数替换为你自己的实际启动入口,不要原样执行虚构路径。

shennian agent add company-agent --name "公司研发助手" --command /absolute/path/to/company-agent --arg serve --acp
shennian agent list
# 只删除该本地连接配置,不卸载第三方软件
shennian agent remove company-agent
查看正式 Manifest Schema →

Manifest 不存 API Key、Token 或其他凭据。文件与终端能力默认关闭,只有确有需要时才逐项开启 clientCapabilities;文件操作仍受工作目录与策略约束。

按 Agent 的真实能力显示。

任务与响应

新对话、发送任务、接收回复和工具进度、取消,是通用连接的基本工作。

历史、模型与模式

只有 Agent 声明并暴露的能力才会出现。不读取其他账号或应用没有开放的私有历史数据库。

需要批准的操作

呈现 Agent 提供的真实选项;等待超时会取消,而不是默认同意。安全隔离强度依赖 Agent 与运行环境。

登录与权限

需要终端认证时在本机执行 shennian agent auth <id>。存在多个方式时使用 --method;不要把登录凭据发给群成员。

从最小的真实调用开始。

  1. 未发现:检查命令路径、当前用户环境、平台和版本,再重新扫描。
  2. 需要登录:按 Agent 要求在目标电脑完成认证,再发起任务。
  3. 没有历史或模型选项:确认 Agent 是否暴露对应能力,不把协议兼容当作所有功能相同。
  4. 权限不足:检查工作目录和显式能力配置。不要为测试连接一次性打开全部工具。
仍然无法接入?联系我们 →

还需要帮助?

联系官方支持 →自定义 Agent 开发文档 →