用途:在本地代码库中回答“X 在哪里定义”“Y 被哪些地方使用”“探索某目录”“追踪调用关系”等问题,强调以真实代码证据为依据。
主要能力:提供 localViewStructure(目录结构浏览,支持排序、深度、过滤)、localSearchCode(内容搜索,支持分页与提示)、localFindFiles(按名称、时间、大小等元数据查找文件)、localGetFileContent(按 matchString 定位读取内容);并提供 LSP 语义工具 lspGotoDefinition、lspFindReferences、lspCallHierarchy,用于定位定义、查找全部引用和追踪调用层级。
使用方式:遵循“文本缩小范围→符号定位→图关系解释”的流程。所有 LSP 工具必须先通过 localSearchCode 获得 lineHint 才能调用;localGetFileContent 放在最后读取。结果中的 hints 用于决定下一步,空结果时尝试语义变体(如 auth→login→credentials)。可用 TaskCreate/TaskUpdate 跟踪研究任务,在支持并行的环境中用 Task 派生多个子代理处理独立领域。研究文档可写入 .octocode/research/{session-name}/research.md。
适用场景:陌生代码库探索、符号定义与引用查找、调用链追踪、近期修改或大文件排查、node_modules 依赖内部行为分析。
限制:LSP 工具依赖 localSearchCode 提供的 lineHint,禁止跳过;默认遵循 .gitignore,检查 node_modules 需 noIgnore=true;外部 GitHub 仓库、包源码或 PR 历史需改用 octocode-research 技能;并行子代理仅在宿主环境支持时可用。具体安装命令与收费信息暂未提供。