@itradingai/aiwiki 0.2.9 → 0.2.10

package/README.md

@@ -24,17 +24,6 @@ AIWiki 是一个开源的 Agent-first AI 知识库 CLI。你把文章链接、
 - 处理摘要
 - Obsidian 审阅入口
 
-## 30 秒上手
-
-```bash
-npx @itradingai/aiwiki@latest setup
-aiwiki agent list
-aiwiki agent install
-aiwiki prompt agent
-```
-
-然后把 `入库 <url>` 发给宿主 Agent。
-
 ## 直接发给 AI 帮你安装
 
 如果你希望让 Codex、Claude Code、QClaw、OpenClaw 等 AI 直接帮你完成安装和配置，可以把下面这段话原样发给它，记得改成你自己的知识库路径：
@@ -59,7 +48,18 @@ aiwiki prompt agent
    - 如果还差手动步骤，明确告诉我下一步怎么做
 ```
 
-## 让宿主 Agent 学会 AIWiki
+## 手动安装
+
+```bash
+npx @itradingai/aiwiki@latest setup
+aiwiki agent list
+aiwiki agent install
+aiwiki prompt agent
+```
+
+然后把 `入库 <url>` 发给宿主 Agent。
+
+## 让宿主 Agent 直接安装 AIWiki
 
 初始化知识库后，先扫一遍本机支持的宿主 Agent：
 
@@ -188,6 +188,7 @@ aiwiki doctor
 
 ## 最新动态
 
+- `2026-05-13`：更新了本地 Markdown 导入的命名规则，明确优先使用文件标题或文件名生成外部文件名，不优先从正文反推标题，并调整了 README 中的入口顺序和手动安装说明。
 - `2026-05-12`：公开前口径收口，统一 README、npm 元数据和公开文档入口。
 - `2026-05-09`：完成 npm 公开发布准备，补齐发布前的 README 与交付信息，并让 CLI 版本号与 `package.json` / 发布包保持一致，便于安装、排查与版本确认。
 - `2026-05-08`：完成中文化体验收口，包括默认生成中文 prompt、中文状态输出、中文目标描述，以及 README 和使用文档的中文本地化。

package/dist/src/app.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 import { flagBool, flagString, parseArgs } from "./args.js";
-import { ingestFile, ingestPayload } from "./ingest.js";
+import { deriveFileTitle, 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 async function runCli(argv, streams = { stdout: process.stdout, stderr: process.stderr }) {
@@ -163,7 +163,7 @@ export async function runCli(argv, streams = { stdout: process.stdout, stderr: p
                 source: {
                     kind: "url",
                     url,
-                    title: path.basename(contentFile),
+                    title: deriveFileTitle(contentFile),
                     content_format: "markdown",
                     content,
                     fetcher: "content-file",

package/dist/src/ingest.js

@@ -51,7 +51,7 @@ export async function ingestFile(rootPath, filePath) {
         schema_version: "aiwiki.agent_payload.v1",
         source: {
             kind: "file",
-            title: path.basename(filePath),
+            title: deriveFileTitle(filePath),
             content_format: "markdown",
             content,
             fetcher: "local-file",
@@ -65,6 +65,9 @@ export async function ingestFile(rootPath, filePath) {
         }
     });
 }
+export function deriveFileTitle(filePath) {
+    return path.basename(filePath, path.extname(filePath));
+}
 async function chooseLongTermTargets(root, slug, runId, warnings) {
     return {
         raw: await chooseLongTermTarget(root, "02-raw/articles", `${slug}.md`, runId, warnings),

package/dist/src/paths.js

@@ -16,14 +16,16 @@ export function relativePath(root, target) {
 }
 export function slugify(value) {
     const source = value?.trim() || "item";
-    const ascii = source
+    const normalized = source
         .normalize("NFKD")
-        .replace(/[^\w\s-]/g, "")
+        .replace(/\p{M}/gu, "");
+    const slug = normalized
+        .replace(/[^\p{L}\p{N}\s-]/gu, "")
         .trim()
         .toLowerCase()
         .replace(/[-\s_]+/g, "-")
         .replace(/^-+|-+$/g, "");
-    return ascii || "item";
+    return slug || "item";
 }
 export function appendRunIdBeforeExt(fileName, runId) {
     const ext = path.extname(fileName);

package/docs/USAGE.md

@@ -272,6 +272,11 @@ type "F:\knowledge_data\payload.json" | aiwiki ingest-agent --stdin
 aiwiki ingest-file --file "F:\knowledge_data\article.md"
 ```
 
+命名规则：
+- 本地 `md` 导入时，AIWiki 优先使用文件标题或文件名生成外部文件名。
+- 不会优先从正文内容里的 `# 一级标题` 反推文件名，避免整理后的文件名失去来源可追踪性。
+- 如果文件名本身没有语义，才会继续回退到更弱的兜底命名。
+
 链接加正文文件：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "type": "module",
   "description": "Agent-first AI knowledge base CLI for turning articles, links and notes into Obsidian-ready source cards, topics, outlines and reusable knowledge assets.",
   "license": "MIT",