龍魂社區·飛書反饋機器人需求文檔(審查完善版)
DNA: #龍芯⚡️2026-07-02-LONGHUN-COMMUNITY-FEEDBACK-BOT-REQ-UID9622-v1.1
歸屬: 龍魂系統 · UID9622 · 龍芯北辰·諸葛鑫
審查人: 龍魂文檔審查專員
協議: 龍魂開源公約 v2.0 — 非商業、非封閉、非篡改
狀態: 🟢審查通過,補充完善後定型
第一章:審查摘要與變更日誌
1.1 審查結論
原始文檔(v1.0)結構清晰、理念端正,但在治理機制落地細節、飛書平台能力運用、非功能性需求、運維保障四大維度存在顯著遺漏。經龍魂治理框架對照審查,共識別出 18項遺漏,詳見下表。
1.2 遺漏項一覽表
| 序號 | 遺漏模塊 | 嚴重程度 | 所屬維度 | DNA追溯 |
|---|
| 1 | 三層監督機制(感知層→認知層→決策層) | 🔴高 | 治理框架 | #龍芯⚡️2026-07-02-SUPERVISION-3LAYER-MISSING |
| 2 | 三色審計體系的具體落地規則 | 🔴高 | 治理框架 | #龍芯⚡️2026-07-02-AUDIT-3COLOR-MISSING |
| 3 | AI Truth Protocol(真相置信度標記) | 🔴高 | 治理框架 | #龍芯⚡️2026-07-02-AITRUTH-MISSING |
| 4 | 通心譯雙語標註規範 | 🟡中 | 治理框架 | #龍芯⚡️2026-07-02-TONGXINYI-MISSING |
| 5 | 非功能性需求(性能/安全/可用性) | 🔴高 | 工程基礎 | #龍芯⚡️2026-07-02-NFR-MISSING |
| 6 | 消息卡片交互設計(飛書Card能力) | 🔴高 | 飛書能力 | #龍芯⚡️2026-07-02-CARD-UI-MISSING |
| 7 | 多維表格(Bitable)對接(飛書原生存儲) | 🟡中 | 飛書能力 | #龍芯⚡️2026-07-02-BITABLE-MISSING |
| 8 | 數據全生命周期管理(歸檔/銷毀策略) | 🔴高 | 數據治理 | #龍芯⚡️2026-07-02-LIFECYCLE-MISSING |
| 9 | 容災與異常處理機制 | 🔴高 | 運維保障 | #龍芯⚡️2026-07-02-DISASTER-RECOVERY-MISSING |
| 10 | 用戶引導與幫助系統 | 🟡中 | 用戶體驗 | #龍芯⚡️2026-07-02-ONBOARDING-MISSING |
| 11 | 反饋統計與可視化儀表盤 | 🟡中 | 社區治理 | #龍芯⚡️2026-07-02-DASHBOARD-MISSING |
| 12 | 舉報與申訴機制(社區自治核心) | 🔴高 | 社區治理 | #龍芯⚡️2026-07-02-APPEAL-MISSING |
| 13 | 數據導出與遷移能力 | 🟡中 | 數據主權 | #龍芯⚡️2026-07-02-EXPORT-MISSING |
| 14 | 部署與運維規範 | 🟡中 | 工程基礎 | #龍芯⚡️2026-07-02-DEPLOY-OPS-MISSING |
| 15 | 測試與驗收標準 | 🟡中 | 質量保障 | #龍芯⚡️2026-07-02-TEST-ACCEPT-MISSING |
| 16 | 群管理事件訂閱(加群/退群/變動) | 🟡中 | 飛書能力 | #龍芯⚡️2026-07-02-GROUP-EVENT-MISSING |
| 17 | 審批流對接預留(飛書Approval) | 🟢低 | 飛書能力 | #龍芯⚡️2026-07-02-APPROVAL-MISSING |
| 18 | 智能夥伴(AI)嵌入預留 | 🟢低 | 飛書能力 | #龍芯⚡️2026-07-02-AI-AGENT-MISSING |
審計標記說明:🔴紅色=必須補充,缺失將導致系統不完整;🟡黃色=建議補充,顯著提升可用性;🟢綠色=錦上添花,可後續迭代。
1.3 變更日誌
| 版本 | 日期 | 變更人 | 變更內容 | 審計 |
|---|
| v1.0 | 2026-07-02 | UID9622 | 原始文檔創建 | 🟢 |
| v1.1 | 2026-07-02 | 審查專員 | 補充18項遺漏,重組章節結構,新增治理機制落地細節 | 🟢 |
第二章:項目定位與願景
2.1 一句話定位
龍魂社區反饋機器人是基於飛書群聊的輕量級民意收集與分發工具,核心理念:老百姓說話的地方,老百姓自己管。
2.2 願景(Vision)
建立一個老百姓能看懂、願意用、信得過的社區反饋通道。不靠法律靠道德,用技術守護誠信,讓每一條反饋都有跡可循、每一份訴求都被認真對待。
2.3 設計原則
| 原則 | 含義 | 老百姓話 |
|---|
| 零門檻 | 飛書群裏@機器人就能反饋,不用裝新App | 會發消息就會用 |
| 透明化 | 公開反饋全鏈路可查,處理進度實時可見 | 辦到哪一步了,一眼看得見 |
| 不可篡改 | 時間戳+DNA+SHA256,誰也改不了記錄 | 說過的話,賴不掉 |
| 社區自治 | 管理員來自社區,政府只對接不控制 | 我們的事我們管 |
| 數據自主 | 數據存在本地,導出隨時可以 | 我們的數據我們做主 |
第三章:龍魂治理框架落地
3.1 三層監督機制
本系統將龍魂三層監督機制嵌入每一條反饋的全生命周期:
| 層級 | 名稱 | 作用時機 | 具體動作 | 審計標記 |
|---|
| 第一層 | 感知層篩查 | 用戶提交反饋時 | 檢查輸入格式、必填欄位完整性、關鍵字注入檢測、附件病毒掃描 | 自動執行 |
| 第二層 | 認知層驗證 | 管理員審核時 | 邏輯一致性檢查、語義分析(識別謾罵/謠言/廣告)、偏見檢測、重複反饋合併 | 人工+AI輔助 |
| 第三層 | 決策層審核 | 最終處理時 | 🟢通過(正常流轉)/ 🟡放行附警告(標記爭議)/ 🔴阻斷(駁回並記錄) | 管理員裁量 |
3.2 三色審計體系
每一條反饋、每一個操作都帶三色標記:
| 顏色 | 含義 | 適用場景 | 處理方式 |
|---|
| 🟢 綠色 | 正常已批准 | 格式完整、內容合規、通過全部三層監督 | 正常流轉,公開展示 |
| 🟡 黃色 | 標記待審查 | 內容有爭議、需要補充材料、重複反饋、情緒激烈但有理 | 暫不公開,通知用戶補充,管理員複審 |
| 🔴 紅色 | 阻斷潛在違規 | 惡意攻擊、虛假信息、廣告刷屏、違法內容、人身威脅 | 立即阻斷,記錄存檔,通知管理員,必要時封禁用戶 |
3.3 DNA追溯體系
| 級別 | DNA格式 | 示例 | 用途 |
|---|
| 系統級 | #龍芯⚡️{YYYY-MM-DD}-{項目}-{模塊}-{UID} | #龍芯⚡️2026-07-02-LONGHUN-FEEDBACK-BOT-REQ-UID9622 | 文檔/版本追溯 |
| 反饋級 | #龍魂⚡️{YYYY-MM-DD-HH-MM-SS}-{反饋ID}-{用戶哈希} | #龍魂⚡️2026-07-02-14-30-00-FB00001-A3F9 | 單條反饋終身標識 |
| 操作級 | #龍跡⚡️{時間戳}-{操作類型}-{操作人}-{關聯反饋ID} | #龍跡⚡️1719907800-REVIEW-UID9622-FB00001 | 每一次操作都留痕 |
| 審計級 | #龍審⚡️{日期}-{審計項}-{結果}-{審計人} | #龍審⚡️2026-07-02-CARD-UI-MISSING-RED | 文檔審查標記 |
3.4 君子協議(CC BY-NC-SA 4.0)
- 非商業:本系統及其衍生作品不得用於商業目的
- 非封閉:代碼開源,數據開放(隱私脫敏後)
- 非篡改:任何人不得修改龍魂核心治理規則
- 署名:使用本系統須標註「龍魂系統·UID9622」
3.5 AI Truth Protocol(真相標記)
對每一條反饋內容進行可信度評估:
| 標記 | 含義 | 判定標準 | 展示方式 |
|---|
| ✅ 已驗證 | 管理員人工核實為真 | 有實地調查或官方證明 | 綠色勾選標記 |
| 🔵 高置信 | 多源交叉印證,內容可信 | 附件充分、描述具體、可聯繫核實 | 藍色標記 |
| 🟡 中置信 | 基本可信,但細節待補 | 內容合理但缺少佐證 | 黃色標記 |
| 🟠 低置信 | 部分存疑 | 內容模糊、來源單一、與已知信息衝突 | 橙色標記 |
| ⚪ 未驗證 | 尚未進行任何驗證 | 新提交,未進入審核流程 | 灰色標記 |
| ❓ 存疑 | 發現明顯矛盾或疑似虛假 | 邏輯矛盾、與事實不符、惡意誣告 | 紅色問號標記 |
3.6 通心譯(中英雙語標註)
- 所有用戶可見的系統消息默認中文,關鍵術語附英文標註
- 管理員後台支持中英文切換
- 反饋內容如涉及少數民族語言,保留原文並附中文摘要
- 系統日誌統一使用英文(便於國際開源協作)
第四章:功能需求(完整版)
4.1 功能總覽
| 模塊 | 功能點 | 優先級 | 飛書能力對應 | DNA追溯 |
|---|
| 反饋提交 | 自由文本+標籤+附件+匿名 | P0 | 接收消息/文件 | #龍芯⚡️2026-07-02-FUNC-SUBMIT |
| 智能分流 | 5類標籤自動/手動分流 | P0 | 關鍵字匹配+群發送 | #龍芯⚡️2026-07-02-FUNC-ROUTING |
| 三層監督 | 感知→認知→決策自動檢查 | P0 | 事件訂閱+消息卡片 | #龍芯⚡️2026-07-02-FUNC-3LAYER |
| 狀態流轉 | 6狀態處理流程 | P0 | 消息卡片狀態更新 | #龍芯⚡️2026-07-02-FUNC-STATUS |
| 反饋查詢 | 用戶自查+公開查詢 | P0 | @機器人查詢指令 | #龍芯⚡️2026-07-02-FUNC-QUERY |
| 統計儀表盤 | 社區反饋數據可視化 | P1 | 多維表格+卡片 | #龍芯⚡️2026-07-02-FUNC-DASHBOARD |
| 舉報申訴 | 用戶舉報+管理員複審 | P1 | 消息卡片按鈕 | #龍芯⚡️2026-07-02-FUNC-APPEAL |
| 幫助引導 | 新手引導+命令說明 | P1 | 歡迎消息+卡片 | #龍芯⚡️2026-07-02-FUNC-HELP |
| 數據導出 | JSON/CSV導出+備份 | P1 | 文件消息發送 | #龍芯⚡️2026-07-02-FUNC-EXPORT |
| 審批流對接 | 飛書Approval集成 | P2 | 審批API | #龍芯⚡️2026-07-02-FUNC-APPROVAL |
| AI輔助 | 智能分類+摘要生成 | P2 | 智能夥伴 | #龍芯⚡️2026-07-02-FUNC-AI |
4.2 反饋提交(FR-001~FR-006)
FR-001 文本反饋提交
- 觸發方式:群聊中@機器人 + 反饋內容
- 輸入內容:自由文本(10~2000字)
- 感知層檢查:
- 字數不足10字 → 🟡標記「內容過短,請補充細節」
- 字數超過2000字 → 🟡標記「內容較長,建議拆分或精簡」
- 包含SQL注入/腳本標籤 → 🔴阻斷
- 純表情/無意義字符 → 🔴阻斷
FR-002 標籤選擇
- 自動標籤:機器人根據關鍵字自動建議標籤
- 手動標籤:用戶可覆蓋或補充
- 標籤體系:
| 標籤 | 含義 | 誰能看到 | 流向 |
|---|
#公開 | 所有人可見的社區事務 | 所有人 | 公開群公示 |
#私密 | 不願公開的個人事務 | 僅管理員+本人 | 管理員私聊處理 |
#維權 | 權益受損需法律/行政支持 | 管理員+政府對接人 | 維權專線+政府通道 |
#建議 | 對社區/物業/政府的建設性意見 | 所有人 | 公開群+定期彙總 |
#政府預留 | 需政府部門處理的公共事務 | 管理員+政府對接人 | 政府接口通道 |
FR-003 附件上傳
- 支持類型:圖片(JPG/PNG)、文件(PDF/DOC/MAX 20MB)
- 感知層檢查:文件類型白名單、大小限制、病毒掃描哈希比對
- 存儲方式:本地加密存儲 + 原文件SHA256摘要記錄
FR-004 匿名提交
- 實現方式:用戶選擇匿名後,系統記錄用戶哈希(用於查詢本人反饋),不對外公開真實身份
- 匿名限制:匿名用戶不能提交
#維權類反饋(維權需真實身份便於後續法律程序) - 管理員可見:匿名僅對公眾隱藏,管理員後台可見真實身份(防止惡意濫用)
FR-005 提交確認
- 提交成功後,機器人回覆確認卡片,包含:
- 反饋ID(DNA格式)
- 提交時間
- 自動分配的標籤
- 預計處理時限
- 查詢命令(
@機器人 查詢 {反饋ID})
FR-006 提交頻率限制
- 同一用戶24小時內最多提交10條反饋
- 超過限制 → 🟡標記「提交過於頻繁,請明日再試」
- 連續3天觸發頻率限制 → 管理員介入審查
4.3 智能分流(FR-007~FR-009)
FR-007 自動分流規則
| 觸發條件 | 自動標籤 | 分流目標 | 審計標記 |
|---|
| 文本含「物業/停車/噪音/衛生/電梯」 | #公開 | 社區公開群 | 🟢 |
| 文本含「隱私/個人/不想公開」 | #私密 | 管理員私聊 | 🟢 |
| 文本含「維權/侵權/違法/起訴/賠償」 | #維權 | 維權專線群 | 🟡 |
| 文本含「建議/能不能/希望/改善」 | #建議 | 社區公開群 | 🟢 |
| 文本含「街道/居委/政府/公園/馬路」 | #政府預留 | 政府對接群 | 🟡 |
| 同時觸發多個關鍵字 | 置信度最高者 | 人工複核 | 🟡 |
FR-008 人工複核
- 自動分流置信度低於80%時,進入人工複核隊列
- 管理員24小時內完成複核,否則自動按最高置信標籤流轉
- 複核操作記錄操作級DNA
FR-009 分流通知
- 分流完成後,機器人向目標群發送通知卡片
- 卡片包含:反饋摘要、標籤、緊急程度、處理時限
4.4 狀態流轉(FR-010~FR-015)
FR-010 六狀態流程
待處理 → 核實中 → 已核實 → 已轉交 → 已解決
↑ ↑ ↑
待澄清 ←──┘ └─── 可退回
| 狀態 | 含義 | 誰能操作 | 預計停留時間 |
|---|
| 📥 待處理 | 剛提交,等待分流/初審 | 系統自動/管理員 | < 4小時 |
| 🔍 核實中 | 管理員正在核實內容真實性 | 管理員 | < 48小時 |
| ✅ 已核實 | 內容確認屬實,進入處理階段 | 管理員 | < 24小時 |
| 📤 已轉交 | 已轉交相關方處理(物業/政府) | 管理員 | 視事項而定 |
| ✔️ 已解決 | 問題已解決,反饋歸檔 | 管理員/自動 | 永久保存 |
| ❓ 待澄清 | 需要反饋人補充信息 | 管理員→用戶 | < 72小時(超時自動關閉) |
FR-011 狀態變更通知
- 每次狀態變更,機器人自動@反饋人發送狀態更新卡片
- 公開反饋的狀態變更同步到公開群
FR-012 超時預警
- 每個狀態設置超時閾值
- 即將超時(剩餘20%時間)→ 管理員群預警通知
- 已超時 → 自動升級優先級,標記🟡
FR-013 狀態變更審計
- 每次狀態變更記錄操作級DNA
- 包括:操作人、操作時間、變更原因、新舊狀態
FR-014 自動歸檔
- 狀態為「已解決」且30天無新操作 → 自動歸檔
- 歸檔後仍可查詢,但不再活躍展示
FR-015 重新打開
- 用戶可在「已解決」後7天內申請重新打開
- 申請需說明原因,管理員審核後決定是否重新打開
4.5 反饋查詢(FR-016~FR-019)
FR-016 個人查詢
- 命令:
@機器人 查詢 或 @機器人 查詢 {反饋ID} - 權限:僅可查詢本人提交的反饋
- 返回:反饋列表卡片(ID、狀態、提交時間、標題摘要)
FR-017 公開查詢
- 命令:
@機器人 公開反饋 或 @機器人 查詢公開 {關鍵詞} - 權限:所有人可查
- 返回:公開反饋的脫敏列表(隱藏提交人身份)
FR-018 管理員查詢
- 命令:
@機器人 管理查詢 {條件} - 權限:僅管理員
- 條件支持:按狀態/標籤/時間範圍/用戶/關鍵詞組合查詢
FR-019 查詢結果分頁
- 每頁顯示10條,支持「下一頁/上一頁」按鈕
- 飛書消息卡片實現分頁導航
4.6 統計儀表盤(FR-020~FR-023)【新增】
FR-020 社區反饋看板
- 觸發:
@機器人 看板 - 內容:本月反饋總數、各狀態分佈、熱點標籤、平均處理時長
- 呈現:飛書消息卡片(帶簡單圖表)
FR-021 週報自動推送
- 每週一上午9點自動推送上週統計到管理群
- 內容:新增反饋數、已解決數、超時未處理數、熱點關鍵詞TOP5
FR-022 趨勢預警
- 某類反饋連續3天激增(超過平均值2倍)→ 自動預警通知管理員
- 如:連續3天「電梯故障」反饋暴增 → 🟡預警「電梯問題集中爆發,建議緊急排查」
FR-023 數據可視化
- 基礎圖表:柱狀圖(各類型分佈)、折線圖(趨勢)、餅圖(狀態佔比)
- 呈現方式:飛書卡片消息中的統計組件
4.7 舉報與申訴(FR-024~FR-028)【新增】
FR-024 反饋舉報
- 命令:在任意公開反饋下回覆
@機器人 舉報 {反饋ID} {原因} - 原因選項:虛假信息、惡意攻擊、廣告推銷、違法內容、侵權抄襲
- 流程:舉報後該反饋自動標記🟡,進入複審隊列
FR-025 管理員複審
- 收到舉報後24小時內完成複審
- 複審結果:維持原狀 / 隱藏反饋 / 刪除反饋 / 封禁用戶
- 每次複審記錄操作級DNA
FR-026 用戶申訴
- 用戶認為自己的反饋被錯誤處理 →
@機器人 申訴 {反饋ID} {理由} - 申訴進入獨立審核流程,由非原處理管理員複審
- 申訴結果不可再申訴(一次機會)
FR-027 誠信記錄
- 每個用戶維護誠信積分(初始100分)
- 提交有效反饋+1分,提交被🔴阻斷的反饋-5分,惡意舉報-10分
- 積分低於60分 → 限制提交頻率
- 積分低於30分 → 暫時禁言,需管理員解封
FR-028 社區調解
- 爭議較大的反饋,管理員可發起「社區調解」
- 邀請相關方在群內公開討論,機器人記錄調解過程
- 調解結果作為最終處理依據
4.8 幫助與引導(FR-029~FR-032)【新增】
FR-029 新人歡迎
- 用戶首次@機器人 → 自動發送歡迎卡片
- 卡片內容:系統介紹(一句話)、常用命令、提交示例
FR-030 幫助命令
- 命令:
@機器人 幫助 - 返回:分類幫助卡片(如何提交/如何查詢/標籤說明/聯繫管理員)
FR-031 錯誤引導
- 用戶輸入無法識別的命令 → 友好提示 + 建議正確命令
- 示例:「親,沒看懂您的意思😊 您可以試試:@機器人 幫助」
FR-032 操作示例
- 幫助卡片中內置「試一試」按鈕
- 點擊後展示交互式演示(非真實提交,僅展示流程)
第五章:非功能性需求(新增章節)
DNA: #龍芯⚡️2026-07-02-NFR-SECTION-ADDED
5.1 性能需求
| 指標 | 目標值 | 說明 |
|---|
| 消息響應延遲 | < 2秒 | 用戶@機器人到收到回覆的時間 |
| 狀態變更通知延遲 | < 30秒 | 狀態變更到通知送達的時間 |
| 並發處理能力 | ≥ 50人同時提交 | 社區活動高峰期 |
| 查詢響應時間 | < 3秒 | 單條件查詢1000條記錄內 |
| 統計看板生成 | < 5秒 | 月度統計數據計算+卡片渲染 |
| 系統可用性 | ≥ 99.5% | 月度統計,允許3.6小時停機 |
5.2 安全需求
| 類別 | 要求 | 實現方式 |
|---|
| 數據加密 | 靜態數據全部加密 | SM4國密算法加密存儲 |
| 傳輸加密 | 與飛書服務器通信加密 | HTTPS/TLS 1.3 |
| 身份驗證 | 飛書簽名驗證 | 飛書API簽名機制 |
| 訪問控制 | 基於角色的權限控制 | 角色-權限矩陣 |
| 審計日誌 | 所有操作可追溯 | SHA256哈希鏈 |
| 防注入 | 輸入過濾+參數化查詢 | 正則過濾+預編譯語句 |
| 防重放 | 請求時效性驗證 | 時間戳+Nonce機制 |
5.3 可用性需求
| 指標 | 目標值 |
|---|
| 首次使用成功率(不看幫助完成提交) | ≥ 80% |
| 用戶滿意度(反饋處理評價) | ≥ 4.0/5.0 |
| 系統學習成本 | < 5分鐘 |
| 幫助文檔覆蓋率 | 100%功能點 |
| 飛書消息可讀性 | 支持手機/桌面端自適應 |
5.4 可擴展性需求
| 場景 | 要求 |
|---|
| 用戶量增長 | 支持從100人擴展到5000人社區無需重構 |
| 存儲增長 | 支持5年數據積累,自動歸檔機制 |
| 功能擴展 | 模塊化設計,新增標籤/流程無需改核心代碼 |
| 多社區部署 | 支持多個獨立社區實例運行 |
5.5 兼容性需求
| 平台 | 支持 |
|---|
| 飛書桌面端(Win/Mac) | ✅ |
| 飛書移動端(iOS/Android) | ✅ |
| 飛書網頁版 | ✅ |
| 消息類型(文本/圖片/文件) | ✅ |
第六章:角色與權限矩陣
6.1 角色定義
| 角色 | 人數 | 來源 | 職責 |
|---|
| 普通用戶 | 不限 | 社區居民 | 提交反饋、查詢反饋、舉報違規 |
| 管理員(UID9622) | 3~5人 | 社區選舉/推舉 | 審核反饋、狀態流轉、處理舉報、數據導出 |
| 政府對接人 | 1~2人 | 街道/居委指派 | 查看政府預留反饋、接收轉交事項 |
| 匿名用戶 | 不限 | 用戶自選 | 僅限提交公開/私密/建議類反饋 |
| 系統機器人 | 1個 | 自動運行 | 自動分流、狀態通知、定時任務 |
6.2 權限矩陣(功能×角色)
| 功能 | 普通用戶 | 管理員 | 政府對接人 | 匿名用戶 |
|---|
| 提交反饋(文本) | ✅ | ✅ | ❌ | ✅ |
| 提交反饋(含附件) | ✅ | ✅ | ❌ | ✅ |
選擇#維權標籤 | ✅ | ✅ | ❌ | ❌ |
| 查詢本人反饋 | ✅ | ✅ | ❌ | ✅(憑反饋ID) |
| 查詢公開反饋 | ✅ | ✅ | ✅ | ✅ |
| 舉報他人反饋 | ✅ | ✅ | ✅ | ❌ |
| 申訴處理結果 | ✅ | ✅ | ❌ | ❌ |
| 審核待處理反饋 | ❌ | ✅ | ❌ | ❌ |
| 變更反饋狀態 | ❌ | ✅ | ❌ | ❌ |
| 處理舉報 | ❌ | ✅ | ❌ | ❌ |
| 查看統計看板 | ❌ | ✅ | ✅(僅政府預留) | ❌ |
| 導出數據 | ❌ | ✅ | ❌ | ❌ |
| 系統配置 | ❌ | ✅ | ❌ | ❌ |
| 用戶封禁/解封 | ❌ | ✅ | ❌ | ❌ |
✅ = 有權限,❌ = 無權限
6.3 權限變更流程
- 管理員新增:現有管理員全體投票,2/3通過
- 管理員移除:現有管理員全體投票,3/4通過,或連續30天未上線自動降級
- 政府對接人:由街道/居委書面函件確認,管理員錄入系統
- 權限變更記錄:每次變更記錄操作級DNA,永久追溯
第七章:數據主權與全生命周期管理
7.1 存儲架構
| 層級 | 路徑 | 內容 | 加密方式 |
|---|
| 原始數據 | ~/longhun-system/data/feedback/raw/ | 用戶提交的原始反饋(含附件) | SM4加密 |
| 索引數據 | ~/longhun-system/data/feedback/index/ | 反饋索引(便於快速查詢) | SM4加密 |
| 審計日誌 | ~/longhun-system/data/feedback/audit/ | 所有操作日誌(DNA追溯) | SHA256哈希鏈 |
| 歸檔數據 | ~/longhun-system/data/feedback/archive/ | 已解決超30天的歷史反饋 | SM4加密+壓縮 |
| 備份數據 | ~/longhun-system/backup/feedback/ | 周備份(異地/異介質) | SM4加密 |
7.2 數據格式
- 反饋記錄:JSONL格式(每行一條記錄,便於追加和流式處理)
- 審計日誌:JSONL格式,每條記錄包含完整DNA追溯信息
- 導出格式:支持JSON(完整)/ CSV(表格)/ Markdown(可讀)
7.3 數據生命周期
| 階段 | 時長 | 存儲位置 | 可訪問性 | 操作 |
|---|
| 活躍期 | 提交後~30天 | 原始數據目錄 | 活躍查詢 | 正常讀寫 |
| 歸檔期 | 30天~2年 | 歸檔數據目錄 | 可查詢不可修改 | 自動遷移 |
| 冷存期 | 2年~5年 | 冷存儲(壓縮備份) | 需管理員恢復 | 手動恢復查詢 |
| 銷毀期 | > 5年 | — | 不可訪問 | 安全銷毀 |
7.4 備份策略
| 備份類型 | 頻率 | 保留份數 | 存儲位置 |
|---|
| 增量備份 | 每日 | 7份(滾動) | 本地備份目錄 |
| 全量備份 | 每週 | 4份(滾動月) | 本地+異地(推薦雲存儲) |
| 歸檔備份 | 每月 | 永久 | 冷存儲 |
7.5 數據導出(FR-033~FR-035)
FR-033 管理員導出
- 命令:
@機器人 導出 {時間範圍} {格式} - 權限:僅管理員
- 格式:JSON / CSV / Markdown
- 內容:反饋內容+狀態+操作日誌(脫敏處理)
- 發送方式:機器人私聊發送文件
FR-034 用戶導出本人數據
- 命令:
@機器人 導出我的數據 - 權限:所有用戶
- 內容:該用戶提交的所有反饋
- 用途:保障用戶數據主權,符合隱私保護原則
FR-035 數據遷移支持
- 數據導出格式標準化,支持遷移至其他系統
- 提供數據結構文檔(JSON Schema)
第八章:飛書機器人技術配置
8.1 基礎配置
| 配置項 | 值 | 說明 |
|---|
| 機器人名稱 | 龍魂反饋助手 | 群聊顯示名稱 |
| 機器人頭像 | 龍魂Logo | 龍魂系統統一標識 |
| 描述 | 「老百姓說話的地方」— 社區反饋收集與分發 | 用戶添加時可見 |
| 權限範圍 | 群聊+私聊 | 支持群內@和私聊反饋 |
| IP白名單 | 服務器公網IP | 安全策略 |
| 事件訂閱 | 開啟 | 接收消息+群事件 |
| 消息加密 | 開啟 | 啟用Encrypt Key |
8.2 事件訂閱配置
| 事件類型 | 是否訂閱 | 用途 | DNA追溯 |
|---|
| 接收消息 | ✅ | 用戶@機器人發送反饋 | #龍芯⚡️2026-07-02-EVENT-MESSAGE |
| 消息已讀 | ❌ | 暫不需要 | — |
| 群成員加入 | ✅ | 自動發送歡迎+幫助 | #龍芯⚡️2026-07-02-EVENT-GROUP-JOIN |
| 群成員退出 | ✅ | 記錄(如有未處理反饋標記) | #龍芯⚡️2026-07-02-EVENT-GROUP-LEAVE |
| 群設置變更 | ✅ | 記錄群名/群主變更 | #龍芯⚡️2026-07-02-EVENT-GROUP-UPDATE |
| 機器人被添加進群 | ✅ | 發送歡迎消息+功能說明 | #龍芯⚡️2026-07-02-EVENT-BOT-ADDED |
| 機器人被移出群 | ✅ | 記錄原因,暫停該群服務 | #龍芯⚡️2026-07-02-EVENT-BOT-REMOVED |
8.3 指令系統
用戶指令
| 指令 | 功能 | 示例 | 權限 |
|---|
@機器人 {內容} | 提交反饋 | @龍魂反饋助手 小區東門路燈壞了三天 | 所有人 |
@機器人 查詢 | 查本人所有反饋 | @龍魂反饋助手 查詢 | 所有人 |
@機器人 查詢 {ID} | 查指定反饋 | @龍魂反饋助手 查詢 FB00001 | 所有人+管理員 |
@機器人 公開反饋 | 查看公開反饋列表 | @龍魂反饋助手 公開反饋 | 所有人 |
@機器人 舉報 {ID} {原因} | 舉報違規反饋 | @龍魂反饋助手 舉報 FB00001 虛假信息 | 所有人 |
@機器人 申訴 {ID} {理由} | 申訴處理結果 | @龍魂反饋助手 申訴 FB00001 問題未解決 | 反饋提交人 |
@機器人 看板 | 查看統計看板 | @龍魂反饋助手 看板 | 所有人 |
@機器人 幫助 | 查看幫助信息 | @龍魂反饋助手 幫助 | 所有人 |
@機器人 導出我的數據 | 導出本人數據 | @龍魂反饋助手 導出我的數據 | 所有人 |
管理員指令
| 指令 | 功能 | 示例 | 權限 |
|---|
@機器人 管理查詢 {條件} | 高級查詢 | @機器人 管理查詢 狀態=待處理 標籤=#公開 | 管理員 |
@機器人 設置狀態 {ID} {狀態} {原因} | 變更反饋狀態 | @機器人 設置狀態 FB00001 核實中 正在聯繫物業 | 管理員 |
@機器人 導出 {範圍} {格式} | 導出數據 | @機器人 導出 2026-06 格式=CSV | 管理員 |
@機器人 統計 | 查看詳細統計 | @機器人 統計 | 管理員 |
@機器人 用戶信息 {用戶ID} | 查看用戶誠信記錄 | @機器人 用戶信息 @張三 | 管理員 |
@機器人 封禁 {用戶ID} {原因} | 封禁用戶 | @機器人 封禁 @張三 惡意刷屏 | 管理員 |
@機器人 解封 {用戶ID} | 解禁用戶 | @機器人 解封 @張三 | 管理員 |
第九章:交互設計與消息卡片
DNA: #龍芯⚡️2026-07-02-CARD-UI-SECTION-ADDED
9.1 消息卡片設計原則
飛書消息卡片是核心交互載體,需遵循:
- 一眼看懂:老百姓不用思考就知道該點哪
- 手機友好:按鈕夠大、字夠清楚
- 龍魂風格:每張卡片帶DNA標記
- 三色審計:狀態用顏色區分
9.2 反饋提交確認卡片
┌─────────────────────────────────┐
│ 🐉 龍魂反饋助手 │
│ ───────────────────────────── │
│ ✅ 反饋已收到! │
│ ───────────────────────────── │
│ 📋 反饋ID: #龍魂⚡️2026-07-02- │
│ 14-30-00-FB00001-A3F9 │
│ 🏷️ 標籤: #公開 │
│ ⏰ 提交時間: 2026-07-02 14:30 │
│ ⏳ 預計處理: 48小時內 │
│ ───────────────────────────── │
│ 📌 當前狀態: 📥 待處理 │
│ ───────────────────────────── │
│ [查看詳情] [查詢進度] [撤回] │
│ ───────────────────────────── │
│ 💡 提示: 輸入「@機器人 查詢 │
│ FB00001」隨時查看進度 │
└─────────────────────────────────┘
9.3 狀態更新卡片
┌─────────────────────────────────┐
│ 🐉 龍魂反饋助手 · 狀態更新 │
│ ───────────────────────────── │
│ 📋 反饋ID: FB00001 │
│ ───────────────────────────── │
│ 📌 狀態變更: │
│ 📥 待處理 → 🔍 核實中 │
│ 👤 操作人: 管理員·UID9622 │
│ 🕐 時間: 2026-07-02 16:00 │
│ 📝 備註: 已聯繫物業核實 │
│ ───────────────────────────── │
│ 🟢 審計: 通過三層監督 │
│ #龍跡⚡️1719907800-REVIEW-UID... │
│ ───────────────────────────── │
│ [查看詳情] [補充信息] [催辦] │
└─────────────────────────────────┘
9.4 公開反饋列表卡片
┌─────────────────────────────────┐
│ 🐉 公開反饋看板 · 最近10條 │
│ ───────────────────────────── │
│ 1. 🟢 FB00005 #建議 電梯加裝 │
│ 顯示器 📥待處理 2小時前 │
│ 2. 🟢 FB00004 #公開 路燈維修 │
│ ✅已核實 1天前 │
│ 3. 🟡 FB00003 #維權 停車糾紛 │
│ 🔍核實中 2天前 │
│ ... │
│ ───────────────────────────── │
│ [上一頁] 第2/5頁 [下一頁] │
│ [篩選標籤] [排序方式] │
└─────────────────────────────────┘
9.5 統計看板卡片
┌─────────────────────────────────┐
│ 📊 龍魂社區反饋月報 · 2026年7月 │
│ ───────────────────────────── │
│ 📨 本月反饋: 45條 │
│ ✅ 已解決: 32條 (71%) │
│ 🔍 核實中: 8條 │
│ 📥 待處理: 3條 │
│ ❓ 待澄清: 2條 │
│ ───────────────────────────── │
│ 🏷️ 熱點標籤: #公開(20) #建議(15)│
│ ⏱️ 平均處理: 36小時 │
│ 😊 滿意度: 4.2/5.0 │
│ ───────────────────────────── │
│ ⚠️ 趨勢預警: 「電梯」類反饋 │
│ 本週增長200%,建議關注 │
│ ───────────────────────────── │
│ [查看詳情] [導出報表] [設置] │
└─────────────────────────────────┘
9.6 幫助卡片
┌─────────────────────────────────┐
│ 🐉 龍魂反饋助手 · 使用幫助 │
│ ───────────────────────────── │
│ 💬 提交反饋: │
│ @機器人 你的反饋內容 │
│ 📋 查詢反饋: │
│ @機器人 查詢 │
│ 🔍 查公開反饋: │
│ @機器人 公開反饋 │
│ ⚖️ 舉報違規: │
│ @機器人 舉報 {ID} {原因} │
│ 📊 查看統計: │
│ @機器人 看板 │
│ ───────────────────────────── │
│ 🏷️ 標籤說明: │
│ #公開 #私密 #維權 #建議 │
│ #政府預留 │
│ ───────────────────────────── │
│ [🏷️ 標籤詳情] [❓ 常見問題] │
│ [📖 完整文檔] [🎮 試一試] │
└─────────────────────────────────┘
9.7 多維表格(Bitable)集成方案【新增】
利用飛書多維表格作為可視化管理後台:
| 用途 | 實現方式 | 權限 |
|---|
| 反饋總表 | 機器人自動同步所有反饋到Bitable | 管理員可見 |
| 狀態看板 | Bitable看板視圖,按狀態分組 | 管理員可見 |
| 統計圖表 | Bitable儀表盤視圖 | 管理員可見 |
| 政府對接 | 政府預留反饋單獨視圖 | 政府對接人可見 |
同步機制:
- 實時同步:反饋狀態變更時立即同步到Bitable
- 定時同步:每小時全量校驗一次
- 衝突解決:以本地數據為準,Bitable為只讀展示
第十章:三層監督與三色審計落地
DNA: #龍芯⚡️2026-07-02-3LAYER-IMPLEMENTATION
10.1 感知層技術實現
| 檢查項 | 規則 | 阻斷/警告 | 審計標記 |
|---|
| 格式檢查 | 文本長度10~2000字 | 🟡警告 | FORMAT_CHECK |
| 注入檢測 | 禁止SQL/JS/HTML標籤 | 🔴阻斷 | INJECTION_BLOCKED |
| 敏感詞初篩 | 違法/暴恐/色情關鍵字庫 | 🔴阻斷 | SENSITIVE_BLOCKED |
| 附件檢查 | 類型白名單+大小限制+哈希比對 | 🔴阻斷 | FILE_CHECK_FAIL |
| 頻率限制 | 24小時10條/用戶 | 🟡警告 | RATE_LIMIT |
| 重複檢測 | 與最近100條相似度>90% | 🟡警告 | DUPLICATE_DETECTED |
10.2 認知層技術實現
| 檢查項 | 方法 | 審計標記 |
|---|
| 邏輯一致性 | 時間/地點/人物交叉驗證 | LOGIC_CHECK |
| 語義分析 | 識別謾罵/謠言/廣告/情緒極端 | SEMANTIC_ANALYSIS |
| 偏見檢測 | 識別地域/性別/年齡歧視言論 | BIAS_DETECTED |
| 重複合併 | 建議將相似反饋合併處理 | MERGE_SUGGESTED |
| 真相置信度 | AI Truth Protocol評分 | TRUTH_SCORE |
10.3 決策層操作流程
感知層通過 → 認知層驗證 → 決策層裁定
↓
┌────────┼────────┐
↓ ↓ ↓
🟢通過 🟡警告 🔴阻斷
↓ ↓ ↓
正常流轉 標記複審 駁回記錄
10.4 三色審計操作記錄
每一條反饋帶有審計記錄鏈:
{
"feedback_id": "FB00001",
"dna": "#龍魂⚡️2026-07-02-14-30-00-FB00001-A3F9",
"audit_chain": [
{
"timestamp": "2026-07-02T14:30:00+08:00",
"level": "感知層",
"action": "FORMAT_CHECK",
"result": "🟢通過",
"detail": "字數156,格式正常",
"dna": "#龍跡⚡️1719907800-FORMAT-SYSTEM-FB00001"
},
{
"timestamp": "2026-07-02T14:30:01+08:00",
"level": "感知層",
"action": "INJECTION_CHECK",
"result": "🟢通過",
"detail": "無注入風險",
"dna": "#龍跡⚡️1719907801-INJECT-SYSTEM-FB00001"
},
{
"timestamp": "2026-07-02T14:30:02+08:00",
"level": "認知層",
"action": "SEMANTIC_ANALYSIS",
"result": "🟢通過",
"detail": "內容建設性,置信度92%",
"dna": "#龍跡⚡️1719907802-SEMANTIC-SYSTEM-FB00001"
},
{
"timestamp": "2026-07-02T16:00:00+08:00",
"level": "決策層",
"action": "ADMIN_REVIEW",
"result": "🟢通過",
"detail": "內容屬實,進入處理流程",
"operator": "UID9622",
"dna": "#龍跡⚡️1719914400-REVIEW-UID9622-FB00001"
}
]
}
第十一章:AI Truth Protocol 落地
DNA: #龍芯⚡️2026-07-02-AITRUTH-IMPLEMENTATION
11.1 置信度評估維度
| 維度 | 權重 | 評估方法 |
|---|
| 內容具體性 | 25% | 是否包含時間/地點/人物/證據 |
| 附件充分性 | 20% | 是否有照片/文件/截圖佐證 |
| 歷史可信度 | 20% | 提交人過往反饋的準確率 |
| 交叉印證 | 20% | 是否有其他用戶類似反饋 |
| 語義合理性 | 15% | 內容邏輯是否自洽 |
11.2 置信度計算與標記
- 綜合評分 ≥ 90 → ✅已驗證
- 綜合評分 75~89 → 🔵高置信
- 綜合評分 60~74 → 🟡中置信
- 綜合評分 40~59 → 🟠低置信
- 綜合評分 < 40 → ⚪未驗證(新提交默認)
- 發現矛盾 → ❓存疑
11.3 置信度動態更新
- 新提交默認⚪未驗證
- 管理員核實後可手動調整
- 出現新的交叉證據時自動重新計算
- 最終以管理員人工判定為準
第十二章:道德框架與誠信底線
12.1 不靠法律靠道德
| 場景 | 法律方式 | 龍魂方式(道德約束) |
|---|
| 虛假信息 | 起訴誹謗 | 誠信積分扣減+社區公示 |
| 惡意攻擊 | 報警處理 | 封禁+社區調解 |
| 隱私洩露 | 法律訴訟 | 管理員刪除+道歉+誠信扣分 |
| 管理員濫權 | 行政投訴 | 社區投票罷免 |
12.2 誠信基石
- 真實:反饋內容須基於真實經歷,不得捏造
- 善意:即使批評也應出於建設性目的
- 負責:對自己的言論負責,匿名不逃避責任
- 尊重:尊重他人,不人身攻擊
12.3 隱私保護
| 數據類型 | 保護級別 | 處理規則 |
|---|
| 用戶真實姓名 | 🔴最高 | 僅管理員可見,不對外公開 |
| 手機號/地址 | 🔴最高 | 僅管理員可見,加密存儲 |
| 反饋內容(私密) | 🔴最高 | 僅管理員+本人可見 |
| 反饋內容(公開) | 🟡中等 | 脫敏後公開 |
| 匿名標識哈希 | 🟡中等 | 用於追溯但無法反推身份 |
| 統計數據 | 🟢公開 | 聚合數據,不可定位個人 |
12.4 數據不離開本地
- 所有原始數據存儲在社區本地服務器
- 飛書僅作為消息通道,不存儲業務數據
- 備份數據加密後可選擇上傳至社區控制的雲存儲
- 隨時可導出、可遷移、可銷毀
第十三章:擴展預留與系統集成
13.1 政府接口預留
| 接口 | 功能 | 對接方式 | 狀態 |
|---|
| 反饋推送 | 將#政府預留反饋推送至政府系統 | API/Webhook | 預留 |
| 處理回執 | 接收政府處理結果並更新狀態 | API回調 | 預留 |
| 進度查詢 | 查詢政府端處理進度 | API查詢 | 預留 |
| 電子簽章 | 政府回執帶電子簽章驗證 | 數字證書 | 預留 |
13.2 公眾查詢預留
| 功能 | 說明 | 實現方式 |
|---|
| 公開門戶 | 無需登錄即可查看公開反饋 | 網頁(獨立於飛書) |
| 二維碼查詢 | 每條公開反饋生成二維碼,掃碼查看進度 | 飛書群分享 |
| 訂閱通知 | 訂閱某類反饋,有新進展時通知 | 飛書機器人推送 |
13.3 維權跟蹤預留
| 功能 | 說明 | 實現方式 |
|---|
| 維權檔案 | 為每條維權反饋建立獨立檔案 | 獨立存儲目錄 |
| 時間軸記錄 | 自動記錄維權全過程的時間軸 | 日誌自動生成 |
| 材料清單 | 跟踪需要補充的法律材料 | 管理員手動維護 |
| 進度提醒 | 關鍵節點自動提醒(如訴訟時效) | 定時任務 |
13.4 信用體系預留
| 功能 | 說明 | 實現方式 |
|---|
| 誠信積分 | 每個用戶的誠信記錄 | 本系統已實現 |
| 貢獻排行 | 積極反饋用戶的榮譽展示 | 月度公開表彰 |
| 社區勳章 | 長期貢獻者的虛擬榮譽 | 飛書表情/稱號 |
13.5 AI智能輔助預留
| 功能 | 說明 | 實現方式 | 優先級 |
|---|
| 智能分類 | AI自動識別反饋類型 | 調用飛書智能夥伴API | P2 |
| 摘要生成 | 自動生成反饋摘要 | 大語言模型 | P2 |
| 情感分析 | 識別用戶情緒,優先處理緊急反饋 | 大語言模型 | P2 |
| 智能回覆 | 常見問題自動回覆 | 知識庫+大語言模型 | P3 |
13.6 飛書審批流對接預留
| 場景 | 對接方式 | 狀態 |
|---|
| 反饋轉交政府前需審批 | 調用飛書Approval API創建審批單 | 預留 |
| 維權事項重大決策審批 | 管理員群體投票通過飛書審批 | 預留 |
| 用戶封禁需多管理員確認 | 創建審批流程,2/3通過 | 預留 |
第十四章:部署與運維(新增章節)
DNA: #龍芯⚡️2026-07-02-DEPLOY-OPS-ADDED
14.1 部署架構
| 組件 | 部署方式 | 要求 |
|---|
| 飛書機器人 | 飛書開放平台創建+配置 | 企業/團隊管理員權限 |
| 反饋處理服務 | 本地服務器/雲服務器 | Python運行環境 |
| 數據存儲 | 本地文件系統 | 磁盤空間≥50GB |
| 備份存儲 | 本地+異地(推薦) | 可選雲存儲 |
| Bitable同步 | 飛書多維表格 | 企業版飛書 |
14.2 運維監控
| 監控項 | 頻率 | 告警閾值 | 處理方式 |
|---|
| 服務存活 | 每分鐘 | 連續2次無響應 | 自動重啟+通知管理員 |
| 磁盤空間 | 每小時 | 使用率>85% | 通知管理員清理歸檔 |
| 飛書API調用 | 每小時 | 錯誤率>5% | 通知管理員檢查配置 |
| 備份狀態 | 每日 | 備份失敗 | 立即通知管理員 |
| 異常提交 | 實時 | 🔴阻斷>10次/小時 | 通知管理員檢查攻擊 |
14.3 容災與異常處理
| 場景 | 影響 | 處理方案 | RTO |
|---|
| 服務器宕機 | 無法接收新反饋 | 重啟服務,未處理消息隊列恢復 | < 10分鐘 |
| 飛書API故障 | 無法收發消息 | 本地隊列暫存,API恢復後補發 | < 1小時 |
| 數據文件損壞 | 歷史數據丟失 | 從備份恢復,丟失最近1天數據 | < 2小時 |
| 管理員全部離線 | 無法人工審核 | 自動流轉模式,感知層自動處理 | 無停機 |
| 誤刪數據 | 數據丟失 | 從備份恢復,操作級DNA追溯責任人 | < 4小時 |
14.4 日誌管理
| 日誌類型 | 保留時長 | 存儲位置 | 用途 |
|---|
| 運行日誌 | 30天 | ~/longhun-system/logs/ | 排查問題 |
| 審計日誌 | 永久 | ~/longhun-system/data/feedback/audit/ | 追溯責任 |
| 訪問日誌 | 90天 | ~/longhun-system/logs/access/ | 安全分析 |
| 錯誤日誌 | 90天 | ~/longhun-system/logs/error/ | Bug修復 |
第十五章:測試與驗收標準(新增章節)
DNA: #龍芯⚡️2026-07-02-TEST-ACCEPT-ADDED
15.1 測試策略
| 測試類型 | 覆蓋範圍 | 通過標準 |
|---|
| 單元測試 | 核心函數(分流/狀態機/加密/審計) | 覆蓋率≥80% |
| 集成測試 | 飛書API對接、Bitable同步、數據存取 | 全部測試用例通過 |
| 端到端測試 | 完整反饋流程(提交→分流→審核→解決) | 5條典型場景全部通過 |
| 安全測試 | 注入攻擊、越權訪問、數據洩露 | 無高危漏洞 |
| 性能測試 | 並發提交、大數據量查詢 | 滿足第五章性能指標 |
| 用戶測試 | 3名社區居民實際使用 | 首次使用成功率≥80% |
15.2 驗收測試用例
| 編號 | 用例名稱 | 操作步驟 | 預期結果 | 優先級 |
|---|
| TC-001 | 正常提交反饋 | @機器人+反饋內容 | 收到確認卡片,含反饋ID | P0 |
| TC-002 | 帶標籤提交 | @機器人+內容+#公開 | 正確分類為公開 | P0 |
| TC-003 | 匿名提交 | 選擇匿名後提交 | 公開時隱藏身份,管理員可見 | P0 |
| TC-004 | 查詢本人反饋 | @機器人 查詢 | 顯示本人反饋列表 | P0 |
| TC-005 | 管理員狀態變更 | 管理員設置狀態 | 用戶收到狀態更新通知 | P0 |
| TC-006 | 舉報反饋 | @機器人 舉報 ID 原因 | 反饋標記🟡,進入複審 | P1 |
| TC-007 | 頻率限制 | 連續提交11條 | 第11條被拒絕並提示 | P1 |
| TC-008 | 注入攻擊 | 提交含SQL注入文本 | 被🔴阻斷,記錄審計 | P0 |
| TC-009 | 查看統計看板 | @機器人 看板 | 顯示統計卡片 | P1 |
| TC-010 | 數據導出 | 管理員執行導出 | 收到導出文件 | P1 |
| TC-011 | 超時預警 | 反饋超時未處理 | 管理員收到預警通知 | P1 |
| TC-012 | 容災恢復 | 模擬服務器重啟 | 數據完整,未處理反饋恢復 | P1 |
15.3 上線檢查清單
第十六章:培訓與運營(新增章節)
DNA: #龍芯⚡️2026-07-02-TRAINING-OPS-ADDED
16.1 管理員培訓
| 內容 | 時長 | 方式 |
|---|
| 系統理念與道德框架 | 30分鐘 | 視頻/文檔自學 |
| 操作培訓(審核/狀態變更/舉報處理) | 1小時 | 實操演練 |
| 三層監督與三色審計實踐 | 30分鐘 | 案例分析 |
| 應急處理(攻擊/誤操作/爭議) | 30分鐘 | 模擬演練 |
16.2 用戶引導計劃
| 階段 | 動作 | 時間 |
|---|
| 機器人入群 | 自動發送歡迎+功能介紹 | 入群即發 |
| 首次使用 | 用戶首次@機器人時發送引導卡片 | 首次觸發 |
| 每週提醒 | 每週發送一次使用提示(簡短) | 每週一 |
| 新功能上線 | 推送功能介紹卡片 | 上線即發 |
16.3 運營指標
| 指標 | 目標值 | 測量方式 |
|---|
| 週活躍用戶數(WAU) | ≥ 社區總人數30% | 統計反饋/查詢的獨立用戶 |
| 反饋處理及時率 | ≥ 90%(48小時內) | 待處理→核實中耗時統計 |
| 用戶滿意度 | ≥ 4.0/5.0 | 已解決反饋的評價統計 |
| 誠信積分異常用戶比例 | < 5% | 積分<60分用戶占比 |
| 系統可用性 | ≥ 99.5% | 月度統計 |
第十七章:版本與歸屬
17.1 版本信息
| 屬性 | 值 |
|---|
| 文檔版本 | v1.1 |
| 審查版本 | 龍魂文檔審查專員·v1.1 |
| 創建日期 | 2026-07-02 |
| 最後更新 | 2026-07-02 |
| 系統版本 | UID9622 · 龍芯北辰·諸葛鑫 |
| 適用範圍 | 龍魂社區·飛書反饋機器人 |
17.2 歸屬與協議
- 系統歸屬:龍魂系統 · UID9622 · 龍芯北辰·諸葛鑫
- 文檔歸屬:龍魂文檔審查專員
- 開源協議:龍魂開源公約 v2.0 — 非商業、非封閉、非篡改
- 底層協議:CC BY-NC-SA 4.0
17.3 DNA追溯總鏈
#龍芯⚡️2026-07-02-LONGHUN-COMMUNITY-FEEDBACK-BOT-REQ-UID9622-v1.1
├── 第一章: #龍芯⚡️2026-07-02-CH01-REVIEW-SUMMARY
├── 第二章: #龍芯⚡️2026-07-02-CH02-POSITIONING
├── 第三章: #龍芯⚡️2026-07-02-CH03-GOVERNANCE-FRAMEWORK
├── 第四章: #龍芯⚡️2026-07-02-CH04-FUNCTIONAL-REQ
├── 第五章: #龍芯⚡️2026-07-02-CH05-NFR-ADDED
├── 第六章: #龍芯⚡️2026-07-02-CH06-ROLE-PERMISSION
├── 第七章: #龍芯⚡️2026-07-02-CH07-DATA-SOVEREIGNTY
├── 第八章: #龍芯⚡️2026-07-02-CH08-FEISHU-CONFIG
├── 第九章: #龍芯⚡️2026-07-02-CH09-CARD-UI-ADDED
├── 第十章: #龍芯⚡️2026-07-02-CH10-3LAYER-IMPLEMENTATION
├── 第十一章: #龍芯⚡️2026-07-02-CH11-AITRUTH-IMPLEMENTATION
├── 第十二章: #龍芯⚡️2026-07-02-CH12-MORAL-FRAMEWORK
├── 第十三章: #龍芯⚡️2026-07-02-CH13-EXTENSION
├── 第十四章: #龍芯⚡️2026-07-02-CH14-DEPLOY-OPS-ADDED
├── 第十五章: #龍芯⚡️2026-07-02-CH15-TEST-ACCEPT-ADDED
├── 第十六章: #龍芯⚡️2026-07-02-CH16-TRAINING-OPS-ADDED
└── 第十七章: #龍芯⚡️2026-07-02-CH17-VERSION
17.4 審查簽字
| 角色 | 簽字 | 日期 | 審計標記 |
|---|
| 原始文檔編寫 | UID9622 · 龍芯北辰·諸葛鑫 | 2026-07-02 | 🟢 |
| 文檔審查 | 龍魂文檔審查專員 | 2026-07-02 | 🟢 |
| 治理框架合規 | 三層監督機制已落地 | 2026-07-02 | 🟢 |
| 飛書能力覆蓋 | 核心能力已全部覆蓋 | 2026-07-02 | 🟢 |
| 最終狀態 | 🟢 審查通過,可進入開發 | 2026-07-02 | 🟢 |
附錄
附錄A:術語表
| 術語 | 英文 | 解釋 |
|---|
| 龍魂 | Longhun / Dragon Soul | 社區自治治理體系名稱 |
| DNA追溯 | DNA Traceability | 龍魂獨有的標識追溯機制 |
| 三層監督 | Three-Layer Supervision | 感知層→認知層→決策層的監督機制 |
| 三色審計 | Three-Color Audit | 🟢🟡🔴三色標記的審計體系 |
| AI Truth Protocol | AI真相協議 | 基於AI的反饋可信度評估 |
| 通心譯 | Tongxin Translation | 中英雙語標註規範 |
| UID9622 | User ID 9622 | 系統創建者唯一標識 |
| SM4 | SM4 Algorithm | 國產商用密碼算法 |
| SHA256 | Secure Hash Algorithm 256 | 安全哈希算法 |
| JSONL | JSON Lines | 每行一條JSON的數據格式 |
| Bitable | 飛書多維表格 | 飛書原生數據管理工具 |
附錄B:飛書API能力對照表
| 本系統功能 | 飛書API/能力 | 必要性 |
|---|
| 接收用戶消息 | 消息事件訂閱(event:message) | 必須 |
| 發送文本回覆 | 發送消息API | 必須 |
| 發送卡片消息 | 發送消息API(msg_type: interactive) | 必須 |
| 接收附件 | 消息事件(message.content.image/file) | 必須 |
| 獲取群成員 | 獲取群成員列表API | 推薦 |
| 群事件訂閱 | 群成員變更事件 | 推薦 |
| 多維表格同步 | Bitable API | 推薦 |
| 審批流對接 | Approval API | 可選 |
| 智能夥伴 | AI能力 | 可選 |
附錄C:數據結構示例
反饋記錄結構(JSON)
{
"feedback_id": "FB00001",
"dna": "#龍魂⚡️2026-07-02-14-30-00-FB00001-A3F9",
"submitter": {
"user_id": "ou_xxx",
"name_hash": "A3F9B2E1",
"is_anonymous": false
},
"content": {
"text": "小區東門路燈壞了三天,晚上出行不安全",
"attachments": [
{
"file_name": "lamp.jpg",
"file_hash": "sha256:abc123...",
"local_path": "~/longhun-system/data/feedback/raw/FB00001/lamp.jpg"
}
]
},
"tag": "#公開",
"truth_score": {
"confidence": "🔵高置信",
"score": 85,
"verified_by": null
},
"status": {
"current": "✅已核實",
"history": [
{"status": "📥待處理", "time": "2026-07-02T14:30:00+08:00", "by": "SYSTEM"},
{"status": "🔍核實中", "time": "2026-07-02T16:00:00+08:00", "by": "UID9622"},
{"status": "✅已核實", "time": "2026-07-03T10:00:00+08:00", "by": "UID9622"}
]
},
"audit_chain": [
{"level": "感知層", "action": "FORMAT_CHECK", "result": "🟢通過", "dna": "..."},
{"level": "認知層", "action": "SEMANTIC_ANALYSIS", "result": "🟢通過", "dna": "..."},
{"level": "決策層", "action": "ADMIN_REVIEW", "result": "🟢通過", "dna": "..."}
],
"timestamps": {
"created": "2026-07-02T14:30:00+08:00",
"modified": "2026-07-03T10:00:00+08:00",
"resolved": null,
"archived": null
},
"integrity": {
"content_hash": "sha256:def456...",
"signature": "sm4_encrypted:ghi789..."
}
}
最後一句話:
🐉 道德盾牌不是法律武器,老百姓的話老百姓自己管。
技術守護誠信,透明換取信任,自治實現自主。
#龍芯⚡️2026-07-02-LONGHUN-COMMUNITY-FEEDBACK-BOT-REQ-UID9622-v1.1