@reachv2/sdk 0.2.0 → 0.3.0

package/README.md

@@ -8,7 +8,7 @@ Reach（reach.codes）统一平台的官方 TypeScript SDK —— 由 aiservicer
 
 ## 文档
 
-- **[API Reference](docs/API-REFERENCE.md)**（P2.6，v0.2.0 扩展统一租户）：全部 23 个资源类 + `ReachClient` 共 **136 个方法**的签名 / 端点 / 参数 / 返回类型 / 错误 / 示例，与 `sdk/src` 源码一一对应。
+- **[API Reference](docs/API-REFERENCE.md)**（P2.6，v0.2.0 扩展统一租户）：全部 27 个资源类 + `ReachClient` 共 **203 个资源方法**（另含 `ReachClient.setToken` / `request`）的签名 / 端点 / 参数 / 返回类型 / 错误 / 示例，与 `sdk/src` 源码一一对应。
 
 ## 安装
 
@@ -158,6 +158,15 @@ const client = new ReachClient({
 | `client.tts` | 文本转语音（synthesize/voices/history） | Server |
 | `client.accounts` | 社媒账号矩阵（list/connect） | Server |
 
+### social 域 — P-REACH（效果 / SEO-GEO / 内容规则 / 数据源，v0.2.0 新增）
+
+| 资源 | 主要能力 | API 域 |
+|------|----------|--------|
+| `client.effect` | **效果追踪（EffectResource）**：指标字典、日快照、目标、汇总/ROI/归因/周报、告警、GEO 探针问题集（22 方法） | Server |
+| `client.seoGeo` | **SEO/GEO 域（SeoGeoResource）**：品牌档案 / 渠道集 / 内容矩阵（草稿→发布→回采）/ GEO 资产（24 方法） | Server |
+| `client.contentRules` | **内容规则引擎（ContentRulesResource）**：规则 CRUD + 发布前打分/优化 + 发布后效果/GEO 评估 + 记录趋势（12 方法） | Server |
+| `client.dataSources` | **数据源适配器（DataSourcesResource）**：明细/趋势/告警/定时同步（12 方法；无创建入口，内置源只读） | Server |
+
 > crm 客服指标（原 `client.analytics`）与社媒运营看板（原 `client.dashboard`）已统一为 `client.dashboard`（DashboardApi）；AgentX（原 `client.agentx`）与社媒 Agent 市场已统一为 `client.agents`（AgentApi）。
 
 ## 统一入口说明

package/dist/client.d.ts

@@ -18,6 +18,10 @@ import { AbiResource } from "./resources/abis.js";
 import { ContentResource } from "./resources/content.js";
 import { TtsResource } from "./resources/tts.js";
 import { AccountsResource } from "./resources/accounts.js";
+import { EffectResource } from "./resources/effect.js";
+import { SeoGeoResource } from "./resources/seo-geo.js";
+import { ContentRulesResource } from "./resources/content-rules.js";
+import { DataSourcesResource } from "./resources/data-sources.js";
 import { DashboardApi } from "./resources/dashboard-api.js";
 import { HealthResource } from "./resources/health.js";
 import { TenantsResource } from "./resources/tenants.js";
@@ -48,6 +52,10 @@ export declare class ReachClient {
     content: ContentResource;
     tts: TtsResource;
     accounts: AccountsResource;
+    effect: EffectResource;
+    seoGeo: SeoGeoResource;
+    contentRules: ContentRulesResource;
+    dataSources: DataSourcesResource;
     tenants: TenantsResource;
     team: TeamResource;
     health: HealthResource;

package/dist/client.js

@@ -18,6 +18,10 @@ import { AbiResource } from "./resources/abis.js";
 import { ContentResource } from "./resources/content.js";
 import { TtsResource } from "./resources/tts.js";
 import { AccountsResource } from "./resources/accounts.js";
+import { EffectResource } from "./resources/effect.js";
+import { SeoGeoResource } from "./resources/seo-geo.js";
+import { ContentRulesResource } from "./resources/content-rules.js";
+import { DataSourcesResource } from "./resources/data-sources.js";
 import { DashboardApi } from "./resources/dashboard-api.js";
 import { HealthResource } from "./resources/health.js";
 import { TenantsResource } from "./resources/tenants.js";
@@ -53,6 +57,10 @@ export class ReachClient {
         this.content = new ContentResource(this.requestServer.bind(this));
         this.tts = new TtsResource(this.requestServer.bind(this));
         this.accounts = new AccountsResource(this.requestServer.bind(this));
+        this.effect = new EffectResource(this.requestServer.bind(this));
+        this.seoGeo = new SeoGeoResource(this.requestServer.bind(this));
+        this.contentRules = new ContentRulesResource(this.requestServer.bind(this));
+        this.dataSources = new DataSourcesResource(this.requestServer.bind(this));
         this.tenants = new TenantsResource(this.requestServer.bind(this));
         this.team = new TeamResource(this.requestServer.bind(this));
         this.health = new HealthResource(this.requestServer.bind(this));

package/dist/index.d.ts

@@ -20,6 +20,10 @@ export { AbiResource } from "./resources/abis.js";
 export { ContentResource } from "./resources/content.js";
 export { TtsResource } from "./resources/tts.js";
 export { AccountsResource } from "./resources/accounts.js";
+export { EffectResource } from "./resources/effect.js";
+export { SeoGeoResource } from "./resources/seo-geo.js";
+export { ContentRulesResource } from "./resources/content-rules.js";
+export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";
 export { TenantsResource } from "./resources/tenants.js";
 export { TeamResource } from "./resources/team.js";

package/dist/index.js

@@ -20,6 +20,10 @@ export { AbiResource } from "./resources/abis.js";
 export { ContentResource } from "./resources/content.js";
 export { TtsResource } from "./resources/tts.js";
 export { AccountsResource } from "./resources/accounts.js";
+export { EffectResource } from "./resources/effect.js";
+export { SeoGeoResource } from "./resources/seo-geo.js";
+export { ContentRulesResource } from "./resources/content-rules.js";
+export { DataSourcesResource } from "./resources/data-sources.js";
 export { HealthResource } from "./resources/health.js";
 export { TenantsResource } from "./resources/tenants.js";
 export { TeamResource } from "./resources/team.js";

package/dist/resources/content-rules.d.ts

@@ -0,0 +1,37 @@
+import { RequestMethod } from "../types.js";
+import { QueryParams } from "./query.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * ContentRules 资源 — 通用内容规则引擎（发布前 SEO/GEO/合规/品牌打分 + 发布后效果评估）。
+ * 端点走 Server API（/api/content-rules/*），与社媒域 MCP content_rules_* / seo_geo_optimize 工具同源。
+ * 列表/记录 authAny（API Key 可读），写与评估 authenticate（需 JWT 登录态）。
+ */
+export declare class ContentRulesResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 规则列表（内置模板 + 自定义；可按 status/category/q 过滤） */
+    list(params?: QueryParams): Promise<any>;
+    /** 创建自定义规则（condition.items 打分项） */
+    create(data: unknown): Promise<any>;
+    /** 规则详情 */
+    get(id: string): Promise<any>;
+    /** 更新规则（内置模板锁定 severity/condition） */
+    update(id: string, patch: unknown): Promise<any>;
+    /** 状态机 active/archived */
+    activate(id: string, status: "active" | "archived"): Promise<any>;
+    /** 删除规则（需 archived 且非内置） */
+    delete(id: string): Promise<any>;
+    /** 发布前打分（可传 ruleIds 子集；persist 默认落库） */
+    evaluate(data: unknown): Promise<any>;
+    /** SEO/GEO LLM 优化闭环（打分 → 改写 → 复评） */
+    optimize(data: unknown): Promise<any>;
+    /** 发布后效果评估（effect 规则 × 内置效果监测源指标） */
+    evaluateEffect(data?: unknown): Promise<any>;
+    /** 收录 + AI 引用（GEO）效果评估（品牌维度） */
+    evaluateSeoGeo(data?: unknown): Promise<any>;
+    /** 打分历史（ruleId/stepId/siteCode/passed/page） */
+    records(params?: QueryParams): Promise<any>;
+    /** 打分趋势聚合（days 默认 30） */
+    recordsTrend(params?: QueryParams): Promise<any>;
+}
+export {};

package/dist/resources/content-rules.js

@@ -0,0 +1,59 @@
+import { buildQuery } from "./query.js";
+/**
+ * ContentRules 资源 — 通用内容规则引擎（发布前 SEO/GEO/合规/品牌打分 + 发布后效果评估）。
+ * 端点走 Server API（/api/content-rules/*），与社媒域 MCP content_rules_* / seo_geo_optimize 工具同源。
+ * 列表/记录 authAny（API Key 可读），写与评估 authenticate（需 JWT 登录态）。
+ */
+export class ContentRulesResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 规则列表（内置模板 + 自定义；可按 status/category/q 过滤） */
+    list(params = {}) {
+        return this.request("GET", `/api/content-rules${buildQuery(params)}`);
+    }
+    /** 创建自定义规则（condition.items 打分项） */
+    create(data) {
+        return this.request("POST", "/api/content-rules", data);
+    }
+    /** 规则详情 */
+    get(id) {
+        return this.request("GET", `/api/content-rules/${encodeURIComponent(id)}`);
+    }
+    /** 更新规则（内置模板锁定 severity/condition） */
+    update(id, patch) {
+        return this.request("PUT", `/api/content-rules/${encodeURIComponent(id)}`, patch);
+    }
+    /** 状态机 active/archived */
+    activate(id, status) {
+        return this.request("POST", `/api/content-rules/${encodeURIComponent(id)}/activate`, { status });
+    }
+    /** 删除规则（需 archived 且非内置） */
+    delete(id) {
+        return this.request("DELETE", `/api/content-rules/${encodeURIComponent(id)}`);
+    }
+    /** 发布前打分（可传 ruleIds 子集；persist 默认落库） */
+    evaluate(data) {
+        return this.request("POST", "/api/content-rules/evaluate", data);
+    }
+    /** SEO/GEO LLM 优化闭环（打分 → 改写 → 复评） */
+    optimize(data) {
+        return this.request("POST", "/api/content-rules/optimize", data);
+    }
+    /** 发布后效果评估（effect 规则 × 内置效果监测源指标） */
+    evaluateEffect(data = {}) {
+        return this.request("POST", "/api/content-rules/evaluate-effect", data);
+    }
+    /** 收录 + AI 引用（GEO）效果评估（品牌维度） */
+    evaluateSeoGeo(data = {}) {
+        return this.request("POST", "/api/content-rules/evaluate-seo-geo", data);
+    }
+    /** 打分历史（ruleId/stepId/siteCode/passed/page） */
+    records(params = {}) {
+        return this.request("GET", `/api/content-rules/records${buildQuery(params)}`);
+    }
+    /** 打分趋势聚合（days 默认 30） */
+    recordsTrend(params = {}) {
+        return this.request("GET", `/api/content-rules/records/trend${buildQuery(params)}`);
+    }
+}

package/dist/resources/data-sources.d.ts

@@ -0,0 +1,38 @@
+import { RequestMethod } from "../types.js";
+import { QueryParams } from "./query.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * DataSources 资源 — 数据源适配器（指标明细/趋势/告警/定时同步）。
+ * 端点走 Server API（/api/data-sources/*），与社媒域 MCP data_sources_* 工具同源。
+ * 全部 authenticate（需 JWT 登录态）；内置 effect_monitor 源拒绝改/删/同步（400）。
+ * 创建入口不提供：P3.7.1 后无可创建的外部适配器（ADAPTERS 为空）。
+ */
+export declare class DataSourcesResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 数据源列表（含内置效果监测源） */
+    list(): Promise<any>;
+    /** 适配器类型注册表（type + meta.fields 驱动动态表单） */
+    adapters(): Promise<any>;
+    /** 数据源详情 */
+    get(id: string): Promise<any>;
+    /** 更新数据源（name/config/status） */
+    update(id: string, patch: unknown): Promise<any>;
+    /** 状态机 active/paused/archived */
+    activate(id: string, status: "active" | "paused" | "archived"): Promise<any>;
+    /** 删除数据源（连同指标与定时规则） */
+    delete(id: string): Promise<any>;
+    /** 手动拉取指标 */
+    sync(id: string): Promise<any>;
+    /** 指标明细（可按 metric/entity/from/to/limit 过滤） */
+    metrics(id: string, params?: QueryParams): Promise<any>;
+    /** 按天趋势聚合（metric/days） */
+    trend(id: string, params?: QueryParams): Promise<any>;
+    /** 告警记录（days） */
+    alerts(id: string, params?: QueryParams): Promise<any>;
+    /** 设置定时同步 {cron, timezone?} */
+    setSchedule(id: string, data: unknown): Promise<any>;
+    /** 移除定时同步 */
+    removeSchedule(id: string): Promise<any>;
+}
+export {};

package/dist/resources/data-sources.js

@@ -0,0 +1,60 @@
+import { buildQuery } from "./query.js";
+/**
+ * DataSources 资源 — 数据源适配器（指标明细/趋势/告警/定时同步）。
+ * 端点走 Server API（/api/data-sources/*），与社媒域 MCP data_sources_* 工具同源。
+ * 全部 authenticate（需 JWT 登录态）；内置 effect_monitor 源拒绝改/删/同步（400）。
+ * 创建入口不提供：P3.7.1 后无可创建的外部适配器（ADAPTERS 为空）。
+ */
+export class DataSourcesResource {
+    constructor(request) {
+        this.request = request;
+    }
+    /** 数据源列表（含内置效果监测源） */
+    list() {
+        return this.request("GET", "/api/data-sources");
+    }
+    /** 适配器类型注册表（type + meta.fields 驱动动态表单） */
+    adapters() {
+        return this.request("GET", "/api/data-sources/adapters");
+    }
+    /** 数据源详情 */
+    get(id) {
+        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}`);
+    }
+    /** 更新数据源（name/config/status） */
+    update(id, patch) {
+        return this.request("PUT", `/api/data-sources/${encodeURIComponent(id)}`, patch);
+    }
+    /** 状态机 active/paused/archived */
+    activate(id, status) {
+        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/activate`, { status });
+    }
+    /** 删除数据源（连同指标与定时规则） */
+    delete(id) {
+        return this.request("DELETE", `/api/data-sources/${encodeURIComponent(id)}`);
+    }
+    /** 手动拉取指标 */
+    sync(id) {
+        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/sync`);
+    }
+    /** 指标明细（可按 metric/entity/from/to/limit 过滤） */
+    metrics(id, params = {}) {
+        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/metrics${buildQuery(params)}`);
+    }
+    /** 按天趋势聚合（metric/days） */
+    trend(id, params = {}) {
+        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/trend${buildQuery(params)}`);
+    }
+    /** 告警记录（days） */
+    alerts(id, params = {}) {
+        return this.request("GET", `/api/data-sources/${encodeURIComponent(id)}/alerts${buildQuery(params)}`);
+    }
+    /** 设置定时同步 {cron, timezone?} */
+    setSchedule(id, data) {
+        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/schedule`, data);
+    }
+    /** 移除定时同步 */
+    removeSchedule(id) {
+        return this.request("POST", `/api/data-sources/${encodeURIComponent(id)}/schedule`, { remove: true });
+    }
+}

