# anan-idea-manager

**Repository Path**: narc/anan-idea-manager

## Basic Information

- **Project Name**: anan-idea-manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 安安创意全生命周期管理工具

这是按照《安安创意全生命周期管理工具 PRD V2.0》实现的本地优先桌面应用。它帮助独立开发者把零散创意整理成可验证的项目，并持续记录版本、产物与复盘。

## 已实现功能

- 快速记录创意，支持快捷键 `⌘/Ctrl + K`
- 创意库筛选、编辑、优先级/难度评估、归档与回收站
- 支持本机 Ollama，以及用户自带 API Key 的 OpenAI Chat Completions 兼容接口
- AI 生成结构化分析或 PRD 草稿，采用“预览后采纳”机制
- 将创意转为项目，并保留双向来源关系
- 项目生命周期状态机、下一步、检查日期、版本和产物管理
- 扫描用户选择的本地目录，批量识别并导入已有工程，自动按路径去重
- 项目复盘队列与结构化复盘记录
- V1.2 可控 Agent 工作台：本地相似项目提醒、全局复盘与失败规律、版本迭代建议
- 经单次授权的 GitHub 公开仓库只读检索，以及不含密钥的工具调用审计
- JSON 全量备份、恢复和深浅色主题设置
- 桌面端 SQLite 持久化；浏览器模式使用 IndexedDB，并通过同源代理连接 AI 服务
- 个人账号注册/登录；同一用户在 Web 与桌面端之间增量同步核心业务数据
- 用户级本地数据库隔离、离线优先保存、幂等变更、revision 冲突保护与版本选择

## 本地开发

```bash
npm install
npm run dev:sync
npm run dev
```

前端开发地址固定为 `http://127.0.0.1:1422`，账号与同步接口固定为 `http://127.0.0.1:1421`。Web 端口与 `co-hold` 使用的 `1420` 错开；如果端口已占用，应结束占用进程，不要临时漂移到其他端口。

本地浏览器模式的远程 AI 请求会经过同一个 Vite 服务转发，以兼容未开放浏览器 CORS 的模型服务。代理只监听本机、只接受同源页面调用，不记录或保存 API Key。Cloudflare 部署则由 Pages Functions 提供同源代理；云端无法访问本机 Ollama，只能使用 HTTPS API 模型。

## 账号与多端同步

同步服务默认把账号、会话、设备、业务快照和增量日志写入 `.anan-sync/data.json`，该目录已加入 `.gitignore`。密码使用 scrypt 摘要保存，会话使用可撤销的随机 bearer token；所有记录均按 `userId` 隔离。

Web 与桌面端需要填写同一个同步服务地址。本地开发使用 `http://127.0.0.1:1421`；远程部署必须使用 HTTPS，并可通过以下环境变量配置：

```bash
ANAN_SYNC_HOST=127.0.0.1
ANAN_SYNC_PORT=1421
ANAN_SYNC_DATA_FILE=.anan-sync/data.json
ANAN_SYNC_ALLOWED_ORIGINS=https://ideas.example.com
```

默认同步创意、项目、版本、产物、复盘和状态历史。AI API Key、GitHub Token、本地模型、设备路径、缓存、AI 任务与 Agent 审计仅保存在本机。首次登录可以把匿名工作区合并进账号；登录后每个用户使用独立的 IndexedDB 或 SQLite 文件。

## Cloudflare 部署

正式环境使用 Cloudflare Pages 托管 Vue 前端、Pages Functions 提供账号/同步/AI 代理 API，并使用 D1 持久化云端数据：

- 前端页面：`https://anan-idea-manager.pages.dev`
- 后端健康检查：`https://anan-idea-manager.pages.dev/api/health`
- D1 数据库：`anan-idea-manager-db`

首次部署或新增迁移时执行：

```bash
npm run check
npm test
npm run cf:migrate:remote
npm run cf:deploy
```

HTTPS Web 环境默认使用当前页面同源 API；本地 Web 与 Tauri 桌面端仍默认使用固定同步端口 `1421`，也可以在账号页手动指定同一个 Cloudflare HTTPS 地址。

## 校验

```bash
npm run check
npm test
npm run build
```

## 桌面端

安装 Rust 工具链后运行：

```bash
npm run tauri dev
```

桌面端数据保存到应用本地 SQLite 数据库 `anan.db`。AI 功能默认连接 `http://127.0.0.1:11434`，也可以在设置页切换为 API 模型并填写服务地址、API Key 和模型名称。API Key 仅保存在本机，不进入 JSON 备份。