Skip to content

feat(cli): meebox 新增 pr refresh / version 命令并规整命令树 - #172

Merged
huhamhire merged 12 commits into
devfrom
feat/cli-refresh-command
Jul 2, 2026
Merged

feat(cli): meebox 新增 pr refresh / version 命令并规整命令树#172
huhamhire merged 12 commits into
devfrom
feat/cli-refresh-command

Conversation

@huhamhire

@huhamhire huhamhire commented Jul 2, 2026

Copy link
Copy Markdown
Owner

概述

给 meebox CLI 补两条实用命令，并借此规整命令树领域划分。

变更

新命令

  • meebox pr refresh — 触发一次立即轮询刷新（拉取所有连接的最新 PR、落本地），返回本轮变化计数（fetched / changed / added / removed / errors）；等价 GUI 的手动刷新。归入 pr 领域（刷新 PR 列表）。
  • meebox version — 同时返回客户端（CLI）+ 服务端（应用）版本（仿 docker version）；服务端不可达时仅显示客户端版本、退出码仍 0（根 --version flag 保留为快速客户端版本）。根层级系统性命令。

命令树规整（领域归类）

  • categories 从顶层移入 pr（它是 pr list 的筛选词表）。
  • 系统性命令（whoami / version）保留在根层级，不套领域组。
  • 归属看语义而非是否 PR 维度。

服务端

  • 新增 POST /api/v1/refresh（复用 GUI 同源 poller.tick）与 GET /api/v1/version（复用 buildAppInfo）。refresh 纯读远端 + 落本地，无远端写副作用。

规范沉淀（AGENTS.md）

  • 新增「领域归类」与「文档对齐」两条维护规范：CLI / API / GUI 是同一 service 层的薄前端，命令 / 端点镜像业务领域；CLI 改动须同步 arch / guide / skill 三类文档。

文档

  • arch（service-api 端点表 + cli 命令树/分组哲学）、guide（用法表）、skill（SKILL.md + README.md）全部对齐。

验证

CLI go vet / go test / go build 全过（含新增 refresh / version 用例）；desktop typecheck / lint / build 全过。

后续（不在本 PR）

routes.ts 按领域拆分到子文件（handler 已是薄适配层，仅注册 + 转接混在一处）——待端点增长后另起 refactor(service) 分支。

🤖 Generated with Claude Code

huhamhire and others added 5 commits July 2, 2026 11:03
@huhamhire @claude
docs(agents): 记录 CLI 改动的三类文档对齐规范（arch/guide/skill）
87543d8 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
feat(service): 本地 API 新增 refresh 与 version 端点
4166107 
- POST /api/v1/refresh：触发一次立即轮询刷新（复用 GUI 同源 poller.tick / prs:refresh），
  返回本轮计数汇总；纯读远端 + 落本地，无远端写副作用。
- GET /api/v1/version：返回服务端（桌面应用）版本，供 CLI 同时展示客户端 + 服务端版本。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
feat(cli): meebox 新增 pr refresh 与 version 命令，并规整命令树
bf9584a 
- pr refresh：触发一次立即刷新（POST /refresh），返回本轮变化计数；归入 pr 领域（刷新 PR 列表）。
- version：同时返回客户端（CLI）+ 服务端（应用）版本；服务端不可达时仅客户端、退出码仍 0
  （根 --version flag 保留为快速客户端版本）。根层级系统性命令。
- categories 从顶层移入 pr 领域（它是 pr list 的筛选词表）。
- 系统性命令（whoami / version）保留在根层级，不套领域组。
- 同步更新 SKILL.md / README.md（skill 交付形态）与集成测试。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(cli): 同步 refresh / version 命令与命令树调整
ea99cbd 
arch（service-api 端点表 + cli 命令树/分组哲学）、guide（用法表）三处对齐：根层级系统性命令
（whoami / version）+ pr 领域（含 categories / refresh）+ agent 领域。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(agents): 补充 CLI / API 命令与端点的领域归类规范
881e58a 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire huhamhire added enhancement New feature or request documentation Improvements or additions to documentation labels Jul 2, 2026
huhamhire and others added 7 commits July 2, 2026 11:41
@huhamhire @claude
refactor(service): 本地 API 路由按领域拆分，聚合层只做注册
9445757 
将 routes.ts 拆为 routes/ 子目录：system（whoami / version）、pr（列表 / 详情 / diff / 刷新 /
分类 / 评审写动作）、agent（Agent 操作），公共原语（Route 类型 / seg / NO_EVENT）归 shared；
routes/index 只做聚合注册与路径匹配、不含业务逻辑。与 CLI 命令树的领域划分对称。纯结构调整，
端点与行为不变。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
feat(cli): 新增 login 命令写入连接凭据，补齐配置管理闭环
f4c63da 
meebox login --token <token> [--server <url>]：把 token（与可选 server，默认 loopback）
持久化到 ~/.code-meeseeks/cli.yaml（0600 权限），后续命令免逐次传参。此前 CLI 只能读 cli.yaml
（Resolve）却无写入手段，login 补上写侧，使配置管理自洽。根层级系统性命令；纯本地写、不校验令牌
（可随后 whoami 确认）。

settings 增 Save() 与 DefaultAPIURL()（后者同时去重 Resolve 的默认兜底）。同步 SKILL.md / README.md。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(cli): 补充 login 命令的连接配置说明与命令表
ef911a0 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(readme): 核心特性强化 CLI / API 的外部 Agent 集成表述
de20115 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
feat(cli): SKILL.md 经 go:embed 内嵌二进制，新增 skill 命令自述用法
41bff27 
构建期用 go:embed 把 SKILL.md 内嵌进二进制，meebox skill 打印之——二进制即便脱离发布压缩包
（go install / 裸放 PATH）也能自述 agent 用法，且内嵌内容与随包 SKILL.md 构建期一致。根层级
系统性命令。刻意不做 --manifest 之类 function-calling JSON：skill 的消费形态是 markdown、非工具
schema 注入，真有此需求应从命令树生成而非另手维护。

Execute / newRootCmd 增 skillDoc 形参由 main 注入（embed 须置于 SKILL.md 所在的根包）。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(cli): 补充 skill 命令与 Agent Skill 集成一节（含框架无关接入）
3b35c1e 
arch 补 skill 命令与 go:embed / 不做 manifest 的设计说明；guide 新增「作为 Agent Skill 集成」
一节，说明投放即用、二进制自述、集成流程与边界，并澄清 SKILL.md 自动发现是 Claude 约定、
其它框架经 shell + meebox skill + --output json 接入。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire @claude
docs(cli): 补充仅有二进制时经 meebox skill 重建 SKILL.md 的 fallback 说明
3badea4 
guide「Agent Skill 集成」一节与 README 补充：手头只有二进制（缺压缩包 / SKILL.md）时，
可用 `meebox skill > SKILL.md` 从内嵌副本导出、就地重建 skill 目录，内容与二进制同源。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@huhamhire
huhamhire merged commit 87dbdb3 into dev Jul 2, 2026
2 checks passed
@huhamhire
huhamhire deleted the feat/cli-refresh-command branch July 2, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@huhamhire