codebee 0.1.16 → 0.1.18

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
@@ -82,6 +82,9 @@ def _agents():
 # 本轮运行的智能体池：execute_run 入口快照，_run_step 死链补位时扫描。
 # 直接调 _run_step 的场景（单测/内部工具）池为空 → 补位不触发，闸门语义不变。
 _CURRENT_AGENTS: list = []
+# 本次 run 的任务宪章注入块（execute_run 起跑时从 .codebee/constitution.md 读入；
+# 步骤函数在各提示词组装点引用，空串=未配置零噪音）
+_RUN_CONSTITUTION = ""
 
 
 def _dead_binding_substitute(dead_id, resume=None):
@@ -660,6 +663,11 @@ CODE_REVIEW_PROMPT = """你是代码评审员（不要修改任何文件）。
   "summary": "一句话结论"
 }
 
+## 评审要求（findings 锚定证据）
+每个 issue 的 detail 必须给出「文件名:行号」（从 diff 的 hunk 头 @@ -a,b +c,d @@ 与上下文推算），
+并引用该处一行关键代码作为依据——没有证据定位的问题不要报，宁可少报不报猜测。
+（借鉴 pr-af：findings grounded in code evidence 是评审可信度的根。）
+
 ## 任务目标
 __GOAL__
 
@@ -792,7 +800,7 @@ def _code_bestof(run, task, impl, difficulty, ev):
             agt_b = modelhub.bind_agent(impl, difficulty)
             res = None
             for i, sub in enumerate(subtasks):
-                prompt = (CODE_IMPL_PROMPT
+                prompt = (_RUN_CONSTITUTION + CODE_IMPL_PROMPT
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__", sub["detail"] if sub["detail"] else sub["title"])
                           .replace("__CONTEXT__", task.get("context") or "（无）")
@@ -941,7 +949,7 @@ def _run_code(run, task, agents, ev, stats, mode):
                         (s.get("title") or "")[:40] for s in subtasks[:i]) or "（无）"
                     prog = ("\n\n## 计划进度（第 %d/%d 项）\n已完成：%s。当前接着做下面这一项，"
                             "不要重做已完成的。" % (i + 1, len(subtasks), done_titles))
-                prompt = (CODE_IMPL_PROMPT
+                prompt = (_RUN_CONSTITUTION + CODE_IMPL_PROMPT
                           .replace("__GOAL__", task["goal"])
                           .replace("__SUBTASK__",
                                    sub["detail"] if sub["detail"] else sub["title"])
@@ -1396,10 +1404,25 @@ __GOAL__
 ## 背景与上下文
 __CONTEXT__
 
+## 评审维度（写前自查）
+__RUBRIC__
+（按这些维度组织内容重点——评审会按它们打分）
+
 ## 要求
 - 只修改 `__FILE__` 这一个文件；保持 Markdown 结构。
 - 完成后用 3 句话说明本轮写了什么。"""
 
