快速开始

最近更新 · 2026-09-23 · 适用于 v0.3.1

系统要求

  • Windows 10 及以上 64 位,建议 8 GB 以上内存
  • 安装包约 119 MB,安装后应用会自动向 ai.ayjkly.love 检查更新

三步进入工作区

  1. 下载安装:从下载中心获取安装包。若 SmartScreen 弹出「已保护你的电脑」,点击「更多信息 → 仍要运行」即可继续。
  2. 首启引导:首次启动时选择语言与界面风格(经典布局 / 枢码现代),完成后直接进入主界面——此时无需登录,可浏览全部界面与设置。
  3. 登录调用 AI:当你发起对话、触发补全等 AI 操作时,应用会唤起浏览器,在网页完成人机验证与邮箱验证码登录,授权后经 shuma:// 深链自动回到应用。新邮箱注册即赠 1000 Token。
建议安装后在 PowerShell 执行 Get-FileHash .\Shuma-Setup-0.3.1.exe -Algorithm SHA256,与下载页公布的校验值比对,确认安装包完整。

下一步

界面双风格

最近更新 · 2026-09-23

Shuma 提供两种工作台界面语言,在首次启动引导中选择,之后随时可在设置中切换。切换风格不影响工程文件与配置。

经典布局

  • 紧凑、高密度的信息编排,面板与快捷键贴近主流代码编辑器习惯
  • VS Code 用户零成本上手,适合长时间重度编码

枢码现代

  • 更舒展的间距、柔和的圆角与动效曲线,视觉负担更轻
  • 适合演示、讲解与偏好沉浸式界面的使用者
两种风格共享同一套功能:AI 助手、Agent、Cue 补全、终端与浏览器的位置可能不同,能力完全一致。

AI 助手与 Agent

最近更新 · 2026-09-23

IDE 与 SOLO 双重模式

IDE 模式保留你熟悉的编辑器、终端与 Git 流程,AI 在侧待命:问答、解释代码、补全、改一段。SOLO 模式由专属 Coding Agent 主导,接收目标后自动推进,你在关键节点审查。

一次 Agent 任务的流程

  1. 描述目标:在 Agent 面板用自然语言说明要做什么,例如「新建 src/format.ts 并补充日期格式化函数」。
  2. 拆解与检索:Agent 自动检索仓库上下文,把目标拆成可追踪的步骤,它的思考与动作全程可见。
  3. 调度工具:按需调用终端、内置浏览器、远程主机或通过 MCP 接入的外部资源。
  4. 逐文件改码:修改以差异卡片逐文件呈现。
  5. 审查与提交:逐文件接受或拒绝,未批准不会写入磁盘;随后进入调试与提交。

自定义智能体

  • 为不同场景独立创建 Agent,定义它可使用的工具、技能与任务逻辑
  • 创建好的智能体可以分享,像插件一样在团队间复用组合

Cue 智能预测

最近更新 · 2026-09-23

Cue 是行内智能预测能力,依据仓库、当前文件与编辑轨迹,在你停顿时给出续写建议。它只提供建议,不会自动修改文件。

接受与忽略

  • Tab:接受当前建议(支持中间代码补全 FIM,即光标位于一行中部时也可续写)
  • Esc:忽略建议,继续手动输入
  • 多行改动以直观 diff 呈现,改动范围一目了然

让预测更准

  • 保持工程文件夹完整打开,让 Cue 能读到跨文件上下文
  • 配合 Rules 写明命名与风格约定,建议会更贴合团队规范

上下文与 Rules

最近更新 · 2026-09-23

Shuma 能读到哪些上下文

  • 工程上下文:代码仓库结构与文件内容
  • IDE 上下文:终端信息与编辑轨迹
  • 外部资料:联网搜索,以及你上传的文档集

用 Rules 定义工作规则

在设置中配置 Rules,即可让 AI 助手、Cue 与 Agent 统一遵循你的偏好,例如:

  • 代码风格与命名约定(缩进、引号、命名方式)
  • 目录结构与模块边界
  • 提交信息格式与测试要求
  • 回答语言与详略程度
Rules 是让产出「像你写的」最直接的手段:规则越具体,Agent 的差异卡片需要返工的概率越低。

账号与 Token

最近更新 · 2026-09-23

网页邮箱登录

注册与登录均使用邮箱验证码,无需设置额外密码。流程在浏览器中完成人机验证与验证码校验,授权成功后通过 shuma:// 深链唤起本地应用,令牌本地加密落盘,不经过第三方页面。

什么时候需要登录

  • 浏览界面、编辑本地文件:无需登录
  • AI 助手对话、代码补全、语音、文生图 / 文生视频:统一登录门控,调用时才唤起登录

Token 与计费

  • 新邮箱注册即赠 1000 Token
  • 免费额度耗尽后 AI 功能暂停并提示,不会自动扣费
  • 付费充值与专业版订阅正式上线前,不会出现任何扣款入口

隐私安全

最近更新 · 2026-09-23

本地优先

项目文件保存在本地磁盘,编辑器、终端与 Git 全部在你的机器上运行。不登录也能浏览完整界面。

凭据与登录

  • 登录令牌本地加密存储
  • 网页登录使用一次性 nonce 与短期有效的深链回跳
  • 邮箱验证码登录,免去新密码的泄露面

改动批准

Agent 对代码的每一处修改都以差异形式逐文件呈现,未获批准不会写入任何文件。配合本地 Git,已接受的改动同样可以回溯。

安装包校验

每个版本在下载页公布 SHA256。例如 v0.3.1:

Get-FileHash .\Shuma-Setup-0.3.1.exe -Algorithm SHA256

E65478F9AE947CD0BB71D0B40ED12734
8DC3FD691426ED2FE3636FC66CBD0F65

更多说明见隐私安全专题页与常见问题。