article-tagger 0.4.0__tar.gz

article_tagger-0.4.0/.claude/settings.local.json

@@ -0,0 +1,35 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pip install:*)",
+      "Bash(pip3 install:*)",
+      "Bash(uv venv:*)",
+      "Bash(source .venv/bin/activate)",
+      "Bash(uv pip:*)",
+      "Bash(\"/Users/dex/YD 2026/0323/Article Tagger/.venv/bin/python\" --version)",
+      "Bash(export KMP_DUPLICATE_LIB_OK=TRUE)",
+      "Bash(.venv/bin/pip install:*)",
+      "Bash(.venv/bin/python -m pytest tests/ -v)",
+      "Bash(.venv/bin/article-tagger --help)",
+      "Bash(.venv/bin/article-tagger state:*)",
+      "Bash(.venv/bin/article-tagger build-index:*)",
+      "Bash(.venv/bin/article-tagger tag:*)",
+      "Bash(ls:*)",
+      "Bash(.venv/bin/article-tagger model:*)",
+      "Bash(.venv/bin/article-tagger analytics:*)",
+      "Bash(.venv/bin/article-tagger quality:*)",
+      "Bash(.venv/bin/article-tagger profile:*)",
+      "Bash(.venv/bin/article-tagger weights:*)",
+      "Bash(.venv/bin/article-tagger visualize:*)",
+      "Bash(.venv/bin/python -m pytest tests/ -q)",
+      "Bash(xargs -I{} basename {})",
+      "Bash(gh auth:*)",
+      "Bash(gh repo:*)",
+      "Bash(python3 -c \":*)",
+      "Bash(.venv/bin/python -c \"import mcp; print\\(mcp.__version__\\)\")",
+      "Bash(.venv/bin/python -c \"from mcp.server.fastmcp import FastMCP; print\\(''OK''\\)\")",
+      "Bash(.venv/bin/python -m pytest tests/ -v --tb=short)",
+      "Bash(.venv/bin/article-tagger eval:*)"
+    ]
+  }
+}

article_tagger-0.4.0/.claude/skills/article-tagger/skill.md

@@ -0,0 +1,75 @@
+---
+name: article-tagger
+description: Article Tagger v0.4 — 文章標籤標註、標籤庫管理、評估、狀態遷移、標籤發現、daemon 模式。
+user_invocable: true
+---
+
+# Article Tagger Skill
+
+你現在是 Article Tagger 操作員。根據需求使用 CLI 或 MCP 工具完成任務。
+
+## 快速指令
+
+```bash
+article-tagger build-index --tags <file>       # 建索引
+article-tagger tag --text "..." --top-k 5      # 標註
+article-tagger tag --text "..." --rerank       # LLM 精排
+article-tagger interactive                     # 互動 REPL
+article-tagger watch --dir ./articles/         # 監控目錄
+article-tagger analytics                       # 分析儀表板
+article-tagger quality                         # 標籤品質
+article-tagger visualize -o tags.html          # 視覺化
+article-tagger cooccur --rebuild               # 共現圖
+article-tagger weights                         # AL 權重
+article-tagger enrich -i tags.json             # LLM 增強標籤庫
+article-tagger eval -b benchmark.json          # 評估
+article-tagger export --dir ./articles/ --fmt markdown  # 匯出
+article-tagger discover ./articles/            # 發現新標籤候選
+article-tagger warmup                          # 預載模型+索引
+```
+
+## Daemon（免重載模型）
+```bash
+article-tagger daemon start
+article-tagger daemon tag --text "..."
+article-tagger daemon stop
+```
+
+## 狀態遷移
+```bash
+article-tagger state export -o bundle.tar.gz
+article-tagger state import -f bundle.tar.gz
+article-tagger state export-incr -o incr.tar.gz --since <ISO>
+article-tagger state merge -f incr.tar.gz
+```
+
+## 模型 / Profile
+```bash
+article-tagger model list | switch | compare
+article-tagger profile list | save | load | delete
+```
+
+## 標籤發現
+```bash
+# 掃描目錄，發現未在標籤庫中的高頻詞彙
+article-tagger discover ./articles/ --min-freq 3 --top 10
+article-tagger discover ./articles/ --json   # JSON 格式輸出
+```
+
+## MCP 工具（24 個）
+**標註**: tag_article, build_index, search_tags
+**標籤 CRUD**: list_tags, create_tag, update_tag, delete_tag
+**回饋**: add_feedback, undo_feedback, delete_feedback, get_weights
+**歷史**: search_history, delete_history, export_history
+**分析**: get_stats, get_analytics, get_quality_report
+**狀態**: export_state, import_state
+**模型**: switch_model, list_models
+**其他**: list_profiles, get_pipeline_info, suggest_related_tags, discover_tags
+
+## 使用原則
+1. MCP 可用 → 用 MCP tools；不可用 → 降級 CLI
+2. Daemon 啟動時 → `daemon tag` 比直接 `tag` 快 100 倍
+3. 首次使用先建索引: `build-index --tags 51標籤庫.json`
+4. LLM 功能需要 `TAGGER_ANTHROPIC_API_KEY`
+5. `warmup` 預載模型到記憶體，加速首次查詢
+6. `discover` 發現新標籤候選，半自動擴展標籤庫

article_tagger-0.4.0/.claude/skills/atag/skill.md

