总反馈
—
待处理 (open)
—
已确认 (acknowledged)
—
已解决 (resolved)
—
已关闭 (closed)
—
按来源分布
按分类分布
最近反馈
查看全部 →| ID | 来源 | 内容 | 状态 | 时间 |
|---|---|---|---|---|
| 加载中… | ||||
意见列表
全部反馈的查询与处理：按来源 / 状态 / 分类 / 关键词筛选，逐条回复，支持 CSV 导出。
| ID | 来源 | 分类 | 内容 | 联系方式 | 页面 | 状态 | 时间 | 操作 |
|---|---|---|---|---|---|---|---|---|
| 加载中… | ||||||||
应用列表
管理允许提交反馈的应用来源（source）：创建、启停、删除，并查看各自的反馈计数。
新建应用
应用 = 允许提交反馈的来源标识（source）。嵌入方在提交时携带对应 source，只有启用中的应用会通过准入校验。
已接入应用
停用后该来源的提交将被拒绝（403），历史反馈保留。
| source | 名称 | 状态 | 反馈数 | 备注 | 创建时间 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
用户管理
管理后台账号与角色：admin 全权、viewer 只读；支持启停、重置口令、删除与 API 令牌管理，修改当前账号口令见下方。
新建账号
账号用于登录管理后台。viewer 为只读账号：可查看全部数据、修改自身口令，所有写操作（新建/修改/删除）均被拒绝。
账号列表
停用后该账号立即无法登录（已有会话同步失效）。不能删除/停用自己，也不能删除/停用/降级最后一个启用管理员。
| 账号 | 角色 | 状态 | API 令牌 | 创建时间 | 操作 |
|---|---|---|---|---|---|
| 加载中… | |||||
修改当前账号口令
新口令将立即生效（PBKDF2 哈希存储，服务端不保存明文）。修改后当前登录状态保持有效，其他设备需用新口令重新登录。
令牌管理
为智能体（Agent）签发访问令牌：令牌绑定账号并继承其权限，明文仅创建时显示一次，可随时吊销。
API 令牌
为智能体（Agent）创建访问令牌：令牌与当前账号绑定，拥有该账号的全部权限（只读账号的令牌亦只读）。令牌明文仅在创建时显示一次，可随时吊销。接入方法见帮助文档。
令牌列表
| 名称 | 令牌 | 创建时间 | 有效期至 | 最近使用 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
系统设置
标记「公开」的设置会经 GET /v1/settings 提供给嵌入页（feedback.normdist.com/embed）实时消费，无需重新部署。
日志中心
记录管理端敏感操作：登录成败、账号与口令变更、应用与设置修改、反馈处理等。仅管理员可查看。
开始日期
结束日期
| 时间 (UTC) | 操作 | 账号 | 详情 | IP | User-Agent |
|---|---|---|---|---|---|
| 加载中… | |||||
—
跳至
/ —
帮助文档
如何把意见反馈能力接入您的应用。两种方式任选其一：独立页面（适用于 WEB 页面）或弹窗挂件（适用于桌面应用）。
前置条件
两种方式都依赖来源标识（source）。请先在【应用列表】登记并启用对应来源；提交时来源不在白名单内会被拒绝（403）。管理员在【意见列表】查看与答复反馈，用户上传的日志附件可在详情页下载。
方式一 · 独立页面接入（适用于 WEB 页面）
反馈页是一个独立自适应的页面。用 iframe 嵌入您的站点，或直接跳转 / 新窗口打开。
<iframe src="https://feedback.normdist.com/embed?app_id=your-source" style="width:100%;height:640px;border:0"></iframe>app_id必填。来源标识，须与【应用列表】中登记并启用的值一致。
lang可选。界面语言：zh-CN 或 en；缺省按浏览器语言。
提示：该页面已放行被第三方框架加载，可直接 iframe 嵌入跨域站点。
方式二 · 弹窗接入（适用于桌面应用）
引入一行脚本，页面角落出现反馈入口，点击弹出反馈窗。样式经 Shadow DOM 隔离，不影响宿主页面，适合 Electron 等桌面应用的渲染进程。
<script src="https://feedback.normdist.com/widget.js" data-source="your-source"></script>data-source必填。来源标识，须在白名单内。
data-position可选。入口位置：bottom-right（默认）/ bottom-left / top-right / top-left。
data-theme可选。主题：auto（默认，跟随系统）/ light / dark。
data-lang可选。界面语言：zh-CN 或 en。
data-api-base可选。自托管时指定 API 基址，默认 https://api.feedback.normdist.com。
桌面应用提示：Electron 渲染进程直接引入上述脚本即可；若想自绘弹窗，也可用 iframe 加载 /embed 页面。
方式三 · 智能体接入（API 令牌）
智能体（Agent）通过 API 令牌访问本系统。令牌与账号绑定并继承其权限：管理员令牌全权，只读账号令牌仅可查询。
在【令牌管理】创建令牌（名称 + 有效期），明文仅创建时显示一次，请立即保存。
curl -H "Authorization: Bearer fbk_your-token" \
"https://api.feedback.normdist.com/v1/feedback?page=1&page_size=10"调用 API 时携带 Authorization: Bearer <令牌>，即可像登录用户一样查询与操作。
权限说明：viewer 令牌只读（写操作返回 403）；令牌可随时吊销，账号停用/删除后令牌立即失效。
通用说明
- 提交限速：同一 IP 5 分钟内最多 3 条，超限返回 429。
- 接口已开启 CORS，跨域嵌入无需额外配置。
- 分类枚举：bug（问题）/ feature（功能建议）/ improvement（改进建议）/ praise（表扬）/ other（其他）。
- 新反馈可实时推送到 Webhook（见【系统设置】），通知失败不影响提交。
系统信息
产品意见反馈信息系统
版本v2.1（iter-002 多语言支持）
管理后台feedback.normdist.com（Cloudflare Pages）
API 服务api.feedback.normdist.com（Cloudflare Worker）
嵌入页feedback.normdist.com/embed
数据存储D1（feedback-db）+ R2（日志附件）
运行状态
加载中…
架构说明
管理后台（Pages）与 API（Worker）分离部署，同仓库 web/ 目录单源交付，
另支持内网 Docker 镜像交付（nginx 反代 /v1）。嵌入方两种接入方式：
一行脚本引入 widget.js 悬浮窗，或直接调用 POST /v1/feedback（跨域 CORS 已放开）。
限流为平台级 Rate Limiting binding（60 秒 3 次/IP），口令 PBKDF2 哈希存储于 D1。
提交意见反馈
你的反馈将直接进入本系统的反馈管理列表，团队会尽快跟进处理。
意见分类
意见内容0 / 2000
称呼（选填）
邮箱（选填）
日志附件（选填）
拖拽文件到此处，或 点击选择
支持 .log / .txt，不超过 1MB
我们承诺仅将信息用于产品改进，请勿填写敏感隐私内容。