+# 调研报告类稿件的追加要求（借鉴 gpt-researcher 迭代深研）：有网络/读文件工具时
+# 多源交叉验证，单源结论降权——调研的可信度来自证据链而非文采
+RESEARCH_APPENDIX = """
+
+## 调研要求（证据链）
+- 有联网/检索工具就先搜集资料再写：同一关键结论至少两个独立来源交叉验证，
+  单源信息要标注「仅单一来源」。
+- 引用来源在文中用行内链接或脚注标明（域名即可，不编造 URL）。
+- 区分「事实」与「观点」：数据/时间/版本号给来源，预测/评价标明是分析。
+- 结构建议：结论先行 → 分层论证 → 风险与局限（说明哪些结论证据不足）。"""
+
 NOVEL_REVISE_PROMPT = """你是一名专业作者。请根据下方汇总评审意见修订稿件文件：`__FILE__`（直接写入该文件）。文件必须以 UTF-8 编码保存（PowerShell 写文件显式加 -Encoding UTF8，禁止依赖默认编码）。
 
 ## 原始写作任务
@@ -1465,7 +1488,10 @@ def _story_bible(workdir):
     if not txt:
         return ""
     return ("## 故事圣经（story-bible.md：人物/世界观/伏笔台账，本书一切写作与评审以此为准，"
-            "与其冲突处以圣经为准）\n\n" + txt)
+            "与其冲突处以圣经为准）\n\n"
+            "**连续性锁**（借鉴 drama-skills）：人物外貌/性格口头禅/物品/能力等需要跨章一致"
+            "的设定，写作时原样沿用圣经中的表述（可整句贴入正文），不要同义改写——每章用词"
+            "一致读者才不会出戏。\n\n" + txt)
 
 
 def _plot_modules(workdir):
@@ -1733,6 +1759,10 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
     mods = _plot_modules(workdir)
     if mods:
         bible = (bible + "\n\n" + mods) if bible else mods
+    # 任务宪章（spec-kit constitution）：作者定的质量原则拼在注入块最前——
+    # 优先级最高的约束放最前面，写作者先读原则再读设定
+    if _RUN_CONSTITUTION:
+        bible = _RUN_CONSTITUTION + (bible or "")
 
 
     def crit_prompt_for(text, note=""):
@@ -1747,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 "（稿件为空！）")
 
@@ -1944,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))
 
@@ -2397,10 +2433,25 @@ def _run_serial_review(run, task, agents, ev, stats, mode, critics, impl, route,
                     fixed.append(i)
             store.update_run(run_id, chapter_scores=chapter_scores)
             _check_cancel(ev)
+        if not fixed:
+            # 最弱章重改全部失败（供应商拥堵/流断等）→ 章稿没有任何变化，
+            # 继续跑全书重评只会白烧评审链，组长步骤一挂「工作中」就是几十
+            # 分钟（2026-09-19 实案：polish-c18/c11 双败后仍进全书重评，
+            # 单个评审 35 分钟，用户侧只见打磨 2/3 久卡不动）。直接收尾。
+            store.finish_step(run_id, pstep["n"], "failed",
+                              summary="重改未成功（%s 全部失败），本轮打磨中止；"
+                                      "已落盘章稿不受影响"
+                                      % "、".join("第 %d 章" % c["chapter"] for c in weak))
+            break
         # 重评全书一致性（同一评审闭包；本轮全挂则保留上一轮结论——评审链挂了
         # 不代表书变差，不能拿「无法评审」覆盖真实分数）
-        full_text = "\n\n".join(_read_chapter(workdir, i2) for i2 in range(1, end + 1))
-        gscored2, gmeans_acc2 = run_global_round(critics)
+        try:
+            full_text = "\n\n".join(_read_chapter(workdir, i2) for i2 in range(1, end + 1))
+            gscored2, gmeans_acc2 = run_global_round(critics)
+        except BaseException:
+            store.finish_step(run_id, pstep["n"], "failed",
+                              summary="打磨后全书重评异常中止，已落盘章稿不受影响")
+            raise
         if gscored2:
             global_means = {d: round(sum(xs) / len(xs), 1) for d, xs in gmeans_acc2.items()}
             global_pass = _all_ge(global_means, threshold)
@@ -2659,13 +2710,19 @@ def _run_content_review(run, task, agents, ev, stats, mode):
         except Exception:
             pass
     else:
+        is_research = task.get("type") == "research"
+
         def _draft_prompt_for(vfile):
             p = (_tpl(task, "draft_prompt", NOVEL_DRAFT_PROMPT).replace("__FILE__", vfile)
                  .replace("__GOAL__", task["goal"])
-                 .replace("__CONTEXT__", task.get("context") or "（无）"))
+                 .replace("__CONTEXT__", task.get("context") or "（无）")
+                 .replace("__RUBRIC__", "、".join(dims) if dims else "（按流程默认维度）"))
             if outline:
                 p += "\n\n## 编排者大纲（按要点组织稿件）\n" + \
                      "\n".join("- " + i for i in outline["items"])
+            if is_research:
+                # 调研报告追加证据链要求（gpt-researcher 借鉴）
+                p += RESEARCH_APPENDIX
             return p
 
         best_of = max(1, min(3, int(task.get("best_of") or 1)))
@@ -2871,6 +2928,23 @@ def _run_serial_qa(run, task, agents, ev):
                      error="答疑失败（执行/评审链不可用）——" + "；".join(errors[-3:]))
 
 
+def _read_constitution(workdir):
+    """任务宪章（借鉴 spec-kit constitution）：工作目录 .codebee/constitution.md
+    （作者手工维护的质量原则——代码规范/文风/测试要求）。存在且非空时返回注入块，
+    每次 run 的所有智能体提示词都会带上；否则返回 ""（零配置零噪音）。"""
+    p = os.path.abspath(os.path.join(str(workdir or ""), ".codebee", "constitution.md"))
+    if not _inside(workdir, p) or not os.path.isfile(p):
+        return ""
+    try:
+        txt = _read_text_any_enc(p)[:6000].strip()
+    except OSError:
+        return ""
+    if not txt:
+        return ""
+    return ("## 项目宪章（constitution.md：本项目一切产出的质量原则，优先级最高，"
+            "与其他要求冲突时以宪章为准）\n\n" + txt + "\n\n")
+
+
 def _write_task_spec(task, workdir):
     """任务规格落盘 .codebee/spec.md（借鉴 agent-orchestrator 的 .spec/PROMPT.md 与
     planning-with-files 的文件化计划）：任务定义随工作目录留存、随任务分支版本化，
