开源 · 桌面应用
交给 AI,进度不丢。
交给 AI,进度不丢。Today 是管理你所有项目的一个页面:哪些在等你回复,哪些需要接着做,哪些正在运行,接下来是什么,一眼看清。
- MIT 许可,企业版(Enterprise Edition)模块采用 BUSL-1.1
- 免费下载。需要 Docker Desktop 和 Claude Code。
- macOS、Windows、Linux
助手发来一个请求,你批准它,助手继续工作,一个任务完成,计划随之推进。
Today · 10月4日 星期日
有一个助手在等你回复
它已经等了 1 分钟。
17/38 个任务已完成
来自这里跟踪的 3 个计划
- 4 进行中
- 1 等你回复
- 1 被阻塞
- 15 即将开始
等你回复1
- 问题欢迎晚宴与菜单活动
餐饮商为 24 位客人提供了两种菜单。我该确认哪一种?
自由对话:未关联任何计划
打开对话
待接手1
- 准备经费申请任务被阻塞经费已停止 2 天$2.405/121 被阻塞
继续将重新运行 2 个任务;已完成 5 个
1 个被阻塞的任务将被跳过
- 拿到合作方签字的信函
继续之前请先解除阻塞:被阻塞的任务会被跳过。
我的任务
- 确认场地定金已完成组织秋季团队外出活动
- 向嘉宾发送日期预告已完成组织秋季团队外出活动
- 选定欢迎晚宴的菜单欢迎晚宴与菜单
- 订火车票组织秋季团队外出活动
进行中2
- 组织秋季团队外出活动1h 16m$5.8510/183 进行中3 个助手正在处理活动
- 欢迎晚宴与菜单28m$2.052/81 等你回复1 进行中1 个任务在等你回复活动
助手
1 个在等你回复 · 3 个在工作
$5.50
提案 1
- 把预算表分享给整个团队
决策 1
- 外出活动改在 11 月,而不是 10 月
待复查的笔记 1
- 客舍周一不营业
助手发来一个请求,你批准它,助手继续工作,一个任务完成,计划随之推进。
Today · 10月4日 星期日
有一个助手在等你回复
它已经等了 1 分钟。
17/38 个任务已完成
来自这里跟踪的 3 个计划
等你回复1
- 问题欢迎晚宴与菜单活动
餐饮商为 24 位客人提供了两种菜单。我该确认哪一种?
自由对话:未关联任何计划
打开对话
进行中2
- 组织秋季团队外出活动1h 16m$5.8510/183 进行中3 个助手正在处理活动
- 欢迎晚宴与菜单28m$2.052/81 等你回复1 进行中1 个任务在等你回复活动
助手
1 个在等你回复 · 1 个在工作
$5.50
基于可以查看源码的开放工具
31
个 MCP 工具
每个工具都有一个 action 参数:plan、task、note、decision、code……
17
种 tree-sitter 语法
Rust、TypeScript、Python、Go、Java、C、C++ 等,解析后存入图谱。
3
个桌面平台
Tauri 应用支持 macOS、Windows 和 Linux。
问题所在
AI 助手之间没有共同记忆,会出三种问题
逐个往下看。先看会发生什么,再看 Project Orchestrator 留下了什么,让这些问题不再发生。
1 / 3
每次对话,助手都从零开始
你讲了自己的目标、偏好和已经定下的事。对话一关,助手全忘了。下一次,你又得重讲一遍。
有了 Project Orchestrator
PO 把你的笔记和决策与项目放在一起。做任务之前,助手会先查找适用的内容,而且按含义搜索,不只是匹配原词。
幕后细节
笔记和决策存放在 Neo4j 的图谱中。note(action: "search_semantic") 借助 Meilisearch 按含义找到它们。
2 / 3
助手同时改动同一样东西
两个助手编辑同一份文档。有的工作在它所依赖的工作完成之前就开始了。于是你只好一次只做一件事,本想节省的时间也白白浪费。
有了 Project Orchestrator
计划会写明哪个任务依赖哪个任务。互不依赖的任务同时进行,其余的等待它们所需的任务。
幕后细节
PO 用 plan(action: "get_waves") 根据任务依赖算出批次。声明会影响相同文件的任务,会被分到不同批次。
3 / 3
做出选择的理由渐渐丢失
为什么选这个地点,为什么定这笔预算。理由只留在某个人的脑子里或一条旧消息里。下一个助手会重新问一遍,或者推翻这个选择。
有了 Project Orchestrator
决策会连同理由和影响范围一起保存。下一个助手在改动相关内容之前,会先看到它和它的状态。
幕后细节
用 decision(action: "add_affects") 把决策关联到它影响的任务、计划或文件,并带有状态,例如已提议或已接受。
一个计划,两种视图
多个任务同时进行,而不是一个接一个
有些任务要等另一个任务完成才能开始,其余的可以一起启动,这一组任务叫作一个批次。同一个计划,既可以看成一张关系图,也可以看成一块分列的看板。
Organize the team weekend
0/8 done (0%)
- Wave 12 in parallel, 6 min
- Wave 22 in parallel, 14 min
- Wave 33 in parallel, 12 min
- Wave 41 in parallel, 7 min
Shortlist three venues near a train station
Collect everyone’s availability
Book the venue
Write the invitation
Plan the two-day schedule
Arrange meals and transport
Send invitations and track replies
Share the final plan with the team
一个助手,逐个任务
71 min
分批并行
0 min / 39
节省的时间
—
运行计划才能测出来
示意场景:时长是为这个演示编写的助手分钟数,不是基准测试结果。
它能做什么
你的项目、计划和决策,集中在一处
有代码或没有代码的项目、计划、协同工作的助手、记录已有决定的记忆,以及只在你同意后才进行的共享。下面逐一介绍。
记忆
PO 记得你的决定和心得
笔记、决策以及它们之间的联系,都和你的项目放在一起。需要时,PO 会把它们找出来。向下滚动,看一份记忆如何生长。
虚构示例:一个小型活动项目。图中的名称只是示意,不是你的数据。颜色和形状与产品中的图谱一致。
第 1 步,共 5 步
你的文件变成圆点
PO 从项目里已有的内容开始:文档、表格、文件。每个文件是一个蓝色圆点。
第 2 步,共 5 步
计划和任务加入进来
计划和任务被加到同一张图里。每个任务都与它涉及的文件相连。
第 3 步,共 5 步
笔记和决策保持相连
学到的东西成为笔记,做出的选择成为决策。两者都与文件相连,彼此之间也相连。
第 4 步,共 5 步
相关的内容聚在一起
主题相同的内容会彼此靠近。项目的主要主题一目了然。
第 5 步,共 5 步
PO 顺着连线找到答案
你提出一个问题,PO 找出匹配的笔记(青色),再顺着连线找到相关内容(紫色),即使用词不同也能找到。
幕后:连线的名称
这些是产品图谱中各种连线的名称。使用 PO 并不需要了解它们。
- CONTAINS计划包含它的任务。
- IMPORTS一个文件使用另一个文件。
- AFFECTS任务涉及某个文件。
- CO_CHANGED经常一起修改的两个文件,从代码历史中看出。
- SYNAPSE笔记、决策和文件之间的连线。没人用的连线会逐渐淡去。
工作原理
从一句话,到检查过的成果
规划、排序、回忆、执行、验证、学习。PO 对每个计划都这样做。
1 · 规划
你说出想要什么,就得到一份计划
你用一句话描述想要的结果,助手把它变成带任务的计划。每个任务有若干步骤,每个步骤都写明如何检查它已完成。
2 · 排序
互不依赖的任务放在一起
PO 给任务排序。一个任务只等待它所需的任务,其余的都可以现在一起开始。
3 · 回忆
助手先查找项目已经知道的内容
每个任务开始之前,助手会先读取适用的笔记和决策,所以不会把同样的问题再问一遍。
4 · 执行
助手一组一组地完成任务
每个任务交给各自的助手。一组里的任务同时运行,下一组等待。
5 · 验证
检查通过,一组才算完成
下一组开始之前,PO 会检查工作成果:步骤必须全部关闭,改动里不能留有敏感文件。对于代码项目,PO 还会检查它是否仍能构建。
6 · 学习
学到的东西留给下一次
工作完成后,决定了什么、学到了什么,都会写回项目记忆。下一个计划就从这里开始。
第 6 阶段保存的内容,就是下一个计划在第 3 阶段回忆起的内容。
逐个阶段跟随一次运行试一试
看助手如何借助 PO 工作
选一个请求。你会看到用平实语言写的回答,以及助手在幕后对 PO 发出的调用。点开一个调用,可以查看细节。
Two notes apply: the place must be close to a train station, and last year the menu had nothing vegetarian. I will write the plan around both.
The plan has 3 tasks in 2 waves. The shortlist and the date poll do not depend on each other, so they happen at the same time. Booking waits for both.
模拟演示:回答是预先写好的,不会连接任何服务器。调用及其参数是真实的。
PO 的未来方向
每个人保留自己的 PO,组织共享它选择共享的内容。
想象一家公司:共同的知识、团队、成员和访问权限。基础的一部分今天已在运行,组织层还在计划中。
示意图,人物为虚构。
已可用
每人一个 PO:独立的身份、登录、工作区、保险库
进行中
PO 实例之间的共享,仅在同意后进行
计划中
共同的知识、团队和角色、访问权限
下载
下载 Project Orchestrator
选择适合你电脑的应用。无需注册 Project Orchestrator 账号。
开始之前
- Docker Desktop。应用用它来运行所需的服务,也可以帮你安装它。
- Claude Code,聊天功能由它驱动。AI 本身不包含在内:你需要自己的 Claude 账号。
- 首次启动需要几分钟。设置向导会引导你,并下载缺少的内容。
Linux 5
- Linux,AppImage126 MB一个文件即可在大多数 Linux 发行版上运行(x86_64)。Project.Orchestrator_0.0.16_amd64.AppImage
- Debian 和 Ubuntu,x86_6458.1 MB用 dpkg 或 apt 安装的软件包。Project.Orchestrator_0.0.16_amd64.deb
- Debian 和 Ubuntu,arm6452.7 MB用 dpkg 或 apt 安装的软件包,适用于 ARM64 设备。Project.Orchestrator_0.0.16_arm64.deb
- Fedora 和 RHEL,x86_6436.7 MB用 dnf 或 rpm 安装的软件包。project-orchestrator-0.0.16-1.x86_64.rpm
- Fedora 和 RHEL,arm6430.7 MB用 dnf 或 rpm 安装的软件包,适用于 ARM64 设备。project-orchestrator-0.0.16-1.aarch64.rpm
orchestrator、orch 和 mcp_server,已包含网页界面。不含网页界面的精简版在版本页面。
面向开发者:命令行
Homebrew
适用于 Mac 和 Linux。安装 orchestrator、orch 和 mcp_server。
brew install this-rs/tap/project-orchestrator安装脚本
适用于 Mac 和 Linux。把最新版本装到 ~/.local/bin。加上 --no-frontend 可安装精简版。
curl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | shPowerShell
适用于 Windows。安装到 %LOCALAPPDATA%\orchestrator\bin。
irm https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.ps1 | iexDocker
支持 amd64 和 arm64 的镜像,含网页界面。
docker pull ghcr.io/this-rs/project-orchestrator:latest# API only, no dashboard: a version tag with the -api suffix# docker pull ghcr.io/this-rs/project-orchestrator:0.0.16-api服务器需要什么
- 项目记忆
- Neo4j 5
- 搜索
- Meilisearch
- 事件总线
- NATS(可选)
- 运行环境
- Docker 20.10+
桌面应用会替你在 Docker 中启动 Neo4j 和 Meilisearch。使用命令行时,一条 compose 命令就能完成:请看快速上手。
安装
从下载到首次启动
不需要终端。先安装两个辅助工具,其余由应用完成。请预留几分钟:首次启动会下载它运行所需的内容。
macOS
macOS 10.15 或更高版本。Apple 芯片(M1 及更新)或 Intel。
需要先准备的东西
勾选你已有的,下面的步骤会随之调整。
Claude Code 用于聊天
聊天助手需要它,设置过程会等待它就绪。设置中的 Chat AI 部分,应用可以替你安装它。AI 本身并非由 Project Orchestrator 提供。
第 1 步: 安装并启动 Docker Desktop
从 Docker 的页面下载 Docker Desktop,打开文件,把 Docker 拖到“应用程序”,然后打开它,等到它显示正在运行。
你应该看到. Docker Desktop 已打开,并显示它正在运行。这是 Docker 自己的界面,所以这里没有复刻。 第 3 步: 打开应用
打开 .dmg,把 Project Orchestrator 拖到“应用程序”,再从那里打开它。如果 macOS 提示无法验证该应用(我们无法核实这个构建的签名方式),请在“系统设置”的“隐私与安全性”中点“仍要打开”(Open Anyway)。
你应该看到. 一个启动页面列出应用要检查的项目。首次启动时,Docker 相关的几行会显示“Setup pending”。 第 4 步: 设置 1/4:Infrastructure
保持选中“Docker (recommended)”。应用会查找 Docker Desktop。当它显示“Docker Desktop is running”时,点 Next。如果提示 Docker 缺失或未运行,请使用提示旁边的按钮,然后等待:应用会自动再次检查。
各项服务使用本地端口 7474、7687、7700 和 4222,应用自身使用 6600。
你应该看到. 两张卡片下方有一行绿色文字“Docker Desktop is running”,并且选中了“Docker (recommended)”。 第 5 步: 设置 2/4:Authentication
在只有你自己使用的电脑上,保持“No authentication”并点 Next。在共享或公共网络上,请选择“Password”并设置邮箱和密码:不设置登录时,应用的服务器会接受整个网络的连接。
你应该看到. 三个选项(No authentication、Password、OIDC / OAuth),第一个被选中。 第 6 步: 设置 3/4:Chat AI
如果显示“Claude Code CLI is required”,请点“Install Claude Code CLI”。然后在应用提示时让它下载搜索模型,屏幕上会显示大小。两者都就绪后,Next 才会解锁。
如果你还没有登录 Claude,请看下面的“If it does not work”部分(遇到问题时)。
你应该看到. Claude Code CLI 安装完成后会显示绿色对勾(在此之前显示“Claude Code CLI is required”和一个安装按钮),搜索模型被标为 ready。 第 7 步: 设置 4/4:Launch
点“Generate Config & Save”。出现“Configuration saved!”后,点“Restart Application”。这个页面上有一个开关,控制应用启动时是否检查更新。
你应该看到. 一条绿色的“Configuration saved!”消息,和一个“Restart Application”按钮。 第 8 步: 等待首次启动完成
第二次启动时,应用会下载它运行所需的三个镜像,然后启动它们。首次可能需要几分钟,取决于你的网速;之后的启动会复用这些镜像,速度更快。当每一行都变绿时,主窗口就会打开。
如果某一行显示“Taking longer than expected”,请等待。如果出现“Continue anyway”按钮,请看“遇到问题时”部分。
你应该看到. 一份清单(Docker Desktop、Neo4j、Meilisearch、NATS、Backend server),一行一行地变绿。
遇到问题时
你最可能遇到的三个问题,以及应用显示的内容。
Docker 没有运行
你看到的现象. 应用提示“Docker Desktop is not running”或“Docker Desktop is required”。
怎么办.
- 从“应用程序”文件夹打开 Docker(应用自己的 Open 按钮也能做到)。等到 Docker 显示它正在运行。
- 回到 Project Orchestrator:它会每隔几秒再次检查,持续约两分钟。之后请退出并重新打开应用。
端口已被占用
你看到的现象. Neo4j 或 Meilisearch 一直显示“Unhealthy”,或应用提示启动服务失败。这些服务需要本地端口 7474、7687、7700 和 4222。
怎么办.
- 关闭占用该端口的其他程序:另一个数据库、搜索服务器,或旧的 Project Orchestrator。
- 只有应用自己的端口(默认 6600)可以在设置的 Infrastructure 页面中更改,对应“API Server Port”。
只有在你习惯使用终端时,才用这条命令查看哪个程序占用了端口:
lsof -i :7687聊天连不上 Claude
你看到的现象. 设置提示“Claude Code CLI is required”,或聊天提示没有 Claude 登录。
怎么办.
- 在设置的 Chat AI 页面,点“Install Claude Code CLI”(或“Retry Install”)。
- 如果聊天随后要求登录,请打开“终端”应用,输入下面的命令,按回车,然后登录 Claude。
输入这条命令并按回车:
claudeWindows
Windows,64 位。
需要先准备的东西
勾选你已有的,下面的步骤会随之调整。
Claude Code 用于聊天
聊天助手需要它,设置过程会等待它就绪。设置中的 Chat AI 部分,应用可以替你安装它。AI 本身并非由 Project Orchestrator 提供。
第 1 步: 安装并启动 Docker Desktop
从 Docker 的页面下载 Docker Desktop,运行安装程序,然后从“开始”菜单启动 Docker Desktop,等到它显示正在运行。
你应该看到. Docker Desktop 已打开,并显示它正在运行。这是 Docker 自己的界面,所以这里没有复刻。 第 3 步: 打开应用
运行安装程序并按向导操作,然后从“开始”菜单启动 Project Orchestrator。因为构建配置中没有设置签名证书,Windows 可能会显示“Windows protected your PC”:如果你信任这个下载,请选择“More info”,再选“Run anyway”。
你应该看到. 一个启动页面列出应用要检查的项目。首次启动时,Docker 相关的几行会显示“Setup pending”。 第 4 步: 设置 1/4:Infrastructure
保持选中“Docker (recommended)”。应用会查找 Docker Desktop。当它显示“Docker Desktop is running”时,点 Next。如果提示 Docker 缺失或未运行,请使用提示旁边的按钮,然后等待:应用会自动再次检查。
各项服务使用本地端口 7474、7687、7700 和 4222,应用自身使用 6600。
你应该看到. 两张卡片下方有一行绿色文字“Docker Desktop is running”,并且选中了“Docker (recommended)”。 第 5 步: 设置 2/4:Authentication
在只有你自己使用的电脑上,保持“No authentication”并点 Next。在共享或公共网络上,请选择“Password”并设置邮箱和密码:不设置登录时,应用的服务器会接受整个网络的连接。
你应该看到. 三个选项(No authentication、Password、OIDC / OAuth),第一个被选中。 第 6 步: 设置 3/4:Chat AI
如果显示“Claude Code CLI is required”,请点“Install Claude Code CLI”。然后在应用提示时让它下载搜索模型,屏幕上会显示大小。两者都就绪后,Next 才会解锁。
如果你还没有登录 Claude,请看下面的“If it does not work”部分(遇到问题时)。
你应该看到. Claude Code CLI 安装完成后会显示绿色对勾(在此之前显示“Claude Code CLI is required”和一个安装按钮),搜索模型被标为 ready。 第 7 步: 设置 4/4:Launch
点“Generate Config & Save”。出现“Configuration saved!”后,点“Restart Application”。这个页面上有一个开关,控制应用启动时是否检查更新。
你应该看到. 一条绿色的“Configuration saved!”消息,和一个“Restart Application”按钮。 第 8 步: 等待首次启动完成
第二次启动时,应用会下载它运行所需的三个镜像,然后启动它们。首次可能需要几分钟,取决于你的网速;之后的启动会复用这些镜像,速度更快。当每一行都变绿时,主窗口就会打开。
如果某一行显示“Taking longer than expected”,请等待。如果出现“Continue anyway”按钮,请看“遇到问题时”部分。
你应该看到. 一份清单(Docker Desktop、Neo4j、Meilisearch、NATS、Backend server),一行一行地变绿。
遇到问题时
你最可能遇到的三个问题,以及应用显示的内容。
Docker 没有运行
你看到的现象. 应用提示“Docker Desktop is not running”或“Docker Desktop is required”。
怎么办.
- 从“开始”菜单启动 Docker Desktop(应用自己的 Open 按钮也能做到)。等到 Docker 显示它正在运行。
- 回到 Project Orchestrator:它会每隔几秒再次检查,持续约两分钟。之后请关闭并重新打开应用。
端口已被占用
你看到的现象. Neo4j 或 Meilisearch 一直显示“Unhealthy”,或应用提示启动服务失败。这些服务需要本地端口 7474、7687、7700 和 4222。
怎么办.
- 关闭占用该端口的其他程序:另一个数据库、搜索服务器,或旧的 Project Orchestrator。
- 只有应用自己的端口(默认 6600)可以在设置的 Infrastructure 页面中更改,对应“API Server Port”。
只有在你习惯使用终端时,才用这条命令查看哪个程序占用了端口:
netstat -ano | findstr :7687聊天连不上 Claude
你看到的现象. 设置提示“Claude Code CLI is required”,或聊天提示没有 Claude 登录。
怎么办.
- 在设置的 Chat AI 页面,点“Install Claude Code CLI”(或“Retry Install”)。
- 如果聊天随后要求登录,请打开 PowerShell,输入下面的命令,按回车,然后登录 Claude。
输入这条命令并按回车:
claudeLinux
适用于 Intel/AMD 的 AppImage;适用于 Intel/AMD 和 ARM64 的 .deb 与 .rpm 软件包。
需要先准备的东西
勾选你已有的,下面的步骤会随之调整。
Claude Code 用于聊天
聊天助手需要它,设置过程会等待它就绪。设置中的 Chat AI 部分,应用可以替你安装它。AI 本身并非由 Project Orchestrator 提供。
第 1 步: 安装并启动 Docker Desktop
按照 Docker 为你的发行版提供的页面操作,然后启动 Docker,等到它显示正在运行。应用也能识别没有安装 Desktop 应用的 Docker。
你应该看到. Docker 正在运行。这是 Docker 自己的界面,所以这里没有复刻。 第 2 步: 下载 Project Orchestrator
AppImage 可在任何发行版上运行。Debian 和 Ubuntu 用 .deb,Fedora 和 RHEL 用 .rpm。
- 下载 .AppImage
Linux,AppImage
x86_64,适用于任何发行版 · 132 MB
你应该看到. 文件出现在你的“下载”文件夹里。 第 3 步: 打开应用
对于 AppImage:在文件管理器中打开该文件的属性,允许它作为程序运行,然后双击。对于 .deb 或 .rpm:用软件安装器打开它,然后从应用程序菜单启动 Project Orchestrator。
你应该看到. 一个启动页面列出应用要检查的项目。首次启动时,Docker 相关的几行会显示“Setup pending”。 第 4 步: 设置 1/4:Infrastructure
保持选中“Docker (recommended)”。应用会查找 Docker Desktop。当它显示“Docker Desktop is running”时,点 Next。如果提示 Docker 缺失或未运行,请使用提示旁边的按钮,然后等待:应用会自动再次检查。
各项服务使用本地端口 7474、7687、7700 和 4222,应用自身使用 6600。
你应该看到. 两张卡片下方有一行绿色文字“Docker Desktop is running”,并且选中了“Docker (recommended)”。 第 5 步: 设置 2/4:Authentication
在只有你自己使用的电脑上,保持“No authentication”并点 Next。在共享或公共网络上,请选择“Password”并设置邮箱和密码:不设置登录时,应用的服务器会接受整个网络的连接。
你应该看到. 三个选项(No authentication、Password、OIDC / OAuth),第一个被选中。 第 6 步: 设置 3/4:Chat AI
如果显示“Claude Code CLI is required”,请点“Install Claude Code CLI”。然后在应用提示时让它下载搜索模型,屏幕上会显示大小。两者都就绪后,Next 才会解锁。
如果你还没有登录 Claude,请看下面的“If it does not work”部分(遇到问题时)。
你应该看到. Claude Code CLI 安装完成后会显示绿色对勾(在此之前显示“Claude Code CLI is required”和一个安装按钮),搜索模型被标为 ready。 第 7 步: 设置 4/4:Launch
点“Generate Config & Save”。出现“Configuration saved!”后,点“Restart Application”。这个页面上有一个开关,控制应用启动时是否检查更新。
你应该看到. 一条绿色的“Configuration saved!”消息,和一个“Restart Application”按钮。 第 8 步: 等待首次启动完成
第二次启动时,应用会下载它运行所需的三个镜像,然后启动它们。首次可能需要几分钟,取决于你的网速;之后的启动会复用这些镜像,速度更快。当每一行都变绿时,主窗口就会打开。
如果某一行显示“Taking longer than expected”,请等待。如果出现“Continue anyway”按钮,请看“遇到问题时”部分。
你应该看到. 一份清单(Docker Desktop、Neo4j、Meilisearch、NATS、Backend server),一行一行地变绿。
遇到问题时
你最可能遇到的三个问题,以及应用显示的内容。
Docker 没有运行
你看到的现象. 应用提示“Docker Desktop is not running”或“Docker Desktop is required”。
怎么办.
- 启动 Docker Desktop;如果你使用的是没有 Desktop 应用的 Docker,则启动你的 Docker 服务。应用自己的 Open 按钮只会尝试启动 Docker Desktop。
- 回到 Project Orchestrator:它会每隔几秒再次检查,持续约两分钟。之后请关闭并重新打开应用。
端口已被占用
你看到的现象. Neo4j 或 Meilisearch 一直显示“Unhealthy”,或应用提示启动服务失败。这些服务需要本地端口 7474、7687、7700 和 4222。
怎么办.
- 关闭占用该端口的其他程序:另一个数据库、搜索服务器,或旧的 Project Orchestrator。
- 只有应用自己的端口(默认 6600)可以在设置的 Infrastructure 页面中更改,对应“API Server Port”。
只有在你习惯使用终端时,才用这条命令查看哪个程序占用了端口:
lsof -i :7687聊天连不上 Claude
你看到的现象. 设置提示“Claude Code CLI is required”,或聊天提示没有 Claude 登录。
怎么办.
- 在设置的 Chat AI 页面,点“Install Claude Code CLI”(或“Retry Install”)。
- 如果聊天随后要求登录,请打开终端,输入下面的命令,按回车,然后登录 Claude。
输入这条命令并按回车:
claude常见问题
安装之前
简短的回答,每一条都对照过应用的源代码核实。
免费吗?
免费。下载不收费,源代码在 GitHub 上公开。
唯一可能产生的费用在应用之外:聊天助手通过 Claude Code 运行,它需要你单独安装,并遵循 Anthropic 的套餐和条款。
我的数据会去哪里?
你的计划、任务、笔记和决策都保存在你的电脑上,存放在应用替你启动的数据库和搜索引擎中。它们只接受来自你本机的连接。
聊天是与外界通信的部分:你输入的内容,以及助手为回答你而读取的内容,会由 Claude Code 按 Anthropic 的条款发送给 Claude。
按含义搜索在你的电脑上运行(它的模型只需下载一次)。应用启动时会检查 GitHub 上有没有新版本。在源代码中没有发现任何分析或追踪代码。
需要账号吗?
不需要 Project Orchestrator 的账号:没有什么需要注册,设置默认也不使用登录。
在设置过程中,你可以添加密码,或使用 Google、Microsoft 或其他 OpenID 提供方登录。
需要知道的是:不设置登录时,应用自带的服务器会接受整个网络的连接,而不只是你的电脑。在共享网络上,请选择设置密码。
必须安装 Docker 吗?
默认需要。应用把你的数据保存在数据库和搜索引擎中,并通过 Docker Desktop 运行它们。你只需安装一次 Docker Desktop,之后应用会自己启动和停止这些服务。
设置过程会检查 Docker,告诉你它是否缺失或未启动,并且在它运行之前不让你继续。
已经自己运行数据库和搜索服务器的人,可以改为让应用连接它们(设置里的“External servers”选项)。
AI 包含在内吗?还是需要我自己的订阅或密钥?
AI 不包含在内。聊天助手通过 Anthropic 的工具 Claude Code 工作,它必须安装在你的电脑上,并登录你的 Claude 账号。设置过程可以替你安装它。
登录时,你可能需要在终端里输入一次 claude,应用自己的提示里会这样说明。设置过程不会要求输入密钥。
Claude Code 需要哪种套餐由 Anthropic 决定,请查看他们的网站。在检测到 Claude Code 之前,设置过程不会让你完成。
不写代码也能用吗?
日常使用可以:你在应用里操作(Today、计划、任务、笔记、决策),并在聊天中向助手提出要求。安装也不需要终端,除了可能需要一次性的 Claude 登录。
项目不一定是软件:较新的版本支持没有代码文件夹的项目。
坦率地说,它的局限在于:产品最初面向开发者,有些页面仍然偏向开发者,例如聊天里的起始建议(影响分析、代码搜索、架构)。
它能在哪些电脑上运行?
可以和团队一起用吗?
目前还不能作为团队共享空间使用:现在每个人运行各自的 Project Orchestrator。
已有的功能:用来归拢你多个项目的工作区,以及两个实例之间共享的早期版本。你可以逐个项目决定,笔记是手动共享、以建议形式提给你,还是自动发送;副本可以失效,你也可以撤回共享。
计划中、尚不可用的功能:整个公司共用的一份知识库、团队与层级、角色和访问权限。
采用什么许可?
两种许可,如 LICENSE 文件所述(版权归 FFS SAS):MIT 和 BUSL-1.1。
MIT 许可下的部分可以自由使用、复制、修改和分享。
标为企业版(Enterprise Edition)的部分采用 Business Source License 1.1:你可以用它测试、开发和评估,但用于生产环境需要向 FFS SAS(contact@ffs.holdings)获取商业许可。该部分在发布四年后转为 MIT。
关闭窗口会怎样?
关闭窗口会把应用收到系统托盘,它仍在运行。要停止它,请在托盘图标上选择 Quit。
退出时,也会停止应用在 Docker 中启动的三项服务(数据库、搜索、事件)。如果你使用自己的服务器,则不会动它们。
如何获得帮助或参与贡献?
加入 Discord,可以求助或提出反馈。遇到错误,请在 GitHub 上提交 issue,并附上你的系统、复现步骤和任何错误信息。
欢迎贡献。贡献指南说明了如何搭建项目,以及一份好的报告应包含什么;它是为开发者写的。