name: xinqing-journal version: 1.0.0 description: > 心情日記 — 智慧情緒追蹤器，通過自然語言記錄中文日記、自動識別7種情緒、 1-10分評分、智慧標籤提取，生成日/周/月報告和趨勢分析。 資料純本地JSON儲存，零網路請求，保護隱私。 emoji: "\U0001F308" category: health tags: - health - journal - mood-tracker - chinese - mental-health - privacy requires: python: ">=3.9" os: - macos - linux - windows author: dyby99 license: MIT

Xinqing Journal - 心情日記

用自然語言記錄每天的心情，自動分析情緒變化趨勢。

功能特性

• 📝 自然語言日記: "今天工作很順利，心情不錯"
• 🎭 情緒自動識別: 開心、平靜、興奮、焦慮、難過、憤怒、疲憊
• ⭐ 情緒評分: 1-10分自動或手動評分
• 🏷️ 智慧標籤提取: 自動提取人、事、物、地點、天氣標籤
• 📊 多維度報告: 日報、週報、月報、趨勢分析
• 🔒 本地資料儲存: JSON檔案儲存，保護隱私
• 📅 心情日曆: 視覺化月曆檢視情緒分佈
• 💡 智慧建議: 根據情緒資料給出健康建議

快速開始

新增日記

# 簡單日記
python scripts/journal.py add "今天工作很順利，心情不錯"

# 指定情緒評分
python scripts/journal.py add "今天下雨了有點鬱悶，心情4分"

# 詳細日記
python scripts/journal.py add "今天和朋友去了咖啡店，聊得很開心，心情9分"

# 昨天日記
python scripts/journal.py add "昨天加班到很晚很累"

檢視日記

# 列出最近7天
python scripts/journal.py list

# 列出最近30天
python scripts/journal.py list 30

# 按情緒篩選
python scripts/journal.py list 30 開心

心情日曆

# 本月日曆
python scripts/journal.py calendar

# 指定年月
python scripts/journal.py calendar 2024 1

生成情緒報告

# 日報
python scripts/mood-report.py daily
python scripts/mood-report.py daily 2024-01-15

# 週報
python scripts/mood-report.py weekly
python scripts/mood-report.py weekly 1  # 上週

# 月報
python scripts/mood-report.py monthly
python scripts/mood-report.py monthly 1  # 上月

# 趨勢分析
python scripts/mood-report.py trend 30

檢視統計

# 情緒摘要
python scripts/journal.py summary
python scripts/journal.py summary 90

# 情緒型別列表
python scripts/journal.py moods

編輯和刪除

# 更新日記
python scripts/journal.py update abc123 "修改後的內容"

# 刪除日記
python scripts/journal.py delete abc123

專案結構

xinqing-journal/
├── SKILL.md                      # 本檔案
├── .clawhubignore               # 釋出忽略配置
├── scripts/
│   ├── journal.py               # 核心日記模組
│   └── mood-report.py           # 情緒報告生成器
└── assets/
    └── moods.json               # 情緒配置

資料儲存

• 路徑: ~/.openclaw/workspace/data/journal/entries.json
• 格式: JSON
• 隱私: 純本地儲存，不上傳雲端
• 原子寫入: 使用臨時檔案+原子替換，防止資料損壞

資料結構:

{
  "entries": [
    {
      "id": "a1b2c3d4",
      "date": "2024-01-15",
      "content": "今天工作很順利",
      "mood": "開心",
      "score": 8,
      "tags": ["工作"],
      "raw_text": "今天工作很順利，心情不錯",
      "created_at": "2024-01-15T12:30:00",
      "updated_at": "2024-01-15T12:30:00"
    }
  ],
  "version": "1.0"
}

自然語言支援

時間表達

• "今天..." - 今天
• "昨天..." - 昨天
• "前天..." - 前天
• "2024-01-15..." - 指定日期

情緒評分

• "心情8分"
• "評分9"
• "mood 7"
• "8/10"

