@itradingai/aiwiki 0.2.5 → 0.2.7

package/README.md

@@ -1,9 +1,19 @@
+![AIWiki 宣传图](docs/assets/aiwiki-hero.png)
+
 # AIWiki
 
 AIWiki 是一个面向宿主 Agent 的本地知识库生产 CLI。用户把文章链接或正文发给 Codex、QClaw、OpenClaw、Claude Code 等 Agent，并使用“入库”触发词；宿主 Agent 负责读取网页或上下文，AIWiki 负责把内容写入本地知识库，并生成适合 Obsidian + Dataview 审阅的资料结构。
 
 AIWiki 的重点不是替代 Agent 抓网页，而是把 Agent 已经读到的内容稳定沉淀为可追踪、可复盘、可继续写作的本地知识库。
 
+## 最新动态
+
+- `2026-05-09`：完成 npm 公开发布准备，补齐发布前的 README 与交付信息，并让 CLI 版本号与 `package.json` / 发布包保持一致，便于安装、排查与版本确认。
+- `2026-05-08`：完成中文化体验收口，包括默认生成中文 prompt、中文状态输出、中文目标描述，以及 README 和使用文档的中文本地化。
+- `2026-05-08`：强化 Obsidian 工作流，把 Review Queue、Claims Review 等审阅队列提升为一等入口，方便在知识库里持续审阅和回看入库内容。
+- `2026-05-07`：新增 Codex skill 安装能力，并补上 Agent 协议安装引导，让宿主 Agent 在正式入库前更容易完成对接。
+- `2026-05-07`：持续打磨初始化体验，修复 setup 提示问题，避免静默套用默认值，并把首次使用流程改成交互式引导。
+
 ## 安装与初始化
 
 一次性运行交互式 setup：
@@ -35,6 +45,34 @@ npm install -g @itradingai/aiwiki@latest
 
 要求 Node.js `>=20`。
 
+## 直接发给 AI 帮你安装
+
+如果你希望让 Codex、Claude Code、QClaw、OpenClaw 等 AI 直接帮你完成安装和配置，可以把下面这段话原样发给它，注意修改下你的知识库路径：
+
+```text
+请帮我安装并配置 AIWiki。
+
+要求：
+1. 先检查本机 Node.js 是否满足 >=20。
+2. 如果还没安装 AIWiki，就安装最新版 `@itradingai/aiwiki`。
+3. 执行 `aiwiki setup`，帮我完成知识库初始化；把知识库路径设为 `F:\knowledge_data\aiwiki`。
+4. 执行 `aiwiki agent list` 检查当前环境支持哪些宿主 Agent。
+5. 优先为当前 AI/Agent 安装 AIWiki 对接；如果能自动安装，就执行 `aiwiki agent install` 或对应的 `--agent` 命令。
+6. 如果当前 Agent 不支持自动安装，就执行 `aiwiki prompt agent`，然后把生成的对接协议整理好，告诉我应该粘贴到哪里。
+7. 完成后，再执行 `aiwiki doctor` 和 `aiwiki status`，确认安装和配置是否正常。
+8. 最后告诉我：
+   - 实际执行了哪些命令
+   - 知识库路径是什么
+   - Agent 对接是否完成
+   - 如果还差手动步骤，明确告诉我下一步怎么做
+```
+
+如果你已经确定知识库路径，也可以把上面第 3 步改成直接执行：
+
+```bash
+aiwiki setup --path "F:\knowledge_data\aiwiki" --yes
+```
+
 ## 让宿主 Agent 学会 AIWiki
 
 初始化知识库后，先扫描本机支持的宿主 Agent：

package/dist/src/app.js

@@ -7,7 +7,7 @@ import { flagBool, flagString, parseArgs } from "./args.js";
 import { ingestFile, ingestPayload } from "./ingest.js";
 import { CliError, writeLine } from "./output.js";
 import { confirmInit, directorySummary, doctor, exists, initWorkspace, promptForSetup, promptForInitPath, readConfig, resolveWorkspace, setDefaultWorkspace, statusSummary } from "./workspace.js";