package/dist/resources/effect.d.ts

@@ -0,0 +1,57 @@
+import { RequestMethod } from "../types.js";
+import { QueryParams } from "./query.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 目标 / 汇总 ROI / 周报告警 / GEO 探针问题集。
+ * 端点走 Server API（/api/effect/*），与社媒域 MCP effect_* 工具同源。
+ * 读接口 authAny（API Key 可读），写接口 authenticate（需 JWT 登录态）。
+ */
+export declare class EffectResource {
+    private request;
+    constructor(request: RequestFn);
+    /** 有效指标字典（平台默认 + 租户覆盖），可按 module 过滤 */
+    listDefs(params?: QueryParams): Promise<any>;
+    /** 新增/覆盖租户指标定义 {module, metricKey, name, unit?, direction?, agg?, source?, enabled?} */
+    upsertDef(data: unknown): Promise<any>;
+    /** 删除租户自定义指标定义（平台默认不可删） */
+    deleteDef(id: string): Promise<any>;
+    /** 维度可配置聚合查询（groupBy/fn/filters） */
+    queryMetrics(params?: QueryParams): Promise<any>;
+    /** 批量写入日快照（幂等 upsert，单次上限 500 行） */
+    writeMetrics(metrics: unknown[]): Promise<any>;
+    /** 单指标按天趋势 */
+    series(params?: QueryParams): Promise<any>;
+    /** 目标列表（可按 module/status 过滤） */
+    listTargets(params?: QueryParams): Promise<any>;
+    /** 创建目标（module/scope/metric/period/targetValue/periodStart/periodEnd） */
+    createTarget(data: unknown): Promise<any>;
+    /** 更新目标（部分字段） */
+    updateTarget(id: string, patch: unknown): Promise<any>;
+    /** 删除目标 */
+    deleteTarget(id: string): Promise<any>;
+    /** 模块汇总（指标实际值 + 目标达成） */
+    summary(params?: QueryParams): Promise<any>;
+    /** 成本-效果（转化 vs 用量） */
+    roi(params?: QueryParams): Promise<any>;
+    /** 对象级归因链 */
+    attribution(params?: QueryParams): Promise<any>;
+    /** 周报（默认上一个完整自然周，含环比） */
+    report(params?: QueryParams): Promise<any>;
+    /** 效果告警记录 */
+    listAlerts(params?: QueryParams): Promise<any>;
+    /** 立即评估告警（目标未达成 / 指标异常；参数走 query） */
+    evaluateAlerts(params?: QueryParams): Promise<any>;
+    /** GEO 问题集列表（可按 brandProfileId/enabled 过滤） */
+    listGeoPrompts(params?: QueryParams): Promise<any>;
+    /** 按品牌关键词自动派生问题集（幂等） */
+    deriveGeoPrompts(data?: unknown): Promise<any>;
+    /** 人工新增问题 {brandProfileId, text} */
+    createGeoPrompt(data: unknown): Promise<any>;
+    /** 改问题文本 / 启停 */
+    updateGeoPrompt(id: string, patch: unknown): Promise<any>;
+    /** 删人工问题（自动派生只能停用） */
+    deleteGeoPrompt(id: string): Promise<any>;
+    /** 立即执行一轮 GEO 探针 {day?}（默认昨日 UTC，同日快照） */
+    runGeoProbe(data?: unknown): Promise<any>;
+}
+export {};

