sophhub 0.2.1 → 0.2.3

package/skills/compact-context/src/scripts/setup.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+# Set up post-compaction context refresh rules in personal ~/.agents/AGENTS.md
+# Usage: bash setup.sh
+# Safe to run multiple times.
+
+set -euo pipefail
+
+PERSONAL_AGENTS="$HOME/.agents/AGENTS.md"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+echo ""
+echo -e "${BOLD}━━━ Compact Context Setup ━━━${RESET}"
+echo ""
+
+mkdir -p "$HOME/.agents"
+[ -f "$PERSONAL_AGENTS" ] || : > "$PERSONAL_AGENTS"
+
+PYTHON_OUTPUT="$(python3 - "$PERSONAL_AGENTS" <<'PY'
+import pathlib
+import re
+import sys
+
+path = pathlib.Path(sys.argv[1])
+text = path.read_text(encoding="utf-8") if path.exists() else ""
+
+startup_block = """## Session Startup
+
+Context may have been compacted. When you see `[Post-compaction context refresh]` in your context:
+1. Re-read any task files mentioned in the conversation before responding.
+2. Treat missing earlier conversation details as incomplete context, not as proof they never happened.
+3. If you need to mention compaction to the user, describe it naturally; do not force a fixed reply prefix.
+"""
+
+red_lines_block = """## Red Lines
+
+- After compaction, re-read task context files before proceeding.
+- Never assume conversation history is complete after a `[Post-compaction context refresh]`.
+- Do not force a fixed reply prefix after compaction.
+"""
+
+legacy = "（已压缩，从摘要恢复）" in text or "Start your reply with:" in text
+
+def upsert_section(source: str, title: str, block: str) -> tuple[str, bool]:
+    pattern = rf"(?ms)^## {re.escape(title)}\n.*?(?=^## |\Z)"
+    if re.search(pattern, source):
+      return re.sub(pattern, block + "\n", source), True
+    source = source.rstrip()
+    if source:
+      source += "\n\n"
+    source += block + "\n"
+    return source, False
+
+updated, startup_exists = upsert_section(text, "Session Startup", startup_block)
+updated, red_lines_exists = upsert_section(updated, "Red Lines", red_lines_block)
+updated = updated.rstrip() + "\n"
+path.write_text(updated, encoding="utf-8")
+
+print(f"startup_exists={'1' if startup_exists else '0'}")
+print(f"red_lines_exists={'1' if red_lines_exists else '0'}")
+print(f"legacy={'1' if legacy else '0'}")
+PY
+)"
+
+STARTUP_EXISTS="$(printf '%s\n' "$PYTHON_OUTPUT" | awk -F= '/^startup_exists=/{print $2}')"
+RED_LINES_EXISTS="$(printf '%s\n' "$PYTHON_OUTPUT" | awk -F= '/^red_lines_exists=/{print $2}')"
+LEGACY_FOUND="$(printf '%s\n' "$PYTHON_OUTPUT" | awk -F= '/^legacy=/{print $2}')"
+
+if [ "$STARTUP_EXISTS" = "1" ]; then
+  echo -e "${GREEN}✔ ## Session Startup updated${RESET} in $PERSONAL_AGENTS"
+else
+  echo -e "${GREEN}✔ ## Session Startup added${RESET} to $PERSONAL_AGENTS"
+fi
+
+if [ "$RED_LINES_EXISTS" = "1" ]; then
+  echo -e "${GREEN}✔ ## Red Lines updated${RESET} in $PERSONAL_AGENTS"
+else
+  echo -e "${GREEN}✔ ## Red Lines added${RESET} to $PERSONAL_AGENTS"
+fi
+
+if [ "$LEGACY_FOUND" = "1" ]; then
+  echo -e "${YELLOW}○ Legacy fixed-prefix rules were replaced with safer recovery guidance.${RESET}"
+fi
+
+echo ""
+echo -e "${BOLD}Done.${RESET} Verify with: ${CYAN}bash check.sh${RESET}"
+echo ""
+echo -e "What happens next:"
+echo -e "  • Every auto-compact can still re-inject your recovery rules"
+echo -e "  • Agent will re-read task files after a context refresh"
+echo -e "  • Replies are no longer forced to start with a fixed compaction prefix"
+echo ""

