@biaoo/tiangong-wiki 0.2.0

package/assets/templates/method.md

@@ -0,0 +1,31 @@
+---
+pageType: method
+title: Method Title
+nodeId: method-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+domain:
+effectiveness:
+applicableTo: []
+---
+
+## 方法描述
+
+先用一段完整的话解释这套方法的目标、输入、输出和基本流程。
+
+## 适用场景
+
+说明这套方法在什么问题、约束和前置条件下最值得使用。
+
+## 不适用场景
+
+写出哪些边界条件会让这套方法失效，避免未来被误用。
+
+## 使用记录
+
+记录真实使用过它的场景、结果、指标或反馈，支撑 effectiveness 的判断。

package/assets/templates/misconception.md

@@ -0,0 +1,35 @@
+---
+pageType: misconception
+title: Misconception Title
+nodeId: misconception-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+severity: medium
+resolvedAt:
+correctedConcepts: []
+---
+
+## 原来的理解（错误）
+
+准确写下当时错误的理解，不要提前替它辩护或修正。
+
+## 为什么错了
+
+说明哪条证据、哪个反例或哪个推理步骤暴露了原理解的问题。
+
+## 正确理解
+
+用清晰的语言写出现在确认正确的理解，并指出关键差异。
+
+## 转折点
+
+记录让你真正完成认知切换的瞬间、材料或实验结果。
+
+## 防止复发
+
+写下未来再次遇到相似问题时，应该用什么检查点防止重复犯错。

package/assets/templates/person.md

@@ -0,0 +1,31 @@
+---
+pageType: person
+title: Person Name
+nodeId: person-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+role:
+context:
+contact:
+---
+
+## 基本信息
+
+写清楚这个人的身份、角色、与你的关系以及为什么值得长期记录。
+
+## 共事内容
+
+说明你们在哪些项目、主题或情境中有过协作、交流或影响。
+
+## 从他/她那学到的
+
+记录这个人带来的关键认知、做事方式、提醒或可复用的经验。
+
+## 备忘
+
+写下未来互动时需要记住的事项，例如偏好、待跟进事项或联系线索。

package/assets/templates/research-note.md

@@ -0,0 +1,34 @@
+---
+pageType: research-note
+title: Research Note Title
+nodeId: research-note-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+researchTopic:
+stage:
+---
+
+## 研究问题
+
+明确写下当前真正要回答的问题，以及为什么这个问题值得继续研究。
+
+## 已读文献
+
+汇总已经读过的来源、它们分别提供了什么线索，以及哪些结论彼此冲突。
+
+## 当前理解
+
+用你自己的话总结目前的工作假设、解释框架或初步结论。
+
+## 开放问题
+
+列出尚未解决的疑点、反例、数据缺口或需要验证的推断。
+
+## 下一步
+
+说明下一轮最值得做的阅读、实验、访谈或验证动作。

package/assets/templates/resume.md

@@ -0,0 +1,34 @@
+---
+pageType: resume
+title: Resume Title
+nodeId: resume-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+targetAudience:
+lastReviewedAt:
+---
+
+## 基本信息
+
+先写出这份 resume 面向谁、主打什么定位，以及希望读者一眼记住什么。
+
+## 教育/工作背景
+
+按与你的目标最相关的顺序整理教育、工作或长期项目背景，而不是机械罗列。
+
+## 核心技能
+
+写出最能支撑当前目标 audience 的技能、能力证据和熟练程度。
+
+## 项目经历
+
+挑选最有代表性的项目，说明问题、动作、结果以及你的具体贡献。
+
+## 荣誉与成就
+
+汇总最能增强可信度的 achievement、奖项、认证或公开证明材料。

package/assets/templates/source-summary.md

@@ -0,0 +1,35 @@
+---
+pageType: source-summary
+title: Source Summary Title
+nodeId: source-summary-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+sourceType:
+vaultPath:
+keyFindings: []
+---
+
+## 来源信息
+
+交代这份来源是什么、来自哪里、为什么值得被单独消化成 wiki 页面。
+
+## 核心内容
+
+用结构化段落总结这份来源的主题、结构和主要论点，而不是只写一句话。
+
+## 关键结论
+
+列出对后续决策、学习或项目推进最重要的结论与发现。
+
+## 与已有知识的关系
+
+说明这份来源会补强、修正或挑战哪些现有 concept、method 或 lesson 页面。
+
+## 重要引用
+
+摘录最值得回看的句子、数据点、章节或页码线索，帮助以后快速回源。

