c456-cli 0.1.6 → 0.3.0

package/README.md

@@ -12,6 +12,14 @@
 
 C456 命令行工具：通过 **HTTP API v1** 读写收录、打法等数据，适合本地使用或与 AI Agent 集成。
 
+## 用 C456 搭建私人知识库
+
+若你希望把 **[c456.com](https://c456.com)** 当作私人或团队的**云端知识底座**——在本地用「卡帕西式」Wiki 维护笔记与素材，用本 CLI 与线上收录做**同步**，并按权限**对内协作或对外分享**——请直接阅读独立指南：
+
+**[私人知识库：用 AI 客户端使用 C456](https://github.com/xiaohui-zhangxh/c456-cli/blob/main/docs/private-knowledge-base.md)**（克隆仓库后也可打开 [`docs/private-knowledge-base.md`](./docs/private-knowledge-base.md)）
+
+该流程会串联：**注册 C456 → 安装配置 c456-cli → 安装 [Karpathy Wiki](https://github.com/baklib-tools/skills/tree/main/skills/karpathy-wiki) 技能 → 安装 [c456-llm-wiki](https://github.com/xiaohui-zhangxh/c456-cli/tree/main/skills/c456-llm-wiki) 双向同步规范**。
+
 ## 安装
 
 ```bash
@@ -83,21 +91,47 @@ c456 config show
 
 ## 常用命令
 
-### 收录（intake）
+### 数据管理（5 大类）
 
 ```bash
-# 按 URL 创建 tool 收录（-B 为站点，-u 为收录目标）
-c456 -B https://c456.example.com intake new -k tool -u "https://github.com/owner/repo" --auto-resolve-url
+# 工具
+c456 tool new -u "https://github.com/owner/repo" --auto-resolve-url
+
+# 渠道
+c456 channel new -u "https://example.com" --auto-resolve-url
 
 # 纯文本信号（可无 URL）
-c456 intake new -k signal -t "标题" -b "正文"
+c456 signal new -t "标题" -b "正文"
+
+c456 signal show <id>
+c456 signal list -q "关键词" --stage raw
+c456 signal refine <id> --to cleaned --ai
+c456 signal update <id> --refinement-status approved
 
-c456 intake show <id>
-c456 intake list -k signal -q "关键词"
-c456 intake update <id> -t "新标题"
-c456 intake delete <id> --force
+# 打法（M1/M2 仍为独立资源；M3 会逐步合回 Intake）
+c456 playbook new -t "标题" -b "Markdown 正文"
+c456 playbook show <id>
+c456 playbook list -q "关键词"
+
+# 讲解
+c456 walkthrough new -t "标题" --cast-file ./demo.cast
+c456 walkthrough list
 ```
 
+### 素材库（图片）
+
+```bash
+c456 asset upload -f ./diagram.png
+c456 asset list
+c456 asset show <id>
+c456 asset update <id> --filename logo.webp
+c456 asset delete <id>
+c456 asset refresh-markdown --body-file ./note.md > ./note.new.md
+c456 asset fingerprint --body-file ./note.md
+```
+
+规格见 C456 主仓 [`docs/20-engineering/specs/api-v1.md`](https://github.com/xiaohui-zhangxh/c456/blob/main/docs/20-engineering/specs/api-v1.md) 与 [`docs/10-product/experience/media-library-v1.md`](https://github.com/xiaohui-zhangxh/c456/blob/main/docs/10-product/experience/media-library-v1.md)。
+
 ### 资料抓取（fetch）
 
 ```bash
@@ -111,6 +145,16 @@ c456 search signals -q "关键词"
 c456 search playbooks -q "关键词"
 ```
 
+### AI 自动识别入口（intake）
+
+`intake` 保留为 **AI 识别与录入** 的入口：当你不确定应该落到 signal/tool/channel/playbook 时使用。
+
+```bash
+c456 intake new -t "疑似工具/渠道/信号" -b "一段描述或粘贴内容"
+```
+
+当 AI 判断不在 `signal/tool/channel/playbook/walkthrough` 五类范围内，会返回 422 并给出错误提示；若识别为 `walkthrough`，会提示改用 `walkthrough` 子命令（因为需要媒体文件/外链）。
+
 ### 打法（playbook）
 
 ```bash