makecindy / makecindy/cindy

新手易用性改进:工作区设置两小时未搞定、确认卡文案难懂、功能入口难找、额度消耗不透明

Open
#2,441 1 comment 0 reactions 0 assignees View on GitHub
feature
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.