@@ -3028,6 +3102,11 @@ def execute_run(run_id):
     # 任务规格文件化（借鉴 planning-with-files/agent-orchestrator）：任何任务都在
     # 工作目录留一份 .codebee/spec.md——原始意图可见、随任务分支版本化
     _write_task_spec(task, task["workdir"])
+    # 任务宪章（借鉴 spec-kit constitution）：工作目录 .codebee/constitution.md
+    # 是作者定下的质量原则（代码规范/文风/测试要求），每次 run 注入所有智能体
+    # 提示词——代码/文章/翻译全类型通用，一次定义持续生效。缺省零噪音。
+    global _RUN_CONSTITUTION
+    _RUN_CONSTITUTION = _read_constitution(task["workdir"])
     agents = _agents()
     global _CURRENT_AGENTS
     _CURRENT_AGENTS = agents
@@ -3117,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/core/store.py

@@ -621,11 +621,23 @@ def update_run(run_id, expected_status=None, **fields):
         if expected_status is not None and run.get("status") != expected_status:
             return None
         run.update(fields)
+        # 终态收尸：run 已结束却还挂 queued/running 的步骤统一落 cancelled，
+        # 语义与 recover_orphaned_runs 的启动清扫对齐（那套清跨进程遗留，
+        # 这套在落终态瞬间即时收口——打磨组长被取消/异常打断时 UI 不闪
+        # 假「工作中」）。run 终态后不可能还有步骤在真跑。
+        st = fields.get("status")
+        if st in ("done", "failed", "cancelled"):
+            end_s = time.strftime("%H:%M:%S")
+            for s in run["steps"]:
+                if s.get("status") in ("queued", "running"):
+                    s["status"] = "cancelled"
+                    s["ended_at"] = s.get("ended_at") or end_s
+                    if not s.get("summary"):
+                        s["summary"] = "步骤未正常收尾（终态自动恢复）"
         _save_json(paths.RUNS_DIR / run_id / "run.json", run)
         # 状态回填：起跑与结束都同步任务状态。只回填终态的话，run 在跑、
         # 任务永远显示「排队中」（2026-09-18 实案：「# 重写·续」run 已 running
         # 写了一小时，任务卡 queued，用户以为卡死连点重试）。
