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。

Merge origin/main into fix/shared-provider-concurrent-consent

fmfsaisaif3d07efd5d7f
diff --cc apps/desktop/src/main/remote-agent/controller/startRemote.ts
index 001b6a1d66,8030243d37..21a66d6243
--- a/apps/desktop/src/main/remote-agent/controller/startRemote.ts
+++ b/apps/desktop/src/main/remote-agent/controller/startRemote.ts
@@@ -244,9 -240,7 +248,10 @@@ export async function startRemoteAgentS
? {
confirm: async (action: ExecutorAction) =>
controller?.confirm(credentialConfirmation(action, credentialConsent.description)) ?? false,
+ gitCredentials: sharedGitCredentials,
+ ...(grant
+ ? { credentialGrant: { remember: () => grant.remember(grantPermission()), forget: () => grant.forget() } }
+ : {}),
}
: {}),
});
diff --cc apps/desktop/src/main/remote-agent/credentials.ts
index 87155a21c2,fd112286b1..7865b62c36
--- a/apps/desktop/src/main/remote-agent/credentials.ts
+++ b/apps/desktop/src/main/remote-agent/credentials.ts
@@@ -3,14 -3,27 +3,27 @@@
*
* 受邀者任务的对话与 Agent 读到的文件内容会经过分享者的电脑。凭证类文件(密钥、.env、云与工具的
* 登录凭证)不论权限档,都要受邀者在本机确认后才发出:启动时不随项目说明同步,任务中读取时弹确认卡,
- * 可明确允许当前任务后续的凭证操作;关闭、重新打开任务或切换权限档后恢复确认
+ * 可明确允许当前任务后续的凭证操作;切换权限档或退出应用后恢复确认
* (docs/product-rules/provider-sharing.md §9 第 7 条)。
*
- * 规则沿用本机任务的凭证规则(isSensitiveCredentialPath),只有一处不同:Claude Code / Codex 配置目录里
- * 的说明类内容(Skill、子代理、命令、规则、个人说明)不算凭证。本机规则把整个配置目录算作敏感,是为了
- * 保护里面的登录与设置,不是这些说明文字;不放开的话,个人 Skill 的每个参考文件都要确认。
+ * 规则沿用本机任务的凭证规则(isSensitiveCredentialPath),以下几处不同,都只在这里生效,本机任务不变:
+ * - Claude Code / Codex 配置目录里的说明类内容(Skill、子代理、命令、规则、个人说明)不算凭证。本机规则
+ * 把整个配置目录算作敏感,是为了保护里面的登录与设置,不是这些说明文字;不放开的话,个人 Skill 的
+ * 每个参考文件都要确认;
+ * - 按惯例不含密钥的 .env 模板(.env.example / .env.sample / .env.template)与公钥(*.pub)不算凭证,
+ * 所在目录本身是凭证目录(~/.ssh 等)时照旧算;
+ * - rg -g、grep --include 这类只选中源码与文档扩展名的搜索不算读取凭证;
+ * - git 查看内容又没有限定到具体文件的命令、会打出 git 配置的命令交给执行器在本机核实
+ * (executor/gitCredentials.ts);
+ * - 再收紧:命令里直接写着密钥(带密码的地址、令牌、私钥)、用 `<提交>:<路径>` 写出凭证类文件、
+ * git credential fill 这类打出保存的凭证的命令也要确认。
*/
- import { isSensitiveCredentialPath, shellCommandReadsCredentials } from '@cindy/maker-core';
+ import {
+ isSensitiveCredentialPath,
+ shellCommandReadsCredentials,
+ type CredentialCommandOptions,
+ type GitRead,
+ } from '@cindy/maker-core';
/** 配置目录里的说明类子路径:`/.claude/skills/…`、`/.codex/AGENTS.md` 等(两种分隔符都认)。 */
const CONFIG_INSTRUCTION_SEGMENT =
diff --cc apps/desktop/src/main/remote-agent/executor/__tests__/executor.test.ts
index 4df34ed54c,3d6a9deb49..fa8222b06f
--- a/apps/desktop/src/main/remote-agent/executor/__tests__/executor.test.ts
+++ b/apps/desktop/src/main/remote-agent/executor/__tests__/executor.test.ts
@@@ -5,9 -6,10 +6,10 @@@ import path from 'node:path'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { handleExecMcpRequest } from '../ccMcp';
-import { RemoteExecutor, type ExecutorConfirmation } from '../executor';
+import { RemoteExecutor, type ExecutorConfirmation, type RemoteExecutorOptions } from '../executor';
import { EXECUTOR_APPROVAL_TTL_MS, ExecutorGate, executorGateModeFor, type ExecutorAction } from '../gate';
import type { PdfTextExtractor } from '../files';
+ import type { GitCredentialHistory } from '../gitCredentials';
import { findWindowsGitBash, truncateOutput } from '../shell';
import type { GuardedFetch } from '../webFetch';
import { ExecutorWorkspace } from '../workspace';
@@@ -581,7 -598,7 +598,8 @@@ describe('shared provider credentials'
function sharedExecutor(
mode: ReturnType<typeof executorGateModeFor>,
confirm?: (action: ExecutorAction) => Promise<ExecutorConfirmation>,
+ gitCredentials?: GitCredentialHistory,
+ credentialGrant?: RemoteExecutorOptions['credentialGrant'],
) {
const workspace = new ExecutorWorkspace({ workingDir: project });
const gate = new ExecutorGate(workspace, mode, Date.now, { confirmCredentials: true });
@@@ -591,42 -608,38 +609,70 @@@
rgPath: RG,
tempDir: path.join(root, 'tmp'),
...(confirm ? { confirm } : {}),
+ ...(gitCredentials ? { gitCredentials } : {}),
+ ...(credentialGrant ? { credentialGrant } : {}),
});
return { executor, gate, workspace };
}
+ it('records only an explicit task-level grant and clears it when the permission mode changes', async () => {
+ const env: ExecutorAction = { kind: 'exec', command: 'cat .env', cwd: project };
+ for (const answer of [true, false, 'session'] as const) {
+ const credentialGrant = { remember: vi.fn(), forget: vi.fn() };
- const { executor } = sharedExecutor('normal', async () => answer, credentialGrant);
++ const { executor } = sharedExecutor('normal', async () => answer, undefined, credentialGrant);
+ try {
+ expect(await executor.confirm(env)).toBe(answer !== false);
+ if (answer === 'session') expect(credentialGrant.remember).toHaveBeenCalledTimes(1);
+ else expect(credentialGrant.remember).not.toHaveBeenCalled();
+ executor.setGateMode('full');
+ expect(credentialGrant.forget).toHaveBeenCalledTimes(1);
+ } finally {
+ await executor.close();
+ }
+ }
+ // 卡片回答前请求被取消:不记录。
+ let answer!: (result: ExecutorConfirmation) => void;
+ const credentialGrant = { remember: vi.fn(), forget: vi.fn() };
- const { executor } = sharedExecutor('full', () => new Promise((resolve) => { answer = resolve; }), credentialGrant);
++ const { executor } = sharedExecutor('full', () => new Promise((resolve) => { answer = resolve; }), undefined, credentialGrant);
+ const abort = new AbortController();
+ try {
+ const pending = executor.confirm(env, abort.signal);
+ abort.abort();
+ answer('session');
+ expect(await pending).toBe(false);
+ expect(credentialGrant.remember).not.toHaveBeenCalled();
+ } finally {
+ await executor.close();
+ }
+ });
+
+ it.runIf(posix)('keeps source-filter searches from following a link into credentials without consent', async () => {
+ fs.writeFileSync(path.join(project, '.env'), 'PRIVATE_FIXTURE=followed-link');
+ fs.symlinkSync('.env', path.join(project, 'safe.ts'));
+ const output = execFileSync(RG, ['--follow', '-g', '*.ts', 'PRIVATE_FIXTURE', '.'], { cwd: project, encoding: 'utf8' });
+ expect(output).toContain('PRIVATE_FIXTURE=followed-link');
+ const asked = vi.fn(async () => false);
+ const { gate, executor } = sharedExecutor('full', asked);
+ try {
+ const safe: ExecutorAction = { kind: 'exec', command: "rg -g '*.ts' PRIVATE_FIXTURE .", cwd: project };
+ expect(gate.authorize(safe).ok).toBe(true);
+ for (const command of [
+ "rg --follow -g '*.ts' PRIVATE_FIXTURE .",
+ "rg -nL -g '*.ts' PRIVATE_FIXTURE .",
+ "grep -R --include='*.ts' PRIVATE_FIXTURE .",
+ "grep --dereference-r --include='*.ts' PRIVATE_FIXTURE .",
+ ]) {
+ const action: ExecutorAction = { kind: 'exec', command, cwd: project };
+ expect(gate.authorize(action).ok, command).toBe(false);
+ expect(await executor.confirm(action), command).toBe(false);
+ expect(gate.authorize(action).ok, command).toBe(false);
+ }
+ expect(asked).toHaveBeenCalledTimes(4);
+ } finally {
+ await executor.close();
+ }
+ });
+
it('holds credential reads, writes and commands even with full access, and nothing else', () => {
const { gate, workspace } = sharedExecutor('full');
const secret = path.join(os.homedir(), '.ssh', 'id_rsa');
@@@ -969,6 -950,56 +1139,79 @@@
}
});
+ it('lets git commands run without asking once this computer has checked they cannot show credentials', async () => {
+ const asked: ExecutorAction[] = [];
+ const checked: string[] = [];
+ let safe = true;
+ const gitCredentials = {
+ provesSafe: async (command: string) => {
+ checked.push(command);
+ return safe;
+ },
+ } as unknown as GitCredentialHistory;
+ const { executor, gate } = sharedExecutor('full', async (action) => {
+ asked.push(action);
+ return false;
+ }, gitCredentials);
+ const log: ExecutorAction = { kind: 'exec', command: 'git log -p', cwd: project };
+ expect(gate.authorize(log).ok).toBe(false);
+ expect(await executor.confirm(log)).toBe(true);
+ expect(gate.authorize(log).ok).toBe(true);
+ expect(asked).toEqual([]);
+ // 核实不了时照旧问;命令还读别的凭证、或打出保存的凭证时不交给核实。
+ safe = false;
+ expect(await executor.confirm(log)).toBe(false);
+ expect(asked).toEqual([log]);
+ const withEnv: ExecutorAction = { kind: 'exec', command: 'git log -p && cat .env', cwd: project };
+ const fill: ExecutorAction = { kind: 'exec', command: 'git credential fill', cwd: project };
+ expect(await executor.confirm(withEnv)).toBe(false);
+ expect(await executor.confirm(fill)).toBe(false);
+ expect(asked).toEqual([log, withEnv, fill]);
+ expect(checked).toEqual(['git log -p', 'git log -p']);
+ });
+
+ it('does not let a safe git credential check satisfy plan-mode command approval', async () => {
+ const gitCredentials = {
+ provesSafe: async () => true,
+ } as unknown as GitCredentialHistory;
+ const asked = vi.fn(async (): Promise<ExecutorConfirmation> => false);
+ const { executor, gate } = sharedExecutor('plan', asked, gitCredentials);
+ const action: ExecutorAction = { kind: 'exec', command: 'git remote show origin', cwd: project };
+ try {
+ expect(gate.authorize(action).ok).toBe(false);
+ expect(await executor.confirm(action)).toBe(true);
+ expect(gate.authorize(action).ok).toBe(false);
+ expect(asked).not.toHaveBeenCalled();
+ gate.recordApproval(action);
+ expect(gate.authorize(action).ok).toBe(true);
+ } finally {
+ await executor.close();
+ }
+ });
+
++ it('does not queue a verified git command behind an unanswered credential card', async () => {
++ const gitCredentials = {
++ provesSafe: async () => true,
++ } as unknown as GitCredentialHistory;
++ let answer!: (result: ExecutorConfirmation) => void;
++ const asked = vi.fn(() => new Promise<ExecutorConfirmation>((resolve) => { answer = resolve; }));
++ const { executor } = sharedExecutor('full', asked, gitCredentials);
++ const env: ExecutorAction = { kind: 'exec', command: 'cat .env', cwd: project };
++ const git: ExecutorAction = { kind: 'exec', command: 'git remote show origin', cwd: project };
++ const pending = executor.confirm(env);
++ try {
++ expect(await executor.confirm(git)).toBe(true);
++ expect(asked).toHaveBeenCalledTimes(1);
++ expect(asked).toHaveBeenCalledWith(env);
++ answer(true);
++ expect(await pending).toBe(true);
++ } finally {
++ await executor.close();
++ answer(false);
++ await pending;
++ }
++ });
++
it('leaves credential files out of Pi searches unless the searched path itself was allowed', async () => {
const { executor } = sharedExecutor('full', async () => true);
fs.writeFileSync(path.join(project, '.env'), 'API_KEY=secret\n');
diff --cc apps/desktop/src/main/remote-agent/executor/executor.ts
index dc0146cd14,0630200713..8dd059e5f9
--- a/apps/desktop/src/main/remote-agent/executor/executor.ts
+++ b/apps/desktop/src/main/remote-agent/executor/executor.ts
@@@ -65,11 -66,8 +66,13 @@@ export interface RemoteExecutorOptions
* 默认只放行这一个操作;用户明确选择会话级允许后免除后续的分享凭证确认。缺省时直接拒绝。
*/
confirm?(action: ExecutorAction): Promise<ExecutorConfirmation>;
+ /** 与 confirm 一起提供:git 查看内容、打出 git 配置的命令先在本机核实,读不到凭证时不弹卡。 */
+ gitCredentials?: GitCredentialHistory;
+ /**
+ * 「本任务总是允许」的任务级记录(credentialGrants.ts,由启动方按当前原始权限档写入):Agent 实例被系统
+ * 回收重建后据此恢复;缺省时只在本执行器内有效。
+ */
+ credentialGrant?: { remember(): void; forget(): void };
}
export class ExecutorRequestError extends Error {
@@@ -160,51 -156,42 +163,70 @@@ export class RemoteExecutor
/**
* 凭证类操作在本机补问一次(供应商分享的受邀者任务);本机用户允许后登记批准,调用方再检查一次即可
- * 放行。不是凭证类、没有确认通道或任务已结束时返回 false。
+ * 放行。git 查看内容、打出 git 配置的命令在本机核实过读不到凭证时不弹卡,直接登记批准。不是凭证类、
+ * 没有确认通道或任务已结束时返回 false。
*/
async confirm(action: ExecutorAction, signal?: AbortSignal): Promise<boolean> {
- if (this.closed || !this.opts.confirm || !this.gate.needsCredentialConsent(action)) return false;
+ if (this.closed || signal?.aborted || !this.opts.confirm || !this.gate.needsCredentialConsent(action)) return false;
const permissionGeneration = this.permissionGeneration;
- // 只有要核实的 git 命令才在弹卡前等核实结果,其余操作照旧立即弹卡。
++ // 只有要核实的 git 命令才在弹卡前等核实结果;核实通过不弹卡,也不必排在其他确认卡后面。
+ const gitCheck = this.gitReadsCheck(action, signal);
+ if (gitCheck && await gitCheck) {
+ // 核实期间任务结束、请求被取消或权限已切换:同样不放行。
+ if (this.closed || signal?.aborted || permissionGeneration !== this.permissionGeneration) return false;
+ this.gate.recordCredentialExemption(action);
+ return true;
+ }
- const allowed = await this.opts.confirm(action).catch(() => false);
- // 等确认期间任务结束、请求被取消或权限已切换:不接受旧确认。
- if ((allowed !== true && allowed !== 'session') || this.closed || signal?.aborted
- || permissionGeneration !== this.permissionGeneration) return false;
- if (allowed === 'session') {
- this.gate.allowCredentialsForSession();
- if (this.gate.getMode() === 'full') return true;
+ // 同一任务可能并行调用工具。只排队确认,不排队执行;前一张卡建立任务授权后,
+ // 后续请求重新检查,避免已经弹出的多张卡仍逐一等待用户回答。
+ // 排队位置要等前一个位置放行、且自己的卡处理完才放行。
+ const previous = this.credentialConfirmationTail;
+ let settle!: () => void;
+ const settled = new Promise<void>((resolve) => { settle = resolve; });
+ const slot = previous ? previous.then(() => settled) : settled;
+ this.credentialConfirmationTail = slot;
+ // 自己的请求取消后立即让出:还在排队就不再等(后面的请求仍等前一张卡);
+ // 卡已弹出就不再挡住后面的请求,这张卡之后的回答会被丢弃。
+ let onAbort: (() => void) | undefined;
+ const aborted = new Promise<void>((resolve) => {
+ onAbort = () => { settle(); resolve(); };
+ signal?.addEventListener('abort', onAbort, { once: true });
+ });
+ try {
+ if (previous) await Promise.race([previous, aborted]);
+ if (this.closed || signal?.aborted || permissionGeneration !== this.permissionGeneration) return false;
+ // 调用方仍会重新检查普通权限上限;这里只免除已授权的分享凭证确认。
+ if (!this.gate.needsCredentialConsent(action)) return true;
+ const allowed = await this.opts.confirm(action).catch(() => false);
+ // 等确认期间任务结束、请求被取消或权限已切换:不接受旧确认。
+ if ((allowed !== true && allowed !== 'session') || this.closed || signal?.aborted
+ || permissionGeneration !== this.permissionGeneration) return false;
+ if (allowed === 'session') {
+ this.gate.allowCredentialsForSession();
+ this.opts.credentialGrant?.remember();
+ if (this.gate.getMode() === 'full') return true;
+ }
+ this.gate.recordApproval(action);
+ return true;
+ } finally {
+ if (onAbort) signal?.removeEventListener('abort', onAbort);
+ settle();
+ void slot.then(() => {
+ if (this.credentialConfirmationTail === slot) this.credentialConfirmationTail = undefined;
+ });
}
- this.gate.recordApproval(action);
- return true;
}
+ /** 要在本机核实的 git 命令返回核实结果(true = 读不到凭证);不需要核实的返回 null。 */
+ private gitReadsCheck(action: ExecutorAction, signal?: AbortSignal): Promise<boolean> | null {
+ const history = this.opts.gitCredentials;
+ if (!history || action.kind !== 'exec') return null;
+ const reads = this.gate.credentialGitReads(action);
+ return reads ? history.provesSafe(action.command, reads, signal)
+ .then((safe) => safe && this.gate.credentialGitReads(action) !== null)
+ .catch(() => false) : null;
+ }
+
/** 检查上限;凭证类操作没有批准时先在本机问一次。 */
private async decide(action: ExecutorAction, signal?: AbortSignal): Promise<ExecutorGateDecision> {
const decision = this.gate.authorize(action);
diff --cc docs/product-rules/provider-sharing.md
index 0236d4b7bf,eddfec8c80..51cdaaffa0
--- a/docs/product-rules/provider-sharing.md
+++ b/docs/product-rules/provider-sharing.md
@@@ -281,17 -281,102 +281,106 @@@ Desktop「设置 → 模型供应商」
Skill、子代理、命令与说明文字不算)不随项目说明与个人配置在启动时同步,链接按真实目标判断;
- 任务中读写凭证类文件、执行读取或打出凭证的命令,不论权限档(含完全访问)都要受邀者在本机确认卡上
允许,默认只放行这一次。确认卡同时提供「本任务总是允许」(2026-10-12 用户确认):受邀者明确选择后,
- 当前任务运行期间不再额外确认凭证操作,Pi 的搜索结果也可包含凭证内容;只在本机执行器内存里记住,
- 关闭、重新打开任务或切换权限档后恢复确认,不扩展到其他任务或供应商分享。原权限档的其他限制仍然生效,
+ 当前任务不再额外确认凭证操作,Pi 的搜索结果也可包含凭证内容。授权按「任务 + 分享」只记在本机
+ 主进程内存里(2026-10-13 用户裁决):Agent 实例被系统回收后重建(如 Orca Worker 一轮结束后释放进程)
+ 时,原始权限档与计划模式都和授权时相同才沿用(不按归并后的档位比,`default` 改 `ask` 也算变化);
+ 切换权限档或计划模式、退出应用后恢复确认,不扩展到其他任务或供应商分享。回收期间在 Desktop / 手机
+ 远控的权限入口切走又切回,同样作废。已知代价:归档后恢复的任务在本次应用运行期间沿用之前的授权;
+ 回收期间经 IM 切走又切回原档位不会被识别(最终档位与授权时相同)。原权限档的其他限制仍然生效,
启动同步仍排除凭证文件。确认卡说明内容会经过分享者或其安排的电脑,以及这项授权的范围与失效时机。
确认卡与 Agent 的确认走同一通道,手机远控与 IM 也能处理;
- - 命令只能按命令文本识别(脚本里读的、编码后再解开的认不出来),是防误发,不是防恶意。
+ - 命令只能按命令文本识别(脚本里读的、编码后再解开的认不出来),是防误发,不是防恶意;
+ - 减少误弹(2026-10-12 用户裁决)。**以下几条只用于这张分享任务的确认卡**,本机任务、同账号远程供应商与
+ 自动审查的判定都不变:
+ - `.env.example` / `.env.sample` / `.env.template` 与公钥 `*.pub` 按惯例不含密钥,不算凭证类文件
+ (读取、启动时同步都照普通文件);放在凭证目录里(如 `~/.ssh/id_rsa.pub`)时仍算。命令中读取
+ 文件时,执行前按该命令段的实际目录核对原始路径与链接的真实目标;模板、公钥与配置目录里的说明
+ 路径不能借链接指向凭证。目标不存在、链接断开、目录或展开认不出、前段可能改动链接或环境时,
+ 都保留确认,不用改写后的文件名或上次核实的链接目标放行;
+ - 按扩展名缩小范围的搜索不算读取凭证:rg 的 `-g '*.ts'`、grep 的 `--include='*.md'` 这类只选中源码
+ 与文档文件的写法,字面上能选中 `.env.ts`、`id_rsa.ts`,但这类名字是代码模块。直接写出像凭证的
+ 文件名、`*.json` / `*.txt` / `*.sh` 这类可能存放凭证的格式、扩展名不确定的写法(`*.ts*`)仍要确认。
+ 搜索启用跟随符号链接(如 rg 的 `--follow` / `-L`、grep 的 `-R` / `--dereference-recursive`)时,
+ 源码扩展名不能证明链接目标非敏感,保留确认;短选项组合与可接受的长选项缩写同样处理;
+ 宿主设置了 `RIPGREP_CONFIG_PATH`、命令里对它赋值时,也不能只凭源码扩展名豁免。
+ 配置可能注入跟随链接或其它扩大读取范围的选项;只在 rg 后第一个参数明确为 `--no-config` 时
+ 才继续按其它既有规则核实,不把搜索词、选项取值或 `--` 后的同名文本当成禁用配置的标志;
+ rg 命令出现预处理器 `--pre`(含分离、附着参数及可能的选项缩写)时,外部程序可以把本机凭证
+ 当成源码内容输出,源码扩展名不能证明结果非敏感,保留确认。无法完整解析的写法同样如此,
+ 不靠 `--no-config`、`--no-pre`、空值或限制预处理文件的 `--pre-glob` 抵销已出现的预处理器;
+ - git 查看内容的命令(`git diff`、`git show`、`git log -p`、`git grep`)只看命令文本时按可能读到
+ 提交进仓库的凭证处理,执行前先在受邀者电脑上核实,读不到凭证类文件就不弹卡:仓库所有分支、标签、
+ stash 与 reflog 的历史和暂存区里从没有凭证类文件;或命令用 `--` 限定的路径碰不到这些文件;或
+ (`git diff` / `git show` / `git log`)按原命令只列出会显示的文件,其中没有凭证类文件。认不出 git
+ 在哪个仓库里跑、仓库带子模块、比较仓库外的文件、核实超过 8 秒,都照旧弹卡;仓库的扫描结果留在
+ 内存里给后面的命令用。
+ 核实预算由整条命令共用:shell 启动状态、目录、所有内容与配置命令段共享同一 8 秒期限,
+ 本次查询子进程只使用剩余时间;文件状态检查不返回、取消或超过总期限时失败关闭,先弹确认。
+ 已开始的历史后台扫描仍按既有缓存流程继续,不影响确认卡及时出现;
+ 指定的对象必须能解析为提交且已在扫描范围内,否则改按实际显示的文件
+ 核对;无法证明为提交的底层对象(如 `git show <blob-id>`,含 `-s` / `--name-only` 等输出选项及隐式
+ `HEAD`)保留确认,不能按干净历史放行。所有
+ 历史与内容探针禁用 replacement refs;仓库有 `refs/replace` 或宿主设置了 `GIT_REPLACE_REF_BASE`
+ 时不授予内容豁免,避免探针与实际命令使用不同对象;
+ 仓库或生效配置中有 textconv / external diff 驱动、或继承了 `GIT_EXTERNAL_DIFF` 时不能只凭文件名
+ 豁免,除非能确定该调用已禁用相应驱动;历史与文件列表探针始终禁用这些外部 helper。
+ - 打出 git 配置的命令(`git remote -v` / `get-url` / `show -n`、读 `git config`、`git var -l`)按受邀者
+ 电脑上生效的 git 配置核实:要打出的那些项里没有密钥(地址里嵌的令牌或密码、`http.extraHeader`、
+ 密码与令牌类配置项)就不弹卡,有才确认;显式切换配置文件、blob 或配置作用域(含附着参数、短选项
+ 组合与长选项缩写)不授予豁免,以免核实的是另一套配置;带取值的选项与单键隐式读取也要核实,
+ 不能把选项的取值计入写配置的参数数目而绕过确认。只有确定的单键读取才缩小核实范围,查询模式、
+ 缩写或键名认不准时按全部配置核实,不能把正则查询的模式当成单个键名放行;
+ `git remote show` 没有在动作后明确用 `-n` 禁用远端查询时不授予豁免,避免 SSH / proxy 等传输
+ helper(含配置、继承环境及系统 SSH 设置)把本机凭证打印到 stdout / stderr;只核对地址不能证明安全。
+ - 上述 Git 核实仅用于命令段直接调用 PATH 中的裸 `git`,且沿用宿主环境、PATH 各项为绝对目录时。
+ 显式执行文件路径(如 `./git`)、`git.exe`、任何命令包装器(包括 `env`、`command`、`exec`),以及
+ 环境变量的赋值、移除或清空(含 PATH、加载器与 Git 配置来源)都无法与探针证明一致,照旧弹卡;
+ 宿主继承了 `BASH_ENV` / `ENV` / `ZDOTDIR` 或导出的 Bash 函数时,同样无法证明 shell 启动后仍调用
+ 探针使用的 Git,不授予内容与配置读取豁免;
+ shell 可执行文件本身也要核实:Bash 仅接受固定系统路径的二进制,以及 Windows 标准 Program Files
+ 安装目录里的 Git Bash(核实实际路径没有重定向)。自定义 Bash、Windows 显式 `CLAUDE_CODE_GIT_BASH_PATH`、
+ 未知安装目录或其他 shell 无法与探针证明一致,保留内容、配置和静态只读调用的凭证确认;
+ 实际执行器选择 zsh 时,即使没有 `ZDOTDIR`,也要核实系统级 `zshenv` 与 `HOME/.zshenv`(含各自
+ `.zwc` 缓存)均不存在;发现文件、核实文件状态失败或超时、HOME 不明确、或自定义 zsh 的启动目录
+ 无法核实,都保留确认。此核实每次执行前重做,不读取或运行启动脚本,不沿用仓库历史的缓存;
+ Git 内容读取前还要按当次生效的配置核实 `filter.<driver>.clean` / `.process`。标准 Git LFS
+ 配置 `filter.lfs.clean=git-lfs clean -- %f` 与 `filter.lfs.process=git-lfs filter-process`
+ 按正常工具使用,不因安装 LFS 就要求普通 Git 查看命令确认;其它非空过滤命令仍保留确认,
+ 探针不运行这些自定义过滤器。即使指定 `--no-textconv` / `--no-ext-diff` 也要核实过滤配置,
+ 不沿用旧配置结论。此处沿用防误发的边界:信任正常安装的 Git / Git LFS,不校验二进制是否被
+ 故意替换;凭证文件、直接写在命令里的密钥与保存的登录凭证仍按原规则确认;
+ 配置中出现 `core.fsmonitor` 时同样保留确认(不假设不同 Git 版本对布尔取值的解释一致),
+ 在读取 index 前拦下它,避免 hook 经 stderr 带出凭证。`git status`、`git ls-files`、只列文件名的
+ diff 等静态只读调用也要核实运行期 helper;无 helper 时仍可豁免,不改变本机任务默认判定;
+ 静态只读调用同样不能略过子模块检查:公共 Git 目录存在 `modules`、index 包含 gitlink,
+ 或核实目录状态失败时保留确认;即使旧式子模块把自己的 `.git` 留在工作目录里也不豁免,
+ 避免 `git status` 进入子模块后执行其独立配置的 helper 或 hook;
+ 配置中出现 `core.hooksPath` 时同样保留确认;未配置时,每次核实仓库公共 Git 目录里的默认
+ `post-index-change` hook(含 Windows 可执行文件后缀)不存在。发现 hook 或无法核实文件状态
+ 都不授予内容与静态只读豁免,避免 `git status` 刷新 index 时执行 hook、经 stderr 带出凭证;
+ 签名验证也可能启动外部程序:配置了 `gpg.program` / `gpg.<format>.program`、启用了
+ `log.showSignature`、命令请求 `--show-signature` 或 `%G` 验证格式、配置中的 pretty 格式或别名
+ 含 `%G` 时均保留确认,不假设验证器不会读取或输出凭证;历史与文件列表探针始终禁用签名展示;
+ 重合并历史(`--remerge-diff`、`--diff-merges=remerge` 或配置选择的 remerge 模式)可能运行
+ 自定义 `merge.<driver>.driver`,非空时先保留确认。内部历史/文件列表探针固定逐父提交比较,
+ 不继承重合并配置、不运行 merge driver;普通 Git 查看不因仅存在 merge driver 就额外确认;
+ `git diff/log/show --check` 的空白错误诊断会输出出错的源码行,因此同样按内容读取核实涉及的
+ 文件;与统计等输出选项组合时也不直接豁免,限定到普通源码的检查仍可免确认;
+ log/show/whatchanged/blame 中的姓名映射也核对来源:`.mailmap` 的真实目标、`mailmap.file` 或
+ `mailmap.blob` 指向凭据路径时保留确认,无法确定路径的 blob 同样确认;普通映射仍可豁免,
+ 不因无关的姓名映射配置让 diff/status 增加确认;
+ `git var -l` 与单个逻辑变量查询按实际输出检查,包含环境中的 editor/pager 及派生值,不能
+ 仅凭 Git 配置没有密钥就豁免;检查结果留在本机内存,不记录原始输出;
+ `--bare` 这类改变仓库上下文的选项、前面的命令段可能修改 Git 状态、运行环境,或写法认不出时也不能豁免。
+ 已知会读取 Git 内容的调用遇到未识别的全局选项、或不能归为静态只读命令时(如 `--ext-diff` /
+ `--textconv`)也保留凭证确认,不能因为未进入核实路径就当成不读取凭证;本机默认判定仍不变。
+ - 再收紧(2026-10-12 用户裁决),同样只用于分享任务:命令里直接写着密钥(`https://用户:密码@`、
+ 地址里的令牌、`Authorization` 头的取值、常见服务的令牌格式与私钥)、用 `<提交>:<路径>` 写出凭证类文件
+ (`git show HEAD:.aws/credentials`)、`git credential fill` 这类打出保存的登录凭证的命令都要确认。
同账号远程供应商不受影响:与本机一致,项目与个人配置里的符号链接一律跟随,不额外确认。
- 实现:`apps/desktop/src/main/remote-agent/{credentials.ts,executor/gate.ts,executor/credentialGrants.ts,controller/projectFiles.ts}`。
- 实现:`apps/desktop/src/main/remote-agent/{credentials.ts,executor/gate.ts,executor/executor.ts,executor/gitCredentials.ts,controller/projectFiles.ts}`;
++ 实现:`apps/desktop/src/main/remote-agent/{credentials.ts,executor/gate.ts,executor/executor.ts,executor/gitCredentials.ts,executor/credentialGrants.ts,controller/projectFiles.ts}`;
+ 命令判定复用 `packages/maker-core/src/agents/shared/auto-review.ts` 的 `shellCommandReadsCredentials`,
+ 上面的命令放宽与 git 核实通过它只有分享任务才传的选项(`CredentialCommandOptions`)实现,不传时判定不变。
## 10. 与现有规则的关系