Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(permissions): 明确媒体路径揭示效果与当前审批流程
Dashf76e9e564de8
diff --git a/docs/dev-rules/media-storage-and-protocols.md b/docs/dev-rules/media-storage-and-protocols.mdindex c9ff35168c..d7f6cbabed 100644--- a/docs/dev-rules/media-storage-and-protocols.md+++ b/docs/dev-rules/media-storage-and-protocols.md@@ -156,9 +156,14 @@- 默认不把媒体仓绝对路径直接暴露给 Renderer、插件或远端。跨边界传递使用托管 URL、受控 grant/deposit/ledger,或已有上传与远程媒体服务。- 唯一的路径揭示例外是:用户明确询问某个受管媒体地址在本机的存储位置时,Host 先用- 安全解析器核验为现存普通文件。Auto 档对精确单文件路径和用户请求进行 AI 审阅;- allow 可返回当前 Agent,block 返回原因,ask 或服务故障才使用 Host-owned 确认卡。- 其它档位仍须用户点击允许。路径进入会话记录,因此也可能同步到用户的配对设备。+ 安全解析器核验为现存普通文件。Auto 档沿用实时审批负责人:原生审批已审核受管 URL+ 及“向 Agent 返回该媒体的本机绝对路径并写入任务记录”这一效果时,不因安全解析而再调+ Cindy 复审;这里仍是同一受管资源,不是符号链接暴露出的新文件目标。由 Cindy 负责时,+ 对精确单文件路径和用户请求进行 AI 审阅。工具说明必须写明真实效果和当前权限流程,+ 不得以“之后一定弹确认卡”误导审批。Cindy 审阅 allow 可返回当前 Agent,block 返回原因,+ ask 或服务故障才使用 Host-owned 确认卡。本地活跃 Full Access 自动允许,+ 其它档位仍须用户点击允许;远程任务不能借此自动取得控制端文件路径。+ 路径进入会话记录,因此也可能同步到用户的配对设备。Agent 自报“用户已同意”不是授权证据,也不能借路径揭示给插件或远端开放文件读取。- `xdt-image://`、`xdt-video://`、`xdt-model://` 和 `userData/cc-agent/` 是冻结的历史兼容层。可以读取已有地址,不得新增写入路径、扩展生命周期或把新功能接回旧仓。diff --git a/packages/cindy-tools/src/ghost/mcpServer.ts b/packages/cindy-tools/src/ghost/mcpServer.tsindex 0fb5e99a1c..0f8da63591 100644--- a/packages/cindy-tools/src/ghost/mcpServer.ts+++ b/packages/cindy-tools/src/ghost/mcpServer.ts@@ -117,7 +117,7 @@ const D_MEDIA = ["插件已返回用户配置的 model_id/provider_id 时必须原样传给 prepare,再按目标 capability 走 prepare → request;provider_id 用于区分不同 Provider 下的同名模型。没有已配置模型时,先用 list_models 查询。Gateway 模型的 prepare 会由 Server 根据 model_id 返回 Guide,并在 Guide 不存在或不支持该 capability 时明确报错。","异步任务的 request 返回 pending 时,再按 recommended_poll_after_ms 调 poll;同步任务会直接返回 xdt_image_urls / xdt_video_urls。","Core 图片完成结果由当前 Agent 控制呈现:在最终回复中用返回的受管地址只嵌入展示一次,不要同时重复口播或再次附同一图片。",- "展示、改图和附件交接都直接使用 cindy-media:// / xdt-image:// / xdt-video:// 受管地址,不需要本地路径。仅当用户明确询问文件存储位置或本地路径时,才调用 resolve_local_path 并原样传入 url;Host 会要求用户点击确认后才返回路径。不要猜路径或扫描磁盘。",+ "展示、改图和附件交接都直接使用 cindy-media:// / xdt-image:// / xdt-video:// 受管地址,不需要本地路径。仅当用户明确询问文件存储位置或本地路径时,才调用 resolve_local_path 并原样传入 url;此调用会把该受管媒体的本机绝对路径返回给 Agent 并写入任务记录。Host 按当前权限处理:Ask 需点击确认,Auto 由当前审批负责人审核,本地 Full Access 自动允许。不要假定稍后还会有确认卡;不要猜路径或扫描磁盘。","模型 id、endpoint、Authorization 和 wire model 均由 Host 管理,不要写进 body,不要猜测或覆盖。","Guide 缺失、能力不匹配或当前客户端不支持协议时,结果会带稳定 errorCode、retryable、outcomeKnown 和 allowedActions;可按 allowedActions 换模型、改用其它已授权工具或仍存在的旧链路,不要把 INTERNAL 当成协议能力结论。","prepare 返回的 invocation_id 是一次性付费提交令牌;request 超时或返回 SUBMISSION_OUTCOME_UNKNOWN 时不要自动重提,以免重复扣费。",@@ -1382,7 +1382,7 @@ export function createCindyGhostsMcpServer(.string().max(4096).optional()- .describe("resolve_local_path 时必填;原样传入 cindy-media://、xdt-image:// 或 xdt-video:// 受管地址。仅在用户明确询问本地存储路径时使用,Host 会要求用户点击确认"),+ .describe("resolve_local_path 时必填;原样传入 cindy-media://、xdt-image:// 或 xdt-video:// 受管地址。调用会向 Agent 返回该媒体的本机绝对路径并写入任务记录,仅在用户明确询问时使用;按当前权限审核,不保证另有确认卡"),invocation_id: z.string().max(128)