Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

19.0 KB
Raw Blame

Agent 与用户同权:工具能力不以「Agent 不该做」为由少给

2026-10-14 裁决。用户本人能对自己的任务、定时任务、项目、伙伴做的操作,Agent 也要有对应工具, 包括操作用户另一台电脑上的数据。

规则

  • 能力全面放开:用户在桌面、手机或远程控制里能做的,Agent 工具也能做。不再因为 「这件事不该让 Agent 做」而不提供工具,或只提供本机版本。
  • 限制放在别的维度:能不能执行由任务的权限档决定——bypass 完全不限制;自动审核(Auto) 主要依赖 AI 审阅。不在工具层另加一道「Agent 专用」的收窄。
  • 不在放开范围内:群成员、共享任务访客等「不是用户本人」的身份,沿用各自规则里的既有边界 (见 shared-task-mode.md、bot-group-chat.md、 cindy-bots-runtime.md)。插件托管任务的受限能力面同样不变。
  • 第一时间能发现:Agent 在工具索引的第一步(类目总览)就要看到每类工具的用途和作用范围 (本机 / 可跨电脑)。工具说明写清作用范围,不用「所有」「全部」这类看不出边界的说法。 只查了本机时,结果要自带「仅本机」,不能让 Agent 把「本机没有」读成「哪台电脑都没有」。

跨电脑的统一口径

  • 数据保存在各自的电脑上。跨电脑一律走用户远程控制的同一条通道与授权:同一账号、对方在线、 双方都开启了远程控制;被撤销授权的设备不可用。
  • 默认仍是本机,跨电脑要显式指定(device 参数,或 deviceId:: 前缀的 id)。
  • 跨电脑的写操作(改动另一台电脑上的定时任务、给另一台电脑上的任务发消息)交给当前任务的 权限档:Full Access 不拦,Auto 走统一审阅,Ask 由用户确认。它们不走第一方工具的静默放行—— 改定时任务能改写并触发那台电脑上的命令,不能让本机一次被注入的调用悄悄越到别的电脑。 本机操作与跨电脑读取保持原样。
  • 查多台电脑时结果按电脑分组;离线、未开启、版本不支持、超时的电脑逐台写明原因, 有电脑没查到时标 partial,不得据此断言「不存在」。
  • 对方电脑版本较旧、不支持某项操作时明确说不支持,不静默失败,也不退回成别的行为。
  • 写操作没有收到回执时如实说明「可能已生效」,由 Agent 先查再决定是否重试;工具不自动重发。
  • 跨电脑请求会像用户打开远程控制一样与目标电脑建立连接。
  • Agent 发到另一台电脑任务里的消息,按 message-source.md 标明来自哪个任务, 界面标签与发给模型的说明一致。

现状台账

「跨电脑」一列写 Agent 工具的现状,不是用户界面的现状。改动对应能力时把这张表写回去。