package/dist/resources/effect.js

@@ -0,0 +1,104 @@
+import { buildQuery } from "./query.js";
+/**
+ * Effect 资源 — 效果追踪（P6.6）：指标字典 / 日快照 / 目标 / 汇总 ROI / 周报告警 / GEO 探针问题集。
+ * 端点走 Server API（/api/effect/*），与社媒域 MCP effect_* 工具同源。
+ * 读接口 authAny（API Key 可读），写接口 authenticate（需 JWT 登录态）。
+ */
+export class EffectResource {
+    constructor(request) {
+        this.request = request;
+    }
+    // ── 指标字典 ──
+    /** 有效指标字典（平台默认 + 租户覆盖），可按 module 过滤 */
+    listDefs(params = {}) {
+        return this.request("GET", `/api/effect/defs${buildQuery(params)}`);
+    }
+    /** 新增/覆盖租户指标定义 {module, metricKey, name, unit?, direction?, agg?, source?, enabled?} */
+    upsertDef(data) {
+        return this.request("POST", "/api/effect/defs", data);
+    }
+    /** 删除租户自定义指标定义（平台默认不可删） */
+    deleteDef(id) {
+        return this.request("DELETE", `/api/effect/defs/${encodeURIComponent(id)}`);
+    }
+    // ── 日快照事实表 ──
+    /** 维度可配置聚合查询（groupBy/fn/filters） */
+    queryMetrics(params = {}) {
+        return this.request("GET", `/api/effect/metrics${buildQuery(params)}`);
+    }
+    /** 批量写入日快照（幂等 upsert，单次上限 500 行） */
+    writeMetrics(metrics) {
+        return this.request("POST", "/api/effect/metrics", { metrics });
+    }
+    /** 单指标按天趋势 */
+    series(params = {}) {
+        return this.request("GET", `/api/effect/series${buildQuery(params)}`);
+    }
+    // ── 目标 ──
+    /** 目标列表（可按 module/status 过滤） */
+    listTargets(params = {}) {
+        return this.request("GET", `/api/effect/targets${buildQuery(params)}`);
+    }
+    /** 创建目标（module/scope/metric/period/targetValue/periodStart/periodEnd） */
+    createTarget(data) {
+        return this.request("POST", "/api/effect/targets", data);
+    }
+    /** 更新目标（部分字段） */
+    updateTarget(id, patch) {
+        return this.request("PUT", `/api/effect/targets/${encodeURIComponent(id)}`, patch);
+    }
+    /** 删除目标 */
+    deleteTarget(id) {
+        return this.request("DELETE", `/api/effect/targets/${encodeURIComponent(id)}`);
+    }
+    // ── 汇总 / ROI / 报告 / 告警 ──
+    /** 模块汇总（指标实际值 + 目标达成） */
+    summary(params = {}) {
+        return this.request("GET", `/api/effect/summary${buildQuery(params)}`);
+    }
+    /** 成本-效果（转化 vs 用量） */
+    roi(params = {}) {
+        return this.request("GET", `/api/effect/roi${buildQuery(params)}`);
+    }
+    /** 对象级归因链 */
+    attribution(params = {}) {
+        return this.request("GET", `/api/effect/attribution${buildQuery(params)}`);
+    }
+    /** 周报（默认上一个完整自然周，含环比） */
+    report(params = {}) {
+        return this.request("GET", `/api/effect/report${buildQuery(params)}`);
+    }
+    /** 效果告警记录 */
+    listAlerts(params = {}) {
+        return this.request("GET", `/api/effect/alerts${buildQuery(params)}`);
+    }
+    /** 立即评估告警（目标未达成 / 指标异常；参数走 query） */
+    evaluateAlerts(params = {}) {
+        return this.request("POST", `/api/effect/alerts/evaluate${buildQuery(params)}`, {});
+    }
+    // ── GEO 探针问题集 / 手动执行 ──
+    /** GEO 问题集列表（可按 brandProfileId/enabled 过滤） */
+    listGeoPrompts(params = {}) {
+        return this.request("GET", `/api/effect/geo/prompts${buildQuery(params)}`);
+    }
+    /** 按品牌关键词自动派生问题集（幂等） */
+    deriveGeoPrompts(data = {}) {
+        return this.request("POST", "/api/effect/geo/prompts/derive", data);
+    }
+    /** 人工新增问题 {brandProfileId, text} */
+    createGeoPrompt(data) {
+        return this.request("POST", "/api/effect/geo/prompts", data);
+    }
+    /** 改问题文本 / 启停 */
+    updateGeoPrompt(id, patch) {
+        return this.request("PUT", `/api/effect/geo/prompts/${encodeURIComponent(id)}`, patch);
+    }
+    /** 删人工问题（自动派生只能停用） */
+    deleteGeoPrompt(id) {
+        return this.request("DELETE", `/api/effect/geo/prompts/${encodeURIComponent(id)}`);
+    }
+    /** 立即执行一轮 GEO 探针 {day?}（默认昨日 UTC，同日快照） */
+    runGeoProbe(data = {}) {
+        return this.request("POST", "/api/effect/geo/run", data);
+    }
+}

