@itradingai/aiwiki 0.2.8 → 0.2.10

package/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to AIWiki
+
+谢谢你愿意帮 AIWiki 变好。
+
+这个仓库比较在意三件事：
+
+- 文档说人话
+- 命令可复现
+- 不破坏已有 CLI 行为
+
+## 先准备什么
+
+本地开发前，先确认：
+
+- Node.js `>=20`
+- `npm install`
+- `npm run build`
+- `npm test`
+
+## 提 issue 前最好给什么
+
+如果你来报 bug，最好把这些信息一起带上：
+
+- 操作系统
+- Node.js 版本
+- AIWiki 版本
+- 宿主 Agent
+- 复现步骤
+- 实际输出
+- 期望输出
+
+如果能贴 `aiwiki doctor` 和 `aiwiki status` 的输出就更好了。
+
+## 提 PR 时注意什么
+
+- 尽量小步改
+- 不要顺手改一堆无关内容
+- 不要破坏已有 CLI 输出
+- 新功能尽量补最小测试
+
+## 本地验证
+
+```bash
+npm run build
+npm test
+aiwiki doctor
+aiwiki status
+```
+
+如果你改的是文档，就至少确认链接、命令和文件名都还对。

package/README.md

@@ -2,21 +2,31 @@
 
 # AIWiki
 
-AIWiki 是一个面向宿主 Agent 的本地知识库生产 CLI。用户把文章链接或正文发给 Codex、QClaw、OpenClaw、Claude Code 等 Agent，并使用“入库”触发词；宿主 Agent 负责读取网页或上下文，AIWiki 负责把内容写入本地知识库，并生成适合 Obsidian + Dataview 审阅的资料结构。
+AIWiki 是一个开源的 Agent-first AI 知识库 CLI。你把文章链接、网页正文或本地文本交给宿主 Agent，宿主 Agent 负责读取内容，AIWiki 负责把结果稳定写进本地知识库，并生成适合 Obsidian 审阅的资料卡、主题、大纲和处理记录。
 
-AIWiki 的重点不是替代 Agent 抓网页，而是把 Agent 已经读到的内容稳定沉淀为可追踪、可复盘、可继续写作的本地知识库。
+对外只有一个 AIWiki，公开页面不做软件分层。商业服务放在部署、陪跑和团队集成里，不放在软件版本层。
 
-## 最新动态
+## 它解决什么
 
-- `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 提示问题，避免静默套用默认值，并把首次使用流程改成交互式引导。
+- 收藏了很多链接，但最后都散在聊天记录里
+- 想用 AI 总结内容，却很难继续写作或复用
+- 想做选题、资料卡和大纲，但每次都得重新整理
+- 想让 Agent 帮忙收资料，但缺一个稳定的本地入库出口
+
+## 它会生成什么
+
+- 原文记录
+- Source Card 资料卡
+- Claim 建议
+- 创意素材
+- 选题候选
+- 草稿大纲
+- 处理摘要
+- Obsidian 审阅入口
 
 ## 直接发给 AI 帮你安装
 
-如果你希望让 Codex、Claude Code、QClaw、OpenClaw 等 AI 直接帮你完成安装和配置，可以把下面这段话原样发给它，注意修改下你的知识库路径：
+如果你希望让 Codex、Claude Code、QClaw、OpenClaw 等 AI 直接帮你完成安装和配置，可以把下面这段话原样发给它，记得改成你自己的知识库路径：
 
 ```text
 请帮我安装并配置 AIWiki。
@@ -38,41 +48,20 @@ AIWiki 的重点不是替代 Agent 抓网页，而是把 Agent 已经读到的
    - 如果还差手动步骤，明确告诉我下一步怎么做
 ```
 
-
-## 手动安装与初始化
-
-一次性运行交互式 setup：
+## 手动安装
 
 ```bash
 npx @itradingai/aiwiki@latest setup
