codebee 0.1.17 → 0.1.18

package/CHANGELOG.md

@@ -4,6 +4,13 @@ CodeBee 的用户可感知变更记录。发布新版时：最上面加一节，
 `<!-- relnotes:start -->…<!-- relnotes:end -->` 段（那段会被 `npm view` 的
 README 元数据带回，供老版本在「发现新版本」时展示新版更新内容）。
 
+## v0.1.18（2026-09-20）
+
+- 知识库：运行产出自动整理成可复用知识——编排者从产出材料（调研报告/文档）提炼知识条目（草稿态），人工「转正」后按任务类型+相关性自动注入同类任务的规划与评审提示词；与经验库分工（教训记「别这么做」，知识记「已知是这样」）；设置页独立「知识库」子页，搜索/状态/标签过滤+手动新建（即个人知识管理库）；事实带账龄，as_of 超 90 天注入时自动标注「可能过期」
+- 封面生成：智谱 CogView 接线（CODEBEE_IMAGE_WATERMARK=1 才保留供应商水印）；封面落运行目录，专用通道内嵌缩略图
+- 七猫发布纠偏：目标读者/分类旧数据不自洽时按官方目录反查，不再死在流程中段
+- 队列补队治理：CLI 安装/升级等管理操作也纳入启动补队与巡检（selfupgrade 除外），排队不再无人接案
+
 ## v0.1.17（2026-09-20）
 
 - 任务宪章：工作目录 .codebee/constitution.md 一次定义质量原则（代码规范/文风/测试要求），每次运行自动注入所有智能体——注入体系五层就位（宪章>圣经>模块库>经验>记忆）

package/README.md

@@ -21,10 +21,10 @@ Kimi Code、MiMo Code、Grok Build、Pi、DeepSeek Harness……），提供
 不会把你的任务内容交给任何第三方。
 
 <!-- relnotes:start -->
-### 最新版更新内容（v0.1.16）
+### 最新版更新内容（v0.1.18）
 
-- **帮助中心**：首启欢迎引导升级为多章帮助中心——快速上手 / 模型接入与绑定 / 连载创作流程 / 发布上架 / 代码任务与版本 / 自动化与技能市场 / 功能一览 / 常见问题八章全就绪；设置各子页与蜂巢、Git 工作台、作品信息等十二处「?」就地问号直达对应章节；**F1** 或设置导航、关于页、Ctrl+K 随时可重开
-- 禅道集成、扫榜选材（双源）、可分享报告页、引擎调参卡见 v0.1.15
+- 新增「知识库」：产出材料自动提炼成知识条目，转正后按任务类型自动注入规划与评审——你的个人知识管理库
+- 新增封面生成（智谱 CogView）；七猫发布分类纠偏；管理操作排队补队治理
 <!-- relnotes:end -->
 
 ---

package/app/core/knowledge.py