package/skills/feishu-notes-assistant-universal/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "feishu-notes-assistant-universal",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "飞书表格助手",
+  "description": "用于飞书在线文档的创建、读取、更新、删除与搜索，并支持在提供会议纪要链接或 token 时生成纪要文档。",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-13",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-13",
+  "updatedAt": "2026-04-13"
+}

package/skills/feishu-notes-assistant-universal/src/README.md

@@ -0,0 +1,55 @@
+# feishu-notes-assistant
+
+Self-contained OpenClaw skill package for:
+
+- Feishu online notes workspace operations:
+  - `create/read/update/delete/search`
+  - image/file insertion
+  - document comments
+  - section-level updates
+- meeting minutes processing as a secondary sub-capability (`Minutes -> Note`)
+
+## Package layout
+
+- `SKILL.md`: OpenClaw skill definition
+- `scripts/run_meeting_minutes.py`: cross-platform minutes entrypoint
+- `scripts/run_note_crud.py`: cross-platform note CRUD entrypoint
+- `scripts/run_meeting_minutes.sh`: compatibility wrapper (delegates to Python)
+- `scripts/run_note_crud.sh`: compatibility wrapper (delegates to Python)
+- `scripts/openclaw_meeting_minutes.py`: downstream orchestrator
+- `scripts/openclaw_notes_crud.py`: note workspace orchestrator
+- `bin/<os>-<arch>/lark-cli-openclaw[.exe]`: bundled platform binaries
+
+## Runtime requirements
+
+- `python3`
+- user must complete `lark-cli-openclaw auth login`
+- recommended scopes:
+  - `vc:note:read`
+  - `minutes:minutes:readonly`
+  - `minutes:minutes.artifacts:read`
+  - `minutes:minutes.transcript:export`
+  - `docx:document:create`
+  - `docx:document:readonly`
+- `docx:document:write_only`
+- `search:docs:read`
+- `docs:document.media:upload`
+- `docs:document.media:download`
+- `docs:document.comment:create`
+- `docs:document.comment:write_only`
+
+## Notes
+
+- This package does not depend on the original repository checkout path.
+- This package is cross-platform for:
+  - `darwin-amd64`
+  - `darwin-arm64`
+  - `linux-amd64`
+  - `linux-arm64`
+  - `windows-amd64`
+  - `windows-arm64`
+- It starts from an existing Feishu Minutes URL or `minute_token`.
+- It does not upload audio into Feishu Minutes.
+- Delete note operation is implemented via Drive file delete API with doc token/docx URL input.
+- The package is note-first: direct Feishu note operations are the primary workflow, while minutes import is secondary.
+- Section-level updates are exposed as a first-class operation instead of requiring users to assemble raw `docs +update` flags manually.

