github/claude-code-best
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ba74e0976c
claude-code-best/.impeccable.md
claude-code-best 2e9aaf4993
feat: ACP 协议版本 remote control (#293) 
* fix: 添加 usage 字段缺失时的防御性防护

第三方 API（如智谱 GLM）在某些流式响应中不返回 usage 字段，
导致 usage.input_tokens 访问 undefined 崩溃并连锁影响后续所有请求。

- claude.ts: content_block_stop 创建消息时 fallback 到 EMPTY_USAGE
- LocalAgentTask.tsx: usage 为 undefined 时提前返回
- tokens.ts: getTokenCountFromUsage 加 null guard 和 ?? 0
- cost-tracker.ts: input_tokens/output_tokens 加 ?? 0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: ACP Plan 展示 — 支持 session/update plan 类型的可视化

补全 PlanUpdate 类型定义（PlanEntry/Priority/Status），新建 PlanView 组件
渲染进度条、状态图标和优先级标签，在 ChatInterface 中处理 plan 更新逻辑。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: 穷鬼模式下跳过 verification agent 以节省 token

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* test: 补充 RCS 后端 + 前端测试覆盖 (+116 tests)

后端新增 3 个测试文件 (70 tests):
- automationState: normalize/snapshot/equals 纯函数
- client-payload: toClientPayload 协议转换
- transport-normalize: normalizePayload + extractContent

前端新增 2 个测试文件 (46 tests):
- utils: formatTime/statusClass/truncate/extractEventText 等
- api-client: getUuid/setUuid/api GET/POST 错误处理

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: RCS ACP 页面添加权限模式选择器 + 权限响应修复

- 新增权限模式选择器 UI（6种模式：默认/自动接受编辑/跳过权限/规划/不询问/自动判断）
- 权限模式通过 ACP _meta 从 web → acp-link → agent 全链路传递
- 修复 PermissionPanel 点击"允许"发送 cancelled 而非 selected 的 bug
- 权限模式和模型选择持久化到 localStorage
- acp-link 直接连接路径同步支持 permissionMode 透传

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: RCS Web UI 重构 + QR 修复 + ACP 扫描自动跳转

- RCS Web UI 组件全面重构: Dialog 迁移 Radix UI, lazy loading,
  主题系统改进, 组件样式优化
- IdentityPanel QR 码显示修复: requestAnimationFrame 延迟绘制
  解决 Radix Dialog Portal 挂载时序问题
- ACP QR 扫描自动跳转: IdentityPanel 扫描 ACP 格式 { url, token }
  后存储 sessionStorage 并跳转 /code/?acp=1
- 新增 ACPDirectView 组件: ACP 直连视图, 用 ACPClient 连接并
  渲染 ACPMain 聊天界面

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: ACP 权限管道改进 — 模式同步 + bypass 检测 + 统一权限流水线

- agent.ts: applySessionMode 同步 appState.toolPermissionContext.mode
- agent.ts: bypassPermissions 可用性检测 (非 root 或 sandbox 环境)
- permissions.ts: createAcpCanUseTool 接入 hasPermissionsToUseTool
  统一权限流水线, 替代原来分散的处理逻辑
- permissions.ts: 支持 onModeChange 回调, 模式变更时实时同步

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: acp-link 支持 permissionMode 默认值传递给 agent

客户端 (Zed/VS Code 等) 的 new_session 不一定携带 permissionMode,
导致 agent 收到 _meta: undefined, permission 回退到 default。

修复: handleNewSession 使用 fallback 链:
  客户端传值 > config.permissionMode > ACP_PERMISSION_MODE 环境变量

使用: ACP_PERMISSION_MODE=auto acp-link claude

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: 更新文档及说明

* fix: 修复类型错误

* chore: 提交脚本

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-18 21:54:22 +08:00

4.2 KiB
Raw Blame History

Impeccable Design Context

Users

Primary: Technical teams and enterprises using AI-assisted coding in production workflows.

  • DevOps engineers managing remote agents via RCS dashboard
  • Development teams collaborating through shared sessions
  • Individual developers using terminal CLI daily

Context: Used during focused work sessions — debugging, code review, agent orchestration. Users are in "get things done" mode, not browsing. They value efficiency but also appreciate warmth and personality.

Job to be done: Make advanced AI coding tools accessible and controllable, especially features that normally require enterprise accounts or Anthropic OAuth.

Brand Personality

3 words: Warm, Considered, Human

Voice: Like a knowledgeable colleague who's genuinely enthusiastic about the craft — not a corporate product manager. Community-first, open, slightly playful. Chinese developer community culture (贴吧/discord 温暖氛围).

Emotional goals: Confidence (this tool is solid), Warmth (this community is welcoming), Delight (small moments of personality make the difference).

References:

  • Anthropic's own design language — their clean, considered aesthetic with warm undertones. The terra cotta/burnt orange as a human accent. Lots of breathing room. Typography-forward.
  • NOT: Generic AI product (no ChatGPT blue, no gradient text, no "AI slop"). NOT corporate SaaS (no Salesforce-blue dashboards, no enterprise sterility).

Anti-references: Corporate enterprise dashboards, generic AI product pages, anything that looks like it was "designed by committee."

Aesthetic Direction

Theme: Light + Dark dual mode (user/system preference switch)

Tone: Anthropomorphic warmth meets terminal precision. The brand orange (Claude's terra cotta) is the thread that ties everything together — it's the human element in a technical world.

Typography: Clean, considered, with good hierarchy. Terminal-native for CLI; modern web fonts for Web UI (RCS dashboard, docs). Favor readability and personality.

Color:

  • Primary: Claude orange family (#D77757 / terra cotta)
  • Accent: Warm neutrals tinted toward orange
  • Semantic: Success/Error/Warning following Anthropic's established palette
  • Dark mode: Warm dark surfaces (not cold blue-black)

Differentiation: The CCB brand sits at the intersection of "serious tool" and "community project." It should feel like Anthropic's design principles applied to an open-source context — less corporate polish, more human craft. The mascot "Clawd" and the playful "踩踩背" naming hint at personality that the design should honor.

Scope: All Web UI — RCS control panel, documentation site, landing pages.

Design Principles

  1. Considered over clever — Every design choice should feel intentional, not trendy. If it doesn't serve the user, it doesn't ship.
  2. Warmth through subtlety — Orange tints on neutrals, breathing room in layouts, personality in copy. Not giant emoji or aggressive color.
  3. Density with clarity — Technical users need information density, but not chaos. Every pixel earns its place.
  4. Community voice — The design should feel like it was made by people who use it, not by a distant design team. Slightly rough edges are fine if they're honest.
  5. Anthropic's shadow — When in doubt, follow Anthropic's design instincts — the clean layouts, the generous spacing, the warm color temperature. Then add the community touch.

Existing Design Assets

Brand Colors (from theme system)

  • Claude Orange: rgb(215,119,87) / #D77757
  • Claude Blue: rgb(87,105,247) / #5769F7
  • Permission Blue: rgb(87,105,247)
  • Auto Accept Violet: rgb(135,0,255)
  • Plan Mode Teal: rgb(0,102,102)
  • Success: rgb(78,186,101)
  • Error: rgb(255,107,128)
  • Warning: rgb(255,193,7)
  • CCB text + orange play button icon
  • Dark/Light SVG variants in docs/logo/
  • Favicon: Orange circle #D97706 with white play triangle

Mascot

  • "Clawd" — terminal-art character with multiple poses
  • Theme-aware coloring

Theme System

  • 7 variants: dark, light, dark-ansi, light-ansi, dark-daltonized, light-daltonized, auto
  • 89+ semantic color tokens
  • Full documentation in packages/@ant/ink/docs/04-theme-system.md