添加语言挂钩

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

第1步:检查语言目录是否存在

在 chunker/hooks/ 中查找现有的 <language>/ 目录。存在 - 您正在向现有语言添加新的钩子。阅读<language>/index.ts可以看到当前的钩子链。不存在——你正在为一种新语言添加钩子。创建<language>/目录。

第三步:创建钩子文件

创建hooks/<language>/<hook-name>.ts。遵循现有模式: comment-capture.ts - 提取文档注释,将行标记为排除 class-body-chunker.ts - 将大型类主体拆分为方法级块 命名导出的钩子:<language><Purpose>Hook(例如,rubyCommentCaptureHook、typescriptBodyChunkingHook)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第1步:检查语言目录是否存在

在 `chunker/hooks/` 中查找现有的 `<language>/` 目录。存在 - 您正在向现有语言添加新的钩子。阅读`<language>/index.ts`以查看当前的钩子链。不存在——你正在为一种新语言添加钩子。创建`<language>/`目录。

02
第二步:了解hook接口

阅读`chunker/hooks/types.ts`。每个钩子实现: `HookContext` 提供: 只读: `containerNode`、 `validChildren`、 `code`、 `codeLines`、 `config` 可变: `excludedRows`、 `methodPrefixes`、 `methodStartLines`、 `bodyChunks`

03
第三步:创建钩子文件

创建`hooks/<language>/<hook-name>.ts`。遵循现有模式: `comment-capture.ts` — 提取文档注释,将行标记为已排除 `class-body-chunker.ts` — 将大型类主体拆分为方法级块 命名导出的钩子:`<language><Purpose>Hook`(例如,`rubyCommentCaptureHook`、`typescriptBodyChunkingHook`)。

04
步骤 4:创建或更新桶

`hooks/<language>/index.ts` 导出有序的钩子数组:

05
第5步:在语言配置中注册

编辑`chunker/config.ts`。在`LANGUAGE_DEFINITIONS`中找到语言条目并添加`hooks`属性:如果`LANGUAGE_DEFINITIONS`中不存在该语言,请添加完整条目`loadModule`、`extractLanguage`、`chunkableTypes`和`hooks`。

06
第 6 步:编写测试

测试在`tests/core/domains/ingest/pipeline/chunker/hooks/<language>/`中进行。遵循`typescript/`或`ruby/`目录中的现有测试模式。每个钩子应该有自己的测试文件,用真正的`HookContext`测试`process()`功能(使用`types.ts`中的`createHookContext()`)。

07
第7步:验证

来源:artk0de/TeaRAGs-MCP — 由 TomeVault 分发。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。