@runweave/server-linux-x64 0.1.8 → 0.1.9

package/payload/plugins/toolkit/skills/browse-record/scripts/zhihu_http.py

@@ -0,0 +1,273 @@
+"""Read-only Zhihu HTTP transport. Credentials remain in a private local file."""
+import contextlib
+import datetime as dt
+from html.parser import HTMLParser
+import http.client
+import json
+import re
+import signal
+import socket
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+import uuid
+
+import suiji
+
+ME = "https://www.zhihu.com/api/v4/me"
+HISTORY = "https://api.zhihu.com/unify-consumption/read_history?offset=0&limit=20"
+ALLOWED = re.compile(r"https://(?:api\.zhihu\.com/unify-consumption/read_history(?:\?[^#]*)?|www\.zhihu\.com/api/v4/(?:me|answers/\d+)(?:\?[^#]*)?|zhuanlan\.zhihu\.com/api/articles/\d+)")
+
+
+def require(ok, code):
+    if not ok:
+        raise suiji.Failure(code)
+
+
+class NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, *args, **kwargs):
+        return None
+
+
+@contextlib.contextmanager
+def request_timeout(seconds):
+    # The macOS/POSIX collector runs requests on its main thread. A socket's
+    # idle timeout alone cannot bound slow headers or a continuously read body.
+    previous_handler = signal.getsignal(signal.SIGALRM)
+    previous_timer = signal.getitimer(signal.ITIMER_REAL)
+    started = time.monotonic()
+
+    def expired(signum, frame):
+        raise TimeoutError("HTTP_REQUEST_TIMEOUT")
+
+    signal.signal(signal.SIGALRM, expired)
+    signal.setitimer(signal.ITIMER_REAL, min(seconds, previous_timer[0]) if previous_timer[0] else seconds)
+    try:
+        yield
+    finally:
+        signal.setitimer(signal.ITIMER_REAL, 0)
+        signal.signal(signal.SIGALRM, previous_handler)
+        if previous_timer[0]:
+            signal.setitimer(signal.ITIMER_REAL, max(0.000001, previous_timer[0] - (time.monotonic() - started)), previous_timer[1])
+
+
+class Text(HTMLParser):
+    def __init__(self):
+        super().__init__(convert_charrefs=True)
+        self.parts = []
+
+    def handle_data(self, value):
+        self.parts.append(value)
+
+    def handle_starttag(self, tag, attrs):
+        if tag == "br":
+            self.parts.append("\n")
+
+    def handle_endtag(self, tag):
+        if tag in ("p", "div", "li", "h1", "h2", "h3", "blockquote"):
+            self.parts.append("\n")
+
+
+def plain(html):
+    safe = re.sub(r"<(script|style|iframe|object|embed|video|audio)[\s\S]*?</\1\s*>", "", html, flags=re.I)
+    safe = re.sub(r"<(img|source|link|meta)\b[^>]*>", "", safe, flags=re.I)
+    parser = Text()
+    parser.feed(safe)
+    return re.sub(r"\n{3,}", "\n\n", "".join(parser.parts)).strip()
+
+
+class Session:
+    def __init__(self, auth, config):
+        require(auth.get("schemaVersion") == 1, "INVALID_HTTP_SESSION")
+        require(all(auth.get(k) == config[k] for k in ("machine", "profile", "externalAccountId")), "HTTP_SESSION_BINDING_CHANGED")
+        require(config["machine"] == socket.gethostname(), "MACHINE_OR_ACCOUNT_BINDING_MISMATCH")
+        require(isinstance(auth.get("cookies"), list) and isinstance(auth.get("userAgent"), str), "INVALID_HTTP_SESSION")
+        self.auth = auth
+        self.opener = urllib.request.build_opener(NoRedirect())
+        self.deadline = time.monotonic() + 20 * 60
+        self.requests = 0
+
+    def request(self, url):
+        require(isinstance(url, str) and ALLOWED.fullmatch(url), "UNTRUSTED_API_URL")
+        require(time.monotonic() < self.deadline, "RUN_BUDGET_EXCEEDED")
+        parsed = urllib.parse.urlsplit(url)
+        cookies = []
+        for cookie in self.auth["cookies"]:
+            domain, path = cookie.get("domain", ""), cookie.get("path", "/")
+            host_matches = parsed.hostname == domain or (domain.startswith(".") and (parsed.hostname == domain[1:] or parsed.hostname.endswith(domain)))
+            path_matches = parsed.path == path or (parsed.path.startswith(path) and (path.endswith("/") or parsed.path[len(path):].startswith("/")))
+            if host_matches and path_matches and (cookie.get("expires", -1) < 0 or cookie["expires"] > time.time()):
+                cookies.append(cookie)
+        require(any(c.get("name") == "z_c0" for c in cookies), "NEEDS_LOGIN")
+        headers = {"Cookie": "; ".join(c["name"] + "=" + c["value"] for c in cookies), "User-Agent": self.auth["userAgent"],
+                   "Accept": "application/json", "Referer": "https://www.zhihu.com/", "Origin": "https://www.zhihu.com"}
+        for attempt in range(3):
+            remaining = self.deadline - time.monotonic()
+            require(remaining > 0, "RUN_BUDGET_EXCEEDED")
+            self.requests += 1
+            try:
+                with request_timeout(min(15, remaining)):
+                    try:
+                        response = self.opener.open(urllib.request.Request(url, headers=headers, method="GET"), timeout=min(15, remaining))
+                    except urllib.error.HTTPError as error:
+                        response = error
+                    with response:
+                        raw = response.read(10 * 1024 * 1024 + 1)
+                        status = response.status
+                    require(len(raw) <= 10 * 1024 * 1024, "API_RESPONSE_TOO_LARGE")
+                    try:
+                        data = json.loads(raw)
+                    except (ValueError, UnicodeError):
+                        data = None
+            except (urllib.error.URLError, TimeoutError, OSError, http.client.HTTPException):
+                status, data = 0, None
+            require(time.monotonic() <= self.deadline, "RUN_BUDGET_EXCEEDED")
+            if (status == 0 or status == 429 or status >= 500) and attempt < 2:
+                time.sleep(min(0.5 * (attempt + 1), max(0, self.deadline - time.monotonic())))
+                continue
+            return {"status": status, "data": data}
+
+    def identity(self):
+        result = self.request(ME)
+        value = result["data"]
+        require(result["status"] == 200 and isinstance(value, dict) and isinstance(value.get("id"), str) and value["id"],
+                "NEEDS_LOGIN" if result["status"] in (401, 403) else "IDENTITY_UNAVAILABLE")
+        return value["id"]
+
+    def history(self, url):
+        result = self.request(url)
+        value = result["data"]
+        require(result["status"] == 200 and isinstance(value, dict) and isinstance(value.get("data"), list)
+                and isinstance(value.get("paging"), dict) and type(value["paging"].get("is_end")) is bool,
+                "NEEDS_LOGIN" if result["status"] in (401, 403) else "HISTORY_UNAVAILABLE_OR_PARSE_FAILED")
+        return value
+
+
+def parse(card):
+    require(isinstance(card, dict) and card.get("card_type") == "single_card" and isinstance(card.get("data"), dict), "UNKNOWN_HISTORY_STRUCTURE")
+    value = card["data"]
+    extra = value.get("extra")
+    require(isinstance(extra, dict) and isinstance(extra.get("content_token"), str) and isinstance(extra.get("content_type"), str)
+            and type(extra.get("read_time")) in (int, float), "UNKNOWN_HISTORY_STRUCTURE")
+    stamp = extra["read_time"]
+    occurred = dt.datetime.fromtimestamp(stamp / 1000 if stamp > 1e12 else stamp, dt.timezone.utc)
+    title = value.get("header", {}).get("title") if isinstance(value.get("header"), dict) else None
+    return {"type": extra["content_type"], "id": extra["content_token"], "occurredAt": occurred.isoformat(timespec="milliseconds").replace("+00:00", "Z"),
+            "day": occurred.astimezone(dt.timezone(dt.timedelta(hours=8))).date().isoformat(), "questionId": extra.get("question_token"),
+            "title": title if isinstance(title, str) else "知乎浏览内容"}
+
+
+def signature(value):
+    return [(item["type"], item["id"], item["occurredAt"]) for item in map(parse, value["data"])]
+
+
+def content(session, item):
+    supported = item["type"] in ("answer", "article") and re.fullmatch(r"[0-9]+", item["id"])
+    if not supported:
+        return "", "metadata-only", "unsupported-content-type"
+    url = (f'https://www.zhihu.com/api/v4/answers/{item["id"]}?include=content,paid_info' if item["type"] == "answer"
+           else f'https://zhuanlan.zhihu.com/api/articles/{item["id"]}')
+    try:
+        result = session.request(url)
+        value = result["data"]
+        if result["status"] == 200 and isinstance(value, dict) and str(value.get("id")) == item["id"] and isinstance(value.get("content"), str):
+            body = plain(value["content"])
+            if value.get("is_paid") is True and (value.get("paid_info") or {}).get("has_purchased") is not True:
+                return body, "metadata-only", "paid-content-limited"
+            return body, "available" if body else "metadata-only", None if body else "empty-content"
+        return "", "metadata-only", "forbidden" if result["status"] == 403 else "not-found" if result["status"] == 404 else "content-unavailable-or-id-mismatch"
+    except Exception:
+        return "", "metadata-only", "content-timeout-or-parse-failed"
+
+
+def collect(config, options):
+    auth = json.loads(suiji.private_read(config["sessionFile"]))
+    session = Session(auth, config)
+    before = session.identity()
+    require(before == config["externalAccountId"], "ACCOUNT_CHANGED")
+    captured = dt.datetime.now(dt.timezone.utc).isoformat(timespec="milliseconds").replace("+00:00", "Z")
+    observed, baseline_pages, errors = {}, {}, []
+    pages, stable, baseline = 0, False, None
+    for round_number in range(3):
+        baseline_pages = {}
+        next_url, first, complete, seen = HISTORY, None, False, set()
+        for index in range(100):
+            if next_url in seen:
+                errors.append("PAGINATION_LOOP")
+                break
+            seen.add(next_url)
+            try:
+                value = session.history(next_url)
+                current = signature(value)
+            except Exception as error:
+                if isinstance(error, suiji.Failure) and str(error) == "NEEDS_LOGIN":
+                    raise
+                errors.append(str(error) if isinstance(error, suiji.Failure) else "UNKNOWN_HISTORY_STRUCTURE")
+                break
+            baseline_pages[next_url] = current
+            pages += 1
+            if index == 0:
+                first = current
+                if baseline is None:
+                    baseline = first
+            if len(value["data"]) > 20:
+                errors.append("PAGE_LIMIT_EXCEEDED")
+                break
+            for card in value["data"]:
+                item = parse(card)
+                if options["from"] <= item["day"] <= options["to"]:
+                    observed[(item["type"], item["id"], item["occurredAt"])] = item
+            if value["paging"]["is_end"]:
+                complete = True
+                break
+            next_url = value["paging"].get("next")
+            parsed = urllib.parse.urlsplit(next_url) if isinstance(next_url, str) else None
+            if not parsed or not ALLOWED.fullmatch(next_url) or parsed.netloc != "api.zhihu.com" or urllib.parse.parse_qs(parsed.query).get("limit") != ["20"]:
+                errors.append("UNTRUSTED_PAGINATION")
+                break
+            if index == 99:
+                errors.append("PAGE_CAP_REACHED")
+        try:
+            if first is not None and signature(session.history(HISTORY)) == first:
+                stable = complete
+                break
+        except Exception:
+            errors.append("HOMEPAGE_RECHECK_FAILED")
+            break
+        if round_number == 2:
+            errors.append("HISTORY_UNSTABLE")
+    bodies, items = {}, []
+    for item in observed.values():
+        key = item["type"], item["id"]
+        if key not in bodies:
+            bodies[key] = content(session, item)
+        body, state, reason = bodies[key]
+        if reason not in (None, "unsupported-content-type", "paid-content-limited"):
+            errors.append("CONTENT_" + reason.upper().replace("-", "_"))
+        question = str(item.get("questionId") or "")
+        url = (f'https://www.zhihu.com/question/{question}/answer/{item["id"]}' if item["type"] == "answer" and re.fullmatch(r"[0-9]+", question)
+               else f'https://zhuanlan.zhihu.com/p/{item["id"]}' if item["type"] == "article" else None)
+        items.append({"observation": {"contentType": item["type"], "contentId": item["id"], "readTime": item["occurredAt"], "observedAt": captured},
+                      "entry": {"captureId": str(uuid.uuid4()), "browseDate": item["day"], "occurredAt": item["occurredAt"], "capturedAt": captured,
+                                "title": item["title"], "body": body, "userNote": "", "source": {"provider": "zhihu", "displayName": "知乎", "connectionId": config["connectionId"]},
+                                "contentType": item["type"], "captureMethod": "connector", "sourceUrl": url, "contentState": {"state": state, "reason": reason}, "attachmentIds": []}})
+    after = session.identity()
+    require(after == before, "ACCOUNT_CHANGED_DURING_RUN")
+    unchanged = False
+    try:
+        unchanged = baseline == signature(session.history(HISTORY))
+    except Exception:
+        errors.append("HISTORY_RECHECK_FAILED")
+    for url, previous in baseline_pages.items():
+        try:
+            if signature(session.history(url)) != previous:
+                unchanged = False
+        except Exception:
+            unchanged = False
+            errors.append("HISTORY_RECHECK_FAILED")
+    if not unchanged:
+        errors.append("HISTORY_CHANGED_DURING_CONTENT_READ")
+    return {"identityBefore": before, "identityAfter": after, "items": items, "historyUnchanged": unchanged,
+            "coverage": {"state": "complete" if stable and not errors else "partial", "pages": pages, "metadata": len(items),
+                         "content": sum(i["entry"]["contentState"]["state"] == "available" for i in items), "errors": list(dict.fromkeys(errors))[:200]}}

