Skip to content

find: document that the command contacts a remote ranking service #72

Closed

Description

@iguangfei

Observation on main faf1d88

deckuse find ranks document elements through @typesafe-ai/sdk (src/find/client.ts, src/find/rank.ts; see also #53, "release the workspace write lock before remote ranking"). The README describes Deckuse as local-first and does not mention TypeSafe, the network, or what is sent.

Impact

Users who choose Deckuse because documents stay on their machine have no way to learn from the README that one read command sends data to a third-party service. An agent may pick find over search without the user knowing.

Acceptance

  • README and deckuse find --help state that the command makes a network request, what content leaves the machine (query only, or element text as well), and which credential it needs.
  • agent-context / the skill mark find as network-dependent and name search / list as the offline alternative.
  • Consider an environment switch that disables network commands so restricted hosts fail with a structured error.

Activity

  1. zhaoxiongfei commented on Nov 13, 2026

    @zhaoxiongfei
    Member

    README、find --help、agent-context 和 Skill 均注明 TypeSafe 网络请求、TYPESAFE_API_KEY、会发送的查询、名称、文本摘录及布局上下文,并给出离线 search/list。CLI 输出和打包回归已核对。

    已随 PR #74 合并到 main(46ff80d)。GitHub 两组 CI、本地 470 项测试和 npm 安装包检查通过。
    #74

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions