# fn-minicode

**Repository Path**: yanfanVIP/fn-minicode

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiniCode（飞牛原生版）

飞牛 fnOS 原生 MiniCode 应用：本地运行的智能编码工作台，上下文工程、Plan 并行交付、知识图谱记忆。支持 Claude、GPT、OpenRouter、Ollama 等模型。

## 要求

- fnOS **V1.1.3100+**
- **x86_64**（`platform = x86`）

## 架构

```
浏览器 → 飞牛网关 /app/minicode → Unix Socket minicode.sock → MiniCode
```

- 网关前缀 `/app/minicode`：通过 `--webroot` 参数启动
- 启动模式：`minicode serve --type=sockets --data-dir=/var/apps/minicode/var/data --webroot=/app/minicode`
- 应用以 **root** 运行（[应用权限](https://developer.fnnas.com/docs/core-concepts/privilege)），MiniCode 以 **`TRIM_RUN_USERNAME`**（当前操作用户）启动
- 默认工作区：飞牛 `TRIM_PKGHOME`（通常为 `/vol1/@apphome/minicode`）
- 数据目录：`/var/apps/minicode/var/data`（全局配置、会话数据等）

## 打包

将预编译的 MiniCode 二进制放入 `app/server/minicode`：

```bash
# 下载最新版本（或从源码编译）
curl -fL "https://gitee.com/yanfanVIP/minicode/releases/latest/download/minicode-linux-amd64" -o app/server/minicode
chmod +x app/server/minicode
```

或从源码构建：

```bash
git clone https://gitee.com/yanfanVIP/minicode.git
cd minicode
(cd web && npm install && npm run build) && go build -o minicode .
cp minicode /path/to/fn-minicode/app/server/minicode
```

## 控制台

桌面另有 **MiniCode 控制台** 入口（iframe），功能：

- 启动 / 停止 MiniCode 服务（应用启动时**不自动**运行，需在控制台手动启动）
- 卡片方式管理项目目录（数据保存在 `var/data/projects.json`）
- 点击项目打开：`{当前域名}{gatewayPrefix}?workspace={项目路径}`

## 启动参数

| 参数 | 值 | 说明 |
|------|-----|------|
| `--type` | `sockets` | 使用 Unix 域套接字模式，无需暴露 TCP 端口 |
| `--data-dir` | `/var/apps/minicode/var/data` | 全局配置与缓存目录 |
| `--webroot` | `/app/minicode` | Web UI 与 API 的路径前缀 |

## 目录

```
app/www/index/              # 控制台前端
app/ui/index.cgi            # CGI 静态资源与 API
app/server/index-api.sh     # 控制台 API + 启停 MiniCode
app/server/minicode           # 内置 MiniCode 二进制
app/ui/config                 # 网关与应用入口
cmd/main                      # fnOS 生命周期（自包含，不引用其他目录）
```

## MiniCode 功能概览

| 能力 | 说明 |
|------|------|
| **Chat / Agent 双模式** | Chat 只读查阅代码库，Agent 完整读写与执行 |
| **Plan 模式** | 描述目标、锁定计划、拆解任务并在 Kanban 上并行执行 |
| **上下文工程** | 知识图谱 `memory_recall`、调用图按需召回、历史压缩 |
| **Agent 记忆** | Topic → Concept → Fact 层级 + 向量检索，跨会话保留上下文 |
| **多模型提供商** | Anthropic、OpenAI、OpenRouter、Ollama；支持自定义 OpenAI 兼容接口 |
| **单二进制自托管** | 内嵌 SolidJS 前端，无额外服务端依赖 |

## 文档

- [MiniCode 源码](https://gitee.com/yanfanVIP/minicode)
- [统一网关注册](https://developer.fnnas.com/docs/core-concepts/gateway-registration)
- [登录认证](https://developer.fnnas.com/docs/core-concepts/gateway-authentication)