pleaselogit (Lukasedv)

请登录

反馈情报平台 --自动发现来自Microsoft 365渠道的用户反馈，对现有的GitHub问题进行重复数据消除，并为未跟踪的反馈创建新问题。

与 和 微软WorkIQ MCP.

它的作用

PleaseLogIt连接到您的M365环境（电子邮件、团队聊天、团队频道、会议），以查找用户对您产品的反馈。然后，AI代理：

1. 提取物 可操作的反馈项（错误报告、功能请求、投诉、建议）
2. 划分 每个项目都有情感和优先级
3. 火柴 针对现有GitHub问题的反馈以查找重复项
4. 创建 新的GitHub Issues提供无与伦比的反馈——自动

所有这些都有实时进度记录，因此您可以准确地看到代理正在做什么。

建筑

┌──────────────────────────────────────────────────────────┐
│  Next.js Web App (UI + API Routes)                       │
│  ├── Projects & Scan Targets management                  │
│  ├── Scan execution with live progress logs              │
│  └── Feedback dashboard with issue linking               │
├──────────────────────────────────────────────────────────┤
│  AI Agent (GitHub Copilot SDK)                           │
│  ├── MCP Server: WorkIQ — queries M365 data              │
│  ├── MCP Server: GitHub — reads/creates issues           │
│  └── Model: claude-sonnet-4.6 (configurable)             │
├──────────────────────────────────────────────────────────┤
│  SQLite + Prisma ORM                                     │
│  └── Projects, Triggers, ScanRuns, FeedbackItems, Logs   │
└──────────────────────────────────────────────────────────┘

先决条件

• Node.js 18+
• GitHub Copilot命令行界面 已安装并验证(安装指南)
• GitHub Copilot订阅 （或BYOK配置）
• 微软365 访问与 WorkIQ管理员同意 为您的租户配置

入门指南

1.克隆并安装

git clone https://github.com/Lukasedv/pleaselogit.git
cd pleaselogit
npm install

2.建立数据库

npx prisma migrate dev

这将创建一个本地SQLite数据库(prisma/dev.db).

3.运行开发服务器

npm run dev

打开 http://localhost:3000.

4.配置项目

1. 首选 项目 → 新项目
2. 输入名称和GitHub存储库(owner/repo)应在哪里跟踪问题
3. 添加 扫描目标 --配置要搜索哪些M365通道以及要运行哪些查询
4. 点击 运行扫描 启动AI代理

扫描的工作原理

当您触发扫描时，将执行以下流水线：

For each enabled Scan Target:
  1. Create a Copilot SDK session with WorkIQ + GitHub MCP servers
  2. Send a natural language query to WorkIQ (e.g. "find feedback about login bugs in emails")
  3. AI agent extracts and classifies feedback items from M365 data
  4. Store results in database

After all targets are scanned:
  5. AI agent fetches existing GitHub Issues from the configured repo
  6. Semantic matching: compare each feedback item against existing issues
  7. Link matched feedback to existing issues
  8. Create new GitHub Issues for unmatched feedback items

进度是实时记录的——您可以在发生时看到工具调用、步骤转换和结果。

扫描目标类型

项目结构

src/
├── app/                          # Next.js App Router
│   ├── api/                      # API routes
│   │   ├── projects/             # Projects CRUD + scan + feedback
│   │   ├── scans/                # Global scan runs listing
│   │   └── settings/             # App settings
│   ├── projects/                 # Project management UI
│   │   └── [id]/
│   │       ├── page.tsx          # Project detail + scan targets + scan runner
│   │       └── feedback/         # Feedback dashboard
│   ├── scans/                    # Global scans view
│   └── settings/                 # Settings page
├── lib/
│   ├── copilot.ts                # CopilotClient singleton + session factory
│   ├── scanner.ts                # Scan orchestration pipeline
│   ├── issue-matcher.ts          # Semantic matching against GitHub Issues
│   ├── issue-creator.ts          # Auto-create GitHub Issues
│   ├── send-with-events.ts       # Event-based prompt sending (no timeout)
│   ├── scan-logger.ts            # Real-time scan progress logging
│   ├── prisma.ts                 # Prisma client singleton
│   └── providers/                # Extensibility interfaces
│       ├── feedback-channel.ts   # FeedbackChannelProvider interface
│       ├── workiq-channel.ts     # WorkIQ implementation
│       ├── issue-tracker.ts      # IssueTrackerProvider interface
│       ├── github-issue-tracker.ts # GitHub Issues implementation
│       └── index.ts              # Provider registry
└── prisma/
    └── schema.prisma             # Database schema

配置

模型选择

首选 设置 更改默认AI模型。支持的型号：

• claude-sonnet-4.6 （默认）
• claude-sonnet-4.5
• claude-haiku-4.5
• claude-opus-4.6
• gpt-5
• gpt-4.1

GitHub身份验证

默认情况下，PleaseLogIt使用Copilot CLI中经过身份验证的用户(copilot 必须登录）。您可以选择在以下位置提供GitHub个人访问令牌 设置 为了推翻这一点。

WorkIQ/M365身份验证

WorkIQ通过基于浏览器的登录处理M365身份验证。您的租户管理员必须同意WorkIQ访问M365数据。请参阅 WorkIQ管理说明.

可扩展性

PleaseLogIt旨在通过提供商界面支持其他输入通道和问题跟踪器。

添加新的输入通道（例如Slack）

实施 FeedbackChannelProvider 接口在 src/lib/providers/feedback-channel.ts:

import type { FeedbackChannelProvider, FeedbackQuery, RawFeedbackItem } from "./feedback-channel";

export class SlackChannel implements FeedbackChannelProvider {
  readonly id = "slack";
  readonly name = "Slack";
  readonly supportedChannelTypes = ["slack_channel", "slack_dm"];

  async queryFeedback(query: FeedbackQuery): Promise {
    // Your Slack API integration here
  }

  async isAvailable(): Promise {
    return true;
  }
}

然后在中注册 src/lib/providers/index.ts.

添加新的问题跟踪器（例如Jira）

实施 IssueTrackerProvider 接口在 src/lib/providers/issue-tracker.ts:

import type { IssueTrackerProvider, Issue, CreateIssueInput } from "./issue-tracker";

export class JiraIssueTracker implements IssueTrackerProvider {
  readonly id = "jira";
  readonly name = "Jira";

  async listIssues(project: string, query?: IssueSearchQuery): Promise { /* ... */ }
  async createIssue(project: string, input: CreateIssueInput): Promise { /* ... */ }
  async getIssue(project: string, issueNumber: number): Promise { /* ... */ }
  async isAvailable(): Promise { return true; }
}

技术栈

• Next.js --全栈React框架（App Router）
• **** --支持MCP服务器的AI代理运行时
• 微软WorkIQ --通过MCP访问M365数据
• 棱镜 --使用SQLite的类型安全ORM
• 顺风CSS --实用性优先的造型
• 佐德 --架构验证

许可证

麻省理工学院