package/skills/feishu-notes-assistant-universal/src/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: feishu-notes-assistant
+description: Feishu notes assistant for online note creation, reading, updating, deleting, and search, with meeting-minutes import as a secondary capability.
+metadata: {"openclaw":{"requires":{"bins":["python3"]}}}
+---
+
+# Feishu Notes Assistant
+
+This skill focuses on Feishu online note workflows first. Feishu Minutes import is a secondary sub-capability that should only be used when the user explicitly provides a Minutes link or `minute_token`.
+
+This skill provides two capability groups:
+
+- `Notes Workspace`: create/read/update/delete/search Feishu notes, insert images/files, add comments, and perform section-level updates.
+- `Minutes -> Note` (secondary): read a Feishu Minutes link/token, generate meeting notes, create a Feishu doc, return the doc URL.
+
+Use bundled scripts only:
+
+```bash
+python3 {baseDir}/scripts/run_meeting_minutes.py "<minutes_url_or_token>"
+```
+
+```bash
+python3 {baseDir}/scripts/run_note_crud.py --op <create|read|update|delete|search> ...
+```
+
+```bash
+python3 {baseDir}/scripts/run_note_crud.py --op <media-insert|media-download|comment|section-update> ...
+```
+
+Package assumptions:
+
+- This package is self-contained for `darwin/linux/windows` on `amd64/arm64`.
+- It bundles multi-platform `lark-cli-openclaw` binaries under `{baseDir}/bin/<os>-<arch>/`.
+- It does not depend on the original `feishu-cli` repository checkout path.
+
+## A. Notes Workspace
+
+Use this branch when user intent is direct note management, such as:
+
+- `新建笔记` / `创建飞书笔记`
+- `查看笔记内容` / `读取某篇笔记`
+- `更新笔记` / `追加内容` / `覆盖内容`
+- `删除笔记`
+- `按关键词查找笔记`
+- `往笔记里插入图片` / `上传附件到笔记`
+- `给笔记加评论`
+- `按章节替换、删除、前插、后插`
+
+Routing rules:
+
+- Prefer this skill over generic web tools when user explicitly asks to operate Feishu notes/docs.
+- Prefer notes CRUD over minutes flow unless the user explicitly gives a Feishu Minutes link/token.
+- Prefer note workflows over generic “文档助手” interpretations; this skill is for actual Feishu note manipulation, not generic summarization.
+- Use `run_note_crud.py` first; do not ask the user to manually call `lark-cli`.
+- For delete, prefer doc token or `/docx/<token>` URL.
+- For note comments, prefer this skill over chat-style review summaries when the user explicitly asks to comment on a note.
+- For media insertion, prefer this skill over uploading files elsewhere and pasting links.
+
+Command templates:
+
+- Create:
+  `python3 {baseDir}/scripts/run_note_crud.py --op create --title "<title>" --markdown "<markdown>"`
+- Read:
+  `python3 {baseDir}/scripts/run_note_crud.py --op read --doc "<doc_token_or_url>"`
+- Update (append/overwrite/replace):
+  `python3 {baseDir}/scripts/run_note_crud.py --op update --doc "<doc_token_or_url>" --mode append --markdown "<markdown>"`
+- Delete:
+  `python3 {baseDir}/scripts/run_note_crud.py --op delete --doc "<doc_token_or_url>"`
+- Search:
+  `python3 {baseDir}/scripts/run_note_crud.py --op search --query "<keyword>"`
+- Insert image/file:
+  `python3 {baseDir}/scripts/run_note_crud.py --op media-insert --doc "<doc_token_or_url>" --file "<local_path>" --media-type image`
+- Add comment:
+  `python3 {baseDir}/scripts/run_note_crud.py --op comment --doc "<doc_token_or_url>" --comment "<text>"`
+- Replace one section:
+  `python3 {baseDir}/scripts/run_note_crud.py --op section-update --doc "<doc_token_or_url>" --section-title "## 章节名" --section-mode replace --markdown "<new_markdown>"`
+- Delete one section:
+  `python3 {baseDir}/scripts/run_note_crud.py --op section-update --doc "<doc_token_or_url>" --section-title "## 废弃章节" --section-mode delete`
+- Insert before/after one section:
+  `python3 {baseDir}/scripts/run_note_crud.py --op section-update --doc "<doc_token_or_url>" --section-title "## 目标章节" --section-mode insert_after --markdown "<markdown>"`
+
+Result handling:
+
+- If output has `"ok": true`, summarize key fields and return document link/token when present.
+- If output has `"ok": false`, return `error.message` and keep it concise.
+- For section-update, mention which section was changed and whether it was replaced, deleted, inserted before, or inserted after.
+- For media-insert, return inserted `file_token` when useful.
+- For comment, briefly confirm whether it was a full-document or local comment.
+
+Examples:
+
+- User: `帮我新建一篇飞书笔记，标题是周报，内容是本周完成了接口联调`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op create ...`
+
+- User: `帮我搜索标题里有 OKR 的飞书笔记`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op search --query "OKR"`
+
+- User: `把这篇笔记末尾追加一段总结`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op update --mode append ...`
+
+- User: `把这张图片插到这篇飞书笔记里`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op media-insert ...`
+
+- User: `给这篇笔记中“风险提示”这一段加一句评论`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op comment --selection-with-ellipsis ...`
+
+- User: `把“## 下周计划”这一章节替换成新的内容`
+  Action: use `python3 {baseDir}/scripts/run_note_crud.py --op section-update --section-title "## 下周计划" --section-mode replace ...`
+
+## B. Minutes -> Note
+
+This is a secondary sub-capability under the note assistant. Only use it when the input is explicitly a Feishu Minutes link or a raw `minute_token`. Do not route normal note-taking requests here.
+
+Use this skill when the user provides:
+
+- a Feishu Minutes link like `https://*.feishu.cn/minutes/<minute_token>`
+- a Feishu Minutes link like `https://my.feishu.cn/minutes/<minute_token>`
+- or a raw `minute_token`
+
+and asks to:
+
+- read the meeting transcript
+- create a Feishu cloud document
+- return the document link
+
+For this skill, do not invent a new workflow. Always use the local wrapper script below:
+
+```bash
+python3 {baseDir}/scripts/run_meeting_minutes.py "<minutes_url_or_token>"
+```
+
+Priority and routing rules:
+
+- This skill takes precedence over generic URL-reading, webpage summarization, `web_fetch`, browser automation, or search workflows when the input clearly matches a Feishu Minutes URL.
+- Treat `https://my.feishu.cn/minutes/...` and `https://*.feishu.cn/minutes/...` as high-confidence skill triggers.
+- Treat the URL as an opaque Minutes locator, not as a webpage to scrape.
+
+Rules:
+
+- Prefer this skill proactively when the request is clearly about a Feishu Minutes link.
+- Pass the original URL when available; the wrapper can extract `minute_token`.
+- Do not call `web_fetch`, browser tools, search tools, or any webpage-reading flow before trying this skill.
+- Do not explain that the page requires login or that redirects prevent access unless the wrapper itself fails and returns an error.
+- Do not ask the user to manually export the transcript if the URL already matches a Feishu Minutes link.
+- Extracting `minute_token` from the URL is sufficient; direct webpage access is not required for this skill.
+- Always try the wrapper first for Feishu Minutes URLs, even if the link may redirect in a browser.
+- If the wrapper returns JSON with `"status": "succeeded"`, reply with the Feishu document link from `feishu_doc_url`.
+- If the wrapper returns `"status": "partial"`, explain that the transcript/markdown was generated but document creation failed.
+- If the wrapper returns `"status": "failed"`, summarize `error_message` briefly.
+- Do not ask the user to run terminal commands themselves.
+- Do not upload audio files with this skill; it only handles existing Minutes links or tokens.
+
+Examples:
+
+- User: `读取这个飞书妙记并创建飞书云文档：https://my.feishu.cn/minutes/obc123?from=from_copylink`
+  Action: immediately run `python3 {baseDir}/scripts/run_meeting_minutes.py "https://my.feishu.cn/minutes/obc123?from=from_copylink"`
+
+- User: `请把这个 minutes 链接整理成文档并返回链接`
+  Action: if the URL matches `feishu.cn/minutes/`, use the minutes flow and skip webpage fetching.

