Repository navigation
Releases: PinelliaChill/Operant
Release list
Operant v0.1.0-beta.5
本版修复项目同步、草稿恢复与使用状态提示。产品源码固定于 d2817b4。
- 创建、改名、归档和解除知识关联后同步项目状态；文件、对话及协作页使用同步后的当前工作区。
- 草稿按项目、对话和服务来源保存，刷新或重开恢复；发送期间继续编辑的内容保留，未知结果先核对原请求。
- 浏览器遇到桌面专属管理权限时明确说明入口；读取失败不再误报为空或未配置，默认模型和就绪步骤可核对。
- 项目路径错误给出中文修正提示并保留输入；CLI简化已知记录不存在错误。
- 设置显示实际版本、发行标签与源码提交；修复macOS临时目录别名导致构建信息不可读的问题。
U1–U5均通过独立仿真与实际客户端验收，包含两个项目/两个对话草稿、刷新/退出重开、gpt-6-luna正式受控发送、真实Web403、宽窄屏和键盘。GUI267项及类型/构建通过，Rust32项通过、1条既有忽略；最终CI中Python3.10/3.12各1750项通过、16条条件跳过、1条既有警告，GUI和CodeQL均通过。PR #50已合入主线；最终CI可核对。
DMG适用于Apple Silicon macOS，内置Python和Core。正常产品身份、签名、来源摘要、4610个文件摘要及实际关于页已核对；候选包完成DMG挂载、空格路径、/tmp别名、正式管理写入、退出回收和重开持久性。此次发布不自动替换已有安装或迁移真实用户库。
组件版本仍为0.1.0，发行标识为0.1.0-beta.5。应用采用ad-hoc签名，尚无Apple Developer ID签名、公证或自动更新。
下载后请用同名.sha256核对DMG。来源摘要记录精确源码和构建输入。
Operant v0.1.0-beta.4 · 开箱即用与 Codex 接入
开箱即用与 Codex 接入
- 连接模型后直接开始对话，自动准备个人工作区和通用助手；高级参数默认收起。
- 对话支持命名与改名，修复新建对话误弹“已找到先前创建的对话”。
- 新增 ChatGPT（Codex）订阅连接，原 ChatGPT 授权保留在高级设置；支持 Gemini API 与 OAuth。
- 自动发现常见技能目录，兼容标准技能格式；整理导航、设置、选择菜单和团队模板入口。
- 当前源码构建的自包含 macOS arm64 DMG，内置 Core、Python 与运行依赖；修复登录辅助进程写入签名包的问题。
下载
Apple Silicon Mac 使用 Operant-v0.1.0-beta.4-macos-arm64.dmg，打开后将 Operant 拖入 Applications。
同名 .sha256 用于校验，Operant-v0.1.0-beta.4-build.json 记录构建来源及完整文件摘要。
ChatGPT（Codex）连接需要另装官方 Codex CLI；API 连接不需要该 CLI。可用模型、额度与费用由所选服务决定。
验证与限制
产品冻结 CI：Python 3.10/3.12 各1740项通过、16项条件跳过，TUI各39项、GUI243项及类型/构建、静态检查与CodeQL通过。
本次正式包已通过DMG挂载/复制、4610项文件清单、arm64及严格签名检查；内置Core在临时库和随机端口完成启动、私有鉴权、正式接口和退出回收验证，事后签名与清单保持一致。既有真实模型和原生界面证据按相同产品源码与依赖复用，没有重复账号授权或调用模型。
仍为Beta：ad-hoc签名、未经过Apple公证，没有自动更新；完整退出会丢失未发送草稿，端口冲突提示及部分TUI原生视觉验收仍有缺口。包内产品版本沿用0.1.0，以本发行标签和来源摘要区分版本。升级前退出旧App并备份完整运行目录，本次发行不会自动安装或迁移你的数据。
发行标签基于main提交 92a8ab4c4ca2a910fd86a88b637644d398f7ceee，构建提交 aa2843522181b62371ab1ba8a06c6ad96dd1a55f 与其源码树完全一致；源码和打包脚本均随标签提供。
Operant v0.1.0-beta.3 · 界面精简与本机路径选择
Operant v0.1.0-beta.3
本版修复界面说明过多、用词不直观和本机路径只能手动输入的问题。
- 左侧导航以图标呈现，名称通过悬停和读屏保留；删除多余的技术说明。
- 新建项目及其他本机路径字段增加“浏览…”，支持系统文件与文件夹选择。
- 常用页面统一使用项目、会话、团队、流程等用词，内部信息按需展开。
- 切换会话时清空旧文件路径，旧的异步引用结果不会覆盖新会话。
macOS arm64 安装包内置 Python 和 Core。将 Operant.app 拖到 Applications 后启动；沿用已有 Operant Beta 2 数据目录，本次不进行数据库迁移。API 配置仍由用户提供。
产品源码固定于 main@939e3cc（包含 PR #43）；与已通过全套 CI 的修复提交相比仅 README 改动。打包脚本来自 PR #41 的 d88931a，并在构建上下文适配 beta.3；包内来源摘要记录实际源码、脚本和输入校验值。
本包仍为 Beta，仅 ad-hoc 签名，未获 Apple Developer ID 签名或公证。桌面本机浏览不代表网页或远端目录浏览能力。
下载 Assets 中的 Operant-v0.1.0-beta.3-macos-arm64.dmg，用同名 .sha256 校验。旧版 beta.2 保留，不覆盖旧附件。
验证：149项GUI测试、类型与构建，Rust测试/正式release构建通过；修复CI与CodeQL通过。已从DMG实际安装到macOS，验证内置Core、协议和CORS、系统文件夹选择与取消、创建测试项目、退出回收和重开。既有v23数据经备份后沿用，表记录数量保持不变。
DMG大小：70,782,424 bytes；SHA-256：a8c5db6b3809ac8e954580d619d08d2dd79bdbf034de842b468e8ef26c7f7f8d。
本版未重新进行真实模型验收；模型与Core代码及依赖未变，复用原有有效证据。Windows/Linux原生界面、远端目录浏览、签名公证和自动更新不在本次交付范围。打包适配源码另附，软件及源码沿用仓库的许可与第三方许可。
Operant v0.1.0-beta.2 · 协作工作台与 macOS Beta
Operant v0.1.0-beta.2
这是 Operant 的第二个 Beta 预发布，适合愿意自行配置模型并反馈问题的开发者。
相比 beta.1，本版把多 Agent 协作、可视化编排、审批、经验复用和扩展能力接进日常工作流程。
本次提供源码、Python Core/TUI 包及 macOS arm64 App，不发布到 PyPI。
2026-10-06 补充自包含 DMG，内置 Python、Core 和基础依赖；原 ZIP 保留，仍需按包内说明单独配置 Core。两种桌面包均无 Developer ID 签名、公证或自动更新。9 月 28 日的旧桌面候选不能与本版 Core 混用。
本版采用 PolyForm Noncommercial 1.0.0：超出许可证允许用途的商业使用，须先协商并取得书面授权。这是源码可见许可；已经按 Apache-2.0 公开的历史代码保留原授权，不受追溯限制。详见 商业授权说明。
下载与安装包
在 本版 GitHub Release 的 Assets 中选择：
| 文件 | 用途 |
|---|---|
Operant-v0.1.0-beta.2-macos-arm64.dmg |
推荐给 Apple Silicon Mac 用户：拖拽安装，App 内置 Python、Core 和基础依赖 |
Operant-v0.1.0-beta.2-macos-arm64.zip |
Apple Silicon Mac 的 App、Core/TUI wheel、安装说明、许可证与校验清单 |
Operant-v0.1.0-beta.2-python.zip |
macOS/Ubuntu 的 Core wheel/sdist、TUI wheel、安装说明、许可证与校验清单 |
SHA256SUMS / DMG 对应的 .sha256 |
下载后校验文件完整性 |
| GitHub 的 Source code | 完整标签源码，适合开发与自行构建 |
DMG 用户：打开磁盘映像，将 Operant.app 拖入“应用程序”，再启动 App；无需安装 Python 或 uv。包内有中文安装说明。首次启动使用新目录 ~/Library/Application Support/Operant Beta 2/，不会自动迁移旧版数据库。请先退出占用 8000 端口的旧版 Operant。模型调用需要你自己的 API 配置和网络，本 DMG 同时带有 DOCX/PPTX/PDF 所需的文档依赖；浏览器、外部工具和各项 Skill 仍需按功能说明安装或启用。
如 macOS 阻止打开，请核对下载来源，参照 Apple 官方说明在“系统设置 → 隐私与安全”允许此 App。
ZIP 用户：解压后先阅读 INSTALL.md，使用独立环境安装，首次需要联网获取依赖。旧 ZIP 不会因新增 DMG 而改变。
产品包内版本元数据仍为 0.1.0，本次分发身份以 v0.1.0-beta.2、源码提交、打包清单和 SHA-256 为准。DMG 的启动器与打包脚本另有来源记录；源码标签保持不变。
主要变化
- 从对话到协作：在会话中委派子 Agent、发送定向消息并查看父子历史。子 Agent 按任务包工作，权限和预算受父任务约束，减少无关上下文传递。
- 工作流可以看见、编辑和运行：画布支持节点、连线、版本差异与运行状态；14 类节点覆盖模型、工具、脚本、条件、循环、人工输入、审批、等待、子流程和工件等场景。对话生成的草稿需要确认后再发布。
- 审批严格度可选：可以指定独立裁判模型，选择谨慎、平衡或宽松。超出范围的请求回到人工，硬性拒绝不能被模型覆盖，异常或超时不会自动放行。默认仍为人工审批。
- 经验可以积累，也可以纠正：按任务召回有来源和版本的记忆，审阅候选、处理冲突与撤销；经验可以发布为 Skill，并显式共享给其他项目。后台整理默认关闭，不保证所有任务都节省 Token。
- 工作台更完整：加入文件正文与 Diff、终端、配置继承、Goal/Plan/清单、旁路提问、上下文压缩，以及临时资源盘点和安全清理。
- 扩展与本机操作：提供工具、命令、事件、Provider、Runtime、能力驱动六类本地扩展。GUI/TUI 可显式调用已授权命令与 Skill；macOS 可在授权范围内操作浏览器和指定 App，支持截图、剪贴板与人工接管。
- 私有跨设备任务：macOS 与 Ubuntu 间支持设备配对、权限范围、加密命令与结果、断线追平、撤销，以及白名单约束的远端执行。未知写入结果不自动重放。
- 安装与日常修复：六项默认 Skill 随 Core 分发；DOCX/PPTX/PDF 依赖可单独安装。补齐完整备份、隔离升级与回退，修复长任务记忆召回和退出 App 后自启 Core 残留。
从源码安装
准备 Git 和 uv，Python 要求 3.10+，开发版本由仓库 .python-version 指定。首次安装需要网络。
git clone --branch v0.1.0-beta.2 --depth 1 https://github.com/PinelliaChill/Operant.git
cd Operant
uv sync --frozen --extra dev
cp .env.example .env
uv run operant init用编辑器在 .env 中填写模型服务地址和自己的 API Key，再查询可用模型：
uv run operant model discover
uv run operant serve --host 127.0.0.1 --port 8000基础工作台位于 http://127.0.0.1:8000/web。按 README 创建模型配置、角色和第一个只读任务。
需要完整 React 工作台时，另外准备 Node.js 22.6+ 和 npm，在第二个终端执行：
npm ci --prefix clients/gui
npm run dev --prefix clients/gui -- --host 127.0.0.1访问 http://127.0.0.1:3000 并切换到 Live。默认演示模式的数据不是真实任务。
文档类 Skill 的可选依赖用 uv sync --frozen --extra dev --extra artifacts 安装；六项 Skill 还需在产品中显式安装、启用。
TUI 和桌面构建见 TUI 说明、同源候选安装指南。
升级与回退
本版 SQLite Schema 为 v23。新用户优先使用新目录；已有用户先停止旧 Core/App，备份整个运行目录，在副本上升级。
备份不只包含数据库，还需包含记忆插件注册信息、包与外部工件。旧 Core 不可直接打开升级后的库。
v20/v22 到 v23 的隔离升级与从升级前完整快照回退已有验收；这不代表所有历史库都能无条件升级。
具体命令见 升级与回退指南。升级后应核对记录和插件状态，需要时显式重新启用插件。
发行操作不会更新本机已安装 App，也不会替用户迁移数据。
验证依据与支持范围
产品源码基线为已合并的 PR #39，主线提交 567c761ec859dea44f0c46a9275751cd77d975c3；本次调整说明、许可元数据和许可文件分发，不改产品运行源码或依赖版本。Core/TUI 因许可与包内说明变化重新打包，桌面二进制在核对构建输入后复用已验收候选；新发行包的检查与源码身份记录在包内。
- 冻结提交的 CI：Python 3.10/3.12 各 1329 项通过、16 项条件跳过；TUI 各 34 项、GUI 145 项及类型和构建通过，Ruff、mypy、锁检查通过。跳过项不算验收。
- CodeQL 通过。扫描作业成功不代表仓库没有安全告警，也不覆盖所有 Rust 桌面代码。
- 真实模型使用发现后的
gpt-6-luna，覆盖父子协作、定向消息、记忆纠正、Graph、审批与默认 Skill；模型名称是验收记录，不是固定的产品模型要求。 - 验收环境为 macOS arm64 的 Core/TUI/原生 Tauri 壳，以及 Ubuntu 24.04 的 Core/TUI 和私有跨设备链路。安装、升级、回退和六轮能力的详细范围见 Beta 最终验收。该记录中的“待 CI”保留为审查时历史状态；最终冻结 CI 以以上链接为准。
2026-10-06 DMG 安装补充
DMG 沿用 beta.2 的 Core wheel 和 Tauri 产品二进制，新增原生启动器，内置官方 CPython 3.13.14 与锁定的运行及文档依赖。Python 官方下载摘要、产品输入摘要、启动器源码摘要和整个 App 的文件摘要随包记录。原 ZIP 与源码标签不变。构建源码为 49e020d，见 DMG 打包 PR #41。该提交的 CI 和 CodeQL 已通过。
已知限制
- 仍为 Beta；桌面包未签名公证，没有自动更新或公网部署验收。Windows 与任意 Linux 桌面环境不在本轮支持承诺内。
- Docker 条件跳过不算容器验收；Linux 第三方扩展隔离器和任意网站/App 操作不在本轮已验收范围。Host 模式使用当前系统用户权限，只用于可信工作区。
- 私有跨设备验收不等于可以直接把 Core 管理 API 暴露公网，也不等于通用远程桌面。
- 模型收到的提示词、代码和工具结果会传给相应模型服务。运行目录可能包含私有内容，反馈问题前请脱敏。
- 本次未升级依赖或集中修复存量安全告警；依赖更新继续通过独立 PR 验证。历史性能负结果与失败样本仍保留，不承诺统一的速度、Token 节省或成功率提升。
问题请提交仓库 Issue；安全漏洞通过 Security 页面私密报告。许可和商业授权范围见 LICENSE 与 COMMERCIAL.md。
原 ZIP 发行检查
PR #40 的 CI 与 CodeQL 全部通过。新 Core wheel、sdist 和 TUI wheel 已独立安装；新库 v23 与健康接口通过。macOS 发行副本完成 ad-hoc 资源签名校验及真实窗口连接、退出回收检查，仍未获 Developer ID 签名或公证。
两个 ZIP 含安装说明、源码与文件摘要、商业及历史许可；macOS 包另附第三方许可。下载后用附件 SHA256SUMS 核对。GitHub 回读的附件摘要与本地一致。
DMG 安装包检查
已从实际 DMG 复制安装，验证原生界面连接内置 Core、端口冲突提示、正常退出、立即重开与关闭窗口回收。内置 Python 在无开发环境 PATH 下通过协议、数据库、依赖导入及 HTTPS 检查；运行后文件摘要与签名保持完整。旧 App 与旧数据不被替换或迁移。
DMG 为 70,627,639 bytes，SHA-256：80a99f5e8593ddec18a1afcc9259ec4c27dc42aa7b9c6c817cbc6d456dbde022。下载后可用同名 .dmg.sha256 校验。此包只有 ad-hoc 签名，尚未 Apple 公证；正常退出可回收 Core，强制杀死桌面进程不在这一保证内。
DMG 布局简化
安装窗口仅保留 Operant 与 Applications，把 Operant 拖入 Applications 即可安装。许可、中文安装说明和来源记录收在 App 的 Contents/Resources/ 内，可右键“显示包内容”查看。此更新只整理安装包内容，产品功能和运行源码未变；已重新验证磁盘映像、签名和 Finder 展示。此前下载的旧 DMG 不会自动更新，请重新下载。
Operant macOS arm64 桌面候选 · 08e65ea
从已合并的 main@08e65ea4551fd84352c56f3ef1edbbffc24022bf 构建的 macOS arm64 桌面候选包。ZIP 包含 Operant.app、匹配的 Python Core wheel 和中文安装说明。
- 这是桌面候选构建，不代表整个版本的所有目标能力都已完成或正式发布。
- App 需要单独安装并启动同包 Core。候选数据库与现有用户数据分开；不会自动迁移数据。
- App 仅做临时签名，尚无 Apple Developer ID 签名、公证、DMG 或自动更新。下载后的 macOS 安全提示请按包内说明处理。
- 桌面候选构建：GitHub Actions 运行中的
client-candidates已通过；同一提交在 PR #33 的 Python 和 GUI 门禁已通过。本机已验证同源桌面窗口与 Core 连接；本下载包尚未做跨机器安装验收。
请下载下面的 ZIP，并核对 SHA256SUMS.txt。完整安装步骤在压缩包中的 INSTALL.md。
Operant v0.1.0-beta.1 · Beta 源码版
Operant v0.1.0-beta.1
这是 Operant 的首个 GitHub Beta 源码预发布，适合愿意从源码安装、体验与反馈问题的开发者。
本次发布固定到明确 Git 提交，不提供已签名桌面安装包，也不发布到 PyPI。
这个版本可以做什么
- 配置模型与角色，让规划、只读探索、编码、审查和汇总角色分工运行。
- 通过本地 Core 统一管理会话、工作流、工具权限、审批、历史和文件产物。
- 使用 React 网页、基础 Web 工作台、可选 TUI 或 Tauri 壳连接本机服务；实时连接出错时明确提示。
- 使用带来源、作用域和版本记录的记忆。插件需要显式安装和启用。B2-1～B2-3 提供记忆插件协议、隔离宿主、两个示例插件，以及安装、开关、保留/删除和基础管理流程。
- 通过 MCP 工具、受控 Skill 发现和生成客户端扩展能力。
本批同时补齐了开源维护基础：轻量 main 保护、密钥推送拦截、依赖漏洞提醒、CodeQL 默认扫描（Python、JavaScript/TypeScript、Actions）、按范围运行的 Python/GUI CI，以及中文反馈模板和社区准则。
从源码安装
git clone --branch v0.1.0-beta.1 --depth 1 https://github.com/PinelliaChill/Operant.git
cd Operant
uv sync --frozen --extra dev
cp .env.example .env
uv run operant init需要 Git 和 uv。用编辑器在 .env 中配置自己的模型地址与 API Key，然后按 README 的「快速开始」创建模型、只读角色和会话。
uv run operant model discover
uv run operant serve --host 127.0.0.1 --port 8000访问 本机工作台。React 界面另需 Node.js 22.6+，安装与启动方式见 README。
默认编码角色执行命令需要 Docker 和合适镜像；只读体验不需要 Docker。
验证与边界
- 本次 PR16 修复仅去掉测试对开发机临时路径的依赖；产品代码沿用已交付 B2-1～B2-3，并在当前 Python 3.10/3.12 与 GUI 检查中复核。
- 历史真实模型/原生证据的范围见仓库交付记录。本次维护没有重跑真实模型或桌面壳，不将自动测试等同于完整真实场景验收。
- B2-4 及后续工作不在本次标签中。GUI 拖拽编排和默认裁判模型等目标能力不全部等于当前可用功能。
- 新用户建议使用新数据库体验。已有用户升级前先备份；SQLite 升级可能不支持直接降级，不要让旧版本接管新库。
- 默认只监听本机；远程能力没有公网部署验收。运行数据中可能含私有代码，发送给在线模型的内容会交给对应服务商。
- 桌面产物尚未签名、公证，未提供自动更新。当前 GitHub 默认配置 API 未接受 Rust 语言，因此本次 CodeQL 不覆盖 Rust 壳。本次 Release 的附件仅为 GitHub 提供的源码归档。
- 安全扫描已经启用，但告警尚未全部核查关闭：依赖告警涉及 cryptography 和 glib，CodeQL 对部分路径处理和界面数据保存提出了待复核提示。没有把这些结果标记为误报或声称已全部修复，后续修复应经兼容性测试后发布。
问题反馈请使用仓库 Issue 模板；安全漏洞请通过 Security 页面私密提交。项目采用 Apache-2.0 许可证。