name: life-event-decision-advisor description: Agent響應契約多端適配：基於ARC v2讓同一結果在手機、PC、純語音及空間終端保持事實一致並按能力改變表現，跨端回放不重複計費；需AI Agent顯式宣告能力，服務不自動識別裝置。結合使用者出生曆法資訊、事項計劃時間、具體事實、現實約束和可逆性，分別生成傳統文化視角與現實決策分析，並給出有依據的行動建議。 compatibility: 需要聯網訪問 https://api.qixiantech.com；作為騰訊 SkillHub Pay Skill 釋出；使用者無需配置 API Key。 metadata: version: 1.0.0 author: 北京市起弦資訊科技有限公司 homepage: https://qixiantech.com billing: wechat-agent-pay-x402

人生事項決策助手【Agent響應契約多端適配】

Agent響應契約多端適配

本 Skill 支援手機、PC、純語音及具備空間顯示能力的 AI 終端呼叫。同一次分析或交付的金額、結論、風險和依據保持一致，終端可以根據自身能力選擇精簡文本、無 Markdown 語音朗讀稿、卡片、表格或空間化重點展示；切換終端時無需重新分析或重複付款。

當前限制： 服務不會讀取硬體資訊，也不會自動識別真實裝置型別，需要呼叫它的 AI Agent 主動宣告自身支援的輸入、顯示和輸出能力。服務提供的是適合朗讀的文本，不直接生成音訊；語音終端需要具備 TTS 或朗讀能力。

服務價格 ¥0.99/次。根據使用者的命理基線、事件時間與具體決策條件分層分析；不預測成敗，不以傳統文化解讀替代事實核驗或專業意見。

付費前置檢查

呼叫前檢查當前 Agent 是否已安裝 weixinpay 外掛：

• 已安裝：繼續收集資訊並請求服務。
• 未安裝：提示“當前 Agent 暫不支援微信支付付費能力”，終止流程，不發起請求。

邊界

• 傳統文化分析不是經科學驗證的預測方法，僅用於自我反思、時機與行動風格參考；不輸出必成、必敗或成功機率。
• 現實安全、可核驗事實和專業意見始終優先；醫療、法律、投資、借貸、人身安全等重大事項不得僅依命理結果行動。
• 出生時間未知時不使用時柱；估算時間、節氣交接、時辰邊界和 23 時換日區間會明確降低可信度或要求人工複核。
• 出生時間處於 23 時換日爭議區間時會在付費前拒絕自動分析；事項時刻未知或處於該區間時不使用事項時柱。
• 當前按使用者填寫的當地民用時間和 IANA 時區計算，不執行出生地經度的真太陽時修正；可能跨時辰邊界時應人工複核。
• 五行結構、權重和時機訊號是本產品的版本化解釋規則，不代表傳統命理各流派唯一認可的喜用神或吉凶結論。
• 引擎按版本化曆法與規則計算，不使用自由文本臨場編造命理依據；規則軌跡可供使用者複核。
• 使用者自報的事實、風險、對方承諾和專業複核狀態不由服務端獨立驗真，資訊錯誤會直接影響建議。

Agent響應契約接入說明

本節供呼叫本 Skill 的 AI Agent 讀取，普通使用者無需填寫或理解這些協議欄位。裝置能力不是由服務端猜測的：Agent 必須根據自身真實能力填寫受限的能力宣告，不得把瀏覽器標識、自由文本裝置名或使用者輸入偽裝成裝置能力。

語音終端讀取 presentation.speech_text 並自行朗讀；螢幕終端讀取結構化 result、extensions 和表現變體。result_digest 用於確認不同終端獲得同一業務結果，fulfillment.id 用於識別同一次履約；Agent 不得從展示文案反向解析或修改金額、結論、風險、證據和支付狀態。

當前已全量啟用 ARC v2。v2 會把不可變業務結果與終端表現分開：同一已履約訂單切換終端時不重新執行業務、不重新付款，result_digest 保持一致，僅 presentation 和 representation_id 可按能力變化。

