AI导哈

AI编码工具VS Code扩展

UltraRepo App Builder是一个免费的AI编码工具，支持使用本地AI服务或远程AI服务（如OpenRouter、xAI、Google、OpenAI等），扩展了AI LLMs的上下文窗口，适用于需要隐私和控制权的开发者。

  • by UltraRepo
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 UltraRepo/builder

使用说明

UltraRepo应用程序生成器VS代码扩展

UltraRepo App Builder是一个免费的AI编码工具，允许您使用 本地人工智能服务 免费，或您自己的OpenRouter、xAI、谷歌、OpenAI、Anthropic等远程AI服务帐户。我们正在构建一套存储库工具，将AI LLM的范围扩展到典型的1MB上下文窗口之外。

开发人员快速入门

问题和解决方案愿景

问题： 几乎所有的IDE都利用远程、基于云的AI服务。虽然远程服务对于跨项目的持久性和作为团队资源非常有用，但我们通常希望获得只有私有人工智能基础设施才能提供的隐私、控制、性能和财务自由。一个巨大的问题是：AI IDE的内存很差，1MB的上下文窗口对于大多数专业开发项目来说是完全不够的。

解决方案： UltraRepo App Builder for VS Code旨在为开发人员提供对其开发环境所有元素的本地控制。UltraRepo App Builder拥有一套先进的编码工具、MCP Hub服务等，扩展了典型AI IDE的功能、可靠性、准确性和上下文窗口。默认情况下，UltraRepo App Builder提供了一个使用 本地AI 通过本地机器上的LMstudio或Docker AI服务（100%OpenAI兼容）。您可以使用 远程人工智能 如果你想要云服务，只需添加你的api密钥和AI服务信息（存储在VS Code Secrets中）。

重塑品牌和构建脚本概述

本文档描述了使用重构命令和自定义品牌将KiloCode VS Code扩展转换为UltraRepo App Builder品牌扩展的完整过程。

项目结构（开发人员视图）

/Users/jetstart/dev/ultrarepo/builder/
├── upstream/kilocode/                # Original KiloCode source (read-only/submodule)
├── build/kilocode/                   # Working build copy created by rebrand scripts (generated)
├── rebrand/                          # Rebrand source files, patches, and scripts (edit here)
│   ├── assets/icons/                 # UltraRepo App Builder icon assets used during rebrand
│   ├── webview-ui/                   # Optional React webview UI sources (built separately)
│   └── scripts/                      # Automation scripts (build, rebrand, patch NLS)
├── .ultrarepo/archivenew/            # Archive of moved/experimental files (not packaged)
├── .github/                          # CI / guidance for AI coding agents (copilot instructions)
├── .openai/  .grok/  .kilocode/      # Local configs and agent guidance (project-specific)
└── README.md                         # This developer README

笔记：

  • 在中编辑源代码级别更改 rebrand/ （不是 upstream/).构建脚本复制/合并 rebrand/ 进入 build/ 并产生封装的扩展。
  • 以前基于React Home UI下 rebrand/kilocode/webview-ui/src/components/home 已存档到 .ultrarepo/archivenew/.../home 并且默认情况下不是运行时包的一部分。运行时内联主页位于 rebrand/kilocode/src/extension.ts 作为 UltraHomePanel.
  • 该存储库以前包含一个存储库跟踪的预提交钩子 .githooks/；它已在此工作副本中删除/禁用。

源码库信息

  • 原始存储库（千码）: https://github.com/Kilo-Org/kilocode
  • 此存储库（UltraRepo应用程序生成器）: https://github.com/UltraRepo/builder
  • 本地副本: upstream/kilocode/ （Git子模块或副本）
  • 构建目录: build/kilocode/ （修改工作副本）

重新命名组件

1.脚本(rebrand/scripts/)

核心品牌重塑脚本

  • patch-nls-builder.sh -更新UltraRepo App Builder的package.json和本地化文件
  • icon-rebrand-builder.sh -将KiloCode图标替换为UltraRepo App Builder图标
  • rebrand-webviews-builder.sh -应用Web视图和文件重新命名
  • build-ultrarepo-complete.sh -完整的自动化构建过程

2.资产(rebrand/assets/)

UltraRepo应用程序生成器图标

  • icon.png -主扩展图标
  • logo-outline-black.gif -动画徽标
  • logo-outline-black-blue.png -替代徽标变体

转换过程

第一阶段：扩展身份重塑

这 patch-nls-builder.sh 脚本转换：

Package.json更改：

{
  "name": "ultrarepo" → "builder",
  "publisher": "UltraRepo"
}

*本地化文件（package.nls.json）：**

{
  "extension.displayName": "UltraRepo",
  "extension.description": "Open Source AI coding assistant"
}

结果：扩展ID为 UltraRepo.builder

第二阶段：图标重塑

这 icon-rebrand-builder.sh 该脚本将UltraRepo App Builder图标复制到构建目录中的KiloCode图标上，确保扩展在整个VS Code中显示UltraRepo AppBuilder品牌。

构建过程

自动完成构建

命令：

bash rebrand/scripts/build-ultrarepo-complete.sh

构建步骤：

  1. 依赖安装 - pnpm install
  2. Webview品牌重塑 -应用UltraRepo App Builder网络视图文件
  3. 扩展品牌重塑 -应用UltraRepo App Builder名称/发布者
  4. 图标重塑 -替换为UltraRepo App Builder图标
  5. 清洁建筑 -删除以前的工件
  6. 扩展构建 -编译和打包
  7. VSIX创建 -生成可安装的扩展

输出位置：

build/kilocode/dist/builder-[version].vsix

手动逐步构建

如果需要运行单个步骤：