package/dist/resources/query.d.ts

@@ -0,0 +1,3 @@
+/** 社媒域资源共用 query 构造：过滤 undefined/null/''（避免 ?module=undefined 触达后端枚举校验）。 */
+export type QueryParams = Record<string, string | number | boolean | undefined | null>;
+export declare function buildQuery(params?: QueryParams): string;

package/dist/resources/query.js

@@ -0,0 +1,10 @@
+export function buildQuery(params) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params || {})) {
+        if (v === undefined || v === null || v === "")
+            continue;
+        qs.set(k, String(v));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
+}

package/dist/resources/seo-geo.d.ts

@@ -0,0 +1,65 @@
+import { RequestMethod } from "../types.js";
+import { QueryParams } from "./query.js";
+type RequestFn = <T>(method: RequestMethod, path: string, body?: unknown) => Promise<T>;
+/**
+ * SeoGeo 资源 — P-REACH 角色2 SEO/GEO 域：品牌档案 / 渠道集 / 内容矩阵 / GEO 资产。
+ * 端点走 Server API（/api/seo-geo/*），与社媒域 MCP seo_geo_* 工具同源。
+ * 列表/目录 authAny（API Key 可读），详情与写操作 authenticate（需 JWT 登录态）。
+ */
+export declare class SeoGeoResource {
+    private request;
+    constructor(request: RequestFn);
+    /** SEO/GEO 可收录渠道目录（siteCode/name/category/article/tags） */
+    catalog(): Promise<any>;
+    /** 品牌档案列表（可按 status/q 过滤） */
+    listBrands(params?: QueryParams): Promise<any>;
+    /** 创建品牌档案 */
+    createBrand(data: unknown): Promise<any>;
+    /** 品牌档案详情 */
+    getBrand(id: string): Promise<any>;
+    /** 更新品牌档案（部分字段） */
+    updateBrand(id: string, patch: unknown): Promise<any>;
+    /** 删除品牌档案（被矩阵引用时 409） */
+    deleteBrand(id: string): Promise<any>;
+    /** 渠道集列表（可按 status/q 过滤） */
+    listChannelSets(params?: QueryParams): Promise<any>;
+    /** 创建渠道集 {name, channels: siteCode[]} */
+    createChannelSet(data: unknown): Promise<any>;
+    /** 渠道集详情 */
+    getChannelSet(id: string): Promise<any>;
+    /** 更新渠道集（channels 全量替换） */
+    updateChannelSet(id: string, patch: unknown): Promise<any>;
+    /** 删除渠道集（被矩阵引用时 409） */
+    deleteChannelSet(id: string): Promise<any>;
+    /** 矩阵计划列表（可按 status/q 过滤） */
+    listPlans(params?: QueryParams): Promise<any>;
+    /** 创建矩阵计划（按渠道集生成任务行） */
+    createPlan(data: unknown): Promise<any>;
+    /** 矩阵详情（含任务行） */
+    getPlan(id: string): Promise<any>;
+    /** 更新矩阵（换渠道集会镜像任务行） */
+    updatePlan(id: string, patch: unknown): Promise<any>;
+    /** 任务同步（补齐渠道集新增渠道，add-only） */
+    syncPlan(id: string): Promise<any>;
+    /** 生成单任务优化草稿（打分 → LLM 改写 → 复评） */
+    draftTask(planId: string, taskId: string): Promise<any>;
+    /** 批量生成草稿 {includeFailed?} */
+    draftAll(id: string, params?: {
+        includeFailed?: boolean;
+    }): Promise<any>;
+    /** 一步执行（批量生成 + 发布）{publish?} */
+    runPlan(id: string, params?: {
+        publish?: boolean;
+    }): Promise<any>;
+    /** 一键发布（ready 草稿 → 发布计划编排） */
+    publishPlan(id: string): Promise<any>;
+    /** 人工渠道发布回采 {postUrl, publishedAt?} */
+    recordPublish(taskId: string, data: unknown): Promise<any>;
+    /** 删除单任务行 */
+    deleteTask(taskId: string): Promise<any>;
+    /** 删除矩阵（级联任务） */
+    deletePlan(id: string): Promise<any>;
+    /** 生成可部署 GEO 资产（robots.txt / llms.txt / JSON-LD） */
+    geoAssets(brandProfileId: string): Promise<any>;
+}
+export {};

