前言¶
在 DeepSeek Harness（DSH）裏做智能體，常見做法是手動複製窗口內容或截圖再貼進會話。上下文切來切去，很難把「當時正在做什麼」和模型回覆留在一條可檢索的時間線上。dsh-companion-journal 把自繪桌寵、原生截圖/讀窗橋和本地陪伴記錄接到同一套插件裏：熱鍵或菜單觸發後，讀前臺窗口（優先文本，必要時截圖），讓當前模型短評或繼續對話，並把結果寫在 ~/.dsh/dsh-companion-journal/。維護者爲 DarkAnJ，倉庫 darkanj/dsh-companion-journal，SkillHub 分類爲客戶端；截至目錄收錄時 GitHub 約 1 star。插件聲明平臺爲 darwin，僅支持 macOS 11+。
這是什麼¶
一句話定位：給 DSH 的自繪桌寵 + 屏幕感知層。桌寵浮窗由插件自帶的 AppKit 程序 buddy/bin/dsh-buddy 負責；窗口、截圖、選中文字由 Swift 橋 bridge/bin/dsh-bridge 提供，不依賴第三方桌寵框架。
數據流可以概括爲：
當前模型 ──工具──> dsh-companion-journal ──原生橋──> macOS（窗口 / 截圖 / 選中文字）
│
└──氣泡──> dsh-buddy（立繪 + 氣泡 + 右鍵菜單）
宿主要求：DeepSeek Harness >= 0.2.1-rc.1 < 0.3.0（README 寫明 0.2.2-rc.1 實測通過）。許可證 MIT，當前包版本 1.0.2。
核心功能¶
README 用入口表歸納能力；各功能均可從桌寵右鍵菜單進入，熱鍵在設置頁自定義（表中不寫死組合鍵）。
| 功能 | 做什麼 |
|---|---|
| 看一眼 | 後臺截剛纔用過的窗口，模型給 ≤40 字評語，桌寵念出；不激活目標應用 |
| 看一眼並提問 | 截窗並彈輸入框，圖文一併發給當前會話 |
| 看幾眼 | 多次「看一眼」收成一組，氣泡上「結束並看 / 提問 / 取消」 |
| 看一陣 | 對某窗口按間隔採樣，可暫停、可調 1/2/5/10/20 秒；段摘要與拼圖，停止後生成帶時間線記錄 |
| 陪伴記錄 | 側邊欄搜索、時間篩選、追問（帶圖）、對記錄開新會話、多選刪除 |
| 桌寵 | 立繪、氣泡、拖動與位置記憶、全局熱鍵 |
讀內容策略：Word、PDF、網頁正文等優先讀文本；視頻、畫布、掃描件等才走截圖。記錄裏同時保留文字與圖片。插件不上傳數據；僅在觸發感知類操作時，把當次內容發給你配置的模型。
安裝與啓用¶
環境
| 項 | 要求 |
|---|---|
| 系統 | macOS 11+（universal 二進制） |
| DSH | >= 0.2.1-rc.1 < 0.3.0 |
| 其他平臺 | Windows / Linux 會被宿主拒絕安裝 |
方式一：Release 預編譯包（推薦）
在 DSH「插件」→「添加插件」→「安裝第三方插件」，填入：
https://github.com/DarkAnJ/dsh-companion-journal/releases/latest/download/dsh-companion-journal.tgz
方式二：從 GitHub 源碼安裝
github:DarkAnJ/dsh-companion-journal
命令行等價寫法：
dsh plugin --profile desktop add \
https://github.com/DarkAnJ/dsh-companion-journal/releases/latest/download/dsh-companion-journal.tgz
裝完後完全退出並重開 DeepSeek Harness（宿主只在啓動時加載插件代碼）。升級重複安裝即可；卸載在插件頁操作，~/.dsh/dsh-companion-journal/ 內記錄與人設立繪默認保留。
權限與首次使用¶
可用程度取決於 macOS 權限，授權對象均爲 DeepSeek Harness.app：
| 權限 | 用途 |
|---|---|
| 屏幕錄製 | 截圖、窗口標題 |
| 輔助功能（可選） | 跨應用讀選中文字 |
| 自動化（按應用，可選） | Word / Preview / Skim 正文 |
| Zotero 本地 API（可選） | 文獻條目 |
路徑：系統設置 → 隱私與安全性。插件內 設置 → 陪伴桌寵 → 權限 可請求授權、打開對應面板、刷新狀態。授權後同樣需完全退出並重開 DSH，TCC 身份纔會重新加載。
典型用法¶
下面按 README 描述的可復現流程說明。
看一眼：右鍵桌寵或熱鍵（默認可在 cordis.patch.yml 裏改，如 buddy.hotkeys.look: F8）。失敗時會說明：無屏幕錄製權限、模型不支持圖片、或沒有其他前臺窗口。
看一陣：右鍵 →「看一陣」→ 氣泡顯示「開始」且應用名隨切換更新 →「開始」後按間隔採樣，可暫停與改採樣率 →「停止」生成帶時間線記錄，「丟棄」不保存。
陪伴記錄：側邊欄入口；可對單條追問、開新會話；多圖記錄宮格與大圖切換。
配置示例（~/.dsh/profiles/desktop/cordis.patch.yml，改完重啓生效）：
- id: dsh-companion-journal
name: 'dsh-companion-journal'
config:
buddy:
hotkeys:
look: 'F8'
ask: 'F7'
collect: 'F9'
hotkey:
enabled: true
spec: 'option+shift+L'
observe:
enabled: false
intervalMs: 5000
minGapSec: 20
quietHours: ['23:00-08:00']
capture:
maxWidth: 1600
read:
maxChars: 12000
privacy:
redact: []
pauseOnSensitiveTitles: true
設置頁還可改人設、提示詞、立繪、浮窗尺寸與字號、全局熱鍵等。
適用場景與注意¶
適合誰：主要在 macOS 上用 DSH 做桌面協作、需要「看一眼當前工作區再讓模型說話」或把多段屏幕活動落成本地時間線的人；想要自帶桌寵 UI、而不是外掛其它桌寵插件的開發者。
運行與信任邊界：插件以當前 DSH 進程權限訪問屏幕與輔助功能 API；安裝前應在 GitHub 查看源碼與 MIT 許可證，並理解只會把觸發操作時的內容發給你配置的模型。SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
已知限制（README）：只讀不代點；瀏覽器側目前主要只能拿到標題（正文需擴展橋，尚未實現）；「看一陣」是按間隔取幀而非連續錄屏；無音頻；僅 macOS。
常見問題例如缺屏幕錄製導致無法截圖、桌寵未出現可查 /companion status 的 buddyRunning、熱鍵衝突需在設置頁檢查，均以 README 表格爲準。
結尾¶
dsh-companion-journal 把桌寵表現層、原生 macOS 感知橋和本地陪伴記錄收進一個 DSH 客戶端插件：熱鍵或菜單觸發，模型短評或深度問答，記錄留在本機。目錄頁：https://www.skillhub.cn/plugins/DarkAnJ/dsh-companion-journal；源碼與文檔：https://github.com/DarkAnJ/dsh-companion-journal（另含 docs/FEATURES.md、docs/PRIVACY.md）。
