規格與上限
數字先講清楚再看功能
需求、上限、保留、節奏和界線都在同一頁，每個數字都標了功能規格章節，要改數字就得先改規格
- Controller DSM 7.2-64570 以上
- 受管 1 到 300 台
- 不需要 root
上限就是合約
超過上限會回工作上限或請你縮小範圍，不會偷偷抽樣，也不會截斷後當成 0
留空就是沒有硬上限
例如每組織的政策數和主資料庫大小，所以我們不寫「無限制」
未知不當正常
讀不到資料時寫出原因（沒權限、這版 DSM 不支援、還沒讀到），不當成通過
真機證據有多少
有真機證據的公開描述目前只有三條：NAS 狀態和盤點讀取、套件動作、DSM 桌面通知，其餘能力有實作、有合約和上限，但缺該流程的真機驗收，所以不當成已驗收
系統需求
兩個版本號和架構是安裝的前提，其他都是執行時的行為
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| Controller NAS | DSM 7.2-64570 以上 | x86_64 或 aarch64 | §1 |
| 受管 NAS | DSM 7.1 以上 | 要能從 Controller 用 HTTPS 連到，預設 5001 | §1 |
| 執行身分 | 套件帳號 | 不需要 root，也不要求全機共用 service | SPEC §1 |
| 入口 | 只有 DSM administrators | 沒有一般使用者或匿名路由 | §1 |
| 前端 | 瀏覽器開啟的 DSM 套件 | 沒有行動 App，也沒有離線模式 | §1 |
| 受管規模 | 1 到 300 台 | 1 台、2–20 台、21 台以上採不同總覽 | SPEC §1 |
規模與上限
每個數字都有合約依據，沒依據的就不寫
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| 操作目錄 | 318 筆 OpSpec、15 個 stream | 產生檔和執行端共用 | §4.1 |
| 方法權限 | 541 個 | 538 個 administrators、3 個 integration | §14 |
| AI 工具 | 231 個 | human-only 不算工具 | §12 |
| CLI 與 MCP 工具 | 223 個 | 扣掉 8 個 ui_only | §4.4 |
| 內建目錄 | 30 個 plugin、265 個定義 | 98 signal、83 action、58 source、17 setting、8 protection-source、1 package-set | §12 |
| 起始政策 | 4 份 | 基本安全、時間一致、更新政策、常見套件 | §7 |
| 批次 Operation | 300 個目標 | 每批 20，預設 5 | §4.3 |
| Operation 預覽 | 5 分鐘 | 可設 1 秒到 15 分，registry 或世代一改就要重新預覽 | §4.3 |
| 儀表板元素 | 200 個 | 整份 256 KiB，16 種元素、9 種量測 | §8 |
| 儀表板查詢 | 150,000 列、1,000 台、4,096 序列 | 結果 8 MiB，超過回工作上限，不抽樣 | §8 |
| 依資料查看 | 每台先顯示 10 個共用資料夾 | 備份任務先顯示 15 台，再顯示 50 | §4 |
| 保護例外 | 365 天 | 預設 90 天，14 天前提醒即將到期 | §4 |
| 目的地同時備份 | 1–8 | 預設 2，空間不足會開告警 | §4 |
| 立即備份 | 1,000 個任務 | 追蹤 1–72 小時，預設 24 | §4 |
| 維護時段 | 每週 7 段、一次性 20 段 | 各 NAS 用自己的 DSM 時區 | §7 |
| 組合步驟 | 64 步 | 只有 Packages 一步的可存成套件組 | §7 |
| 對外暴露的列 | 不可批次操作 | 必須逐台處理 | §5 |
保留與容量
保留天數和單筆大小，容量不足只警告，不提前刪
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| 稽核保留 | 90–1,095 天 | 預設 730 天，每天清理只刪已驗證的前段 | §9 |
| 稽核單筆 | 16 KiB | 超過就拆成 audit_blob，同一筆交易同一條鏈 | §9 |
| 稽核匯出 | 128 MiB、400 天 | 超過 1,000 筆改用背景工作，部分匯出標 partial | §9 |
| 稽核容量 | 4 GiB 或可用空間 10% | 只警告，不縮短保留 | §9 |
| NAS 日誌快取 | 500–20,000 筆 | 預設 5,000，可丟棄，不進主 DB、備份或稽核鏈 | §10 |
| 日誌讀取 | 128 頁或 32 MiB | 單檔 64 MiB，訊息 256 KiB，直接讀取最多 50 台 | §10 |
| 日誌拉取 | 2–30 分鐘 | 沒新日誌就加倍，有錯誤或警告回到 2 分鐘 | §10 |
| 備份 bundle | 256 MiB | 密碼 12–1,024 bytes，AES-256-GCM 配 PBKDF2-SHA256 | §13 |
| 排程備份保留 | 1–30 份 | 預設 7，每天一次 | §13 |
| 冷還原 staging | 256 MiB、15 分鐘 | 只接受空白 Controller | §13 |
| 每日摘要 | 每組織 1 封 | 合併最多 5 項，payload 32 KiB | §11 |
採集節奏
間隔可以調，慢的 NAS 會被調慢，不會被當成故障
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| 連線 | 1 分 | 固定，永不調適 | §3 |
| 狀態 | 2 分 | 固定 | §3 |
| 資源 | 5 分 | 可設 1–15 分 | §3 |
| 保護 | 5 分 | 可設 5 分到 1 小時 | §3 |
| 容量與 App 物件 | 15 分 | 可設 15 分到 1 小時 | §3 |
| 盤點 | 6 小時 | 可設 1–24 小時 | §3 |
| 日誌 | 2 分起 | 自適應 2–30 分 | §3 |
| 全域並行 | 1–16 | 間隔 60–3,600 秒，每台同時讀取固定 1 件 | §3 |
| 單台流程預算 | 60–3,600 秒 | 預設 10 分鐘，逾時算等待中，不是錯誤 | §3 |
| 慢 NAS 調適 | 最多 8 倍、24 小時 | 連續 2 次慢加倍，連續 3 次快減半 | §3 |
| 資料延遲 | 間隔的 3 倍 | 係數可調，範圍 2–48 | §3 |
| 重新檢查 | 一次 300 台 | 同一人對同一台 10 秒最多 1 次 | §3 |
AI 與 MCP 的界線
AI 只看得到 OpSpec，會改到系統的動作一律留給人按
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| AI 上下文 | 8,192–2,000,000 | 預設 128,000，由管理員填模型真的能收的數 | §12 |
| 每次輸入 | 16 KiB、20 個 Ref | 依管理員和組織隔離 | §12 |
| 每回合 | 200 次已收集讀取 | 20 次即時 NAS 讀取、5 個草稿、4 MiB 巢狀輸出，120 秒起 | §12 |
| 排程 AI 任務 | 每組織 10 個 active | 每次 27,000 tokens、每天 648,000，每天 24 次嘗試 | §12 |
| 一次呼叫的組織 | 1 個 | AI 和 MCP 都只能指定剛好一個 Org | §5.1 |
| MCP 工具 | 223 個 | 訊息 1 MiB，同時 4 個，工具清單每頁 50 | §12 |
| MCP 工作階段 | 120 分鐘、7 天、30 天 | access、閒置、最長期限，refresh token 重用就撤銷 | §12 |
| MCP 本地變更 | 4 種 | 接手、延後、復原 Event、缺口例外，其餘是讀或草稿 | §12 |
| 網頁下載 | 每頁 100,000 字元 | 每回合 10 次、每次重新導向 10 次、下載上限 20 MB | §12 |
| 圖片 | 4 張、每張 5 MB | 縮到 1600 px，只收這四種格式 | §12 |
| 資料外送 | 3 類 | conversation、inventory、logs，只記類別和 bytes，不記內容 | §12 |
| 寫入 | 只能起草 | 人按過預覽和確認才執行，草稿 15 分鐘到期 | §12 |
權限與身分
管理員之間只差在稽核記了誰做了什麼
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| Route 權限 | 541 個方法 | 538 個 administrators、3 個 integration | §14 |
| 範圍 | Org 與 Site | 空陣列代表所有已授權的值，還是要通過授權 | SPEC §2 |
| 憑證 | AES-GCM 加密封存 | 金鑰目錄 0700、檔案 0600、32 bytes，回應只回是否已設定 | §5.3 |
| 一次性密碼 | 24 小時 | 只有確認者能讀一次，讀完就刪除並寫稽核 | §5.3 |
| 介面語言 | 7 種 | 缺少的 key 顯示英文 | §14 |
| 時間顯示 | 3 種 | 各 NAS 本地時間、瀏覽器時區、UTC | §14 |
明確不支援
這一節是界線，不是待辦，需要這些能力的客戶請另找方案
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| 一般使用者與匿名入口 | 沒有 | 只有 DSM administrators，沒有 authenticated 或 app-privilege 路由 | §14 |
| 任意 DSM API 主控台、shell、root | 拒絕 | 自訂能力必須是目錄定義，root 身分和自由字串一律拒絕 | SPEC §5.2 |
| 自動修正偏離 | 不提供 | 政策只判斷，Fix 永遠是人按 | SPEC §1.2 |
| 真機套件安裝 | 不執行 | 更新、啟動、停止、重啟、解除安裝有真機證據，安裝沒有 | §12 |
| 反向連線的管理介面 | 未提供 | 後端配對方法和 Agent 套件已經有，入口整合和管理畫面還沒出貨 | §12 |
| Controller 交接 | 未出貨 | prepare 和 accept 還是 stub | §13 |
| 物件選擇器的即時比對數 | 未提供 | per-object 設定可以存，但即時筆數不保證 | §12 |
| 跨 Controller 的 HA 與 fencing | 沒有硬 fencing | 舊機失聯時新機停在 recovery-only | SPEC §1.2 |
| 強租戶隔離 | 不提供 | Org 是範圍和金鑰邊界，不是對 Controller 管理員的隔離 | SPEC §1.2 |
| 行動 App、離線模式 | 不提供 | 瀏覽器介面，登入一律走 DSM | SPEC §1.2 |
| 日誌全文索引、SIEM、自架 syslog | 不提供 | 只留每台最近幾筆快取，長期保存交給 DSM Log Center | SPEC §1.2 |
| 備份的還原引擎 | 不提供 | Syngle 只備份自己的狀態，NAS 資料由 DSM 原生套件負責 | §12 |
| 伺服器端 NAS 日誌匯出 | 不提供 | CSV 由瀏覽器把已載入的列存成檔案 | §10 |
還沒定案
這些路徑有程式或畫面，但缺真機證據，所以不列成功能
| 項目 | 內容 | 說明 | 依據 |
|---|---|---|---|
| Preset 建立 | 未列入 | HB 和 SR 的建立流程有程式和畫面，還沒有真機完成的證據 | §還沒定案 |
| package.install | 未列入 | 只有模擬器證據 | §還沒定案 |
| live_verified 為 false 的定義寫入 | 未列入 | 目錄可以載入和預覽，不代表真機寫入完成 | §還沒定案 |
| 反向連線是否對客戶開放 | 待決 | 後端和 Agent 已經有，UI 還沒出貨，等入口整合和實機驗證 | §還沒定案 |
| Controller 交接何時完成 | 待決 | 兩條核心 route 還是 stub | §還沒定案 |
| 每組織政策數上限 | 留空 | 程式沒有上限，所以我們不寫「無限制」 | §還沒定案 |
| 主資料庫大小上限 | 留空 | 只寫保留天數和備份 256 MiB | §還沒定案 |
| NAS 日誌是否含檔案傳輸 | 不含 | 只寫系統、連線和備份，不寫全部日誌 | §還沒定案 |