# codegeek_work_desktop

**Repository Path**: hupeng0518/codegeek_work_desktop

## Basic Information

- **Project Name**: codegeek_work_desktop
- **Description**: 码上Work桌面端，一款面向个人、团队和企业真实工作交付的开源 AI 工作台。集成自然对话、办公文档生成、软件与数据项目、阶段化研发、Skills、插件、自动化、多模型执行引擎和本地安全管控，支持私有部署、企业授权、品牌定制与扩展分发。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="resources/icons/128x128.png" width="88" alt="码上Work Logo">
</p>

<h1 align="center">码上Work</h1>

<p align="center"><strong>从一句需求到文档、代码、测试与交付的本地优先 AI 桌面工作台</strong></p>

<p align="center">
  <a href="https://gitee.com/hupeng0518/codegeek_work_desktop/releases">下载应用</a> ·
  <a href="docs/operation-manual.zh-CN.md">使用手册</a> ·
  <a href="https://fast-token.top">Fast-Token</a> ·
  <a href="#定制化服务">企业定制</a> ·
  <a href="#参与开发">参与开发</a>
</p>

<p align="center">
  <img alt="Version 0.5.4" src="https://img.shields.io/badge/version-0.5.4-16775b">
  <img alt="Electron React" src="https://img.shields.io/badge/Electron-React-334155">
  <img alt="Local first" src="https://img.shields.io/badge/local--first-yes-16775b">
  <img alt="License MIT" src="https://img.shields.io/badge/license-MIT-334155">
</p>

<p align="center">
  <img src="docs/readme-assets/hero-workbench.png" width="100%" alt="码上Work 自然工作台">
</p>

码上Work是一款面向个人、团队和企业真实工作交付的开源 AI 桌面应用。它不止回答问题，而是把自然对话、办公文档、软件研发、数据分析、项目管理、自动化、Skills、插件和多模型执行引擎组织在同一个工作空间中，让任务真正落到文件、代码、测试结果和交付成果上。

## 为什么选择码上Work

- **围绕成果工作**：从需求输入持续推进到 DOCX、XLSX、PPTX、代码、测试报告和部署记录。
- **模型与引擎可切换**：支持 OpenAI 兼容模型服务，可配置 Codex CLI、Claude Code 等执行引擎。
- **本地优先**：项目文件、Git 操作、模型密钥和敏感配置默认保留在用户设备中。
- **覆盖完整项目流程**：统一管理需求、设计、开发、测试、部署和项目交付。
- **能力可持续扩展**：通过 Skills、插件和自动化沉淀办公、研发及行业工作流。
- **个人与企业均可使用**：既能作为个人桌面工具，也可接入企业账号、授权、分发和私有部署体系。

## 快速开始

