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。

fix(sharing): validate wrapped results and share bare path parsing

david703da19a7e38
diff --git a/apps/desktop/src/main/device-link/__tests__/sharedTaskMediaAccess.test.ts b/apps/desktop/src/main/device-link/__tests__/sharedTaskMediaAccess.test.ts
index 2b812b4d32..c43b06c9d7 100644
--- a/apps/desktop/src/main/device-link/__tests__/sharedTaskMediaAccess.test.ts
+++ b/apps/desktop/src/main/device-link/__tests__/sharedTaskMediaAccess.test.ts
@@ -85,6 +85,25 @@ describe('shared task media access', () => {
await expect(assertSharedTaskMedia('xdt-file://local?path=' + encodeURIComponent(file), capture)).resolves.toEqual({ file });
await expect(assertSharedTaskMedia('xdt-file://local?path=' + encodeURIComponent(file + '.secret'), capture)).rejects.toThrow('PERMISSION_DENIED');
});
+ it.each(['assistant', 'user', 'guest'])('recognizes bare file links in %s prose with the same author boundary', async (author) => {
+ const file = path.resolve('deliveries/report.pdf');
+ deps.query.mockResolvedValue([{ rowid: 1, role: author === 'guest' ? 'user' : author,
+ content: JSON.stringify(`Saved at ${markdownPath(file)}:42.`),
+ agentMeta: author === 'guest' ? JSON.stringify({ sharedTaskAuthor: { memberId: 'm' } }) : null }]);
+ const access = assertSharedTaskMedia('xdt-file://local?path=' + encodeURIComponent(file), capture);
+ if (author === 'guest') await expect(access).rejects.toThrow('PERMISSION_DENIED');
+ else await expect(access).resolves.toEqual({ file });
+ });
+ it.each(['fenced', 'link-label', 'reference-label', 'partial-token'])('does not extract bare-path authorization from %s text', async (kind) => {
+ const file = path.resolve('deliveries/report.pdf');
+ const local = markdownPath(file);
+ const content = kind === 'fenced' ? '```\nSaved at ' + local + '\n```'
+ : kind === 'link-label' ? `[${local}](https://example.com)`
+ : kind === 'reference-label' ? `[${local}][site]\n\n[site]: https://example.com`
+ : `Saved at ${local}_backup`;
+ deps.query.mockResolvedValue([{ rowid: 1, role: 'assistant', content: JSON.stringify(content) }]);
+ await expect(assertSharedTaskMedia('xdt-file://local?path=' + encodeURIComponent(file), capture)).rejects.toThrow('PERMISSION_DENIED');
+ });
it('does not treat a guest message as authority for outside files', async () => {
const file = path.resolve('other/private.pdf');
deps.query.mockResolvedValue([{ rowid: 1, role: 'user', content: JSON.stringify({ text: `[file](<${markdownPath(file)}>)` }), agentMeta: JSON.stringify({ sharedTaskAuthor: { memberId: 'm' } }) }]);
@@ -155,6 +174,20 @@ describe('shared task media access', () => {
expect(deps.query.mock.calls[1][1]).toEqual(['task', 'run-1', 2]);
}
});
+ // Outer transport success must not mask the producing tool's inner failure.
+ it.each(['tool_use', 'tool_result'])('checks wrapped tool failures through the %s authorization route', async (role) => {
+ const file = path.resolve('deliveries/report.pdf');
+ const url = 'xdt-file://local?path=' + encodeURIComponent(file);
+ const tool = { toolName: 'mcp:reports:generate', input: role === 'tool_use' ? { outPath: file } : {} };
+ for (const success of [false, true]) {
+ const result = { ok: true, result: { ok: success, xdt_media_produced: [url] } };
+ deps.query.mockResolvedValueOnce([{ rowid: role === 'tool_use' ? 1 : 2, role, toolUseId: 'generate-1', content: JSON.stringify(role === 'tool_use' ? tool : result) }])
+ .mockResolvedValueOnce([{ content: JSON.stringify(role === 'tool_use' ? result : tool) }]);
+ const access = assertSharedTaskMedia(url, capture);
+ if (success) await expect(access).resolves.toEqual({ file });
+ else await expect(access).rejects.toThrow('PERMISSION_DENIED');
+ }
+ });
// Successful reading/echoing of guest-controlled content is not delivery.
// Even JSON that resembles delivery metadata stays content for native readers.
it.each([
diff --git a/apps/desktop/src/main/device-link/sharedTaskFileReferences.ts b/apps/desktop/src/main/device-link/sharedTaskFileReferences.ts
index c95afa1788..b8c8fbdb95 100644
--- a/apps/desktop/src/main/device-link/sharedTaskFileReferences.ts
+++ b/apps/desktop/src/main/device-link/sharedTaskFileReferences.ts
@@ -8,6 +8,7 @@ import { parseMessageToolUse } from '@cindy/maker-shared/message-normalize';
import { isToolResultFailureLike } from '@cindy/maker-shared/message-presentation';
import { parseToolResultPayload } from '@cindy/maker-shared/payload-summary';
import { extractCommandOutputPathCandidates } from '../../shared/commandOutputPaths.js';
+import { findPathMatches } from '../../shared/bareFilePathTokens.js';
import { getDbClient } from '../localDb/client/current.js';
import type { SharedTaskPeerCapture } from './sharedTaskDispatch.js';
@@ -24,6 +25,17 @@ function decode(value: string): unknown {
try { return JSON.parse(value); } catch { return value; }
}
+/** Transport success does not override a failure inside the tool's result. */
+function toolResultFailed(descriptor: ReturnType<typeof describeToolUse>, content: unknown): boolean {
+ let value = content;
+ for (;;) {
+ if (isToolResultFailureLike(descriptor, typeof value === 'string' ? value : JSON.stringify(value))) return true;
+ const envelope = record(typeof value === 'string' ? decode(value) : value);
+ if (envelope?.ok !== true || !record(envelope.result)) return false;
+ value = envelope.result;
+ }
+}
+
/** Only explicit file references count; a substring in source, a patch or a log does not. */
function references(content: unknown, role: string, includeText: boolean): string[] {
const body = record(content);
@@ -63,10 +75,12 @@ function references(content: unknown, role: string, includeText: boolean): strin
visit(tree, 'definition', (node) => {
if (!definitions.has(node.identifier)) definitions.set(node.identifier, node.url);
});
- visit(tree, (node) => {
+ visit(tree, (node, _index, parent) => {
if (node.type === 'link' || node.type === 'image') result.push(node.url);
else if (node.type === 'inlineCode') result.push(node.value);
- else if (node.type === 'linkReference' || node.type === 'imageReference') {
+ else if (node.type === 'text' && parent?.type !== 'link' && parent?.type !== 'linkReference') {
+ result.push(...findPathMatches(node.value).map((match) => match.value));
+ } else if (node.type === 'linkReference' || node.type === 'imageReference') {
const url = definitions.get(node.identifier);
if (url) result.push(url);
}
@@ -148,7 +162,7 @@ export async function sharedTaskReferencesFile(
// Their actual outputs are authorized via invocation output paths below;
// delivery metadata is a contract of MCP/dynamic tool responses only.
if (descriptor.kind !== 'mcp' && descriptor.kind !== 'dynamic') continue;
- if (isToolResultFailureLike(descriptor, typeof content === 'string' ? content : JSON.stringify(content))) continue;
+ if (toolResultFailed(descriptor, content)) continue;
}
if (row.role === 'tool_use') {
// A queued/denied tool invocation is not delivery. Only completed output
@@ -164,7 +178,7 @@ export async function sharedTaskReferencesFile(
if (!capture.isCurrent()) return false;
if (!results.length) continue;
const result = decode(results[0].content);
- if (isToolResultFailureLike(describeToolUse(tool.toolName, tool.input), typeof result === 'string' ? result : JSON.stringify(result))) continue;
+ if (toolResultFailed(describeToolUse(tool.toolName, tool.input), result)) continue;
}
return true;
}
diff --git a/apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts b/apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts
index 9ea5b7fe40..4a67c583ef 100644
--- a/apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts
+++ b/apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts
@@ -46,8 +46,8 @@
* (避免嵌套链接)。纯 AST 变换,无 IO、无副作用。
*
* 手机端对等物:`apps/mobile/src/session/chatPathCandidate.ts` 的
- * `findBareFilePathMatch`(下面 PATH_RE 那一族常量与 findPathMatches 的移植,接进
- * messageMarkdown 的 inline 分词器)。**本文件的正则改了要同步过去**,否则两端会
+ * `findBareFilePathMatch`(shared/bareFilePathTokens 的移植,接进
+ * messageMarkdown 的 inline 分词器)。**共享分词器的正则改了要同步过去**,否则两端会
* 就"哪些正文路径可点"给出不同结果。
*/
@@ -57,54 +57,7 @@ import { visit, SKIP } from 'unist-util-visit';
import { looksLikeFilePath } from '@/lib/localPathResolver';
import { splitLocalLineSuffix } from '@/lib/markdownTarget';
-
-// CJK / 假名 / 谚文:可作为路径段的一部分(如 `docs/设计稿/index.md`)。
-const CJK = '\\u4e00-\\u9fff\\u3400-\\u4dbf\\u3040-\\u30ff\\uac00-\\ud7af';
-// 路径段允许的字符(不含分隔符、不含 `:`)。`:` 留给盘符锚点与 `:line` 后缀。
-const SEG = `[A-Za-z0-9._~@+\\-${CJK}]+`;
-const SEP = '\\\\/'; // 反斜杠 + 正斜杠,字符类内用
-// 锚点:盘符 `C:\` / `./` `../` / 单独的分隔符开头。
-//
-// **刻意不含 `~/`**:`~` 在本仓任何一层都没有展开 —— renderer 的 resolveLocalPath /
-// resolveChatAbsPath 只做 join,被控端的 fs:stat-path / fs:resolve-path 也不展开,于是
-// `~/logs/app.log` 会被 stat 成 `<workdir>/~/logs/app.log`:链路正常时判 nonfile、永远不
-// 点亮(白发一次 stat),链路断时还会按「绝对形状」乐观点亮、点开错误地址。
-// 在拿到可靠展开能力(被控端返回真实 home)之前,正文裸路径不认这个锚点
-// (PR #1144 review 实捉;行内 code / 显式链接入口的同一问题是既有行为,属另一处 —— 修它
-// 要改被控端协议,不是 renderer 能兜的,已在 PR 里记为 follow-up)。
-const ANCHOR = `(?:[A-Za-z]:[${SEP}]|\\.{1,2}[${SEP}]|[${SEP}])`;
-// `SEG` 含 `~`(备份文件 `file~` 等中段用途),所以只改锚点挡不住 `~/x`:
-// `(?:SEG SEP)+` 一样能把 `~/` 当成「段+分隔符」吃下去。故在整条匹配前加负向前瞻,
-// 明确拒绝以 `~/` `~\` 开头的 token(实测过:只删锚点里的 `~` 时 `~/logs/app.log`
-// 仍然命中)。
-const NO_HOME = '(?!~[\\\\/])';
-// 右边界:匹配**不得停在段内字符或分隔符之前**。只排除字母数字是不够的 —— SEG 还允许
-// `_ ~ @ + -` 与 CJK,分隔符也会漏过去,于是这些形态会被切出一个错误前缀、后半段留成
-// 普通文本,而那个前缀形状上是「分隔符+扩展名」= 非歧义,断链时会被点亮、点开错误地址:
-// src/foo.ts/bar → `src/foo.ts` + 文本 `/bar`
-// src/file.tsx_backup → `src/file.tsx` + 文本 `_backup`
-// src/foo.ts~ → `src/foo.ts` + 文本 `~`
-// (PR #1144 review 实捉;上一轮只挡住了「超长扩展名」这一种。)
-//
-// **`.` 刻意不排除**:句末英文句点是最常见的紧随字符,把它加进来会让 `见 src/a.ts.`
-// 整条失配(SEG 含 `.`,回溯也救不回来)。`:` 同理留给合法的 `:line` 后缀。
-const RIGHT_BOUNDARY = `(?![A-Za-z0-9_~@+\\-${CJK}${SEP}])`;
-// 路径主体:要么有锚点(中间段可有可无),要么是"段+分隔符"至少一组(保证含分隔符);
-// 末段必须以扩展名收尾。
-//
-// 扩展名后的 `(?![A-Za-z0-9])` 是**右边界**,不能省:没有它,超过 10 个字符的扩展名会被
-// 截成前 10 个字符当成链接(`src/file.typescriptreact` → `src/file.typescript`),而截断后的
-// 前缀形状上是「分隔符+扩展名」= 非歧义,远程会话断链时会被加下划线、允许点击,点开的是
-// 一个**不存在的错误路径**;正文里还留着孤零零的 `react`。加了边界后整条路径直接不识别
-// (保持纯文本),这才是想要的语义(PR #1144 review 实捉,移动端 chatPathCandidate 同步)。
-const BODY =
- `(?:${ANCHOR}(?:${SEG}[${SEP}])*|(?:${SEG}[${SEP}])+)${SEG}\\.[A-Za-z0-9]{1,10}${RIGHT_BOUNDARY}`;
-// 可选 `:line[:column]` 行号后缀。
-const LINE_SUFFIX = '(?::[1-9]\\d{0,6}(?::[1-9]\\d{0,6})?)?';
-// 左边界:前一个字符不能是路径字符 / 分隔符(`:` 不算,允许 `文件:src/x.ts`)。
-const LEFT_BOUNDARY = `(?<![A-Za-z0-9._~@+${CJK}${SEP}])`;
-
-const PATH_RE = new RegExp(`${LEFT_BOUNDARY}${NO_HOME}(${BODY}${LINE_SUFFIX})`, 'g');
+import { findPathMatches, type PathMatch } from '../../../shared/bareFilePathTokens';
/**
* 标记属性名:正文裸路径切出的 link 节点带上它,渲染层据此走「只加下划线、不变
@@ -113,123 +66,6 @@ const PATH_RE = new RegExp(`${LEFT_BOUNDARY}${NO_HOME}(${BODY}${LINE_SUFFIX})`,
*/
export const BARE_PATH_ATTR = 'data-bare-path';
-interface PathMatch {
- start: number; // 在 text 节点 value 里的起始下标
- end: number; // 结束下标(不含)
- value: string; // 命中的路径文本(含可能的 :line 后缀)
-}
-
-/**
- * 边界后置过滤 —— 一条统一判据,替掉「一轮补一个字符类」。
- *
- * 词法层是「在散文里用正向正则定位路径」(按空白切 token 再剥边在中文里不成立,见本文件
- * 头部的说明),所以必须自己保证:**命中要独占它所在的路径 token,不许从中段起、也不许把
- * 紧跟的字符截断**。前四轮 review 各捉到这条规格的一个缺口(扩展名长度 / 右边界字符 /
- * 空格中段 / `( ) # %` 等未支持字符 + 行号后缀),逐个补字符类注定一轮一个,故改成:
- *
- * 左侧:命中点前是**同一 run 内的字符**时,只有少数字符可以合法地紧邻一条路径 ——
- * 开括号 / 引号 / 冒号 / 列表分隔符。其余一律拒绝(说明我们落在
- * `foo(bar)/src/index.ts`、`docs/50%off/a.md`、`foo#bar/x/a.ts` 这类**未支持字符**
- * 把 token 断开后的中段)。这里刻意用**白名单**:上一版用「run 前缀已含分隔符」
- * 的黑名单,假设了未支持字符出现在首个分隔符之后,于是 `foo(bar)/src/index.ts`
- * (括号在第一个 `/` 之前)绕过去、还切出个绝对路径 `/src/index.ts`。白名单让未知
- * 字符**默认拒绝**,与本节「宁可少点亮」同向,不必再逐个补。
- * 命中点前是空白时,看空白前那个 run:含分隔符**且不以扩展名收尾** → 拒绝
- * (`C:\Program Files\Cindy\app.log` 被空格截断的后半段)。「不以扩展名收尾」
- * 不能省,否则 `src/a.ts src/b.ts` 里的第二条会被连坐。
- * 右侧:命中之后紧跟 token 字符 → 拒绝。正则自带的右边界只管到扩展名,整段行号后缀
- * 之后没有边界,于是 `src/a.ts:12345678` 被截成 `:1234567`、`src/a.ts:12foo`
- * 截成 `:12`(错误行号 + 正文残留)。`.` 与 `:` 本身不算 token 字符(句末句点
- * `见 src/a.ts.`、句末冒号 `见 src/a.ts:` 要保住),但**它们后面还跟 token 字符**
- * 时同样拒绝 —— 否则 `src/a.ts:12.5` / `src/a.ts:12:foo` 会留下错误行号 + 正文
- * 残渣,而且这种前缀在链路正常时也会点亮。
- *
- * 好处是 `( ) # % [ ]` 之类**不需要枚举**:白名单之外一律拒绝,以后出现别的未支持字符
- * 也自动覆盖,不必再来一轮。
- *
- * 已知误伤(显式取舍,有用例钉住):散文里紧挨着一个「含分隔符、无扩展名」的片段时会被
- * 连坐,如 `见 /etc src/a.ts`。代价是少点亮一条、文本仍可读,方向与 DESIGN.md §14.5
- * 「宁可少点亮一个真目录,不可多点亮一片假链接」一致。
- */
-const TOKEN_CHAR_RE = new RegExp(`[A-Za-z0-9_~@+\\-${CJK}\\\\/]`);
-/**
- * 可以合法地紧邻一条裸路径的字符(同一 run 内)。白名单而非黑名单:未知字符默认拒绝。
- * 开括号与引号 —— 路径被包裹(`见(src/a.ts)`);冒号 —— `文件:src/x.ts`;
- * 列表分隔符 —— `src/a.ts,src/b.ts` 是真的两条路径。
- * `>` 也放行:字面 HTML 的**元素内容**里的路径按既有口径仍识别(`<div>src/App.tsx</div>`,
- * 与 strong / inlineCode / 裸 URL matcher 同口径,见 messageMarkdown 的说明),而 `>` 不可能
- * 出现在路径段内,放行它不会带来错误前缀。
- * 注意闭括号 `)` `]` 刻意**不在**表里:它只可能出现在被断开的 token 中间。
- * `=` 同样不在表里:`--config=src/a.json` 因此不点亮 —— 那是可有可无的便利,而放行 `=` 会
- * 让 `docs/a=b/c.md` 切出错误前缀 `b/c.md`(§14.5:宁可少点亮一个,不可多点亮一片)。
- */
-const ALLOWED_BEFORE_RE = /[([{(【「『"'`::,;,;、>]/;
-const SEP_IN_RUN_RE = /[\\/]/;
-const TRAILING_EXT_RE = /\.[A-Za-z0-9]{1,10}$/;
-
-/** 命中是否从路径 token 的**中段**起(见上方说明)。 */
-function startsMidPathToken(text: string, start: number): boolean {
- if (start === 0) return false;
- // (1) 同一非空白 run 内:只有白名单字符可以紧邻路径,其余说明是被断开的中段。
- let runStart = start - 1;
- while (runStart >= 0 && !/\s/.test(text[runStart])) runStart -= 1;
- const runPrefix = text.slice(runStart + 1, start);
- if (runPrefix.length > 0) {
- return !ALLOWED_BEFORE_RE.test(text[start - 1]);
- }
- // (2) 命中点前是空白:看空白前那个 run 是不是「被空格截断的前半段」。
- // 只跨空格 / 制表符,不跨换行 —— 换行之后是新的一行,不是同一条路径。
- let i = start - 1;
- while (i >= 0 && (text[i] === ' ' || text[i] === '\t')) i -= 1;
- if (i < 0 || i === start - 1) return false;
- let j = i;
- while (j >= 0 && !/\s/.test(text[j])) j -= 1;
- const prevRun = text.slice(j + 1, i + 1);
- if (!SEP_IN_RUN_RE.test(prevRun)) return false;
- return !TRAILING_EXT_RE.test(prevRun);
-}
-
-/** 命中之后是否紧跟 token 字符(= 我们截断了它,见上方说明)。 */
-function endsMidPathToken(text: string, end: number): boolean {
- const next = text[end];
- if (next === undefined) return false;
- if (TOKEN_CHAR_RE.test(next)) return true;
- // `.` / `:` 本身要放过(句末句点 / 句末冒号),但它们后面还跟 token 字符时说明我们把
- // 一段复合后缀截断了:`src/a.ts:12.5`、`src/a.ts:12:foo`。
- //
- // **跳过整串标点再判,不能只看紧邻一个字符**:只看一个时 `src/a.ts:12..5`、
- // `src/a.ts:12::foo`、`src/a.ts:12:.:foo` 会因为第二个标点不是 token 字符而绕过去
- // (这一处被连续挖了三轮:`:12345678` → `:12.5` → `:12..5`,每轮多一层嵌套;跳整串是
- // 为了把「再多一个标点」这条路一次封掉)。句末连写的省略号 `src/a.ts...` 仍保住 ——
- // 跳完之后没有 token 字符。
- if (next === '.' || next === ':') {
- let i = end;
- while (text[i] === '.' || text[i] === ':') i += 1;
- const after = text[i];
- return after !== undefined && TOKEN_CHAR_RE.test(after);
- }
- return false;
-}
-
-/** 在一段纯文本里定位所有"带分隔符、可解析形状"的路径 token。 */
-function findPathMatches(text: string): PathMatch[] {
- const matches: PathMatch[] = [];
- let m: RegExpExecArray | null;
- PATH_RE.lastIndex = 0;
- while ((m = PATH_RE.exec(text)) !== null) {
- const value = m[1];
- // 复用 inline code / 链接同款谓词复核:剥行号后缀 → 路径形状校验。
- const pathPart = splitLocalLineSuffix(value).href;
- if (!looksLikeFilePath(pathPart)) continue;
- const start = m.index + (m[0].length - value.length);
- // 边界后置过滤:命中必须独占它所在的路径 token(见 startsMidPathToken 的说明)。
- if (startsMidPathToken(text, start)) continue;
- if (endsMidPathToken(text, start + value.length)) continue;
- matches.push({ start, end: start + value.length, value });
- }
- return matches;
-}
-
/** 把一个 text 节点按命中的路径区间拆成 [text, link, text, ...]。 */
function splitTextNode(node: Text, matches: PathMatch[]): PhrasingContent[] {
const out: PhrasingContent[] = [];
@@ -270,7 +106,7 @@ const remarkLocalPathLinks: Plugin<[], Root> = () => {
// 快速短路:不含任何路径分隔符的文本一定不是带分隔符路径,直接跳过。
if (!node.value || (!node.value.includes('/') && !node.value.includes('\\'))) return;
- const matches = findPathMatches(node.value);
+ const matches = findPathMatches(node.value).filter((match) => looksLikeFilePath(splitLocalLineSuffix(match.value).href));
if (matches.length === 0) return;
const replacement = splitTextNode(node, matches);
diff --git a/apps/desktop/src/shared/bareFilePathTokens.ts b/apps/desktop/src/shared/bareFilePathTokens.ts
new file mode 100644
index 0000000000..8e805456c3
--- /dev/null
+++ b/apps/desktop/src/shared/bareFilePathTokens.ts
@@ -0,0 +1,165 @@
+/** Shared lexical path tokens for Markdown rendering and host file authorization.
+ * No filesystem access or trust decision; callers validate and resolve candidates. */
+
+// CJK / 假名 / 谚文:可作为路径段的一部分(如 `docs/设计稿/index.md`)。
+const CJK = '\\u4e00-\\u9fff\\u3400-\\u4dbf\\u3040-\\u30ff\\uac00-\\ud7af';
+// 路径段允许的字符(不含分隔符、不含 `:`)。`:` 留给盘符锚点与 `:line` 后缀。
+const SEG = `[A-Za-z0-9._~@+\\-${CJK}]+`;
+const SEP = '\\\\/'; // 反斜杠 + 正斜杠,字符类内用
+// 锚点:盘符 `C:\` / `./` `../` / 单独的分隔符开头。
+//
+// **刻意不含 `~/`**:`~` 在本仓任何一层都没有展开 —— renderer 的 resolveLocalPath /
+// resolveChatAbsPath 只做 join,被控端的 fs:stat-path / fs:resolve-path 也不展开,于是
+// `~/logs/app.log` 会被 stat 成 `<workdir>/~/logs/app.log`:链路正常时判 nonfile、永远不
+// 点亮(白发一次 stat),链路断时还会按「绝对形状」乐观点亮、点开错误地址。
+// 在拿到可靠展开能力(被控端返回真实 home)之前,正文裸路径不认这个锚点
+// (PR #1144 review 实捉;行内 code / 显式链接入口的同一问题是既有行为,属另一处 —— 修它
+// 要改被控端协议,不是 renderer 能兜的,已在 PR 里记为 follow-up)。
+const ANCHOR = `(?:[A-Za-z]:[${SEP}]|\\.{1,2}[${SEP}]|[${SEP}])`;
+// `SEG` 含 `~`(备份文件 `file~` 等中段用途),所以只改锚点挡不住 `~/x`:
+// `(?:SEG SEP)+` 一样能把 `~/` 当成「段+分隔符」吃下去。故在整条匹配前加负向前瞻,
+// 明确拒绝以 `~/` `~\` 开头的 token(实测过:只删锚点里的 `~` 时 `~/logs/app.log`
+// 仍然命中)。
+const NO_HOME = '(?!~[\\\\/])';
+// 右边界:匹配**不得停在段内字符或分隔符之前**。只排除字母数字是不够的 —— SEG 还允许
+// `_ ~ @ + -` 与 CJK,分隔符也会漏过去,于是这些形态会被切出一个错误前缀、后半段留成
+// 普通文本,而那个前缀形状上是「分隔符+扩展名」= 非歧义,断链时会被点亮、点开错误地址:
+// src/foo.ts/bar → `src/foo.ts` + 文本 `/bar`
+// src/file.tsx_backup → `src/file.tsx` + 文本 `_backup`
+// src/foo.ts~ → `src/foo.ts` + 文本 `~`
+// (PR #1144 review 实捉;上一轮只挡住了「超长扩展名」这一种。)
+//
+// **`.` 刻意不排除**:句末英文句点是最常见的紧随字符,把它加进来会让 `见 src/a.ts.`
+// 整条失配(SEG 含 `.`,回溯也救不回来)。`:` 同理留给合法的 `:line` 后缀。
+const RIGHT_BOUNDARY = `(?![A-Za-z0-9_~@+\\-${CJK}${SEP}])`;
+// 路径主体:要么有锚点(中间段可有可无),要么是"段+分隔符"至少一组(保证含分隔符);
+// 末段必须以扩展名收尾。
+//
+// 扩展名后的 `(?![A-Za-z0-9])` 是**右边界**,不能省:没有它,超过 10 个字符的扩展名会被
+// 截成前 10 个字符当成链接(`src/file.typescriptreact` → `src/file.typescript`),而截断后的
+// 前缀形状上是「分隔符+扩展名」= 非歧义,远程会话断链时会被加下划线、允许点击,点开的是
+// 一个**不存在的错误路径**;正文里还留着孤零零的 `react`。加了边界后整条路径直接不识别
+// (保持纯文本),这才是想要的语义(PR #1144 review 实捉,移动端 chatPathCandidate 同步)。
+const BODY =
+ `(?:${ANCHOR}(?:${SEG}[${SEP}])*|(?:${SEG}[${SEP}])+)${SEG}\\.[A-Za-z0-9]{1,10}${RIGHT_BOUNDARY}`;
+// 可选 `:line[:column]` 行号后缀。
+const LINE_SUFFIX = '(?::[1-9]\\d{0,6}(?::[1-9]\\d{0,6})?)?';
+// 左边界:前一个字符不能是路径字符 / 分隔符(`:` 不算,允许 `文件:src/x.ts`)。
+const LEFT_BOUNDARY = `(?<![A-Za-z0-9._~@+${CJK}${SEP}])`;
+
+const PATH_RE = new RegExp(`${LEFT_BOUNDARY}${NO_HOME}(${BODY}${LINE_SUFFIX})`, 'g');
+
+export interface PathMatch {
+ start: number; // 在 text 节点 value 里的起始下标
+ end: number; // 结束下标(不含)
+ value: string; // 命中的路径文本(含可能的 :line 后缀)
+}
+
+/**
+ * 边界后置过滤 —— 一条统一判据,替掉「一轮补一个字符类」。
+ *
+ * 词法层是「在散文里用正向正则定位路径」(按空白切 token 再剥边在中文里不成立,见本文件
+ * 头部的说明),所以必须自己保证:**命中要独占它所在的路径 token,不许从中段起、也不许把
+ * 紧跟的字符截断**。前四轮 review 各捉到这条规格的一个缺口(扩展名长度 / 右边界字符 /
+ * 空格中段 / `( ) # %` 等未支持字符 + 行号后缀),逐个补字符类注定一轮一个,故改成:
+ *
+ * 左侧:命中点前是**同一 run 内的字符**时,只有少数字符可以合法地紧邻一条路径 ——
+ * 开括号 / 引号 / 冒号 / 列表分隔符。其余一律拒绝(说明我们落在
+ * `foo(bar)/src/index.ts`、`docs/50%off/a.md`、`foo#bar/x/a.ts` 这类**未支持字符**
+ * 把 token 断开后的中段)。这里刻意用**白名单**:上一版用「run 前缀已含分隔符」
+ * 的黑名单,假设了未支持字符出现在首个分隔符之后,于是 `foo(bar)/src/index.ts`
+ * (括号在第一个 `/` 之前)绕过去、还切出个绝对路径 `/src/index.ts`。白名单让未知
+ * 字符**默认拒绝**,与本节「宁可少点亮」同向,不必再逐个补。
+ * 命中点前是空白时,看空白前那个 run:含分隔符**且不以扩展名收尾** → 拒绝
+ * (`C:\Program Files\Cindy\app.log` 被空格截断的后半段)。「不以扩展名收尾」
+ * 不能省,否则 `src/a.ts src/b.ts` 里的第二条会被连坐。
+ * 右侧:命中之后紧跟 token 字符 → 拒绝。正则自带的右边界只管到扩展名,整段行号后缀
+ * 之后没有边界,于是 `src/a.ts:12345678` 被截成 `:1234567`、`src/a.ts:12foo`
+ * 截成 `:12`(错误行号 + 正文残留)。`.` 与 `:` 本身不算 token 字符(句末句点
+ * `见 src/a.ts.`、句末冒号 `见 src/a.ts:` 要保住),但**它们后面还跟 token 字符**
+ * 时同样拒绝 —— 否则 `src/a.ts:12.5` / `src/a.ts:12:foo` 会留下错误行号 + 正文
+ * 残渣,而且这种前缀在链路正常时也会点亮。
+ *
+ * 好处是 `( ) # % [ ]` 之类**不需要枚举**:白名单之外一律拒绝,以后出现别的未支持字符
+ * 也自动覆盖,不必再来一轮。
+ *
+ * 已知误伤(显式取舍,有用例钉住):散文里紧挨着一个「含分隔符、无扩展名」的片段时会被
+ * 连坐,如 `见 /etc src/a.ts`。代价是少点亮一条、文本仍可读,方向与 DESIGN.md §14.5
+ * 「宁可少点亮一个真目录,不可多点亮一片假链接」一致。
+ */
+const TOKEN_CHAR_RE = new RegExp(`[A-Za-z0-9_~@+\\-${CJK}\\\\/]`);
+/**
+ * 可以合法地紧邻一条裸路径的字符(同一 run 内)。白名单而非黑名单:未知字符默认拒绝。
+ * 开括号与引号 —— 路径被包裹(`见(src/a.ts)`);冒号 —— `文件:src/x.ts`;
+ * 列表分隔符 —— `src/a.ts,src/b.ts` 是真的两条路径。
+ * `>` 也放行:字面 HTML 的**元素内容**里的路径按既有口径仍识别(`<div>src/App.tsx</div>`,
+ * 与 strong / inlineCode / 裸 URL matcher 同口径,见 messageMarkdown 的说明),而 `>` 不可能
+ * 出现在路径段内,放行它不会带来错误前缀。
+ * 注意闭括号 `)` `]` 刻意**不在**表里:它只可能出现在被断开的 token 中间。
+ * `=` 同样不在表里:`--config=src/a.json` 因此不点亮 —— 那是可有可无的便利,而放行 `=` 会
+ * 让 `docs/a=b/c.md` 切出错误前缀 `b/c.md`(§14.5:宁可少点亮一个,不可多点亮一片)。
+ */
+const ALLOWED_BEFORE_RE = /[([{(【「『"'`::,;,;、>]/;
+const SEP_IN_RUN_RE = /[\\/]/;
+const TRAILING_EXT_RE = /\.[A-Za-z0-9]{1,10}$/;
+
+/** 命中是否从路径 token 的**中段**起(见上方说明)。 */
+function startsMidPathToken(text: string, start: number): boolean {
+ if (start === 0) return false;
+ // (1) 同一非空白 run 内:只有白名单字符可以紧邻路径,其余说明是被断开的中段。
+ let runStart = start - 1;
+ while (runStart >= 0 && !/\s/.test(text[runStart])) runStart -= 1;
+ const runPrefix = text.slice(runStart + 1, start);
+ if (runPrefix.length > 0) {
+ return !ALLOWED_BEFORE_RE.test(text[start - 1]);
+ }
+ // (2) 命中点前是空白:看空白前那个 run 是不是「被空格截断的前半段」。
+ // 只跨空格 / 制表符,不跨换行 —— 换行之后是新的一行,不是同一条路径。
+ let i = start - 1;
+ while (i >= 0 && (text[i] === ' ' || text[i] === '\t')) i -= 1;
+ if (i < 0 || i === start - 1) return false;
+ let j = i;
+ while (j >= 0 && !/\s/.test(text[j])) j -= 1;
+ const prevRun = text.slice(j + 1, i + 1);
+ if (!SEP_IN_RUN_RE.test(prevRun)) return false;
+ return !TRAILING_EXT_RE.test(prevRun);
+}
+
+/** 命中之后是否紧跟 token 字符(= 我们截断了它,见上方说明)。 */
+function endsMidPathToken(text: string, end: number): boolean {
+ const next = text[end];
+ if (next === undefined) return false;
+ if (TOKEN_CHAR_RE.test(next)) return true;
+ // `.` / `:` 本身要放过(句末句点 / 句末冒号),但它们后面还跟 token 字符时说明我们把
+ // 一段复合后缀截断了:`src/a.ts:12.5`、`src/a.ts:12:foo`。
+ //
+ // **跳过整串标点再判,不能只看紧邻一个字符**:只看一个时 `src/a.ts:12..5`、
+ // `src/a.ts:12::foo`、`src/a.ts:12:.:foo` 会因为第二个标点不是 token 字符而绕过去
+ // (这一处被连续挖了三轮:`:12345678` → `:12.5` → `:12..5`,每轮多一层嵌套;跳整串是
+ // 为了把「再多一个标点」这条路一次封掉)。句末连写的省略号 `src/a.ts...` 仍保住 ——
+ // 跳完之后没有 token 字符。
+ if (next === '.' || next === ':') {
+ let i = end;
+ while (text[i] === '.' || text[i] === ':') i += 1;
+ const after = text[i];
+ return after !== undefined && TOKEN_CHAR_RE.test(after);
+ }
+ return false;
+}
+
+/** 在一段纯文本里定位所有"带分隔符、可解析形状"的路径 token。 */
+export function findPathMatches(text: string): PathMatch[] {
+ const matches: PathMatch[] = [];
+ let m: RegExpExecArray | null;
+ PATH_RE.lastIndex = 0;
+ while ((m = PATH_RE.exec(text)) !== null) {
+ const value = m[1];
+ const start = m.index + (m[0].length - value.length);
+ // 边界后置过滤:命中必须独占它所在的路径 token(见 startsMidPathToken 的说明)。
+ if (startsMidPathToken(text, start)) continue;
+ if (endsMidPathToken(text, start + value.length)) continue;
+ matches.push({ start, end: start + value.length, value });
+ }
+ return matches;
+}
+
diff --git a/docs/product-rules/shared-task-mode.md b/docs/product-rules/shared-task-mode.md
index 0205ae275e..99bc5f63d6 100644
--- a/docs/product-rules/shared-task-mode.md
+++ b/docs/product-rules/shared-task-mode.md
@@ -42,6 +42,7 @@
- 文件浏览器(2026-10-10 用户裁决):访客可在文件浏览器中浏览和编辑本任务工作目录,读写权限与房主一致:列目录、读取、搜索、缩略图、保存、新建、重命名、删除,以及文件变化监听。主机只认本机记录的任务工作目录与执行端点(本地或任务所属 SSH 主机),访客传入的路径只用于比对;读写前复核成员资格。文件导出/文件夹下载这类导出任务仍只限同账号(它们走房主的同账号中转路径),工作目录本身的管理(更换目录)仍归房主。实现见 `sharedTaskDispatch.ts`(通道与操作)、`sharedTaskFileAccess.ts`(目录绑定)与 `file-browser/device-op.ts`。
- 任务关联的本机文件即使位于工作目录外,访客也可经原有取件通道只读访问(2026-10-19 修复):归属由房主端当前未回退且未被 `/clear` 隐藏的消息记录确认,包括主机已校验并接收的结构化附件(含访客上传)、房主/Agent 明确交付的文件链接及已完成且未报错的工具产出。文件引用及配对的工具调用、结果均须晚于任务的清空边界;清空前的记录即使仍在数据库中,也不再提供授权。访客自行粘贴的路径、代码示例、其他任务记录或仅前缀相同的路径不构成授权;仅放行关联的具体文件,不开放其父目录浏览或写入。取件继续检查成员资格、敏感路径和解析后的文件身份,不缓存历史授权结论。Desktop 与 Mobile 共用房主校验,无新增 wire 字段;SSH 的工作目录限界保持原规则,不以本机路径例外绕过。实现与回归见 `sharedTaskFileReferences.ts`、`sharedTaskMediaAccess.ts` 及 `sharedTaskMediaAccess.test.ts`、`mediaFetch.test.ts`。
- 工具结果中的普通文本链接不构成外部文件交付,包括读取、搜索、网页或 shell 返回的内容。原生工具产出沿用调用中明确声明的输出路径;MCP/动态工具的结果只认既有结构化交付字段 `xdt_media_produced`、`_xdt_model_files`,并继续核对调用配对、成功状态及当前历史边界。原生读取和 shell 输出即使形似这些字段,也不按交付解释。房主/Agent 在消息中明确交付的链接仍按上述规则处理。
+- 工具结果外层 `ok: true` 仅代表调用包装成功,内层 `result` 的失败状态同样阻止文件授权,调用产出路径与结果交付字段使用相同判定。房主/Agent 消息中可解析为文件链接的正文路径和完整行内代码路径沿用界面已有的链接/文件卡片语义;代码块中的示例、普通代码表达式、链接标签中的路径不提供额外授权。正文路径分词由 Renderer 与房主共用 `shared/bareFilePathTokens.ts`,仍须完整匹配请求文件。
- 消息按主机现有输入队列顺序处理,保留 clientId 幂等。访客仅编辑/撤回自己未处理消息,房主可处理全部未处理消息;直接更新内容,不显示“已编辑”。
- 发言者身份来自经过验证的账号和成员关系,不能信任消息正文或客户端自报的身份。