zai-org / zai-org/feedback

[建议 / Feature] Mobile app is strong and useful — please prioritize everyday UX convenience with fast-follow small fixes

Open
#557 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

提交前确认 · Pre-submission checklist
  • I searched existing issues and confirmed this isn't a duplicate.
  • I've read CONTRIBUTING.md.
问题类别 · Category

UI / 界面体验 · UI / UX

涉及的 Agent 框架 · Agent framework

ZCode Agent(自研)

使用场景 · Use case

First, credit where it's due: the mobile app is genuinely strong and useful — the core (agent runs, sessions, remote control) works, and I use it daily. But it is not yet convenient: on mobile every check-in is short (one hand, on the go, seconds of attention), so small ergonomic frictions cost far more than the same friction would on desktop.

The community backlog shows small convenience items accumulating without a dedicated track, for example:

  • #454 — quota/context button unclickable on touch devices (CSS hover lock)
  • #228 — large sessions fail to open on phones (relay frame limit)
  • #255 — session titles truncated despite free space
  • #254 — wide tables/code blocks drag the whole page sideways (missing overscroll containment)
  • #92 — H5 remote page requires manual zoom (fixed-width layout)
  • #305 — no voice input / dictation on mobile

None of these are hard engineering problems individually — but together they define how "convenient" the app feels day to day.

建议方案 · Proposal
  1. A fast-follow UX-polish track for mobile. Batch several small ergonomic fixes (touch targets, layout overflow, truncation, zoom) into frequent minor releases, instead of bundling them with large feature releases. Most of the items above look like days, not months, of work.
  2. Treat "open session → catch up → act" as the primary mobile flow to optimize: reliable opening of large sessions (#228), always land on the newest message with a "jump to latest" affordance, quick session switching one-handed.
  3. Voice input (#305) as a first-class convenience feature — on mobile, dictation is often faster than typing.
预期价值 · Expected value

Mobile is where quick check-ins happen; per-check-in friction multiplies across many short sessions every day. Faster small-fix releases compound into a noticeably more convenient app without waiting for major versions — and they directly improve perceived quality of an already strong product.

你认为的优先级 · Your perceived priority

高 · High

你使用的 ZCode 版本 / 环境 · ZCode version / environment

ZCode mobile app (iOS), current App Store build (September 2026)

补充材料 · Additional context
  • Related: #556 (chat UX improvements — sticky latest prompt and inline media previews apply to mobile too), #469 (timeline/navbar UX).
  • Happy to help with repro steps, device details, or beta testing for any of the linked items.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

This is an umbrella proposal rather than a single implementation target; start by reviewing the referenced issues #454, #228, #255, #254, #92, and #305, plus related #556 and #469. Choose one concrete mobile UX fix with reproducible steps, then verify the selected behavior on an iOS device or the stated mobile flow.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios
Domain
mobile
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.