@topmindspace/topmind-skills 4.13.0

package/topmind-wechat/scripts/sync-status.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""sync-status.py — 同步公众号交付包的「状态 ⇄ 目录名 ⇄ 字数」。
+
+规则（与专题 topic.md 的目录规范一致）：
+  status = 草稿            → 目录名 YYYY-MM-DD-<中文名>
+  status = 定稿 / 已发布    → 目录名 YYYY-MM-DD-<中文名>-released
+
+同时刷新 frontmatter 的 word_count（正文中文字数）。
+
+Usage:
+    python3 sync-status.py                       # 扫描全部，只报告（dry-run）
+    python3 sync-status.py --apply               # 实际重命名并回写字数
+    python3 sync-status.py --set 定稿 <包目录>    # 改状态 + 同步目录名
+    python3 sync-status.py --base <专题目录>
+"""
+
+import argparse
+import os
+import re
+import sys
+
+def _default_base():
+    """交付包根：CLI --base → env TOPMIND_WECHAT_BASE → env TOPMIND_WORKSPACE 发现 → 惯例路径。"""
+    env = os.environ.get("TOPMIND_WECHAT_BASE") or os.environ.get("TOPMIND_WECHAT_PACKAGE_ROOT")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    ws = os.environ.get("TOPMIND_WORKSPACE")
+    if ws:
+        for rel in (
+            ("40-创作", "2026-公众号"),
+            ("20-专题", "2026-公众号"),
+            ("88-交付", "2026-公众号"),
+        ):
+            p = os.path.join(ws, *rel)
+            if os.path.isdir(p):
+                return p
+        return os.path.join(ws, "40-创作", "2026-公众号")
+    # 惯例：父工作区（可被 CLI 覆盖）
+    return os.path.join(
+        os.path.expanduser("~"), "TopWorkSpace", "topmind-workspace",
+        "40-创作", "2026-公众号")
+
+
+def _default_topstream():
+    env = os.environ.get("TOPSTREAM_ROOT") or os.environ.get("TOPMIND_TOPSTREAM")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    return os.path.join(os.path.expanduser("~"), "TopWorkSpace", "topstream")
+
+DEFAULT_BASE = _default_base()
+
+FINAL_STATUSES = ("定稿", "已发布")
+VALID_STATUSES = ("草稿",) + FINAL_STATUSES
+RELEASED_SUFFIX = "-released"
+
+
+def split_fm(text):
+    """返回 (frontmatter, body, head, tail_sep)；无 frontmatter 时 fm=None"""
+    if not text.startswith("---\n"):
+        return None, text, "", ""
+    i = text.find("\n---", 3)
+    if i < 0:
+        return None, text, "", ""
+    return text[4:i], text[i + 4:].lstrip("\n"), text[:4], text[i:i + 4]
+
+
+def get_field(fm, key):
+    m = re.search(r"^%s:\s*(.*)$" % re.escape(key), fm, re.M)
+    return m.group(1).strip().strip('"') if m else None
+
+
+def set_field(fm, key, val):
+    line = "%s: %s" % (key, val)
+    pat = re.compile(r"^%s:\s*.*$" % re.escape(key), re.M)
+    if pat.search(fm):
+        return pat.sub(line, fm, count=1)
+    return fm.rstrip("\n") + "\n" + line + "\n"
+
+
+def scan(base):
+    """返回 [(dirname, status, word_count, needs_rename, target_name)]"""
+    rows = []
+    for name in sorted(os.listdir(base)):
+        pkg = os.path.join(base, name)
+        draft = os.path.join(pkg, "公众号稿.md")
+        if not os.path.isdir(pkg) or not os.path.exists(draft):
+            continue
+        text = open(draft, encoding="utf-8").read()
+        fm, body, head, sep = split_fm(text)
+        if fm is None:
+            rows.append((name, None, None, False, None, "无 frontmatter"))
+            continue
+        status = get_field(fm, "status") or "草稿"
+        cn = len(re.findall(r"[\u4e00-\u9fff]", body))
+
+        want_final = status in FINAL_STATUSES
+        stem = name[:-len(RELEASED_SUFFIX)] if name.endswith(RELEASED_SUFFIX) else name
+        target = stem + (RELEASED_SUFFIX if want_final else "")
+        rows.append((name, status, cn, target != name, target, ""))
+    return rows
+
+
+def apply_rename(base, name, target, draft_path, fm, body, head, new_fm):
+    """写回 frontmatter 后重命名目录"""
+    open(draft_path, "w", encoding="utf-8").write("---\n" + new_fm + "\n---\n\n" + body)
+    if target != name:
+        os.rename(os.path.join(base, name), os.path.join(base, target))
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--base", default=DEFAULT_BASE)
+    ap.add_argument("--apply", action="store_true", help="实际执行（默认只报告）")
+    ap.add_argument("--set", metavar="STATUS", choices=VALID_STATUSES,
+                    help="把指定包改成该状态（需配合包名）")
+    ap.add_argument("pkg", nargs="?", help="包目录名（配合 --set 使用）")
+    args = ap.parse_args()
+
+    if not os.path.isdir(args.base):
+        print("✗ 专题目录不存在：%s" % args.base)
+        return 1
+
+    # 单包改状态
+    if args.set:
+        if not args.pkg:
+            print("✗ --set 需要指定包目录名")
+            return 1
+        draft = os.path.join(args.base, args.pkg, "公众号稿.md")
+        if not os.path.exists(draft):
+            print("✗ 找不到：%s" % draft)
+            return 1
+        text = open(draft, encoding="utf-8").read()
+        fm, body, head, sep = split_fm(text)
+        if fm is None:
+            print("✗ 该文件无 frontmatter")
+            return 1
+        fm = set_field(fm, "status", args.set)
+        cn = len(re.findall(r"[\u4e00-\u9fff]", body))
+        fm = set_field(fm, "word_count", str(cn))
+
+        want_final = args.set in FINAL_STATUSES
+        stem = args.pkg[:-len(RELEASED_SUFFIX)] if args.pkg.endswith(RELEASED_SUFFIX) else args.pkg
+        target = stem + (RELEASED_SUFFIX if want_final else "")
+
+        if args.apply:
+            apply_rename(args.base, args.pkg, target, draft, fm, body, head, fm)
+            print("✓ %s → status=%s，目录 %s（%d 中文字）" % (
+                args.pkg, args.set, target if target != args.pkg else "不变", cn))
+        else:
+            print("[dry-run] %s → status=%s，目录将变为 %s" % (args.pkg, args.set, target))
+        return 0
+
+    rows = scan(args.base)
+    if not rows:
+        print("专题下没有交付包：%s" % args.base)
+        return 0
+
+    print("%-44s %-6s %8s  %s" % ("包目录", "状态", "中文字", "待同步"))
+    print("-" * 84)
+    changed = 0
+    for name, status, cn, needs, target, note in rows:
+        if status is None:
+            print("%-44s %-6s %8s  %s" % (name, "-", "-", note))
+            continue
+        flag = "→ " + target if needs else ""
+        print("%-44s %-6s %8s  %s" % (name, status, cn, flag))
+
+        if args.apply:
+            draft = os.path.join(args.base, name, "公众号稿.md")
+            text = open(draft, encoding="utf-8").read()
+            fm, body, head, sep = split_fm(text)
+            fm = set_field(fm, "word_count", str(cn))
+            apply_rename(args.base, name, target, draft, fm, body, head, fm)
+            if needs:
+                changed += 1
+
+    if args.apply:
+        print("\n✓ 已刷新 %d 个包的 word_count，重命名 %d 个目录" % (len(rows), changed))
+    else:
+        pending = sum(1 for r in rows if r[3])
+        print("\n[dry-run] %d 个包目录名与状态不一致，加 --apply 执行" % pending)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/topmind-weread/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: topmind-weread
+version: 4.13.0
+description: >-
+  同步微信读书划线/想法/统计到专题。Use when 微信读书、划线同步、weread、读书笔记。
+  Do NOT use for 普通 URL 捕获、仅整理、出稿、X.
+action_category: connector
+triggers:
+  - 微信读书
+  - weread
+  - 划线同步
+  - 读书笔记
+  - 阅读统计
+  - 书架
+  - weread sync
+  - sync highlights
+tags: [weread, reading, highlights, sync, capture]
+entrypoint: false
+compatibility: Requires WeRead Skill API key (wrk-*). Desktop WereadService preferred; host may call gateway manually.
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-08-15
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind WeRead
+
+将微信读书划线/想法/统计同步为 topmind 笔记（`source_type: external-capture`）。
+
+## When NOT to use
+
+- 普通链接剪藏 → `topmind-capture`  
+- 发推 / X → `topmind-x`  
+- 无微信读书语义的整理/写作 → organize / write  
+
+## API（官方 Gateway）
+
+```text
+POST https://i.weread.qq.com/api/agent/gateway
+Authorization: Bearer wrk-xxxxxxxx
+Body: { "api_name": "/…", "skill_version": "1.0.4", … }
+```
+
+Key：`https://weread.qq.com/r/weread-skills`（微信扫码）。
+
+| 能力 | api_name |
+|------|----------|
+| 书架 | `/shelf/sync` |
+| 搜索 | `/store/search` |
+| 统计 | `/readdata/detail` |
+| 书详情/进度 | `/book/info` · `/book/getprogress` |
+| 有笔记的书 | `/user/notebooks`（`count` + `lastSort`） |
+| 划线 | `/book/bookmarklist` |
+| 想法 | `/review/list/mine` |
+| 推荐 | `/book/recommend` · `/book/similar` |
+
+## Desktop 同步策略
+
+1. 分页拉全 notebooks（`count=100` + `lastSort`）  
+2. 仅 `noteCount + reviewCount > 0`（书签不算可导出；拉完仍空也不写专题）  
+3. 本地条数一致 → 跳过；`note_fingerprint` 二次校验  
+4. 每书：bookmarklist + 可选 `/review/list/mine`（`synckey`）  
+5. 写 `topic.md` + `划线笔记.md`（`writeConnectorNote` 经 kernel 写闸；create/update 不备份，仅 locked 等高影响才备份）  
+6. 软预算（默认 4 分钟）超时留下次  
+7. `lastSyncAt` 仅展示，不作时间过滤  
+8. `upgrade_info` 展示即可，不因新 zip 单独失败  
+
+目标类别：见 router [`../topmind/references/connector-resolution.md`](../topmind/references/connector-resolution.md)。
+
+### 落盘形状
+
+```text
+{类别}/2026-书名/
+├── topic.md      # weread_book_id, synced_at, …
+└── 划线笔记.md
+```
+
+### 配置（Desktop）
+
+`weread.enabled` · `apiKey` · `syncCategory: auto|目录` · `includeThoughts` · `syncBudgetMinutes`。
+
+RPC：`weread.getStatus` · `testConnection` · `listNotebooks` · `syncHighlights` · stats/search 等。
+
+## 降级
+
+1. 无 API Key → 引导获取  
+2. API 失败 → 保留上次数据 + 错误  
+3. 单书超时 → 跳过继续  
+4. 无 Desktop → host 可手工调 Gateway；仍遵守 PROJECT-MODEL  
+
+## 保存设置
+
+- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
+- **需要审阅 (confirm)**：先进入目标路径/内容审阅入口再保存
+- Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+

package/topmind-write/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: topmind-write
+version: 4.13.0
+description: >-
+  写作/润色/出稿到专题或交付层（role:delivery）。Use when 写、起草、续写、润色、出稿、交付、write、draft、deliver。
+  Do NOT use for 仅捕获、仅结构整理、只写记忆、doctor/loop、社交连接器.
+action_category: write
+triggers:
+  - 写
+  - 写作
+  - 起草
+  - 续写
+  - 修订
+  - 润色
+  - 交付
+  - 改写
+  - de-AI
+  - 输出
+  - 出稿
+  - 定稿
+  - 发布
+  - 导出
+  - 排版
+  - write
+  - draft
+  - deliver
+  - publish
+  - export
+tags: [write, draft, revise, polish, deliver]
+entrypoint: false
+compatibility: topmind workspace. Delivery role category (often 88-交付 / 88-Delivery).
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-09-22
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind Write
+
+从起草到交付。输出最终内容到 **delivery 层**（role:delivery）或专题根。
+
+## Activation checklist
+
+1. 能定位专题时：**先读 `topic.md`（若有）**，再读焦点稿与必要笔记（不足再 organize/capture）  
+2. 起草或修订；去 AI 腔 / 适配格式  
+3. 落盘专题根或 `save-output` → delivery  
+4. 路径回执；交付勿塞进专题内 `outputs/`  
+
+## When NOT to use
+
+- 记链接/想法 → `topmind-capture`  
+- 整理/综合证据 → `topmind-organize`  
+- 只更新「我的情况」/ 周期反思 → `topmind-memory`  
+- 清理/体检/巡检 → maintain / loop  
+- 发推 / 微信读书 → connectors  
+- **公众号 / 微信排版 / 公众号定稿发布** → `topmind-wechat`（write 族子技能）
+
+## Writing Entry Points
+
+Draft · Continue · Revise · Polish · Deliver — 按用户当前意图，不是固定流水线。
+
+公众号专用：选题包 · 审校改写 · 质量三关 · 定稿 · 微信排版 — 转入 [`../topmind-wechat/SKILL.md`](../topmind-wechat/SKILL.md)。
+
+## Workflow
+
+1. **读序（先首页再素材）**：`topic.md`（若有）→ 焦点对象 → 仅必要笔记。无 topic.md 不强制创建，照旧扫笔记。禁止一上来 dump 整专题  
+2. 对齐目标、稳定记忆、风格、受众  
+3. 产出可用正文，少过程旁白  
+4. 按保存设置写入；锁定文件：内容编辑允许（任务级首写快照），可恢复删/归档允许，永久删仅用户。宿主若提供唯一片段替换（Desktop / Obsidian `edit_file`），中段改稿优先用它：匹配阶梯（精确→换行/空白→行级宽松），多步编辑跟 postEditWindow + contentHash/expectedHash，不要为改一段而整文件覆盖。不要编造 shell / bash 工具。  
+5. Desktop 可选影子流式：`.shadow-*.tmp`，Commit 后再原子落盘  
+
+## source_type
+
+- AI 草稿默认 `ai-derived`  
+- 用户原文仅排版 → `user-original`  
+- 交付层文件 `source_type` 可选；专题内笔记建议必填  
+
+## Delivery Checklist
+
+```text
+□ 格式匹配目标
+□ 无内部标注 / TODO / 占位符
+□ 受众与语气匹配
+□ source_type 正确
+□ 路径正确（交付层 save-output；专题根 capture-note）
+□ 交付层文件名 YYYY-MM-DD-描述.ext
+□ 回执含路径与下一步
+```
+
+不满足则在回执标注。
+
+## Quality Bar
+
+具体、受众向；去 AI 套话；保用户声音。`topic.md` 风格锚点优先。
+
+改稿按场景选工具，别混用：
+
+| 场景 | 技能 |
+|---|---|
+| 中文改稿的保真边界（不新增事实、不把「可能」写成「确定」） | `humanizer-zh` |
+| 中文 AI 味体检 / 量化评分 / pan 个人风格 | `qu-aiwei-zh` |
+| 英文文本 | `humanizer` |
+
+默认组合是**先 `humanizer-zh` 立边界，再 `qu-aiwei-zh` 扫描定位**。分数不够时只能删套话改表达，不许补数字或硬塞「我」。
+
+## Capability Degradation
+
+[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。`inspect-topic` · `save-output` · `capture-note`。
+
+## 保存设置
+
+- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
+- **需要审阅 (confirm)**：先进入目标路径/内容审阅入口再保存
+- Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+

package/topmind-x/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: topmind-x
+version: 4.13.0
+description: >-
+  X/Twitter：归档/搜索（Bearer）、发帖（xurl）、Agent 可用官方 MCP。Use when 发推、推特、twitter、x.com。
+  Do NOT use for 微信读书、非 X 捕获、doctor、长文交付.
+action_category: connector
+triggers:
+  - 发推
+  - 推特
+  - twitter
+  - x.com
+  - 发帖
+  - 推文
+  - post tweet
+  - x platform
+tags: [x, twitter, social, mcp, agent]
+entrypoint: false
+compatibility: Desktop needs Bearer (read) and/or xurl (post). Agent hosts use official X MCP + xurl bridge.
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind
+updated: 2026-08-16
+degradation: ../shared/capability-degradation.md
+---
+
+# topmind X / Twitter
+
+分清两个平面：
+
+| 平面 | 接入 | 能力 |
+|------|------|------|
+| Agent 宿主 | 官方 MCP `https://api.x.com/mcp` + `xurl mcp` | 搜索/用户/书签等（随 scope） |
+| Desktop 只读 | App-only Bearer → API v2 | 搜索/时间线 → 归档笔记 |
+| Desktop 发帖 | 本机 `xurl`（用户 OAuth） | 发布；失败草稿进 Inbox |
+
+文档：https://docs.x.com/tools/mcp
+
+## When NOT to use
+
+- 微信读书 → `topmind-weread`  
+- 非 X 的剪藏 → `topmind-capture`  
+- 长文交付（非推文）→ `topmind-write`  
+
+## 认证
+
+- **Bearer**：只读；不能发帖  
+- **xurl OAuth**：Desktop 发帖  
+- **官方 MCP**：Agent 宿主；Desktop **不**内嵌 OAuth 桥  
+
+```bash
+npx -y @xdevplatform/xurl mcp https://api.x.com/mcp
+brew install --cask xdevplatform/tap/xurl && xurl auth oauth2
+```
+
+## 与笔记整合
+
+类别解析：[`../topmind/references/connector-resolution.md`](../topmind/references/connector-resolution.md)。
+
+推文笔记：`source_type: external-capture`，含链接与可选 AI 摘要分隔。
+
+## 发布工作流
+
+起草（可 write）→ **用户确认**（即使 `writeback_mode: auto`）→ xurl 或 MCP 发布 → 可选归档。
+
+## Desktop RPC
+
+`x.getStatus` · `probeTools` · `testConnection` · `searchTweets` · `getTimeline` · `syncToNotes` · `postTweet`。
+
+设置：`x.enabled` · `bearerToken` · `mcpEndpoint`（仅 Agent 文档）· `syncCategory: auto` · `autoArchivePosts`。
+
+### Desktop 实现约定
+
+- **读**：Bearer → 官方 `GET https://api.x.com/2/tweets/search/recent` / `GET /2/users/by/username/{handle}` + `/2/users/{id}/tweets`。无 Bearer 时走本机 xurl **同一 REST 路径**（不是自造 `timeline --user`）。
+- **写**：`xurl -X POST /2/tweets -d '{"text":…}'`（官方）；快捷 `xurl post "…"` 作回退。App-only Bearer **不能**发帖。
+- **归档**：预览勾选后写入 `{类别}/{YYYY-主题}/`；`append` 时按 `tweet_ids` / `status/{id}` **跳过已有推文**。create/update 不备份（仅 locked 等高影响）。
+- Desktop **不**内嵌官方 MCP OAuth 桥；`mcpEndpoint` 给 Agent 宿主配置。
+
+## 降级
+
+1. 无 Bearer → 不能搜索/时间线  
+2. 无 xurl → 不能发帖（草稿 Inbox）  
+3. Agent 完整能力 → 宿主接 MCP  
+4. 无通道 → 仅编辑器起草  
+
+## 安全
+
+Bearer 加密存储；不自动关注/点赞/转发；遵守 X API 规则。
+
+## 保存设置
+
+- **自动保存 (auto)**：直接写入并返回路径回执（path receipt）
+- **需要审阅 (confirm)**：先进入目标路径/内容审阅入口再保存
+- Host 可编码为 `writeback_mode: auto | confirm`。详见 [`../shared/writeback-receipt.md`](../shared/writeback-receipt.md)。
+
+发布动作始终二次确认（即使 auto）。
+