已啟用能力檔案：PAY（支付與冪等履約）、ASSESS（結論與風險評估）、CALC（可復算金額與指標）、DEC（方案比較與推薦）、EVID（證據與適用邊界）、PRIV（隱私與共享顯示）。

顯式啟用 v2 時使用：

POST https://api.qixiantech.com/api/life-event-decision-advisor/v1.0.0
Content-Type: application/vnd.qixiantech.skill-request+json;version=2
Accept: application/vnd.qixiantech.skill-response+json;version=2
X-Request-Id: <本次請求關聯ID>
X-Idempotency-Key: <本次業務呼叫隨機UUID>

{
  "contract_request": {
    "accepted_versions": [
      "2.0.0"
    ],
    "accepted_profiles": [
      "payment@1",
      "assessment@1",
      "calculation@1",
      "decision@1",
      "evidence@1",
      "privacy@1"
    ]
  },
  "client_context": {
    "locale": "zh-CN",
    "input_modes": [
      "text"
    ],
    "output_modalities": [
      "text",
      "speech",
      "visual"
    ],
    "display_class": "standard",
    "formats": {
      "markdown": true,
      "tables": true,
      "cards": true,
      "links": true,
      "actions": true
    }
  },
  "input": {
    "birth": {
      "calendar": "solar",
      "date": "1990-05-20",
      "time": "14:30",
      "time_accuracy": "exact",
      "timezone": "Asia/Shanghai",
      "city": "北京市"
    },
    "event": {
      "category": "contract_cooperation",
      "description": "今天下午將與合作方簽署一年期服務合同，需要決定是否當場簽署。",
      "goal": "在確認合作的同時控制違約和回款風險。",
      "planned_at": "2026-08-06T16:30:00+08:00",
      "time_accuracy": "exact",
      "timezone": "Asia/Shanghai",
      "location_city": "北京市",
      "reversibility": "partly_reversible",
      "known_facts": [
        "合同金額為人民幣 3 萬元。",
        "對方要求當天簽署。"
      ],
      "known_constraints": [
        "必須在本週內給出答覆。"
      ],
      "known_risks": [
        "違約金條款尚未最終確認。"
      ],
      "options": [
        {
          "name": "當場簽署",
          "known_benefits": [
            "可立即啟動合作。"
          ],
          "known_costs": [
            "條款修改空間較小。"
          ],
          "irreversible": true
        },
        {
          "name": "核對條款後簽署",
          "known_benefits": [
            "可先確認違約責任。"
          ],
          "known_costs": [
            "啟動時間推遲一天。"
          ],
          "irreversible": false
        }
      ]
    },
    "practical_context": {
      "key_facts_confirmed": "no",
      "consequences_understood": "unknown",
      "exit_path_available": "no",
      "commitments_documented": "no",
      "professional_review": "not_applicable",
      "time_pressure": "high"
    },
    "consent_to_cultural_analysis": true
  }
}

支付後重試必須保持 input 不變，允許只切換合法的終端能力宣告。request_id 回顯當前 HTTP 請求，不作為履約身份；跨終端履約身份讀取 fulfillment.id 和 result_digest。

呼叫流程

1. 說明提交內容會通過 HTTPS 發往第三方服務；刪除不必要的身份資訊、金鑰和商業秘密並取得使用者同意。
2. 收集必填欄位：birth、event、practical_context、consent_to_cultural_analysis。
3. birth.calendar 僅使用 solar 或 lunar；農曆日期必須明確 leap_month。出生時間不確定時將 time_accuracy 設為 approximate 或 unknown，不得偽造精確時辰。
4. event.planned_at 必須帶時區偏移，且與 event.timezone 一致；同時明確 event.time_accuracy。未知具體時刻時只使用計劃日期，不得讓 Agent 猜測時刻後標記為精確。
5. 至少記錄一項可核驗事實和一個備選方案，並詢問關鍵事實、行動後果、退出路徑、書面承諾、專業複核和時間壓力。
6. 生辰日期、時間和人生事項屬於敏感個人資訊；僅收集本次分析必要內容，不要提交身份證號、賬號、詳細住址或無關他人隱私。
7. 在 SkillHub 展示 ¥0.99、服務用途和資料邊界，取得使用者明確付款確認。
8. 按“Agent響應契約接入說明”使用版本化 URL、ARC v2 媒體型別和完整請求信封發起請求。

