Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
097910e63e | ||
|
|
7369706cd4 | ||
|
|
3f08c55cae | ||
|
|
8f27e34088 |
No files matched your search
@@ -26,3 +26,4 @@ CONNECTOR_API_KEY=
|
||||
|
||||
# ---- 跨域(默认允许)----
|
||||
ALLOW_CORS=true
|
||||
|
||||
@@ -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`。
|
||||
|
||||
@@ -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{
|
||||
|
||||
@@ -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 页查看进展",
|
||||
})
|
||||
}
|
||||
@@ -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")
|
||||
|
||||
|
||||
@@ -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 {
|
||||
|
||||
Reference in new issue
Block a user