行者

一款基于对话的 15 维度人格画像 应用。不是一次性测试，而是通过持续聊天，让 AI 从你的表达中捕捉信号，逐步解锁并刷新你的人格维度。

---

产品理念

传统人格测试给的是一张静态标签。行者认为人格是流动的：你关心什么、如何决策、在意谁的评价、容易为什么事焦虑……这些信息藏在你自然的对话里。

产品流程：

1. 冷启动：回答 3 个开场问题，生成初始 4 维度画像
2. 自由对话：像和朋友聊天一样倾诉或讨论
3. 信号提取：AI 从对话中抽取维度信号
4. 画像刷新：每 5 条消息重新计算 15 维度得分
5. 书单推荐：根据维度匹配推荐书籍

---

技术栈

• 前端：React 19 + TypeScript + Vite 7 + Tailwind CSS + shadcn/ui + Framer Motion
• 后端：Hono + tRPC 11 + Drizzle ORM
• 数据库：SQLite（本地文件 ./local.db，开发便捷）
• AI：DeepSeek（对话）+ SiliconFlow（Embedding）
• 状态管理：Zustand
• 部署：Vite 静态构建 + Node.js 后端（可选）

---

快速开始

1. 安装依赖

npm install

2. 配置环境变量

cp .env.example .env

关键配置：

# 数据库（SQLite 本地开发）
DATABASE_URL=file:./local.db

# AI
DEEPSEEK_API_KEY=sk-...
SILICONFLOW_API_KEY=sk-...

# 后端 JWT 签名
APP_ID=dev-app
APP_SECRET=dev-secret-at-least-32-characters

# OAuth（可选）
KIMI_AUTH_URL=https://auth.kimi.com
KIMI_OPEN_URL=https://open.kimi.com

3. 初始化数据库

npm run db:push

4. 本地开发

npm run dev
# 访问 http://localhost:3001

本地开发模式下，登录页提供「本地开发登录」按钮，可跳过 OAuth 直接创建测试用户。

5. 构建

npm run build
npm run check   # TypeScript 类型检查
npm run test    # 单元测试

---

目录结构

.
├── api/              # Hono + tRPC 后端
│   ├── auth-router.ts
│   ├── chat-router.ts
│   ├── profile-router.ts
│   ├── dimension-router.ts
│   ├── middleware.ts
│   └── lib/          # AI 封装、合规过滤、缓存等
├── db/               # Drizzle ORM schema 与迁移
├── contracts/        # 前后端共享类型
├── doc/              # 产品文档（中文）
├── src/              # React 前端
│   ├── pages/        # 页面（Home / Chat / Login / Settings 等）
│   ├── components/   # 组件
│   ├── stores/       # Zustand 状态
│   └── lib/          # 工具函数
├── .env.example
├── package.json
├── tsconfig.json
└── vite.config.ts

---

核心模块

• 15 维度定义：见 doc/02-15维度定义.md
• 书单数据：见 doc/03-书单数据.md
• AI 提示词：见 doc/06-全部Phase提示词.md
• 合规红线：见 doc/05-合规红线.md

---

合规说明

行者涉及心理健康相关内容，已内置内容安全机制：

• 屏蔽命理、风水、塔罗、占卜等话题
• 检测到高危表达时返回心理援助热线
• AI 回复避免过度拟人化表述

详情见 api/lib/compliance.ts。

---

License

MIT