🚀 hwjcode

飞书原生 · Worktree 并行 · 自更新的 AI 编程 Agent

基于 Easy Code 深度定制的增强 fork，专为飞书团队协作而生

---

📖 这是什么？

hwjcode 是 Easy Code 的增强 fork，在原项目的 AI 编码能力之上，增加了三大核心能力：

1. 🦜 飞书原生集成

把 AI Agent 变成飞书机器人，在群聊里直接干活：

你在飞书群：帮我重构这个模块
                ↓
飞书 Bot → 创建独立 Worktree → Agent 在隔离环境中工作 → 提交代码

• 私聊：直接对话，像用 CLI 一样
• 项目群：「拉个群 + 项目路径」一键创建绑定工作目录的专属群
• 批量建群：一次性拆分任务到多个群并行开发，每个群自带独立 worktree + TASK.md 任务文档
• 实时流式：Agent 的思考过程和工具调用通过飞书卡片实时回传
• 自然语言指令：「提交代码」「查看修改」「放弃修改」直接触发 git 操作

2. 🌳 Git Worktree 并行隔离

多个 Agent 在同一仓库下互不干扰地并行工作：

ai-exam/                         ← 仓库根目录
├── .easycode/worktrees/
│   ├── ui-team/                 ← UI 组的隔离工作区（独立分支）
│   ├── api-team/                ← API 组的隔离工作区（独立分支）
│   └── test-team/               ← 测试组的隔离工作区（独立分支）
├── vibe-coding-题目.md
└── packages/

• 每个飞书群聊绑定独立 worktree，文件操作完全隔离
• /worktree status 查看改动 · /worktree commit 提交 · /worktree discard 丢弃
• worktree 正确建在 git root（而非子目录），包含完整仓库快照
• TASK.md 持久化任务文档（handoff 设计哲学：文档是最可靠的上下文）

3. 🔄 自更新机制

飞书里说一句「更新一下」，自动完成 npm 安装 + 进程重启：

• 外挂脚本模式：父进程退出 → npm cache clean → install latest → 拉起新进程
• SIGHUP 修复：外挂脚本脱离父进程 session，不被连带杀死
• npm cache 三重保险：cache clean --force + --prefer-online + --force
• 自动带上原启动参数（--feishu 等），无缝重启

---

📦 安装

npm install -g hwjcode

验证：

hwjcode --version

---

🚀 快速开始

CLI 模式（和原项目一样）

cd your-project
hwjcode

飞书网关模式（核心差异化）

hwjcode --feishu

首次启动会引导你完成飞书应用配置（App ID / Secret）。配置完成后：

1. 私聊机器人：直接对话即可，机器人绑定一个默认工作目录
2. 创建项目群：发送 拉个群 /path/to/project
3. 批量并行开发：告诉主 Agent 你的任务清单，它会自动拆分到多个群

---

🦜 飞书功能详解

项目群创建

操作	效果
拉个群 D:\my-app	创建群 + 绑定工作目录 + 自动检测 git 创建 worktree
拉个群 D:\my-app --agent claude-code	群消息自动派发给本机 Claude Code 执行
批量建群（Agent 自动）	一次性创建多个群，每个群独立 worktree + TASK.md

飞书命令

命令	说明
/help	查看帮助
/status	查看 CLI 版本、积分、模型、上下文大小
/model <name>	切换 AI 模型
/bind <路径>	绑定/切换群的工作目录
/worktree status	查看当前 worktree 的 git 改动
/worktree commit [msg]	提交修改并清理 worktree
/worktree discard	丢弃所有修改
/worktree create [name]	创建新 worktree
/sessions	查看本机 Agent 会话（Claude Code / Codex）
/update	自更新到最新版

自然语言触发

你说的话	触发的操作
「提交代码」	/worktree commit
「查看修改」	/worktree status
「放弃修改」	/worktree discard
「更新一下」	自更新到最新版

Agent 派发（ACP）

把编码任务转交给本机的 Claude Code 或 Codex 执行：

@cc 给 src/foo.ts 加单元测试          → 派发给 Claude Code
@codex 写个基准测试                    → 派发给 Codex
@cc:resume <sessionId> 继续上次的工作   → 续接历史会话

也可以通过 /bind <路径> --agent claude-code 设置群默认派发方。

---

🌳 Worktree 管理详解

工作流

建群 → 自动创建 worktree（独立分支）
  ↓
Agent 在隔离环境工作（文件互不干扰）
  ↓
/worktree status   ← 查看改了什么
/worktree commit   ← 提交到分支 + 清理
/worktree discard  ← 不满意？丢弃重来

TASK.md 任务文档

批量建群时，每个群的 worktree 根目录会自动生成 TASK.md：

# 任务规划

> 本文档由主 Agent 在建群时自动生成，描述本群 agent 的工作目标。
> 文件持久保存在工作区根目录，可随时查看或编辑。

---

（主 Agent 分配的具体任务描述）

Agent 首次收到消息时会被引导去读 TASK.md。这个文件：

• ✅ 持久 — 不会因 session 重建或 /compact 丢失
• ✅ 可见 — 终端 cat TASK.md 随时查看
• ✅ 可编辑 — 改了文件，Agent 下次读就是新内容

---

⚙️ CLI 原有功能

作为 Easy Code 的 fork，原项目的所有功能完整保留：

• AI 编码：代码生成、重构、Bug 修复、多语言支持
• 工具系统：read_file / write_file / shell / grep / glob / web_fetch / web_search 等
• MCP 协议：连接外部数据源和工具
• 自定义模型：OpenAI / Anthropic / 本地模型
• Hooks 钩子：在工作流节点注入自定义逻辑
• 会话管理：持久化 / 恢复 / 压缩 / 检查点
• 斜杠命令：/help / /model / /session / /mcp / /memory 等
• VS Code 扩展：CLI 伴侣 + 完整 UI 插件

详见原项目文档。

🛠️ 开发

git clone https://github.com/hwj123hwj/hwjcode.git
cd hwjcode
npm install
npm run build
npm run dev

常用命令

命令	说明
npm run build	构建所有包
npm run dev	开发模式运行
npm run test	运行测试
npm run lint	代码风格检查
npm run typecheck	TypeScript 类型检查
npm run release:version patch	版本号 bump

发布流程

npm run release:version patch   # bump 版本
git add -A && git commit        # 提交
git tag v1.1.xx && git push     # 打 tag 推送
npm publish --access public     # 发布到 npm

---

📋 与原项目的差异

功能	原 Easy Code	hwjcode fork
飞书集成	❌	✅ 网关模式 + 群聊 + 卡片 + 流式
Worktree 隔离	❌	✅ 并行开发 + 群聊隔离
自更新	❌	✅ npm + 外挂脚本 + SIGHUP 修复
批量建群	❌	✅ + TASK.md 持久化任务文档
Agent 派发	基础 ACP	✅ 增强（群默认绑定 + /sessions + resume）
包名	easycode-ai	hwjcode
命令名	easycode	hwjcode

---

📄 许可证

Apache License 2.0

---

⭐ 如果这个 fork 对你有帮助，请给个 Star！

Based on Easy Code by OrionStarAI