情緒識別關鍵詞

標籤自動提取

自動識別以下類別標籤:

• 人: 朋友、家人、同事、老闆、同學、物件
• 事: 工作、學習、考試、專案、會議、面試
• 物: 咖啡、茶、書、電影、音樂、遊戲
• 地點: 公司、家、學校、咖啡店、公園
• 天氣: 晴天、陰天、下雨、下雪、熱、冷

報告型別

日報

• 當日情緒評分
• 情緒型別分佈
• 日記內容列表

週報

• 本週情緒總覽
• 日均情緒評分
• 每日情緒變化
• 主導情緒分析
• 健康建議

月報

• 月度情緒總覽
• 每週情緒概況
• 情緒分佈統計
• 主導情緒變化
• 月度建議

趨勢分析

• 情緒趨勢（上升/下降/穩定）
• 每週情緒評分變化
• 情緒波動異常檢測
• 長期健康建議

命令列參考

journal.py 命令

mood-report.py 命令

配置檔案

情緒配置儲存在 assets/moods.json:

{
  "moods": {
    "開心": {
      "score_range": [7, 9],
      "keywords": ["開心", "高興", "快樂"],
      "emoji": "😊",
      "color": "#FFD93D"
    }
  },
  "tag_patterns": {
    "人": ["朋友", "家人", "同事"],
    "事": ["工作", "學習", "考試"]
  }
}

可自定義: - 情緒型別和關鍵詞 - 評分範圍 - Emoji和顏色 - 標籤提取規則

使用建議

1. 每日記錄: 養成每天寫日記的習慣，可以在睡前花3-5分鐘回顧一天
2. 誠實表達: 記錄真實的情緒，不必掩飾負面情緒
3. 具體描述: 嘗試描述產生情緒的具體原因，而不僅是情緒本身
4. 定期復盤: 每週檢視週報，瞭解自己的情緒週期
5. 關注趨勢: 注意長期趨勢，而非單一天的評分

情緒健康提示

• 評分持續低於3分超過一週，建議尋求專業幫助
• 情緒波動過大（忽高忽低）可能提示壓力過大
• 長期焦慮或難過情緒需要關注心理健康
• 保持記錄本身就是情緒調節的好方法

故障排除

無法識別情緒

• 在日記中使用更明確的情緒詞彙
• 直接指定評分："心情5分"

資料檔案損壞

• 使用原子寫入機制，極少出現損壞
• 如有問題可手動編輯 JSON 檔案修復
• 建議定期備份 entries.json

標籤提取不準確

• 在 moods.json 中新增自定義標籤關鍵詞
• 在日記中使用更具體的詞彙

擴充套件開發

新增新情緒型別

編輯 assets/moods.json:

{
  "moods": {
    "新情緒": {
      "score_range": [4, 6],
      "keywords": ["關鍵詞1", "關鍵詞2"],
      "emoji": "🆕",
      "color": "#FFFFFF"
    }
  }
}

作為模組使用

from scripts.journal import JournalTracker

tracker = JournalTracker()
entry = tracker.add("今天心情不錯")
print(entry)

# 獲取統計
summary = tracker.get_summary(days=30)
print(summary)

技術規格

• Python版本: 3.9+
• 依賴: 無外部依賴，僅使用標準庫
• 編碼: UTF-8
• 資料格式: JSON
• ID生成: UUID短ID（8位）
• 檔案操作: 原子寫入

隱私說明

• 所有資料僅儲存在本地
• 無網路傳輸

  發現更多技能外掛，請訪問7w4.net。

• 無雲端同步
• 使用者完全擁有資料

許可證

MIT License

這是一款實用的中文情緒日記工具，功能豐富，支援智慧情緒識別和多維度報告生成，資料本地儲存隱私性好。中文處理自然，介面友好易上手。扣分項是缺少自動安裝指令碼，安裝配置稍顯繁瑣，且沒有經過測試驗證穩定性。總體來說質量良好，值得使用。