feat: integrate fork work onto upstream main (squashed)

Squash-merge of feat/autofix-pr-test (69 commits) onto upstream/main
with -X ours strategy (upstream as authoritative for content conflicts).

Key features brought in from fork:
- LocalMemoryRecall + VaultHttpFetch tools (end-to-end wired)
- /local-memory, /local-vault, /memory-stores, /skill-store interactive panels
- /agents-platform, /schedule, /vault command scaffolding
- /login: switch / replace / remove of workspace API key
- statusline refactor (built-in status row, /statusline as info command)
- autofix-pr command + workflow

Conflict resolutions (upstream-wins):
- 10 .js command stubs kept from upstream (alongside fork's .ts implementations)
- src/components/BuiltinStatusLine.tsx accepted upstream's deletion
  (fork's wire-up references in StatusLine.tsx will be cleaned up next)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
unraid
2026-05-08 16:47:29 +08:00
parent 73e54d4bbc
commit 8945f08708
233 changed files with 40597 additions and 341 deletions

View File

@@ -0,0 +1,114 @@
# 内部命令解锁与 Stub 恢复总规划
> **状态**:规划阶段 → 即将进入实施
> **基于**:反向查阅 `C:/Users/12180/.local/bin/claude.exe` v2.1.123 字符串 + fork 代码残留扫描
> **验收**订阅用户视角claude-ai availability所有可恢复命令在 `/help` 出现且可调用
## 一、命令分级(基于反向查阅 + 代码残留)
### A. 已是完整实现,只需移到主 COMMANDS 数组 — **零代码工作量**
| 命令 | 行数 | 性质 | 订阅用户价值 |
|---|---|---|---|
| `/bridge-kick` | 200 | bridge 故障注入调试器RC 测试) | 中(开发/调试 RC 时) |
| `/init-verifiers` | 262 | 创建项目 verifier skillsquality-gate 自动化) | **高**quality-gate 高频功能) |
| `/commit` | 92 | git commit 命令 | **高**(每天用) |
| `/commit-push-pr` | 158 | commit + push + 创建 PR | **高**(高频开发流) |
### B. 底层完整 + 1 行 stub launcher仿 autofix-pr 模式恢复
| 命令 | 底层证据 | 工作量 |
|---|---|---|
| `/teleport` | `src/utils/teleport.tsx` 已 export 5+ utility官方 19 个 `tengu_teleport_*` 事件可对标 | ~150 行 launcher |
| `/share` | sessions API 已有(订阅 endpoint需 launcher | ~150 行 |
### C. 纯本地命令(无需 Anthropic 后端,可自主实现替代)
| 命令 | 字面意思 → 自主替代设计 | 工作量 |
|---|---|---|
| `/env` | dump 本地 env vars + config白名单字段 | ~60 行 |
| `/ctx_viz` | 当前会话 context 可视化messages 数 + token 分布 + role类似系统 `CtxInspect` 工具 | ~100 行 |
| `/debug-tool-call` | 列出最近 N 个 tool call 的 input/output | ~80 行 |
| `/perf-issue` | 本地 metrics 导出token 用量、响应延迟、cache hit、tool count写到 `~/.claude/perf-reports/` | ~120 行 |
| `/break-cache` | 强制下次请求清空 prompt cache在系统 prompt 后插入 ephemeral cache_control 标记) | ~50 行 |
### D. GitHub API 类(订阅用户可用,需 GitHub token
| 命令 | 设计 | 工作量 |
|---|---|---|
| `/issue` | 创建当前仓库的 GitHub issue`gh` CLI 或 GraphQL | ~150 行 |
### E. 不做(无替代价值或已有等价命令)
| 命令 | 不做原因 |
|---|---|
| `/onboarding` | 一次性引导,订阅用户不需要 |
| `/bughunter` | 已被 `/ultrareview` 完全替代 |
| `/good-claude` | Anthropic 内部反馈收集,无替代价值 |
| `/backfill-sessions` | 需要 Anthropic admin endpointfork 无后端 |
| `/ant-trace` | Anthropic 内部 trace 系统 |
| `/agents-platform` | Anthropic agents platform 集成 |
| `/mock-limits` | QA 内部测试用 |
| `/reset-limits` / `/reset-limits-non-interactive` | 需要 Anthropic admin endpoint 重置用户配额 |
## 二、实施顺序(全自主执行)
### Phase 1零代码移动5 分钟)⭐ 立即收益最大
操作:从 `INTERNAL_ONLY_COMMANDS` 移到主 `COMMANDS` 数组:
- `commit`
- `commitPushPr`
- `bridgeKick`
- `initVerifiers`
仅改 `src/commands.ts` 一处。
### Phase 2仿 autofix-pr 模式恢复(约 2 小时)
- Step 2.1`/teleport` launcher最易底层全在
- Step 2.2`/share` launcher
### Phase 3纯本地命令约 2 小时)
- Step 3.1`/env`
- Step 3.2`/ctx_viz`
- Step 3.3`/debug-tool-call`
- Step 3.4`/perf-issue`
- Step 3.5`/break-cache`
### Phase 4GitHub 类(约 30 分钟)
- Step 4.1`/issue`
### Phase 5验证
- `bun run typecheck`0 错误
- `bun test`:现有测试不破坏 + 新命令测试通过
- `bun run build`:生成 dist
- `bun --feature ...verify-*.ts`:每个新命令的注册验证脚本
## 三、风险与回退
| 风险 | 缓解 |
|---|---|
| 移到主数组后,命令依赖 Anthropic 内部 API 才能工作(如 `/bridge-kick` | 命令对象设 `isHidden: false` 但保留环境检查逻辑(如 RC 未启动时报错友好) |
| `/commit` 命令与用户 git workflow 冲突 | 先看 commit.ts 现状(已 92 行实现),不动逻辑,只改注册 |
| `/teleport``/autofix-pr` 类似的 source 字段问题 | 复用 `/autofix-pr` 学到的 lock pattern + skipBundle 决策 |
| 反向查阅误判(某命令官方公开但实际依赖内部 API | 命令实现失败时给清晰错误文案,不破坏会话 |
## 四、验收标准(订阅用户视角)
- [ ] `/help` 中显示新增/解锁的命令
- [ ] `/au` Tab 出现 `/autofix-pr` 补全(已修,待验证)
- [ ] `/te` Tab 出现 `/teleport` 补全
- [ ] `/com` Tab 出现 `/commit``/commit-push-pr`
- [ ] `/init-verifiers` 跑出 verifier skill 创建提示
- [ ] `/env` 显示当前 env / config
- [ ] `bun run typecheck` 0 错误
- [ ] `bun test` 全过
## 变更日志
| 日期 | 改动 |
|---|---|
| 2026-04-29 | 初版规划(基于反向查阅 v2.1.123 + 代码残留扫描) |