对象 操作 本机 跨电脑
任务 列出、搜索、读聊天记录、发现电脑 有 有
任务 获取可直接引用的任务链接(列表、搜索、聊天记录与摘要返回 sessionUrl) 有 有(链接携带所属电脑;旧远端查询结果由调用端补齐)
任务 读摘要(状态、最后的要求与回答、模型路线、PR、排队数) 有 有(2026-10-17)
任务 给既有任务发消息 有 有(2026-10-14)
任务 新建任务 有 无
任务 归档 / 取消归档 有 有(2026-10-16)
任务 改名、移动、标签 有 无
任务 看输入队列;编辑 / 撤回 / 调序自己发的排队消息;插话;停止 有 无
任务 模型、推理强度、Fast 有 无
任务 删除、Fork、Rewind、切换权限档、代用户确认权限或回答提问 无 无
协同 / Worker 单个 / 批量创建、指定已有目录、查询实际目录与自有 worktree 有 有(运行设备;新建 worktree 仅本机)
协同 / Worker Lead 使用远程供应商时派发跨设备 Worker;独立选择工作电脑与模型电脑 有 有(execution_device_id + agent_device_id;目录查询支持同一工作电脑范围)
协同 / Worker 为 Worker 新建 worktree、指定源分支、归档时回收 有 无
定时任务 列出、详情、运行记录、修改、暂停、恢复、删除、立即运行 有 有(2026-10-14)
定时任务 选择远程/分享供应商模型(运行位置、引擎、模型与速度)及清除覆盖恢复跟随;绑定任务或持续模式切回本机须保留完整引擎/模型选择 有 有(设置或清除模型选择均核验目标电脑的 supportsScheduleAgentDeviceSelection)
定时任务 新建、安装检查脚本 有(绑定远程 Agent 时由本机辅助模型生成脚本) 无
定时任务 查可选运行位置与模型;设每次新建任务的 Agent 运行位置(其他电脑 / 分享来的供应商) 有(2026-10-22) 无
定时任务 删除单条运行记录、标记已读 无 无
项目 列出、登记、改名、移除;工作目录列表 有 无
伙伴 发现伙伴、伙伴间消息 有 有
伙伴 自身关联项目:列出、添加与移除(原有文件工具按需读资料) 有 无(远程设置界面可管理)
伙伴 资料、能力、待办、后台任务 有(已准入的后台任务补充排队后可跨发起轮投递,仍复核撤权;见 伙伴代表谁) 无
伙伴 显式重新接受已保存模型,恢复旧版遗留的自动模型记录 有(update_teammate_profile 显式提交完整 modelChain,即使值未变) 无(远程设置 IPC 可按版本接受,不等于跨电脑 Agent 工具)
伙伴 发现与选择 Codex Apps 连接器(继承默认保留,显式 MCP 白名单可收窄) 有(能力工具) 无(SSH Codex 不提供)
伙伴 按已证实归属搜索跨渠道聊天、按最近活动列出旧任务 有 有(历史查询,两端需支持筛选参数)
伙伴 查看自己的本机 IM 连接分配与状态 有 无
伙伴 「一眼」投影(等你 / 在做;用户界面已改为近况,2026-10-21) 有 无
伙伴 跟进任务:读取与继续(自动跟进所有任务的伙伴) 有 有(2026-10-17)
伙伴 查看与更换主力电脑 有 有(2026-10-17)
伙伴 夜间学习:暂停 / 恢复、立即运行(沿用伙伴自己的例行任务工具) 有 无
伙伴 夜间学习:改频率、撤销 / 恢复整理改动、处理在观察的做法 无 无
社区插件贡献 当前安装快照准备、提交审核/当前进度、本人列表/详情/留存内容 有(2026-10-15) 无
SSH 主机 列出、查状态、执行命令、添加主机、重新读取 ~/.ssh/config(与设置页同一实现;只用 ssh-agent/私钥,密码登录先用 ssh-copy-id 经终端代输入装公钥) 有(添加与重读 2026-10-29) 无
SSH 主机 编辑、删除、安装远端 Agent、Agent Proxy 无 无

Worker 工具省略 working_dir 时保持继承 Lead 任务记录目录,不跟随之后 cd 进入的 worktree。 面板默认识别实际目录属于 UI 行为;Agent 通过显式 working_dir 共用已有 worktree, 通过 new_worktree 新建独立检出,二者按会话权限审批,并以返回的 working_dir 核对结果。

表里「无」的项是待补的缺口,不是有意的限制。其中「切换权限档」「代用户确认权限或回答提问」 会让 Agent 改变约束自己的那一层,补之前需要单独的产品决定。

实现入口

  • 工具索引与作用范围:packages/lizi-mcps/src/lizi_xdtHelperMcpServer.ts (HELPER_CATEGORY_DESCRIPTIONS)、cindy_schedulerMcpServer.ts (SCHEDULER_CATEGORY_DESCRIPTIONS)、xdt-helper/capabilities.ts 的 self-management。
  • 定时任务的 Agent 运行位置:packages/lizi-mcps/src/scheduler/listModels.ts(与协同 Worker 的 list_available_models 共用 host 实现;模型项的 id 对应 model,providers[].id 对应 providerId)、create.ts / update.ts 的 agentDeviceId;执行见 apps/desktop/src/main/scheduler-host/runner.ts(按那台电脑的已授权目录解析,不回落本机同名来源)。
  • 跨电脑定时任务:packages/lizi-mcps/src/scheduler/_devices.ts、 apps/desktop/src/main/mcp-integrations/schedulerDevices.ts。
  • 跨电脑发消息:apps/desktop/src/main/mcp-integrations/sessionHandoffRemote.ts、 apps/desktop/src/main/maker-ipc/sessionHandoffIpc.ts。
  • 任务摘要(get_task_digest):packages/lizi-mcps/src/xdt-helper/get_task_digest.ts(输出合同 ≤2KB)、 apps/desktop/src/main/mcp-integrations/taskDigest.ts 与 taskDigestHost.ts(跨电脑只读,复用 local-db:sessions:get、maker:list-active、历史消息与 PR 状态通道)。 本机与跨电脑均排除带隐藏触发标记的协调/续跑输入,保留最新助手回复全文供工具按预算截短; 长回复保留首尾片段,总预算进一步收紧时仍保留首尾,避免丢掉末尾结果或阻塞说明。 不用内部回报替代用户要求,也不只取助手回复最后一行。finished 只表示所查任务本轮结束, 不证明委派工作或用户目标完成;不参与输入放行判定,下一条消息仍按实时运行状态和队列派发。
  • 伙伴跟进任务:apps/desktop/src/main/maker-ipc/botWorkbenchAccess.ts(授权:自动跟进所有任务的伙伴 可读取既有范围内的任务,含在线电脑;继续或接手还需行动授权,其它伙伴只读自己开的或已接手的任务)。
  • 协议与兼容见 ../dev-rules/protocol-compatibility.md 「Agent 跨电脑管理定时任务与发消息」。

