Psa Igent

BildsyPS

你的终端，精心策划。BildsyPS是一个AI shell环境，它理解你的上下文——你的文件、git状态、正在运行的进程——并代表你行事。与Claude、GPT或当地LLM聊天。执行命令、管理文件、搜索网络、运行自主代理以及连接到MCP服务器。全部来自PowerShell，全部本地优先，没有给家里打电话。

话题： bildsyps ai-assistant claude chatgpt ollama llm terminal mcp agent automation cli app-builder exe

特性

🤖 AI聊天助手

• 多提供商支持：Ollama，克劳德，OpenAI，LM工作室+ llm命令行界面 （100+插件）
• 命令执行：AI可以代表您运行安全的PowerShell命令
• 意图系统：80多种自然语言操作，如“创建一个名为Report的文档”
• 流媒体响应：人工智能提供商的实时输出
• MCP客户端：连接到外部MCP服务器以扩展功能
• 对话持久性：SQLite数据库，可在所有会话中进行FTS5全文搜索
• 文件夹感知：AI可以看到您当前的目录、git状态和文件结构
• 代币预算管理：智能地修剪上下文以适应模型限制，总结被驱逐的消息
• 秘密扫描仪：检测文件和暂存git提交中暴露的API密钥、令牌和凭据
• 视觉支持：将截图和图像发送给Claude/GPT-4o进行分析
• OCR集成：图像的Tesseract OCR，PDF的pdftotext，带视觉API回退
• 选项卡完成：所有公共函数上的动态参数补全器——提供者、会话名称、技能名称、工作流名称、构建名称、MCP服务器、任务ID、工件文件、git分支

🧠 自主代理

使用单个命令运行多步骤任务。代理进行推理、计划、使用工具和调整，不需要预定义的工作流。

# One-shot task
agent "check AAPL and MSFT stock prices and calculate the difference"

# Interactive mode — follow-up tasks with shared memory
agent -Interactive "research PowerShell async patterns"

# Pre-seed working memory
agent -Memory @{ budget = "5000" } "calculate 8% tax on the budget"

内置代理工具：

插件可以通过以下方式注册其他工具 Register-AgentTool.

分层代理编排

代理可以通过深度限制递归（最大深度2）为集中的子任务生成子代理：

# The LLM can dynamically delegate during an agent run:
# Single sub-task
{"tool":"spawn_agent","task":"research PowerShell async patterns"}

# Parallel sub-tasks via thread jobs
{"tool":"spawn_agent","tasks":"[{\"task\":\"research X\"},{\"task\":\"research Y\"}]","parallel":"true"}

内存隔离： 深度0-1共享父内存；深度1-2得到一个独立的副本。每个线程的并行作业都是完全隔离的，结果在完成时合并。

🏗️ 应用程序生成器--提示.exe

用简单的英语描述一个应用程序，并获得一个编译后的Windows可执行文件。

# Build a standalone .exe (defaults to PowerShell/WinForms lane)
build "a todo list app with categories and due dates"

# Force a specific framework
build python-tk "a calculator with scientific functions"
build python-web "a markdown editor with live preview"

# Override token budget for complex apps
build -tokens 32000 "a project management dashboard"

# Skip branding (future paid tier)
build -nobranding "a simple timer"

# List all builds
builds

# Modify an existing build with diff-based edits
rebuild my-todo-app "add a dark mode toggle"

五条施工车道：

PowerShell是默认通道——没有venv，没有pip，没有PyInstaller。只是一个直接 .ps1 → .exe 汇编。令牌预算会自动从模型的上下文窗口中检测到每条车道的上限和下限。每个生成的应用程序都包含“Built with BildsyPS”品牌。

管道v2 --生成管道现在包括一个计划代理（用于复杂的规范）、一个在验证失败时最多可自动重试2次的修复循环、一个根据规范检查生成代码的审查代理，以及一个从过去的失败中学习并将约束注入未来提示的构建内存系统。

🔧 可用意图

🧩 插件架构

掉落 .ps1 文件进入 Plugins/ 在不涉及核心代码的情况下添加新意图：

