星願 (XingYuan) for DeepSeek Harness

DeepSeek Harness (DSH) follows a plugin-centric architecture. starwish-ai/xingyuan-dsh is a plugin bundle that includes an Agent Preset for managing wishes and habits. It integrates into the DSH session view, providing a unified interface for task management, progress tracking, and memory management.

核心功能¶

• 對話驅動創建：通過自然語言創建願望或任務，系統會自動進行查重，避免重複創建。
• 機會日打卡：支持週期任務打卡、補卡、取消打卡以及未來預勾選，進度會自動更新。
• 承諾口徑進度：只有“領取”的任務纔算進度。達成條件爲“承諾全部完成且沒有待領取的任務”。如果已完成但有未領取的任務，狀態會停留在“待收尾”，等待用戶決定是領取繼續還是刪除。
• 微行動拆解：將無從下手的目標拆解爲 3 到 7 個小步驟，引導用戶逐個完成或跳過。
• 成長體系：包含等級系統（Lv.1-Lv.10）、連續打卡加成以及統計卡片，並自動生成近 30 天的柱狀圖。
• 會話視圖頁：提供今日、願望、任務、日曆、成長、記憶六個標籤頁。頁面上的按鈕可以直接觸發操作接口。
• 記憶管理：支持重要記憶的自動注入上下文（上限可配），並支持記憶的增刪改查與一鍵清空。
• 統計圖表：內置 15 種統計圖表，自動渲染爲卡片展示。
• 同權操作：頁面與對話享有相同的操作權限。在對話中可以執行打卡、領取、刪除、分類改名等操作，結果與頁面回顯一致。安全策略中的“寫操作二次確認”例外，只能通過設置頁面調整。
• 安全確認：寫操作二次確認按類目細化（創建、打卡、取消打卡、領取、修改、保存記憶），刪除操作始終確認且不可關閉。
• 主題適配：支持深淺色主題，跟隨應用設置。

安裝與啓用¶

1. 安裝插件：
   在終端執行以下命令安裝插件：

    dsh plugin --profile web add @starwish-ai/xingyuan-dsh

2. 環境要求：
   • 宿主 DeepSeek Harness 版本需爲 0.1.7-rc.1 或 0.2.0-rc.1。
   • 插件版本需在 0.6.5-alpha.2 以上，以修復 DSH 0.1.7 起引入的預設註冊機制變更導致的顯示問題。
3. 啓用預設：
   啓動 Web GUI 後，在 Agent 選擇器中選擇「星願」預設會話，插件將在此會話中掛載並生效。

數據與配置¶

• 業務數據：存儲於本地 SQLite 文件 ~/.dsh/xingyuan/xingyuan.sqlite。卸載或升級插件不會丟失數據，備份時只需拷貝該目錄。
• 設置偏好：設置存儲於宿主的 Profile 配置文件 ~/.dsh/profiles/<profile>/cordis.patch.yml 中，而非插件目錄下。換機恢復時需額外拷貝該配置文件。
• 作用範圍：插件僅掛載在選擇「星願」預設的會話上，不會影響其他會話。

限制與說明¶

插件提供深淺色主題適配。所有業務邏輯與界面交互均在 DSH 進程權限範圍內運行。