# 1. Apply UltraRepo App Builder webview rebranding
NO_BACKUP=true bash rebrand/scripts/rebrand-webviews-builder.sh

# 2. Apply UltraRepo App Builder branding
bash rebrand/scripts/patch-nls-builder.sh build/kilocode/src

# 3. Apply icon rebranding
bash rebrand/scripts/icon-rebrand-builder.sh build/kilocode/src/assets/icons

# 4. Build extension
cd build/kilocode
pnpm run clean
pnpm build

文件和位置

关键源文件

扩展配置

  • build/kilocode/src/package.json -扩展清单
  • build/kilocode/src/package.nls*.json -本地化文件（23种语言）
  • build/kilocode/src/extension.ts -主扩展入口点

图标资产

  • build/kilocode/src/assets/icons/ -扩展图标
  • rebrand/assets/icons/ -UltraRepo App Builder替换图标

构建输出

主输出

  • build/kilocode/dist/builder-[version].vsix -最终可安装扩展

中间文件

  • build/kilocode/bin/builder-[version].vsix -初始构建输出
  • build/kilocode/src/dist/ -编译的扩展代码

安装和测试

安装扩展

# Install the rebranded extension
code --install-extension build/kilocode/dist/builder-[version].vsix

# Uninstall previous versions if needed
code --uninstall-extension UltraRepo.ultrarepo
code --uninstall-extension UltraRepo.builder

验证

安装后，请验证以下内容：

  1. 扩展标识

    • 名称：“UltraRepo应用程序生成器”
    • 出版商：“UltraRepo”
    • 扩展ID: UltraRepo.builder

  2. 命令功能

    • 打开命令选项板(Cmd+Shift+P)
    • 搜索“UltraRepo”命令
    • 测试： UltraRepo: New Task

  3. 视觉品牌

    • 扩展面板中的UltraRepo App Builder图标
    • 激活时侧边栏中的UltraRepo App Builder图标
    • 演练中的正确品牌

技术细节

扩展ID影响

扩展ID UltraRepo.builder 指：

  • 新安装：不从其他扩展迁移现有设置/状态
  • 命令注册：所有命令都在新命名空间下注册
  • VS代码集成：新的侧边栏面板、菜单项等。
  • 市场身份：唯一的扩展标识

开发工作流程

从上游更新（千码）

要纳入KiloCode的新更改：

  1. 更新上游更改 （如果将KiloCode作为上游跟踪）
  2. 合并到您的叉子中
  3. 通过品牌重塑进行重建
    bash rebrand/scripts/build-ultrarepo-complete.sh

定制品牌

要修改品牌，请执行以下操作：

  1. 更新显示名称：编辑 rebrand/scripts/patch-nls-builder.sh
  2. 改变图标：替换中的文件 rebrand/assets/icons/
  3. 修改命令：根据需要更新命令命名空间

故障排除

常见问题

  1. 脚本不可执行

    chmod +x rebrand/scripts/*.sh

  2. 缺失依赖项

    cd build/kilocode
pnpm install

  3. 构建失败

    • 检查Node.js版本（扩展目标为20.x，但适用于22.x）
    • 确保所有脚本都成功运行
    • 检查是否有任何错误消息

  4. 命令不起作用

    • 验证命令ID是否已正确重构
    • 检查VS代码开发人员控制台是否有错误
    • 确认扩展已激活

验证命令

# Check final extension identity
jq '.name, .publisher, .displayName' build/kilocode/src/package.json

# Check localization
jq '.["extension.displayName"]' build/kilocode/src/package.nls.json

# Check icon replacement
ls -la build/kilocode/src/assets/icons/

版本信息

  • 基于基洛码 4.125.1
  • UltraRepo应用程序生成器版本：[版本]（保持上游版本编号）
  • 编译时间：2025年11月30日
  • Node.js：v22.x（扩展目标20.19.2）
  • 包管理器：pnpm

v4.125.1主要更新摘要

此版本对UltraRepo App Builder进行了重大增强，整合了上游KiloCode v4.125.1版本的主要功能。

主要功能和改进

  • LanceDB矢量数据库集成:

    • 它是什么LanceDB是一个开源、无服务器的矢量数据库，专为人工智能应用而设计。它能够快速、高效地存储和检索向量嵌入（代码/文本的数值表示）。
    • 利益：显著提高了扩展理解和搜索代码库的能力。它允许语义搜索（按含义查找代码，而不仅仅是关键字）和更好的AI上下文检索，从而提供更准确和相关的代码建议和答案。
    • 本地和私人：在扩展中本地运行，维护数据的隐私和控制，而不需要外部云向量存储。

  • 增强的AI提供商支持:

    • Gemini 3 Pro预览版：在Gemini和Vertex AI提供商中添加了对最新Gemini 3 Pro模型的支持，提供了改进的推理和编码能力。
    • Nano GPT提供程序：对Nano GPT的新支持，扩大了可用的本地/轻量级模型的范围。
    • MiniMax M2改进：优化以减少使用MiniMax M2模型时不成功的编辑。

  • UI/UX优化:

    • 直观的下拉搜索：下拉菜单中的搜索功能已得到改进，以匹配VS Code的原生行为，从而更容易找到选项。
    • 自动完成状态栏：重新设计自动完成状态栏和工具提示，以获得更清晰、更丰富的体验。

贡献

要修改或增强品牌重塑过程：

  1. 脚本更改：在中编辑文件 rebrand/scripts/
  2. 资产更新：替换中的文件 rebrand/assets/
  3. 文档：更新此自述文件
  4. 测试：更改后始终测试完整的构建过程

备注：此次品牌重塑保留了KiloCode的所有原始功能，同时提供了独特的UltraRepo App Builder身份。该过程旨在随着上游项目的发展而可重复和可维护。

相关 MCP