@modesto_ma/dsh-channels 0.6.0 → 0.7.0

package/README.md

@@ -302,7 +302,7 @@ npm 发行包已包含构建产物：Host 入口是 `lib/index.js`（profile 直
     dmAllowWhitelist: false             # guarded 下用户白名单里的人也可私聊（默认关：私聊仅管理员）
     adminUserId: 'a1b2c3d4'            # 管理员 user_id（可留空，留空时自动使用应用所有者；都没有时 guarded 下拒绝所有对话；面板可改）
     authRequestTtlDays: 7               # 入群/用户授权申请卡有效期（天，1–30）
-    analyzeEnabled: false               # 日志平台分析接口开关（POST /api/dsh-channels.logalyze，挂在 DSH Web 端口；改后立即生效）
+    analyzeEnabled: false               # 日志平台分析接口开关（POST /open-api/logalyze，挂在 DSH Web 端口；改后立即生效）
     analyzeToken: 'DSH_CHANNELS_ANALYZE_TOKEN' # 分析接口 Bearer 令牌的凭据引用名（值在面板填写或写进 .credentials.yaml）
     loggerLevel: 'info'
 ```
@@ -379,12 +379,12 @@ FEISHU_APP_SECRET: xxxxxxxx
 
 日志平台调用插件的分析接口：插件在指定群里发一张分析卡（发起人、触发时间、应用、错误码和日志详情页表格），在卡片下开话题，把平台给的 prompt 原样交给一个新 Session（prompt 开头的斜杠命令由 DSH 展开成对应 skill），分析过程在话题内流式输出，和用户自己发起的会话一样。分析结束后分析卡的状态标签随之更新。群里通过准入的成员都可以在该话题内追问。插件只负责接收 prompt 和开会话：日志包地址写在 prompt 里，下载、解压、超时都由日志分析 skill 自己处理（Session 的沙箱需要能访问日志存储地址）。
 
-**开启**：在面板「高级 → 日志分析接口」打开开关（`analyzeEnabled`，默认关，改后立即生效、不需要重连），并在同一处的「访问令牌」卡片填写令牌（建议 32 位以上随机串；写入 DSH 凭据库的 `DSH_CHANNELS_ANALYZE_TOKEN`，也可直接写进 `$DSH_HOME/.credentials.yaml`，引用名可用 `analyzeToken` 修改）。接口挂在 DSH Web 服务上（与 Web 界面同一端口），路径 `/api/dsh-channels.logalyze` 按 DSH 纯 HTTP 路由 `/api/<名字>.<方法>` 的命名；只有带 Web 的 profile（web、desktop）有这个接口，headless 没有。DSH 通过反向代理挂在前缀下时，地址随之带上前缀（如 `https://<域名>/dsh/api/dsh-channels.logalyze`）。该路由不走 DSH 登录 cookie，访问令牌是唯一凭据。开关关闭时所有请求返回 404；令牌每次请求都重新解析，轮换后下一次请求生效；令牌缺失时所有请求返回 503。
+**开启**：在面板「高级 → 日志分析接口」打开开关（`analyzeEnabled`，默认关，改后立即生效、不需要重连），并在同一处的「访问令牌」卡片填写令牌（建议 32 位以上随机串；写入 DSH 凭据库的 `DSH_CHANNELS_ANALYZE_TOKEN`，也可直接写进 `$DSH_HOME/.credentials.yaml`，引用名可用 `analyzeToken` 修改）。接口挂在 DSH Web 服务上（与 Web 界面同一端口），路径 `/open-api/logalyze` 刻意放在 DSH 的 `/api` 之外，网关可以把它与需要登录的 DSH API 分开放行；只有带 Web 的 profile（web、desktop）有这个接口，headless 没有。DSH 通过反向代理挂在前缀下时，地址随之带上前缀（如 `https://<域名>/dsh/open-api/logalyze`）。该路由不走 DSH 登录 cookie，访问令牌是唯一凭据。开关关闭时所有请求返回 404；令牌每次请求都重新解析，轮换后下一次请求生效；令牌缺失时所有请求返回 503。
 
 **请求**：
 
 ```http
-POST /api/dsh-channels.logalyze
+POST /open-api/logalyze
 Authorization: Bearer <令牌>
 Idempotency-Key: <平台生成的唯一值，1-200 个可见 ASCII 字符>
 Content-Type: application/json

package/lib/index.js

@@ -7465,7 +7465,7 @@ var InboundRouter = class {
 /**
 * Wire contract of the log-platform analyze API.
 *
-* `POST /api/dsh-channels.logalyze` on the DSH Web server, with
+* `POST /open-api/logalyze` on the DSH Web server, with
 * `Authorization: Bearer <token>`, an `Idempotency-Key` header, and a JSON
 * body naming the requester, the trigger time, the subject (application +
 * error code), the log-platform detail pages, the target group, and the
@@ -7477,11 +7477,12 @@ var InboundRouter = class {
 * @module dsh-channels/analyze/contract
 */
 /**
-* Exact DSH Web route of the analyze API. It follows the host's plain-HTTP
-* `/api/<name>.<method>` naming; an exact route wins over the `/api` RPC prefix
-* route, so the request carries this API's bearer token, not a DSH login.
+* Exact DSH Web route of the analyze API. It sits outside DSH's `/api`
+* namespace so a gateway in front of DSH can expose it separately from the
+* login-protected DSH API; the request carries this API's bearer token, not a
+* DSH login.
 */
-const ANALYZE_ROUTE = "/api/dsh-channels.logalyze";
+const ANALYZE_ROUTE = "/open-api/logalyze";
 /** Largest accepted request body (the prompt dominates it). */
 const ANALYZE_MAX_BODY_BYTES = 1024 * 1024;
 /** Largest accepted prompt, in characters. */
@@ -16228,7 +16229,7 @@ const configSchema = z.object({
 	*/
 	questionTimeoutMs: z.number().int().min(1e4).max(36e5).default(DEFAULT_QUESTION_TIMEOUT_MS),
 	/**
-	* Switch for the log-platform analyze API (`POST /api/dsh-channels.logalyze`
+	* Switch for the log-platform analyze API (`POST /open-api/logalyze`
 	* on the DSH Web server). Off (default) answers 404; read per request, so
 	* toggling it needs no reconnect. Needs a host with a Web server.
 	*/
@@ -19676,7 +19677,7 @@ function mountSettingsRoutes(ctx, surface) {
 /**
 * The analyze API's HTTP route on the DSH Web server.
 *
-* Registers the exact route `POST /api/dsh-channels.logalyze` (see
+* Registers the exact route `POST /open-api/logalyze` (see
 * `./contract.ts`) on the host `webServer`; hosts without one (headless) have
 * no analyze API. This module owns the transport-level checks, in order:
 * path, the `analyzeEnabled` switch, method, bearer token, `Idempotency-Key`,
@@ -19743,7 +19744,7 @@ async function readBody(req) {
 * @param handler - the business side.
 */
 async function handleAnalyzeHttp(req, res, handler) {
-	if (new URL(req.url ?? "/", "http://analyze.invalid").pathname !== "/api/dsh-channels.logalyze") {
+	if (new URL(req.url ?? "/", "http://analyze.invalid").pathname !== "/open-api/logalyze") {
 		refuse(res, 404, "未知路径");
 		return;
 	}
@@ -20312,7 +20313,7 @@ const FIELD_META = {
 		label: "日志分析接口",
 		group: "analyze",
 		summary: "关闭时接口返回 404",
-		help: "接口挂在 DSH Web 端口上：POST /api/dsh-channels.logalyze，请求需带 Authorization: Bearer <访问令牌>。只有带 Web 的 profile 才有这个接口。改后立即生效，不需要重连。"
+		help: "接口挂在 DSH Web 端口上：POST /open-api/logalyze，请求需带 Authorization: Bearer <访问令牌>。只有带 Web 的 profile 才有这个接口。改后立即生效，不需要重连。"
 	},
 	loggerLevel: {
 		label: "SDK 日志级别",