现在写代码的新姿势：不再一行行敲，而是用大白话告诉 AI 你的目标，让它自己去读代码、改文件、跑命令。 这个分区讲透三款主流终端 AI 编程代理：内置工具、模式与权限、插件生态、常用命令，一次搞懂。
✅ 零基础可读 · 建议先看完主页教程，理解"仓库 / 提交 / 分支"后体验更佳 · 具体以各家官方文档为准你可能在别处用过 AI 聊天：它只能给你代码，让你自己复制粘贴。而 AI 编程代理更进一步——
"纸上谈兵"的军师
能动手干活的"AI 实习生"
三款工具的界面和叫法不同，但零件是一样的。先建立这套"地图"，后面看哪家文档都不迷路。
代理的"手"：读写文件、执行终端命令、搜索代码、联网查资料……你说的每个任务，都是它调用一个个工具完成的。执行工具时会向你展示过程。
代理的"挡位"：最常见的是 Plan 计划模式（只读不改，先给方案）和 Build/Edit 执行模式（真正动手改代码）。先规划后动手是好习惯。
安全阀：决定哪些操作 AI 可以直接做（如读文件），哪些必须先问你（如删文件、跑命令）。新手建议保持"多问"的严格档。
项目说明书文件（如 AGENTS.md / CLAUDE.md）：写清技术栈、规范、禁区，代理每次干活都遵守，一次编写长期生效。
行业的"USB 接口"标准：接入外部工具服务器，让代理多出新能力（查数据库、控制浏览器、调内部 API……）。三款工具都支持。
给代理装"技能包"：插件改变行为（接新 CLI、加钩子），Skill 教会它某领域的成套做法（如"怎么发版"）。各家商店与格式略有不同。
出品：Z.ai。官方定位是 GLM 大模型的 AI 编程代理工具（Harness），把模型和代理能力接进你现有的工具链，覆盖规划 → 写码 → 审查 → 部署的完整开发流程，并有针对 GLM 深度优化的长程任务能力。
打开一个项目文件夹就是一个工作区，代理围绕整个仓库干活，而不是只看你贴的一小段代码。
终端 CLI、桌面端、Web 端，还能通过 ACP 协议接入 Zed 等编辑器，选你顺手的姿势。
给一个目标，它自主拆解规划、逐步执行；配合权限模式可控，重要操作会先征求你同意。
对话框点模型名打开选择器，"管理模型"面板可配置多个模型通道，不同任务用不同模型。
访问官网 zcode.z.ai 按指引安装（源码开源于 GitHub 的 zai-org/ZCode），在项目根目录启动交互会话：
cd my-project # 进入你的项目文件夹 zcode # 启动 ZCode 交互代理（首次按提示登录 / 绑定套餐）
登录后即可使用；用 GLM Coding Plan 套餐计费，也可在设置里管理其他模型通道。
在项目根目录新建 AGENTS.md（兼容 CLAUDE.md 等同类约定），这是代理的"员工手册"：
# 项目说明 - 技术栈：纯 HTML/CSS/JS，无构建工具 - 改完代码必须自己打开浏览器验证 - 不要动 .shots/ 目录和任何密钥文件 - 提交信息用中文，一行讲清改动
像给实习生派活一样说话，它自己规划执行，关键改动前会找你确认：
> 给网站加一个"回到顶部"按钮，固定在右下角，样式和现有主题一致
> 检查所有页面有没有手机端排版问题，列出来并修复
> 把这次改动 commit 并说明改动内容
| ZCode 的"零件" | 是什么 / 怎么用 |
|---|---|
| 内置工具 | 读写项目文件、执行终端命令、检索代码、联网查资料等；每次调用都会展示在会话里，你能看到它"手"在动 |
| 模式与权限 | 可切换"先出计划再动手"的计划方式与直接执行；权限模式下删文件、跑脚本等敏感操作会先请求批准，新手建议保持严格档 |
| Subagents 子代理 | 把大任务拆给多个"分身"并行处理（如一个查资料、一个写代码），主代理负责汇总，适合大改动 |
| Skills 技能 | 用 Markdown 编写的"成套做法"，教代理按固定套路完成某类任务（如"发版流程"），放在项目或用户目录即可生效 |
| MCP 扩展 | 在配置文件里登记 MCP 服务器即可扩展工具箱：用户级 ~/.zcode/cli/config.json（mcp.servers），项目级 .zcode/config.json；可接浏览器控制、数据库等外部工具 |
| 自动化 | 支持定时/自动触发任务（如每天固定时间跑检查），把重复劳动交给代理 |
开源社区作品（opencode.ai），专为终端打造，界面是一个漂亮的 TUI（终端图形界面）。最大特色：不绑定任何模型厂商，Claude、GLM、DeepSeek、GPT……谁的 API 都能接，随时换。
代码公开在 GitHub，免费使用，社区活跃迭代快，也是很多同类工具的学习对象。
内置 /models 选择器，接各家 API 都行；哪家便宜用哪家，一个工具吃遍所有模型。
自带两个"人格"：Plan 只读不改、专门出实现方案，Build 真正动手改代码。TUI 里按 Tab 即可切换。
交互式 TUI 慢慢聊，或 opencode run "任务" 一句话直接跑完退出，方便写进脚本自动化。
# 方式一：官方一键脚本（macOS / Linux） curl -fsSL https://opencode.ai/install | bash # 方式二：npm 安装（装过 Node.js 的用这个） npm install -g opencode-ai
cd my-project opencode # 启动 TUI 界面 # 在 TUI 里： /models # 选模型厂商和具体型号，首次填 API Key Tab # 在 Plan / Build 模式间切换 > 先出个方案：给首页加深色模式，改动最小化
也可以一句话非交互运行：
opencode run "把 README.md 翻译成英文并保持 Markdown 格式"
Tab 换到 Build 模式：让它按定稿方案动手改/undo 撤回它做的修改，再来一遍| OpenCode 的"零件" | 是什么 / 怎么用 |
|---|---|
| 斜杠命令 | TUI 里输入 / 唤出：/new 新会话、/undo 撤销上一步修改、/share 生成会话分享链接、/models 换模型、/help 帮助；还支持自定义命令 |
| 权限控制 | 在 opencode.json 里按工具配置（如 edit 编辑、bash 跑命令允许 / 询问 / 禁止）；运行中触发敏感工具会弹窗等你批准 |
| 自定义代理 | 可以造自己的"人格"：限定它能用哪些工具、权限多严，比如"只许改文档的审校员" |
| 自定义命令 | 把常用提示词写成 Markdown 文件放进 .opencode/command/，变成团队共享的快捷命令 |
| 插件 | JavaScript/TypeScript 插件，挂在工具执行等事件上做钩子（如禁止碰某些文件、自动格式化） |
| MCP 扩展 | 在 opencode.json 的 mcp 配置段挂载外部工具服务器，本地或远程都行 |
| 项目规范 | 支持 AGENTS.md 一类的项目说明文件，进来先读懂规矩再干活 |
DSH（DeepSeek Harness）是 DeepSeek AI 开源的智能体框架，DeepSeek 模型原生加持。它不止写代码：用自然语言就能让代理读写文件、执行命令、委派子代理、编排工作流。官方提供 CLI、Web UI、VS Code 扩展三种形态，并有活跃的插件生态。
npm 包 @deepseek-ai/dsh 一键启动终端代理或本地 Web 界面，双形态随意切换。
扩展商店搜 "DSH Agent"，通过 ACP 协议在编辑器里直接对话代理，边写边让 AI 干活。
社区插件市场（如 DSH 插件商店）提供 Skills 技能包与 MCP 服务器挂载插件，装上就多新能力。
社区（hust-open-atom-club）维护的整合包 oh-dsh：一条 ohdsh 命令在桌面端 / Web / TUI 三种形态间切换。
npm install -g @deepseek-ai/dsh # 安装官方 CLI / Web UI 启动包 dsh # 在项目目录启动代理（首次按提示配置模型）
不想折腾命令行？装 VS Code 扩展 "DSH Agent"，或用社区发行版 oh-dsh 获得桌面端 / Web / TUI 三合一体验。
dsh，用大白话描述任务（"读这个项目，修复登录报错"）| DSH 的"零件" | 是什么 / 怎么用 |
|---|---|
| 内置能力 | 读写文件、执行终端命令、检索代码、联网查询；支持委派子代理并行干活、编排多步工作流 |
| 权限审批 | 敏感操作（改文件、跑命令）会先请求确认；可在配置里调整放行范围，新手保持"多问"档 |
| 三种形态 | CLI / Web UI / VS Code 扩展（ACP 协议）随时切换；oh-dsh 发行版用一条 ohdsh 命令管理全部形态 |
| 插件生态 | 插件商店提供 Skills 技能包与 MCP 服务器挂载（mounts）类插件；也有官方指南教你设计、打包自己的插件 |
| Python SDK | 官方 deepseek-harness-sdk：写 Python 程序直接调度 DSH，把它嵌进自动化流水线 |
| 开源 | 框架开源，GitHub 上可看源码、提 Issue；社区有蓝皮书 / 指导手册从零上手到插件开发 |
| 工具 | 出品方 | 形态 | 模型 | 模式与扩展 | 适合谁 |
|---|---|---|---|---|---|
| ZCode | Z.ai | CLI / 桌面端 / Web | GLM 系列（官方 Harness） | Goal Mode + 权限审批；Skills / Subagents / MCP / 定时自动化 | 想要开箱即用、中文生态、围绕仓库完整开发的人 |
| OpenCode | 开源社区 | 终端 TUI（另有 CLI） | 任意厂商（自己接 API） | Plan / Build 双代理（Tab 切换）+ 权限配置；自定义代理 / 命令 / 插件 / MCP | 喜欢开源、想灵活选模型的"键盘流"玩家 |
| DSH | DeepSeek | CLI / Web UI / VS Code 扩展 | DeepSeek 系列（原生） | 子代理 + 工作流编排；插件商店（Skills / MCP）、Python SDK、开源 | DeepSeek 用户、爱装插件折腾玩法的人 |
看任何一款工具的文档都会撞上这些词，先备好字典。
| 术语 | 中文 | 一句话解释 |
|---|---|---|
| Agent | 代理 / 智能体 | 能自主调用工具、多步完成任务的 AI，不只是"你问我答" |
| Tool | 工具 | 代理的"手"：读文件、改文件、跑命令、联网搜索都是一个个工具 |
| Plan mode | 计划模式 | 只读不改，先给实现方案；讨论定稿后再切执行模式动手 |
| Permission | 权限 | 哪些操作 AI 能直接做、哪些要人工批准，安全的第一道闸 |
| Context | 上下文 | AI 一次能"装进脑子"的内容上限；项目太大时它会挑重点读 |
| Token | 令牌 | 模型计费与计量的单位，约等于半个到一个词，API 按量收费 |
| MCP | 模型上下文协议 | 给代理接外部工具的通用标准，被三款工具共同支持，像"USB 接口" |
| Skill | 技能 | 写成文档的"成套做法"，装上后代理会按套路完成某类任务 |
| Subagent | 子代理 | 主代理派出去干活的"分身"，并行处理、汇报汇总 |
| TUI | 终端图形界面 | 在终端里画出窗口、菜单的界面（区别于纯命令行和网页） |
| ACP | 代理客户端协议 | 让编辑器（如 Zed、VS Code 扩展）和代理对话的标准接口 |
| Harness | 工具链 / 运行时 | 给大模型装上"手脚和界面"的框架，模型是脑子，Harness 是身体 |
工具会过时，习惯不会。这是让 AI 代理干活又快又稳的关键。
说清"目标 + 约束 + 验收标准"："加个搜索框，用现有配色，改完自查手机端排版"远好过"帮我改改网站"。
大任务拆成小任务，一次一个。每完成一步就验证一步，出错好定位，也不怕它"跑偏十万八千里"。
重要改动先让它在计划模式出方案，你确认了再放行动手——一次通过率远高于"上来就改"。
让代理改代码前先 commit 存档（这正是本站教程教过的！），改砸了一键回滚，永远有后悔药。
技术栈、规范、禁区写进项目说明书，一次编写长期生效，比每次口头叮嘱靠谱得多。
AI 会一本正经地出错。跑通了 ≠ 做对了，最终验收的责任在你。把它当实习生，不是当领导。
zcode.z.ai 与 GitHub 的 zai-org/ZCode；OpenCode 见 opencode.ai；DSH 见 npm 包 @deepseek-ai/dsh、VS Code 扩展 "DSH Agent" 与社区 awesome-deepseek-harness 合集。安装命令和界面常变，但"目标 → 规划 → 执行 → 审阅"的使用逻辑长期不变。