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。

docs(plugin): 明确逐插件默认配置和任务授权边界

liugaowei2be475d895c0
diff --git a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md
index c98294f5ae..d833ad3485 100644
--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md
+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md
@@ -214,7 +214,7 @@ const r = await cindy.agent.requestSchedule({
- `list({targetKind:'project'|'task'|'bot'})`:返回 `{targets:[{kind,id,label,detail}]}`,只含本机可用目标的名称和目录/说明,不含消息历史。插件可自行搜索和展示列表,最近活动只用于排序。
- `resolve({target:{kind,id}})`:复核已保存或本次选择的目标,返回最新 `{kind,id,label,detail}`。只查询,不创建任务、不打开 UI、不保存绑定;固定目标失效返回 TARGET_UNAVAILABLE,不自动替换。插件可将 `{kind,id}` 存入自己的配置。project 的 id 是 Cindy 已有项目目录,task/bot 的 id 是任务/伙伴标识。
-- `send({target:{kind,id},requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})`:直接指定目标,Host 当次复核。project 在目录中新建普通任务,可传统一模型目录的 route 和已授权范围内的 permissionMode;task/bot 沿用接收方模型、权限、目录,不接受 route 或 permissionMode。`delivery` 为 `queue | steer`,缺省 queue;project 不接受 steer。steer 尝试同轮注入,不停止当前轮,空闲或插话暂不可用时入队。返回 `{taskId,accepted:true,delivery:"queue"|"steer"}` 表示实际接受路径,不表示执行完成。筛查拒绝返回 DELIVERY_REJECTED,不入队重试;ACK 未知返回 DELIVERY_UNCERTAIN,不得换键重发。不开放读取任意任务历史或改模。
+- `send({target:{kind,id},requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})`:直接指定目标,Host 当次复核。project 在目录中新建普通任务,可传统一模型目录的 route 和本次 permissionMode;task/bot 沿用接收方模型、权限、目录,不接受 route 或 permissionMode。`delivery` 为 `queue | steer`,缺省 queue;project 不接受 steer。steer 尝试同轮注入,不停止当前轮,空闲或插话暂不可用时入队。返回 `{taskId,accepted:true,delivery:"queue"|"steer"}` 表示实际接受路径,不表示执行完成。筛查拒绝返回 DELIVERY_REJECTED,不入队重试;ACK 未知返回 DELIVERY_UNCERTAIN,不得换键重发。不开放读取任意任务历史或改模。
- 同一次 send 重试沿用相同 requestKey、target、内容和 delivery(缺省与 queue 等价);同键参数变化返回 REQUEST_KEY_CONFLICT。Host 在执行前持久保留投递回执,重启后已接受的请求返回原结果,未确定结果的请求返回 DELIVERY_UNCERTAIN,不再次创建或投递。回执不保存正文或附件字节。不要通过更换 requestKey 绕过未知结果,应先让用户在 Cindy 检查。
- `cancel({requestKey})`:使本次请求及迟到的发送失效,仅撤回本插件该请求尚未执行的输入;不会停止接收方其他输入,也不保证撤销已经开始的工作。新操作使用新的 requestKey。
- `tasks.send` 和 `targets.send` 均支持可选 `attachments:[{base64,name?}]`:只接收插件提供的图片字节,不接受本机路径、URL、媒体 URI 或自报 MIME。Host 检测 PNG/JPEG/WebP,最多 4 张、合计 20 MiB。先检查 `tasks.capabilities().messageAttachments.kinds` 包含 image;旧客户端不支持时停止,不静默丢图或改投临时路径。截图进既有 cindy-media,作为消息附件展示并进入模型输入;不需要额外声明 media.deposit。附件内容及名称参与幂等签名,更换附件不能复用同键。
@@ -257,19 +257,16 @@ text 与 context 合计不超过 64000;tasks.send 的 text 上限仍为 32768
### 新建任务的权限选择(可选)
-先检查 `tasks.capabilities().createPermissionMode === true`。`tasks.create` 和 project 的
-`targets.send` 可传 `permissionMode: 'ask' | 'auto' | 'bypassPermissions'`,分别对应默认权限、自动审批、完全访问,仅决定这一个新任务的权限,
-不修改插件默认设置。省略时仍使用用户的插件任务设置,未设置则为 ask。
+先检查 `tasks.capabilities().createPermissionMode === true`。Host 已批准任务能力后,`tasks.create` 和
+project 的 `targets.send` 可传 `permissionMode: 'ask' | 'auto' | 'bypassPermissions'`,对应默认权限、自动审批、完全访问。
+仅决定这一个新任务,不修改插件默认设置。省略时使用启用卡片的默认值,否则为 ask。
-参数不是授权凭证。Host 在创建前、异步准备后、投递及排队受理前按当前用户设置复核:ask 只允许 ask,
-auto 允许 ask/auto,bypassPermissions 允许上述三档;超出范围返回 PERMISSION_DENIED,
-不会静默降档或自动更改用户设置。完全访问须由用户在插件任务设置中选择;
-既有 `requestWriteAccess` 仍只支持 acceptEdits/auto,不能请求完全访问或降低用户已授权的上限。
-历史 plan/acceptEdits 设置原样保留,但不作为此新参数的可选值;历史 acceptEdits 上限只允许新参数选择 ask。
-不接受自报 confirmed;Plan Mode 不是此参数的权限档位。
-已有 task/bot 的投递不能携带 permissionMode,也不会改动接收方权限。
-权限选择参与幂等摘要,同键改变权限返回原有冲突错误;省略新字段的旧请求摘要及重放保持不变。
-旧 Host 未宣告支持时,不发送该参数,也不能悄悄忽略用户已经选择的权限。
+默认卡不是授权上限。每个插件自行声明 `showTaskPreferences:false` 后,其旧模型、目录和权限配置不再读取,
+不影响其它插件。Host 仍在创建、异步准备、投递和排队接受前复核能力批准、账号、任务归属与 Session/Plan。
+既有 `requestWriteAccess` 仍只支持 acceptEdits/auto,确认只修改目标 Session,不改默认卡或其它任务。
+历史 plan/acceptEdits 配置保留,但不是新参数选项。不接受自报 confirmed;Plan Mode 不是此参数的权限档位。
+已有 task/bot 不接受 permissionMode,也不改变接收方权限。同键改变权限仍返回冲突错误,省略字段的旧请求可重放。
+旧 Host 未宣告支持时不发送新参数;依赖隐藏后解耦的插件须使用实现此契约的 Host。
原有 `cindy.tasks` 的归属限制不变。先调用 `capabilities()` 获取实际支持操作。当前仅支持本插件创建的本机普通任务:
`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`。
@@ -283,13 +280,13 @@ auto 允许 ask/auto,bypassPermissions 允许上述三档;超出范围返回
卸载会撤销插件后续 API 控制,但不保证停止已派发的原生工作;需要停止时请使用任务停止入口。
计划须在首次派发或创建 Worker 前登记,之后不可改写(包括补填 task);需要不同范围时创建新任务。
缺少该字段的存量计划继续可读,但 Host 不允许插件任务自动授权或普通 MCP 快捷放行,不会从 Agent 消息推导额外授权;进入 Host 的 Ask/acceptEdits 动作仍可沿原流程逐次确认。
-计划不授予目录权限。Worker 仅可使用宿主任务目录及解析后仍在其中的子目录、插件 AI 配置目录或用户亲选的确切目录;Library 绑定不自动变成 Agent 工作根。宿主在登记和创建时均复核。
+计划不授予目录权限。Worker 仅可使用宿主任务目录及解析后仍在其中的子目录或用户亲选的确切目录;Library 绑定不自动变成 Agent 工作根。宿主在登记和创建时均复核。
插件自有主任务不支持用 `execution_device_id` 新建跨设备 Worker;本机目录授权不代表已授权另一台电脑的同名目录,登记团队计划也不改变此限制。
这描述准入检查,不是持续的 OS 目录隔离保证。首版用于可信本地工作区;同权限进程在检查后恶意置换目录对象仍可能改变实际 cwd,不提供此类对抗性沙箱。
`models()` 返回统一目录可选项的完整 route、efforts 和 supportsFastMode。用户明确选择后将 route 原样传给 create,或用 `setModel({taskId, expectedRevision, route})` 修改已有自有任务。运行中按普通任务的安全边界切换,不修改应用默认。两方法使用前检查 capabilities.operations。
当 `capabilities().pluginDefaultModel === true` 时,持续复用任务的插件可在每次新输入前调用
-`setModel({taskId, expectedRevision, route:'plugin-default'})`。Host 当次读取本插件的任务模型设置,
+`setModel({taskId, expectedRevision, route:'plugin-default'})`。Host 当次读取本插件有效的任务模型默认值(隐藏卡片时忽略旧值),
复用 create 的模型解析规则(未指定时采用当前新任务选择),只同步模型、来源、引擎、强度和 Fast,
不改权限、目录或其它任务。返回 `{status,task}`;配置相同返回 unchanged,不反复切换。
后续 send 使用返回 task.revision。须先处理已接受/结果不确定的旧请求,再同步下一次输入,
@@ -344,10 +341,9 @@ create/send 的 requestKey 持久去重;同键不同内容拒绝。删除后
新字段需该能力为 true 才发送,旧客户端不能假定支持;同 requestKey 的重放保留原创建结果。
来源/模型/强度必须当前可用,派发前再次核对;失败引导改选或修复连接,不自动换模型或账号。
已有普通任务保留自身配置,用户在任务内修复后继续使用原任务。
-工作目录由宿主分配,或沿用用户已在插件设置中选择的目录;不接受任意路径或超出已授权范围的权限。
-权限上限来自用户的插件任务设置;新建时可按上述参数选择更低档位,省略则沿用设置,未设置为 ask。工作区内行为及询问规则与所选
-Agent 的普通任务一致。用户可在插件设置中选择 ask / auto / bypassPermissions,
-不继承发起任务的权限。既有任务与显式历史 plan/acceptEdits 配置保留原行为,不自动提权;需要改变时由用户选择。
+工作目录由宿主分配,或沿用启用默认卡时用户已选择的目录;不接受任意路径。
+权限使用显式参数或有效默认值,缺省 ask;不继承发起任务权限。Host 能力批准与 Session 执行权限独立校验。
+工作区行为及询问规则与所选 Agent 的普通任务一致。已有任务和历史 plan/acceptEdits 值不自动改权。
create 可传 `isolatedWorkspace:true`,使用宿主为该任务生成的独立空目录,忽略插件的项目目录偏好。
返回 workingDir 仅属于本插件创建的任务,可交给插件 Node 进程放入候选项目;不接受插件自报任意目录。
任务视图同时返回 permissionMode;按实际权限展示,不将历史 plan 值视作跨 Agent 的只读保证,不能暗中升级权限。
diff --git a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md
index 672dacd42a..a481c3f4c6 100644
--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md
+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md
@@ -9,11 +9,12 @@
"settingsHeight": 360 // 可选:固定高度 px(160–800);缺省 = 随内容自适应(矮内容真收矮),超 800 内部滚动
```
-**宿主默认配置卡(可选)**:顶层 `showTaskPreferences` 只接受布尔值。
-省略或设为 `true` 时,符合能力条件的插件继续显示宿主「模型与任务」卡。
-声明 `"showTaskPreferences": false` 可隐藏 Desktop 和手机上的该卡,供插件在自己的设置界面提供配置。
-这只是显示声明:任务 API、已有配置的读取和执行规则、权限检查均保持原样;也不会为没有相应能力的插件新增卡片。
-旧客户端不识别此字段时仍显示原卡片;依赖隐藏效果的插件应使用支持此字段的客户端版本。
+**宿主默认配置卡(可选)**:每个插件在自己的身份卡声明 `showTaskPreferences`,只接受布尔值。
+省略或声明 `"showTaskPreferences": true` 时,符合能力条件的插件继续显示并使用自己的「模型与任务」默认卡。
+声明 `"showTaskPreferences": false` 隐藏该插件在 Desktop 和手机上的卡片,且不读取其旧模型、目录、权限配置;其它插件不受影响。
+旧值保留,重新启用后恢复。插件自行维护配置并通过任务参数传入;默认卡不是宿主授权上限。
+Host 仍独立检查能力批准、任务归属、目录和任务当前权限,隐藏字段本身不授予能力。
+旧 Host 可能只隐藏 UI 而继续使用配置;依赖解耦行为须使用实现此契约的客户端版本。
**渲染环境**:与面板同款沙箱页(零桥、无通用网络直连,与同插件面板/逻辑页共用浏览器存储和
`BroadcastChannel`,脚本/样式/字体/媒体/数据请求仍只认同源)。所有插件 HTML 页面
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/forge.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/forge.test.ts
index 01d0e2787b..6277df6b3b 100644
--- a/apps/desktop/src/main/cindy-brain/__tests__/forge.test.ts
+++ b/apps/desktop/src/main/cindy-brain/__tests__/forge.test.ts
@@ -1705,10 +1705,11 @@ describe('scaffoldGhostDir', () => {
});
describe('FORGE_GUIDE', () => {
- it('documents optional Host task card visibility separately from task capabilities', () => {
+ it('documents plugin-level defaults independently of Host authorization', () => {
expect(FORGE_GUIDE).toContain('"showTaskPreferences": false');
expect(FORGE_GUIDE).toContain('"showTaskPreferences": true');
- expect(FORGE_GUIDE).toContain('任务 API、已有配置的读取和执行规则、权限检查均保持原样');
+ expect(FORGE_GUIDE).toContain('且不读取其旧模型、目录、权限配置;其它插件不受影响');
+ expect(FORGE_GUIDE).toContain('Host 仍独立检查能力批准、任务归属、目录和任务当前权限');
});
it('账号业务元数据使用插件 KV,不声明 Host 昵称接口', () => {
diff --git a/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts b/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts
index 2f27fd6f67..cff4406a50 100644
--- a/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts
+++ b/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts
@@ -1,11 +1,12 @@
/**
* User preferences for plugin-created ordinary tasks. The legacy errand adapter
- * consumes these same preferences; it does not own the model/permission policy.
+ * consumes the effective defaults; this store does not grant task authority.
* Keep ghost-errand-prefs.json and its `errand`/`sessions` keys for installed-plugin
* compatibility. `sessions` belongs only to the old errand sessionKey adapter.
* Empty model preferences use the originating task or the current new-task route.
* New ordinary tasks use ask; the legacy adapter retains its historical default.
- * Permissions stay independently user-owned, never caller-inherited.
+ * Hidden cards retain their saved values but provide no runtime defaults.
+ * Host capability approval and Session permissions are independent of this store.
* Model admission belongs to the shared ordinary-session resolver, never this store.
* The same model fields are the plugin's single "model" preference: Cindy quick
* answers (cindy.text.oneshot) use them too; empty = the system auxiliary model.
@@ -28,7 +29,7 @@ import {
readLegacyOneshotPins,
} from './cindyPrefsStore.js';
-/** User-owned plugin task permission policy. A model source never grants authority. */
+/** Normalize a creation default, not an authorization ceiling. */
export function clampPluginTaskPermissionMode(value: unknown, fallback: GhostErrandPermissionMode = 'ask'): GhostErrandPermissionMode {
return typeof value === 'string' && (GHOST_ERRAND_PERMISSION_MODES as readonly string[]).includes(value)
? value as GhostErrandPermissionMode : fallback;
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index 430cd87fda..ab27a30aff 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -17809,10 +17809,10 @@
"pluginTaskWriteAccess": {
"autoTitle": "Enable Auto approval",
"autoMessage": "Allow “{{name}}” to use Auto approval?",
- "autoDetail": "Cindy will review coordinator and Worker actions automatically. Actions requiring confirmation or denied actions still pause. This is not Full access. The choice is saved in plugin AI settings without changing global permissions for other tasks.",
+ "autoDetail": "Cindy will review coordinator and Worker actions automatically. Actions requiring confirmation or denied actions still pause. This is not Full access. Only this session’s permission changes; plugin defaults stay unchanged.",
"title": "Allow this plugin’s AI to edit files?",
"message": "Allow the AI in “{{name}}” to edit files and continue?",
- "detail": "This sets the plugin’s AI permission to Allow edits for future tasks too. A separate working directory is not a system sandbox; commands still follow Cindy permission checks. You can switch back to read-only in the plugin’s AI settings.",
+ "detail": "This allows edits only for the current session. A separate working directory is not a system sandbox; commands still follow Cindy permission checks. You can change this in the session’s permission menu.",
"allow": "Allow and continue",
"cancel": "Not now"
},
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index c04a64a96d..acbc7e267c 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -17749,12 +17749,12 @@
"pluginTaskWriteAccess": {
"title": "このプラグインの AI にファイルの編集を許可しますか?",
"message": "「{{name}}」の AI にファイルの編集を許可して続行しますか?",
- "detail": "このプラグインの AI 権限を編集可能に変更します。今後のタスクにも適用されます。独立した作業ディレクトリはシステムのサンドボックスではなく、コマンドには引き続き Cindy の権限チェックが適用されます。プラグインの AI 設定でいつでも読み取り専用に戻せます。",
+ "detail": "現在のセッションのみ編集を許可します。独立した作業ディレクトリはシステムのサンドボックスではなく、コマンドには引き続き Cindy の権限チェックが適用されます。このセッションの権限メニューで変更できます。",
"allow": "許可して続行",
"cancel": "今は許可しない",
"autoTitle": "Auto 自動承認を有効化",
"autoMessage": "「{{name}}」で Auto 自動承認を使用しますか?",
- "autoDetail": "主タスクと Worker の操作を Cindy が自動審査します。確認が必要な操作や拒否された操作は停止します。完全アクセスではありません。他のタスクの全体設定は変更しません。"
+ "autoDetail": "主タスクと Worker の操作を Cindy が自動審査します。確認が必要な操作や拒否された操作は停止します。完全アクセスではありません。現在のセッションの権限のみを変更し、プラグインの既定設定は変更しません。"
},
"groupTools": {
"authorizationRequired": "グループの許可が失効したか、この操作は許可されていません。パートナーの所有者からこのグループで再度依頼してください。",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 306a15d5a8..1216c6f855 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -17749,12 +17749,12 @@
"pluginTaskWriteAccess": {
"title": "이 플러그인의 AI가 파일을 수정하도록 허용할까요?",
"message": "“{{name}}”의 AI가 파일을 수정하도록 허용하고 계속할까요?",
- "detail": "이 플러그인의 AI 권한을 수정 가능으로 변경하며, 이후 작업에도 적용됩니다. 별도의 작업 디렉터리는 시스템 샌드박스가 아니며, 명령에는 계속 Cindy의 권한 검사가 적용됩니다. 플러그인 AI 설정에서 언제든지 읽기 전용으로 되돌릴 수 있습니다.",
+ "detail": "현재 세션에만 수정을 허용합니다. 별도의 작업 디렉터리는 시스템 샌드박스가 아니며, 명령에는 계속 Cindy의 권한 검사가 적용됩니다. 이 세션의 권한 메뉴에서 변경할 수 있습니다.",
"allow": "허용하고 계속",
"cancel": "지금은 허용 안 함",
"autoTitle": "Auto 자동 승인 사용",
"autoMessage": "“{{name}}”에 Auto 자동 승인을 허용할까요?",
- "autoDetail": "Cindy가 주 작업과 Worker 동작을 자동 심사합니다. 확인이 필요하거나 거부된 동작은 일시 중지됩니다. 전체 접근 권한이 아니며 다른 작업의 전역 권한은 변경하지 않습니다."
+ "autoDetail": "Cindy가 주 작업과 Worker 동작을 자동 심사합니다. 확인이 필요하거나 거부된 동작은 일시 중지됩니다. 전체 접근 권한이 아닙니다. 현재 세션의 권한만 변경하며 플러그인 기본 설정은 변경하지 않습니다."
},
"groupTools": {
"authorizationRequired": "그룹 권한이 만료되었거나 이 작업이 허용되지 않습니다. 파트너 소유자가 이 그룹에서 다시 요청해 주세요.",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index cd6ca75325..2bb1c508c1 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -17749,10 +17749,10 @@
"pluginTaskWriteAccess": {
"autoTitle": "启用 Auto 自动审批",
"autoMessage": "允许“{{name}}”使用 Auto 自动审批?",
- "autoDetail": "主任务和 Worker 的操作将交由 Cindy 自动审批。审批要求人工确认或拒绝时仍会暂停;这不是完全访问。此选择保存到插件 AI 设置,不改变其他任务的全局权限。",
+ "autoDetail": "主任务和 Worker 的操作将交由 Cindy 自动审批。审批要求人工确认或拒绝时仍会暂停;这不是完全访问。仅更改当前任务的权限,不改动插件默认设置。",
"title": "允许插件的 AI 修改文件?",
"message": "允许“{{name}}”的 AI 修改文件并继续?",
- "detail": "将此插件的 AI 权限设为“允许修改”,后续任务沿用此选择。独立作答目录不是系统沙箱;命令仍遵循 Cindy 的权限检查。你可以随时在插件 AI 设置中改回只读。",
+ "detail": "仅将当前任务的权限设为“允许修改”。独立作答目录不是系统沙箱;命令仍遵循 Cindy 的权限检查。你可以在当前任务的权限菜单中调整。",
"allow": "允许并继续",
"cancel": "暂不允许"
},
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index b14cf217bb..4ed0b3c579 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -17749,12 +17749,12 @@
"pluginTaskWriteAccess": {
"title": "允許此插件的 AI 修改檔案?",
"message": "允許「{{name}}」的 AI 修改檔案並繼續?",
- "detail": "將此插件的 AI 權限設為「允許修改」,後續任務也會沿用此選擇。獨立工作目錄不是系統沙箱;命令仍遵循 Cindy 的權限檢查。你可以隨時在插件 AI 設定中改回唯讀。",
+ "detail": "僅將目前任務的權限設為「允許修改」。獨立工作目錄不是系統沙箱;命令仍遵循 Cindy 的權限檢查。你可以在目前任務的權限選單中調整。",
"allow": "允許並繼續",
"cancel": "暫不允許",
"autoTitle": "啟用 Auto 自動審批",
"autoMessage": "允許「{{name}}」使用 Auto 自動審批?",
- "autoDetail": "主任務與 Worker 的操作將交由 Cindy 自動審批。需要人工確認或遭拒時仍會暫停;這不是完全存取。此選擇儲存到插件 AI 設定,不變更其他任務的全域權限。"
+ "autoDetail": "主任務與 Worker 的操作將交由 Cindy 自動審批。需要人工確認或遭拒時仍會暫停;這不是完全存取。僅變更目前任務的權限,不變更插件預設設定。"
},
"groupTools": {
"authorizationRequired": "群組授權已失效或不允許此操作,請由夥伴主人在目前群組重新發起。",
diff --git a/apps/desktop/src/shared/ghost.ts b/apps/desktop/src/shared/ghost.ts
index 95f90e81af..339cc013e0 100644
--- a/apps/desktop/src/shared/ghost.ts
+++ b/apps/desktop/src/shared/ghost.ts
@@ -1547,7 +1547,7 @@ export interface GhostManifest {
* 页用它避免抖动)。须与 settingsHtml 成对声明。
*/
settingsHeight?: number;
- /** 是否显示宿主「模型与任务」默认配置卡;缺省或 true 显示,false 仅隐藏卡片。 */
+ /** 本插件是否使用宿主默认配置卡;缺省/true 启用,false 隐藏且不读取该插件的卡片配置。 */
showTaskPreferences?: boolean;
/**
* 卡片能力;空对象表示基础卡片渲染。
@@ -6564,7 +6564,7 @@ export const GHOST_ERRAND_MIN_INTERVAL_MS = 10_000;
export const GHOST_ERRAND_SESSION_KEY_RE = /^[A-Za-z0-9._-]{1,64}$/;
/**
- * 插件新建任务与普通任务使用同一三档,由用户设置决定授权上限,缺省 ask。
+ * 插件新建任务与普通任务使用同一三档;显式参数优先,其次有效默认配置,缺省 ask。
* plan / acceptEdits 仅保留旧配置及旧接口兼容,不自动升权或丢弃历史选择。
*/
export const GHOST_ERRAND_PERMISSION_MODES = [...PLUGIN_TASK_PERMISSION_MODES, 'plan', 'acceptEdits'] as const;
diff --git a/apps/desktop/src/shared/pluginTasks.ts b/apps/desktop/src/shared/pluginTasks.ts
index 869b0008a9..a63aa39f56 100644
--- a/apps/desktop/src/shared/pluginTasks.ts
+++ b/apps/desktop/src/shared/pluginTasks.ts
@@ -94,7 +94,7 @@ export type PluginTaskRequest = (
/** Opt in to Host naming after the first accepted message; omit title. */
autoTitle?: boolean;
route?: PluginTaskRoute;
- /** New task only; cannot exceed the user's current plugin permission policy. */
+ /** New task only; requires Host task approval and does not change plugin defaults. */
permissionMode?: PluginTaskPermissionMode;
isolatedWorkspace?: boolean;
/** Requires `agent.hiddenTasks`; creates the task as a background task. */
diff --git a/docs/dev-rules/plugin-security-and-authoring.md b/docs/dev-rules/plugin-security-and-authoring.md
index 7b4d426fd8..dd7653e234 100644
--- a/docs/dev-rules/plugin-security-and-authoring.md
+++ b/docs/dev-rules/plugin-security-and-authoring.md
@@ -136,11 +136,12 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开
但当前 Host 不展示、不授权、也不因此阻止安装或发布。
未来 Host 识别该字段后,才按正常的能力展示和运行时守门链路启用。不能把
未知字段猜成现有权限,也不能让它意外获得能力。
-- 顶层 `showTaskPreferences?: boolean` 仅控制宿主「模型与任务」默认配置卡的显示。
- 省略或 `true` 沿用原有能力条件;`false` 隐藏 Desktop 和手机上的该卡,由插件提供自己的配置界面。
- 任务 API、已有配置的读取和执行规则、权限检查及安装确认均不改变。此字段不是能力授权,
- 无相应能力时设为 `true` 也不会新增卡片。旧客户端不识别时仍显示原卡片。
- 实现见 `ghostPluginViewModel.ts`、`mobilePageService.ts`;作者用法见 `FORGE_GUIDE` §4.8。
+- 顶层 `showTaskPreferences?: boolean` 是每个插件自己的默认配置声明,不是 Cindy 全局开关。
+ 省略或 `true` 沿用原有能力条件并提供该插件的创建默认值;`false` 隐藏 Desktop 和手机上的卡片,
+ 且运行期不读取该插件的旧模型、目录和权限配置。旧数据保留,重新启用时恢复;其它插件不受影响。
+ 默认卡不承担授权上限,隐藏字段也不授予能力。Host 仍独立检查能力批准、任务归属、目录和 Session/Plan。
+ 旧客户端可能只隐藏卡片而继续读取配置;依赖解耦行为须使用实现此契约的 Host。
+ 实现见 `getPluginTaskDefaults`、`ghostPluginViewModel.ts`、`mobilePageService.ts`;作者用法见 `FORGE_GUIDE` §4.8。
- `agent.tasks` 另需 Host receipt 的显式任务能力批准事实;旧 receipt 没有该事实时,
只在首次任务能力调用通过既有宿主权限界面确认,原插件的启用态、其它能力、凭证和
设置保持不变。拒绝、窗口不可用、账号或安装版本变化均不授予任务权限;同能力更新
@@ -213,7 +214,7 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开
### 3.1 安装与自动更新
-插件普通任务创建的 Worker 目录由宿主校验:允许当前任务目录及解析符号链接后仍在其中的子目录、插件 AI 配置目录、用户通过目录选择器授权的确切目录。Library 绑定本身不授予 Agent 工作目录权限,协同计划也不构成目录授权。登记计划和实际创建 Worker 均复核授权;账号、配置或任务归属发生变化时拒绝继续创建。
+插件普通任务创建的 Worker 目录由宿主校验:允许当前任务目录及解析符号链接后仍在其中的子目录、用户通过目录选择器授权的确切目录。Library 绑定本身不授予 Agent 工作目录权限,协同计划也不构成目录授权。登记计划和实际创建 Worker 均复核授权;账号、实际任务配置或任务归属发生变化时拒绝继续创建;默认卡目录不作为额外授权根。
这些目录授权只标识任务所在电脑的资源,不授权另一台电脑的同名目录。插件自有 Lead 不支持通过 `executionDeviceId` 新建跨设备 Worker:有无团队计划均在目录探测、槽位预留和远端创建之前拒绝。普通用户任务的跨设备 Worker 及插件既有 Worker 路径不变;不新增插件批准、配置或迁移。
同一次 Worker 创建沿用最初的账号与任务归属,在启动 Session、续租完成后、写入 Worker 前再次复核。
复核失败沿用既有尽力清理路径(关闭、移除运行缓存、归档 Session 与释放预留),不派发初始任务;新团队沿用创建失败收尾。
@@ -487,17 +488,15 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开
缺省从宿主验证的发起任务继承,面板无发起任务则使用当前新任务的完整选择,不优先翻找 Claude Code 的历史草稿。模型选择不授予权限或目录。
保存、新建和插件派发前复用普通独立任务的模型/供应商/Agent 准入,不另建目录或选择器。
连接状态不等于额度、网络及远端参数一定可用;执行失败如实返回,不静默换型号或账号。
-- 插件新建普通任务的权限仅来自用户的插件设置或既有宿主确认流程,默认普通任务的 `ask`,允许
- 用户显式选择默认权限(`ask`)/自动审批(`auto`)/完全访问(`bypassPermissions`);不继承发起任务的权限。
- `tasks.create` 与 project 的 `targets.send` 可选 `permissionMode`,仅在当前用户插件权限上限内
- 选择本次新任务的 ask/auto/bypassPermissions;参数本身不授予权限、不写插件默认设置。
- 完全访问须来自用户在插件设置中的选择;旧 `requestWriteAccess` 仍只支持 acceptEdits/auto,
- 不增加完全访问确认弹窗,也不因复用该流程降低用户已授权的上限。
- Main 在创建前及异步准备后复核;省略参数保持旧行为,已有任务/伙伴投递不接受权限覆盖。
- 旧 errand 适配器保留历史缺省 `plan` 与原 Agent 行为;历史 plan/acceptEdits 配置保留,但不列入新建接口和设置页的新选项。已有任务不自动改权。
- 不把历史 `plan` 值宣称为跨 Agent 的只读保证,也不为它改造各 Agent 的权限引擎。
- 旧存储文件名、键及 IPC 保持兼容,升级不丢配置、不重批权限。来源优先级、复用和恢复
- 详见 [插件普通任务接口](plugin-task-api-implementation.md#模型配置与创建来源)。
+- 插件须先取得 Host 的任务能力批准;已批准的插件可在 `tasks.create` 或 project 的
+ `targets.send` 显式选择默认权限(`ask`)/自动审批(`auto`)/完全访问(`bypassPermissions`)。
+ 省略时使用启用卡片的默认值,否则为 `ask`;不继承发起任务权限,也不写插件默认配置。
+ 默认卡不是授权上限。Main 在创建、异步准备、投递及排队接受时继续复核账号、批准、归属和实际任务状态。
+ 已有任务按自己的权限执行,默认卡改值不撤销或提升它的权限;已有任务/伙伴投递不接受权限覆盖。
+ 旧 `requestWriteAccess` 仍只支持 acceptEdits/auto,通过原宿主确认只改变目标 Session,不写回默认卡。
+ 旧 errand 适配器保留历史缺省 `plan`;历史 plan/acceptEdits 配置保留,但不列入新建接口和设置页的新选项。
+ 不把历史 `plan` 值宣称为跨 Agent 的只读保证。旧存储、IPC 和能力批准不迁移,无需重装或重新批准。
+ 来源优先级、复用和恢复见 [插件普通任务接口](plugin-task-api-implementation.md#模型配置与创建来源)。
- 附件、媒体、目录和保存路径通过归属校验后的 grant/deposit/ledger 交接,**禁止把
宿主绝对路径或不必要的字节暴露给沙箱**。媒体字节须走
[`media-storage-and-protocols.md`](media-storage-and-protocols.md) 的统一入库。
diff --git a/docs/dev-rules/plugin-task-api-implementation.md b/docs/dev-rules/plugin-task-api-implementation.md
index 50e2f3494f..a905674725 100644
--- a/docs/dev-rules/plugin-task-api-implementation.md
+++ b/docs/dev-rules/plugin-task-api-implementation.md
@@ -114,14 +114,16 @@ Host 每次调用都重新读取本插件的模型设置,复用创建任务的
新任务选择;用户可为插件单独覆盖。模型、Agent、供应商、推理强度和 Fast 作为完整组合
解析,绝不从另一 Agent 的历史草稿拼出一组值。权限独立设置,不随模型来源继承。
-插件可在 `ghost.json` 顶层声明 `showTaskPreferences: false`,隐藏 Desktop 和手机上的
-宿主「模型与任务」默认配置卡,并在自己的设置界面提供配置。省略或设为 `true` 保持原有显示条件。
-此字段仅控制卡片显示;以下任务 API、模型优先级、已有默认配置和权限检查全部保持原样。
-旧客户端不识别该字段时仍显示原卡片。
+每个插件可在自己的 `ghost.json` 顶层声明 `showTaskPreferences: false`,隐藏 Desktop 和手机上的
+宿主「模型与任务」默认卡,并停止读取该插件旧卡片的模型、目录和权限值。旧数据保留;重新启用
+后恢复。省略或 `true` 仍按原有能力条件提供该插件的默认配置,其它插件不受影响。
+运行期统一通过 `getPluginTaskDefaults` 读取有效默认值,原始存储只供设置页维护。
+默认卡与宿主授权独立:卡片只提供缺省参数,不作为权限上限;Host 仍核验插件能力批准、账号/安装代次、
+任务归属、目录/目标授权以及 Session 当前权限和 Plan 状态。旧 Host 可能只隐藏 UI,升级后才有解耦语义。
| 入口 | 模型来源与复用 | 权限与结果 |
| --- | --- | --- |
-| `tasks.create` | 显式 route → 插件任务设置 → 经验证的 callId 发起任务 → 当前新任务选择;保存准入后的完整 route | 可选 permissionMode 在用户插件权限上限内选择本次权限;省略沿用设置,缺省 ask;返回普通任务及持久创建回执 |
+| `tasks.create` | 显式 route → 插件任务设置 → 经验证的 callId 发起任务 → 当前新任务选择;保存准入后的完整 route | 已批准任务能力的插件可选本次 permissionMode;省略沿用有效默认值,缺省 ask;返回普通任务及持久创建回执 |
| `tasks.send` | 使用该任务当前 route,检查 revision 和当前可用性;不因新默认变化重建任务 | 复核插件归属与权限;结果使用逐输入 run 回执 |
| `agent.errand` | 共用模型解析;无显式覆盖时优先保留已有专属任务的当前模型。配置冲突时只在新任务创建成功后替换映射,旧历史保留 | 旧权限边界、sessionKey、jobId 与结果取回协议保持兼容 |
| `workspace.ensureSession` | 已有工作区入口照常复用;新建才使用插件设置/发起任务/当前新任务完整组合 | 目录仍经亲选或原有确认流程;只建入口、不运行 Agent |
@@ -143,13 +145,12 @@ Host 每次调用都重新读取本插件的模型设置,复用创建任务的
跨 Agent 的只读保证;历史 acceptEdits 配置也原样保留。新选项统一为默认权限(ask)、
自动审批(auto)和完全访问(bypassPermissions),用户明确选择后才覆盖旧值。
-`tasks.capabilities().createPermissionMode` 表示创建接口支持按次选择 ask/auto/bypassPermissions,
-不代表获得这三档权限。`tasks.create` 和 project 的 `targets.send` 接收可选 `permissionMode`;
-Main 复用 `isPluginTaskPermissionAllowed` 按当前插件用户设置校验,上限不足返回 PERMISSION_DENIED。
-仅写入新 Session 的 permissionMode,不修改插件偏好;已有任务与伙伴不接受该参数。
-新字段参与请求摘要,缺省不增加摘要项,因此旧回执仍能重放;创建过程继续复核账号、插件批准及配置。
-完全访问必须由用户在插件设置中选择;既有 requestWriteAccess 仍只接受 acceptEdits/auto,
-不新增确认 UI 或授权存储,也不因旧写权限流程降低用户已授权的上限。
+`tasks.capabilities().createPermissionMode` 表示创建接口支持按次选择 ask/auto/bypassPermissions。
+`tasks.create` 和 project 的 `targets.send` 接收可选 `permissionMode`,前提仍是 Host 已批准任务能力。
+新参数只写入新 Session,不写插件默认配置;默认卡的权限值不限制本次显式选择。
+新字段参与请求摘要,缺省不增加摘要项,因此旧回执仍能重放;创建期间复核账号、插件批准与实际使用的默认值。
+已有任务和伙伴不接受该参数。既有 requestWriteAccess 仍只接受 acceptEdits/auto,通过原宿主确认
+只改变目标 Session,不写回默认卡、不影响其它任务;不新增确认 UI 或授权存储。
`pluginTaskPrefsStore` 保留历史 `ghost-errand-prefs.json`、`errand` 与 `sessions` 键以及
既有 IPC 名;无需重装、重新授权或人工迁移。`sessions` 键只供旧 errand 映射使用。
@@ -183,11 +184,11 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`
- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden`。
- create 可传 `hidden:true`、`setHidden({taskId, hidden})` 切换,`get`/`list` 快照恒返回 `hidden` 布尔值;仅身份卡声明 `agent.hiddenTasks: true`(必须同时 `agent.tasks: true`)时可用,见下文「后台任务」。
-- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,按次选择不得超过用户授予插件的权限。
-- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);工作目录及权限来自用户配置,不接受插件传入绕过权限、任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。
+- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,Host 任务能力批准独立校验。
+- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);权限取显式参数或有效默认值,目录取已授权目标/有效默认目录或宿主分配;不接受任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。
- 发送走普通输入协调器,使用持久 requestKey 去重和稳定输入 ID;重复请求不会再次启动模型。
- 指定 provider、model、effort、Fast 必须通过当前目录核验;派发前再次核验,不静默 fallback。
-- 创建回执写入后、创建 Session 前,按原始请求重新解析路由并与已受理路由比较;默认模型配置变化则拒绝,不静默使用旧值。目录解析及创建器的最终 continuation 同时复核 agentKind/model/provider/effort/Fast、目录和权限。
+- 创建回执写入后、创建 Session 前,按原始请求重新解析路由并与已受理路由比较;实际使用的默认模型配置变化则拒绝,不静默使用旧值。目录解析及创建器的最终 continuation 复核实际使用的默认字段;隐藏或已被显式参数覆盖的卡片字段不参与判断。
- 本次创建在 Session INSERT 开始前明确失败(如配置、目录或工作区准备失败)时,沿现有回执队列撤回仍为原版本、且原始 Session 行不存在的新回执;修正原因后可用原 requestKey 显式重试,不自动重派。回执存储固定原账号数据库,撤销或版本变化的回执不删除。
- 新请求的幂等摘要忽略对象键顺序,保留数组顺序;计划及已受理配置共用相同比较。早期开发版创建回执保留原序列化输入的精确重试兼容;这类旧摘要未保存原始键序,不能承诺首次以不同键序重放成功。
- 回执独立落库,区分任务、输入执行及原生执行代次;原生终态按 instanceId + generation 结算,不以 idle 或最后一条 assistant 消息猜测完成。
@@ -261,13 +262,13 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`
插件新增的 tasks 能力首次使用时复用宿主权限确认。拒绝、超时或确认失败后,同一账号代际和安装修订在当前宿主进程内不再自动弹窗;插件重载或重复调用不能清除该状态。用户可在本机插件详情权限区点击“确认任务权限”重新进入原确认流程,点击不等于批准;在途确认不并发,账号、安装修订或发起窗口改变时旧结果无效。旧插件的既有功能、启用态、凭证与设置不变。此显式入口不向插件页面或 device-link 暴露;重启宿主后可重新首次询问。
-逻辑页可调用 cindy.tasks.requestWriteAccess({taskId, mode?})。省略 mode 保留旧行为(acceptEdits,仅限未开始执行的任务);mode: auto 请求宿主原生确认,为空闲自有任务及插件后续任务启用 Auto。插件不能替用户确认,该写权限请求接口不接受 Full access;完全访问须由用户在插件设置中选择。拒绝不改状态;账号、配置、任务版本在确认期间改变则拒绝写入。Auto 插件主任务的 Worker 固定使用 Auto,不继承或改写全局 Worker 偏好;授权撤销后拒绝新建。Host 读取该次权限时一并保留账号与插件来源,在团队查询、Worker 准备/启动、落盘后以及首条输入的 accepted 回调中复核;在途卸载、重装、归属消失或降权不能将本次创建降为普通 Orca。调用开始前已明确撤销的旧用户任务仍可新发起普通 Orca。首条输入(任务或就绪消息)真正接收时沿现有回调再次复核;任务接收生命周期的异步更新前后均检查,失败回滚本次临时运行态并取消派发。直发拒绝后,在派发调用退出后才沿原生命周期清理新 Worker;排队后迟到的拒绝仅取消该输入并回滚本次临时状态,保留 Worker 和用户数据。既有内存回调不构成跨重启的授权事务,也不保证中断已接收执行。失败沿原生命周期尽力清理,不保证跨账号数据库补偿或跨进程事务。独立目录不是沙箱。返回 granted 与更新后的 task/revision,插件应继续原批次。
+逻辑页可调用 cindy.tasks.requestWriteAccess({taskId, mode?})。省略 mode 保留旧行为(acceptEdits,仅限未开始执行的任务);mode: auto 请求宿主原生确认,仅为空闲自有任务启用 Auto,不写插件默认卡。插件不能替用户确认,该写权限请求接口不接受 Full access;新任务可经已批准的创建接口选择完全访问。拒绝不改状态;账号、插件批准或任务版本在确认期间改变则拒绝写入。Auto 插件主任务的 Worker 固定使用 Auto,不继承或改写全局 Worker 偏好;授权撤销后拒绝新建。Host 读取该次权限时一并保留账号与插件来源,在团队查询、Worker 准备/启动、落盘后以及首条输入的 accepted 回调中复核;在途卸载、重装、归属消失或降权不能将本次创建降为普通 Orca。调用开始前已明确撤销的旧用户任务仍可新发起普通 Orca。首条输入(任务或就绪消息)真正接收时沿现有回调再次复核;任务接收生命周期的异步更新前后均检查,失败回滚本次临时运行态并取消派发。直发拒绝后,在派发调用退出后才沿原生命周期清理新 Worker;排队后迟到的拒绝仅取消该输入并回滚本次临时状态,保留 Worker 和用户数据。既有内存回调不构成跨重启的授权事务,也不保证中断已接收执行。失败沿原生命周期尽力清理,不保证跨账号数据库补偿或跨进程事务。独立目录不是沙箱。返回 granted 与更新后的 task/revision,插件应继续原批次。
### 主任务协调评测
插件拥有的主任务通过公共 `start_team` 显式请求 Worker Full access 时,Host 在原确认入口前复用当前插件归属与 Auto 判据,直接返回 PERMISSION_DENIED,不弹确认、不更新全局偏好或创建团队。Auto/省略参数和普通用户任务的 Full access 确认保持原流程;已撤权任务仍按当前接受输入的来源判定,旧插件执行不会变成普通用户调用。
-Worker 创建后至首条输入真正接受,继续核对实际解析的目录与模型路由;落盘、创建预留释放、Lead 激活和排队接收不会结束这次校验。异步来源/计划读取后同步复核当前目录授权,配置目录被取消或 picker 记录淘汰不能借旧检查放行。复用原创建失败补偿;排队后迟到拒绝只取消该输入,不删除已创建的 Worker。回调仅在 Host 内传递,不进入任务回执或 IPC 返回值。
+Worker 创建后至首条输入真正接受,继续核对实际解析的目录与模型路由;落盘、创建预留释放、Lead 激活和排队接收不会结束这次校验。异步来源/计划读取后同步复核当前目录授权,Lead 工作目录变化或 picker 记录淘汰不能借旧检查放行。复用原创建失败补偿;排队后迟到拒绝只取消该输入,不删除已创建的 Worker。回调仅在 Host 内传递,不进入任务回执或 IPC 返回值。
模型调用的暂停 Worker、归档、结束团队与切换焦点,也复用当前输入来源和插件权限检查;关闭、归档及既有目录锁等待后的写入前复核。原有延后完成确认保存同次调用的核验回调,消费一次后不重登记;独立用户确认不继承模型限制。用户 UI/远程控制的停止清理及内部失败补偿保持原入口。多步清理途中拒绝可能已有局部效果,不构成跨工具授权事务,也不保证停止已接受的原生执行。
@@ -279,11 +280,11 @@ Worker 创建后至首条输入真正接受,继续核对实际解析的目录
首次协同计划检查落盘 user 消息与任务开始/结束时间;清空或回退对话不会抹除执行事实。目录核验到保存复用普通发送锁,同计划重放仍保持幂等。
-`tasks.startTeam({taskId})` 为本插件拥有的普通任务启用 Orca Lead,复用现有协同入口及 Worker 权限确认。插件不能指定 Worker 权限绕过确认。确认返回后检查原修订;团队查询、创建和 Lead 激活后复用同一准入回调,核对原账号、插件归属/批准、当前 Auto/Plan、任务路由与目录以及插件配置目录。正常成为 Lead 会改变包含角色的修订,原生阶段改比这些准入事实,不把本次角色变化误判为用户变更。`tasks.getTeam({taskId})` 只投影所属团队的 Worker 身份、实际模型配置、目录、队列和终态;不会将 Lead 一轮完成解释为整个团队完成。
+`tasks.startTeam({taskId})` 为本插件拥有的普通任务启用 Orca Lead,复用现有协同入口及 Worker 权限确认。插件不能指定 Worker 权限绕过确认。确认返回后检查原修订;团队查询、创建和 Lead 激活后复用同一准入回调,核对原账号、插件归属/批准、当前 Auto/Plan、任务路由与目录。默认卡不参与协作准入。正常成为 Lead 会改变包含角色的修订,原生阶段改比这些准入事实,不把本次角色变化误判为用户变更。`tasks.getTeam({taskId})` 只投影所属团队的 Worker 身份、实际模型配置、目录、队列和终态;不会将 Lead 一轮完成解释为整个团队完成。
-协同启动要求任务仍为 active;创建或激活中的归档、撤权、降权及配置变化会拒绝本次调用。新建团队沿原 lifecycle 补偿标为 failed,清理 Lead 角色及运行态选项,不删除任务或成果;复用已有团队时只拒绝本次调用,不结束原团队。检查与尽力补偿均处于原生操作的 drain 跟踪内;存储补偿失败仍返回失败,不保证跨账号数据库补偿,也不宣称最终复核与后续跨进程归档形成事务。
+协同启动要求任务仍为 active;创建或激活中的归档、能力撤回、任务降权及任务配置变化会拒绝本次调用;默认卡变动不影响已有任务。新建团队沿原 lifecycle 补偿标为 failed,清理 Lead 角色及运行态选项,不删除任务或成果;复用已有团队时只拒绝本次调用,不结束原团队。检查与尽力补偿均处于原生操作的 drain 跟踪内;存储补偿失败仍返回失败,不保证跨账号数据库补偿,也不宣称最终复核与后续跨进程归档形成事务。
-插件可读取自己任务在权限变化后的状态与执行停止,但新发送拒绝超出插件策略的 full access 任务。任务快照同时返回独立的 planModeEnabled 与原 permissionMode;独立 Plan Mode 开启时拒绝新发送、排队接受、写权限请求及 Worker/团队启动,不以原 Auto/AcceptEdits 作为执行授权。普通 permissionMode 为 plan 的既有流程保持不变。既有普通任务的所有权收据在成为 Lead 后继续有效;Worker 不是插件直接控制的普通任务。
+插件可读取自己任务在权限变化后的状态与执行停止;新发送按该 Session 当前权限运行,不与默认卡比较。任务快照同时返回独立的 planModeEnabled 与原 permissionMode;独立 Plan Mode 开启时拒绝新发送、排队接受、写权限请求及 Worker/团队启动,不以原 Auto/AcceptEdits 作为执行授权。普通 permissionMode 为 plan 的既有流程保持不变。既有普通任务的所有权收据在成为 Lead 后继续有效;Worker 不是插件直接控制的普通任务。
评测客户端每批仅创建一个 Lead,答案目录逐份隔离,由 Lead 使用原生 Orca 调度。插件根据 Worker 成员、配置、目录、done 且无活动/队列的状态独立验收。该投影不是逐轮执行账本,不作为精确费用证据。重试先核对既有 Worker;未知归属不得重派或算零分。停止须确认 Lead 停止处理完成和团队不再活动。
@@ -293,7 +294,7 @@ getTeam 的 completedAt 可由宿主落盘的 turnCompleted 终态恢复:仅
`setTeamPlan({taskId,plan:{concurrency,items}})` 在本插件自己的创建收据中冻结计划。首次登记必须早于输入派发和 Worker 创建(包括创建预留);同一计划的幂等重放不受此限制。每项含唯一 label、workingDir 和精确 route;重复设置必须一致。未登记计划的存量任务保留读取、停止和已有成果,但不能据此取得委派 Auto 自动授权。Worker 创建复用原子 reservation,预留后再次核对计划,计划上限只可收窄宿主硬上限。已结算 label 持久保留,不因归档再次变成可派发项。
-计划保存目录准入返回的 canonical 路径,后续别名改链不会把冻结计划改成新目标;这不构成 OS 目录对象隔离。首版仅用于可信本地工作区,不防御同权限进程在最后校验后、harness 使用 cwd 前恶意替换目录对象;路径复核或 JS 锁不能消除该窗口,不把另建 OS 隔离后端列为本接口的发布前提。插件归属、显式撤权、用户降权与任务范围的检查仍须成立。`getTeam` 先恢复 Lead 的持久输入队列,恢复失败或未确认时拒绝返回空闲;最终读取实时 Lead 状态,不以启动后的空内存队列报告批次完成。
+目录准入仅使用当前 Lead 工作目录及其子目录或用户亲选的确切目录,不把默认卡目录当作额外授权根。计划保存目录准入返回的 canonical 路径,后续别名改链不会把冻结计划改成新目标;这不构成 OS 目录对象隔离。首版仅用于可信本地工作区,不防御同权限进程在最后校验后、harness 使用 cwd 前恶意替换目录对象;路径复核或 JS 锁不能消除该窗口,不把另建 OS 隔离后端列为本接口的发布前提。插件归属、显式撤权、用户降权与任务范围的检查仍须成立。`getTeam` 先恢复 Lead 的持久输入队列,恢复失败或未确认时拒绝返回空闲;最终读取实时 Lead 状态,不以启动后的空内存队列报告批次完成。
`releaseWorker({taskId,workerId,completedAt})` 仅释放本插件 Lead 内、结束时间仍匹配、无活动/排队输入的 Worker。它与 getTeam 共用宿主成功终态判据,不能以 Worker 更新时间或失败轮结束时间替代交卷凭据。调用方应先保存交卷快照和评分。复用 Orca 的归档路径、transition 锁和发送锁;持锁后再次核对 completedAt 与归属。有计划时必须在归档前确认标签归属;无计划的兼容调用不写标签结算。已有发送锁时直接拒绝释放,不等待而形成锁反转;只有归档成功才结算 label。拒绝正在发送或运行的 Worker,保留任务历史与作答文件。
@@ -318,7 +319,7 @@ Host 只接受经绑定插件身份写入的自有创建收据;已登记计划
已识别插件任务的协调任务或 Worker 缺少有效范围时返回既有 authorizationError,在缓存、本地安全动作或 Host MCP 快捷路径之前拒绝自动授权;不退回普通任务、不从消息补造范围。旧计划继续可读,不事后补填;新范围须在新任务中登记完整计划。Ask/acceptEdits 保留既有逐次人工确认,普通无插件归属任务不受此限制。
没有新增权限档位、没有提升到 Full access。
-审批在查询缓存前重新核对插件批准版本、启用状态、Auto 设置、账号 epoch、任务状态、
+审批在查询缓存前重新核对插件批准版本、启用状态、任务/Lead 的 Auto 权限、账号 epoch、任务状态、
团队归属和计划匹配;异步结果返回前再次核对。
历史投影和归属读取完成后,以同一条只读 SQL 比较本次使用的任务/Lead 权限、独立 Plan、状态、路由目录、团队链接及计划收据,并复核授权投影修订号仍与读取值一致、投影已同步且版本为 3;变化拒绝本次授权,查询失败保留 unavailable。该检查同时覆盖 Lead 和 Worker 的真人证据变化,不只检查当前 Worker 的意图。Lead 或 Worker 已开启独立 Plan 时不恢复委派 Auto。
Worker 别名目录的异步解析在该次归属和最终授权核验之前完成;核验后只同步消费本次目录匹配结果,不再等待文件系统读取。该结果不写入回执,也不替代可信本地工作区边界。
@@ -357,7 +358,7 @@ Pi 子代理未成功投递的自动 allow 再次投递前重走现有核验,
- `resolve({target:{kind,id}})` 返回最新目标元数据,供插件校验保存的固定目标;无写入、弹窗或隐式选中。
`send` 同样重新校验目标,不要求先 list/resolve,也不接受任意不可用路径或目标;失效返回 TARGET_UNAVAILABLE,不降级改投。
- `send({target,requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})` 在指定项目中新建普通任务,或向指定普通任务/伙伴投递。
- 新任务经现有 `PluginTaskService.create` 登记归属后使用 `createPluginTaskSession`,沿用插件模型选择、受限动手权限及卸载撤销流程,可传统一模型目录的 route,以及当前授权范围内的 permissionMode。
+ 新任务经现有 `PluginTaskService.create` 登记归属后使用 `createPluginTaskSession`,使用显式参数或有效默认配置,保留能力批准及卸载撤销流程;可传统一模型目录的 route 与 permissionMode。
存量任务和伙伴保留其模型、权限、目录,不接受 route 或 permissionMode;伙伴通过唯一 canonical 注册解析,不使用兼容镜像或伪造伙伴身份。
- 同键并发发送共享同一 Promise。回执复用当前账号 SQLite 的 `plugin_task_requests`,以 `operation=target` 按插件和请求键读写单行;只保存请求摘要、Host 生成的 taskId/clientId、批准修订和状态,
不保存正文、图片或插件固定配置。执行前原子预留回执;已接受请求可在重启后返回原结果,尚未确定的回执返回 DELIVERY_UNCERTAIN,
diff --git a/packages/plugin-protocol/src/manifest.ts b/packages/plugin-protocol/src/manifest.ts
index be6c9f2d61..4fde3f5ea3 100644
--- a/packages/plugin-protocol/src/manifest.ts
+++ b/packages/plugin-protocol/src/manifest.ts
@@ -960,7 +960,7 @@ export interface GhostManifest {
* 页用它避免抖动)。须与 settingsHtml 成对声明。
*/
settingsHeight?: number;
- /** 是否显示宿主「模型与任务」默认配置卡;缺省或 true 显示,false 仅隐藏卡片。 */
+ /** 本插件是否使用宿主默认配置卡;缺省/true 启用,false 隐藏且不读取该插件的卡片配置。 */
showTaskPreferences?: boolean;
/** 仅 schemaVersion 2 存在的兼容声明。 */
slots?: LegacyGhostSlot[];