当前桌面版本主要面向 Windows x64。已发布版本可从 [Gitee Releases](https://gitee.com/hupeng0518/codegeek_work_desktop/releases) 获取，安装后既可使用授权码进入，也可在联网时使用服务端账号登录。

从源码运行需要 Node.js 24 和 `package.json` 指定版本的 pnpm：

```bash
pnpm install
pnpm run dev
```

> 项目仍在持续迭代，运行环境、签名状态、已知限制和升级说明以对应 Release 为准。

## 从对话到真实交付

### 自然对话与多模型执行

自然对话页提供多轮会话、历史记录、附件、上下文管理、流式输出和停止执行。用户可按任务选择服务商、模型、执行引擎、推理强度及工作区权限。

支持 GPT、DeepSeek、Qwen、GLM、Kimi 等 OpenAI 兼容模型。Claude Code 为可配置执行能力，是否展示由应用配置和企业授权共同决定。

<p align="center">
  <img src="docs/readme-assets/model-settings.png" width="100%" alt="模型服务商与执行引擎配置">
</p>

<p align="center"><sub>服务商、API 地址、模型和执行引擎在同一处管理，模型凭证默认存储在本地。</sub></p>

### 办公文档与数据处理

内置会议纪要、正式文档、表格分析、报告摘要、汇报 PPT、工作邮件、翻译润色和工作计划八类结构化办公工作流。任务支持表单输入、附件拖放、放大编辑、生成进度和停止操作。

内置 OfficeCLI 可创建并检查真实的 DOCX、XLSX 与 PPTX 文件，而不只是输出一段聊天文本。

<p align="center">
  <img src="docs/readme-assets/office-workflows.png" width="100%" alt="结构化办公工作流">
</p>

<p align="center"><sub>通过结构化输入组织材料，让会议纪要、正式文档和汇报材料具备可审核的生成过程。</sub></p>

### 软件与数据项目

软件项目工作台覆盖需求迭代、快速 UI、方案定版、批量开发、自动测试、自动部署和项目交付七个阶段，并统一管理项目目录、会话、文件、Git、任务状态、执行日志和交付材料。

数据项目可记录输入文件、处理过程、运行结果和交付产物，使分析过程能够继续追踪和复用。

<p align="center">
  <img src="docs/readme-assets/project-delivery.png" width="100%" alt="七阶段软件项目交付流程">
</p>

<p align="center"><sub>阶段导航、对话执行、项目环境和任务状态始终保持在同一个工作上下文中。</sub></p>

### Skills、插件与自动化

码上Work支持内置、用户目录和工作区三级 Skills，并提供插件导入、启用、停用、更新和运行环境检测。团队可将重复的办公、研发、测试和部署步骤沉淀为可复用流程。

<p align="center">
  <img src="docs/readme-assets/skills-runtime.png" width="100%" alt="Skills 与插件管理">
</p>

<p align="center"><sub>统一管理内置与用户扩展，按任务为执行引擎注入真正可落地的专业流程。</sub></p>

第三方办公 Skills 的固定版本、校验值和许可证记录见 [THIRD_PARTY_SKILLS.md](THIRD_PARTY_SKILLS.md)。

## 核心能力

| 领域 | 能力 |
| --- | --- |
| AI 工作台 | 多轮对话、附件、上下文、流式输出、中断执行、运行统计和错误诊断 |
| 模型接入 | 多服务商、OpenAI 兼容协议、代理、模型切换和 Token 统计 |
| 执行引擎 | Codex CLI，以及可按配置启用的 Claude Code |
| 办公交付 | DOCX、XLSX、PPTX、邮件草稿和结构化办公任务 |
| 软件项目 | 需求、UI、方案、开发、测试、部署和交付七阶段流程 |
| 数据项目 | 数据文件、处理记录、结果预览、分析报告和产物管理 |
| 扩展生态 | 内置/用户/工作区 Skills、插件、扩展商店和运行环境包 |
| 自动化协作 | 手动与定时任务、过程记录、云文档、群通知和外部工作流 |
| 本地能力 | 文件系统、Git、SQLite 数据、运行环境检测和桌面生命周期 |

## 企业级能力

码上Work桌面端可配合企业服务端和管理平台形成内网或私有化部署方案。开源桌面端不强制依赖托管模型服务，企业能力按实际部署方式启用。

| 企业场景 | 支持能力 |
| --- | --- |
| 账号与组织 | 企业租户、个人用户、角色、登录和会话管理 |
| 授权控制 | 在线授权、个人授权码、离线授权、授权期限和功能范围 |
| 模型治理 | 私有模型、统一网关、服务商范围、模型范围和 Token 用量 |
| 扩展分发 | Skills、插件、桌面应用和运行环境包统一发布与升级 |
| 项目管理 | 项目摘要、处理记录、过程事件和协作信息留痕 |
| 运营配置 | 公告、服务入口、联系作者、价格和赞赏内容远程维护 |
| 品牌定制 | 企业名称、Logo、图标、功能组合和安装包配置 |
| 私有部署 | 企业内网、专属接口、代理、同步策略和本地数据隔离 |

企业可以保留统一管理能力，同时让模型 API Key、Webhook、服务器密码、项目源代码和本地文件继续保存在员工设备或企业内网中。

<p align="center">
  <img src="docs/readme-assets/enterprise-support.png" width="100%" alt="码上Work 企业服务与支持入口">
</p>

## Fast-Token 模型服务

[Fast-Token](https://fast-token.top) 提供统一的 AI 模型 API 接入，适合希望减少多服务商配置和接口适配工作的用户。

- 访问地址：<https://fast-token.top>
- 主要用途：申请和管理模型调用凭证，通过统一网关接入模型服务
- 应用接入：在码上Work设置中填写服务地址、API Key 和实际模型名称
- 开放性：Fast-Token 是可选服务，也可以接入其他 OpenAI 兼容接口或企业私有模型
- 隐私边界：模型凭证默认保存在本地，不进入源码仓库

> 可用模型、价格和服务条款以 Fast-Token 站点实时信息为准。

## 安全与隐私

- 模型 API Key、代理和外部系统凭据默认存储在本地
- 项目文件、Git 操作和执行引擎默认在用户设备运行
- 支持只读、工作区写入和完整访问等执行权限
- 支持离线授权、企业内网和可配置的数据同步策略
- 支持关闭不需要的执行引擎和外部服务
- 不要求将企业源代码上传到公共平台

安全问题请按 [SECURITY.md](SECURITY.md) 中的方式私下报告。请勿在公开 Issue 中提交 API Key、日志凭据、私有代码或内部地址。

## 定制化服务

面向企业、团队和行业客户提供以下定制与交付服务：

- 企业内网部署、离线环境和私有化交付
- 企业品牌、Logo、主题、功能组合和安装包定制
- GPT、DeepSeek、Qwen、GLM、Kimi及企业私有模型接入
- 账号、租户、授权、模型范围和用量管理平台
- 专属办公 Skills、研发流程、插件和行业工作流开发
- 飞书、钉钉、云文档、模型网关和内部业务系统集成
- 版本升级、备份、运行监控、故障支持、培训和持续维护

<p align="center">
  <img src="docs/readme-assets/contact-wechat.jpg" width="260" alt="联系码上Work作者">
</p>

<p align="center"><strong>微信扫码联系作者，沟通企业定制、私有部署与技术服务。</strong></p>

## 赞赏作者

码上Work核心代码持续保持开源。如果这个项目帮助你完成了实际工作，可以通过微信或支付宝赞赏作者。赞赏完全自愿，不影响开源版本的功能与使用权限。

<table align="center">
  <tr>
    <th>微信赞赏</th>
    <th>支付宝赞赏</th>
  </tr>
  <tr>
    <td align="center"><img src="docs/readme-assets/reward-wechat.jpg" width="260" alt="微信赞赏码"></td>
    <td align="center"><img src="docs/readme-assets/reward-alipay.jpg" width="260" alt="支付宝赞赏码"></td>
  </tr>
</table>

## 参与开发

```bash
pnpm run typecheck
pnpm run lint:check
pnpm run build
```

主要目录：

| 目录 | 说明 |
| --- | --- |
| `src/` | React、TypeScript、Vite 和 Tailwind CSS 页面与组件 |
| `electron/` | Electron 主进程、Host API、本地执行与数据存储 |
| `shared/` | Renderer 与主进程共享的类型和接口契约 |
| `resources/builtin/skills/` | 内置办公、研发、测试与交付 Skills |
| `branding/` | 码上Work品牌配置、图标和打包元数据 |
| `scripts/` | 品牌同步、运行环境准备、构建和打包脚本 |

Renderer 通过类型化 Host API 调用 Electron 主进程能力，不直接访问 IPC。完整工程说明见 [开发指南](docs/development-guide.zh-CN.md)，具体操作见 [使用手册](docs/operation-manual.zh-CN.md)。

欢迎贡献缺陷修复、文档、模型兼容性改进、Skills 和插件。功能改动应保持 Renderer、Host API、共享契约和文档一致，并提供与改动风险相匹配的验证。

## License

本仓库原创代码采用 [MIT License](LICENSE)。第三方依赖、运行环境和上游内容遵循各自许可证。