Skip to content
Vincent-chkPublic

About

this is a Claude-tool for 3M

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

3mClaude

从零实现一个本地 Claude Code Agent 系统(mini 版),接入任意 Anthropic 兼容 API 即可运行。

环境要求

  • Python >= 3.12(如果本地已有兼容版本,直接复用,不会重复安装)
  • 无需预先安装任何依赖库(Git、uv 等均由脚本自动处理)
  • .env 配置文件可以随时编辑,只需在启动 3m-core 之前配置好 API Key 即可

Docker 安装(无任何环境依赖)

git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude

docker build -t 3mclaude .
docker run -it --rm -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY 3mclaude

macOS / Linux 安装

# 1. 克隆项目
git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude

# 2. 配置 LLM API Key
cp .env.example .env
# 编辑 .env,填入你的 API Key(如 ANTHROPIC_API_KEY 或对应模型密钥)

# 3. 一键安装(自动检测 Git/uv/Python,缺什么装什么)
bash scripts/install.sh

# 4. 启动守护进程(终端 A,前台运行)
3m-core

# 5. 在另一个终端,体验 TUI 界面
3m-tui

Windows 安装

在 PowerShell 中执行(右键 → 以管理员身份运行):

# 1. 克隆项目
git clone git@github.com:Vincent-chk/3M_claude.git
cd 3M_claude

# 2. 配置 LLM API Key
copy .env.example .env
# 用记事本编辑 .env,填入你的 API Key

# 3. 一键安装(自动检测 Git/uv/Python,缺什么装什么)
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

注意: 如果安装过程中遇到 SSL 证书错误(常见于企业网络),脚本已内置 UV_NATIVE_TLS=true 环境变量自动使用系统证书。若仍有问题,可手动设置:

$env:UV_NATIVE_TLS = "true"

然后重新运行安装脚本。

启动方式与 macOS/Linux 相同:

# 终端 A — 启动守护进程
3m-core

# 终端 B — 启动 TUI 界面
3m-tui

使用 Makefile

make install    # 等同于 bash scripts/install.sh
make uninstall  # 卸载全局命令
make test       # 运行单元测试
make lint       # 代码检查

安装完成后,以下命令在任意目录均可直接使用

命令 说明
3m --version 查看版本
3m ping ping 守护进程
3m-tui 启动 TUI 终端界面(主要入口)
3m-core 启动守护进程
3m run --goal "..." 执行一次 Agent 任务
3m chat 多轮对话
3m trace 查看系统日志
3m core start 后台启动守护进程
3m core stop 停止守护进程
3m core status 查看守护进程状态

卸载

平台 命令
macOS / Linux bash scripts/uninstall.sh
Windows powershell -File .\scripts\uninstall.ps1

/skills 内置技能

在 TUI 对话中直接输入 /skill名 即可调用对应能力:

命令 说明
/init 分析当前项目,生成 .3m/context.md 初始内容
/plan 启动规划模式,通过 HITL 交互生成结构化实施规划文档
/orchestrate 用 planner → executor → reviewer 三阶段多 Agent 工作流完成复杂任务
/review 对指定路径做代码审查,输出严重/建议/可选三级分类
/summarize 将当前 session 对话压缩为人类可读摘要
/meeting-summary 读取会议记录文件,生成结构化的 HTML 会议纪要
/skill-create 引导创建新的自定义 skill,输出规范化的 SKILL.md 文件

自定义 skill 可放入 skills/ 目录,格式参考内置 skill 的 SKILL.md。


架构

3mClaude 的最终形态是:

  • 用户通过 3m CLI 或 3m-tui 连接到常驻的 3m-core 守护进程
  • 真正执行任务的是 Core daemon,CLI 和 TUI 只是客户端

这意味着:

  • TUI 崩了,Agent 任务不一定要跟着死
  • 后续可以同时接 CLI、TUI、Web 前端
  • 所有任务过程都能通过事件流订阅
  • 所有命令、响应、事件都要通过类型化协议通信
  • Agent 的工具调用、会话记忆、权限审批、上下文压缩,都在同一条运行链路里完成
用户目标
  → CLI / TUI
  → JSON-RPC over NDJSON
  → 3m-core daemon
  → AgentRunner
  → AgentLoop
  → LLM Provider
  → ToolRegistry
  → PermissionManager
  → EventBus
  → Session Store
  → TUI 实时渲染 / events.jsonl 持久化 / trace 回放

核心机制

不是单次调用大模型,而是实现了完整的本地 Agent 运行时链路:

  • 用户输入一个目标,Agent 能自己规划下一步
  • 模型不是只回答文本,而是能主动发起工具调用
  • 工具调用不是直接裸跑,而是有参数校验和权限审批
  • 执行过程不是黑盒,而是通过事件流实时展示到 TUI
  • 每一次 run 都能留下 events、trace、session 记录,方便复盘和排查
  • 多轮会话不是简单拼接历史,而是有 thread、notes、context 分层记忆
  • 上下文快爆了,不是粗暴截断,而是有水位检测和 compact 压缩
  • 复杂任务可以交给子 Agent,外部工具可以通过 MCP 接进来

About

this is a Claude-tool for 3M

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages