secondme-init

SecondMe Project Initialization

Initialize SecondMe project configuration, supporting direct parsing of App Info format or manual credential entry.

Tool usage: Use AskUserQuestion tool when collecting user input.

Workflow

Step Zero: Environment Check

Important reminder: The current directory will be used as the project root directory, and the Next.js project will be initialized directly in this directory.

Display the current working directory path for the user to confirm:
```
📂 当前工作目录: /path/to/current/dir
```

⚠️ The Next.js project will be initialized directly in this directory, please make sure you are running in a newly created empty folder.


2. 检查当前目录内容（除 `.secondme/`、`.git/`、`CLAUDE.md`、`.claude/` 等配置文件外）：
- **如果目录为空或仅有配置文件**：继续到下一步
- **如果存在其他文件**：发出警告
  ```
  ⚠️  当前目录不为空，包含以下文件/文件夹：
  - src/
  - package.json
  - ...

  继续操作可能会覆盖现有文件。是否确认继续？
  ```
- 使用 `AskUserQuestion` 让用户确认是否继续

---

### 第一步：检查现有配置

首先检查项目根目录是否存在 `.secondme/state.json`：

**如果存在**：
1. 读取并显示当前配置摘要：

📋 Existing configuration:

App Name: secondme-tinder
Client ID: 71658da7-***
Database: postgresql://***
Selected modules: auth, chat, profile
Current stage: init

2. 询问用户是否要修改配置或继续使用

**如果不存在**：继续到第二步

---

### 第二步：收集配置信息

首先询问用户是否已有 SecondMe 应用的 Client ID 和 Client Secret。

**如果用户没有凭证**，引导用户前往开发者平台注册：

📌 Don't have SecondMe app credentials yet? Please follow these steps to obtain them:

Visit the SecondMe developer platform:https://develop.second.me
Register and log in to your account
Create a new App
After creation, you will receive App Info (including Client ID, Client Secret, etc.)
Copy and paste the App Info here


提示用户获取到凭证后再继续。如果用户已有凭证，继续以下流程。

---

#### 方式一：解析 App Info 格式（推荐）

如果用户提供了以下格式的信息，自动解析：

App Info

App Name: secondme-tinder
Client ID: 71658da7-659c-414a-abdf-cb6472037fc2
Client Secret:
Redirect URIs:
- http://localhost:3000/api/auth/callback
- https://xxx.vercel.app/api/auth/callback
Allowed Scopes: user.info, user.info.shades, user.info.softmemory, chat, note.add, voice


**解析规则**：

| 字段 | 提取方式 |
|------|----------|
| `app_name` | 直接提取 App Name |
| `client_id` | 直接提取 Client ID |
| `client_secret` | 直接提取 Client Secret |
| `redirect_uri` | 优先选择 `localhost:3000` 的 URI（开发用） |
| `redirect_uris` | 保存所有 Redirect URIs 列表 |
| `modules` | 根据 Allowed Scopes 自动推断（见下表） |

**Scopes 到模块的映射**：

| Scope | 模块 |
|-------|------|
| `user.info` | `auth`（必选） |
| `user.info.shades` | `profile` |
| `user.info.softmemory` | `profile` |
| `chat` | `chat` |
| `chat` | `act` |
| `note.add` | `note` |
| `voice` | 记录但暂不生成代码 |

**解析后只需额外收集**：
- **Database URL**（必填）

#### 方式二：手动输入

如果用户没有提供 App Info，则依次收集：

1. **App Name** (可选)
   - 提示：请输入应用名称
   - 默认值：`secondme-app`

2. **Client ID** (必填)
   - 提示：请输入 SecondMe 应用的 Client ID
   - 如果用户没有，提示：请前往 https://develop.second.me 注册并创建 App 获取
   - 验证：非空

3. **Client Secret** (必填)
   - 提示：请输入 SecondMe 应用的 Client Secret
   - 如果用户没有，提示：请前往 https://develop.second.me 注册并创建 App 获取
   - 验证：非空

4. **Redirect URI** (可选)
   - 提示：请输入回调地址
   - 默认值：`http://localhost:3000/api/auth/callback`

5. **Database URL** (必填)
   - 提示：请输入数据库连接串
   - 提供格式示例：
     - PostgreSQL: `postgresql://user:pass@localhost:5432/dbname`
     - MySQL: `mysql://user:pass@localhost:3306/dbname`
     - SQLite: `file:./dev.db`

6. **功能模块选择**（多选）

---

### 第三步：确认模块选择

展示根据 Scopes 推断的模块（或用户选择的模块）：

| 模块 | 说明 | 备注 |
|------|------|------|
| `auth` | OAuth 认证 | **必选**，自动包含 |
| `profile` | 用户信息展示 | 可选 |
| `chat` | 聊天功能 | 可选 |
| `act` | 结构化动作判断（返回 JSON） | 可选，权限复用 `chat` scope |
| `note` | 笔记功能 | 可选 |

询问用户是否需要调整模块选择。

---

### 第四步：生成配置文件

#### 4.1 创建 `.secondme/state.json`

```json
{
  "version": "1.0",
  "stage": "init",
  "app_name": "secondme-tinder",
  "modules": ["auth", "chat", "profile"],
  "config": {
    "client_id": "71658da7-659c-414a-abdf-cb6472037fc2",
    "client_secret": "用户输入的 Client Secret",
    "redirect_uri": "http://localhost:3000/api/auth/callback",
    "redirect_uris": [
      "http://localhost:3000/api/auth/callback",
      "https://xxx.vercel.app/api/auth/callback"
    ],
    "database_url": "用户输入的数据库连接串",
    "allowed_scopes": ["user.info", "user.info.shades", "chat", "note.add"]
  },
  "api": {
    "base_url": "https://api.mindverse.com/gate/lab",
    "oauth_url": "https://go.second.me/oauth/",
    "token_endpoint": "https://api.mindverse.com/gate/lab/api/oauth/token/code",
    "refresh_endpoint": "https://api.mindverse.com/gate/lab/api/oauth/token/refresh",
    "access_token_ttl": 7200,
    "refresh_token_ttl": 2592000
  },
  "docs": {
    "quickstart": "https://develop-docs.second.me/zh/docs",
    "oauth2": "https://develop-docs.second.me/zh/docs/authentication/oauth2",
    "api_reference": "https://develop-docs.second.me/zh/docs/api-reference/secondme",
    "errors": "https://develop-docs.second.me/zh/docs/errors"
  },
  "prd": {}
}

4.2 Create or update `CLAUDE.md`

Create CLAUDE.mdin the project root directory, with the following content:

# SecondMe 集成项目

## 应用信息

- **App Name**: [app_name]
- **Client ID**: [client_id 部分隐藏]

## API 文档

开发时请参考官方文档（从 `.secondme/state.json` 的 `docs` 字段读取）：

| 文档 | 配置键 |
|------|--------|
| 快速入门 | `docs.quickstart` |
| OAuth2 认证 | `docs.oauth2` |
| API 参考 | `docs.api_reference` |
| 错误码 | `docs.errors` |

## 关键信息

- API 基础 URL: [从 state.json api.base_url 读取]
- OAuth 授权 URL: [从 state.json api.oauth_url 读取]
- Access Token 有效期: 2 小时
- Refresh Token 有效期: 30 天

> 所有 API 端点配置请参考 `.secondme/state.json` 中的 `api` 和 `docs` 字段

## 已选模块

[根据推断/选择动态生成模块列表]

## 权限列表 (Scopes)

根据 App Info 中的 Allowed Scopes：

| 权限 | 说明 | 状态 |
|------|------|------|
| `user.info` | 用户基础信息 | ✅ 已授权 |
| `user.info.shades` | 用户兴趣标签 | ✅ 已授权 |
| `chat` | 聊天功能 | ✅ 已授权 |
| `note.add` | 添加笔记 | ✅ 已授权 |

Step Five: Output Results

Display success message and next steps:

✅ SecondMe 项目配置已完成！

应用名称: secondme-tinder
已保存配置到 .secondme/state.json
已创建/更新 CLAUDE.md（包含 SecondMe API 文档链接）

已选择模块（根据 Allowed Scopes 推断）:
- auth ✓
- profile ✓ (user.info.shades)
- chat ✓
- note ✓

⚠️  重要：请将 .secondme/ 添加到 .gitignore 以保护敏感信息

下一步：
- 运行 /secondme-prd 定义产品需求（推荐）
- 或运行 /secondme-nextjs --quick 快速生成项目

Output files

File	Description
`.secondme/state.json`	Project status and configuration
`CLAUDE.md`	API reference documentation for consultation during development

App Info Format Example

Below is the complete App Info format, which users can copy directly from the SecondMe developer backend:

## App Info
- App Name: my-app
- Client ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- Client Secret: your-secret-here
- Redirect URIs:
  - http://localhost:3000/api/auth/callback
  - https://my-app.vercel.app/api/auth/callback
  - https://my-app.com/api/auth/callback
- Allowed Scopes: user.info, user.info.shades, user.info.softmemory, chat, note.add

Error Handling

App Info format cannot be parsed: Prompt format error, switch to manual input mode
Client Secret is a placeholder: Prompt the user to fill in the actual Secret
Database connection string format error: Display correct format example
Insufficient permissions to create directory: Prompt to check directory permissions