对话驱动
用自然语言描述功能，助手直接改代码。
用对话完成从想法到可运行应用
MonkeyCode-AI 是云端智能开发平台。你在对话里描述需求，编程助手会在隔离工作区里写代码、跑服务、生成预览链接，让开发、调试和上线在同一界面完成。
云端工作区
代码、依赖和进程都在沙箱里执行。
即时预览
Web 项目可自动启动并给出访问链接。
规范交付
需求、设计、任务列表和文档可按流程生成。
教程目录
1. 认识界面与第一次对话
界面三块区域
- 左侧「项目文件」面板：查看工作区目录、上传文件、打开代码。
- 中间对话区：向编程助手下发任务、追问细节、确认方案。
- 右侧/顶部能力入口：预览站点、发布作品。右上角【发布】按钮用于正式提交作品集。
助手运行在沙箱工作区中，默认路径是当前项目根目录。它能读写项目文件、执行开发命令，但无法直接访问你电脑上的本地路径。
推荐的第一句话
把目标、约束和验收标准一次说清，例如：
帮我做一个待办清单网页。 要求：支持新增、完成、删除；数据保存在浏览器；界面简洁，适配手机。 做完后启动预览，我先看效果。
说得越具体，返工越少。优先写「要做成什么」，再补充技术偏好。
2. 管理项目文件与本地上传
上传本地文件
助手不能读取你本机路径（如 ~/Documents/report.pdf）。需要先把文件放进工作区：
- 在界面左侧找到「项目文件」面板。
- 点击面板右上角的下拉菜单。
- 选择「上传文件」。
- 上传完成后，把工作区中的路径告诉助手，再继续分析或改代码。
适合上传的内容
- 需求文档、截图、设计稿、CSV / Excel 数据。
- 已有项目压缩包或关键源码文件。
- 接口说明、错误日志、测试用例。
3. 标准开发流程：需求、设计、实现
四步工作流
1提出功能想法，让助手整理成需求文档。
2确认需求后生成技术方案与架构说明。
3把设计拆成可执行任务列表，逐项实现。
4启动服务、打开预览、按反馈迭代。
相关产物通常落在 .monkeycode/specs/ 与 .monkeycode/docs/，便于后续会话继续接力。
可以直接说的指令
帮我梳理这个功能的需求文档。 根据需求出技术方案。 按任务列表开始实现登录模块。 给现有代码生成项目文档。 启动这个网站并给我预览链接。
一次只推进一个明确目标时，助手更不容易跑偏。
4. 在线预览与正式发布
开发阶段：在线预览
当你让助手「做个网页」「启动服务」「看一下效果」时，平台会在当前会话里拉起开发服务器，并返回可点击的预览地址。这是日常调试的默认路径。
- 静态 HTML、Vite / React / Vue、Python、Go、Java 等常见 Web 项目均可自动识别。
- 前后端分离项目会由前端反向代理转发
/api，因为预览环境通常只暴露一个端口。 - 环境闲置后会自动休眠，以对话或操作唤醒后继续开发。
正式上线：用户作品集
确认效果后，点击页面右上角【发布】，即可把当前应用提交到 MonkeyCode-AI 用户作品集。提交后需要管理员审核，通过后才会对外可访问。
正式发布是公开作品通道：站点会出现在作品集列表中。纯前端应用的数据只存在当前浏览器；带后端的容器应用运行时无外网、无持久化、单容器限额 1 核 1 GiB。
5. 提问方式、能力边界与常见问题
这样提问更高效
- 给出角色与场景：「我要给运营同学做数据看板」。
- 给出范围：「只改前端样式，不要动接口」。
- 给出验收：「列表要分页，空数据要有提示」。
- 给出现状：「登录页报 401，我已经上传了截图」。
助手能做的事
- 读写工作区代码、安装依赖、运行测试与开发服务器。
- 解析文档、理解截图、检索公开技术资料。
- 按规范生成需求、设计、任务列表和项目 Wiki。
明确不能做的事
- 攻击测试、漏洞扫描、爆破、挖洞或编写 exploit。
- 在环境里搭隧道、代理、内网穿透或保活面板。
- 读取或导出平台大模型 API Key。
- 直接操作你电脑上尚未上传的文件。
常见问题
- 预览打不开：把拒绝页上的 IP 发给助手，加入白名单后再试。
- 找不到刚才的文件：看左侧「项目文件」，确认上传是否成功。
- 想继续改已发布应用：在新会话里提供上次返回的更新凭证。
现在就可以开始
打开对话，用一句话描述你的产品目标。建议附上：用户是谁、核心功能三条、是否需要登录、希望多久看到第一版预览。
我想做一个团队周报收集页。成员填写本周进展和卡点，管理员可导出 Markdown。先出静态页面预览，数据和样式都要好看。