package/assets/vllm/qwen3_5_openai_developer.jinja

@@ -0,0 +1,182 @@
+{#-
+Derived from the official Qwen3.5 chat template.
+Local change: normalize OpenAI "developer" messages to Qwen "system".
+-#}
+{%- set image_count = namespace(value=0) %}
+{%- set video_count = namespace(value=0) %}
+{%- set ns = namespace(
+    instruction_prefix_count=0,
+    seen_non_instruction=false,
+    multi_step_tool=true,
+    last_query_index=messages|length - 1
+) %}
+{%- macro render_content(content, do_vision_count, is_system_content=false) %}
+    {%- if content is string %}
+        {{- content }}
+    {%- elif content is iterable and content is not mapping %}
+        {%- for item in content %}
+            {%- if 'image' in item or 'image_url' in item or item.type == 'image' %}
+                {%- if is_system_content %}
+                    {{- raise_exception('System/developer message cannot contain images.') }}
+                {%- endif %}
+                {%- if do_vision_count %}
+                    {%- set image_count.value = image_count.value + 1 %}
+                {%- endif %}
+                {%- if add_vision_id %}
+                    {{- 'Picture ' ~ image_count.value ~ ': ' }}
+                {%- endif %}
+                {{- '<|vision_start|><|image_pad|><|vision_end|>' }}
+            {%- elif 'video' in item or item.type == 'video' %}
+                {%- if is_system_content %}
+                    {{- raise_exception('System/developer message cannot contain videos.') }}
+                {%- endif %}
+                {%- if do_vision_count %}
+                    {%- set video_count.value = video_count.value + 1 %}
+                {%- endif %}
+                {%- if add_vision_id %}
+                    {{- 'Video ' ~ video_count.value ~ ': ' }}
+                {%- endif %}
+                {{- '<|vision_start|><|video_pad|><|vision_end|>' }}
+            {%- elif 'text' in item %}
+                {{- item.text }}
+            {%- else %}
+                {{- raise_exception('Unexpected item type in content.') }}
+            {%- endif %}
+        {%- endfor %}
+    {%- elif content is none or content is undefined %}
+        {{- '' }}
+    {%- else %}
+        {{- raise_exception('Unexpected content type.') }}
+    {%- endif %}
+{%- endmacro %}
+{%- if not messages %}
+    {{- raise_exception('No messages provided.') }}
+{%- endif %}
+{%- for message in messages %}
+    {%- if not ns.seen_non_instruction and (message.role == 'system' or message.role == 'developer') %}
+        {%- set ns.instruction_prefix_count = ns.instruction_prefix_count + 1 %}
+    {%- else %}
+        {%- set ns.seen_non_instruction = true %}
+    {%- endif %}
+{%- endfor %}
+{%- if tools and tools is iterable and tools is not mapping %}
+    {{- '<|im_start|>system\n' }}
+    {{- "# Tools\n\nYou have access to the following functions:\n\n<tools>" }}
+    {%- for tool in tools %}
+        {{- "\n" }}
+        {{- tool | tojson }}
+    {%- endfor %}
+    {{- "\n</tools>" }}
+    {{- '\n\nIf you choose to call a function ONLY reply in the following format with NO suffix:\n\n<tool_call>\n<function=example_function_name>\n<parameter=example_parameter_1>\nvalue_1\n</parameter>\n<parameter=example_parameter_2>\nThis is the value for the second parameter\nthat can span\nmultiple lines\n</parameter>\n</function>\n</tool_call>\n\n<IMPORTANT>\nReminder:\n- Function calls MUST follow the specified format: an inner <function=...></function> block must be nested within <tool_call></tool_call> XML tags\n- Required parameters MUST be specified\n- You may provide optional reasoning for your function call in natural language BEFORE the function call, but NOT after\n- If there is no function call available, answer the question like normal with your current knowledge and do not tell the user about function calls\n</IMPORTANT>' }}
+    {%- if ns.instruction_prefix_count > 0 %}
+        {%- for instruction in messages[:ns.instruction_prefix_count] %}
+            {%- set content = render_content(instruction.content, false, true)|trim %}
+            {%- if content %}
+                {{- '\n\n' + content }}
+            {%- endif %}
+        {%- endfor %}
+    {%- endif %}
+    {{- '<|im_end|>\n' }}
+{%- else %}
+    {%- if ns.instruction_prefix_count > 0 %}
+        {{- '<|im_start|>system\n' }}
+        {%- for instruction in messages[:ns.instruction_prefix_count] %}
+            {%- set content = render_content(instruction.content, false, true)|trim %}
+            {%- if content %}
+                {%- if not loop.first %}
+                    {{- '\n\n' }}
+                {%- endif %}
+                {{- content }}
+            {%- endif %}
+        {%- endfor %}
+        {{- '<|im_end|>\n' }}
+    {%- endif %}
+{%- endif %}
+{%- for message in messages[::-1] %}
+    {%- set index = (messages|length - 1) - loop.index0 %}
+    {%- if ns.multi_step_tool and message.role == "user" %}
+        {%- set content = render_content(message.content, false)|trim %}
+        {%- if not(content.startswith('<tool_response>') and content.endswith('</tool_response>')) %}
+            {%- set ns.multi_step_tool = false %}
+            {%- set ns.last_query_index = index %}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- if ns.multi_step_tool %}
+    {{- raise_exception('No user query found in messages.') }}
+{%- endif %}
+{%- set conversation = messages[ns.instruction_prefix_count:] %}
+{%- set last_query_conv_index = ns.last_query_index - ns.instruction_prefix_count %}
+{%- for message in conversation %}
+    {%- set role = 'system' if message.role == 'developer' else message.role %}
+    {%- set content = render_content(message.content, true, role == 'system')|trim %}
+    {%- if role == "system" %}
+        {{- raise_exception('System/developer messages must appear before the first user/assistant/tool message.') }}
+    {%- elif role == "user" %}
+        {{- '<|im_start|>' + role + '\n' + content + '<|im_end|>' + '\n' }}
+    {%- elif role == "assistant" %}
+        {%- set reasoning_content = '' %}
+        {%- if message.reasoning_content is string %}
+            {%- set reasoning_content = message.reasoning_content %}
+        {%- else %}
+            {%- if '</think>' in content %}
+                {%- set reasoning_content = content.split('</think>')[0].rstrip('\n').split('<think>')[-1].lstrip('\n') %}
+                {%- set content = content.split('</think>')[-1].lstrip('\n') %}
+            {%- endif %}
+        {%- endif %}
+        {%- set reasoning_content = reasoning_content|trim %}
+        {%- if loop.index0 > last_query_conv_index %}
+            {{- '<|im_start|>' + role + '\n<think>\n' + reasoning_content + '\n</think>\n\n' + content }}
+        {%- else %}
+            {{- '<|im_start|>' + role + '\n' + content }}
+        {%- endif %}
+        {%- if message.tool_calls and message.tool_calls is iterable and message.tool_calls is not mapping %}
+            {%- for tool_call in message.tool_calls %}
+                {%- if tool_call.function is defined %}
+                    {%- set tool_call = tool_call.function %}
+                {%- endif %}
+                {%- if loop.first %}
+                    {%- if content|trim %}
+                        {{- '\n\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                    {%- else %}
+                        {{- '<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                    {%- endif %}
+                {%- else %}
+                    {{- '\n<tool_call>\n<function=' + tool_call.name + '>\n' }}
+                {%- endif %}
+                {%- if tool_call.arguments is defined %}
+                    {%- for args_name, args_value in tool_call.arguments|items %}
+                        {{- '<parameter=' + args_name + '>\n' }}
+                        {%- set args_value = args_value | tojson | safe if args_value is mapping or (args_value is sequence and args_value is not string) else args_value | string %}
+                        {{- args_value }}
+                        {{- '\n</parameter>\n' }}
+                    {%- endfor %}
+                {%- endif %}
+                {{- '</function>\n</tool_call>' }}
+            {%- endfor %}
+        {%- endif %}
+        {{- '<|im_end|>\n' }}
+    {%- elif role == "tool" %}
+        {%- if loop.previtem and ('system' if loop.previtem.role == 'developer' else loop.previtem.role) != "tool" %}
+            {{- '<|im_start|>user' }}
+        {%- endif %}
+        {{- '\n<tool_response>\n' }}
+        {{- content }}
+        {{- '\n</tool_response>' }}
+        {%- if not loop.last and ('system' if loop.nextitem.role == 'developer' else loop.nextitem.role) != "tool" %}
+            {{- '<|im_end|>\n' }}
+        {%- elif loop.last %}
+            {{- '<|im_end|>\n' }}
+        {%- endif %}
+    {%- else %}
+        {{- raise_exception('Unexpected message role.') }}
+    {%- endif %}
+{%- endfor %}
+{%- if add_generation_prompt %}
+    {{- '<|im_start|>assistant\n' }}
+    {%- if enable_thinking is defined and enable_thinking is false %}
+        {{- '<think>\n\n</think>\n\n' }}
+    {%- else %}
+        {{- '<think>\n' }}
+    {%- endif %}
+{%- endif %}

package/assets/wiki.config.default.json

@@ -0,0 +1,193 @@
+{
+  "schemaVersion": 1,
+  "customColumns": {},
+  "defaultSummaryFields": [
+    "title",
+    "tags"
+  ],
+  "vaultFileTypes": [
+    "md",
+    "txt",
+    "pdf",
+    "docx",
+    "pptx",
+    "xlsx",
+    "csv",
+    "json",
+    "yaml",
+    "yml"
+  ],
+  "commonEdges": {
+    "relatedPages": {
+      "edgeType": "related",
+      "resolve": "path"
+    },
+    "sourceRefs": {
+      "edgeType": "sourced_from",
+      "resolve": "path",
+      "match": "\\.md$"
+    }
+  },
+  "templates": {
+    "concept": {
+      "file": "templates/concept.md",
+      "columns": {
+        "confidence": "text",
+        "masteryLevel": "text"
+      },
+      "edges": {
+        "prerequisites": {
+          "edgeType": "prerequisite",
+          "resolve": "nodeId"
+        }
+      },
+      "summaryFields": [
+        "confidence",
+        "masteryLevel",
+        "prerequisites"
+      ]
+    },
+    "misconception": {
+      "file": "templates/misconception.md",
+      "columns": {
+        "severity": "text",
+        "resolvedAt": "text"
+      },
+      "edges": {
+        "correctedConcepts": {
+          "edgeType": "corrects",
+          "resolve": "nodeId"
+        }
+      },
+      "summaryFields": [
+        "severity",
+        "correctedConcepts"
+      ]
+    },
+    "bridge": {
+      "file": "templates/bridge.md",
+      "columns": {
+        "fromCourse": "text",
+        "toCourse": "text",
+        "transferType": "text"
+      },
+      "edges": {
+        "fromConcepts": {
+          "edgeType": "bridges_from",
+          "resolve": "nodeId"
+        },
+        "toConcepts": {
+          "edgeType": "bridges_to",
+          "resolve": "nodeId"
+        }
+      },
+      "summaryFields": [
+        "fromCourse",
+        "toCourse",
+        "transferType"
+      ]
+    },
+    "source-summary": {
+      "file": "templates/source-summary.md",
+      "columns": {
+        "sourceType": "text",
+        "vaultPath": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "sourceType",
+        "keyFindings"
+      ]
+    },
+    "lesson": {
+      "file": "templates/lesson.md",
+      "columns": {
+        "context": "text",
+        "severity": "text",
+        "actionable": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "context",
+        "severity"
+      ]
+    },
+    "method": {
+      "file": "templates/method.md",
+      "columns": {
+        "domain": "text",
+        "effectiveness": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "domain",
+        "applicableTo",
+        "effectiveness"
+      ]
+    },
+    "person": {
+      "file": "templates/person.md",
+      "columns": {
+        "role": "text",
+        "context": "text",
+        "contact": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "role",
+        "context",
+        "contact"
+      ]
+    },
+    "achievement": {
+      "file": "templates/achievement.md",
+      "columns": {
+        "achievementType": "text",
+        "date": "text",
+        "issuer": "text",
+        "verifiable": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "achievementType",
+        "date",
+        "issuer",
+        "verifiable"
+      ]
+    },
+    "resume": {
+      "file": "templates/resume.md",
+      "columns": {
+        "targetAudience": "text",
+        "lastReviewedAt": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "targetAudience",
+        "lastReviewedAt"
+      ]
+    },
+    "research-note": {
+      "file": "templates/research-note.md",
+      "columns": {
+        "researchTopic": "text",
+        "stage": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "researchTopic",
+        "stage"
+      ]
+    },
+    "faq": {
+      "file": "templates/faq.md",
+      "columns": {
+        "frequency": "text"
+      },
+      "edges": {},
+      "summaryFields": [
+        "frequency"
+      ]
+    }
+  }
+}

package/dist/commands/check-config.js

@@ -0,0 +1,77 @@
+import path from "node:path";
+import { loadRuntimeConfig } from "../core/runtime.js";
+import { EmbeddingClient } from "../core/embedding.js";
+import { getWikiAgentStatus } from "../core/vault-processing.js";
+import { resolveTemplateFilePath } from "../core/config.js";
+import { AppError } from "../utils/errors.js";
+import { ensureTextOrJson, formatKeyValueLines, writeJson, writeText } from "../utils/output.js";
+import { pathExistsSync } from "../utils/fs.js";
+export function registerCheckConfigCommand(program) {
+    program
+        .command("check-config")
+        .description("Validate environment variables, config, templates, and optionally the embedding endpoint")
+        .option("--probe", "Probe the embedding endpoint when configured")
+        .option("--format <format>", "Output format: text or json", "text")
+        .action(async (options) => {
+        const format = ensureTextOrJson(options.format);
+        const { paths, config } = loadRuntimeConfig(process.env);
+        const embeddingClient = EmbeddingClient.fromEnv(process.env);
+        const wikiAgent = getWikiAgentStatus(process.env);
+        if (wikiAgent.enabled && wikiAgent.missing.length > 0) {
+            throw new AppError(`WIKI_AGENT_ENABLED=true but missing required settings: ${wikiAgent.missing.join(", ")}`, "config");
+        }
+        const templateChecks = Object.keys(config.templates).map((pageType) => {
+            const templatePath = resolveTemplateFilePath(config, paths.wikiRoot, pageType);
+            return {
+                pageType,
+                templatePath,
+                exists: pathExistsSync(templatePath),
+            };
+        });
+        let probe = "skipped";
+        if (options.probe && embeddingClient) {
+            await embeddingClient.probe();
+            probe = "ok";
+        }
+        else if (options.probe) {
+            probe = "not_configured";
+        }
+        const payload = {
+            wikiPath: paths.wikiPath,
+            vaultPath: paths.vaultPath,
+            dbPath: paths.dbPath,
+            configPath: paths.configPath,
+            templatesPath: paths.templatesPath,
+            configVersion: config.configVersion,
+            embeddingConfigured: embeddingClient !== null,
+            agentProcessing: wikiAgent,
+            probe,
+            templateChecks,
+        };
+        if (format === "json") {
+            writeJson(payload);
+            return;
+        }
+        writeText([
+            "tiangong-wiki check-config",
+            formatKeyValueLines({
+                wikiPath: paths.wikiPath,
+                vaultPath: paths.vaultPath,
+                dbPath: paths.dbPath,
+                configPath: paths.configPath,
+                templatesPath: paths.templatesPath,
+                embeddingConfigured: embeddingClient !== null,
+                agentEnabled: wikiAgent.enabled,
+                agentConfigured: wikiAgent.configured,
+                agentBaseUrl: wikiAgent.baseUrl ?? "",
+                agentModel: wikiAgent.model ?? "",
+                agentBatchSize: wikiAgent.batchSize,
+                agentWorkflowTimeoutSeconds: wikiAgent.workflowTimeoutSeconds,
+                agentMissing: wikiAgent.missing.join(", "),
+                probe,
+            }),
+            "",
+            ...templateChecks.map((entry) => `${entry.exists ? "OK" : "MISSING"} ${entry.pageType} -> ${path.relative(paths.wikiRoot, entry.templatePath)}`),
+        ].join("\n"));
+    });
+}

package/dist/commands/create.js

@@ -0,0 +1,32 @@
+import { executeServerBackedOperation, requestDaemonJson } from "../daemon/client.js";
+import { createPage } from "../operations/write.js";
+import { writeJson } from "../utils/output.js";
+export function registerCreateCommand(program) {
+    program
+        .command("create")
+        .description("Create a new wiki page from a registered template and index it immediately")
+        .requiredOption("--type <pageType>", "Registered pageType")
+        .requiredOption("--title <title>", "Page title")
+        .option("--node-id <nodeId>", "Optional nodeId")
+        .action(async (options) => {
+        const result = await executeServerBackedOperation({
+            kind: "write",
+            local: () => createPage(process.env, {
+                type: options.type,
+                title: options.title,
+                nodeId: options.nodeId ?? undefined,
+            }),
+            remote: (endpoint) => requestDaemonJson({
+                endpoint,
+                method: "POST",
+                path: "/create",
+                body: {
+                    type: options.type,
+                    title: options.title,
+                    nodeId: options.nodeId ?? undefined,
+                },
+            }),
+        });
+        writeJson(result);
+    });
+}