Skillget

bytemind

agent
SUMMARY

ByteMind 是一个运行在本地代码仓库中的工程 Agent，当前以 Terminal / TUI 作为主交互入口，让开发者完成“理解项目、修改代码、执行命令、验证结果、恢复上下文、继续推进任务”的工程闭环。

README.md

ByteMind

一个用 Go 实现的 AI Coding CLI，目标是提供更接近 OpenCode / ClaudeCode 的工作流能力。

当前版本已经具备：

  • 多轮会话与会话持久化
  • 纯 CLI 聊天交互
  • 流式终端输出
  • OpenAI-compatible 与 Anthropic 双 provider 适配层
  • 工具调用循环
  • 工作区文件浏览、读取、搜索、写入、精确替换
  • Shell 命令执行与审批策略
  • -max-iterations 执行预算覆盖
  • 到达预算时自动返回阶段性总结，而不是直接报错
  • 简单的重复工具调用检测，避免死循环

目录结构

cmd/bytemind            CLI 入口
internal/agent          对话循环、系统提示词模板、流式输出
internal/config         配置加载与环境变量覆盖
internal/llm            通用消息与工具类型
internal/provider       多 provider 适配层
internal/session        会话持久化
internal/tools          文件工具、patch 工具、shell 工具

快速开始

先按下方“配置文件”章节准备好 config.json，再在仓库根目录运行：

聊天模式：

go run ./cmd/bytemind chat

单次任务：

go run ./cmd/bytemind run -prompt "分析当前项目并生成改进建议"

需要更大的执行预算时：

go run ./cmd/bytemind chat -max-iterations 64
go run ./cmd/bytemind run -prompt "refactor this module" -max-iterations 64

配置文件

在工作区根目录下寻找配置文件 config.json，直接从仓库根目录复制示例模板开始：

Copy-Item config.example.json config.json

然后把 api_key 等字段改成你自己的配置。

配置示例：

{
  "provider": {
    "type": "openai-compatible",
    "base_url": "https://api.openai.com/v1",
    "model": "gpt-5.4-mini",
    "api_key": "your-api-key-here"
  },
  "approval_policy": "on-request",
  "max_iterations": 32,
  "session_dir": ".bytemind/sessions",
  "stream": true
}

Anthropic 示例：

{
  "provider": {
    "type": "anthropic",
    "base_url": "https://api.anthropic.com",
    "model": "claude-sonnet-4-20250514",
    "api_key": "your-api-key-here",
    "anthropic_version": "2023-06-01"
  }
}

交互命令

  • /help
  • /session
  • /sessions
  • /quit

已实现工具

  • list_files
  • read_file
  • search_text
  • write_file
  • replace_in_file
  • apply_patch
  • run_shell

系统提示词维护

系统提示词已抽离为独立模板文档维护：

  • internal/agent/prompts/system.md

运行时由 internal/agent/prompt.go 通过 go:embed 内嵌 Markdown 文档，并替换 {{WORKSPACE}}、{{APPROVAL_POLICY}} 占位符，因此修改提示词时不需要再直接编辑 Go 字符串常量。

Reviews (0)

No results found