-        st = fields.get("status")
         if st in ("running", "done", "failed", "cancelled"):
             tid = run.get("task_id")
             task = _TASKS.get(tid) if tid else None

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

@@ -1679,7 +1679,7 @@ async function openImportDialog() {
       '<input type="checkbox" value="' + esc(s.id) + '"' + (ok ? " checked" : " disabled") +
       (ok ? ' onchange="updateImportSelHint()"' : "") + ">" +
       '<div class="src-main">' +
-      '<div class="src-name">' + esc(s.name) + status + "</div>" +
+      '<div class="src-name">' + esc(t(s.name)) + status + "</div>" +
       '<div class="src-desc">' + esc(t(s.desc)) + "</div>" +
       '<div class="src-path">' + esc((s.paths || []).join("  ·  ")) + "</div>" +
       (s.note ? '<div class="src-note">' + esc(t.apply(null, [s.note].concat(s.note_args || []))) + "</div>" : "") +
@@ -3846,6 +3846,7 @@ function renderBookMetaPanel(task) {
   let html = '<div class="bm-head"><svg class="ico" aria-hidden="true"><use href="#i-idcard"/></svg>' +
     '<span class="sec-title">' + t("作品信息") + "</span>" +
     '<span class="hint">' + esc(t("按发布平台生成建书表单资料，逐字段复制过去")) + "</span>" +
+    '<button class="hhelp" data-help-topic="publish" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' +
     '<span class="flex1"></span>';
   if (taskBusy) html += '<span class="bm-warn">' + esc(t("任务运行中，生成将在本轮结束后可用")) + "</span>";
   html += "</div>";
@@ -4284,6 +4285,7 @@ function _renderGitSnapshot(run, task) {
   let html =
     '<div class="git-head"><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg>' +
     '<span class="sec-title">' + t("代码版本隔离") + '</span>' +
+    '<button class="hhelp" data-help-topic="code" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' +
     '<code class="git-branch" title="' + esc(t("任务分支：产物提交在此，原分支未受影响")) + '">' + esc(g.branch) + "</code>";
   const addT = ch.add_total, delT = ch.del_total;
   if (addT != null && delT != null) {
@@ -4379,7 +4381,8 @@ function renderGitWbMain(d, task) {
   sel += "</select>";
   let html =
     '<div class="git-head"><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg>' +
-    '<span class="sec-title">' + t("Git 工作台") + "</span>" + sel +
+    '<span class="sec-title">' + t("Git 工作台") + "</span>" +
+    '<button class="hhelp" data-help-topic="code" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' + sel +
     '<code class="git-branch" title="HEAD">' + esc(d.head || "") + "</code>" +
     (d.upstream ? '<span class="gm" title="' + esc(d.upstream) + '">↑' + (d.ahead || 0) + " ↓" + (d.behind || 0) + "</span>" : "") +
     '<span class="flex1"></span>' +
@@ -7519,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}；任务/模板操作走子路径。 */
@@ -8191,7 +8314,7 @@ function mkrCardHtml(p) {
   const meta = [p.author, p.version ? "v" + p.version : ""].filter(Boolean).join(" · ");
   return '<div class="card mk-card' + (p.compat === "blocked" ? " blocked" : "") + '"><div class="head">' +
     '<span class="name">' + esc(t(p.title || p.name)) + "</span>" +
-    '<span class="tag mk-src">' + esc(p.source_name || "") + "</span>" +
+    '<span class="tag mk-src">' + esc(t(p.source_name || "")) + "</span>" +
     (p.category ? '<span class="tag">' + esc(p.category) + "</span>" : "") +
     "</div>" +
     '<div class="note">' + esc(t(p.desc || "")) + "</div>" +
@@ -8214,7 +8337,7 @@ function renderMarketRemote() {
   if (srcSel && !srcSel.options.length) {
     srcSel.innerHTML = '<option value="">' + t("全部来源") + "</option>" +
       (data.sources || []).map((s) =>
-        '<option value="' + esc(s.id) + '">' + esc(s.name) + t("（") + s.count + t("）") + "</option>").join("");
+        '<option value="' + esc(s.id) + '">' + esc(t(s.name)) + t("（") + s.count + t("）") + "</option>").join("");
   }
   const times = (data.sources || []).map((s) => s.fetched_at).filter(Boolean);
   const meta = $("mkr-meta");
@@ -8269,7 +8392,7 @@ async function mkrRefresh() {
       const keep = srcSel.value;
       srcSel.innerHTML = '<option value="">' + t("全部来源") + "</option>" +
         (r.sources || []).map((s) =>
-          '<option value="' + esc(s.id) + '">' + esc(s.name) + t("（") + s.count + t("）") + "</option>").join("");
+          '<option value="' + esc(s.id) + '">' + esc(t(s.name)) + t("（") + s.count + t("）") + "</option>").join("");
       srcSel.value = keep;
     }
     mkrLoadPage(true);
@@ -8389,7 +8512,7 @@ async function loadSettingsV2() {
         inp = '<input id="' + iid + '" type="text" value="' + esc(String(cur)) + '">';
       }
       html += '<div class="set-v2-row">' + inp +
-        '<span class="set-v2-lb" title="' + esc(f.description || f.path) + '">' + esc(f.description || f.path) + "</span></div>";
+        '<span class="set-v2-lb" title="' + esc(t(f.description || f.path)) + '">' + esc(t(f.description || f.path)) + "</span></div>";
     }
     html += '<div class="input-row" style="margin-top:6px"><button class="ghost small" onclick="saveSettingsV2(\'' + esc(ns) + '\')">' + t("保存") + "</button>" +
       '<span class="set-v2-msg msg"></span></div></div>';
@@ -8577,6 +8700,7 @@ var HELP_CHAPTERS = [
   { id: "features",   icon: "i-bee",           label: "功能一览" },
   { id: "serial",     icon: "i-book-open",     label: "连载创作流程" },
   { id: "publish",    icon: "i-clapper",       label: "发布上架" },
+  { id: "code",       icon: "i-git-branch",    label: "代码任务与版本" },
   { id: "auto",       icon: "i-calendar-days", label: "自动化与技能市场" },
   { id: "faq",        icon: "i-search",        label: "常见问题" },
 ];
@@ -8620,6 +8744,7 @@ function helpChapterBody(id) {
       '<li><svg class="ico" aria-hidden="true"><use href="#i-clapper"></use></svg><div><b>' + t("发布上架") + '</b><span>' + t("一键发布到番茄、七猫，含封面与作品资料") + '</span></div></li>' +
       '<li><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg><div><b>' + t("版本工作台") + '</b><span>' + t("任务分支隔离，改动可审可合") + '</span></div></li>' +
       '<li><svg class="ico" aria-hidden="true"><use href="#i-calendar-days"></use></svg><div><b>' + t("自动化") + '</b><span>' + t("定时任务，无人值守") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-library"></use></svg><div><b>' + t("经验库") + '</b><span>' + t("内置规范包 + 自动沉淀教训，越用越顺手") + '</span></div></li>' +
       '<li><svg class="ico" aria-hidden="true"><use href="#i-blocks"></use></svg><div><b>' + t("插件市场") + '</b><span>' + t("600+ 技能，一键安装") + '</span></div></li>' +
       '</ul>';
   }
@@ -8643,13 +8768,25 @@ function helpChapterBody(id) {
       '<h3 class="help-h3">' + t("发布失败") + '</h3>' +
       '<p class="help-p">' + t("平台改版或登录态过期会导致失败，失败信息会写明原因。重新登录后再点重试即可；反复失败可以到 GitHub 提 Issue 附上失败截图。") + '</p>';
   }
+  if (id === "code") {
+    return '<h3 class="help-h3">' + t("代码任务怎么跑") + '</h3>' +
+      '<p class="help-p">' + t("新建任务选开发类类型，目标写清楚要做什么（可以附需求文档、截图，附件会进入上下文）。蜂群先出计划再实现：实现 → 客观验证 → 跨厂商评审 → 修复，单路实现失败还有多候选赛马——各候选在隔离的 worktree 里各写各的，择优采纳。跑的过程中可以在详情页递话（文字/截图），下一轮生效。") + '</p>' +
+      '<h3 class="help-h3">' + t("任务分支隔离：你的工作区不受影响") + '</h3>' +
+      '<p class="help-p">' + t("启用代码版本隔离的任务会检出独立的任务分支（codebee/任务ID），所有改动只落在那条分支上，你当前的分支和未提交的改动完全不动——开跑前工作区有脏改动会先帮你收起（stash），跑完自动还原。") + '</p>' +
+      '<h3 class="help-h3">' + t("版本裁决：合并还是丢弃") + '</h3>' +
+      '<p class="help-p">' + t("任务跑完后，「版本」页签会亮起「待裁决」等你拍板：先看变更清单，双击文件能看 diff；满意点「合并」，任务分支合回基线分支；不满意点「丢弃」，分支和工作现场自动清场。中途停下的任务也会留好提交，可以继续跑完再裁决。合并与丢弃绝不静默替你决定。") + '</p>' +
+      '<h3 class="help-h3">' + t("哪里看细节") + '</h3>' +
+      '<p class="help-p">' + t("「蜂巢」页签看每个智能体实时在干什么（点格子看实时日志）；「步骤」页签看任务拆解、每步实际用的模型、耗时与失败原因，评审分数与打磨记录也在这里。") + '</p>';
+  }
   if (id === "auto") {
     return '<h3 class="help-h3">' + t("定时任务") + '</h3>' +
       '<p class="help-p">' + t("设置 → 自动化：把任意任务类型挂上时间表（每天/每周固定时刻），到点自动按真实运行链开跑，结果照常落盘。配合群机器人（钉钉/飞书/企微自动适配）可以把完成状态推到群里。") + '</p>' +
+      '<h3 class="help-h3">' + t("禅道 Bug 自动修复") + '</h3>' +
+      '<p class="help-p">' + t("设置 → 禅道：配好地址与产品档案后，定时扫描激活 Bug，按模块路由 / AI 排查定责（前端/后端/双端/非我方）；我方端的 Bug 自动创建代码修复任务，修完自动合并、resolve 并回写报告到群里；测试指错人的也会按排查结论改派。合并失败不 resolve 不转派，留人工兜底。") + '</p>' +
       '<h3 class="help-h3">' + t("技能市场") + '</h3>' +
       '<p class="help-p">' + t("设置 → 插件市场：600+ 技能一键安装，来源包括内置库和 ZCode、Anthropic 等多个外部目录。装上的技能会注入智能体能力，按任务类型生效。") + '</p>' +
       '<h3 class="help-h3">' + t("用量台账") + '</h3>' +
-      '<p class="help-p">' + t("设置 → 用量：每次调用的模型、token 与费用按多个维度聚合展示，历史运行会在启动时自动回填——每个任务花了多少，一目了然。") + '</p>';
+      '<p class="help-p">' + t("设置 → 用量统计：每次调用的模型、token 与费用按多个维度聚合展示，历史运行会在启动时自动回填——每个任务花了多少，一目了然。") + '</p>';
   }
   if (id === "faq") {
     return '<div class="help-qa"><b>' + t("点「获取模型列表」报 404？") + '</b><p>' + t("部分网关不提供模型列表接口，属正常现象；只要能正常对话就不用管，模型名手工填即可。") + '</p></div>' +
@@ -8690,6 +8827,12 @@ function setHelpChapter(id) {
   renderHelp();
 }
 function helpGo(id) { setHelpChapter(id); }
+function paintHelpChrome() {
+  const badge = $("welcome-badge");
+  if (badge) badge.textContent = t(helpFirst ? "首次启动" : "帮助中心");
+  const title = $("welcome-title");
+  if (title) title.textContent = t(helpFirst ? "欢迎使用 CodeBee" : "帮助中心");
+}
 function welcomeOpen(opts) {
   const w = $("welcome");
   if (!w) return;
@@ -8697,8 +8840,7 @@ function welcomeOpen(opts) {
   helpFirst = !!(opts && opts.firstRun);
   if (helpFirst) helpCur = "quickstart";
   else if (opts && opts.topic && HELP_CHAPTERS.some((c) => c.id === opts.topic)) helpCur = opts.topic;
-  const badge = $("welcome-badge");
-  if (badge) badge.textContent = t(helpFirst ? "首次启动" : "帮助中心");
+  paintHelpChrome();
   renderHelp();
   w.classList.remove("hidden");
   document.body.classList.add("welcome-open");
@@ -8906,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) {
@@ -9070,10 +9212,9 @@ function setLangBtn(lang) {
   paintArchToggle();
   syncSideExpandBtn();
   renderCodePreviews();   // 预览徽章是动态文案：语言切换时若停在皮肤页要跟着换
-  // 帮助中心若开着：徽章/目录/正文跟着换语言重画
+  // 帮助中心若开着：徽章/标题/目录/正文跟着换语言重画
   if (!$("welcome").classList.contains("hidden")) {
-    const wbadge = $("welcome-badge");
-    if (wbadge) wbadge.textContent = t(helpFirst ? "首次启动" : "帮助中心");
+    paintHelpChrome();
     renderHelp();
   }
   // 重画还在缓存里的页面标题
@@ -9554,7 +9695,7 @@ function collapseDrawerIfMobile() {
 
 function switchTab(name) {
   if (name === "__phone") { openPhoneConnect(); return; }  // 手机连接是弹框，不切页
-  if (name === "__guide") { welcomeOpen(); return; }       // 使用引导是弹层，不切页（设置导航「软件」组）
+  if (name === "__guide") { welcomeOpen(); return; }       // 帮助中心是弹层，不切页（设置导航「软件」组）
   // 导航收进「设置」：进设置后左栏整体换成设置导航，内容铺满
   S.tab = name;
   if (SET_TABS.has(name)) localStorage.setItem("orch.setTab", name);
@@ -9569,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();   // 进禅道页：拉配置与修复记录回填表单
@@ -10041,6 +10183,7 @@ document.addEventListener("DOMContentLoaded", () => {
         && e.target.tagName !== "TEXTAREA") { _askClose(true); return; }
     // 文件内容弹窗(240) 夹在 ask(250) 与 modal(200) 之间，Esc 同样逐层关
     if (e.key === "Escape" && filePopIsOpen()) { window.filePopClose(); return; }
+    if (e.key === "F1") { e.preventDefault(); welcomeOpen(); return; }   // F1 = 帮助中心（浏览器帮助被拦下）
     if (e.key === "Escape" && !$("welcome").classList.contains("hidden")) { welcomeClose(); return; }
     if (e.key === "Escape" && !$("modal").classList.contains("hidden")) closeModal();
     // 日志抽屉：Esc 收起（最底层，放在弹窗之后）
@@ -10136,10 +10279,11 @@ 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() },
-    { icon: "i-bee", label: t("使用引导"), run: () => welcomeOpen() },
+    { icon: "i-bee", label: t("帮助中心"), run: () => welcomeOpen() },
     { icon: "i-phone", label: t("手机连接"), run: () => switchTab("__phone") },
   ];
 }