+aiwiki agent list
+aiwiki agent install
+aiwiki prompt agent
 ```
 
-CLI 会询问知识库路径。直接回车会使用默认目录，确认后会创建或补齐 AIWiki 目录，并写入默认知识库配置。
-
-自动化初始化可以使用：
-
-```bash
-npx @itradingai/aiwiki@latest setup --path "F:\knowledge_data\aiwiki" --yes
-```
-
-如果希望**长期使用**全局命令：
-
-```bash
-npm install -g @itradingai/aiwiki@latest
-aiwiki setup
-```
-
-升级到最新版本：
-
-```bash
-npm install -g @itradingai/aiwiki@latest
-```
-
-要求 Node.js `>=20`。
+然后把 `入库 <url>` 发给宿主 Agent。
 
-## 让宿主 Agent 学会 AIWiki
+## 让宿主 Agent 直接安装 AIWiki
 
-初始化知识库后，先扫描本机支持的宿主 Agent：
+初始化知识库后，先扫一遍本机支持的宿主 Agent：
 
 ```bash
 aiwiki agent list
@@ -99,9 +88,9 @@ aiwiki agent install --agent claude --yes
 aiwiki prompt agent
 ```
 
-把输出内容安装成宿主 Agent 的 skill，或粘贴到宿主 Agent 的项目/会话说明里。
+把输出内容安装成宿主 Agent 的 skill，或者粘贴到宿主 Agent 的项目说明里。
 
-## 入库流程
+## 日常入库
 
 完成 setup 和 Agent 安装后，对宿主 Agent 发送：
 
@@ -117,49 +106,21 @@ aiwiki prompt agent
 用户发送链接 -> 宿主 Agent 读取内容 -> Agent 调用 AIWiki -> AIWiki 写入本地知识库 -> Obsidian 审阅和沉淀
 ```
 
-## Obsidian 与 Dataview
-
-AIWiki 初始化时会创建面向 Obsidian 的目录、Dashboard、Dataview 查询和 frontmatter 约定。核心入口包括：
+## 设计边界
 
-- `dashboards/AIWiki Home.md`
-- `dashboards/Review Queue.md`
-- `dashboards/Claims Review.md`
-- `_system/schemas/aiwiki-frontmatter.md`
+AIWiki 不是通用网页抓取器。网页读取主要交给宿主 Agent，AIWiki 专注于把 Agent 已经读到的内容写成稳定、可追踪、可复用的本地知识资产。
 
-完整方案见：[docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)。
+AIWiki 生成的 Markdown 和 frontmatter 默认面向 Obsidian + Dataview 审阅；如果你不装 Dataview，普通 Markdown、Properties、Backlinks、Search 和 Graph View 也能用。
 
-## 常用命令
+当前范围：
 
-```bash
-aiwiki setup
-aiwiki setup --path <path> --yes
-aiwiki agent list
-aiwiki agent install
-aiwiki prompt agent
-aiwiki doctor
-aiwiki status
-aiwiki ingest-agent --stdin
-aiwiki ingest-file --file <file>
-```
-
-高级/调试命令：
-
-```bash
-aiwiki init --path <path> --yes --set-default
-aiwiki config show
-aiwiki ingest-agent --payload <file>
-aiwiki ingest-url <url> --content-file <file>
-```
-
-## 当前范围
-
-- 单知识库
+- 只写入当前配置的知识库
 - 单次处理一条输入
 - 宿主 Agent 读取网页、附件或正文
 - CLI 写入本地文件和 Obsidian 友好的结构
 - 生成资料卡、素材建议、主题候选、草稿大纲、处理摘要
 
-## 当前不包含
+当前不包含：
 
 - CLI 内置通用网页抓取
 - 跨主题自动路由
@@ -168,13 +129,32 @@ aiwiki ingest-url <url> --content-file <file>
 - 长流程状态机
 - 技术支持流程
 