@@ -0,0 +1,98 @@
+---
+name: atag
+description: Agent-native article tagging — JSON-only CLI for automated tagging workflows, feedback loops, and tag management.
+user_invocable: true
+---
+
+# atag — Agent Article Tagger
+
+你現在是一個自動標籤 agent。使用 `atag` CLI 完成標籤相關任務。所有輸出都是 JSON。
+
+## 核心工作流程
+
+### 1. 標註文章
+```bash
+# 直接傳文字
+atag tag "文章內容..."
+
+# 從檔案
+atag tag -f article.txt
+
+# Pipe（適合批次腳本）
+echo "文章內容" | atag tag
+
+# 帶上下文 ID（會原樣回傳）
+atag tag "文章" -c "request-123"
+
+# 自訂 top_k + 門檻
+atag tag "文章" -k 10 -t 0.3
+```
+
+### 2. 批次標註
+```bash
+# 目錄
+atag batch -d ./articles/
+
+# 指定檔案
+atag batch file1.txt file2.txt
+
+# JSONL stdin（每行一個 {"text": "...", "id": "..."}）
+cat articles.jsonl | atag batch
+```
+
+### 3. 回饋 → Active Learning
+```bash
+atag feedback "兔女郎" true     # 正確
+atag feedback "高叉裝" false    # 錯誤
+```
+
+### 4. 推薦相關標籤
+```bash
+atag suggest "貓娘,女僕"
+```
+
+### 5. 搜尋標籤庫
+```bash
+atag search "狐狸"
+```
+
+### 6. 系統狀態
+```bash
+atag stats
+atag quality
+```
+
+### 7. Tool Schema 匯出
+```bash
+atag schema openai     # OpenAI function calling
+atag schema anthropic  # Anthropic tool use
+```
+
+## Agent Chaining 範例
+
+```bash
+# 標註 → 提取 top tag → 搜尋相關標籤 → 推薦
+TAG=$(atag tag "文章" | jq -r '.tags[0].tag_name')
+atag suggest "$TAG"
+
+# 批次標註 → 過濾低信心 → 匯出
+atag batch -d ./articles/ | jq '.results[] | .tags |= map(select(.score > 0.5))'
+
+# 標註 + 自動回饋迴圈
+RESULT=$(atag tag "文章")
+echo "$RESULT" | jq -r '.tags[] | .tag_name' | while read tag; do
+  # Agent 判斷是否正確後回饋
+  atag feedback "$tag" true
+done
+```
+
+## 錯誤處理
+- exit 0 = 成功（有結果）
+- exit 1 = 錯誤（JSON error 在 stderr）
+- exit 2 = 成功但無結果（空 tags）
+
+## 規則
+1. **永遠用 `atag`**（不是 `article-tagger`）— 更短、純 JSON、agent-native
+2. **所有輸出都是 JSON** — 直接 pipe 到 `jq` 或程式解析
+3. **先 `atag stats` 檢查** — 確認 index 已載入再標註
+4. **回饋很重要** — 每次標註後盡量給回饋，系統會越來越準

article_tagger-0.4.0/.dockerignore

@@ -0,0 +1,13 @@
+.venv
+__pycache__
+*.pyc
+.pytest_cache
+.git
+.claude
+.agents
+.codex
+dev/
+instincts/
+tests/
+*.egg-info
+.DS_Store

article_tagger-0.4.0/.env.example

@@ -0,0 +1,34 @@
+# Article Tagger 環境變數
+# 複製此檔案為 .env 並修改
+
+# Embedding 模型
+TAGGER_MODEL_NAME=paraphrase-multilingual-MiniLM-L12-v2
+
+# 標註設定
+TAGGER_TOP_K_RETURN=3
+TAGGER_SIMILARITY_THRESHOLD=0.1
+TAGGER_ENABLE_HIERARCHY=true
+TAGGER_ENABLE_SYNONYMS=true
+TAGGER_ENABLE_CHUNKING=true
+
+# LLM Reranker（可選）
+TAGGER_ENABLE_RERANKER=false
+TAGGER_ANTHROPIC_API_KEY=
+
+# API
+TAGGER_API_HOST=127.0.0.1
+TAGGER_API_PORT=8000
+TAGGER_API_KEY=
+
+# Rate Limiting
+TAGGER_RATE_LIMIT_MAX=60
+TAGGER_RATE_LIMIT_WINDOW=60
+
+# 路徑
+TAGGER_INDEX_DIR=data/index
+TAGGER_DATA_DIR=data
+TAGGER_PLUGINS_DIR=plugins
+
+# 其他
+KMP_DUPLICATE_LIB_OK=TRUE
+TAGGER_LOG_LEVEL=info

article_tagger-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: |
+          uv venv .venv
+          uv pip install -e ".[dev]" --python .venv/bin/python
+
+      - name: Run tests
+        env:
+          KMP_DUPLICATE_LIB_OK: "TRUE"
+          OPENBLAS_NUM_THREADS: "1"
+          OMP_NUM_THREADS: "1"
+        run: |
+          .venv/bin/python -m pytest tests/ -v --tb=short -x --timeout=120
+
+      - name: Check CLI loads
+        env:
+          KMP_DUPLICATE_LIB_OK: "TRUE"
+        run: |
+          .venv/bin/article-tagger --help

article_tagger-0.4.0/.gitignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+data/index/
+data/feedback.json
+data/history.json
+data/cooccurrence.json
+data/tag_weights.json
+data/profiles/
+*.egg-info/
+.DS_Store
+.env
+dist/
+build/
+node_modules/
+packages/*/dist/

article_tagger-0.4.0/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["@modelcontextprotocol/server-sequential-thinking"],
+      "type": "stdio"
+    },
+    "article-tagger": {
+      "command": "python",
+      "args": ["-m", "article_tagger.mcp_server"],
+      "type": "stdio"
+    }
+  }
+}