package/skills/feishu-notes-assistant-universal/src/scripts/_resolve_lark_cli.py

@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+"""Resolve bundled lark-cli binary path by platform."""
+
+from __future__ import annotations
+
+import platform
+from pathlib import Path
+
+
+def _norm_os() -> str:
+    system = platform.system().lower()
+    if system.startswith("darwin"):
+        return "darwin"
+    if system.startswith("linux"):
+        return "linux"
+    if system.startswith("windows"):
+        return "windows"
+    return system
+
+
+def _norm_arch() -> str:
+    machine = platform.machine().lower()
+    mapping = {
+        "x86_64": "amd64",
+        "amd64": "amd64",
+        "aarch64": "arm64",
+        "arm64": "arm64",
+    }
+    return mapping.get(machine, machine)
+
+
+def resolve_bundled_cli(base_dir: Path) -> Path:
+    os_name = _norm_os()
+    arch = _norm_arch()
+    ext = ".exe" if os_name == "windows" else ""
+
+    # New multi-platform layout.
+    candidate = base_dir / "bin" / f"{os_name}-{arch}" / f"lark-cli-openclaw{ext}"
+    if candidate.exists():
+        return candidate
+
+    # Backward compatibility: old single-binary layout.
+    old = base_dir / "bin" / f"lark-cli-openclaw{ext}"
+    if old.exists():
+        return old
+
+    supported = [
+        "darwin-amd64",
+        "darwin-arm64",
+        "linux-amd64",
+        "linux-arm64",
+        "windows-amd64",
+        "windows-arm64",
+    ]
+    raise FileNotFoundError(
+        f"missing bundled lark-cli-openclaw for {os_name}-{arch}; "
+        f"expected {candidate}. supported targets: {', '.join(supported)}"
+    )