新手易用性改进:工作区设置两小时未搞定、确认卡文案难懂、功能入口难找、额度消耗不透明
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 401
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
**提交人**: 用户6977
**客户端版本**: 0.1.44
---
## 使用场景
一位代码小白 / 初学者用户首次使用 Cindy 的真实经历:
- 仅在「修改工作区」这一件事上就花了约两小时仍未完成,且四个环节全部受阻:找不到设置 / 切换工作区的入口;一路弹确认卡不敢点;按指引操作后 AI 依然操作不了目标项目;到最后也没搞懂「工作区」到底是什么概念。
- 各类需要用户同意的弹窗文案无法理解,不知道同意后会发生什么、会不会对自己的项目造成不可逆影响,包括:权限确认卡(允许命令 / 改文件)、插件安装与授权弹窗、文件 / 目录交接确认、账号与设置类弹窗——几乎全部类型都让用户感到困惑。
- 功能对用户不透明:插件、技能、设置等功能入口难找,不问就不知道软件能做什么。
- 结果:还没体验到任何核心价值,赠送额度已消耗约一半,用户产生强烈挫败感,甚至担心软件会对自己的开发项目造成不可逆破坏。
## 诉求
- 新手不看文档、不问人,也能完成最基本的上手路径(打开项目 → 让 AI 干活 → 看到结果)。
- 每一个需要用户确认的弹窗,用大白话说清三件事:**要做什么、有什么风险、能否撤销**。
- 操作默认安全、可逆,并明确告知用户这一点,消除「会不会搞坏我的项目」的恐惧。
- 额度消耗透明:花在哪、剩多少,可见可查。
## 建议方案
1. 首次启动提供新手引导(onboarding),用一次真实的小任务带用户走完「选择工作区 → 下达指令 → 确认执行 → 查看结果」全流程。
2. 「工作区」等核心概念在界面内给出一句话解释和入口指引,不要让用户自己猜。
3. 确认卡片改用「人话」模板:动作 + 影响范围 + 是否可逆 + 建议选项;技术术语折叠进「详情」。
4. 在显眼位置(如侧边栏)提供功能导览 / 入口地图,让能力可见。
5. 增加额度用量页:本次会话消耗、剩余额度、哪些操作最费额度。
6. 对可能造成不可逆影响的操作给出显著标识,并默认提供回滚指引(如建议先创建 git 提交)。
---
**版本区域**: CN
**OS**: win32 x64 (10.0.26200)
**界面语言**: zh-CN
Contributor guide
Research direction
Start by mapping the first-run onboarding flow, workspace selection, confirmation cards, feature entry points, and quota usage view described in the issue. Done means a newcomer can open a project, instruct the AI, understand and confirm actions, see the result, and inspect quota usage without documentation or assistance.
Written by the indexing model from the issue text.
Assessment
- Domain
- frontend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100