{"id":38554884,"url":"https://github.com/xuzeyu91/webcode","last_synced_at":"2026-01-26T11:04:53.137Z","repository":{"id":332523386,"uuid":"1134072945","full_name":"xuzeyu91/WebCode","owner":"xuzeyu91","description":"WebCode is a browser-based AI coding platform that lets you remotely run and control CLI coding assistants like Claude Code and Codex. Code from anywhere—subway, café, or couch—with just a web browser.","archived":false,"fork":false,"pushed_at":"2026-01-17T16:05:56.000Z","size":5776,"stargazers_count":177,"open_issues_count":4,"forks_count":21,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-17T17:46:47.670Z","etag":null,"topics":["aicoding","blazor","claude-code","codex","dotnet-core","vibecoding","webcode"],"latest_commit_sha":null,"homepage":"https://wc.tree456.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xuzeyu91.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-14T07:58:06.000Z","updated_at":"2026-01-17T17:18:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xuzeyu91/WebCode","commit_stats":null,"previous_names":["xuzeyu91/webcode"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/xuzeyu91/WebCode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuzeyu91%2FWebCode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuzeyu91%2FWebCode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuzeyu91%2FWebCode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuzeyu91%2FWebCode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xuzeyu91","download_url":"https://codeload.github.com/xuzeyu91/WebCode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuzeyu91%2FWebCode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28543497,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aicoding","blazor","claude-code","codex","dotnet-core","vibecoding","webcode"],"created_at":"2026-01-17T07:41:07.309Z","updated_at":"2026-01-26T11:04:53.130Z","avatar_url":"https://github.com/xuzeyu91.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WebCode\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"README_EN.md\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🚀 随时随地，AI 工作助手 | Your AI Workspace, Anywhere\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e远程驱动 AI 助手，支持编程、文档处理、需求分析、报告撰写等全方位工作场景\u003c/em\u003e\n\u003c/p\u003e\n\n---\n\n## 🌐 在线试用\n\n想要快速体验？无需安装，直接访问在线演示版：\n\n| 试用地址 | 账号 | 密码 |\n|----------|------|------|\n| **[https://webcode.tree456.com/](https://webcode.tree456.com/)** | `treechat` | `treechat@123` |\n\n\u003e ⚠️ **注意**：试用环境为演示用途，请勿存储敏感信息\n\n---\n\n## 💬 交流群\n\n扫码加入微信交流群，获取最新动态、反馈问题、交流使用心得：\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/qrcode.jpg\" alt=\"微信群二维码\" width=\"200\" /\u003e\n\u003c/p\u003e\n\n---\n\n## ✨ 核心特色\n\nWebCode 是一个**在线 AI 全能工作平台**，让你可以通过 Web 浏览器远程控制各种 AI CLI 助手，实现真正的**随时随地智能办公**——无论你在地铁上、咖啡馆里，还是躺在沙发上，只要有浏览器就能完成编程、文档处理、需求分析等各种工作！\n\n### 🎯 主要功能\n\n#### 💻 编程开发\n- **🤖 多 AI 助手支持** - 集成 Claude Code CLI、Codex CLI、GitHub Copilot CLI 等主流 AI 编程工具\n- **⚡ 实时流式输出** - 即时看到 AI 的思考和编码过程，打字机效果展示\n- **🎨 代码高亮预览** - Monaco Editor 代码高亮，支持多种编程语言\n\n#### 📄 文档处理\n- **📝 文档撰写** - 支持 Markdown、Word、PDF 等格式的文档生成与编辑\n- **🔄 格式转换** - 文档格式互转，满足不同场景需求\n- **📊 数据可视化** - 表格数据处理与图表生成\n\n#### 🎯 需求分析\n- **📋 需求文档生成** - 自动生成 PRD、用户故事、功能规格说明\n- **🔍 需求澄清** - AI 辅助需求分析与优化建议\n- **📈 优先级评估** - 智能评估需求优先级与工作量\n\n#### 📊 报告撰写\n- **📈 项目报告** - 项目进度、总结报告自动生成\n- **📉 数据分析报告** - 数据洞察与可视化报告\n- **💼 商务文档** - 商业计划书、提案文档等\n\n#### 🛠️ 通用特性\n- **📱 全平台支持** - 完整的移动端适配，手机、平板、电脑无缝切换\n- **📂 会话工作区** - 每个会话独立工作目录，文件隔离，安全可靠\n- **🔐 安全执行** - 沙箱环境，命令白名单，防注入保护\n\n## 🖥️ 支持的 AI CLI 工具\n\n### ✅ 已完整支持（流式JSON解析）\n\n| 工具 | 命令 | 特点 | 状态 |\n|------|------|------|------|\n| **Claude Code CLI** | `claude` | MCP 服务器、会话恢复、stream-json 输出、代理系统 | 🟢 已启用 |\n| **Codex CLI** | `codex` | 沙箱执行、网络搜索、Git 集成、JSONL 输出 | 🟢 已启用 |\n| **OpenCode CLI** | `opencode` | GitHub Models 集成、多模型支持、流式输出 | 🟢 已启用 |\n\n### 🔧 待扩展支持\n\n| 工具 | 命令 | 特点 | 状态 |\n|------|------|------|------|\n| **GitHub Copilot CLI** | `copilot` | GitHub 集成、细粒度权限 | 🟡 已配置，待适配 |\n| **Qwen CLI** | `qwen` | YOLO 模式、检查点、扩展系统 | 🟡 已配置，待适配 |\n| **Gemini CLI** | `gemini` | Google AI、简洁配置 | 🟡 已配置，待适配 |\n\n\u003e 📚 详细的 CLI 工具使用说明请查看 [cli/README.md](./cli/README.md)\n\u003e \n\u003e 💡 **扩展支持**：如需添加新的 CLI 工具适配器，请参考 `WebCode.Domain/Domain/Service/Adapters/` 目录下的现有实现\n\n## 📱 移动端支持\n\nWebCode 针对移动设备进行了全面优化：\n\n- **响应式布局** - 自适应手机、平板、桌面各种屏幕\n- **触摸优化** - 44px 触摸目标，手势支持，按压反馈\n- **iOS 适配** - 解决 Safari 100vh 问题，适配刘海屏\n- **横竖屏切换** - 无缝切换，内容不丢失\n- **虚拟键盘适配** - 输入时自动调整视口\n\n### 📱 移动端兼容界面\n\n- **顶部导航与工具入口** - 小屏优先布局，常用功能一键触达\n- **对话区气泡样式** - 阅读清晰、滚动顺滑\n- **底部输入栏与快捷操作** - 触摸友好，减少误触\n- **底部导航栏** - 对话/输出/文件/预览/设置快速切换\n\n![移动端界面](images/mobile.png)\n\n### 测试设备支持\n\n- ✅ iPhone SE / iPhone 12-14 / iPhone Pro Max\n- ✅ iPad Mini / iPad Pro\n- ✅ Android 手机（各尺寸）\n- ✅ Chrome / Safari / Firefox / Edge 移动版\n\n## 🧭 首次安装设置向导\n\n首次安装会进入设置界面（/setup），按步骤完成初始化配置：\n\n![设置向导 - 第一步](images/setup1.png)\n![设置向导 - 第二步](images/setup2.png)\n![设置向导 - 第三步](images/setup3.png)\n\n## 🖼️ 产品截图\n\n\u003e 以下截图来自项目内置演示素材，实际界面以当前版本为准。\n\n![代码编程助手](images/coding.png)\n![PPT/文档辅助](images/ppt.png)\n![Skills/工作流](images/skill.png)\n![游戏/创意示例](images/games.png)\n\n## 🚀 快速开始\n\n### 方式一：Docker 一键部署（推荐）\n\n**无需任何配置，30 秒启动！** 首次访问时，系统会自动引导您完成所有配置。\n\n```bash\n# 克隆项目\ngit clone https://github.com/xuzeyu91/WebCode.git\ncd WebCode\n\n# 一键启动\ndocker compose up -d\n\n# 访问 http://localhost:5000\n# 首次访问会自动进入设置向导\n```\n\n\u003e 📖 详细部署文档请参考 [DEPLOY_DOCKER.md](./DEPLOY_DOCKER.md)\n\u003e\n\u003e 🔧 需要预置环境变量/无人值守部署与内置 CLI 验证：参考 [docs/Docker-CLI-集成部署指南.md](./docs/Docker-CLI-集成部署指南.md)\n\n### 方式二：本地开发运行\n\n#### 环境要求\n\n- .NET 10.0 SDK\n- 已安装的 AI CLI 工具（如 Claude Code CLI、Codex CLI）\n\n#### 安装运行\n\n```bash\n# 克隆项目\ngit clone https://github.com/xuzeyu91/WebCode.git\ncd WebCode\n\n# 恢复依赖\ndotnet restore\n\n# 运行应用\ndotnet run --project WebCodeCli\n```\n\n应用将在 `http://localhost:5000` 启动，访问 `/code-assistant` 开始编程！\n\n### 配置 Claude/Codex 等 CLI（推荐界面配置）\n\n默认情况下无需编辑 appsettings.json：首次启动会进入设置向导（/setup），在 Web 界面完成初始化；之后可在“系统设置”中随时调整 Claude/Codex/OpenCode 等参数。\n\n仅在以下场景建议使用 appsettings.json / 环境变量进行预置：\n\n- 需要无人值守部署（CI/CD）\n- 需要把配置写死在镜像/配置文件中\n- 进行本地开发调试且希望用文件快速切换配置\n\n示例（高级用法）：\n\n```json\n{\n  \"CliTools\": {\n    \"Tools\": [\n      {\n        \"Id\": \"claude-code\",\n        \"Name\": \"Claude Code\",\n        \"Command\": \"claude\",\n        \"ArgumentTemplate\": \"-p \\\"{prompt}\\\"\",\n        \"Enabled\": true\n      },\n      {\n        \"Id\": \"codex\",\n        \"Name\": \"OpenAI Codex\",\n        \"Command\": \"codex\",\n        \"ArgumentTemplate\": \"exec \\\"{prompt}\\\"\",\n        \"Enabled\": true\n      }\n    ]\n  }\n}\n```\n\n## 🏗️ 技术架构\n\n```\nWebCode/\n├── WebCode/              # 主项目 (Blazor Server)\n│   ├── Components/          # Blazor 组件\n│   ├── Pages/               # 页面\n│   │   └── CodeAssistant/   # 编程助手页面\n│   ├── wwwroot/             # 静态资源\n│   └── Program.cs           # 应用入口\n├── WebCode.Domain/       # 领域层 (DDD)\n│   ├── Domain/\n│   │   ├── Model/           # 领域模型\n│   │   └── Service/         # 领域服务\n│   │       └── Adapters/    # CLI 适配器\n│   └── Repositories/        # 数据仓储\n└── cli/                     # CLI 工具文档\n```\n\n### 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| **前端框架** | Blazor Server + Tailwind CSS |\n| **代码编辑器** | Monaco Editor |\n| **AI 功能** | Microsoft Semantic Kernel |\n| **数据访问** | SqlSugar ORM (Sqlite/PostgreSQL) |\n| **实时通信** | Server-Sent Events (SSE) |\n| **进程管理** | System.Diagnostics.Process |\n\n## 📋 功能特性\n\n### 聊天与交互\n- ✅ 左右分栏布局（移动端上下布局）\n- ✅ 消息历史记录\n- ✅ 流式输出（打字机效果）\n- ✅ 快捷键发送 (Ctrl+Enter)\n- ✅ 清空会话\n\n### 预览与展示\n- ✅ 代码高亮预览 (Monaco Editor)\n- ✅ Markdown 渲染\n- ✅ HTML 实时预览\n- ✅ 原始输出查看\n- ✅ 多 Tab 切换\n\n### 工作区管理\n- ✅ 会话隔离工作区\n- ✅ 文件上传/下载\n- ✅ 文件树浏览\n- ✅ 自动清理过期工作区\n\n### 安全特性\n- ✅ 命令白名单验证\n- ✅ 输入转义（防注入）\n- ✅ 并发限制\n- ✅ 超时控制\n\n## 📚 文档\n\n- [快速启动指南](./docs/QUICKSTART_CodeAssistant.md)\n- [编程助手使用说明](./docs/README_CodeAssistant.md)\n- [CLI 工具配置说明](./docs/CLI工具配置说明.md)\n- [移动端兼容性说明](./docs/移动端兼容性优化说明.md)\n- [Codex 配置说明](./docs/Codex配置说明.md)\n- [环境变量配置](./docs/环境变量配置功能说明.md)\n\n## 💡 推荐 Skills\n\n提升 AI 编程助手能力的优秀 Skills 资源：\n\n- [**planning-with-files**](https://github.com/OthmanAdi/planning-with-files) - 基于文件的项目规划与任务管理技能\n- [**Anthropic Skills**](https://github.com/anthropics/skills) - Anthropic 官方 Skills 集合，提供多种 Claude 增强能力\n- [**UI/UX Pro Max Skill**](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - 专业的 UI/UX 设计与开发技能\n\n\u003e 💡 **提示**：这些 Skills 可以与 Claude Code CLI 等 AI 助手配合使用，增强代码生成、项目规划、UI 设计等能力。\n\n## 🛠️ 使用场景\n\n### 💻 编程开发\n- **移动编程** - 手机上随时处理代码任务，紧急 bug 修复不再受限\n- **远程开发** - 通过浏览器远程驱动 AI 助手，无需本地开发环境\n- **代码审查** - AI 辅助代码审查、测试用例生成、代码重构\n- **学习编程** - 初学者通过 AI 互动学习，获得即时反馈\n\n### 📄 文档工作\n- **技术文档** - API 文档、技术规范、系统设计文档撰写\n- **项目文档** - 项目计划、进度报告、总结文档生成\n- **用户手册** - 产品使用手册、操作指南、FAQ 文档\n- **内部文档** - 会议纪要、工作日志、知识库整理\n\n### 🎯 产品管理\n- **需求分析** - PRD 撰写、用户故事拆分、需求优先级评估\n- **功能设计** - 功能规格说明、交互设计文档、原型说明\n- **项目规划** - 里程碑规划、任务分解、资源评估\n- **数据分析** - 用户反馈分析、数据报告生成、趋势洞察\n\n### 💼 商务办公\n- **商业文档** - 商业计划书、项目提案、合作方案\n- **报告撰写** - 工作总结、分析报告、述职报告\n- **沟通协作** - 邮件撰写、通知公告、培训材料\n- **创意策划** - 营销方案、活动策划、内容创作\n\n## 🛠️ 高级配置\n\n### 工作区配置\n\n```json\n\"CliTools\": {\n  \"TempWorkspaceRoot\": \"D:\\\\Temp\\\\WebCode\\\\Workspaces\",\n  \"WorkspaceExpirationHours\": 24,\n  \"NpmGlobalPath\": \"\",\n  \"MaxConcurrentExecutions\": 3,\n  \"DefaultTimeoutSeconds\": 300\n}\n```\n\n| 配置项 | 说明 | 示例值 |\n|--------|------|--------|\n| `TempWorkspaceRoot` | 临时工作区根目录，用于存放会话隔离的工作文件 | `D:\\\\Temp\\\\WebCode\\\\Workspaces` |\n| `WorkspaceExpirationHours` | 工作区过期时间（小时），过期后自动清理 | `24` |\n| `NpmGlobalPath` | NPM 全局安装路径（可选，留空则自动检测） | `C:\\\\Users\\\\YourUsername\\\\AppData\\\\Roaming\\\\npm\\\\` 或留空 `\"\"` |\n| `MaxConcurrentExecutions` | 最大并发执行数 | `3` |\n| `DefaultTimeoutSeconds` | 默认超时时间（秒） | `300` |\n\n\u003e 💡 **提示**：\n\u003e - **Windows 用户**：NPM 全局路径通常为 `C:\\Users\\{用户名}\\AppData\\Roaming\\npm\\`\n\u003e - **Linux/Mac 用户**：NPM 全局路径通常为 `/usr/local/bin/` 或 `~/.npm-global/bin/`\n\u003e - 工作区目录建议使用绝对路径，确保有足够的磁盘空间\n\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 📄 许可证\n\n本项目采用 **AGPLv3** 开源许可证。\n\n- 开源使用：遵循 [AGPLv3](https://www.gnu.org/licenses/agpl-3.0.html) 协议\n- 商业授权：如需商业授权，请联系 **antskpro@qq.com**\n\n详细信息请查看 [LICENSE](LICENSE) 文件。\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🌟 让 AI 成为你的编程伙伴，随时随地，代码随行 🌟\u003c/strong\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuzeyu91%2Fwebcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxuzeyu91%2Fwebcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuzeyu91%2Fwebcode/lists"}