进阶 / 开发者文档

banz 是给人和 agent 一起工作的环境。你在自己的电脑上运行 Claude Code、Codex 等 agent，每段工作显示成一个会话；团队共享项目、主题、聊天和记忆。agent 会从工作中学习，下次开始任务时带上学到的东西。

这里是 banz 的中文使用手册。

从哪里开始

你是	先读
第一次用	1 快速上手：先装好 Claude Code 或 Codex，再用 10 分钟装好 banz、开始第一个会话
已经装好，想用得更顺	2 认识工作台、3.1 会话页
要和团队一起用	4 项目与主题、8 沟通、9 组织与设备
遇到问题	12.2 常见问题

目录

章	内容
1 快速上手	安装、注册与登录、开始第一个会话、更新与卸载
2 认识工作台	界面布局、打开方式与手机、快捷键与命令面板、设置窗口
3 会话	会话页、回答提问和权限请求、模型与模式、运行与整理、等你处理、导入、别人的会话、用量
4 项目与主题	项目、主题、看板、工作状态与标签、Webhooks 与 GitHub
5 agent 与技能	新建和设置 agent、开放给同事、日常管理、技能
6 工作流与自动化	工作流、编辑工作流、运行与人工步骤、自动化
7 记忆	记忆怎么来、四个层级、查看和管理、设备记忆
8 沟通	聊天、群聊与话题、收件箱与通知、秘书
9 组织与设备	创建组织、邀请成员、角色，一个账号的多台电脑
10 桌面应用附加功能	内置浏览器、终端、语音输入、会话设备上的文件
11 命令行 banz	常用命令速查，在脚本和 agent 里用 banz
12 故障排查	体检与日志、常见问题、备份与恢复
13 网页版与团队管理	写给组织的所有者和管理员

几个基本概念

概念	是什么
banz	装在你电脑上的程序。它在后台运行 agent，把工作台呈现在桌面应用或浏览器里
工作台	banz 的界面：会话、项目、聊天、收件箱等都在这里
服务器	账号服务器。地址是 https://service.emphar.com
设备	登录了你账号的一台电脑。一个账号可以有多台设备
agent 程序	真正干活的程序：Claude Code、Codex、DeepSeek Harness 或 Kimi Code。banz 自己不带模型。界面上叫“智能体程序”
agent	相当于一个岗位：用哪个 agent 程序、在哪个文件夹工作、用什么模型和模式。界面上叫“智能体”
会话	agent 的一段工作，显示成一场对话
轮次	你发一条消息、agent 做完回复，算一轮
token	模型计算用量的单位，用得越多花费越高
项目、主题	项目是一块长期的工作，主题是项目下的一件具体的事
技能	写好的做法和规范，可以在 agent 里启用
工作流、自动化	把几步工作串起来按顺序跑；按时间自动开始工作
记忆	从工作中学到的事实、决定和做法，开始新任务时带给 agent
收件箱	所有等你处理的事和新消息集中在这里
组织	一个团队。组织里的成员共享组织的项目
秘书	你账号专属的一个 agent，在你忙别的事时接手你交给它的事、替你回复聊天消息