@@ -0,0 +1,371 @@
+# -*- coding: utf-8 -*-
+"""知识库（Knowledge）：运行产出自动整理形成的可复用知识 + 个人知识管理入口。
+
+与经验库（skills.py）的分工边界：
+  - 教训（lessons）记「别这么做」——负面规则，来源=评审暴露的问题（verdict/issues）；
+  - 知识（knowledge）记「已知是这样」——领域事实/平台规则/结论/方法论，
+    来源=run 产出材料（调研报告/文档）。两者输入源不同，提炼互不双写。
+
+质量闸门：自动提炼的条目一律落 draft（草稿态），人工「转正」后才参与注入——
+垃圾知识进了提示词比没有知识更糟；手动新建即视为已确认（直接 approved）。
+
+注入纪律（与教训反着来）：教训是全量小注（top-8），知识默认不注入——
+scope 命中且库里有 approved 条目才成块，按与任务目标的相关性取 top，
+独立预算截断（KNOWLEDGE_BUDGET），绝不挤占经验包/圣经的空间。
+选择依据在单次注入内恒定（goal 固定、id 唯一），同一任务字节稳定，
+不碎供应商前缀缓存。
+
+事实会过期：竞品/平台类知识每条带 as_of（事实采集日），超过 STALE_DAYS
+注入时自动标注「可能过期」，提示模型自行核实时效。
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import threading
+import time
+from pathlib import Path
+
+from . import paths, skills
+
+_LOCK = threading.RLock()
+_FILE = paths.DATA_DIR / "knowledge.json"
+
+KNOWLEDGE_BUDGET = 3000     # 注入块字符预算（独立于经验包的 MAX_INJECT_CHARS）
+KNOWLEDGE_MAX_INJECT = 6    # 单次注入条数上限
+STALE_DAYS = 90             # as_of 超过该天数标注「可能过期」
+
+
+def _now():
+    return time.strftime("%Y-%m-%d %H:%M:%S")
+
+
+def _load():
+    try:
+        return json.loads(_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+
+
+def _save(data):
+    try:
+        _FILE.parent.mkdir(parents=True, exist_ok=True)
+        _FILE.write_text(json.dumps(data, ensure_ascii=False, indent=1),
+                         encoding="utf-8")
+    except Exception:
+        pass
+
+
+def _entry_id(scope, title):
+    """去重指纹：scope + 归一化标题（沿用教训库的 _norm_title 标点剥离）。"""
+    h = hashlib.sha256(("%s|%s" % (scope, skills._norm_title(title)))
+                       .encode("utf-8")).hexdigest()[:12]
+    return "kb-" + h
+
+
+def list_entries(scope=None, status=None, tag=None, only_enabled=False):
+    with _LOCK:
+        items = list(_load().get("entries") or [])
+    if scope:
+        items = [x for x in items if x.get("scope") in (scope, "*")]
+    if status:
+        items = [x for x in items if (x.get("status") or "draft") == status]
+    if tag:
+        items = [x for x in items if tag in (x.get("tags") or [])]
+    if only_enabled:
+        items = [x for x in items if x.get("enabled", True)]
+    items.sort(key=lambda x: (x.get("updated_at") or x.get("created_at") or ""),
+               reverse=True)
+    return items
+
+
+def upsert_entry(scope, title, body, tags=None, source="", source_file="",
+                 as_of=None, status="draft"):
+    """写入/合并一条知识。同 scope 同标题视为同一条（指纹去重）：
+    - 已有条目是 approved 且新条是 draft：不覆盖正文（人工确认过的内容优先），
+      新内容记入 revisions 作为修订候选，seen+1；
+    - 其余情况（已有是 draft，或新条是 approved）：正文取新。
+    返回条目；title/body 为空返回 None。"""
+    title = str(title or "").strip()[:80]
+    body = str(body or "").strip()[:1500]
+    if not title or not body:
+        return None
+    tags = [str(t).strip()[:20] for t in (tags or []) if str(t).strip()][:6]
+    status = status if status in ("draft", "approved") else "draft"
+    scope = str(scope or "*").strip() or "*"
+    kid = _entry_id(scope, title)
+    with _LOCK:
+        data = _load()
+        items = data.setdefault("entries", [])
+        for it in items:
+            if it.get("id") != kid:
+                continue
+            it["seen"] = int(it.get("seen") or 1) + 1
+            if status == "approved" or it.get("status") != "approved":
+                it["body"] = body
+                if status == "approved":
+                    it["status"] = "approved"
+            else:
+                it.setdefault("revisions", []).append(
+                    {"at": _now(), "body": body, "source": source})
+                it["revisions"] = it["revisions"][-5:]   # 最多留 5 条修订候选
+            for tg in tags:
+                if tg not in (it.get("tags") or []):
+                    it["tags"] = (it.get("tags") or []) + [tg]
+            it["tags"] = (it.get("tags") or [])[:8]
+            if as_of:
+                it["as_of"] = str(as_of)[:10]
+            if source:
+                it["source"] = source
+            if source_file:
+                it["source_file"] = source_file
+            it["updated_at"] = _now()
+            _save(data)
+            return it
+        it = {"id": kid, "scope": scope, "title": title, "body": body,
+              "tags": tags, "status": status, "enabled": True,
+              "source": source, "source_file": source_file,
+              "as_of": str(as_of or _now()[:10])[:10],
+              "revisions": [], "hits": 0, "seen": 1,
+              "created_at": _now(), "updated_at": _now(), "kind": "knowledge"}
+        items.append(it)
+        _save(data)
+        return it
+
+
+def entry_op(entry_id, op, fields=None):
+    """新建/编辑/转正/启停/删除。返回错误或 None。
+
+    create：手动新建直接 approved（人工录入即确认）；edit：改标题/正文/标签/
+    范围/账龄，不改状态——转正必须显式走 approve，保持人工闸门。
+    """
+    if op not in ("create", "edit", "approve", "enable", "disable", "delete"):
+        return "未知操作 " + str(op)
+    if op == "create":
+        f = fields or {}
+        it = upsert_entry(f.get("scope") or "*", f.get("title") or "",
+                          f.get("body") or "", tags=f.get("tags"),
+                          as_of=(f.get("as_of") or "").strip() or None,
+                          status="approved")
+        return None if it else "标题与正文不能为空"
+    with _LOCK:
+        data = _load()
+        items = data.get("entries") or []
+        hit = next((x for x in items if x.get("id") == entry_id), None)
+        if not hit:
+            return "知识条目不存在"
+        if op == "delete":
+            data["entries"] = [x for x in items if x.get("id") != entry_id]
+        elif op == "approve":
+            hit["status"] = "approved"
+            hit["updated_at"] = _now()
+        elif op == "edit":
+            f = fields or {}
+            if str(f.get("title") or "").strip():
+                hit["title"] = str(f["title"]).strip()[:80]
+            if str(f.get("body") or "").strip():
+                hit["body"] = str(f["body"]).strip()[:1500]
+            if "tags" in f:
+                hit["tags"] = [str(t).strip()[:20]
+                               for t in (f.get("tags") or []) if str(t).strip()][:8]
+            if str(f.get("scope") or "").strip():
+                hit["scope"] = str(f["scope"]).strip()[:30]
+            if str(f.get("as_of") or "").strip():
+                hit["as_of"] = str(f["as_of"]).strip()[:10]
+            hit["updated_at"] = _now()
+        else:
+            hit["enabled"] = (op == "enable")
+        _save(data)
+    return None
+
+
+def _is_stale(as_of):
+    try:
+        d = time.strptime(str(as_of or "")[:10], "%Y-%m-%d")
+        return (time.mktime(time.localtime()) - time.mktime(d)) / 86400.0 > STALE_DAYS
+    except Exception:
+        return False
+
+
+def block_for(task):
+    """生成注入提示词的知识块。默认不注入：scope 命中且存在 approved 条目才成块，
+    按与任务目标/上下文的相关性取 top（复用教训库的 bigram 检索），独立预算截断。
+    无命中返回 ""——字节稳定，不碎供应商前缀缓存。"""
+    scope = (task or {}).get("type") or "*"
+    entries = [x for x in list_entries(scope, only_enabled=True)
+               if (x.get("status") or "draft") == "approved"]
+    if not entries:
+        return ""
+    probe = (skills._text_bigrams((task or {}).get("goal"))
+             | skills._text_bigrams((task or {}).get("context"))
+             | skills._text_bigrams((task or {}).get("title")))
+    if probe:
+        def rank(x):
+            grams = (skills._text_bigrams(x.get("title"))
+                     | skills._text_bigrams(x.get("body"))
+                     | set(x.get("tags") or []))
+            return (-len(probe & grams), x.get("id") or "")
+        entries = sorted(entries, key=rank)
+    else:
+        entries.sort(key=lambda x: x.get("id") or "")
+    entries = entries[:KNOWLEDGE_MAX_INJECT]
+
+    lines, used = [], []
+    for x in entries:
+        stale = _is_stale(x.get("as_of"))
+        mark = ("（事实截至 %s，可能过期，请自行核实时效）" % x.get("as_of") if stale
+                else ("（事实截至 %s）" % x.get("as_of") if x.get("as_of") else ""))
+        lines.append("- **%s**%s：%s" % (x["title"], mark, x["body"]))
+        used.append(x["id"])
+    text = "## 知识库（已确认的领域知识，供参考）\n\n" + "\n".join(lines)
+    if len(text) > KNOWLEDGE_BUDGET:
+        text = text[:KNOWLEDGE_BUDGET] + "\n…（已截断）"
+    if used:
+        _bump_hits(used)
+    return text
+
+
+def _bump_hits(ids):
+    with _LOCK:
+        data = _load()
+        dirty = False
+        for it in (data.get("entries") or []):
+            if it.get("id") in ids:
+                it["hits"] = int(it.get("hits") or 0) + 1
+                dirty = True
+        if dirty:
+            _save(data)
+
+
+# ---------------------------------------------------------------- 自动整理
+
+KNOWLEDGE_PROMPT = """你是编排系统的知识管理员。下面是一次任务的目标与它的产出材料（调研报告/文档等）。
+请从产出中提炼**可长期复用的知识条目**：领域事实、平台规则、结论、方法论。
+注意：只提炼事实性/结论性内容；「下次要避免什么」这类负面教训由另一个复盘流程负责，你不要写。
+只输出一个 ```json 代码块，不要输出其他内容。JSON 结构：
+{"entries": [{"title": "≤20 字的知识标题", "body": "具体结论（≤200 字，自含上下文，脱离本次任务也能看懂）", "tags": ["1-3 个检索标签"], "as_of": "YYYY-MM-DD（事实采集日）"}]}
+最多 3 条，只保留有明确复用价值的；产出里没有值得沉淀的就返回空数组。
+
+## 任务类型
+__TYPE__
+
+## 任务目标
+__GOAL__
+
+## 产出材料（节选）
+__MATERIAL__"""
+
+
+def _read_text(p):
+    """产物读取：utf-8 严格优先，GBK 兜底（codex/pwsh 落盘编码不一）。"""
+    try:
+        return p.read_text(encoding="utf-8")
+    except Exception:
+        try:
+            return p.read_text(encoding="gbk", errors="replace")
+        except Exception:
+            return ""
+
+
+def _pick_material(run):
+    """挑本次 run 的产出材料喂给编排者：最近的 .md/.txt 文档各截 4000 字，
+    外加运行目录里的评审报告。总量封顶 10000 字。"""
+    from . import store
+    try:
+        wd, files = store.run_artifacts(run.get("id"))
+    except Exception:
+        return ""
+    chunks = []
+    try:
+        rp = paths.RUNS_DIR / (run.get("id") or "") / "report.md"
+        if rp.is_file():
+            t = _read_text(rp)
+            if t.strip():
+                chunks.append("### 评审报告（节选）\n" + t[:4000])
+    except Exception:
+        pass
+    docs = [f for f in (files or [])
+            if str(f.get("name", "")).lower().endswith((".md", ".txt"))
+            and int(f.get("size") or 0) < 500_000]
+    for f in docs[:3]:
+        t = _read_text(Path(wd) / f["name"])
+        if t.strip():
+            chunks.append("### " + f["name"] + "\n" + t[:4000])
+    return "\n\n".join(chunks)[:10000]
+
+
+def learn_from_run(run_id):
+    """运行结束后由编排者从产出材料提炼知识条目（草稿态）。返回写入条数。
+
+    知识没有便宜的兜底路径：无编排者/无产出/非真实运行（mock）一律静默跳过，
+    宁缺毋滥——教训库的规则兜底搬到这里只会制造垃圾知识。
+    """
+    from . import store
+    run = store.get_run(run_id)
+    if not run:
+        return 0
+    task = store.get_task(run.get("task_id")) if run.get("task_id") else None
+    if not task:
+        return 0
+    if all((s.get("agent") or "").startswith("mock") for s in (run.get("steps") or [])):
+        return 0
+    material = _pick_material(run)
+    if not material:
+        return 0
+    n = 0
+    try:
+        from . import modelhub, runner
+        orch = modelhub.resolve_orchestrator()
+        if not orch:
+            return 0
+        prov, model = orch
+        prompt = (KNOWLEDGE_PROMPT
+                  .replace("__TYPE__", str(task.get("type")))
+                  .replace("__GOAL__", (task.get("goal") or "")[:600])
+                  .replace("__MATERIAL__", material))
+        res = modelhub.chat(prov["id"], model, prompt, max_tokens=4000, timeout=300)
+        if not res.get("ok"):
+            return 0
+        data = runner.extract_json(res.get("text") or "")
+        raw = (data or {}).get("entries") if isinstance(data, dict) else None
+        if not isinstance(raw, list):
+            return 0
+        for x in raw[:3]:
+            if not (isinstance(x, dict) and x.get("title") and x.get("body")):
+                continue
+            as_of = str(x.get("as_of") or "").strip()
+            if not re.match(r"^\d{4}-\d{2}-\d{2}$", as_of):
+                as_of = _now()[:10]
+            if upsert_entry(task.get("type") or "*", x["title"], x["body"],
+                            tags=x.get("tags"), source=run_id,
+                            as_of=as_of, status="draft"):
+                n += 1
+    except Exception:
+        return n
+    return n
+
+
+def learn_async(run_id):
+    """异步提炼（不阻塞任务收尾，与教训沉淀同款语义）。"""
+    def _run():
+        try:
+            learn_from_run(run_id)
+        except Exception:
+            pass
+    threading.Thread(target=_run, name="kb-learn", daemon=True).start()
+
+
+def view():
+    """知识库总览（给 UI/API）：条目 + 标签聚合 + 草稿数 + 账龄标记。"""
+    entries = list_entries()
+    tags, drafts = {}, 0
+    for x in entries:
+        for tg in (x.get("tags") or []):
+            tags[tg] = tags.get(tg, 0) + 1
+        if (x.get("status") or "draft") != "approved":
+            drafts += 1
+        x["stale"] = _is_stale(x.get("as_of"))
+    return {"entries": entries,
+            "tags": sorted(tags, key=lambda t: (-tags[t], t)),
+            "tag_counts": tags, "drafts": drafts, "total": len(entries)}

package/app/core/pipeline.py

@@ -19,7 +19,7 @@ import re
 import threading
 import time
 
-from . import aiflavor, catalog, history, jobs, manager, modelhub, mocks, paihang, planner, registry, router, runner, skills, store, usage
+from . import aiflavor, catalog, history, jobs, knowledge, manager, modelhub, mocks, paihang, planner, registry, router, runner, skills, store, usage
 from . import builtin_agent
 from . import diagnostics
 from . import paths as paths_mod
@@ -1777,6 +1777,9 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
             tpl = tpl.replace("## 待评审稿件", "%s\n\n## 待评审稿件" % sk, 1)
         if bible:
             tpl = tpl.replace("## 待评审稿件", "%s\n\n## 待评审稿件" % bible, 1)
+        kb = knowledge.block_for(task)
+        if kb:
+            tpl = tpl.replace("## 待评审稿件", "%s\n\n## 待评审稿件" % kb, 1)
         return tpl.replace("__DIMKEYS__", dimkey).replace(
             "__MANUSCRIPT__", text or "（稿件为空！）")
 
@@ -1974,6 +1977,9 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
             sk_block, _ = skills.block_for(task, stable_order=True)
             if bible:
                 sk_block = (sk_block + "\n\n" + bible) if sk_block else bible
+            kb_block = knowledge.block_for(task)
+            if kb_block:
+                sk_block = (sk_block + "\n\n" + kb_block) if sk_block else kb_block
             scope = ("本章 = 大纲第 %d 章" % i) if start == 1 else (
                 "本批为第 %d–%d 章，下列按全书章号列出各章要点" % (start, end))
 
@@ -3190,3 +3196,8 @@ def execute_run(run_id):
                 skills.learn_async(run_id)
         except Exception:
             pass
+        # 知识库闭环：从产出材料提炼可复用知识条目（草稿态，人工转正后参与注入）
+        try:
+            knowledge.learn_async(run_id)
+        except Exception:
+            pass

package/app/main.py

@@ -233,6 +233,9 @@ class Handler(BaseHTTPRequestHandler):
             if path == "/api/skills":
                 from core import skills
                 return self._json(200, skills.view())
+            if path == "/api/knowledge":
+                from core import knowledge
+                return self._json(200, knowledge.view())
             if path == "/api/settings":
                 return self._json(200, dict(settings.load(), **jobs.workers_info()))
             if path == "/api/settings-v2":
@@ -835,6 +838,16 @@ class Handler(BaseHTTPRequestHandler):
             from core import skills
             n = skills.learn_from_run((self._body().get("run_id") or ""))
             return self._json(200, {"ok": True, "learned": n})
+        if path == "/api/knowledge/op":
+            from core import knowledge
+            body = self._body()
+            err = knowledge.entry_op(body.get("id") or "", body.get("op") or "",
+                                     fields=body.get("fields"))
+            return self._json(400, {"error": err}) if err else self._json(200, {"ok": True})
+        if path == "/api/knowledge/learn":
+            from core import knowledge
+            n = knowledge.learn_from_run((self._body().get("run_id") or ""))
+            return self._json(200, {"ok": True, "learned": n})
         m = re.match(r"^/api/flows/([^/]+)/reset$", path)
         if m:
             err = flows.reset_flow(m.group(1))

package/app/ui/app.js

@@ -7522,6 +7522,126 @@ async function skillLessonOp(id, op) {
   loadSkills();
 }
 
+/* ---------------------------------------------------------- 知识库 */
+/* 运行产出自动提炼（草稿→人工转正）+ 手动新建的个人知识库；
+ * 进页拉一次，操作后重拉，搜索/状态/标签过滤全在客户端。 */
+let KB = { data: null, q: "", tag: "", status: "" };
+
+async function loadKnowledge() {
+  try { KB.data = await api("/api/knowledge"); } catch (e) { KB.data = null; }
+  renderKnowledge();
+}
+
+function renderKnowledge() {
+  const box = $("kb-cards");
+  if (!box || !KB.data) return;
+  const entries = KB.data.entries || [];
+  // 状态 chips：全部 / 草稿 / 已转正（转正=人工确认过、参与注入）
+  const stBox = $("kb-status-chips");
+  if (stBox) {
+    const cnt = (s) => s ? entries.filter((x) => (x.status || "draft") === s).length : entries.length;
+    stBox.innerHTML = [["", "全部"], ["draft", "草稿"], ["approved", "已转正"]].map((p) =>
+      '<button class="cat-chip' + (KB.status === p[0] ? " active" : "") + '" onclick="kbSetFilter(\'status\',\'' + p[0] + '\')">' +
+      esc(t(p[1])) + "<b>" + cnt(p[0]) + "</b></button>").join("");
+  }
+  const tags = KB.data.tags || [];
+  const tagBox = $("kb-tag-chips");
+  if (tagBox) {
+    tagBox.innerHTML = tags.length
+      ? '<button class="cat-chip' + (!KB.tag ? " active" : "") + '" onclick="kbSetFilter(\'tag\',\'\')">' + esc(t("全部标签")) + "</button>" +
+        tags.map((tg) => '<button class="cat-chip' + (KB.tag === tg ? " active" : "") +
+          '" onclick="kbSetFilter(\'tag\',\'' + esc(tg) + '\')">' + esc(tg) + "<b>" + (KB.data.tag_counts[tg] || 0) + "</b></button>").join("")
+      : "";
+  }
+  let shown = entries;
+  if (KB.status) shown = shown.filter((x) => (x.status || "draft") === KB.status);
+  if (KB.tag) shown = shown.filter((x) => (x.tags || []).includes(KB.tag));
+  if (KB.q) shown = shown.filter((x) =>
+    (x.title || "").toLowerCase().includes(KB.q) || (x.body || "").toLowerCase().includes(KB.q) ||
+    (x.tags || []).some((tg) => tg.toLowerCase().includes(KB.q)));
+  const cnt = $("kb-count");
+  if (cnt) cnt.textContent = shown.length ? shown.length + t(" / 共 ") + entries.length + t(" 条") : t("（暂无）");
+  box.innerHTML = shown.map(kbCard).join("") ||
+    '<div class="empty">' + t("还没有知识条目——完成一次产出型任务后自动提炼（草稿态待转正），也可以点右上角手动新建。") + "</div>";
+}
+
+function kbCard(x) {
+  const draft = (x.status || "draft") !== "approved";
+  return '<div class="card' + (x.enabled === false ? " off" : "") + '" data-kb-id="' + esc(x.id) + '"><div class="head">' +
+    '<span class="name">' + esc(x.title) + "</span>" +
+    (draft ? '<span class="tag warn">' + esc(t("草稿")) + "</span>" : '<span class="tag ok">' + esc(t("已转正")) + "</span>") +
+    (x.stale ? '<span class="tag" title="' + esc(t("事实较旧，注入时会标注可能过期")) + '">' + esc(t("可能过期")) + "</span>" : "") +
+    '<span class="tag">' + esc(x.scope === "*" ? t("通用") : x.scope) + "</span>" +
+    (x.tags || []).map((tg) => '<span class="tag" onclick="kbSetFilter(\'tag\',\'' + esc(tg) + '\')" title="' + esc(t("只看该标签")) + '">' + esc(tg) + "</span>").join("") +
+    (x.seen > 1 ? '<span class="tag">' + t("出现 ") + x.seen + t(" 次") + "</span>" : "") +
+    (x.hits ? '<span class="tag">' + t("已注入 ") + x.hits + t(" 次") + "</span>" : "") +
+    (x.enabled === false ? '<span class="tag">' + t("已停用") + "</span>" : "") + "</div>" +
+    '<div class="note">' + esc(x.body) + "</div>" +
+    '<div class="facts">' + (x.as_of ? t("事实截至 ") + esc(x.as_of) : "") +
+    (x.source ? (x.as_of ? " · " : "") + '<a href="#" onclick="openRun(\'' + esc(x.source) + '\');return false">' + t("来源运行") + "</a>" : "") + "</div>" +
+    '<div class="ops">' +
+    (draft ? '<button class="ghost small" onclick="kbOp(\'' + esc(x.id) + '\', \'approve\')">' + t("转正") + "</button>" : "") +
+    '<button class="ghost small" onclick="kbEditOpen(\'' + esc(x.id) + '\')">' + t("编辑") + "</button>" +
+    '<button class="ghost small" onclick="kbOp(\'' + esc(x.id) + '\', \'' + (x.enabled === false ? "enable" : "disable") + '\')">' + (x.enabled === false ? t("启用") : t("停用")) + "</button>" +
+    '<button class="danger small" onclick="kbOp(\'' + esc(x.id) + '\', \'delete\')">' + t("删除") + "</button>" +
+    "</div></div>";
+}
+
+function kbSetFilter(k, v) {
+  KB[k] = v || "";
+  renderKnowledge();   // 客户端过滤，无需重拉
+}
+
+function kbSearch(v) {
+  KB.q = String(v || "").trim().toLowerCase();
+  renderKnowledge();
+}
+
+async function kbOp(id, op) {
+  if (op === "delete" && !await uiConfirm(t("删除这条知识？转正条目不再注入，删除后不可恢复。"), { ok: t("删除"), danger: true })) return;
+  try { await api("/api/knowledge/op", { method: "POST", body: JSON.stringify({ id, op }) }); }
+  catch (e) { toast(e.message, true); return; }
+  loadKnowledge();
+}
+
+function kbFormOpen(x) {   // x 为空 = 新建（保存即转正），否则编辑（不改状态）
+  const isNew = !x;
+  openModal(isNew ? t("新建知识条目") : t("编辑知识条目"),
+    '<div class="form">' +
+    '<div class="field"><label>' + t("标题") + ' <span class="req">*</span></label><input id="kb-f-title" value="' + esc(x ? x.title || "" : "") + '"></div>' +
+    '<div class="field"><label>' + t("正文") + ' <span class="req">*</span></label><textarea id="kb-f-body" rows="5">' + esc(x ? x.body || "" : "") + "</textarea></div>" +
+    '<div class="grid-2">' +
+    '<div class="field"><label>' + t("标签（逗号分隔）") + '</label><input id="kb-f-tags" value="' + esc((x ? x.tags || [] : []).join(", ")) + '" data-i18n-ph="例：番茄, 签约" placeholder="例：番茄, 签约"></div>' +
+    '<div class="field"><label>' + t("事实截至") + '</label><input id="kb-f-asof" value="' + esc(x ? x.as_of || "" : "") + '" placeholder="YYYY-MM-DD"></div>' +
+    "</div>" +
+    '<div class="field"><label>' + t("适用范围（任务类型，* 为通用）") + '</label><input id="kb-f-scope" value="' + esc(x ? x.scope || "*" : "*") + '" placeholder="novel / serial_novel / code / *"></div>' +
+    "</div>",
+    '<button class="ghost" onclick="closeModal()">' + t("取消") + "</button>" +
+    '<button onclick="kbFormSave(' + (isNew ? "" : "'" + esc(x.id) + "'") + ')">' + t("保存") + "</button>");
+}
+
+async function kbFormSave(id) {
+  const fields = {
+    title: $("kb-f-title").value.trim(),
+    body: $("kb-f-body").value.trim(),
+    tags: $("kb-f-tags").value.split(/[,，]/).map((s) => s.trim()).filter(Boolean),
+    scope: $("kb-f-scope").value.trim() || "*",
+    as_of: $("kb-f-asof").value.trim(),
+  };
+  if (!fields.title || !fields.body) { toast(t("标题与正文不能为空"), true); return; }
+  try {
+    await api("/api/knowledge/op", { method: "POST", body: JSON.stringify(id
+      ? { id, op: "edit", fields }
+      : { op: "create", fields }) });
+  } catch (e) { toast(e.message, true); return; }
+  closeModal();
+  loadKnowledge();
+}
+
+function kbEditOpen(id) {
+  kbFormOpen((KB.data && KB.data.entries || []).find((x) => x.id === id));
+}
+
 /* ---------------------------------------------------------- 自动化（定时任务） */
 /* 进页拉一次 + 每次操作后重拉 + 页面可见时每 8s 轮询（离页停表）。
  * 后端 /api/automation → {tasks, templates}；任务/模板操作走子路径。 */
@@ -8928,7 +9048,7 @@ async function suStartupCheck() {
 }
 
 /* ---------------------------------------------------------- 页签 & 初始化 */
-const TAB_TITLES = { tasks: "任务", runs: "运行记录", automation: "自动化", zentao: "禅道 Bug 自动修复", usage: "用量统计", agents: "智能体管理", models: "模型接入", bindings: "CLI 绑定", skills: "经验库", market: "插件市场", orch: "编排设置", appearance: "皮肤", about: "关于与更新" };
+const TAB_TITLES = { tasks: "任务", runs: "运行记录", automation: "自动化", zentao: "禅道 Bug 自动修复", usage: "用量统计", agents: "智能体管理", models: "模型接入", bindings: "CLI 绑定", skills: "经验库", knowledge: "知识库", market: "插件市场", orch: "编排设置", appearance: "皮肤", about: "关于与更新" };
 const SET_TABS = new Set(Object.keys(TAB_TITLES));   // 设置导航里的子页（__phone 是弹框，不算）
 
 function tabTitle(name) {
@@ -9590,6 +9710,7 @@ function switchTab(name) {
   if (name === "agents") autoCheckUpdates();   // 进目录页自动查各 CLI 新版本
   if (name === "orch") { loadOrchestrator(); loadSettings(); }  // 进编排设置页拉取配置
   if (name === "skills") loadSkills();   // 进经验库页拉取沉淀
+  if (name === "knowledge") loadKnowledge();   // 进知识库页拉取条目
   if (name === "automation") { loadAutomation(); startAutoPoll(); }   // 进自动化页：拉取 + 页面可见时每 8s 轮询
   else stopAutoPoll();   // 离开自动化页（或切到别的子页）即停表
   if (name === "zentao") loadZentao();   // 进禅道页：拉配置与修复记录回填表单
@@ -10158,6 +10279,7 @@ function cmdkOps() {
     { icon: "i-calendar-days", label: t("自动化"), run: () => switchTab("automation") },
     { icon: "i-blocks", label: t("插件市场"), run: () => switchTab("market") },
     { icon: "i-book", label: t("经验库"), run: () => switchTab("skills") },
+    { icon: "i-sigma", label: t("知识库"), run: () => switchTab("knowledge") },
     { icon: "i-cpu", label: t("智能体管理"), run: () => switchTab("agents") },
     { icon: "i-chart", label: t("用量统计"), run: () => switchTab("usage") },
     { icon: "i-gear", label: t("设置"), run: () => enterSettings() },

package/app/ui/i18n.js

@@ -429,6 +429,36 @@
     "CLI 绑定": "CLI bindings",
     "编排设置": "Orchestrator",
     "经验库": "Skill library",
+    "知识库": "Knowledge base",
+    "新建条目": "New entry",
+    "运行产出自动整理成的可复用知识：": "Reusable knowledge distilled from run outputs:",
+    "自动提炼（草稿）": "auto-distilled (draft)",
+    "——每次任务结束由编排者从产出材料里提炼知识条目，你确认「转正」后才参与注入；": "— after each run the orchestrator distills knowledge entries from output material; they join prompt injection only after you approve them;",
+    "手动新建（直接转正）": "manually created (approved)",
+    "——也是你自己的知识管理库。转正条目按任务类型与相关性自动注入同类任务的规划与评审提示词。": "— doubles as your personal knowledge base. Approved entries are injected by task type and relevance into planning/review prompts of similar tasks.",
+    "搜索标题 / 正文 / 标签": "Search title / body / tags",
+    "知识条目": "Knowledge entries",
+    "全部标签": "All tags",
+    "草稿": "Draft",
+    "已转正": "Approved",
+    "转正": "Approve",
+    "可能过期": "Possibly stale",
+    "事实较旧，注入时会标注可能过期": "Fact is old; injection marks it as possibly stale",
+    "只看该标签": "Filter by tag",
+    "来源运行": "Source run",
+    "事实截至 ": "As of ",
+    "事实截至": "Fact as of",
+    "删除这条知识？转正条目不再注入，删除后不可恢复。": "Delete this entry? Approved entries stop being injected; deletion is permanent.",
+    "新建知识条目": "New knowledge entry",
+    "编辑知识条目": "Edit knowledge entry",
+    "标题": "Title",
+    "正文": "Body",
+    "标签（逗号分隔）": "Tags (comma-separated)",
+    "例：番茄, 签约": "e.g. fanqie, signing",
+    "适用范围（任务类型，* 为通用）": "Scope (task type; * = general)",
+    "标题与正文不能为空": "Title and body are required",
+    "还没有知识条目——完成一次产出型任务后自动提炼（草稿态待转正），也可以点右上角手动新建。": "No entries yet — finish an output-producing task and entries are auto-distilled (drafts awaiting approval), or create one manually.",
+    "（暂无）": "(none)",
     "皮肤": "Skins",
     "手机连接": "Phone link",
     "设置": "Settings",

package/app/ui/index.html

@@ -185,6 +185,7 @@
       <button class="set-item" data-sub="models" data-i18n="模型接入"><svg class="ico" aria-hidden="true"><use href="#i-layers"></use></svg>模型接入</button>
       <button class="set-item" data-sub="bindings" data-i18n="CLI 绑定"><svg class="ico" aria-hidden="true"><use href="#i-link"></use></svg>CLI 绑定</button>
       <button class="set-item" data-sub="skills" data-i18n="经验库"><svg class="ico" aria-hidden="true"><use href="#i-book"></use></svg>经验库</button>
+      <button class="set-item" data-sub="knowledge" data-i18n="知识库"><svg class="ico" aria-hidden="true"><use href="#i-sigma"></use></svg>知识库</button>
       <button class="set-item" data-sub="market" data-i18n="插件市场"><svg class="ico" aria-hidden="true"><use href="#i-blocks"></use></svg>插件市场</button>
       <button class="set-item" data-sub="orch" data-i18n="编排设置"><svg class="ico" aria-hidden="true"><use href="#i-workflow"></use></svg>编排设置</button>
       <div data-i18n="外观" class="set-group">外观</div>
@@ -671,6 +672,22 @@
         </div>
       </div>
 
+      <!-- 知识库：运行产出自动整理的知识条目 + 个人知识管理 -->
+      <div id="sub-knowledge" class="subpage hidden">
+        <div class="panel wide">
+          <div class="panel-head"><h2 data-i18n="知识库">知识库</h2>
+            <button class="ghost small" onclick="kbFormOpen(null)"><svg class="ico" aria-hidden="true"><use href="#i-plus"></use></svg><span data-i18n="新建条目">新建条目</span></button></div>
+          <p class="hint"><span data-i18n="运行产出自动整理成的可复用知识：">运行产出自动整理成的可复用知识：</span><b data-i18n="自动提炼（草稿）">自动提炼（草稿）</b><span data-i18n="——每次任务结束由编排者从产出材料里提炼知识条目，你确认「转正」后才参与注入；">——每次任务结束由编排者从产出材料里提炼知识条目，你确认「转正」后才参与注入；</span><b data-i18n="手动新建（直接转正）">手动新建（直接转正）</b><span data-i18n="——也是你自己的知识管理库。转正条目按任务类型与相关性自动注入同类任务的规划与评审提示词。">——也是你自己的知识管理库。转正条目按任务类型与相关性自动注入同类任务的规划与评审提示词。</span></p>
+          <div class="kb-toolbar">
+            <input id="kb-search" data-i18n-ph="搜索标题 / 正文 / 标签" placeholder="搜索标题 / 正文 / 标签" oninput="kbSearch(this.value)">
+            <div class="cat-chips" id="kb-status-chips"></div>
+          </div>
+          <div class="cat-chips" id="kb-tag-chips"></div>
+          <h3 class="sec-title"><span data-i18n="知识条目">知识条目</span> <span class="tag" id="kb-count"></span></h3>
+          <div id="kb-cards" class="cards"></div>
+        </div>
+      </div>
+
       <!-- 插件市场：经验包一键安装 + 外部生态目录 -->
       <div id="sub-market" class="subpage hidden">
       <div class="panel wide">

package/app/ui/style.css

@@ -5232,3 +5232,7 @@ body.welcome-open { overflow: hidden; }
 .hhelp:hover { color: var(--accent); border-color: var(--accent); }
 .hhelp .ico { width: 12px; height: 12px; }
 .empty a { color: var(--accent); }
+
+/* —— 知识库：工具行（搜索框 + 状态过滤 chips 同排）—— */
+.kb-toolbar { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin: 10px 0 2px; }
+.kb-toolbar input { flex: 1 1 220px; min-width: 180px; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebee",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
   "license": "MIT",
   "bin": {