-export const VERSION = "0.2.2";
+export const VERSION = "0.2.7";
 export async function runCli(argv, streams = { stdout: process.stdout, stderr: process.stderr }) {
     try {
         const args = parseArgs(argv);

package/dist/src/payload.js

@@ -13,7 +13,10 @@ export function normalizePayload(raw, runStartedAt) {
     const legacyContent = isRecord(raw.content) ? stringValue(raw.content.text) : undefined;
     const legacyMetadata = isRecord(raw.metadata) ? raw.metadata : undefined;
     const warnings = [];
-    const content = stringValue(sourceRaw.content) ?? legacyContent;
+    const contentRepair = repairMojibake(stringValue(sourceRaw.content) ?? legacyContent);
+    const titleRepair = repairMojibake(stringValue(sourceRaw.title));
+    const fetchNotesRepair = repairMojibake(stringValue(sourceRaw.fetch_notes));
+    const content = contentRepair.value;
     const fetcher = stringValue(sourceRaw.fetcher) ?? (legacyMetadata ? stringValue(legacyMetadata.fetcher) : undefined);
     const legacyCapturedAt = legacyMetadata ? stringValue(legacyMetadata.captured_at) : undefined;
     const capturedAt = stringValue(sourceRaw.captured_at) ?? legacyCapturedAt ?? runStartedAt;
@@ -42,6 +45,15 @@ export function normalizePayload(raw, runStartedAt) {
     if (typeof raw.target_kb === "string" && raw.target_kb.trim()) {
         warnings.push(`target_kb=${raw.target_kb} 已被单知识库流程忽略。`);
     }
+    if (contentRepair.repaired) {
+        warnings.push("source.content 检测到疑似 UTF-8 mojibake，已自动修复。");
+    }
+    if (titleRepair.repaired) {
+        warnings.push("source.title 检测到疑似 UTF-8 mojibake，已自动修复。");
+    }
+    if (fetchNotesRepair.repaired) {
+        warnings.push("source.fetch_notes 检测到疑似 UTF-8 mojibake，已自动修复。");
+    }
     if (fetchStatus === "failed" && content?.trim()) {
         throw new Error("source.content must be empty when source.fetch_status is failed");
     }
@@ -51,14 +63,14 @@ export function normalizePayload(raw, runStartedAt) {
         source: {
             kind,
             url: stringValue(sourceRaw.url),
-            title: stringValue(sourceRaw.title),
+            title: titleRepair.value,
             author: stringValue(sourceRaw.author),
             platform: stringValue(sourceRaw.platform),
             content_format: stringValue(sourceRaw.content_format),
             content,
             fetcher,
             fetch_status: fetchStatus,
-            fetch_notes: stringValue(sourceRaw.fetch_notes),
+            fetch_notes: fetchNotesRepair.value,
             captured_at: capturedAt,
             language: stringValue(sourceRaw.language) ?? (legacyMetadata ? stringValue(legacyMetadata.language) : undefined)
         },
@@ -93,3 +105,79 @@ function stringValue(value) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function repairMojibake(value) {
+    if (!value || !looksLikeUtf8Mojibake(value)) {
+        return { value, repaired: false };
+    }
+    const repaired = decodeUtf8BytesFromLatin1(value) ?? decodeUtf8BytesFromCp1252(value);
+    if (!repaired || scoreText(repaired) <= scoreText(value)) {
+        return { value, repaired: false };
+    }
+    return { value: repaired, repaired: true };
+}
+function looksLikeUtf8Mojibake(value) {
+    return /(?:Ã|Â|â€|“|”|’|å|ç|è|é|ä|æ|ï¼|ã€)/.test(value);
+}
+function decodeUtf8BytesFromLatin1(value) {
+    try {
+        return Buffer.from(value, "latin1").toString("utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function decodeUtf8BytesFromCp1252(value) {
+    const bytes = [];
+    for (const char of value) {
+        const code = char.codePointAt(0);
+        if (code === undefined) {
+            continue;
+        }
+        const mapped = cp1252ReverseMap.get(code);
+        if (mapped !== undefined) {
+            bytes.push(mapped);
+        }
+        else if (code <= 0xff) {
+            bytes.push(code);
+        }
+        else {
+            return undefined;
+        }
+    }
+    return Buffer.from(bytes).toString("utf8");
+}
+function scoreText(value) {
+    const cjk = [...value].filter((char) => /[\u4e00-\u9fff]/u.test(char)).length;
+    const mojibake = (value.match(/(?:Ã|Â|â€|“|”|’|å|ç|è|é|ä|æ|ï¼|ã€)/g) ?? []).length;
+    const replacement = (value.match(/\uFFFD/g) ?? []).length;
+    return cjk * 4 - mojibake * 20 - replacement * 50;
+}
+const cp1252ReverseMap = new Map([
+    [0x20ac, 0x80],
+    [0x201a, 0x82],
+    [0x0192, 0x83],
+    [0x201e, 0x84],
+    [0x2026, 0x85],
+    [0x2020, 0x86],
+    [0x2021, 0x87],
+    [0x02c6, 0x88],
+    [0x2030, 0x89],
+    [0x0160, 0x8a],
+    [0x2039, 0x8b],
+    [0x0152, 0x8c],
+    [0x017d, 0x8e],
+    [0x2018, 0x91],
+    [0x2019, 0x92],
+    [0x201c, 0x93],
+    [0x201d, 0x94],
+    [0x2022, 0x95],
+    [0x2013, 0x96],
+    [0x2014, 0x97],
+    [0x02dc, 0x98],
+    [0x2122, 0x99],
+    [0x0161, 0x9a],
+    [0x203a, 0x9b],
+    [0x0153, 0x9c],
+    [0x017e, 0x9e],
+    [0x0178, 0x9f]
+]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "description": "Agent-first local knowledge production CLI for a single knowledge base.",
   "license": "MIT",