plugins                        # List active & disabled plugins
Enable-BildsyPSPlugin 'Example'  # Activate a plugin
new-plugin 'MyPlugin'          # Scaffold from template
test-plugin -All               # Run plugin self-tests
watch-plugins                  # Auto-reload on file save
plugin-config Pomodoro          # View plugin configuration

插件功能： 依赖关系解析，按插件配置(Plugins/Config/*.json)，生命周期挂钩(OnLoad/OnUnload)、自检框架、辅助函数共享、版本兼容性检查、热重载文件监视器。

看 Plugins/_Example.ps1 对于完整模板。

🎯 自定义用户技能

通过JSON定义自己的意图——不需要PowerShell。技能是在第一次运行时从示例模板自动创建的。

{
  "skills": {
    "deploy_staging": {
      "description": "Pull latest and show status",
      "triggers": ["deploy staging", "push to staging"],
      "parameters": [{"name": "branch", "default": "main"}],
      "confirm": true,
      "steps": [
        {"command": "git checkout {branch}"},
        {"command": "git pull origin {branch}"},
        {"intent": "git_status"}
      ]
    }
  }
}

# Skills are directly callable from the prompt
deploy_staging                          # invoke by name
deploy_staging main                     # with positional args

# Or programmatically
Invoke-UserSkill -Name 'deploy_staging' -Parameters @{ branch = 'main' }

skills              # List user skills
new-skill 'name'    # Create interactively
reload-skills       # Reload from JSON

触发短语 在 triggers 数组注册为意图别名——人工智能可以通过自然语言匹配调用你的技能。 UserSkills.json 在第一次运行时从示例模板自动创建。

🔄 多步骤工作流

将多个意图链接在一起以完成复杂任务：

# List available workflows
workflows

# Run a workflow
workflow daily_standup
workflow research_and_document -Params @{ topic = "AI agents" }

# Stop on first failure
Invoke-Workflow -Name daily_standup -StopOnError

# AI can trigger via intent:
# {"intent":"run_workflow","name":"research_and_document","params":"{\"topic\":\"PowerShell\"}"}

内置工作流：

🛠️ 终端工具集成

• 蝙蝠 -语法高亮显示的文件查看
• 发光 -Markdown渲染
• 兄弟 -交互式文件导航
• 电液动方型闸阀 -模糊发现
• jq/yq -JSON/YAML处理

📁 导航实用程序

• tree -目录树可视化
• size -文件夹大小分析
• z -快速跳转目录
• .., ..., .... -快速家长导航
• gco, gmerge, grb -Git签出/合并/重基，完成分支选项卡

快速开始

# Start AI chat (local Ollama)
chat

# Start AI chat with Claude
chat -p anthropic

# Start with folder awareness (AI sees your current directory)
chat -FolderAware   # or: chat -f

# Resume last session with context recall
chat -Continue      # or: chat -c

# Show available commands
tips

# Check tool health
health

配置

API密钥

编辑 ChatConfig.json 添加API密钥：

{
  "apiKeys": {
    "ANTHROPIC_API_KEY": "your-key-here",
    "OPENAI_API_KEY": "your-key-here"
  }
}

默认提供程序

在中更改默认聊天提供程序 ChatConfig.json:

{
  "defaults": {
    "provider": "ollama",
    "model": "llama3.2"
  }
}

还支持提供程序级别覆盖（例如每个提供程序的默认模型）：

{
  "providers": {
    "anthropic": { "defaultModel": "claude-sonnet-4-6" }
  }
}

文件结构

BildsyPS/
├── Microsoft.PowerShell_profile.ps1  # Main profile (loads modules)
├── ChatConfig.json                   # API keys and settings
├── ToolPreferences.json              # Tool preferences
├── NaturalLanguageMappings.json      # Command mappings
├── UserSkills.json                   # Custom user-defined intents (your file)
├── UserSkills.example.json           # Template for user skills
├── UserAliases.ps1                   # Your custom persistent aliases
├── BildsyPS.psm1                     # Module loader
├── BildsyPS.psd1                     # Module manifest
├── Modules/
│   ├── ConfigLoader.ps1              # .env and config loading
│   ├── PlatformUtils.ps1             # Cross-platform helpers
│   ├── SecurityUtils.ps1             # Path/URL security
│   ├── SecretScanner.ps1             # API key / credential leak detection
│   ├── CommandValidation.ps1         # Command whitelist & safety
│   ├── SystemUtilities.ps1           # uptime, hwinfo, ports, sudo, PATH
│   ├── ArchiveUtils.ps1              # zip, unzip
│   ├── DockerTools.ps1               # Docker shortcuts
│   ├── DevTools.ps1                  # IDE launchers, dev checks
│   ├── NaturalLanguage.ps1           # NL to command translation
│   ├── ResponseParser.ps1            # Parse AI responses, format markdown
│   ├── DocumentTools.ps1             # OpenXML document creation
│   ├── SafetySystem.ps1              # AI execution safety + secret scanning
│   ├── SystemCleanup.ps1             # Wrapped cleanup commands (flush DNS, restart explorer)
│   ├── TerminalTools.ps1             # bat, glow, broot, fzf integration
│   ├── NavigationUtils.ps1           # Navigation & git shortcuts
│   ├── PackageManager.ps1            # Tool installation
│   ├── WebTools.ps1                  # Web search APIs
│   ├── ProductivityTools.ps1         # Clipboard, Git, Calendar
│   ├── MCPClient.ps1                 # MCP protocol client
│   ├── BrowserAwareness.ps1          # Browser tab URL + content reading
│   ├── VisionTools.ps1               # Screenshot capture + vision model analysis
│   ├── OCRTools.ps1                  # Tesseract OCR + pdftotext integration
│   ├── CodeArtifacts.ps1             # AI code save + execute + tracking
│   ├── AppBuilder.ps1                # Prompt-to-executable pipeline (ps2exe, PyInstaller)
│   ├── FzfIntegration.ps1            # Fuzzy finder integration
│   ├── PersistentAliases.ps1         # User-defined aliases
│   ├── ProfileHelp.ps1               # Help, tips, system prompt
│   ├── FolderContext.ps1             # Folder awareness for AI context
│   ├── ToastNotifications.ps1        # BurntToast/.NET notifications
│   ├── ChatStorage.ps1               # SQLite persistence + FTS5 full-text search
│   ├── ChatSession.ps1               # LLM chat loop + session management
│   ├── ChatProviders.ps1             # AI provider implementations
│   ├── AgentHeartbeat.ps1            # Cron-triggered background agent tasks
│   ├── UserSkills.ps1                # JSON user-defined intent loader
│   ├── PluginLoader.ps1              # Plugin system (deps, config, hooks, tests)
│   ├── IntentAliasSystem.ps1         # Intent system orchestrator (loads below)
│   ├── IntentRegistry.ps1            # Intent metadata + category definitions
│   ├── IntentActions.ps1             # Core intent scriptblocks (docs, web, git, etc.)
│   ├── IntentActionsSystem.ps1       # System/filesystem/workflow/vision/build scriptblocks
│   ├── WorkflowEngine.ps1            # Multi-step workflow engine
│   ├── IntentRouter.ps1              # Intent router, help, tab completion
│   ├── AgentTools.ps1                # Agent tool registry (17 built-in tools incl. spawn_agent)
│   └── AgentLoop.ps1                 # Autonomous agent engine (ReAct + tools + memory + sub-agents)
├── Plugins/
│   ├── _Example.ps1                  # Reference plugin template
│   ├── _Pomodoro.ps1                 # Pomodoro timer plugin
│   ├── _QuickNotes.ps1               # Note-taking plugin
│   └── Config/                       # Per-plugin configuration overrides
├── Tests/                            # 17 Pester test files (368 tests)
├── README.md
├── VISION.md                         # Product direction and roadmap
├── CHANGELOG.md                      # Release history
├── CONTRIBUTING.md                   # Contributor guide
└── SETUP.md                          # Detailed setup instructions

聊天指令

在聊天模式下：

• exit -退出聊天（自动保存会话）
• clear -清晰对话（自动保存之前的对话）
• save / save -保存会话
• resume / resume -加载已保存的会话
• sessions -浏览所有已保存的会话
• search -在所有会话中搜索
• rename -重命名当前会话
• delete -删除已保存的会话
• export / export -将会话导出到markdown
• budget -按角色显示令牌使用情况明细
• folder -注入当前目录上下文
• `folder

` -注入特定目录

• agent 或 /agent -运行自主代理以完成多步骤任务
• /agent -进入交互式代理模式（共享内存的后续任务）
• /tools -列出所有已注册的代理工具
• /steps -显示上次代理运行的步骤
• /memory -显示代理工作记忆
• /plan -演出经纪人最后宣布的计划
• vision / `vision

` -使用视觉AI分析图像或屏幕截图

• build "prompt" -根据描述构建独立的.exe
• builds -列出所有以前的版本
• rebuild "changes" -修改和重建现有应用程序
• switch -更改AI提供商
• model -更改模型

会话标志

chat -Resume        # or: chat -r  — resume last session
chat -Continue      # or: chat -c  — resume + inject summary so model recalls context
chat -FolderAware   # or: chat -f  — inject current directory on start, auto-update on cd
chat -AutoTrim      # automatically trim context when approaching model limits

安全特性

• 命令白名单：只能执行批准的命令
• 确认提示：危险命令需要批准-- RequiresConfirmation 意图总是提示，即使在代理模式下也是如此
• 速率限制：防止执行失控
• 执行日志记录：记录所有AI命令
• 路径安全：根据允许的根验证文件读/写操作
• 计算器沙盒：只有 [math]:: 允许.NET调用；任意类型的访问被阻止
• 秘密扫描：检测文件中的API密钥、令牌和凭据，并在启动时进行分段git提交；具有后视镜感知的正则表达式避免了UI变量名的误报
• 代码验证：App Builder在编译之前验证生成的代码是否存在语法错误、危险模式和秘密泄漏；代码生成提示禁止硬编码/占位符API键，而需要运行时设置UI

需求

• PowerShell 7.0+ （Windows/Mac/Linux）
• Windows 10/11、macOS或Linux
• 可选：Ollama用于本地AI
• 可选：用于云AI的Anthropic/OpenAI API密钥
• 可选：用于MCP服务器的Node.js
• 可选：Tesseract OCR用于图像文本提取
• 可选：Python 3.8+用于Python-tk/Python web构建通道
• 可选：ps2exe(Install-Module ps2exe)用于PowerShell构建通道

安装

PowerShell 7（推荐）

# Windows
git clone https://github.com/gsultani1/BildsyPS.git "$HOME\Documents\PowerShell"

# macOS/Linux
git clone https://github.com/gsultani1/BildsyPS.git ~/.config/powershell

设置

1. 复制 ChatConfig.example.json 到 ChatConfig.json
2. 将API密钥添加到 ChatConfig.json
3. 重新启动PowerShell或运行 . $PROFILE

看 设置.md 有关详细的设置说明，包括可选依赖关系。

MCP（模型上下文协议）支持

连接到外部MCP服务器以扩展AI功能。

快速开始

# Register common MCP servers
mcp-register

# List registered servers
mcp-servers

# Connect to a server
mcp-connect filesystem

# Call a tool
mcp-call -ServerName filesystem -ToolName read_file -Arguments @{path="C:\file.txt"}

可用的MCP服务器

注册自定义服务器

Register-MCPServer -Name "myserver" `
    -Command "npx" `
    -Args @("-y", "@org/mcp-server-name") `
    -Description "My custom server"

路线图

BildsyPS今天是一个shell编排器——一个理解你的终端环境并代表你行事的人工智能。方向更为广阔： 整个计算机的任务控制.

看 视觉.md 以获得完整的产品方向。

许可证

MIT许可证-请参阅许可证文件

作者

乔治·苏塔尼