4 Commits
Author SHA1 Message Date
admin 097910e63e docs(changelog): 记录 v1.1.1 问题反馈通道发布说明 2026-09-05 15:26:32 +08:00
admin 7369706cd4 refactor(feedback): 反馈配置内嵌二进制,移除 .env 依赖
- giteaAPIBase/giteaIssueRepo/giteaIssueToken 常量编译进 server/version.go(含外网地址 :82)
- config.go 移除 Gitea 三个字段;.env/.env.example 清理 GITEA_*,部署零配置
- e2e:零环境变量启动 → POST /api/v1/feedback 自动建 issue #2(外网 issue_url)→ 外网 API 关闭
2026-09-05 15:17:11 +08:00
admin 3f08c55cae feat(feedback): 公开反馈代理 POST /api/v1/feedback — 自动生成 Gitea issue,调用方零凭据
- 实测 Gitea 1.26.1 原生不支持匿名建 issue(401 + Web 跳登录),改为服务端代理
- 服务端持专用 token(GITEA_ISSUE_TOKEN,仅 write:issue scope,不入库 .env)
- 标题自动补 [bug]/[建议] 前缀,正文自动附版本号/commit/时间
- 每 IP 每小时限 10 条;token 未配置时 503 引导 Web 入口
- MCP manifest feedback.api 与 CHANGELOG 同步为 /api/v1/feedback
2026-09-05 15:12:23 +08:00
admin 8f27e34088 feat(changelog): CHANGELOG 头部增加 Issue 反馈机制(Web/API 入口 + 提交约定),MCP manifest 同步 feedback 字段
- issue 入口: https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues(已探活 200)
- AI 经 Gitea API POST issues 提交 bug/建议,标题 [bug]/[建议] 前缀 + 版本号 + 复现步骤
- MCP manifest 新增 feedback 段(issues/api/convention/changelog_url)
2026-09-05 15:04:08 +08:00
6 changed files with 153 additions and 0 deletions

No files matched your search

