桌面AI，atomcode的使用了解教程

3066212745

     最近使用到了atomcode，我发现论坛里有很多高中，大学生，对于拥有电脑的人来说，这是一个用起来很舒服的桌面AI，功能强大，不仅免费，能写小说，操作桌面，下载软件，替你解决电脑问题，还有专门官网交流论坛，免费可以链接deepseek。v4  flash，每五个小时算一次额度，不超过就行，里面还有免费专门的算力可以供你开发一些东西，鸿蒙软件开发，CANNLab 模型改进，软件开发之类的。    是很适合高中爱好者和计算机专业大学的桌面ai，比如你有什么正规网页网站上不去，就可以让它想办法。
    让它写word文档总结，完成简单的android开发，写网页前端，链接数据库，打开网页，写小说，整理桌面，直接在你的桌面进行操作，配置环境，总之非常全能。
    假若你有国外的ai好像也可以链接，但是免费deepseek v4 flash已经完全够用了，额度完全用不完。

       我会放一些图片和文档方便你们了解，使用，剩下的我就不过多赘述了，word也是ai写的
      当然在过程中你可能需要github账号或者别的什么，要么b站搜，要么自己研究，新一代要有探究精神，分享精神，当然不是因为懒。


       而且鸿蒙软件好像是蓝海，只要认真做是有人民币拿的。
AtomCode —— 住在终端里的 AI 编码助手一份面向新人的推荐与上手指南(内容依据 AtomCode 官方文档整理)
──────────────────────────────
一、AtomCode 是什么?AtomCode 是一个住在终端里的 AI 编码助手。 给它一个自然语言任务,它会自主地读取、编辑、运行并自我验证——不是只给你"建议代码",而是真正动手把活干完,再自己检查结果。
[size=11.0000pt]· 语言:Rust 编写(1.88+)
[size=11.0000pt]· 平台:macOS · Linux · Windows · HarmonyOS PC
[size=11.0000pt]· 许可证:MIT(开源)
[size=11.0000pt]· 当前版本:v5.0.3
一句话:你在终端里用中文/自然语言下达任务,AtomCode 负责执行并验证,你负责确认和收尾。
──────────────────────────────
二、为什么推荐它?(核心优势)1. 三步上手,零门槛# 第一步:安装(一条命令)
curl -fsSL https://raw.atomgit.com/atomgit_atomcode/atomcode/... | bash

# 第二步:登录(推荐一键 OAuth,含免费额度)
# 首次启动自动弹出 3 步向导:选语言 → 选接入方式 → 完成

# 第三步:开干
atomcode
> 简要介绍一下这个项目的目录结构和职责
首次启动向导第 3 步选 "用 AtomGit CodingPlan 一键接入",一条命令完成 OAuth 登录 + 申领免费额度 + 自动配置 provider 和 model,全程不需要手动配 API Key。
2. 真正"干活",而不是"给建议"

其他助手	AtomCode
给你一段代码,你自己粘贴	直接改文件
让你自己去跑命令	自己执行命令并看结果
让你自己检查	改完自己验证,失败会继续修

内置 21 个工具:文件读写、Shell 执行、代码图谱、Web 抓取、AtomGit 原生操作等,模型会根据任务自动选用。
3. 安全模型清晰可控(四层审批)AtomCode 替你执行工具时,每一次调用都会落入四个审批等级之一:

等级	行为
自动放行	项目内安全操作,直接执行,不打扰
询问	弹窗确认,选"本会话总是允许"后可记住
始终询问	破坏性操作(rm -rf、git push --force 等),每次都问
按资源询问	项目外/敏感路径(~/ .ssh、.env 等),按路径询问

项目内干活畅通无阻,伸到项目外、碰机密、或破坏性操作自动升级确认。还有只读的 **Plan 模式** 让你先看方案再动手。
4. 隐私透明你的代码只发到你配置的模型 endpoint。 项目文件由本地工具读取后作为 prompt 发送,AtomCode 本身不会额外上传或遥测代码内容。也可以按需禁用工具:
[tools]
disabled = ["shell", "web_fetch"]
5. 生态可扩展,越用越懂你[size=11.0000pt]· Skills:把常用流程固化成可复用命令(发布 release、写 changelog、跑回归测试…),写好自动出现在 `/` 菜单
[size=11.0000pt]· Plugin:一行 `/plugin install` 安装别人写好的工作流套件,与 Claude Code 生态兼容
[size=11.0000pt]· MCP:通过 `.mcp.json` 接入 GitHub、数据库、Playwright 等外部工具,让模型像用内置工具一样调用
[size=11.0000pt]· 永久记忆:`/remember` 记住你的偏好和约定,每轮对话自动带入
[size=11.0000pt]· 项目指令文件:项目根目录放一个 `.atomcode.md`,把技术栈、约定、偏好固化,自动生效(原生支持 AGENTS.md 开放标准)
6. 会话不丢,可回溯[size=11.0000pt]· 每次对话默认持久化,`atomcode -c` 接着昨天继续
[size=11.0000pt]· `/undo` 一键回滚上一轮工具改动
[size=11.0000pt]· `/resume` 从历史会话列表挑一个继续
[size=11.0000pt]· `/compact` 压缩上下文,`/clear` 清空重来
7. 终端 + 浏览器双界面除了终端 TUI,输入 `/webui` 即可在浏览器里聊天、翻历史、配模型、传图片,并通过 `/sync` 与终端实时同步同一个会话。
──────────────────────────────
三、新人快速上手安装(任选其一)# 方式 1:一键安装(推荐)
curl -fsSL https://raw.atomgit.com/atomgit_atomcode/atomcode/... | bash

