前言¶
給智能體開發者寫工具時，一個常見情形是：希望助手能自己按人格和興趣去刷內容，而不是每次臨時擬一份行爲腳本。社區目錄裏的 dsh-douyin-mac 就是這類嘗試，它把上游 dsh-douyin-agent 1.4.6 的實現移植成 DSH 插件，限定在 macOS + Google Chrome 的形態上，只認專用 Chrome 窗口，不再附帶 Windows 獨立軟件或 Electron 打包。
下面介紹它的來源歸屬、可用能力、安裝方式和已知邊界。它由 asd45183 發佈維護，項目 package.json 的 author 字段是 LockyBee（上游作者），README 也聲明這是第三方適配，不是 DeepSeek 官方發行版。
基本定位¶
插件形態只有一個：設置入口在 DSH 的「設置 → 刷抖音」。主模型直接使用 DSH 已配置的提供商和模型（需支持圖片）。狀態、人格、興趣與記憶保存在 ~/.dsh/douyin-browser/，專用 Chrome 資料目錄是 ~/.dsh/douyin-browser/cli-profile，和日常瀏覽器互相隔離。
瀏覽器控制通過 Playwright 啓動這個獨立資料目錄的 Chrome，再連接本機 CDP。Chrome 136 起默認資料目錄不允許開遠程調試，README 說明專用目錄就是爲了規避這一限制。
已覈實的核心功能¶
自主觀看：在「視頻觀看」裏選時段，按需展開「高級選項」設置每日觀看分鐘數和每日模型請求數（均可選不限），打開「允許自動觀看」後，插件在額度內挑片、停留、換片或停止，保留手動啓動／暫停按鈕。人格與興趣共用一張人格卡，興趣依據實際播放進度、觀看比例和已確認互動更新，看到主題不等於喜歡。
好友互動：一個總開關管理許可會話的新消息回覆，以及觀看過程中的自主分享，默認開啓。本人需要手動勾選許可好友或羣聊，插件不會自行添加許可會話，也不設人數、回覆請求數或分享次數的業務上限（模型調用仍消耗額度）。被撤回的記錄和系統通知不自動回覆。
羣聊回覆：只回復已許可羣聊中 @ 了機器人、或叫到設定暱稱的消息。引用預覽裏的舊 @ 不觸發羣回覆。
自主分享：通過官方面板發送當前實際觀察的作品卡片，按平臺穩定身份綁定收件人，同作品同會話去重。多對象分享按順序逐個發送，頁面頂部顯示當前分享進度；點擊結果不明時暫停後續分享並保留收據，不自動重發。
公開評論：獨立開關，默認關閉；保留每日和每次觀看的嘗試上限，同一作品不重複評論。
靜默觀看：持續靜音，覈實窗口歸屬後嘗試最小化，仍然使用有窗口的 Chrome。
可選音頻：本地 Whisper 轉寫對白，視頻音頻還可選擇 MiMo 或 MiniMax 雲端後端。README 標註本機未安裝 ffmpeg 和本地 Whisper 時該用例未通過，音頻功能保持默認關閉。
觀看日報：從本機觀看記錄生成 Markdown，不額外調用模型。
分鏡採樣：觀看決策、視頻回覆和視頻觀察會把同一作品的多張 JPEG 採樣拼成一張帶格編號的圖片，默認總像素預算 480000，每格時間寫在模型可讀清單裏。另有 douyin_video_zoom 工具按 storyboardSampleId、cell、videoId 讀取指定格原圖，僅限最近一分鐘採樣。
自檢與用量：一鍵診斷、限定修復建議、實際請求與已報告 token 用量、進行中狀態。
上面每項都來自 README 的功能表和正文。分工爲自己整理的總結性描述，字段名和數值以 README 爲準。
安裝與啓用¶
環境要求：macOS、Google Chrome、Node.js 22.13+、兼容的 DSH（engines.dsh 爲 >=0.2.1-rc.2 <0.3.0-0）。從 npm 安裝到 web profile：
dsh plugin --profile web add dsh-douyin-mac@0.1.15
本地開發也可以從源碼目錄安裝：npm install 後執行 dsh plugin --profile web add .。兩種方式不要同時用。
DSH 配置變化後，重啓同一份 DSH 即生效。
第一次使用¶
按 README 的四條執行：
- 在「刷抖音 → 基礎設置 → DSH 模型」選擇支持圖片的提供商與模型。
- 點擊「打開抖音」，在專用 Chrome 中手動登錄或完成驗證碼；登錄態保存在專用資料目錄。
- 在「視頻觀看」選擇時段，按需展開「高級選項」設置每日分鐘數和每日請求數，再開啓「允許自動觀看」。
- 在「好友互動」讀取當前會話，覈對穩定身份並勾選許可好友或羣聊，按需填寫羣聊響應暱稱。
普通設置自動保存，文本輸入離開輸入框後提交，失敗保留草稿。音頻 Key 在「音頻與密鑰」密碼框填寫，保存後不回顯。
修改暱稱、簡介和頭像¶
插件自帶一個編輯腳本，默認預演，只有顯式 --apply 纔會保存：
cd dsh-douyin-mac
# 預演：只填入/預覽，不保存
node scripts/profile-edit.mjs --nickname "新暱稱" --bio "新簡介"
# 保存（暱稱 ≤20 字，簡介 ≤200 字）
node scripts/profile-edit.mjs --nickname "新暱稱" --bio "新簡介" --apply
# 換頭像（png/jpg/webp/bmp），保存後進入平臺審覈
node scripts/profile-edit.mjs --avatar /絕對路徑/avatar.png --apply
腳本通過本機 9227 端口操作專用 Chrome，需要先在插件裏「打開抖音」。三點要留意：修改資料可能觸發抖音短信身份驗證，腳本會提示需要驗證碼，不會誤報成功；頭像保存後顯示「審覈通過後展示」，審覈期間資料頁可能仍是舊圖；設置頁「抖音賬號 → 編輯個人資料」也提供暱稱／簡介／頭像入口，同樣是預演加二次確認保存。
適用場景與注意¶
適合已經在用 DSH、希望助手按固定人格長期維護興趣畫像、並且願意接受「有窗口的專用 Chrome」這一運行形態的開發者。所有行爲都跑在當前 dsh 進程權限下，插件能做的事受該進程能訪問的目錄和網絡範圍約束。安裝前建議先打開倉庫根目錄覈對源碼與許可證：原創代碼採用 MIT，第三方通知見 THIRD_PARTY_NOTICES.md，來源說明見 docs/reuse.md 和 desktop/UPSTREAM.md，模型使用說明見 skill/SKILL.md。
關於驗證邊界，README 說得比較直接：macOS 移植的實機結果和已知失敗分類見 docs/verification/mac-0.1.0-20261104.md。推薦流仍可能換片失敗；真實公開評論發佈確認、連續兩小時播放、真實羣聊與多收件人分享仍待驗。歷史 Windows 的結果保留在原版本記錄中，不自動適用於本移植。
操作上的幾條邊界也寫在這裏，避免誤讀：同一時刻只運行一條自主觀看，暫停、重啓或改設置不清空當天用量；無效或截斷的觀看決策不執行動作，重新觀察後再判斷，連續三次無效會停止本次觀看，每次模型調用都計入每日預算；升級、配置、隱私和許可風險請自行判斷。
測試命令：
npm test
npm run test:native
README 提醒，測試使用臨時目錄、合成模型或臨時瀏覽器，不應把測試通過寫成真實平臺聯調通過。運行狀態、Key、登錄資料、私信及聯繫人記錄不進入倉庫。
結尾¶
dsh-douyin-mac 的價值在於把「自主觀看 + 人格記憶 + 許可式好友互動」收進一個邊界清晰的插件裏，並把形態明確收斂到 macOS 的 Google Chrome。它的能力上限取決於上游實現和本機環境，驗證到什麼程度、還有哪些待驗項，README 裏都有對應說明。
目錄頁：https://www.skillhub.cn/plugins/asd45183/dsh-douyin-mac
GitHub：https://github.com/asd45183/dsh-douyin-mac