+## 示例展示
+
+想先看一次完整跑完会生成什么，可以看：
+
+- [docs/SHOWCASE.md](docs/SHOWCASE.md)
+
 ## 文档
 
-- 使用说明：[docs/USAGE.md](docs/USAGE.md)
-- Agent 对接协议：[docs/AGENT_HANDOFF.md](docs/AGENT_HANDOFF.md)
-- Obsidian + Dataview 方案：[docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)
-- 发布检查：[docs/RELEASE.md](docs/RELEASE.md)
-- 架构图：[docs/architecture.svg](docs/architecture.svg)
+- [docs/USAGE.md](docs/USAGE.md)
+- [docs/AGENT_HANDOFF.md](docs/AGENT_HANDOFF.md)
+- [docs/OBSIDIAN_DATAVIEW_PLAN.md](docs/OBSIDIAN_DATAVIEW_PLAN.md)
+- [docs/FAQ.md](docs/FAQ.md)
+- [docs/ROADMAP.md](docs/ROADMAP.md)
+- [docs/RELEASE.md](docs/RELEASE.md)
+- [CONTRIBUTING.md](CONTRIBUTING.md)
+- [SECURITY.md](SECURITY.md)
+- [docs/architecture.svg](docs/architecture.svg)
+
+## 参与与反馈
+
+如果你想提 bug、提需求，或者反馈宿主 Agent 对接问题，直接看：
+
+- [CONTRIBUTING.md](CONTRIBUTING.md)
+- [.github/ISSUE_TEMPLATE/bug_report.md](.github/ISSUE_TEMPLATE/bug_report.md)
+- [.github/ISSUE_TEMPLATE/feature_request.md](.github/ISSUE_TEMPLATE/feature_request.md)
+- [.github/ISSUE_TEMPLATE/agent_integration.md](.github/ISSUE_TEMPLATE/agent_integration.md)
 
 ## 联系与交流
 
@@ -206,6 +186,16 @@ aiwiki prompt agent
 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 和使用文档的中文本地化。
+- `2026-05-08`：强化 Obsidian 工作流，把 Review Queue、Claims Review 等审阅队列提升为一等入口，方便在知识库里持续审阅和回看入库内容。
+- `2026-05-07`：新增 Codex skill 安装能力，并补上 Agent 协议安装引导，让宿主 Agent 在正式入库前更容易完成对接。
+- `2026-05-07`：持续打磨初始化体验，修复 setup 提示问题，避免静默套用默认值，并把首次使用流程改成交互式引导。
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

package/SECURITY.md

@@ -0,0 +1,31 @@
+# Security Policy
+
+AIWiki 是一个本地 CLI 工具。它会按用户指定的路径写入 Markdown、JSON 和配置文件。
+
+## 安全边界
+
+AIWiki 不会：
+
+- 主动上传用户本地知识库内容
+- 绕过登录墙或付费墙
+- 自动修改 `.obsidian` 插件配置
+- 自动安装 Dataview
+- 扫描未指定的个人目录
+
+## 建议
+
+- 只在你信任的环境里运行 AIWiki
+- 首次使用时最好指定一个新的测试知识库目录
+- 遇到异常写入行为时，先停下来检查 payload 和目标路径
+
+## 报告问题
+
+如果你发现疑似安全问题，请优先提交 issue，并尽量附上：
+
+- 运行命令
+- 目标路径
+- `aiwiki doctor` 输出
+- `aiwiki status` 输出
+- 能稳定复现的最小示例
+
+如果问题涉及本地数据泄露、越权写入或路径逃逸，请尽量把细节说清楚，方便快速复核。

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/dist/src/payload.js

