Tubun Agent · macOS 安装与首次任务
版本：0.1.0-preview.20261012.3
发布日期：2026-10-12

系统要求：macOS 14 或更新版本，Apple Silicon（M 系列芯片）。
内置 Node.js，无需安装开发工具。安装包尚未完成 Developer ID 签名、公证与全新 Mac 验收。如果系统阻止安装，请联系支持安排协助试用；不要为试用而关闭系统安全保护。

安装文件
Tubun-Agent-0.1.0-preview.20261012.3-macOS-AppleSilicon.pkg
大小：101,613,334 字节（约 101.6 MB）
SHA-256：87106e1c273a7751f5ae2db57850b9858182b89def06b8e30ebd849c2ea3b8b0
校验清单：https://tubun.tech/downloads/SHA256SUMS.txt

安装
1. 下载 Tubun-Agent-0.1.0-preview.20261012.3-macOS-AppleSilicon.pkg。
2. 打开文件，按照 macOS 安装向导阅读说明、选择安装位置并完成安装。系统可能要求由电脑管理员授权安装。
3. 从“应用程序”打开 Tubun Agent。应用带有图班图标，会在本地服务就绪后打开工作台。
4. 启动窗口提供“打开工作台”、重试和退出；选择“退出 Tubun Agent”可停止本实例服务。

第一项任务（指南更新：2026-10-12）
1. 打开“设置 → 模型连接”，添加自己的模型服务地址及认证信息并验证。首次任务请选择支持工具调用的通用对话模型。
2. 在“设置 → 角色”选择 Plan，在“模型”页签中选择已验证连接及可用模型，然后保存角色。模型用量由服务商单独计费。
3. 在“工作文件”中选择一个空文件夹。本次不需要订单文件或业务系统连接。
4. 在“知识空间”新建“首项任务”。通过“新建主题”分别创建“统计对象”和“统计口径”。每个主题会自动产生同名根节点，无需另建子节点。
5. 点击“手动记录”，标题为“按月订单统计”。在“主题归类”中各选一个“统计对象”和“统计口径”的同名节点；少于两个不同主题不能保存资料。正文填写：
   以去重订单编号计数，按创建月份汇总；没有订单的月份显示 0；统计前先确认是否排除已取消订单。
   点击“创建资料”，确认资料已出现在空间中。
6. 回到“设置 → 角色 → Plan → 知识空间”，勾选“首项任务”并保存角色。
7. 在规划模式开始对话，输入：
   请读取“首项任务”知识空间中的“按月订单统计”，解释统计前需要哪些字段和确认事项，并引用实际读取的资料。没有订单数据时不要计算数量，不要修改文件或连接业务系统。
8. 打开引用资料，与保存的规则核对。回复应说明订单编号、创建月份和取消订单的处理口径，不能编造订单数量；来源应为刚创建的资料。

常见卡点：资料无法创建时，检查“主题归类”是否选了两个不同主题的节点；角色看不到知识时，检查空间勾选后是否保存了角色。之后尝试执行模式前，也需要为 Agent 绑定模型并分配所需知识空间。

数据、升级、卸载
数据位于 ~/.tubun-preview，与应用安装目录分离。包内没有开发者账号、聊天、客户知识、自动任务或已授权的外部系统。
更新前先退出应用并备份数据目录。重新安装应用不会替换原有用户数据。卸载时移除 /Applications/Tubun Agent.app；是否保留数据由你决定。
浏览器关闭不会自动停止应用，请从应用菜单选择退出。若端口被占用，应用会提示错误，不会接管其他服务。
部分外部 MCP、浏览器自动化和 Python/DXF 能力需要另行安装依赖。本地预览版不代表已提供企业多租户隔离。

旧 ZIP 预览包
上一版 0.1.0-preview.20260930.4 仍供高级用户使用。需完整解压并打开 Start Tubun.command，Ctrl+C 停止。不要只拷贝启动文件。与新版使用同一个预览数据位置，请勿同时运行两份。

支持：https://tubun.tech/contact.html?interest=support
官方运行案例：https://tubun.tech/demos.html

---
Tubun Agent · macOS installation and first task
Version: 0.1.0-preview.20261012.3
Release date: 2026-10-12

Requires macOS 14 or later on Apple Silicon. Node.js is included.
This preview does not have Developer ID signing or notarization, and a full clean-Mac installation remains unverified. If macOS blocks it, contact support for an assisted trial. Do not disable system protections to try the app.

Installer
Tubun-Agent-0.1.0-preview.20261012.3-macOS-AppleSilicon.pkg
Size: 101,613,334 bytes (about 101.6 MB)
SHA-256: 87106e1c273a7751f5ae2db57850b9858182b89def06b8e30ebd849c2ea3b8b0
Checksum list: https://tubun.tech/downloads/SHA256SUMS.txt

Install the PKG, then open Tubun Agent from Applications. The installer may need your computer administrator's authorization. The workspace opens when the local service is ready.

First task (guide updated: 2026-10-12)
1. Under Settings → Model connections, add and verify your own connection. Choose a general chat model that supports tool calling.
2. Under Settings → Roles, select Plan. On the Model tab, select the verified connection and available model, then save the role. Your provider bills model usage separately.
3. Select an empty folder in Work files. This task does not need order files or business-system connections.
4. In Knowledge spaces, create First task. Use New topic to create Counting object and Counting rule. Each topic automatically has a root node with the same name; no extra child nodes are needed.
5. Choose Manual entry and use Monthly order count as the title. Under topic classification, select the Counting object and Counting rule nodes, one from each topic. At least two different topics are required. Enter this rule:
   Count unique order IDs by creation month. Show zero for months with no orders. Confirm whether cancelled orders should be excluded before calculating.
   Choose Create material and confirm the entry appears in the space.
6. Return to Settings → Roles → Plan → Knowledge spaces, select First task, then save the role.
7. Start a conversation in Plan mode and send:
   Read Monthly order count in the First task knowledge space. Explain which fields and decisions are needed before counting, and cite the entry you actually read. Do not calculate without order data, change files or connect to business systems.
8. Open the cited entry and compare it with the saved rule. The answer should identify the order ID, creation month and cancellation decision, without inventing an order total. Confirm the source is the entry you created.

If an entry will not save, check that nodes from two different topics are selected. If the role cannot see it, check that the space assignment was saved. Before trying execution mode later, configure Agent's model and knowledge spaces too.

Use Quit Tubun Agent to stop the local service. Closing the browser does not quit the app. Data is kept in ~/.tubun-preview, separately from the application. Quit the app and back up that folder before upgrades. Removing /Applications/Tubun Agent.app leaves user data intact. The package contains no developer accounts, customer knowledge, conversations or scheduled tasks.

Some integrations require additional software. This local preview is not a hosted multi-tenant enterprise service. Intel Mac downloads are not yet available. An unsigned Windows x64 test build is available separately; installation and runtime checks on a Windows PC are pending. See https://tubun.tech/downloads/windows-quickstart.txt.

The previous ZIP preview requires extracting the whole folder and running Start Tubun.command; stop it with Ctrl+C. It uses the same preview data directory. Do not run both versions at once.

Support: https://tubun.tech/contact.html?interest=support
Official runs: https://tubun.tech/demos.html