伙伴或普通任务代主人下达要求时,由宿主附上当前输入中可核实的用户原话,工具参数承载必要的轻度补充; 自主消息、自动化与回传保持正常正文,无原话不加空栏。伙伴通话和继续转交已核实请求 保留同一来源;接收任务沿用原请求范围和当前权限档,不增加交接确认。来源回执不是新的执行权限档。 详见 消息来源。

模型速度

模型能力中的 supportsUltrafastMode 来自当前账号的 Codex 目录。桌面和手机的模型配置,以及 set_session_runtime / 新建任务 / Worker 工具,均使用同一速度值:false 为标准、true 为快速、 "ultrafast" 为超快。原有布尔值保持兼容;不得把超快归一成 true。

自主跟进行动授权(2026-10-19)

任务读取与提醒保持原发现入口及可见范围。cindy_helper 的工作台、通用任务控制与 Session 委托写操作,以及 cindy_orca 的协作写操作,共用 Host 行动授权入口; 直接调用、渐进式调用与 CC / Codex / Pi 路由相同。工具描述明确角色不授予行动权限。 2026-10-20 修订:主人私聊输入及经 Chat Server 实时核验的群内主人请求,沿用普通任务原有权限流程, 不再额外弹行动确认卡;helper 与 Orca、直接与渐进调用保持一致。群专线必须通过 authorizeGroupTool(sessionId, botId, 'owner-action'),仅有 role 或持久来源不算主人输入; 访客身份核验暂不可用不得放行。2026-10-21 修订:普通任务中,用户已委托的定时工作沿用 当前任务的权限审核,不能在正常审核前一律拒绝。缺少可复用的实时权限决定时,Host 从活跃 Session 识别定时轮次,并对准确工具、目标和正文调用 Session.reviewHostPermissionAction:Full Access 放行,Auto 使用原任务已恢复的用户意图, 审核同时携带宿主确认的「定时触发已经发生」上下文,区分先前的设置阶段与当前续跑, 该事实不构成新授权。排队时应用模型设置不得改写绑定任务的权限档。 Ask 或审核要求确认时复用现有确认入口;Plan 不允许副作用。来源标签本身不提供授权。 审核到执行及延迟投递均保留账号、实例、权限/Plan 代次与输入边界校验, 不得借定时工作扩大原授权范围。 2026-10-29 修订:伙伴的来源记录与访问权限、操作风险分开。移除自主工具白名单与 例行任务的静默 NEEDS_OWNER_REQUEST;普通操作沿用任务权限,仅对自主删除自动化、 代答授权、恢复暂停、本机调度命令、授予常驻指令等明确风险显示可操作的一次性授权请求与等待状态。 确认、拒绝与取消共用桌面/手机原交互通道。见 伙伴操作权限。 2026-10-22 修订:伙伴、转入消息与定时跟进的任务操作 统一沿用普通任务权限流程:Full Access 免审、Auto 使用原有自动审核、Ask 使用原有确认。 helper 任务写工具与 Orca 协作写工具均逐次进入该流程,不能借可信 server 静默跳过;Orca 只读查询保持免审。 Host 不因当前输入缺少主人标记再追加行动同意判定。只认运行中任务的实时权限, 不读数据库旧值;从 Host 接收调用并捕获快照起,权限切换、计划模式或实例变化使该调用 尚未执行及排队中的放行失效。该快照不是 Agent 审批回执:审批完成到进入 Host 之前的交接窗口 沿用普通任务既有语义,本次不增加跨 harness 审批凭证,也不承诺该窗口的原子撤销。 群成员、共享访客、插件托管工具范围及账号归属检查保持原边界。 没有可核验的实时执行权限时,仍按原有主人输入或委托范围校验,不凭角色放行。 本人通过本机或同账号远控发送带引用的消息时,引用外亲自输入的正文仍是当前请求。 宿主按持久化正文校验引用位置并剔除引用内容,不因附带消息/任务引用就清空整条 autoReviewUserText;引用与自动事件本身不获得本人身份或执行授权。 实现与回归见 maker-ipc/autoReviewUserIntent.ts、makerSendTransaction.test.ts 和 agent-input-coordinator.test.ts。 已有委托的执行权不依赖自动观察规则的开关;仅凭普通 Orca Lead 的当前 team 回报只延续原 team 范围。 跨电脑任务互发要求双方支持 行动回执,旧端明确提示不支持;未增加观察数据权限。实机多端验收仍待完成。