@@ -41,10 +41,10 @@ export function normalizePayload(raw, runStartedAt) {
         : ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"];
     const outputs = ["source_card", "creative_assets", "topics", "draft_outline", "processing_summary"];
     if (fetchStatus !== "failed" && requestedOutputs.length && requestedOutputs.length !== outputs.length) {
-        warnings.push("基础版会生成完整单条资料产物，request.outputs 已按全量输出处理。");
+        warnings.push("AIWiki 会为每条输入生成完整资料产物，request.outputs 已按全量输出处理。");
     }
     if (typeof raw.target_kb === "string" && raw.target_kb.trim()) {
-        warnings.push(`target_kb=${raw.target_kb} 已被单知识库流程忽略。`);
+        warnings.push(`target_kb=${raw.target_kb} 已被当前知识库流程忽略。`);
     }
     if (contentRepair.repaired) {
         warnings.push("source.content 检测到疑似 UTF-8 mojibake，已自动修复。");

package/docs/FAQ.md

@@ -0,0 +1,47 @@
+# AIWiki FAQ
+
+## AIWiki 是什么？
+
+AIWiki 是一个开源的 Agent-first AI 知识库 CLI。它把文章链接、网页正文和本地文本整理成本地知识资产，方便在 Obsidian 里继续审阅和写作。
+
+## AIWiki 是网页爬虫吗？
+
+不是。网页读取主要交给宿主 Agent，AIWiki 专注于校验结构化输入、写本地文件和生成审阅产物。
+
+## 一定要用 Obsidian 吗？
+
+不一定。AIWiki 生成的是标准 Markdown 和 frontmatter，Obsidian 只是最适合它的审阅界面之一。
+
+## 一定要装 Dataview 吗？
+
+不一定。没有 Dataview，也可以用 Obsidian 原生的 Properties、Backlinks、Search 和 Graph View。
+
+## 宿主 Agent 和 AIWiki 各负责什么？
+
+- 宿主 Agent 负责读取网页、正文或附件，并组装 payload
+- AIWiki 负责校验 payload、写本地知识库、输出处理记录
+- 用户负责提供链接或正文，最后在 Obsidian 里审阅结果
+
+## 为什么要先让 Agent 学会 AIWiki？
+
+因为大多数用户不想每次手动跑命令。更顺的方式是：把链接发给宿主 Agent，Agent 自动把内容交给 AIWiki，AIWiki 再把结果写进本地知识库。
+
+## 我能不能把它当成一个通用爬虫用？
+
+不建议。AIWiki 的边界不是“抓全网”，而是“把宿主 Agent 已经读到的内容稳定沉淀下来”。
+
+## 我从哪里开始最好？
+
+先跑：
+
+```bash
+npx @itradingai/aiwiki@latest setup
+aiwiki agent list
+aiwiki agent install
+```
+
+然后去看：
+
+- [USAGE.md](USAGE.md)
+- [SHOWCASE.md](SHOWCASE.md)
+- [AGENT_HANDOFF.md](AGENT_HANDOFF.md)

package/docs/README.md

@@ -1,11 +1,14 @@
 # AIWiki Docs
 
-AIWiki 是一个 Agent-first 的本地知识库工具，用来把宿主 Agent 已经读取到的文章、网页正文或本地文本写入单知识库。
+AIWiki 是一个 Agent-first 的本地知识库工具，用来把宿主 Agent 已经读取到的文章、网页正文或本地文本写入当前配置的知识库。
 
 - 用户使用说明：[USAGE.md](USAGE.md)
 - Agent 对接协议：[AGENT_HANDOFF.md](AGENT_HANDOFF.md)
 - Obsidian + Dataview 方案：[OBSIDIAN_DATAVIEW_PLAN.md](OBSIDIAN_DATAVIEW_PLAN.md)
 - 架构图：[architecture.svg](architecture.svg)
+- 示例展示：[SHOWCASE.md](SHOWCASE.md)
+- 常见问题：[FAQ.md](FAQ.md)
+- 路线图：[ROADMAP.md](ROADMAP.md)
 
 ## Quick Start
 

package/docs/ROADMAP.md

@@ -0,0 +1,38 @@
+# AIWiki Roadmap
+
+AIWiki 对外只有一个项目，所以这里写的是能力路线，不是版本分层。
+
+## 1. 更稳的入库体验
+
+- 更顺的 setup 引导
+- 更清晰的 doctor 检查
+- 更稳定的 Agent handoff
+- 更完整的 Obsidian 审阅入口
+- 更容易追查失败原因
+
+## 2. 更完整的内容处理能力
+
+- 更好用的资料卡
+- 更清楚的 Claim / Evidence 建议
+- 更顺手的选题候选
+- 更稳定的大纲生成
+- 更好复用的模板和输出结构
+
+## 3. 更适合团队和自动化部署
+
+- 更多宿主 Agent 接入方式
+- 更适合团队协作的知识库目录
+- 更完善的部署说明
+- 更清楚的诊断和支持入口
+- 更好的服务化落地方式
+
+## 4. 服务层能力
+
+公开软件还是 AIWiki 本身。后续如果要做商业化，重点会放在：
+
+- 部署服务
+- 陪跑服务
+- 团队集成服务
+- 技术支持服务
+
+这些都属于服务层，不是把 AIWiki 拆成多个软件版本。

package/docs/SHOWCASE.md

@@ -0,0 +1,78 @@
+# AIWiki 示例展示
+
+这页不是讲概念，直接看一次完整跑通会发生什么。
+
+## 示例 1：一篇文章进知识库
+
+### 用户输入
+
+```text
+入库 https://example.com/article
+```
+
+### 宿主 Agent 做的事
+
+1. 读取网页正文或可访问内容。
+2. 组装 `aiwiki.agent_payload.v1`。
+3. 调用 `aiwiki ingest-agent --stdin`。
+4. 把 AIWiki 的处理结果回复给用户。
+
+### AIWiki 会写什么
+
+```text
+09-runs/<run-id>/payload.json
+09-runs/<run-id>/raw.md
+09-runs/<run-id>/source-card.md
+09-runs/<run-id>/creative-assets.md
+09-runs/<run-id>/topics.md
+09-runs/<run-id>/draft-outline.md
+09-runs/<run-id>/processing-summary.md
+```
+
+### 长期目录会出现什么
+
+```text
+02-raw/articles/
+03-sources/article-cards/
+04-claims/_suggestions/
+06-assets/_suggestions/
+07-topics/ready/
+08-outputs/outlines/
+dashboards/
+```
+
+### 用户在 Obsidian 里怎么看
+
+- 打开 `dashboards/AIWiki Home.md`
+- 查看 `dashboards/Review Queue.md`
+- 从资料卡回到原文、选题、大纲和处理记录
+
+## 示例 2：网页没读到正文
+
+有些页面需要登录，或者宿主 Agent 暂时拿不到正文。这个时候 AIWiki 也不会装死，它会把失败原因记录下来。
+
+### 用户输入
+
+```text
+入库 https://example.com/locked-page
+```
+
+### 结果
+
+```text
+09-runs/<run-id>/payload.json
+09-runs/<run-id>/processing-summary.md
+```
+
+### 你会看到什么
+
+- 失败原因会写进 `processing-summary.md`
+- 用户仍然能在 Obsidian 里看到这次处理记录
+- 下次只要宿主 Agent 能读到正文，就可以重新入库
+
+## 这个示例页想说明什么
+
+- AIWiki 不是网页爬虫本体
+- 宿主 Agent 负责读取内容
+- AIWiki 负责稳定写入本地知识库
+- 结果始终可追踪、可复盘、可继续写作

package/docs/USAGE.md

@@ -6,7 +6,7 @@
 用户只做一次 setup -> 之后只把链接发给 Agent -> Agent 自动调用 AIWiki 入库
 ```
 
-AIWiki CLI 不负责网页抓取。Qclaw、Codex、Claude Code、Cursor、Gemini CLI 等都只是宿主 Agent 的例子；基础版面向的是通用宿主 Agent 协作。
+AIWiki CLI 不负责网页抓取。Qclaw、Codex、Claude Code、Cursor、Gemini CLI 等都只是宿主 Agent 的例子；这份文档面向的是通用宿主 Agent 协作。
 
 ## 1. 一次性设置
 
@@ -78,13 +78,13 @@ aiwiki agent install --agent claude --yes
 - `openclaw`：复制到 OpenClaw workspace skills 目录。
 - `claude`：复制为 Claude Code slash-command 提示文件。
 
-`opencode` 和 `hermes` 会被扫描出来，但基础版暂不自动写入它们的配置。确认官方用户提示/skill 目录后再开放自动安装。现在可先输出通用对接协议：
+`opencode` 和 `hermes` 会被扫描出来，但 AIWiki 暂不自动写入它们的配置。确认官方用户提示/skill 目录后再开放自动安装。现在可先输出通用对接协议：
 
 ```bash
 aiwiki prompt agent
 ```
 
-把输出内容安装成宿主 Agent 的 skill，或粘贴到宿主 Agent 的项目/会话说明里。不同 Agent 的安装入口不同，所以基础版提供自动安装向导和通用协议两条路径。
+把输出内容安装成宿主 Agent 的 skill，或粘贴到宿主 Agent 的项目/会话说明里。不同 Agent 的安装入口不同，所以 AIWiki 提供自动安装向导和通用协议两条路径。
 
 ## 3. 日常使用
 
@@ -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/docs/architecture.svg

@@ -1,6 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1280" height="820" viewBox="0 0 1280 820" role="img" aria-labelledby="title desc">
-  <title id="title">AIWiki Base Architecture</title>
-  <desc id="desc">AIWiki base edition architecture showing setup, host Agent installation, ingestion, CLI processing, and local knowledge base outputs.</desc>
+  <title id="title">AIWiki Architecture</title>
+  <desc id="desc">AIWiki architecture showing setup, host Agent installation, ingestion, CLI processing, and local knowledge base outputs.</desc>
   <defs>
     <style>
       .bg { fill: #fbfaf7; }
@@ -25,7 +25,7 @@
   </defs>
 
   <rect class="bg" x="0" y="0" width="1280" height="820"/>
-  <text class="title" x="54" y="58">AIWiki 基础版架构图</text>
+  <text class="title" x="54" y="58">AIWiki 架构图</text>
   <text class="small" x="56" y="86">目标：宿主 Agent 负责读取与理解，AIWiki CLI 负责校验与本地确定性写入。</text>
 
   <rect class="band" x="48" y="118" width="1184" height="118" rx="8"/>
@@ -98,6 +98,6 @@
 
   <rect class="panel" x="772" y="650" width="460" height="102" rx="8"/>
   <text class="h2" x="798" y="684">边界</text>
-  <text class="small" x="798" y="714">基础版不抓网页、不做多知识库、不做状态机、不做批量队列。</text>
+  <text class="small" x="798" y="714">AIWiki 不抓网页、不做多知识库、不做状态机、不做批量队列。</text>
   <text class="small" x="798" y="738">所有写入必须限制在目标知识库根目录内。</text>
 </svg>

package/package.json

@@ -1,13 +1,26 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "type": "module",
-  "description": "Agent-first local knowledge production CLI for a single knowledge base.",
+  "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",
   "keywords": [
     "aiwiki",
-    "agent",
+    "ai-knowledge-base",
     "knowledge-base",
+    "knowledge-management",
+    "agent",
+    "ai-agent",
+    "agentic-workflow",
+    "llm-wiki",
+    "markdown",
+    "cli",
+    "codex",
+    "claude-code",
+    "openclaw",
+    "qclaw",
+    "content-workflow",
+    "writing-workflow",
     "obsidian",
     "dataview"
   ],
@@ -22,6 +35,9 @@
   "files": [
     "dist/src",
     "README.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
     "docs/*.md",
     "docs/architecture.svg",
     "skill"