使用指南 — Vinez

1

安装服务端（daemon）

挑一台团队都能访问的常开机器（Mac 或 Linux），一行命令完成安装：

curl -fsSL https://vinez.ai/install.sh | sh

安装器会从 GitHub Releases 下载对应平台的 vinezd 二进制，并注册为系统服务（macOS 用 launchd，Linux 用 systemd），开机自启、异常自愈。也可以到下载页手动下载二进制，直接运行 vinezd serve。

装完后浏览器打开 http://localhost:7833，看到任务看板即成功。聊天通道还没配置时，看板与手动建任务已经可以正常使用。管理员账号是 admin，初始密码在安装时随机生成、安装结束时会打印出来，也可以在 ~/.vinez/initial-admin-password 里查到。首次登录后请在「团队成员」页改密，改完把这个文件删掉。

Agent CLI（如 Claude Code）只需在这台服务端机器上安装并登录一次，全团队的任务都由它执行，同事各自的电脑上什么都不用装。

2

接入聊天通道

企业微信、飞书、Slack 三家都已支持，配了哪个就起哪个。以企业微信为例，创建一个智能机器人，把拿到的 Bot ID 和 Secret 写入配置：

# ~/.vinez/config.yaml
wecom:
  bot_id: "你的 Bot ID"
  secret: "你的 Secret"
  bot_name: "vinez"

重启 daemon 后机器人上线。建议直接私聊机器人派活；需要群内协作时，再把它拉进项目群并 @它。

三家的完整步骤（建机器人、配权限、拿凭据、绑同事身份、排障速查）见接入聊天通道。三家都走出向长连接，不需要公网 IP、不需要域名。

3

同事们开始使用

同事不需要安装任何东西。绝大多数时候，在聊天里说一句就够了。

在聊天里直接用

私聊直接说，或者在群里 @机器人 —— 发需求、答复它的提问、接收进展与完成通知。任务按发起人身份记录，各自参与、各自验收。

4

可选

想看细节，或者亲自接管

任务在 IM 里派、结果在 IM 里收，那条路本身就是完整的。但当你想知道它此刻在做什么、到底改了哪些文件，或者想自己接手一段时，打开 Web、桌面客户端或手机 App 就行，三者是同一套界面。

Web 客户端

浏览器打开 http://<服务器地址>:7833，用管理员分配的账号登录即可，什么都不用装。

桌面客户端 / App

想要 Dock 常驻与原生体验的同事，可以从下载页安装；首次使用在 IM 里向机器人发送 /bind 拿一个配对码完成配对，之后免登录直接进。不装不影响任何功能。

全队的活在一块看板上

谁派的、在哪个项目、跑到第几步、烧了多少 token、用的哪个 agent —— 正在进行和已经完成的，一屏看完。

它此刻在做什么

每个任务背后是一个真实的 agent CLI 终端，实时输出、永远可写。想自己来的时候，直接在这里敲字接管。

它到底改了哪些文件

每个任务的改动逐行可查，提交与分支一并记录 —— 不必等它说完，自己看就行。

它这一路是怎么做的

从收到需求到交卷，每一步的思考、命令与结果都留在回放里，随时可以回头看。

项目工作台

按项目而不是按任务看：这个仓里有什么、当前分支是什么、哪些任务正在动它 —— 也可以直接从这里派新活。

手机上也是同一套

出门在外收到「有问题需要你回答」，掏出手机就能看现场、回一句让它接着跑。

十分钟跑起来