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
HomeUI下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构建步骤:
- 依赖安装 -
pnpm install - Webview品牌重塑 -应用UltraRepo App Builder网络视图文件
- 扩展品牌重塑 -应用UltraRepo App Builder名称/发布者
- 图标重塑 -替换为UltraRepo App Builder图标
- 清洁建筑 -删除以前的工件
- 扩展构建 -编译和打包
- 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验证
安装后,请验证以下内容:
- 扩展标识
- 名称:“UltraRepo应用程序生成器” - 出版商:“UltraRepo” - 扩展ID: UltraRepo.builder
- 命令功能
- 打开命令选项板(Cmd+Shift+P) - 搜索“UltraRepo”命令 - 测试: UltraRepo: New Task
- 视觉品牌
- 扩展面板中的UltraRepo App Builder图标 - 激活时侧边栏中的UltraRepo App Builder图标 - 演练中的正确品牌
技术细节
扩展ID影响
扩展ID UltraRepo.builder 指:
- 新安装:不从其他扩展迁移现有设置/状态
- 命令注册:所有命令都在新命名空间下注册
- VS代码集成:新的侧边栏面板、菜单项等。
- 市场身份:唯一的扩展标识
开发工作流程
从上游更新(千码)
要纳入KiloCode的新更改:
- 更新上游更改 (如果将KiloCode作为上游跟踪)
- 合并到您的叉子中
- 通过品牌重塑进行重建
bash rebrand/scripts/build-ultrarepo-complete.sh定制品牌
要修改品牌,请执行以下操作:
- 更新显示名称:编辑
rebrand/scripts/patch-nls-builder.sh - 改变图标:替换中的文件
rebrand/assets/icons/ - 修改命令:根据需要更新命令命名空间
故障排除
常见问题
- 脚本不可执行
chmod +x rebrand/scripts/*.sh- 缺失依赖项
cd build/kilocode
pnpm install- 构建失败
- 检查Node.js版本(扩展目标为20.x,但适用于22.x) - 确保所有脚本都成功运行 - 检查是否有任何错误消息
- 命令不起作用
- 验证命令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的原生行为,从而更容易找到选项。 - 自动完成状态栏:重新设计自动完成状态栏和工具提示,以获得更清晰、更丰富的体验。
贡献
要修改或增强品牌重塑过程:
- 脚本更改:在中编辑文件
rebrand/scripts/ - 资产更新:替换中的文件
rebrand/assets/ - 文档:更新此自述文件
- 测试:更改后始终测试完整的构建过程
______________________________________________________________________
备注:此次品牌重塑保留了KiloCode的所有原始功能,同时提供了独特的UltraRepo App Builder身份。该过程旨在随着上游项目的发展而可重复和可维护。
