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。

6.4 KB
Raw Blame
/**
 * remarkLocalPathLinks — 把回复正文纯文本里"长得像本地文件路径"的 token 切成
 * mdast `link` 节点,让它复用现有的链接渲染链路(classify → resolve → chip /
 * 降级纯文本)。
 *
 * 背景:
 *   桌面端聊天渲染器早就能把本地文件路径渲染成可点 chip,但只识别两种入口——
 *   行内代码 `` `path` `` 和显式 markdown 链接 `[label](path)`。agent 在正文
 *   里直接写进句子的路径(`见 src/App.tsx`、`改的是 C:\proj\app.ts`)完全当普通
 *   文字渲染,点不动。本插件补上"正文纯文本"这个缺口。
 *
 * 为什么放渲染器侧而不是系统提示词:
 *   "一条路径要不要变可点"是个确定性判断——能唯一解析到真实文件就可点,否则不
 *   可点(解析 + stat 存在性校验都在主进程 pathResolver 里)。按仓库规则 16,确
 *   定性逻辑应落代码而非甩给 prompt。放渲染器侧还顺带救了**已经渲染成纯文本的
 *   历史消息**(prompt 只能影响未来输出)。
 *
 * 匹配策略:
 *   - 用一条"正向路径正则"在正文里定位 token,而不是按空白切再剥边——后者在中文
 *     里("src/App.tsx,然后呢"这种路径直接黏着中文)会把尾巴一起吞掉判废。正向
 *     正则在**扩展名**处收尾,尾随的中文/标点天然落在 match 之外。
 *   - 只认**带路径分隔符**的形态:相对路径(含 `/` 或 `\` + 扩展名)、`./` `../`
 *     `~/` 开头、POSIX 绝对、Windows 盘符。裸文件名(`app.tsx`,无分隔符)在正文里
 *     太歧义,不碰——这点比 inline code 更严(inline code 是作者主动用反引号标注
 *     的格式信号)。
 *   - 左边界用负向 lookbehind 卡死:路径前一个字符必须是边界(空白 / 起始 / 标点
 *     等),不能是另一个路径字符,避免从中文 prose 中间起切。
 *
 * 已知限制(CJK 既可能是 prose 也可能是真实目录名 `我的看板`,词法层无法区分,故
 * 一律当作路径段字符;代价在"无空白边界紧贴中文"时显现,均与现状一致、本就点不动,
 * 不是回退):
 *   - 前导紧贴:`见src/x.ts`(中文直接黏在路径前)→ "见"被并入 token,解析不到 →
 *     纯文本。
 *   - 中文黏连两条真路径:`a/b.ts和c/d.ts` → 中间的"和"被当成路径段,整串吞成**一个**
 *     token `a/b.ts和c/d.ts`,解析不到 → 两条真路径**都点不亮**(比前导紧贴影响更大)。
 *   要救这些只能把 CJK 当分隔符,但那会反过来切断 `docs/设计稿/index.md` 里的中文目录
 *   名,得不偿失,故不做。
 *
 *   - 命中后再用现有 `splitLocalLineSuffix` + `looksLikeFilePath` 复核一遍,与
 *     inline code / 链接共用同一套谓词,"什么算文件路径"全仓一致;且切出来的 link
 *     仍走主进程 resolve,解析不到 → 现有链路降级成纯 `<span>`,误匹配天然不会变坏
 *     chip。
 *
 * 只处理 `text` 节点,天然不碰代码:mdast 里 `code` / `inlineCode` 是带 `value`
 * 的叶子节点,没有 `text` 子节点,扫不到;唯一要跳过的是已经在 `link` 里的 text
 * (避免嵌套链接)。纯 AST 变换,无 IO、无副作用。
 *
 * 手机端对等物:`apps/mobile/src/session/chatPathCandidate.ts` 的
 * `findBareFilePathMatch`(shared/bareFilePathTokens 的移植,接进
 * messageMarkdown 的 inline 分词器)。**共享分词器的正则改了要同步过去**,否则两端会
 * 就"哪些正文路径可点"给出不同结果。
 */

import type { Plugin } from 'unified';
import type { Root, Text, Link, PhrasingContent } from 'mdast';
import { visit, SKIP } from 'unist-util-visit';

import { looksLikeFilePath } from '@/lib/localPathResolver';
import { splitLocalLineSuffix } from '@/lib/markdownTarget';
import { findPathMatches, type PathMatch } from '../../../shared/bareFilePathTokens';

/**
 * 标记属性名:正文裸路径切出的 link 节点带上它,渲染层据此走「只加下划线、不变
 * 等宽」的分支(见 splitTextNode 里的说明)。与 MarkdownRenderer 共享同一常量,
 * 避免字面量在两处漂移。
 */
export const BARE_PATH_ATTR = 'data-bare-path';

/** 把一个 text 节点按命中的路径区间拆成 [text, link, text, ...]。 */
function splitTextNode(node: Text, matches: PathMatch[]): PhrasingContent[] {
  const out: PhrasingContent[] = [];
  const value = node.value;
  let cursor = 0;
  for (const match of matches) {
    if (match.start > cursor) {
      out.push({ type: 'text', value: value.slice(cursor, match.start) });
    }
    const link: Link = {
      type: 'link',
      url: match.value,
      children: [{ type: 'text', value: match.value }],
      // 标记「这条 link 是从正文纯文本切出来的」,供渲染层区分作者手写的
      // `[label](path)`。两者点亮后的形态不同(DESIGN.md §14.5):
      //   - 作者写的 markdown 链接:label 像文件名 → 等宽 chip(那是作者的排版意图);
      //   - 正文裸写的路径:保持正文字体,只加下划线 —— 否则同一句里点亮的路径变成
      //     等宽块、没点亮的仍是正文,字体/底色/下划线三处齐变,跳变无法解释。
      // hProperties 是 mdast-util-to-hast 的既有通道,会原样落到 <a> 的属性上,
      // 再由 MarkdownRenderer 的 a 组件读取并从 DOM props 里剥掉。
      data: { hProperties: { [BARE_PATH_ATTR]: '' } },
    };
    out.push(link);
    cursor = match.end;
  }
  if (cursor < value.length) {
    out.push({ type: 'text', value: value.slice(cursor) });
  }
  return out;
}

const remarkLocalPathLinks: Plugin<[], Root> = () => {
  return (tree) => {
    visit(tree, 'text', (node: Text, index, parent) => {
      if (!parent || index == null) return;
      // 已在链接里的 text 不动:避免把链接 label 再切成嵌套链接。
      if (parent.type === 'link') return;
      // 快速短路:不含任何路径分隔符的文本一定不是带分隔符路径,直接跳过。
      if (!node.value || (!node.value.includes('/') && !node.value.includes('\\'))) return;

      const matches = findPathMatches(node.value).filter((match) => looksLikeFilePath(splitLocalLineSuffix(match.value).href));
      if (matches.length === 0) return;

      const replacement = splitTextNode(node, matches);
      parent.children.splice(index, 1, ...replacement);
      // 跳过刚插入的节点,避免重复访问。
      return [SKIP, index + replacement.length];
    });
  };
};

export default remarkLocalPathLinks;