feat(cli): doc/kb resource expansion — upload flags + list filters + view fields

Closes deep-tuning gaps in v0.4-shipped doc / kb / session commands.
Each command had multiple SDK fields the CLI silently hardcoded or
omitted; this commit threads them through.

doc upload:
- --enable-multimodel (tri-state via NoOptDefVal): toggle multimodal
  extraction (PDF/DOCX image-to-text) per upload. Empty explicit
  value (e.g. --enable-multimodel="" from uninterpolated shell var)
  rejected as input.invalid_argument rather than silently coerced.
- --metadata key=value (repeatable): attach arbitrary metadata
- --channel <name> (default api, override for browser / wechat ingests)
- URL mode gains --title / --file-type / --tag-id; URL-only flags
  rejected with input.invalid_argument when used without --from-url

doc list filter flags:
- --keyword (server-side LIKE — case-sensitive per PG)
- --file-type / --source / --tag-id
- --start-time / --end-time (RFC3339)

search docs switches from client-side substring to server-side Keyword
via ListKnowledgeWithFilter — smaller wire payload, but case-sensitivity
shifts (documented in CHANGELOG + help text + Long).

MCP doc_list schema gains the same 6 filter fields (parity with CLI).

session view --full + --limit: loads chat history via LoadMessages SDK
method.

kb view human KV expanded: type / pinned / temporary / processing
state + count / summary model / created timestamp. All omit-empty.

doc view human KV expanded: title (when distinct from filename) /
description / source / channel / summary_status / enable_status /
tag_id / storage (human bytes) / file_hash (12-char prefix).
This commit is contained in:
nullkey
2026-05-16 02:38:48 +08:00
committed by lyingbug
parent 7bccd72ba3
commit f89d54362d
17 changed files with 1280 additions and 79 deletions
+37
View File
@@ -65,21 +65,58 @@ func runView(ctx context.Context, opts *ViewOptions, jopts *cmdutil.JSONOptions,
w := iostreams.IO.Out
fmt.Fprintf(w, "ID: %s\n", doc.ID)
fmt.Fprintf(w, "NAME: %s\n", text.KnowledgeDisplayName(doc.FileName, doc.Title, doc.ID))
// Title is rendered as a separate line only when it adds info over
// NAME (i.e. FileName is set AND differs from Title). When FileName
// is empty, KnowledgeDisplayName already used Title for NAME so a
// duplicate TITLE line would be noise.
if doc.Title != "" && doc.FileName != "" && doc.Title != doc.FileName {
fmt.Fprintf(w, "TITLE: %s\n", doc.Title)
}
if doc.KnowledgeBaseID != "" {
fmt.Fprintf(w, "KB: %s\n", doc.KnowledgeBaseID)
}
if doc.TagID != "" {
fmt.Fprintf(w, "TAG: %s\n", doc.TagID)
}
if doc.Description != "" {
fmt.Fprintf(w, "DESC: %s\n", doc.Description)
}
if doc.FileType != "" {
fmt.Fprintf(w, "TYPE: %s\n", doc.FileType)
}
if doc.Source != "" {
fmt.Fprintf(w, "SOURCE: %s\n", doc.Source)
}
if doc.Channel != "" {
fmt.Fprintf(w, "CHANNEL: %s\n", doc.Channel)
}
if doc.FileSize > 0 {
fmt.Fprintf(w, "SIZE: %s\n", formatSize(doc.FileSize))
}
if doc.StorageSize > 0 {
fmt.Fprintf(w, "STORAGE: %s\n", formatSize(doc.StorageSize))
}
if doc.ParseStatus != "" {
fmt.Fprintf(w, "STATUS: %s\n", doc.ParseStatus)
}
if doc.SummaryStatus != "" {
fmt.Fprintf(w, "SUMMARY: %s\n", doc.SummaryStatus)
}
if doc.EnableStatus != "" {
fmt.Fprintf(w, "ENABLED: %s\n", doc.EnableStatus)
}
if doc.EmbeddingModelID != "" {
fmt.Fprintf(w, "EMBEDDING: %s\n", doc.EmbeddingModelID)
}
if doc.FileHash != "" {
// Git-SHA-style 12-char prefix is enough for de-duplication
// while keeping the line short.
h := doc.FileHash
if len(h) > 12 {
h = h[:12]
}
fmt.Fprintf(w, "HASH: %s\n", h)
}
if !doc.CreatedAt.IsZero() {
fmt.Fprintf(w, "CREATED: %s\n", doc.CreatedAt.Format("2006-01-02 15:04:05"))
}