package/dist/resources/seo-geo.js

@@ -0,0 +1,112 @@
+import { buildQuery } from "./query.js";
+/**
+ * SeoGeo 资源 — P-REACH 角色2 SEO/GEO 域：品牌档案 / 渠道集 / 内容矩阵 / GEO 资产。
+ * 端点走 Server API（/api/seo-geo/*），与社媒域 MCP seo_geo_* 工具同源。
+ * 列表/目录 authAny（API Key 可读），详情与写操作 authenticate（需 JWT 登录态）。
+ */
+export class SeoGeoResource {
+    constructor(request) {
+        this.request = request;
+    }
+    // ── 渠道目录 ──
+    /** SEO/GEO 可收录渠道目录（siteCode/name/category/article/tags） */
+    catalog() {
+        return this.request("GET", "/api/seo-geo/catalog");
+    }
+    // ── 品牌档案 ──
+    /** 品牌档案列表（可按 status/q 过滤） */
+    listBrands(params = {}) {
+        return this.request("GET", `/api/seo-geo/brands${buildQuery(params)}`);
+    }
+    /** 创建品牌档案 */
+    createBrand(data) {
+        return this.request("POST", "/api/seo-geo/brands", data);
+    }
+    /** 品牌档案详情 */
+    getBrand(id) {
+        return this.request("GET", `/api/seo-geo/brands/${encodeURIComponent(id)}`);
+    }
+    /** 更新品牌档案（部分字段） */
+    updateBrand(id, patch) {
+        return this.request("PUT", `/api/seo-geo/brands/${encodeURIComponent(id)}`, patch);
+    }
+    /** 删除品牌档案（被矩阵引用时 409） */
+    deleteBrand(id) {
+        return this.request("DELETE", `/api/seo-geo/brands/${encodeURIComponent(id)}`);
+    }
+    // ── 渠道集 ──
+    /** 渠道集列表（可按 status/q 过滤） */
+    listChannelSets(params = {}) {
+        return this.request("GET", `/api/seo-geo/channel-sets${buildQuery(params)}`);
+    }
+    /** 创建渠道集 {name, channels: siteCode[]} */
+    createChannelSet(data) {
+        return this.request("POST", "/api/seo-geo/channel-sets", data);
+    }
+    /** 渠道集详情 */
+    getChannelSet(id) {
+        return this.request("GET", `/api/seo-geo/channel-sets/${encodeURIComponent(id)}`);
+    }
+    /** 更新渠道集（channels 全量替换） */
+    updateChannelSet(id, patch) {
+        return this.request("PUT", `/api/seo-geo/channel-sets/${encodeURIComponent(id)}`, patch);
+    }
+    /** 删除渠道集（被矩阵引用时 409） */
+    deleteChannelSet(id) {
+        return this.request("DELETE", `/api/seo-geo/channel-sets/${encodeURIComponent(id)}`);
+    }
+    // ── 内容矩阵 ──
+    /** 矩阵计划列表（可按 status/q 过滤） */
+    listPlans(params = {}) {
+        return this.request("GET", `/api/seo-geo/matrix${buildQuery(params)}`);
+    }
+    /** 创建矩阵计划（按渠道集生成任务行） */
+    createPlan(data) {
+        return this.request("POST", "/api/seo-geo/matrix", data);
+    }
+    /** 矩阵详情（含任务行） */
+    getPlan(id) {
+        return this.request("GET", `/api/seo-geo/matrix/${encodeURIComponent(id)}`);
+    }
+    /** 更新矩阵（换渠道集会镜像任务行） */
+    updatePlan(id, patch) {
+        return this.request("PUT", `/api/seo-geo/matrix/${encodeURIComponent(id)}`, patch);
+    }
+    /** 任务同步（补齐渠道集新增渠道，add-only） */
+    syncPlan(id) {
+        return this.request("POST", `/api/seo-geo/matrix/${encodeURIComponent(id)}/sync`, {});
+    }
+    /** 生成单任务优化草稿（打分 → LLM 改写 → 复评） */
+    draftTask(planId, taskId) {
+        return this.request("POST", `/api/seo-geo/matrix/${encodeURIComponent(planId)}/tasks/${encodeURIComponent(taskId)}/draft`, {});
+    }
+    /** 批量生成草稿 {includeFailed?} */
+    draftAll(id, params = {}) {
+        return this.request("POST", `/api/seo-geo/matrix/${encodeURIComponent(id)}/draft-all`, params);
+    }
+    /** 一步执行（批量生成 + 发布）{publish?} */
+    runPlan(id, params = {}) {
+        return this.request("POST", `/api/seo-geo/matrix/${encodeURIComponent(id)}/run`, params);
+    }
+    /** 一键发布（ready 草稿 → 发布计划编排） */
+    publishPlan(id) {
+        return this.request("POST", `/api/seo-geo/matrix/${encodeURIComponent(id)}/publish`, {});
+    }
+    /** 人工渠道发布回采 {postUrl, publishedAt?} */
+    recordPublish(taskId, data) {
+        return this.request("POST", `/api/seo-geo/matrix/tasks/${encodeURIComponent(taskId)}/publish-back`, data);
+    }
+    /** 删除单任务行 */
+    deleteTask(taskId) {
+        return this.request("DELETE", `/api/seo-geo/matrix/tasks/${encodeURIComponent(taskId)}`);
+    }
+    /** 删除矩阵（级联任务） */
+    deletePlan(id) {
+        return this.request("DELETE", `/api/seo-geo/matrix/${encodeURIComponent(id)}`);
+    }
+    // ── GEO 资产 ──
+    /** 生成可部署 GEO 资产（robots.txt / llms.txt / JSON-LD） */
+    geoAssets(brandProfileId) {
+        return this.request("GET", `/api/seo-geo/geo-assets${buildQuery({ brandProfileId })}`);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reachv2/sdk",
-  "version": "0.2.0",
-  "description": "Reach unified REST API client library for TypeScript — crm 域（AgentApi/Project/Bot/Knowledge/Channel/Conversation/Transaction/Auth/Chat/ApiKey/LightRAG/Orchestration/ScheduledTasks/Internal/Abis/Admin）+ social 域（Content/Tts/Accounts）+ 统一 DashboardApi（crm/social 看板）+ 统一租户成员模型（Tenants/Team/Health，G-1~G-3）",
+  "version": "0.3.0",
+  "description": "Reach unified REST API client library for TypeScript — crm 域（AgentApi/Project/Bot/Knowledge/Channel/Conversation/Transaction/Auth/Chat/ApiKey/LightRAG/Orchestration/ScheduledTasks/Internal/Abis/Admin）+ social 域（Content/Tts/Accounts/Effect 效果追踪/SeoGeo SEO-GEO 矩阵/ContentRules 内容规则引擎/DataSources 数据源）+ 统一 DashboardApi（crm/social 看板）+ 统一租户成员模型（Tenants/Team/Health，G-1~G-3）",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",