Hi，本周有奖互动话题为「你认为当前 iFlow CLI 的产品文档有哪些需要改进的地方？
」
使用iFlow CLI时，不知道从哪里开始
跟着文档操作，还是无从下手
别担心～请说出你的困惑和建议，一起让文档变得更清晰、更好用！
新年好礼升级
～评论区将抽选 5 位云股东获得 知乎新年日历
or 喝星爸爸一杯
哦
感谢大家的热心回复，反馈都已经收到啦，年后会将文档优化提上日程！以下为本周获奖的云股东：
也欢迎各位云股东继续在此贴留下你的需求！我们会持续关注产品文档的反馈，让 iFlow CLI 体验更好 
应该使用SDD工具去规划这样子文档会很清晰，我分享一下我的春节问答系统SDD创建的规划文件
design.md
## Context
春节知识问答系统旨在提供一个专门的平台，让用户能够通过网页端输入框提问关于春节的相关问题，并获得智能体的流式回复。系统将基于Flask框架构建Web应用，使用AgentScope框架作为智能体引擎，通过handoffs机制实现智能体分流，并集成mem0作为长期对话记忆系统。当前缺乏专门针对春节文化的智能问答系统，需要构建一个能够准确回答春节相关问题并提供流畅对话体验的解决方案。
## Goals / Non-Goals
**Goals:**
- 构建基于Flask的Web应用，提供用户友好的问答界面
- 集成AgentScope智能体引擎，实现高质量的春节知识问答
- 实现handoffs智能体分流机制，根据问题类型路由到专业智能体
- 集成mem0长期记忆系统，维护对话上下文和历史记录
- 支持流式回复，提供实时的问答体验
- 构建全面的春节知识库，覆盖传统习俗、历史、文化等多维度信息
**Non-Goals:**
- 替代现有的通用AI助手系统
- 提供其他节日的知识问答服务（仅专注于春节）
- 实现复杂的多媒体内容展示（主要关注文本问答）
- 集成语音识别或语音合成功能
## Decisions
1. **技术栈选择：Flask + AgentScope + mem0**
- 选择Flask作为Web框架，因其轻量级、灵活且易于集成AI组件
- 选择AgentScope作为智能体框架，因其支持复杂的AI Agent模式
- 选择mem0作为记忆系统，因其支持长期对话记忆和上下文管理
2. **智能体分流策略**
- 基于handoffs实现智能体分流，将问题按类型分类（如历史类、习俗类、文化类等）
- 每个专业智能体负责特定领域的春节知识问答
- 实现智能路由机制，确保问题被正确分配到对应的智能体
3. **前端交互设计**
- 采用简洁的聊天界面设计，突出问答功能
- 支持流式文本显示，提供实时回复体验
- 实现对话历史记录和查看功能
4. **知识库构建策略**
- 构建分层知识库结构，包含基础信息层、深度解析层和互动问答层
- 采用结构化数据存储，便于智能体快速检索和理解
## Risks / Trade-offs
[Risk: 智能体回答准确性不足] → Mitigation: 建立知识库验证机制，引入多源验证和人工审核流程
[Risk: 流式回复延迟影响用户体验] → Mitigation: 优化智能体响应速度，实现响应缓存和预加载机制
[Risk: 长期记忆系统存储成本过高] → Mitigation: 实现记忆压缩和清理策略，设置合理的记忆保留期限
[Risk: 春节知识覆盖不够全面] → Mitigation: 建立知识库持续更新机制，邀请文化专家参与内容审核
[Risk: 系统并发处理能力不足] → Mitigation: 设计可扩展的架构，支持智能体池化和负载均衡
proposal.md
## Why
随着春节文化的传播和数字化进程的推进，需要一个专门的春节知识问答系统，帮助用户了解春节传统习俗、文化内涵、历史背景等相关知识。当前缺乏一个专门针对春节知识的智能问答系统，用户难以快速获取准确、全面的春节相关信息。本系统将结合AI技术为用户提供流畅的春节知识问答体验，支持用户在网页端输入问题并获得智能体的流式回复。
## What Changes
- 新增基于Flask的Web应用框架，提供用户界面和API接口
- 集成AgentScope框架作为智能体引擎，处理用户问题并生成回答
- 实现handoffs机制，根据问题类型将请求分发到不同的专业智能体
- 集成mem0作为长期对话记忆系统，维护用户对话上下文
- 开发春节知识问答前端界面，支持用户输入和流式回答显示
- 构建春节知识库，包含传统习俗、历史、文化等多维度信息
### 新增功能
- **春节知识问答接口**: 提供用户提问和智能体回答的API
- **智能体分流系统**: 根据问题类型路由到不同专业智能体
- **对话记忆管理**: 基于mem0的长期记忆系统
- **前端交互界面**: 网页端问答界面
### 修改功能
- **智能体交互**: 增强智能体对春节知识的理解和回答能力
- **对话管理**: 添加长期记忆和上下文理解功能
## Capabilities
### New Capabilities
- `flask-web-app`: 基于Flask的Web应用框架，提供用户界面和API接口
- `agentscope-integration`: AgentScope智能体引擎集成，处理春节知识问答
- `handoff-routing`: 智能体分流机制，根据问题类型路由请求
- `mem0-memory`: mem0长期对话记忆系统集成
- `chinese-new-year-knowledge`: 春节知识库构建和管理
### Modified Capabilities
- `ai-agent-interaction`: 增强智能体对春节知识领域的理解和回答能力
- `conversation-context`: 添加长期记忆和上下文管理功能
## Impact
- 后端API需要新增春节知识问答相关接口
- 需要集成Flask、AgentScope、mem0等多个框架和库
- 前端需要开发专门的问答界面
- 需要构建和维护春节知识库
- 系统架构需要支持智能体分流和长期记忆功能
- 可能需要与现有AI助手系统集成
tasks.md
## 1. 项目设置和基础架构
- [x] 1.1 创建Flask项目结构和基础配置
- [x] 1.2 设置项目依赖（Flask, AgentScope, mem0等）
- [x] 1.3 配置项目环境和开发工具
## 2. Flask Web应用开发
- [x] 2.1 创建基础Flask应用和路由
- [x] 2.2 开发用户输入界面（HTML/CSS/JS）
- [x] 2.3 实现API端点用于处理用户查询
- [x] 2.4 实现流式响应功能
## 3. AgentScope集成
- [x] 3.1 集成AgentScope框架到项目
- [x] 3.2 配置基础AI代理
- [x] 3.3 实现与Flask应用的连接
## 4. Handoff路由机制
- [x] 4.1 实现问题分类算法
- [x] 4.2 开发路由逻辑到不同专业代理
- [x] 4.3 实现代理间的手动切换功能
## 5. mem0记忆系统集成
- [x] 5.1 集成mem0库到项目
- [x] 5.2 实现对话历史存储功能
- [x] 5.3 实现上下文检索和应用
## 6. 春节知识库构建
- [x] 6.1 创建春节知识数据结构
- [x] 6.2 收集和整理春节相关知识
- [x] 6.3 实现知识库的存储和检索功能
## 7. 专业智能体开发
- [x] 7.1 创建历史类问题专业代理
- [x] 7.2 创建习俗类问题专业代理
- [x] 7.3 创建文化类问题专业代理
## 8. 系统集成和测试
- [x] 8.1 集成所有组件到完整系统
- [x] 8.2 进行端到端功能测试
- [x] 8.3 优化性能和用户体验
## 9. 部署和文档
- [x] 9.1 准备部署配置
- [x] 9.2 编写用户使用文档
- [x] 9.3 创建系统维护指南
目前感觉文档中的内容还是比较分散，如果能有一篇实操的教程，新手可能会更容易上手。
在我用下来的这段时间，经常会忘记 /chat resume 和 /chat save 导致我关闭cli，下次再打开就看不到之前的记录了，这点还是很让我苦恼的~
建议要夯实iflow cli最最基础功能，要多关注使用者反馈，要从用户角度出发，要稳定、好用、易用;确保这一最基础功能不断迭代的情况下，扩围增加skill、MCP、command等功能，因为无论增加啥功能都是提高iflow cli效率，锦上添花！最最基础功能才是核心竞争力；对于高手来说只要iflow cli基础功能足够优秀，完全可以基于iflow cli手搓clawdbot.
文档作为一个参考的载体，简略无可厚非，但是对于关键步骤我认为还是要细致
1.建议给操作步骤添加终端截图，新人依赖模仿和效果来验证操作的真实性，没有真实效果，就缺少了参考的意义
建议在「skill」章节补充安装截图
2.软件的迭代是日新月异的，文档的更新也应该迭代，比如：本地安装skills，现在的工作流把skillls都归拢了，但是并没有明确的指出工作流/skills即使不用发布也是可以本地正常安装使用的，满足私有化个性化需要，文档的不明确，就减少了创作的热情，并且实际使用过程中，文档一般指向的是/skills，也没有明确指出应该/+技能名称,或许是/skills refresh刷新不出来本地安装的内容（延迟等）问题，所以导致体验并不好
感觉可以添加一个网页的问答助手，毕竟有些功能根据使用者的惯用工具不同，描述有偏差，直接通过文档的搜索不一定能搜出来，而且文档的搜索功能没有模糊搜索，比如 iflow cli 的 sandbox 功能，如果搜索 沙盒 就搜索不到，需要搜索 沙箱才能找到，虽然这能通过模糊搜索实现，但是毕竟是ai产品，一步到位上问答助手，让问答助手帮助用户搜索这更能提升用户体验
只把AI修改的文件 做历史记录 做检查点 没有修改的不要管 这样能显著减少.iflow文件夹的大小
1. 建议
文档里增加「用户角度的最佳实践」（真正 C 端、实战向）。
从论坛里筛选、整合优秀用户实践，在 CLI 产品文档里做归集。
2. 理由
更贴近实战：来自真实使用体验，而不只是功能说明。
更容易共鸣：看到「别人怎么用、怎么踩坑、怎么解决」，更容易跟着用。
形成规模效应：论坛优质内容沉淀到官方文档，新用户一站式学习，同时激励更多人分享。
建议+1 ： 对于动手能力教弱的同学，可以考虑出个视频教学系列
在setting.json中开启checkpoint
现在工作区文件权限隔离是否可以对skills这类全局生效的例外？感觉设计不合理，skills的信息全局维护，在项目中使用的时候，调用skills就没有权限访问了，只能手动/Directory add 添加iflow的skills路径
1、可以将命令行的 /qa 集成到文档的搜索里。
比如这样：
2、搜索增加搜索历史
比如这样：
3、将更多论坛里的优秀使用案例放到文档里，甚至可以单开一页（比如这次的春节活动：iFlow CLI 新春创造营）
4、一些功能可以做成视频进行演示（发到b站，贴一个视频链接到文档里）
比如这个文档，单纯的文字说明我觉得不太够：https://platform.iflow.cn/cli/features/smart-mode
5、手机端访问时，没法看到这个章节侧栏，影响使用。
自定义skill，agent等使用文档需要完善，自定义一些规则撰写等官方支持较少
（追加内容）
附图：
希望可以写的详细一点，最好能有教程，目前官方文档对于新手真的不太友好。如果 iFlow CLI 能具备教用户如何使用iFlow CLI更好，比如我想知道自定义skill如何弄向他提问可以给我教程，或者像楼上说的官方文档做一个问答助手也可以。
同意哇！
流式输出和gui界面我觉得很重要。k2.5都支持视觉了，界面里面直接看到图片肯定比命令行好太多了。流式输出也很重要，碰到慢的模型，可以确认它有没有死掉
mcp工具是门槛低体验收益最大的功能，极大增强了iflow的扩展性与可靠性，但是在iflow cli里面，虽然配置有/mcp online但是没有配置/mcp online search功能，只得到浏览器上去检索，这就比较麻烦了…
难道就没有人说最应该支持的语言服务器吗？这玩意儿才是真正有用的
还有就是登录方式太狗屎了。本来 cli工具就是提供在只有终端能访问的情况下可以使用的。但是强制要跳转到浏览器进行登录。我服务器又没有图像界面，我平时用安卓平板躺在床上用。安卓端的浏览器的cookies也很容易浏览器自动清理，导致又必须下床拿手机接收验证码，然后浏览器才能登录，浏览器登录完再给iflow登录。真的难受死了
说好的auth2方式自动续期，原来是自动跳转浏览器，登录一次才能续期
