# funcomputer

**Repository Path**: farfarfun/funcomputer

## Basic Information

- **Project Name**: funcomputer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-08
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# funcomputer

Google Colab / 云端开发环境的个人一次性配置脚本集合：挂载 Google Drive、检查 SSH agent、配置 Git、安装并启动 code-server（网页版 VSCode）、通过 natapp 做内网穿透、拉取 fun 系列仓库到 workspace。代码里硬编码了大量个人路径（如 `/content/gdrive/My Drive/core/configs/`）和 Git 账号邮箱，本质是作者自用的 Colab 环境初始化脚本，没有做通用化封装，也没有 CLI 入口，目前不在维护中。code-server / natapp 这两个后台常驻进程通过 `scripts/setup.sh` 统一管理生命周期，PID 与日志落在仓库的 `.run/` 目录下。

## 安装

该包未发布到 PyPI，只能从源码安装：

```bash
git clone git@github.com:farfarfun/funcomputer.git
cd funcomputer
uv sync --dev
```

## 结构

- `src/funcomputer/run/__init__.py`：`run_cmd(cmd)`，执行 shell 命令（传 list 时依次执行，遇到失败即抛出 `RuntimeError`）
- `src/funcomputer/config/core.py`：`config_all()` / `config_ssh()`，检查 `SSH_AUTH_SOCK` 是否指向已加载密钥的 SSH agent
- `src/funcomputer/install/config.py`：`config_all()` / `config_init()` / `config_ssh()` / `config_git()` / `config_workspace()`，检查 SSH agent、配置 git 用户名邮箱，并把 `funtool`、`funkeras`、`fundrive`、`funcomputer` 克隆到 `/root/workspace`
- `src/funcomputer/install/core_server.py`：`install_drive()` 挂载 Google Drive；`install_code_server()` 安装 code-server 并装一批 VSCode 插件；`start_code_server()` / `start_natapp()` 前台执行启动 code-server / natapp 内网穿透的命令本身（不做后台化）
- `src/funcomputer/workspace/core.py`：`init()`，创建 `/root/workspace` 并克隆 fun 系列仓库
- `scripts/setup.sh`：code-server / natapp 的统一生命周期管理入口（`start`/`stop`/`restart`/`run`/`status`），负责后台化、PID 文件与日志重定向，运行时文件落在 `.run/` 下。服务用 `setsid` 起在独立进程组里，`stop` 按进程组回收，不会留下孤儿进程

## 用法示例

```python
from funcomputer.install.core_server import install_drive, install_code_server
from funcomputer.install.config import config_all

install_drive()  # 挂载 Google Drive（需在 Colab 环境中运行）
config_all()  # 检查 SSH agent、配置 Git，并克隆 fun 系列仓库
install_code_server()  # 安装 code-server 及常用插件
```

安装完成后，通过 `scripts/setup.sh` 启动/停止 code-server（需先设置 `CODE_SERVER_PASSWORD` 环境变量）：

```bash
export CODE_SERVER_PASSWORD=xxx
./scripts/setup.sh start code-server
./scripts/setup.sh status code-server
./scripts/setup.sh stop code-server
```

natapp 同理，需要先设置 `NATAPP_AUTH_TOKEN` 环境变量：

```bash
export NATAPP_AUTH_TOKEN=xxx
./scripts/setup.sh start natapp
```

不指定服务执行 `status` 会报告两个服务的状态。运行命令不再接受无效的
`dev`/`prod` 参数；本仓库没有发布正式包，只有 README 安装章节所述的源码模式。

## 说明

代码中的路径（`/content/gdrive/...`）和 Git 账号邮箱（`src/funcomputer/install/config.py` 的 `config_git()`）是写死的个人配置，直接搬到其他环境大概率跑不通，需要按自己的情况修改。SSH 私钥和 PyPI 凭据不会从 Drive 复制，SSH 配置需使用 `SSH_AUTH_SOCK` 指向已加载密钥的 agent。**natapp token 和 code-server 密码并未硬编码**：`start_natapp()` 从显式参数或 `NATAPP_AUTH_TOKEN` 环境变量读取，`start_code_server()` 要求通过 `CODE_SERVER_PASSWORD` 环境变量提供密码，缺失时会直接抛出异常拒绝启动。测试覆盖公开 API 的命令生成、成功和失败路径，并用 mock 隔离外部命令。开发检查统一使用 `uv run ruff check .`、`uv run ruff format --check .` 和 `uv run pytest`。

---

## 关于 farfarfun

[farfarfun](https://github.com/farfarfun) 是一个专注于实用工具库的开源组织，
涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

- 🏠 组织主页：<https://github.com/farfarfun>
- 📦 PyPI：<https://pypi.org/user/niuliangtao/>
- 📧 联系：farfarfun@qq.com

本项目基于 [MIT](LICENSE) 协议开源。