# hand_source

**Repository Path**: zhao_jun_nan/hand_source

## Basic Information

- **Project Name**: hand_source
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hand_source

个人向移动端代码阅读与学习工具（**Android / iOS**）。从 Gitee 克隆公开仓库或导入 ZIP 到本机，浏览源码、**Python 跨文件跳转**、**行区间备注**，并可通过自配置的 **OpenAI 兼容接口** 辅助阅读。

## 文档

| 文档 | 说明 |
|------|------|
| [**docs/GUIDE.md**](docs/GUIDE.md) | **推荐首读**：架构导读、环境、**启动**、**打包发布**、**使用说明** |
| [docs/PRODUCT_SPEC.md](docs/PRODUCT_SPEC.md) | 产品范围与功能规格 |
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 技术架构、插件 API、数据与安全 |
| [mobile/README.md](mobile/README.md) | `mobile/` 目录说明与故障排除简表 |

## 最短启动路径（开发者）

Flutter 与 Android SDK / Xcode 就绪后：

```bash
make bootstrap          # 生成 mobile/android、ios 等，并 flutter pub get
cd mobile && flutter run
```

若未安装 `make`，见 [docs/GUIDE.md §4](docs/GUIDE.md) 或执行 `cd mobile && bash tool/bootstrap_platform.sh`。

**打 Android 安装包**：`cd mobile && flutter build apk --release`（详见 [GUIDE.md §5](docs/GUIDE.md)）。

## 当前范围（摘要）

- 仅 **移动应用**（非小程序）；源码默认在应用沙箱 `Documents/hand_source/workspaces/`。  
- **公开 Gitee HTTPS**；克隆支持系统 git 与 **HTTP 压缩包回退**（无 `.git` 时不可 pull）。  
- **AI**：用户自填 Base URL、Key、Model；Key 存安全存储。  
- **跳转**：首版可靠跨文件语义仅 **Python**（Tree-sitter）；其它语言为文本 + 简易高亮。

## 仓库布局

- `docs/` — 产品与架构文档  
- `mobile/` — Flutter 应用（`lib/`、`pubspec.yaml`；平台目录由 `bootstrap` 生成）  
- `Makefile` — `bootstrap`、`mobile-run`、`mobile-analyze`