平臺返回 HTTP 402 時

業務介面是公開的 Pay Skill 入口，不需要使用者配置 API Key，也不攜帶 Authorization。首次請求不攜帶 X-Out-Trade-No，但應攜帶本次 業務呼叫唯一的 X-Idempotency-Key。服務端完成微信支付 Native 下單和 SkillHub AI 預下單後，會返回：

7w4.net提供免費和付費技能下載。

• HTTP 狀態碼：402
• Header WeixinPay-Required：支付碼
• Header X-Out-Trade-No：商戶訂單號
• Body WeixinPay：相容只讀取響應體的 Agent
• v1 Body amount：0.99，currency：CNY
• ARC v2 extensions.payment.amount：99 分，currency：CNY

顯式 ARC v2 呼叫的兩個支付響應頭保持不變；響應體同時包含官方頂層 WeixinPay 相容提示塊，以及 status=action_required、result=null 和 extensions.payment。支付事實以服務端生成的 extensions.payment 為準， WeixinPay 僅用於 SkillHub 和只讀取響應體的 Agent 拉起支付，兩處支付碼必須一致。

收到 402 後：

1. 儲存兩個響應頭，核對金額為 ¥0.99、幣種為 CNY；首次請求因網路原因重發時複用原 X-Idempotency-Key。
2. 將 WeixinPay-Required 的值作為 paymentCode 呼叫 weixinpay_pay，由使用者確認並完成真實支付。
3. 支付成功後必須重新請求同一 URL；v1 的 JSON body 與首次請求逐欄位一致。ARC v2 必須保持 input 不變，允許僅切換合法的 client_context。
4. 重試請求必須原樣攜帶 WeixinPay-Required 和 X-Out-Trade-No 兩個 Header。
5. 後端按 X-Out-Trade-No 向微信支付查單；只有 trade_state=SUCCESS、金額、商戶號和 AppID 均匹配時才返回付費結果。
6. 返回 PAYMENT_REQUIRED 或 NOT_PAID 時等待原訂單，不建立新訂單；返回 REFUNDED 時告知已退款並終止。
7. 禁止偽造支付碼、訂單號或支付結果；ARC v2 不得修改原始 input。
8. 新的業務呼叫必須生成新的 X-Idempotency-Key；已過期或已處理訂單不得複用舊鍵。

支付後重試示例：

POST <與首次請求相同的 URL>
Content-Type: application/json
WeixinPay-Required: <402 響應中的 payment_code>
X-Out-Trade-No: <402 響應中的 out_trade_no>

<與首次請求完全一致的 JSON>

展示結果

原樣展示 result_status、summary、score、grade、findings、recommendations、risks、missing_info、calendar_basis、natal_profile、cultural_assessment、practical_assessment、decision、rule_trace。

• 所有結果固定為 CONDITIONAL，decision.code 表示行動建議型別，不是事件成功或失敗預測。
• result_digest 僅證明同一履約的規範結果跨終端一致，不證明傳統文化解讀具有科學預測效力。

HTTP 402 按上方流程處理支付；400 先修正輸入且確認欄位型別、長度和列舉值後再重試，不要重複付款；409 訂單或冪等鍵衝突時使用新冪等鍵；410 表示訂單已過期；429 按 Retry-After 等待；5xx 告知暫不可用。

這個決策助手質量中等偏上，優勢是文件規範、風險提示充分、多端場景考慮周全。缺點是隻有一個文件，內容偏向技術協議，缺少實際使用示例；命理分析規則不透明，使用者無法瞭解建議依據；完全依賴外部服務，斷網時無法使用。如果對命理分析有需求且願意付費，可嘗試體驗，但重大決策不建議僅依賴其建議。