# 方式 2:npm(已装 Node.js 18+)
npm install -g @atomgit.com/atomcode

# 方式 3:Homebrew(macOS / Linux)
brew install --cask atomcode

# 验证
atomcode --version
首次运行atomcode
自动弹出 3 步向导:① 欢迎 → ② 选语言(简体中文)→ ③ 选接入方式(推荐:AtomGit CodingPlan 一键接入,含免费额度)。
想在已有会话接入,直接输入 `/login`。
完成第一个任务cd ~/你的项目目录
atomcode
> 帮我看看这个项目的目录结构,并简要介绍每个模块的职责
或者快速体验(一次性执行,结果输出到 stdout):
atomcode -p "简要介绍一下这个仓库"
常用斜杠命令速查

命令	作用
`/login`	一键 OAuth + 免费额度 + 自动配置(新人首选)
`/model`	切换模型
`/plan`	只读探索模式,先理清方案再动手
`/undo`	回滚上一轮文件改动
`/resume` / `-c`	恢复历史会话
`/compact` / `/clear`	压缩 / 清空上下文
`/remember`	记一条永久记忆(偏好、约定、命令)
`/webui`	启动浏览器界面
`/config` / `/provider`	编辑配置 / 管理 provider
`/plugin`	交互式插件管理器

配置文件(~/.atomcode/config.toml)default_provider = "deepseek"

[providers.deepseek]
type = "openai"
api_key = "sk-xxxx"
model = "deepseek-chat"
base_url = "https://api.deepseek.com/v1"
[size=11.0000pt]· 支持多个 provider 并行存在、随时切换:OpenAI、Claude、DeepSeek、智谱 GLM、通义千问、SiliconFlow、本地 Ollama 等
[size=11.0000pt]· API Key 支持环境变量语法(`$MY_KEY`),避免明文写在配置里
[size=11.0000pt]· 默认跟随系统代理,公司内网也能用
[size=11.0000pt]· 视觉预处理器:即使当前模型不支持图片,也能把图片交给独立 provider 做 OCR + 描述后接进对话
写项目的 .atomcode.md在项目根目录放一个 `.atomcode.md`,把约定固化:
# Project Instructions
这是一个 Vue 3 + TypeScript 项目,使用 Pinia 做状态管理、Vitest 做单元测试。

## 约定
- 组件一律使用 <script setup> 语法
- 跑测试用 pnpm test
- 禁止使用 any
之后每次对话自动生效,不用反复交代。
──────────────────────────────
四、常见问题(FAQ 速览)

问题	解答
每次执行命令都要确认,太烦了	弹窗里选"一直允许此类操作",或在 config.toml 的 [permissions] 加白名单
我的代码会被发到哪里?	只发到你配置的模型 endpoint,无额外上传或遥测
怎么切换模型?	`/model` 从菜单选择
上下文超限了怎么办?	`/compact` 压缩后继续,或 `/clear` 重开(历史保留可 /resume)
怎么让它读某个文件?	输入里用 `@` 触发文件补全
改错了怎么回滚?	`/undo` 回滚上一轮工具改动
安装脚本网络超时?	到 releases 页面手动下载,解压后放进 PATH

──────────────────────────────
五、了解更多[size=11.0000pt]· 官方文档:https://atomcode.atomgit.com/docs/zh/index.html
[size=11.0000pt]· 开源仓库:https://atomgit.com/atomgit_atomcode/atomcode
[size=11.0000pt]· 反馈:执行 `/login` 后,直接让 AtomCode 用内置 AtomGit 工具创建 Issue
──────────────────────────────
*本文档内容依据 AtomCode 官方文档整理,供推荐与新人入门使用,可按需修改。*

3066212745

有不懂，进官网琢磨一下就好了，这个真的好用，无论是mac还是windows