+1
View File
@@ -26,3 +26,4 @@ CONNECTOR_API_KEY=
# ---- 跨域(默认允许)----
ALLOW_CORS=true
+23
View File
@@ -4,6 +4,29 @@
格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),版本号采用语义化版本。
## 问题反馈(Issue 机制)
AI 客户端在使用本平台过程中发现 bug 或有改进建议,**请提交 Issue**,不要只在会话里提及(会话结束即丢失):
- **自动提交(推荐)**:`POST /api/v1/feedback`(公开,无需任何 token)
```json
{"title":"xxx 失败","body":"复现步骤/期望/实际","kind":"bug"}
```
kind 取 `bug` 或 `suggestion`(标题前缀 `[bug]`/`[建议]` 缺失时自动补,正文自动附服务端版本与时间)。响应返回 `issue_number` 与 `issue_url`。每 IP 每小时限 10 条。
- **Web 手工入口**:https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues (需登录)
- **约定**:正文带版本号(`get_server_info`)与复现步骤,能定位到的接口/工具名写进正文;同一问题先检索已有 issue 避免重复提交
## 版本历史
## [1.1.1] - 2026-09-05 问题反馈通道
### 新增
- **公开反馈代理**:`POST /api/v1/feedback`(公开、调用方零凭据)→ 服务端持专用 token 自动生成 Gitea issue。标题自动补 `[bug]`/`[建议]` 前缀,正文自动附版本号/commit/时间;每 IP 每小时限 10 条
- **Issue 反馈机制**:CHANGELOG 头部说明 + Web 手工入口 + 提交约定;MCP manifest 新增 feedback 段(issues/api/convention/changelog_url)
### 变更
- **反馈配置内嵌二进制**:Gitea 地址/仓库/token 编译进 `version.go`(含外网地址),移除 `.env` 依赖与 `GITEA_*` 环境变量,部署零配置
## [1.1.0] - 2026-09-05 实例治理
对标《本体改进需求》14 项按本库实情取舍落地,另落地 Palantir 两个机制。详细语义见 `docs/INSTANCE_GOVERNANCE.md`。
+7
View File
@@ -590,6 +590,13 @@ func (a *app) mcpManifest(c *gin.Context) {
"base_url": "/api/v1/connector",
"mcp_url": "/api/v1/mcp",
"auth": authHint(a.cfg),
"feedback": gin.H{
"issues": "https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues",
"api": "POST /api/v1/feedback(公开,无需 token)body={\"title\":\"...\",\"body\":\"复现/期望/实际\",\"kind\":\"bug|suggestion\"};服务端自动建 issue 并返回 issue_url",
"web_fallback": "Web 手工入口 https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues(需登录)",
"convention": "标题前缀 [bug]/[建议](缺失自动补);正文带版本号(get_server_info)与复现步骤;先检索已有 issue 避免重复;每 IP 每小时限 10 条",
"changelog_url": "/api/v1/version/changelog",
},
"usage": "知识导入约定:本平台 MCP 仅接受 Markdown 文本。调用方(WorkBuddy/Cursor/Claude 等客户端智能体)须先将 docx/pdf/html/xlsx/ppt 等原文档在本地转换为 Markdown,再调用 km_upload_markdown(content 为 Markdown 文本、filename 以 .md 结尾)上传,最后用 km_extract 抽取导入本体。平台不提供任何二进制/原生文档解析能力。",
"tools": mcpToolList(),
"ui_template": gin.H{
+110
View File
@@ -1,7 +1,13 @@
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"strings"
"sync"
"time"
"github.com/gin-gonic/gin"
)
@@ -15,3 +21,107 @@ func (a *app) versionHandler(c *gin.Context) {
func (a *app) changelogHandler(c *gin.Context) {
c.Data(http.StatusOK, "text/markdown; charset=utf-8", []byte(changelogMarkdown()))
}
// ---------------------------------------------------------------------------
// 反馈代理:公开端点 POST /api/v1/feedback → 服务端持 Gitea token 自动建 issue。
// 调用方(AI 客户端/用户)零凭据;限流防灌水。
// ---------------------------------------------------------------------------
const feedbackHourlyLimit = 10 // 每 IP 每小时最多条数
var (
feedbackMu sync.Mutex
feedbackHits = map[string][]time.Time{} // ip -> 命中时间
)
func feedbackAllow(ip string) bool {
feedbackMu.Lock()
defer feedbackMu.Unlock()
now := time.Now()
recent := feedbackHits[ip][:0]
for _, t := range feedbackHits[ip] {
if now.Sub(t) < time.Hour {
recent = append(recent, t)
}
}
if len(recent) >= feedbackHourlyLimit {
feedbackHits[ip] = recent
return false
}
feedbackHits[ip] = append(recent, now)
return true
}
type feedbackInput struct {
Title string `json:"title"` // 必填;前缀 [bug]/[建议] 自动补
Body string `json:"body"` // 复现步骤/期望/实际
Kind string `json:"kind"` // bug | suggestion(默认 suggestion)
}
// feedbackHandler 公开反馈端点:把 bug/建议以 issue 形式自动提交到 Gitea。
// 目标地址与 token 编译进二进制(version.go 常量),部署零配置。
func (a *app) feedbackHandler(c *gin.Context) {
if giteaIssueToken == "" {
c.JSON(503, gin.H{"error": "反馈服务未配置(二进制内未嵌入 token),请改用 Web 入口建 issue"})
return
}
ip := c.ClientIP()
if !feedbackAllow(ip) {
c.JSON(429, gin.H{"error": "提交过于频繁,每小时最多 " + fmt.Sprint(feedbackHourlyLimit) + " 条"})
return
}
var in feedbackInput
if err := c.ShouldBindJSON(&in); err != nil || strings.TrimSpace(in.Title) == "" {
c.JSON(400, gin.H{"error": "title 必填;body 建议包含复现步骤/期望/实际"})
return
}
kind := in.Kind
if kind != "bug" && kind != "suggestion" {
kind = "suggestion"
}
// 标题规范化:无前缀则自动加
prefix := "[bug]"
if kind == "suggestion" {
prefix = "[建议]"
}
title := strings.TrimSpace(in.Title)
if !strings.HasPrefix(title, "[bug]") && !strings.HasPrefix(title, "[建议]") {
title = prefix + " " + title
}
// 正文自动附加版本与时间上下文
body := strings.TrimSpace(in.Body)
body += fmt.Sprintf("\n\n---\n- 提交渠道: /api/v1/feedback (%s)\n- 服务端版本: %s (commit %s)\n- 时间: %s",
kind, Version, Commit, time.Now().Format("2006-01-02 15:04:05 MST"))
payload, _ := json.Marshal(map[string]interface{}{"title": title, "body": body})
req, err := http.NewRequestWithContext(c.Request.Context(), http.MethodPost,
giteaAPIBase+"/api/v1/repos/"+giteaIssueRepo+"/issues",
bytes.NewReader(payload))
if err != nil {
c.JSON(500, gin.H{"error": err.Error()})
return
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "token "+giteaIssueToken)
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil {
c.JSON(502, gin.H{"error": "Gitea 不可达: " + err.Error()})
return
}
defer resp.Body.Close()
var gi map[string]interface{}
_ = json.NewDecoder(resp.Body).Decode(&gi)
if resp.StatusCode != http.StatusCreated {
msg, _ := gi["message"].(string)
c.JSON(502, gin.H{"error": fmt.Sprintf("Gitea 拒绝 (HTTP %d): %s", resp.StatusCode, msg)})
return
}
number, _ := gi["number"].(float64)
htmlURL, _ := gi["html_url"].(string)
c.JSON(201, gin.H{
"ok": true, "issue_number": int(number), "issue_url": htmlURL,
"title": title,
"message": "issue 已自动创建,可在仓库 issues 页查看进展",
})
}
+2
View File
@@ -157,6 +157,8 @@ func registerRoutes(r *gin.Engine, a *app) {
// 版本自描述(公开):部署核对用,前端页脚 / MCP get_server_info 同源
r.GET("/api/v1/version", a.versionHandler)
r.GET("/api/v1/version/changelog", a.changelogHandler)
// 反馈代理(公开):bug/建议自动转 Gitea issue,调用方零凭据
r.POST("/api/v1/feedback", a.feedbackHandler)
api := r.Group("/api/v1")
+10
View File
@@ -22,6 +22,16 @@ var (
//go:embed CHANGELOG.md
var changelogFS embed.FS
// ---------------------------------------------------------------------------
// Issue 反馈代理配置:直接编译进二进制(苏苏拍板 2026-09-05,不走 .env 避免泄漏面)。
// token 仅 write:issue scope(专用账号 ontology-feedback);如泄漏在 Gitea 后台吊销后重打镜像即可。
// ---------------------------------------------------------------------------
const (
giteaAPIBase = "https://oadfec13300ad18dm.mayishangshu.cn:82"
giteaIssueRepo = "ssw/ssw-ontology"
giteaIssueToken = "a8da103260778d013114ca0fd52bdda22e85cc0f"
)
func changelogMarkdown() string {
b, err := changelogFS.ReadFile("CHANGELOG.md")
if err != nil {