2026-10-24 修订:每个独立 MCP 请求隔离启动共享传输时遗留的行动上下文, 再按绑定的当前调用方执行原有权限判定;进程内调用沿同一隔离边界。 普通任务获准后不继承旧调用的行动证据,也不因此强制排队。 当前调用的委托、权限撤销和延迟交付检查继续保留;不恢复过期授权,不自动重发。 实现见 maker-ipc/taskActionAuthorization.ts、taskActionHost.ts 与 mcp-integrations/codexHttpBridge.ts;回归见各自授权及 HTTP 桥接测试。

伙伴例行任务(2026-10-26):桌面与 routine_save 共用每条规则的 modelOverride,可选引擎、来源、型号、执行位置、推理强度与 Fast;null 恢复跟随伙伴,省略保留选择。执行记录返回独立 sessionId。内置跟进/每天查待办也可选模型,指令与触发条件仍由宿主维护。sessionMode(persistent 复用同一任务/fresh 每次触发新建任务)同样经桌面与 routine_save 设置,省略保留原值。跨电脑桌面设置通过 routines.saveWithModel 与 routines.saveWithSessionMode 能力声明协商;手机仍按现有合同不提供例行任务管理。

执行任务的模型可用 cindy_helper 的 cindy 类 report_task_delivery 报告本轮是否新交付最终结果;只限当前任务执行者,子 Agent 不可代报。三个 Harness 共用此入口;它不结束任务或授予操作权限。跟进通知门控见 cindy-bots-runtime.md §6.3。

历史查询的大结果分页

历史工具 list_sessions、get_chat_history、search_chat_history 的 limit 是条数上限。 源设备另按完整记录约 64 KiB 的软预算提前分页,消息、搜索命中及其上下文不被截断; 单条记录超过预算时仍完整返回,保证继续读取可以前进。调用方以 hasMore / nextCursor 续读,不以返回条数少于 limit 判断结束。原始历史不改写、不另存摘要,所有 Harness 共用; 跨电脑沿源设备同一查询与游标,旧设备保留其原有分页行为。 搜索预算仅由历史工具入口启用;界面搜索和学习证据等内部消费者保留按条数取页。 工具搜索逐条读取上下文并累计预算,到达边界后停止后续读取;游标保留未返回命中的位置。

社区插件贡献

普通个人作者的独立入口为 ghost_contribution_prepare、ghost_contribution_submit、 ghost_contribution_status、ghost_contribution_stop、ghost_my_plugins、ghost_cancel_plugin_review,由 cindy-tools 直接提供工具说明。手动和 AI 复用 Host 的精确安装快照、操作键、回执及个人读取接口;AI 不拿到 Bearer、PUT 票据或受管文件路径。公开写入遵循当前任务 Full Access / Auto / Ask,不加最后人工点击。 共享任务访客及既有 helper surface 判为 restricted 的插件托管任务(包括其 Worker)不得读取个人 个人插件发布资料或执行发布。普通用户自己的 Worker、自动任务沿相同账号边界与任务权限;人工审核不由 Agent 执行。 客户端提交边界见 社区贡献实现说明。

2026-10-16:个人发布 prepare 返回包内 releaseNotes 和远端只读预检;submit 前重新校验所见快照内容。 ghost_cancel_plugin_review 使用本人版本的精确 revision,区分停止上传与取消审核,沿现有 Full Access/Auto/Ask 授权。 旧版本包仍可安装,成功提审后的同版本不再支持改包重提。