package/payload/plugins/toolkit/skills/clear-technical-explanations/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dustin Yuchen Teng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/payload/plugins/toolkit/skills/clear-technical-explanations/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: clear-technical-explanations
+description: 对中文或英文技术文本消歧和改写，让 Agent、下游系统或读者能准确理解工具描述、错误信息、操作步骤、系统提示和状态报告。用于“消除歧义”“应用 STE100”“把这段改清楚”“减少误读”等请求；不用于创意写作或营销文案。
+license: MIT
+metadata:
+  source: https://github.com/danyuchn/asd-ste100-skill/blob/32511c6992ecb5f1971e46a2943f2e6adceedafe/SKILL.md
+  adapted_for: Runweave Toolkit
+  changes: 中文化核心改写规则，按中文语法适配句长与时态表达；英文结构检查脚本未移植。
+---
+
+# 简化技术表达（ASD-STE100 启发）
+
+改写难懂或有歧义的技术文本，让读者无需询问作者也能准确理解。保留原文语言，除非用户要求翻译。目标是消除歧义，不是把文字压到最短。
+
+## 两种模式
+
+改写前选择模式。用户未指定时，按文本类型判断。默认不宣布模式。
+
+- **Strict**：操作步骤、错误信息、工具描述、Agent 间指令和误读成本高的文本。严格保持同一术语对应同一含义，一个句子只表达一个指令，执行适用的结构规则。
+- **STE-flavored**：README、PR 描述、变更记录和解释性文章。执行结构规则，词汇规则作为建议，不为了统一词汇抹掉文章的必要语气和表达。
+
+这两种模式都必须保留事实、条件、范围、例外、数字和不确定性。
+
+## 核心改写规则
+
+### 结构规则
+
+| 规则               | 做法                                                                                                                         |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
+| 主动表达           | 明确谁执行什么动作。主体确实未知或无关时，不为改成主动句而虚构主体。                                                         |
+| 一个句子一个指令   | 将连续操作拆为独立句子或步骤。条件必须紧邻它限定的动作。                                                                     |
+| 短句               | 英文操作句不超过 20 词，描述句不超过 25 词。中文按独立动作或判断拆句，不机械套用英文词数或另定字数上限。必要精度优先于句长。 |
+| 拆开分号连接的内容 | 用独立句子或步骤表达多个判断。破折号不一概禁用，但检查它是否把多个判断挤在一起。                                             |
+| 拆开长串名词       | 英文避免超过 3 词的名词堆叠。中文明确长串名词之间的关系，不强行套英文词数。固定术语和标识符保留原样。                        |
+| 不省略必要成分     | 保留读者需要的主体、动作、对象和限定。中文零主语自然且指代唯一时可以保留；有多个可能主体时明确指代。                         |
+| 保留确定程度       | “可能失败”不能改成“失败”，“可能由 X 引起”不能改成“由 X 引起”。                                                               |
+| 段落聚焦           | 每段只讨论一个主题，通常不超过 6 句。                                                                                        |
+| 步骤和条件用列表   | 3 个以上步骤或条件优先使用列表，明确先后关系及各条件对应的动作。                                                             |
+| 避免模糊短语       | 英文优先用明确的单词动词替代多义短语动词；中文把“处理一下”等模糊动作改明确，但不得猜测原文未说明的动作。                     |
+
+### 词汇规则
+
+优先使用常见、含义明确的词。Strict 模式保持同一动作和对象的名称一致；STE-flavored 模式允许不引起歧义的自然表达。
+
+- 同一概念不要交替使用多个名称，让读者误以为它们是不同对象。
+- 使用动词表达动作，例如将“进行分析”改为“分析”。名称本身是技术术语时保留。
+- 保留必要的领域术语。陌生术语可以补一行释义，但不改写 API、命令、文件路径或标识符。
+- 不机械将英文“一词一种词性”规则套到中文。判断依据是含义和指代是否明确。
+
+此技能不包含 ASD 官方词典。词汇选择是消歧建议，不是正式批准词校验，也不能据此保证 ASD-STE100 合规。
+
+### 时态与状态
+
+英文优先使用简单时态，但复合形式承载当前状态或不确定性时保留。例如不能把“may have failed”改成已确认失败。
+
+中文保留“已”“正在”“将”“尚未”等状态信息，以及“可能”“仅当”“至少”“最多”等限定。不为句子变短而删除它们。
+
+## 扫描清单
+
+逐句检查这些常见问题：
+
+1. **名称轮换**：同一对象被称为“用户”“客户”“客户端”，但没有说明是否是同一主体。
+2. **套话和限定堆叠**：删除“值得注意的是”等无信息表达，保留真正表达置信度、频率或条件的限定。
+3. **动作名词化**：用明确动词替代“进行……的处理”等绕法。
+4. **营销形容词**：删除无依据的质量夸赞，或使用原文已有的可核对数据。不能补造数据。
+5. **长句串联**：多个判断挤在一个句子里，需要按逻辑拆分。
+6. **模糊动作短语**：明确原文已经给出的动作；原文没有足够信息时指出歧义，不代替作者决定。
+
+## 改写流程
+
+1. 选择 Strict 或 STE-flavored 模式。
+2. 先读完整原文，确定改写后必须保留的意思。
+3. 逐句检查结构、词汇和扫描清单中的问题。STE-flavored 模式不强制统一所有自然用词。
+4. 改写有问题的句子，保留原文的事实、条件、范围、数值、单位、先后关系和确定程度。原文未陈述的原因、频率或机制不能补入。
+5. 对照原文核对语义。若简化会丢失精度，就保留较长表述，并按下方格式说明。
+6. 返回结果。原文已经清楚时保留原文，不为了产生改动而重写。
+
+词数、标点等结构检查不能证明改写保留了语义。
+
+## 输出格式
+
+**默认只输出改写后的文本。** 不加开场说明、模式名称、问题计数、改动总结、规则清单或结尾邀请。
+
+若刻意保留某个无法安全简化的表述，可以在正文后加一行：
+
+> 保留原表述：〔表述〕。进一步简化会丢失〔必要信息〕。
+
+没有需要说明的保留项时，不加这一行。
+
+用户要求“展示差异”“解释修改”或“列出规则”时，改为输出比较表：
+
+| 规则         | 原文                         | 改写                       |
+| ------------ | ---------------------------- | -------------------------- |
+| 动作名词化   | 请对日志进行分析。           | 请分析日志。               |
+| 保留不确定性 | 请求可能由于旧客户端而失败。 | 旧客户端可能导致请求失败。 |
+
+表后注明模式；有意保留的内容及理由用一行说明。
+
+## 边界
+
+只改善表达，不改变文本所描述的行为，不把缺乏依据的内容变成事实。保留所有条件、例外和不确定性；不能为了更短而降低精度。
+
+创意、营销或以语气和说服为目标的文字不适用此技能。没有实质内容的段落，不能仅靠改写变得有用。

