快速开始
最近更新 · 2026-09-23 · 适用于 v0.3.1
系统要求
- Windows 10 及以上 64 位,建议 8 GB 以上内存
- 安装包约 119 MB,安装后应用会自动向 ai.ayjkly.love 检查更新
三步进入工作区
- 下载安装:从下载中心获取安装包。若 SmartScreen 弹出「已保护你的电脑」,点击「更多信息 → 仍要运行」即可继续。
- 首启引导:首次启动时选择语言与界面风格(经典布局 / 枢码现代),完成后直接进入主界面——此时无需登录,可浏览全部界面与设置。
- 登录调用 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 任务的流程
- 描述目标:在 Agent 面板用自然语言说明要做什么,例如「新建 src/format.ts 并补充日期格式化函数」。
- 拆解与检索:Agent 自动检索仓库上下文,把目标拆成可追踪的步骤,它的思考与动作全程可见。
- 调度工具:按需调用终端、内置浏览器、远程主机或通过 MCP 接入的外部资源。
- 逐文件改码:修改以差异卡片逐文件呈现。
- 审查与提交:逐文件接受或拒绝,未批准不会写入磁盘;随后进入调试与提交。
自定义智能体
- 为不同场景独立创建 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
更多说明见隐私安全专题页与常见问题。