关于 Veloci by ArcticRex
Veloci by ArcticRex 是连接 Veloci 工作区的插件,面向希望把目标、承诺事项和实际工作进展关联起来的团队或个人。它可从笔记协调承诺,并在支持的 Agent 会话启动时加载共享任务跟踪说明。
主要功能
- 01连接 Veloci 工作区
- 02设置与查看目标
- 03将笔记与现有承诺协调
- 04在支持的会话加载任务跟踪说明
- 05跟踪任务开始与完成
适用场景
- 01规划每周工作并关联目标
- 02从会议或工作笔记整理承诺
- 03在 Agent 会话中跟踪具体任务
- 04查看目标与未完成承诺
MCP 相关
插件通过用户自己的 Veloci 账户连接 `https://veloci.arcticrex.com/mcp/veloci`,由 Agent 使用授予权限的 Veloci 工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://veloci.arcticrex.com/mcp/velociclaude mcp add --transport http com-arcticrex-veloci https://veloci.arcticrex.com/mcp/veloci{"mcpServers":{"com-arcticrex-veloci":{"type":"http","url":"https://veloci.arcticrex.com/mcp/veloci"}}}在 Cursor 中打开{"servers":{"com-arcticrex-veloci":{"type":"http","url":"https://veloci.arcticrex.com/mcp/veloci"}}}在 VS Code 中打开{"mcpServers":{"com-arcticrex-veloci":{"type":"http","url":"https://veloci.arcticrex.com/mcp/veloci"}}}{"mcpServers":{"com-arcticrex-veloci":{"serverUrl":"https://veloci.arcticrex.com/mcp/veloci"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
ArcticRex 的 Veloci
将 Agent 连接到你的 Veloci 工作区:设定并回顾目标、根据笔记协调承诺事项,并让进度始终围绕重要工作推进。支持的 Agent 会话启动时,插件也会加载共享的工作跟踪说明。
试试“显示我的目标和未完成承诺事项,以便我们决定接下来什么最重要”,或“将这些笔记与我现有的承诺事项进行协调”。工具取决于你的工作区可用的功能。使用 Veloci 规划每周安排、将目标与承诺事项关联,并回顾进度。
面向 veloci.arcticrex.com 上现有 Veloci 账户的 Beta 版。 此来源由 ArcticRex 维护。它不是官方供应商目录条目,也不是经过验证的徽章。安装不会授予工作区访问权限。Claude Code 和 Cowork 条目已提交,正在等待审核。ChatGPT Work 验证尚待完成。
公开 Beta 市场。 按照以下步骤从 ArcticRex 仓库安装。如果已安装 Veloci,请先检查其端点、已启用的组件、身份验证、信任设置和新会话行为,再重新安装。
如果现有的 Veloci 连接使用不同的网关,请勿安装此测试版,也不要切换账户。请使用明确配置为适配你的网关的软件包。
Claude Cowork
- 打开 Customize → Plugins → Add marketplace。
- 输入 **https://github.com/ArcticRexOrg/veloci-plugins**。
- 选择 Veloci,安装它,然后登录你的 Veloci 账户。
- 启用插件组件,开始新的 Cowork 任务,并询问 “运行 Veloci init,检查自动任务跟踪。”
在每个 Cowork 会话中启用跟踪
如果新任务忽略 Veloci,请打开 Settings → Cowork → Global instructions,并在保留现有说明的前提下添加以下内容。保存后,开始一个新任务。如果插件本身未能加载相关说明,此设置会提供提醒。
对实质性工作使用 Veloci;状态问题无需创建任务。
对相关的后续工作、澄清、测试、评估和修复,复用已绑定的任务。如果已完成的工作重新开始,先调用 reopen_task,再对同一 ID 调用 start_task。只有在目标不同且没有匹配任务时,才在相关目标下创建新任务。开始时调用 start_task,并仅播报一次标题和 ID,然后持续绑定该 ID。
仅在开始时以及跟踪的工作确实完成时更新任务,除非用户要求更新。
跟踪的工作确实完成时——已发布、合并或落地——调用 complete_task 并报告结果。
Claude Code
在 Claude Code 中运行以下命令:
/plugin marketplace add ArcticRexOrg/veloci-plugins
/plugin install veloci@arcticrex
选择用户范围。出现提示时登录 Veloci。如果安装摘要要求重新加载插件,请重新加载;然后开始新会话,并按照宿主支持的方式调用一次插件的 init 技能。不能保证字面命令 /init 可用,而且它不能替代宿主内置的初始化功能。
Codex 和本地 ChatGPT Work
在本地终端中注册市场:
codex plugin marketplace add ArcticRexOrg/veloci-plugins
重启桌面应用。在 Plugins Directory 中,选择 ArcticRex,安装 Veloci by ArcticRex,并连接你的账户。根据提示检查并信任当前的钩子定义(在 Codex CLI 中使用 /hooks)。开始一个新的本地任务,并询问 “运行 Veloci init,检查自动任务跟踪。” 网页安装不会将脚本部署到单独的托管环境中。
了解何时生效
初始化是一次性检查,不需要在每次会话前重复运行。设置完成后,在新的会话中直接开始常规工作,无需提及跟踪。你的 Agent 应启动匹配的任务,并公布一次其标题和 ID;后续继续处理时保留该 ID,并在跟踪的工作实际完成后将任务标记为完成。未完成的工作应保持进行中。你可以按需查看进度;自动跟踪不需要反复更新或回读。
检查会分别报告连接、安装、信任状态和观察到的指令传递情况。如果无法确认指令已加载,检查会如实报告。仅完成安装并不代表已验证。远程控制同一台计算机时,使用该计算机的设置;单独的 Agent 或执行环境则需要单独设置。
插件的功能
此插件使用你自己的账户连接到 https://veloci.arcticrex.com/mcp/veloci。它的启动脚本只会打印 Veloci 任务指令,不会发起网络请求,也不会修改任何文件。Agent 会在你授予的权限范围内使用 Veloci 工具。不需要 arcrex 二进制文件,也不需要修改 AGENTS.md/CLAUDE.md。
仅用于移除内容的 scripts/remove-legacy-hooks.py 辅助脚本需要显式指定 --remove;scripts/check.py --migrate 流程会调用它。此插件不包含独立安装程序。启用并信任插件后,只有在你明确请求迁移时,可选迁移才会移除能够识别的旧独立任务钩子。无关钩子会保留。不要同时启用独立任务钩子和插件任务钩子。验证替代连接后,使用宿主的连接界面移除过时的重复 MCP 连接。
更新或移除
使用宿主的插件管理器更新或卸载 Veloci。更新后的钩子定义可能需要重新获得信任。在 Codex 桌面应用中安装或更新后,退出并重新打开应用,然后启动一个新任务。在 Codex CLI 中,启动新会话以验证更新。卸载不会恢复迁移期间移除的独立钩子,也不会删除你的 Veloci 任务。如果你添加了上方的 Cowork 全局指令,请移除该段文字以关闭提醒。
请通过此仓库的 issues 报告安装问题。请注明宿主和版本,以及失败的设置步骤;不要发布令牌、私人任务或账户数据。
发布打包
GitHub Actions 会在每次推送和拉取请求时验证并构建 ZIP。要测试尚未发布的构建,请从工作流运行记录中下载
veloci-release。ZIP 文件不会提交到此仓库。
要发布,请在经过审查的提交中更新两个插件清单的版本,合并后再推送对应的标签(例如 v0.2.2)。同一工作流会验证标签与两个清单是否匹配,只打包已提交的 plugins/veloci/ 文件,并将 veloci-0.2.2.zip 和 veloci-0.2.2.zip.sha256 附加到 GitHub Release。
隐藏清单位于 ZIP 根目录,且会保留可执行权限。
验证失败或版本不匹配都会阻止发布。已有发布不会被覆盖;如需发布更改,请使用新版本。
通过 Marketplace 安装时仍会直接使用此仓库。ZIP 用于手动上传和下载插件。无需单独的发布密钥;发布任务使用仓库的 GitHub Actions 令牌。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。