package/payload/plugins/toolkit/skills/code-grounded-requirements/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: code-grounded-requirements
+description: 在已有代码库里要改动现有行为、排查「为什么现在是这样」，或需求涉及已有组件/状态/接口时使用——先把需求落到真实代码现状上，对齐现状/目标/差异，再谈方案。不要用于从零新建或纯问答。
+---
+
+# Code-Grounded Requirements
+
+把需求落到**真实代码**上再下结论，对抗「不读代码就脑补方案」。
+
+要对齐三件事：当前代码已经怎么做了 / 用户想改成什么 / 两者差在哪。
+
+## 触发边界
+
+- **触发**：改动现有行为、排查「为什么现在是这样」、需求涉及已有组件/状态/接口/链路。
+- **不触发**：全新文件从零搭建、纯问答、用户已给出明确实现指令。
+
+## 硬规则
+
+- **先读代码，再梳理需求**，不允许只凭 query 或通用经验下结论。
+- 优先读与需求最相关的真实代码：页面/组件、路由、hooks/store、服务层/API、后端接口，以及（若涉及）配置/Electron bridge/storage。
+- 排查「为什么现在这样」时，必须看完整链路：调用方 → 中间层 → 真正生效层。
+- 关键判断：能力是**已存在但链路没接上（接线/回归问题）**，还是**真的缺能力**——别把前者误判为后者。
+- 需求对齐前不进入实现。建议可以给，但必须基于代码现状。
+
+## 证据标准
+
+- 结论要带关键文件路径/模块名，且能被代码事实支撑。
+- 推测必须标注：「基于当前代码，我推测……」，不能把推测写成事实。
+
+## 输出格式
+
+按下面顺序，按需裁剪：
+
+### 当前现状
+
+基于代码说明系统现在怎么工作，给关键文件路径。
+
+### 需求理解
+
+用更精确的话重述目标，点明这次改的是行为 / 存储 / UI / 路由还是接口。
+
+### 差异与影响
+
+现状和目标差在哪（行为、数据模型、存储语义、权限、路由跳转），以及可能受影响的模块。
+
+### 建议
+
+1 个推荐方向（必要时补 1 个备选），每条说明为什么贴合当前代码——是最小修复还是结构性改造、是否复用已有接口/组件。
+
+### 待确认点
+
+只在确实需要时保留，1-3 个高价值边界问题；能从代码看出来的不要反问。
+
+默认用中文回复。

package/payload/plugins/toolkit/skills/daily-doc-maintenance/SKILL.md

@@ -0,0 +1,151 @@
+---
+name: daily-doc-maintenance
+description: 仅当用户明确要求使用 daily-doc-maintenance skill，或调度器触发“每日文档整理/文档保鲜/文档保持最新”流程时使用；用于根据最新文档与代码变更更新或删除 Runweave 文档，并强制清理 docs/plans 与 docs/review 过程材料；禁止修改代码、配置和测试；验证通过后调用 toolkit:github-pr 提交并合并 PR。
+---
+
+# 每日文档整理
+
+这个 skill 用于每天整理 Runweave 文档，让文档反映当前功能和稳定边界。它只更新或删除文档，不修改代码。
+
+“每天定时”必须由外部调度器触发，例如 GitHub Actions、launchd/cron 或团队 agent 平台。skill 本身只定义 Codex 被触发后的执行流程。
+
+## 硬边界
+
+- 只允许改 `docs/**/*.md`、`README.md` 中的文档入口、文档引用的图片/草图资产，以及本 skill 自身被明确要求更新时的 skill 文档。删除过程文档造成 `docs/testing/**/*.testplan.yaml` 中的路径或说明引用失效时，可仅修正这些引用；不得改用例行为、步骤、预期或验收门槛。
+- 禁止修改 `src/`、`server/`、`electron/`、`packages/`、`scripts/`、其他测试、配置、lockfile、构建产物。
+- 不新增前端单测、Vitest、coverage 配置；文档整理不触发前端 TDD。
+- 不因为文档发现代码问题就顺手修代码；只在最终报告里列出“代码侧待处理”。
+- 不创建长期新文档，除非用户明确要求。默认把新增或零散文档合并进已有权威文档，然后删除冗余文档。
+- `docs/plans/**` 和 `docs/review/**` 是过程材料，不上车做长期维护；每日文档整理必须清空这两个目录下的文档和资产，不能把它们作为可长期保留的例外。
+
+## 文档原则
+
+文档写当前事实和核心判断，不写实现游记。
+
+保留：
+
+- 当前功能是什么、用户怎么感知、什么时候使用。
+- 稳定架构边界、关键数据/协议契约、模块职责。
+- 重要限制、风险、运维/验证入口。
+- 必须长期保留的命令、环境变量、路由、协议字段。
+
+压缩或删除：
+
+- 文件逐行说明、函数调用流水账、临时调试过程。
+- 已完成计划中的中间步骤、commit 过程、个人执行记录。
+- `docs/plans/`、`docs/review/` 下的计划、评审、复盘、草图和截图等过程产物。
+- 与当前代码不一致的旧路径、旧命名、旧截图说明。
+- 可从代码直接读出的低价值细节，例如私有函数名、大段代码片段、局部变量解释。
+
+写法要求：
+
+- 中文优先，短段落，标题直接。
+- 先写结论和边界，再写必要细节。
+- 一个文档只承担一个主题；不要把设计、排障、部署、测试入口混在一起。
+- 需要图时只保留能帮助理解边界或流程的图，不把临时验证截图当长期文档资产。
+
+## 范围
+
+- 默认整理范围：最新 `origin/main` 从上一天 00:00 到当前的所有 commit。
+- 计算时间窗口前，先 `git fetch origin`，再用 `git rev-parse origin/main` 固定本轮基线 SHA；基于该 SHA 创建本次独立分支和 worktree，并在其中整理文档。调用方已创建本次 worktree 时，先核对它基于该 SHA；不一致时保留现场并报告，不强制重置。
+- 本地 `main` 无需更新。其他 worktree 中的 `main` 落后或有进程占用，不阻塞本轮整理；不要切换、快进或重置其他 worktree，也不要停止其进程。fetch 失败或无法核对本轮远端基线时，停止并说明原因。
+- 范围内的文档变更必须逐一检查：新增文档是否需要沉淀进权威文档，旧文档是否过时，文档入口是否需要调整。
+- 范围内的代码变更只用于判断文档是否需要更新；即使发现代码问题，本 skill 也只记录待处理项，不修改代码。
+- 如果调用方显式提供 Git range，以调用方 range 为准；fetch 后固定目标远端 base branch 的 SHA，基于该 SHA 创建本次 worktree，并确认 range 的引用可解析。仍无需更新本地 base branch。
+- 不管 range 是否覆盖，`docs/plans/**` 和 `docs/review/**` 都是本轮固定清理目标：有效结论先迁移到权威文档，随后删除这些目录下的文件。
+
+## 默认输入
+
+优先使用调用方给出的 Git range：
+
+- `base_branch`，默认 `main`。
+- `before_ref` 和 `after_ref`，或等价的 `before_ref..after_ref`。
+- 本次是否允许删除文档，默认允许删除已合并且确认冗余的文档；`docs/plans/**` 和 `docs/review/**` 不受该开关影响，始终按必删过程材料处理。
+
+如果没有明确 range：
+
+- 人工触发时，使用当前工作区 diff 和最近 24 小时提交作为近似范围，并在报告里说明这是近似。
+- 自动调度时，如果没有 range 或上次游标，不推进长期状态；只做一次性整理报告或本地文档 patch。
+
+## 工作流程
+
+1. 检查工作区。
+   - 运行 `git status --short`。
+   - 如果存在非文档改动，不覆盖、不回滚；可以读取代码判断事实，但本轮只改文档。
+   - 如果存在用户未提交的文档改动，先读清楚再继续，避免覆盖用户正在写的内容。
+
+2. 收集变更。
+   - 查看本次 range 的 `git log --oneline` 和 `git diff --name-status`。
+   - 分成三类：新增/修改文档、删除文档、代码或配置变化。
+   - 对代码变化只做“是否影响文档”的判断，不改代码。
+
+3. 建立文档地图。
+   - 先读 `docs/README.md`，确认权威入口。
+   - 按主题映射到现有文档：架构、终端、Preview、AI 协作、质量、测试、部署。
+   - `docs/plans/` 和 `docs/review/` 默认视为计划/评审过程材料，不作为当前功能权威来源；其中仍有效的结论应沉淀到 `docs/architecture/`、`docs/quality/`、`docs/testing/`、`docs/deployment/` 或其他现有权威文档。
+
+4. 判断是否需要更新。
+   - 用户可见功能、协议、路由、状态模型、验证命令、部署方式发生变化：更新权威文档。
+   - 只是内部重构且外部行为、边界、命令都没变：通常不更新文档，只在报告里说明。
+   - 新文档与已有文档重复：把核心内容合并到权威文档，删除新文档或旧冗余文档。
+   - 文档与当前代码冲突：以当前代码为准改文档；无法确认时标注为待确认，不编造。
+
+5. 执行文档整理。
+   - 优先更新已有权威文档，不新建长期文档。
+   - 更新 `docs/README.md` 的路由表，确保入口能找到当前权威文档。
+   - 清理 `docs/plans/**` 和 `docs/review/**`：先迁移仍有效的结论、验收入口、架构边界或风险判断，再删除原文件及其仅被这些文件引用的资产。
+   - 删除前搜索全仓引用；若现有测试计划指向待删文件，只修正过期引用并运行 `pnpm testplan:validate <path>`，再删除。无法保留原用例语义时停止并报告冲突。
+   - 删除文档前必须确认：核心内容已合并、没有被 `docs/README.md` 或其他文档继续引用、不是仍有价值的历史决策记录。
+   - 删除图片/草图前必须确认没有文档引用。
+
+6. 控制细节密度。
+   - 把“实现怎么写”改成“系统现在承诺什么”。
+   - 细节只保留到能支持维护者判断边界、排障或验证。
+   - 如果一个段落主要在解释某个私有函数如何串联，改写为模块职责或删除。
+
+7. 验证。
+   - 运行 `git diff --check`。
+   - 运行 `git diff --name-only`，确认只有允许的文档范围变化及上述测试计划引用修正。
+   - 运行 `find docs/plans docs/review -type f` 或等价命令，确认两个目录下不再有文件；如果目录不存在，记录为已清理。
+   - 删除文档或资产后，用 `rg` 检查仓库内没有残留链接或过期引用。
+   - 不为纯文档整理运行前端单测；只有用户要求或文档工具链需要时才补充更重验证。
+
+8. 调用 `toolkit:github-pr` 提交并合并 PR。
+   - 验证通过后调用 `toolkit:github-pr`，由该 skill 负责提交、push、创建 PR、等待门禁和合并。
+
+9. 输出结果。
+
+- 列出更新了哪些权威文档、删除了哪些冗余文档。
+- 说明哪些代码变化不需要文档更新，以及原因。
+- 列出 `toolkit:github-pr` 返回的 commit、push 分支、PR 链接和合并状态。
+- 如果发现代码和文档事实无法对齐，列出待确认问题，不修改代码。
+
+## 删除规则
+
+可以删除：
+
+- `docs/plans/**` 和 `docs/review/**` 的全部文件；这些目录只承载阶段性计划、评审、草图、截图和执行记录，不作为长期文档。
+- 已被权威文档吸收的重复文档。
+- 只记录一次性执行过程、临时方案或已过期计划的文档。
+- 指向旧架构、旧路径、旧命令且没有长期参考价值的文档。
+- 已经没有引用的文档图片或草图资产。
+
+不要删除：
+
+- `docs/README.md` 路由中仍作为入口的权威文档。
+- 仍在解释当前功能边界、协议或验证路径的文档。
+- 明确作为历史决策、复盘或设计依据保留的文档，除非用户要求清理。
+- 不确定是否仍被外部引用的公开文档；这种情况先在报告里标记。
+
+例外说明：以上“不要删除”不适用于 `docs/plans/**` 和 `docs/review/**`。如果其中内容仍有长期价值，先迁移到权威文档，再删除原过程文件；不要因为引用未迁移或价值未判断而把它们留在主线。
+
+## 最终报告格式
+
+回复保持简短，包含：
+
+- `更新`：改了哪些文档，核心变化是什么。
+- `删除`：删了哪些文档/资产，为什么可以删。
+- `未改`：哪些变更判断后不需要文档更新。
+- `验证`：实际运行的检查命令和结果。
+- `提交`：`toolkit:github-pr` 的 commit、push 分支、PR 链接和合并状态。
+- `待确认`：需要人工判断的外部事实或产品取舍。