文件树即组织架构。
岗位住在文件夹里,嵌套的文件夹定义汇报关系。团队结构留在磁盘上,随时可以打开看、可以核对。
一个工作区是本地项目文件夹;一个岗位是 AI 员工的职位,有自己的指令和预算;一个会话把该岗位的本地对话轮次归到一起。
positions/
└── repo-owner/
├── SKILL.md
├── budget.json
├── issue-researcher/
├── community-operator/
└── release-engineer/
仓库里的 examples/oss-maintainer 就是这样一个开源维护团队:一个仓库负责人带三个支撑岗位——issue 调研、社区运营、发版工程。移动一个岗位就改变了汇报关系;在应用内归档会把岗位保留在工作区的备份区,需要显式恢复。
结构不藏在某个配置里,它就是磁盘上的目录。
组织团队、与岗位工作、看清发生了什么
三件事构成日常使用的闭环——点开每一条看细节。
组织一支 AI 团队
创建岗位时写明它的指令与明确的 token 预算,随时调整汇报关系,把不再需要的岗位归档、需要时再恢复。改变组织结构就是移动文件夹。
与单个岗位一起工作
发起对话,回看本地历史;任务换了就开一个新会话。新会话保留此前的本地记录,但它不授予新的权限,也不代表底层 AI Host 恢复了上一次会话。
看清发生了什么
已记录的活动、组织变更、每一轮的结果与可用预算使用情况都在报表中心。工作区文件与对话记录存在本地——但本地存储不等于离线 AI:提示词与任务上下文仍会发送给你所配置的 AI 提供方。
GET /health 外均需每次启动新生成的 Bearer token引擎跑在你的机器上。
桌面端默认适配器使用本机安装的 Qoder CLI(1.1.x 系列)。RoleWeave 不包含模型订阅;本机就绪检查确认的是 CLI 前置条件,不代表账号访问,也不代表一次成功的模型请求。
连接服务均为可选,未配置时显示为未连接。服务 token 放在服务端环境里,不进岗位文档、提示词和提交的文件。
装好,然后发出第一个任务。
v0.1.1 提供 macOS(Apple Silicon)与 Windows x64 安装包。这是早期预览版:macOS 包未做 Apple Developer ID 签名与公证,Windows 安装包未做 Authenticode 签名,系统可能在安装或首次启动时给出安全提示。
macOS
Apple Silicon。更新清单有独立的密码学签名(它不等于 Apple 代码签名信任)。
Windows
x64 安装包。自动更新仍待完成,新版本用安装包手动更新。
- EXE 安装包
- 未做 Authenticode 签名
- 安装时可能需要手动放行
- 自动更新:待完成
Linux / Intel Mac
v0.1.1 未包含这两类安装包。可以从源码构建,或关注后续发布。
- Node.js 24 + npm + Git
- 与 design-system 仓库并列放置
npm run doctor环境自检- 查看全部 releases
- 安装并打开 RoleWeave。界面支持英文与简体中文;在右上角标题栏打开 Preferences,选择 Language 切换。
- 新建或打开工作区。用项目菜单创建项目,或打开已有的
digital-employee工作区;想看现成的团队,克隆仓库后打开examples/oss-maintainer。 - 选一个岗位。看它的指令与预算,或直接为你要做的事新建一个岗位。
- 准备 AI Host。安装 Qoder CLI(1.1.x)并配置好账号访问。自定义安装路径用服务端环境变量
ORG_WORKBENCH_QODER_BIN指向可执行文件,改动启动环境后需重启应用。 - 发一个小任务。例如“总结你的岗位指令,并提出第一个任务”,然后回看记录下来的结果。