@klarkxy/dsh-zhihu 0.1.0

package/LICENSE

@@ -0,0 +1,41 @@
+            The Star And Thank Author License (SATA)
+                  Version 2.1, September 2026
+
+Copyright © 2026 Klarkxy(278370456@qq.com)
+
+Project Url: https://github.com/klarkxy/dsh-editor
+             https://github.com/klarkxy/sata-license
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+And wait, one more thing — an invitation, not a condition: it would be best if
+you star/+1/like the project(s) in the project url section above, and thank the
+author(s) in the Copyright section. You may, and arguably you should — but the
+permissions above hold either way, star or no star.
+
+Here are some suggested ways:
+
+ - Email the authors a thank-you letter, and make friends with him/her/them.
+ - Report bugs or issues.
+ - Tell friends what a wonderful project this is.
+ - And, sure, you can just express thanks in your mind without telling the world.
+
+Contributors of this project by forking have the option to add his/her name and
+forked project url at copyright and project url sections, but shall not delete
+or modify anything else in these two sections.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @klarkxy/dsh-zhihu
+
+独立知乎资料插件。普通 RPC 与可选 Tool 入口分开，可单独使用。包版本独立维护；兼容 DSH `0.1.5-rc.2`。凭据：DSH `ZHIHU_ACCESS_TOKEN`。
+
+## 安装到 DSH Web
+
+需要 Node.js 22 或更高版本，以及 DSH `0.1.5-rc.2` 的 Web profile。
+
+```sh
+dsh plugin --profile web add @klarkxy/dsh-zhihu
+```
+
+安装后重启 `dsh web`，打开「知乎资料」并配置 `ZHIHU_ACCESS_TOKEN`。模型需要知乎工具时，在所用 `agent.cordis.yml` 的插件列表中加入：
+
+```yaml
+- name: '@klarkxy/dsh-zhihu/tools'
+```
+
+npm 上无 scope 的 `dsh-zhihu` 属于其他维护者，请使用完整的 `@klarkxy/dsh-zhihu` 包名。此包已经编译，安装时无需构建本仓库。
+
+## 入口
+
+- Host `zhihu`（feature `zhihu`）：`/zhihu`（`src/index.ts`）
+- 官方 Web：`shell.overlay`（id `zhihu`，搜索 / 设置 / 用量 / 知识库）
+- 桌面：`dsh-editor.settings.zhihu` 嵌入设置「知乎资料」（配置 / 用量 / 知识库 / 连接测试），桌面上只有这一个入口（`src/client.ts`）
+- `zhihu-tools`（feature `zhihu-tools`，`dshEditor.inserts`）：桌面组合自动加入；工具名未改
+
+桌面 canonical recipe `desktop` 启用 `zhihu` + `zhihu-tools`；`basic` / `smart` / `full` 别名解析同一集合。
+
+## 契约
+
+`/zhihu`：`search`、`global.search`、`hot.list`、`ask`、`knowledge.search`、`knowledge.bases`、`knowledge.upload`、`usage.summary`。工具：`zhihu_search`、`zhihu_global_search`、`zhihu_hot_list`、`zhihu_ask`、`zhihu_knowledge_search`（`src/tools.ts`）。UI 与 Tool 共用计量 `dsh_editor_zhihu_usage`。Client 用结构型 `Select` / `Dialog`，不导入私有 Shell 包（`src/client-host-ui.ts`）。
+
+若当前 profile 已经提供 `webSearchManager`（安装了 `@klarkxy/dsh-web-search-manager`），Host 还会把知乎全网搜索注册为网络搜索后端（id `zhihu-global`），与「知乎资料」共用 `ZHIHU_ACCESS_TOKEN`。未安装管理插件时不注册，也不额外增加依赖。模型侧仍走官方 `web_search`；专用 `zhihu_global_search` 工具不受影响。
+
+在不含空格的目录放置 tarball 后执行：
+
+```powershell
+$packagePath = (Resolve-Path .\klarkxy-dsh-zhihu-0.1.0.tgz).Path.Replace('\', '/')
+dsh plugin --profile web add "file:$packagePath"   # klarkxy-dsh-zhihu-0.1.0.tgz
+```
+
+## 文档
+
+[使用者指南](https://github.com/klarkxy/dsh-editor/blob/main/docs/user-guide.md) · [产品原则](https://github.com/klarkxy/dsh-editor/blob/main/docs/product-principles.md) · [插件发布与发现](https://github.com/klarkxy/dsh-editor/blob/main/docs/plugin-distribution.md)

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: zhihu
+      name: '@klarkxy/dsh-zhihu'